The runppmconfig argument

-mode <mode>

This is where you specify whether the configuration of the PPM component specified by the
<command> argument is saved in the specified file or whether the configuration saved in the specified file is imported into the PPM system. The valid values are export and import.

-<command> <file name>

Specify the PPM component whose configuration is to be saved to or imported from the specified file. 

command

PPM component

abcanalysis

Configuration of ABC analysis

attributenames

Names of the PPM attributes. To export, use the -language <ISO code> argument to specify the relevant language for the PPM attribute names. If this argument is missing, the attribute names are exported in the default language of the PPM client (defaultlanguage XML element in the file Locales.xml).
For importing, the language code specified in the XML file is used.

attributetypes

Definition of the attribute types known in the PPM system

copyattributerules

Rules for copying the object attributes to the process instance

cpi

CPI module messages

datatypes

Extended data type definition

dimgroup

Dimension groups

epctemplate

Templates for EPC representation

factorycalendar

Factory calendar

favorites
[-favoriteuser <user>]

Import or export of favorites. You can restrict the operation to a specific user's favorites with the favoriteuser parameter. If you enter -favoriteuser sharedfavorites, only all shared favorites are imported or exported.

images

Assign wallpaper and other icons for EPC objects to EPC display

keyindicator

Process instance-dependent and independent measures, as well as dimensions, attribute calculations, and relations

keyrules

Rules for key creation

kidepend

User-defined dimensions

kigroup

Measure groups

locales

PPM user interface languages

merger

Merge configuration

mysaptransactions

SAP transactions

onlinekis

User-defined measures

orgunits

Organizational units

processtree [-add]

Definition of the process tree
If you specify the -add option, new elements from the specified file are added to the process tree. Already existing elements of the process tree are not replaced.

ranking

Configuration of ranking analysis

realm

Name of the analysis realm to be imported

reportautomations

Overall configuration of report automations

serverproperties

Export general server settings

system

System configuration. Is saved in XML files in the specified directory. (See chapter Export the system configuration.)

targetvalues

Planned value definitions

topflop

Top-flop dimensions

transformationfactors

Transformation factors

users

User privileges

You can also specify every possible parameter value in the file InitSystem_settings.properties, so that the configuration will be active immediately when the PPM database is initialized. Make sure to take account of the dependency of different configurations on one another.

-overwrite

This switch enforces the replacement of existing configurations when a configuration is imported. It is only applicable for the following configuration components:
-targetvalues, -abcanalysis, -datatypes, -factorycalendar, -keyindicator,
-ranking, -onlineki, -favorites, -reportautomations

Warning

Replacing existing configurations by specifying the
-overwrite option can lead to unwanted effects, for example if you change the definition of data types already in use.  

-replace

This switch deletes an existing configuration before the start of the import. It can only be used for the following configuration components: -targetvalues, -abcanalysis, -ranking -favorites, -reportautomations

Example

The configuration of the user-defined measures of the PPM client umg_en is to be saved in the XML file OnlineKI.xml on C drive.

runppmconfig -client umg_en -user system -password manager -mode export

-onlinekis C:\OnlineKI.xml

Warning

Do not change the resolution (precision) of time dimensions (timedim) and time of day dimensions (hourdim) in an imported measure configuration later, e.g., from HOUR to SECOND, as re-importing using runppmconfig -overwrite cannot create the required changes in the database tables. 

If you want to change the resolution of time and time of day dimensions for a configuration already imported, run a database initialization with the changed configuration.

-registry <host:port>

By specifying this parameter, you can access a remote PPM system whose RMI registry can be reached via the specified computer name and port number.

-usessl <true|false|default>

If you specified the -registry parameter, you can use the -usessl parameter to specify whether the remote system is to use SSL-encrypted data communication or not.

Parameter

Description

true

The remote PPM system uses encrypted data transfer.

Ensure that the local system and remote system are using the same keystore.

false

The remote system uses unencrypted data transfer.

default
(default value)

The settings of the local PPM system are used.