Lesson 1 of 6
Running Migration Assessment
9 min
Listen to this lesson
Course sap-int-301 explains why Contoso Motor Co. is leaving SAP Process Orchestration and in what order. This course is the hands-on half: the screens, settings, files and evidence. It follows Theo's integration team through the 64 integrated configurations on PO system XP1, from the first data extraction to the last wave switch. Lesson 1 gets the assessment running.
Two capabilities, two jobs
SAP splits the work across two tools that are easy to confuse. Migration Assessment is its own capability of SAP Integration Suite, running in the SAP BTP Cloud Foundry environment. It extracts configuration and usage data from a PO system, evaluates every integration scenario against SAP's rules, and estimates effort. It migrates nothing. Migration Tooling is a feature of the Cloud Integration capability that turns PO objects into integration flows (lesson 3). Both depend on your Integration Suite service plan; SAP Note 2903776 lists which plans include which features.
Migration Assessment supports two kinds of PO content: integrated configurations, which run on the Java-only Adapter Engine, and dual-stack scenarios. The supported releases are 7.31 SP28, 7.40 SP23 and 7.50 SP06 and above. For 7.50 SP06 to SP09, SAP Help asks for the patch in SAP Note 2456339 first. Sam, Contoso's Basis lead, confirms XP1's support package level before anyone requests access.
Prerequisites, in the order you will hit them
| Prerequisite | Detail from SAP Help | Owner at Contoso |
|---|---|---|
| Capability active | Migration Assessment activated among the Integration Suite capabilities in the subaccount | Theo |
| BTP role collections | PIMAS_Admin for settings (systems, rules, T-shirt sizes); PIMAS_IntegrationAnalyst for extractions, evaluations and downloads | Nadia assigns, Theo requests |
| PO technical user | Roles SAP_XI_API_DISPLAY_J2EE, SAP_XI_API_DEVELOP_J2EE and SAP_XI_MONITOR_J2EE | Sam creates, Nadia approves |
| Cloud Connector | HTTP mapping, back-end type SAP Process Integration, no underscore in the virtual host, access policy Path And All Sub-Paths on the listed endpoints only | Sam |
| Optional usage depth | Performance data collection per SAP Note 3300008; synchronous message logging in NetWeaver Administrator per SAP Notes 2442373 and 2442344, which adds database load | Sam, with Theo agreeing the window |
The endpoint list in SAP Help is specific, and it is worth exposing nothing more. It includes the Integration Directory services (for example /IntegratedConfiguration750InService, /CommunicationChannelInService and /ValueMappingInService), the ES Repository paths such as /rep/read/ext and /rep/query/ext, message monitoring at /mdt, channel monitoring at /AdapterFramework/ChannelAdminServlet, and /CPACache. Copy the current list from SAP Help into the Cloud Connector change request rather than from an old blog.
Step 1: Add the PO system
- In the Migration Assessment application, open Settings. In the SAP Process Orchestration Systems table, choose Add.
- Enter a System Name (Contoso uses
XP1) and pick the System Version, or choose Auto-Detect. - Under Integration Directory, enter the Address (the Cloud Connector virtual host), the technical User ID and the Password.
- Under ES Repository, tick Same as Integration Directory unless you run a central ES Repository on another host. Choose Create.
- Select the system and choose Test Connection. Do this even if the Cloud Connector and destination checks were green: only this test checks that the PO resources the extraction needs are reachable.
Step 2: Create a data extraction request
Go to Request > Data Extraction and choose Create. Enter a Request Name, select the system, and pick Complete Extraction (every integration scenario) or Custom Extraction (deselect scenarios you want to leave out). The extraction pulls integration scenarios, communication channels, sender and receiver agreements, alert rules and value mappings from the Integration Directory; operation mappings, message mappings and service interfaces from the ES Repository; and processed messages from the message monitor. Disk storage per tenant is limited, so delete extractions you no longer need.
Step 3: Create a scenario evaluation request
Go to Request > Scenario Evaluation, choose Create, enter a Request Name, pick the Data Extraction Request, and give this run an Evaluation Run Name and Description. Each request then offers Open Dashboard, Trigger Analysis (a new run on the same data), Export (the full spreadsheet) and Generate Report (a PDF summary). SAP updates the rule set over time, and an older extraction may not carry what new rules need, so plan a fresh extraction before each formal re-evaluation. Put the date in every run name so runs can be compared later.
- PrepareCapability, role collections, PO user, Cloud Connector paths, logging decisions
- Add systemSettings: XP1 with Integration Directory and ES Repository; Test Connection
- ExtractRequest > Data Extraction: Complete Extraction; read the log
- EvaluateRequest > Scenario Evaluation: dated run name
- DownloadExport (spreadsheet) for triage; Generate Report (PDF) for the steering group
- Migration Assessment extracts and evaluates; Migration Tooling in Cloud Integration does the migrating.
- Prerequisites: supported PO release, PIMAS role collections, a PO technical user with three roles, and Cloud Connector paths limited to SAP's list.
- Add the system in Settings and always run Test Connection; then Request > Data Extraction, then Request > Scenario Evaluation.
- Fix extraction errors in PO and extract again; re-extract before formal re-evaluations as rules change.
Check your understanding · not graded
Lesson check
1. Which statement describes Migration Assessment correctly?
2. Cloud Connector and destination checks are green, but nobody has used Test Connection in Migration Assessment. Why run it anyway?
3. An extraction ends with the status Completed with errors. What happens if you evaluate it as it is?
4. Which BTP role collection does an analyst need to run extractions and evaluations and download results?