Professional Documents
Culture Documents
SAP Directory Content Migration Tool
SAP Directory Content Migration Tool
TABLE OF CONTENTS
INTRODUCTION ............................................................................................................................................... 3
SCENARIO MIGRATION .................................................................................................................................. 3
CHANNEL MIGRATION.................................................................................................................................... 3
1.
System Selection: ............................................................................................................................ 4
2.
Channel Selection: .......................................................................................................................... 4
3.
Object Creation: ............................................................................................................................... 5
CONFIGURATION ............................................................................................................................................ 5
1.
Systems: ........................................................................................................................................... 5
2.
Renaming Rules: ............................................................................................................................. 6
SECURITY AND AUTHORIZATIONS .............................................................................................................. 8
SCENARIO MIGRATION STEP-BY-STEP ....................................................................................................... 9
1.
System Selection ............................................................................................................................. 9
2.
Scenario Selection......................................................................................................................... 10
3.
Scenario Matcher ........................................................................................................................... 10
4.
Preview and Renaming ................................................................................................................. 11
a.
Renaming......................................................................................................................................... 11
b.
Channel properties .......................................................................................................................... 11
c.
Channel migration ............................................................................................................................ 12
5.
Object Creation .............................................................................................................................. 12
1.
System Selection ........................................................................................................................... 13
2.
Scenario Selection......................................................................................................................... 14
3.
Scenario Matcher ........................................................................................................................... 14
4.
Preview and Renaming ................................................................................................................. 14
5.
Object Creation .............................................................................................................................. 15
FAQ ................................................................................................................................................................. 16
INTRODUCTION
The Directory content migration tool provides migration and mass change functionality for PI scenarios
and channels. The tool supports all releases from XI 3.0 on i.e. 3.0, 7.0, 7.1, 7.11, 7.3, 7.31 and 7.4.
The tool can be accessed via http(s)://<host>:<port>/pimon -> Configuration and Administration ->
Migration Tool where host & port is of target system can be AEX,PO or AE of dual stack system.
SCENARIO MIGRATION
The wizard allows to select one or multiple classical scenarios (Integration Engine)
and to migrate these to Integration Configurations(ICO), running in a Java only environment. The
selection of the scenarios is performed through selecting either of sender agreement, receiver
determination or configuration scenario for the corresponding integration scenario. Scenarios with or
without sender agreement are also supported. The tool automatically detects the objects participating
in the scenarios, such as receiver determination, interface determinations and receiver agreements. It
provides an option to preview and rename the object which will be created in the target system. If
some of the used business components, parties, business systems and communication channels are
missing in the target system, they will be created as well.
CHANNEL MIGRATION
The tool allows to select multiple channels from a source system to adapt the adapter engine,
metadata version, channel attributes and module properties and create or update these channels in
the target systems. Depending on the type of channels selected, properties have shown in Channel
Selection step to edit in different sections.
Click on Channel Migration link in Integration Directory Migration Tool page. Road map
displays with steps.
1. System Selection:
Select the source system name from drop down. If system is not present in dropdown list user
can add by clicking Add/Change System button.
Enter the username and password.
User can select Use Secure URL checkbox option.
Target system name is selected by default in which user has opened pimon(pi monitoring)
page.
2.
Channel Selection:
User can search the channel/s either using channel name or Component or Party.
Drop down option available to search the channel based on Sender or Receiver.
Click on Search. User can search by using regular expression if the complete name is not
known. e.g. Abcd*
Select the channel which you wanted to migrate. Channel(s) Basic, Common Properties,
Common Table Properties and Module Properties are shown. User can select the checkbox to
edit the specific property of the channel.
Click on next.
3. Object Creation:
CONFIGURATION
1. Systems:
The tool needs to connect to a source system for reading directory configuration
objects. The tool automatically recognizes all integration directories registered with the SLD, in
addition the source system can be defined manually by specifying name and secure and/or nonsecure HTTP addresses.
Create System:
o Click on Create System button.
o Enter the System Name, System URL and/or System secure URL.
o Click on Save.
Modify System by clicking on Modify button for already existing system.
Delete the systems using Delete System button.
2. Renaming Rules:
User can use the Renaming Rules to rename directory objects (Communication channels, Business
components, Parties, Routing expressions and Business Systems). Directory configuration objects
can be renamed, when migrated. In order to define reusable renaming patterns, the tool provides the
possibility to define renaming rules. Currently there are 2 rule types supported, adding a suffix and
value map. In addition the rules can be applied to Directory Objects or Expression Constants.
Once the rule applied, channels name got changed according to the rule defined.
a. Select the source system from which the tool will read the configuration scenarios to be
migrated.
b. Select Use Secure URL checkbox if secure communication should be used.
c. Provide user name and password for the source system, having the authorization to use the
directory API for display purpose.
d. Provide user and password for the target system. Target system is always the local PI
system.
e. Click on next
Example 1: Scenario (without sender agreement) Idoc to Proxy.
2. Scenario Selection
a. Select Scenario By dropdown contains the options to search the scenario are Sender
Agreement, Scenario Name and Receiver Determination.
b. Search the scenario and select the scenario for migration.
c. User can migrate multiple scenarios. Search criterias are regular expression, Sender
Agreement or Receiver Determination for searching multiple scenarios.
d. Filter option provided for selecting the name of the configuration scenario you want to
migrate, alternatively if no filtering is provided all the configuration scenario objects will be
read from the source system. A progress bar is provided as this can take up to several
minutes, depending on the number of scenarios.
e. Also you can use wild card (*), substring for searching the particular scenario.
f. Click on next.
3. Scenario Matcher
a. The tool search through the complete directory of the source system for matching scenario
objects: receiver determinations, interface determinations, receiver agreements. The
matched objects are presented in this step. As the retrieval of the objects from the source
system can take some time, a progress bar is provided before actually showing this step.
b. Migration feasibility check: The tool will check if the scenarios can be migrated. Feature like
receiver rules available in the classical PI scenarios is not available for integrated
configurations.
c. Excluded: The excluded check box is available to remove any content selected for scenario
migration.
d. Click on next
10
a. Renaming
o
Directory object renaming: you can define different renaming rules for the different
types of integration objects that are involved. If you rename one object then all
dependent object are renamed accordingly, e.g., if you rename a party all the
communication components and channels for this party will be renamed. Interface
name and namespace cannot be renamed as these are often referring to ESR
objects.
Business System renaming based on SLD transport targets: business system can
only be created in the target system if the corresponding business system exists in
the SLD. The tool provides a built in renaming function that will rename the business
systems from the source system, according to the SLD transport targets defined in
SLD, similar to Integration Directory import.
b. Channel properties
You can define the target adapter engine and the adapter metadata version for, to be
created channels.
If the user wants the message flow on de central adapter engine user can select by clicking
on Channel Properties button and selecting de central adapter engine.
11
c. Channel migration
If the scenario which is migrated refers to ABAP based adapter channels, the channels are
transformed into the corresponding Java adapter channels and the properties are preserved
it also includes manual rework. Example in case of security related properties like user name
and password will not get migrated. Here manual entry is required.
If the channels already exist in the target system, migration tool will not create those but
existing channels will be reused.
Click next.
5. Object Creation
The object creation is triggered using the create button. The details from the object creation can
be seen in the details text area. All messages from the directory API invocation are shown in the
text area.
12
a. The tool first creates a new change list for each configuration scenario to be used.
b. The tool attempts to create the required party, communication component, business system
and communication channels objects.
c. The tool deletes any conflicting sender agreement object (used when source and target
system are the same). The integrated configuration object cannot be created if a sender
agreement exists with the same message header.
d. The tool creates the integrated configurations objects.
e. The tool creates the configuration scenario object.
f. The channel list is not activated. It is required that the person performing the migration to
review the objects created by the migration tool and activate the change lists.
g. Click on finish.
Log on to target system and activate the change list.
13
2. Scenario Selection
3. Scenario Matcher
14
5. Object Creation
Click on finish.
Log on to target system and activate the change list.
15
FAQ
1. Does migration tool support migration of objects without sender agreement?
Yes.
2. Does migration tool creates channels which are already in target system?(In case of different
properties including activating objects)
If the channel already exists in the target system they are not created. But for certain
channels the names are same and properties are different (for e.g. the adapter type) even in
this case the channels are not created and hence is not available in the change list (along
with other objects). Hence activating the other objects like Integrated Configuration and
scenario is not possible.
3. Why does the migration tool not overwrite the existing objects?
In general, the tool does not provide 100% migration in all cases. So in some cases it is a mixture of
what the tool creates and what would be done manually by the person doing the migration. So, we
do not like to modify always and existing objects will not be overwritten. But we do have the option of
defining renaming rules (suffix rules) and use it for the channels, now when the names do not clash
new channels will be created.
4. Does the tool support migration of scenario like multiple senders and one receiver?
Yes. It creates multiple ICOs.
16
6. Does migration tool supports migration of scenarios where wild cards are used? e.g. *
Tool supports the scenarios migration which contains wild character with some exceptional
case.
Example tool doesnt support the migration of scenario if * for sender system in receiver
determination where sender agreement is missing (IDOC)
Example tool supports below cases:
a. Sender system is * in receiver determination, has single/multiple sender agreement/s
which fit to receiver determination.
b. Sender system is * in interface determination and receiver agreement, has
single/multiple sender agreement/s and receiver determination/s which fit to
configuration scenario.
17
www.sap.com
18