Show TOC

Configuring the Change Management ServiceLocate this document in the navigation structure

Procedure

Using the Change Management Service (CMS) with SAP NetWeaver usage type PI is optional. You can use it to transport objects of the Enterprise Services Repository and the Integration Directory. If you want to use CMS, you must perform some configuration steps first.

Note

You can configure CMS for either repository objects or directory objects independently from each other.

The following sections only cover a basic and initial configuration of CMS for use with PI.

More information: PI Transports Using the Change Management Service (CMS) .

Recommendation

Do not use CMS and the Change and Transport System (CTS) at the same time, except when you migrate from CMS to CTS or vice versa.

More information about CTS: Configuring the Change and Transport System .

Deploying the CMS Component

The CMS component is part of the SAP NetWeaver Development Infrastructure (DI).

To find the sources for the DI deployment, perform the following steps:

  1. Go to the SAP Service Marketplace at service.sap.com .

  2. Choose Start of the navigation path SAP Support Portal Next navigation step Downloads Next navigation step SAP Software Distribution Centre Next navigation step Download Next navigation step Support Packages and Patches Next navigation step Support Packages and Patches - Entry by Application Group Next navigation step SAP NetWeaver Next navigation step SAP NETWEAVER Next navigation step SAP NETWEAVER 7.3 End of the navigation path.

  3. Select the following components:

    • DI CHANGE MGMT. SERVER 7.30

    • DI COMPONENT BUILD SERVER 7.30

    • DI DESIGN TIME REPOSITORY 7.30

  4. Download the most up-to-date Software Component Archive (SCA) of each component.

  5. Deploy the downloaded SCAs.

Defining CMS Communication Users in PI (optional)

Different PI systems probably use different repository and directory service users and passwords for communicating with CMS. If you want each of these systems to use the same service user name and password for CMS communication, but do not want to modify each system's service users, you can specify dedicated service users for CMS communication. To do so, use the following parameters in the exchange profile:

com.sap.aii.repository.serviceuser.name.cms

com.sap.aii.repository.serviceuser.pwd.cms

com.sap.aii.directory.serviceuser.name.cms

com.sap.aii.directory.serviceuser.pwd.cms

Note

These properties are used to change the user and password for CMS and CTS at the same time.

Do the following to avoid that passwords can be read as plain text in the exchange profile:

  1. Export the exchange profile.

  2. Change type from pwd to string in the file that contains the parameters

    com.sap.aii.repository.serviceuser.pwd.cms

    com.sap.aii.directory.serviceuser.pwd.cms

  3. Import the modified file with option overwrite .

  4. Delete the file that contains the readable passwords.

If you do not specify these parameters, the names and passwords of the repository and directory service users (for example, PIREPUSER and PIDIRUSER) specified with the following parameters will be used:

com.sap.aii.repository.serviceuser.name

com.sap.aii.repository.serviceuser.pwd

com.sap.aii.directory.serviceuser.name

com.sa p.aii.directory.serviceuser.pwd

Maintaining CMS Communication Users in CMS

To maintain the CMS communication user in CMS, perform the following steps:

  1. Access the AS Java User Management area on your CMS system and define the following roles and actions:

    • Role CMSDeveloper with actions CMS.Display and CMS.Export

    • Role CMSAdministrator with action CMS.Administrate

  2. Choose the AS Java User Administration tab page on your CMS system and define the dedicated service users for CMS communication you specified in the previous section as CMS users with role CMSDeveloper.

    If you have not specified any dedicated service users for CMS communication, use the repository and directory service users (for example, PIREPUSER and PIDIRUSER).

    These service users are used by PI to send data to CMS. Therefore, their passwords must be the same in CMS and PI.

    Note

    Make sure that the passwords you define for these two users in CMS match the passwords in your PI system. To do so, log on with both users to the AS Java login screen to make sure that the passwords are correct and that they do not need to be changed.

  3. Define a CMS Administrator user with the role CMSAdministrator.

    It is assumed that the CMS Administrator performs the customizing and the later transports. If you need to distribute administration tasks (for example, approval or transports) to different users, you have to define additional roles and users.

    Note

    All users you created during the CMS setup must change their passwords at initial logon or must have set the flag No password change required .

    Be aware that passwords are case sensitive.

