The runinitdb command line program initializes the database schema for the specified PPM client. For this to work, the -init option must also be specified. The process runs in two stages.
The database schema is recreated and populated with default values for each language referenced in the file Locales.xml. Any file name can be selected for the file Locales.xml and is specified in the file InitDB_settings.properties.
To initialize an existing database schema, you must specify the -user system -password <password> parameters. After successful initialization, the password for the system user is reset to the default value manager.
The PPM client server is started and the configuration files specified in the file InitSystem_settings.properties are imported.
The file InitSystem_settings.properties consists of various sections. Each section is made up of three lines. Each line begins with a keyword, which is assigned a value using an equals sign:
Keyword |
Description |
---|---|
INIT_MODULE_X |
Section introduction |
INIT_MODULE_X_NAME |
Name of the configuration component. Corresponds to the command argument in the runppmconfig program. |
INIT_MODULE_X_FILE |
File name with path for the XML configuration file |
X is a placeholder for the number of a section in the file. All three lines in a section must be specified. Section numbering must start from 1 and be continuous. However, the sections can appear in any order in the file.
Warning
When editing the file InitSystem_settings.properties, you must adhere to the sequence of the configuration components: Data types, attributes, process types, measures, process tree, others.
Example
Extract from the default file InitSystem_Settings.properties:
#
# Initialization of all runppmconfig components according
# to the specified sequence
#
# INIT_MODULE_XXX_NAME : Name of the module according to
# the command line option of runppmconfig
# INIT_MODULE_XXX_FILE : Name of the XML file containing the corresponding config data
#
INIT_MODULE_1 =
INIT_MODULE_1_NAME = datatypes
INIT_MODULE_1_FILE = D:/ppm/xml/DefaultDataTypes.xml
INIT_MODULE_2 =
INIT_MODULE_2_NAME = attributetypes
INIT_MODULE_2_FILE = D:/ppm/xml/DefaultAttributeTypes.xml
INIT_MODULE_3 =
INIT_MODULE_3_NAME = attributenames
INIT_MODULE_3_FILE = D:/ppm/xml/DefaultAttributeNames.xml
...
In order to import the configuration of organizational units during initialization, edit the file InitSystem_settings.properties in the configuration directory for the relevant client and insert the following lines at the end of the file:
...
INIT_MODULE_X =
INIT_MODULE_X_NAME = orgunits
INIT_MODULE_X_FILE = <Organizational units.xml>
For X you use a number 1 higher than the previous section.
In practice, it has proven useful to store the configuration files on a client-specific basis in directories of the form <installation directory>\ppmmashzone\server\bin\work\data_ppm\custom\<client>\xml.