Configuration

Using Cloud Controller you can change the configurations of individual system components. For example, you can add new database drivers for PPM or create new users in the user database. The following is a list of the key commands for configuring the individual components.

Commands

Cloud Controller command

Description

show config

Displays the current configuration of Cloud Agent and Cloud Controller.

show instance <instance id>

Displays the current configuration of a component.

Example

show instance ppm_core

Returns all configuration parameters of the ppm_core component.

enhance [driver]

Use the enhance command to install required drivers.

Install database drivers
enhance <client> with dbDriver local file <path to DB driver>

Install SAP JCO drivers
enhance <client> with dbDriver local file <path to SAP JCO driver>

Please note that you need to enter path data in Java standard. This means that you need to use "/" instead of "\" even under Windows operating systems.

Example

The Oracle database driver ojdbc6.jar is stored under C:\Temp. Enter the following command to install this driver for the PPM client umg_en.

enhance umg_en with dbDriver local file C:/Temp/ojdbc6.jar

enhance [PPM components]

To install PPM components, such as Content Packages or Extractors at a later time, use this command:

CSV2PPM Extractor

enhance <client> with extractor com.aris.ppm.enhancements.csv2ppm <version> type zip

ppm4mm Content Package

enhance <client> with contentPackage com.aris.ppm.enhancements.ppm4mm <version> type zip

Please note that the selected component must already exist in the repository of your installation. The local repository of your installation for PPM extensions is located here: <installation directory>\ppmmashzone\server\bin\agentLocalRepo\com\aris\ppm\enhancements. For the version please refer to the name of the subdirectory of the relevant component. For example, if 95.1.0 is specified under <installation directory>\ppmmashzone\server\bin\agentLocalRepo\com\aris\ppm\enhancements\jdbs2ppm, the version is 95.1.0.

enhance [user]

The command enhance can also be used for creating a new user in central user management.

enhance <instance id> with createUser trigger only options tenant.name="default" tenant.user.name=system tenant.user.pwd=manager affected.user=user1 affected.pwd=user1 affected.first.name="John" affected.last.name="Doe" affected.email="test@test.de" affected.description="description"

Creates a new user user1 with the password user1. Please use the name of the component User management for the instance ID (default: umcadmin).

reconfigure <instance id> <parameter>

This command is used for reconfiguring components. You can change all parameters saved in the configuration file under <installation directory<\ppmmashzone\server\bin\work\work_<instance id>\runtimeinfo.properties.

Changing these values in this file does not affect the instance running. Parameters can be changed only with Cloud Controller.

Please note that you need to enter path data in Java standard. This means that you need to use "/" instead of "\" even under Windows operating systems.

Replace a backslash \ used in the password with a double backslash \\.

Example

You want to change the RMI communication between PPM client and server to SSL encryption. The following commands need to be executed in Cloud Controller.

  • stop ppm_core
  • reconfigure ppm_core ssl.enabled="true" ssl.keystorefile="<path to keystore file>" ssl.keystorepassword="<keystorepassword>"
  • start ppm_core