More information: Roles in the Change Management Service .

Configuring a CMS Domain in CMS

Use the Landscape Configurator to configure the following:

  • CMS domain

  • CMS server

  • System Landscape Directory (as an External Server )

Perform the following steps

  1. Configure a CMS domain for PI in CMS as described in Configuring a Domain .

  2. Configure the CMS server as follows:

    1. Insert the CMS URL (server name and port of the CMS system)

    2. Create a CMS user. The user allows CMS to connect to the PI systems.

      This user (for example LSADMIN) must be maintained as service user in all PI systems (including SLD) with the same password. It requires the following ABAP roles:

      • SAP_XI_CMS_SERV_USER

      • SAP_SLD_ORGANIZER

        Note

        Either restart AS Java after you have added the roles to the CMS user or wait until the group assignment has been transferred to AS Java.

Within CMS, it is assumed that there is only one central SLD for all Enterprise Services Repositories and Integration Directories of the CMS domain. If more than one SLD is used, choose the master SLD for the domain definition.

Note

A CMS track can only be defined if all software component versions relevant for the track are available within the SLD of the CMS domain.

If you have installed the SLD on a standalone AS Java (and not on an AS Java including PI), you have to perform the following steps:

  1. On the AS Java where your SLD is installed, use the SAP NetWeaver Administrator and choose Start of the navigation path Configuration Management  Next navigation step  Security  Next navigation step  Authentication End of the navigation path.

  2. Add the CMS user (for example LSADMIN) to the security role LcrInstance WriterAll or to the group SAP_SLD_ORGANIZER .

Activating CMS

Set or enhance the following exchange profile parameters to activate CMS. The CMS transport option will then be displayed in both the Enterprise Services Repository and the Integration Directory.

Normally, these parameters must only be set in systems that are planned to be inserted into the development tracks. In all other systems, the transport should be organized by CMS.

Enterprise Services Repository

To be able to use CMS for repository objects, perform the following steps:

  1. Ensure that the following parameters are available and set to true in your development and consolidation systems; do not change these parameters in production systems:

    • com.sap.aii.ibrep.core.cms.enableClTransport=true

      Determines that the option of transporting change lists with CMS is provided on the user interface.

    • com.sap.aii.ibrep.core.cms.enableTransportWizard=true

      Determines that the CMS transport is provided by the export wizard.

  2. Add the following value to com.sap.aii.ib.client.properties:

    • com.sap.aii.ibrep.core.cms.*

      Note

      Do not replace existing values here. Just add the new one.

Integration Directory

To be able to use CMS for directory objects; perform the following steps:

  1. Ensure that the following parameter is available and set to true in your development system:

    • com.sap.aii.ibdir.core.cms.enableTransportWizard=true

      Determines that the CMS transport is provided by the export wizard.

      Note

      The transport of change lists with CMS is not supported for the Integration Directory.

  2. Add the following value to com.sap.aii.ib.client.properties:

    • com.sap.aii.ibdir.core.cms.*

      Note

      Do not replace existing values here. Just add the new one.

  3. Ensure that the following parameter is available and set to true in your consolidation system:

    • com.sap.aii.ibdir.core.cms.enableClTransport=true

      Determines that the option of transporting change lists with CMS is provided on the user interface.

Do not change any of these parameters in production systems.

Defining Development Tracks in CMS

More information on defining a development track for PI in CMS: Creating an XI Track .

Specify the tracks as follows:

  • For the Enterprise Services Repository, specify http://<servername>:<port>/rep/

  • For the Integration Directory, specify http://<servername>:<port>/dir/