MidPoint Home Directory

Last modified 03 Jul 2024 15:32 +02:00

MidPoint Home Directory is a filesystem directory that provides a home to midPoint installation. It is a directory that midPoint uses to store initial configuration, cryptographic keys, log files and similar "variable" content.

Those are data that are not well suited for identity repository (database). Initial configuration, log files, connector JAR files, schema customizations and other such low-level entities can be found in the midpoint.home directory.

Setting Location of MidPoint Home Directory

Easiest way to set the location of midpoint home directory is to set MIDPOINT_HOME environment variable before midPoint start script is executed (applies to stand-alone deployment on UNIX systems).

In other cases the midpoint.home directory can be specified by setting the midpoint.home JVM property (hence the name). Setting the property depends on the application server or web container that is used to run midPoint but it is usually a variation of the following JVM command-line option:

-Dmidpoint.home=/var/opt/midpoint/

Default Setting

The default setting on midPoint home depends on a way how midPoint was deployed.

For stand-alone deployment (which is the default) midPoint home directory is located in var sub-directory of midPoint installation. E.g. if midPoint was installed in /opt/midpoint then midPoint home directory will be located in /opt/midpoint/var. This location is determined by startup shell scripts and explicitly passed to midPoint by using midpoint.home JVM option. For UNIX system the location of midPoint home directory can be easily changed by setting MIDPOINT_HOME environment variable.

For Tomcat deployment the default setting of midpoint.home is a midpoint subdirectory of the home directory of the user that runs the application server (web container). Therefore it is usually /home/username/midpoint on UNIX systems or \Documents and Settings\username on Windows systems. This is also the case if stand-alone startup scripts were modified and the midpoint.home option is not provided at startup, or if you run the midpoint.war directly using java command, e.g. java -jar midpoint.war.

MidPoint will try to create the midpoint.home directory if it does not already exist and midPoint has the rights to do so.

Directory Structure

Directory / File Description Notes

connid-connectors/

location for all ConnId based connectors, use for adding or upgrading connectors in your MidPoint deployment

Some connectors are bundled with Midpoint or can be found in Identity Connectors section.

icf-connectors/

location for all ICF based connectors (legacy, kept for support purposes)

Some connectors are bundled with Midpoint or can be found in Identity Connectors section.

idm-legacy/

location for all Sun IDM API adapters

This adapters are licensed separately by their owners.

lib/

location for custom JDBC drivers or other custom libraries

Tested with stand-alone deployment

log/

logging directory

schema/

location for all extension schemas

localization/

location for all localization files

logback.xml

startup logging configuration

See Initial Logging Setup

config.xml

initial midPoint configuration file

See the next section.

Configuration file

File config.xml located in midpoint.home directory is the initial midPoint configuration file.

This is not to be confused with System Configuration Object which is already a midPoint object stored repository.

See Overriding config.xml parameters page for ways how to override values in config.xml from the command line.

Was this page helpful?
YES NO
Thanks for your feedback