Migration and Mass Change of Communication Channels

Use

You can migrate communication channels from a source system to a target system or from one PI Release to the next.

You can perform the following steps:

Perform a mass change for channel attributes for many channels
Validate properties against target adapter metadata
Update the metadata version
Select several communication channels and change their parameters together
Change the Adapter Engine for all selected channels
Change common attributes for all selected channels
Change values for module properties

Procedure

System Configuration

To run the Integration Directory Migration Tool, use the following link in the target system: https://<host>:<port>/webdynpro/resources/sap.com/tc~pi~tools~dirmig~wd/DirectoryCockpit
To configure the systems you want to use as source systems and to configure renaming rules, choose Configuration.
If the system you want to use is not available in the list of source systems, choose Add/Change System .
Choose Create System .
Enter System Name , System URL , System Secure URL , and choose Save .

Channel Migration

On the Integration Directory Migration Tool start page, choose Channel Migration .
Select the source system from the System Name dropdown list, from which the tool will read the communication channels to be migrated.
To use secure communication, select Use Secure URL .
In the User Name and Password fields, provide the user and password for the source system.

Note

The tool is based on the Integration Directory Programming Interface and requires the corresponding security roles, depending on the source system release, in order to read data, for example, SAP_XI_API_DISPLAY_J2EE. The SAP_XI_API_DEVELOP_J2EE roles is required for the target system. To enable accessing of the source and local system via HTTPS, the SSL certificates of the system must be available in the WebServiceSecurity Keystore view in the Web AS Java Keystore.
In the User Name and Password fields, provide the user and password for the target system.

Note

The target system is always the local PI system. If the tool is started on a decentral Adapter Engine, it connects to the Integration Directory running on the central PI system. The source and target system can be different or the same system.
Choose Next.

Channel Selection
Use the search filter to select communication channels from the Integration Directory of the source system.

Note

If no filter is provided, the wizard reads all communication channels from the Integration Directory. The load process can take several minutes.
Select the channels you want to change. The table below the channel list shows the properties that are common to all selected channels.
Change the channel properties and choose Apply . The changes to the channel are highlighted with a marked checkbox in the table with the channel list.

Object Creation
To proceed to Object Creation , choose Next .
Choose Create . This creates a new change list in the Integration Directory of the target system, and adds the changed channels to this new change list.

The log displays the details about the objects that are created, not created, or already exist with an OK/Error/Warning message.
Choose Finish .
Log in to the Integration Directory of the target system. A new change list has been created. Review all created objects and activate the change list.