-Dmidpoint.home=/var/opt/midpoint/
MidPoint Home Directory
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.
midpoint.home
. 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:
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 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.
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 |
---|---|---|
icf-connectors/ |
location for all ICF based connectors |
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 |
|
config.xml |
basic midPoint configuration file |