Configure server.conf parameters in PPM

Note: For more information about the steps in this procedure, see the Installation and Administration Guide.

Add (if not present) and specify the parameters related to Universal CMDB integration for service portfolio to the PPM server.conf configuration file, as follows:

  1. Stop the PPM Server.

  2. Open the <PPM_Home>/server.conf file, add and configure the following parameters:

    All parameter names begin with com.kintana.core.server. but that is not shown in the table.

    Parameter

    Description

    SERVICE_LIST_SOURCE

    Specifies the source of the list of available services:

    • uCMDB to retrieve the list of services from Universal CMDB each time they are needed for PPM requests

    • lookup to retrieve the list of services from PPM for PPM requests and project tasks

    For integration with Universal CMDB, enter uCMDB.

    SERVICE_LIST_UCMDB_CACHE_TIMEOUT

    Length of time (in seconds) the service list remains in PPM cache before it is retrieved again, for example, 300. For more information, see the Installation and Administration Guide.

    SERVICE_LIST_UCMDB_CI_MAPPINGS

    Service list mappings between the following pairs of attributes:

    • The name attribute for the Service List uCMDB autocomplete list in PPM, and the CI name attribute in Universal CMDB

    • The description attribute for the Service List uCMDB autocomplete list in PPM, and the CI description attribute in Universal CMDB

    The mappings are formatted in pairs and separated by commas as follows (with no spaces or new lines): 

    name:<uCMDB_CI_Name_Attribute>,
    description:<uCMDB_CI_Description_Attribute>

    For example, the value of this parameter could be: 

    name:data_name,
    description:service_description

    This example maps name in PPM to the CI name attribute data_name in Universal CMDB, and it maps description in PPM to the CI description attribute service_description in Universal CMDB.

    Note: All items that are to be mapped must already exist in PPM or Universal CMDB.

    SERVICE_LIST_UCMDB_CI_TYPE

    Name of the CI type used to store the service list, for example, Service.We recommend using the value Service.

    Note: You must create this CI type on the Universal CMDB server. For more information about creating a CI type, see the Universal CMDB documentation.

    SERVICE_LIST_UCMDB_MAX_CI_NUMBER

    The maximum number of Universal CMDB configuration items allowed in the service list, for example 1000. For more information, see the Installation and Administration Guide.

    UCMDB_SERVER_URL

    URL of the Universal CMDB server:

    http://<UCMDB_Host>:<port>/ucmdb/

    or

    https://<UCMDB_Host>:<port>/ucmdb

    where <UCMDB_Host> represents the host machine on which Universal CMDB is running.

    For example: http://<UCMDB URL FQDN>:8080/ucmdb/

    Note: If the Universal CMDB server is configured to support HTTPS, make sure you configure the UCMDB_SSL_KEYSTORE_PATH parameter. For information about enabling HTTPS for Universal CMDB, see (Optional) Configuring Universal CMDB to Support HTTPS for the Integration . You should also configure PPM to use HTTPS.

    UCMDB_SERVER_VERSION

    Version of the UCMDB server, for example: 10

    UCMDB_SSL_KEYSTORE_PATH

    Universal CMDB keystore path, used only if the UCMDB_SERVER_URL parameter uses HTTPS.

    UCMDB_WS_MAX_CONNECTION_NUMBER

    Maximum number of connections allowed to connect to the Universal CMDB server using the Web Service API, for example, 10.

    UCMDB_WS_PASSWORD

    Password for Universal CMDB user specified in UCMDB_WS_USER, logging in through Web service.

    You must encrypt this password by using the kEncrypt.sh script, which is located in the bin directory of the PPM Server.

    UCMDB_WS_USER

    Universal CMDB user name for logging in through Web service, for example, admin.

    This user name must include only single-byte characters.
    UCMDB_GATEWAY_URL

    URL of the Probe Gateway component of the Discovery and Dependency Mapping (DDM) Probe. The Probe Gateway provides communication (HTTP or HTTPS) between the Probe Manager and the Universal CMDB user for processes such as downloading tasks and returning task results.

    For example: http://<UCMDB_Host>:<port>/mam/gateway?

    The value for <UCMDB_Host>:<port> is usually the same as for the UCMDB_SERVER_URL parameter.

  3. Run the kUpdateHtml.sh script to apply your changes. For details, see kUpdateHtml.sh.

  4. Restart the PPM Server.