Part 1<\/b><\/span><\/p>\n In this article you will learn:<\/span><\/strong><\/p>\n \n<\/div>\n In Part 2 – Test migration with Int4 IFTT<\/a><\/strong><\/span>\u00a0 (the only tool on the market supporting SAP CPI Neo to SAP CPI Cloud Foundry migration testing) you will see how easily you can test your integration scenarios after migration and how to complete the process with necessary steps.<\/p>\n Check this out for complete migration process!<\/p>\n<\/div>\n In recent months we can observe a thriving popularity of SAP Cloud Platform Integration in Cloud Foundry Environment. There are good reasons that Cloud Foundry environment is a recommended choice.<\/p>\n Cloud Foundry gives you competitive edge thanks to hosting provided by known cloud providers like Amazon, Alibaba, Google or Microsoft and data centers located in many regions.\u00a0 You can also benefit from the improved availability of Cloud Foundry thanks to the concept of availability zones – meaning resources from various data centers can be shared in the zone boundary therefore improving their availability.<\/p>\n However, you should also get familiar with some limitations of this option available in SAP Note 2752867<\/a> before deciding to migrate.<\/p>\n To perform the migration you can use the SAP Cloud Platform Integration OData API.<\/a>\u00a0It enables you to export and import integration content from source tenant to the target and deploy it.<\/p>\n Migration process is described in the SAP Note 2937549 – SAP Cloud Platform Integration for process services: Content Migration from Neo to CF Environment<\/a>. The described approach is based on utilizing Postman tool for performing API calls. There are pre-delivered postman collections which call the APIs made available to you. You will find it in attachment to the before mentioned SAP Note.<\/p>\n The postman collections consist of requests, environment configuration and scripts which control the execution. They are executed before and after particular request. You don’t have to worry about configuring each request, all you have to do is to configure the environment in Postman and press run button.<\/p>\n However, to make the process reliable, you have to prepare accordingly.<\/p>\n Migration procedure can be divided into following phases:<\/p>\n Note, that before migration you have to meet the following prerequisites:<\/p>\n Please consider, it’s recommended to perform activities mentioned in 3rd point in the downtime. It will prevent using source and target tenant in the same time what may lead to issues.<\/p>\n Let’s move on to the details.<\/p>\n Download the file Migration.postman_collections.zip containing postman collections attached to the Note 2937549 and modify the file Credentials.postman_environment.json.<\/p>\n Provide the credentials (user name and password) of the user which will be utilized for the migration and the source and target tenant host URLs (without the http:\/\/ and \/itspaces).\u00a0 Note, that in this approach you need to use same credentials for source and target tenant user.<\/p>\n Import the collection into Postman<\/p>\n You will see the placeholders for the source and target tenant in the requests. They will be populated with values configured in the Credentials environment (file Credentials.postman_environment.json).<\/p>\n You should see imported collections in the left pane and Credentials in the top:<\/p>\n Some requests have scripts assigned, which control the execution of requests. You can see them in Pre-request Script and Test tabs.<\/p>\n Collection execution step by step:<\/p>\n You might see status error codes – for instance 400 when there is an attempt to upload artifact’s configuration which is not available. Also, the run might be aborted when you’ll try to migrate SAP content which is not in the recent version. In this case you will see errors in the log in the console as in the screenshot below.<\/p>\n Migrate security contents<\/strong><\/p>\n After you’ve migrated the Integration content you need to use collection Custom Certificate Management to copy keystore contents. Note, that in this step following artifacts will be migrated:<\/p>\n Note, that migration of Security Material and Certificate-to-User-Mappings are not covered by this procedure. Before proceeding to next steps you have to make sure those materials are in place. There is no collection to handle this part, however there is an API method which enables addition of user credentials and Certificate-to-User-Mappings. You’ll find an exemplary request in the further section of this article.<\/p>\n Migrate Number Range Objects (optional)<\/strong><\/p>\n At this stage you should have already migrated the SAP pre-delivered content, custom content and value mappings configurations. Now you have to migrate the number ranges as well, in case you’re using any. For this purpose use collection Number Range Object Migration.<\/p>\n Deploy integration artifacts<\/strong><\/p>\n Once you have all the required content in place it’s time to deploy your integration artifacts by running Deploy Migrated Content collection. After completing this step ensure that all the Integration flows are in the “Started” state. It may happen some of them are erroneous, for instance if you’re missing user credentials. If there are errors you have to resolve them before proceeding to next steps.<\/p>\n In the screenshots below you can see the source tenant design tab contents:<\/p>\n And migrated content in the target tenant:<\/p>\n As you can see the “Created By” property and timestamp have been overwritten with the user name used for migration and migration date and time. Also, as mentioned, content might be missing, since packages containing objects in the Draft state are not migrated.<\/p>\n At this point all the required integration content is migrated into target tenant. Follow the next part of the blog to complete the process with post-processing steps and make sure migration was successful! I next part I’ll show you how to test your integration scenarios using Int4 IFTT which is the only tool in the market supporting migration of CPI integration content from Neo to Cloud Foundry environment. With low effort you can simply achieve certainty that your integration scenarios work as expected.<\/p>\n <\/p>\n The migration procedure described in the SAP Note does not cover this part. However, you can use the API method POST https:\/\/{{targetHost}}\/api\/v1\/UserCredentials for this purpose with body containing credentials in JSON format. You need to:<\/p>\n <\/p>\n You will find the token in the bottom section:<\/p>\n Content-type: application\/json<\/p>\n X-Csrf-Token: value obtained in the previous request<\/p>\n If the addition was successful you should see the result as below:<\/p>\n Let’s have a look at newly created credentials in the CPI target tenant:<\/p>\n In order to add Certificate-to-User-Mapping you can use POST request\u00a0 https:\/\/{{targetHost}}\/api\/v1\/CertificateUserMappings passing X-CSRF-token in header and body with following format:<\/p>\n You can refer for more details to SAP API Business Hub<\/a><\/p>\n <\/p>\n In this blog you’ve gained essential insights into the process of migration of SAP Cloud Platform Integration content from Neo to Cloud Foundry Environment. In the next part of this blog, you will see how to incorporate Int4 IFTT to ensure your migration is successful.<\/p>\n <\/p>\n Integration Content API in SAP API Business Hub<\/a><\/strong><\/p>\n openSAP course on testing SAP CPI (week 3 – Unit 4: SAP Cloud Platform Integration Testing)<\/a><\/strong><\/p>\n SAP Cloud Platform Integration OData API documentation<\/a><\/strong><\/p>\nMigrate with Postman step-by-step<\/b><\/h2>\n<\/span>\n
\n
SAP Cloud Platform Integration on Cloud Foundry – a game worth playing<\/h3>\n
How to migrate integration content from Neo to Cloud Foundry painlessly?<\/h3>\n
Migration: big picture<\/h3>\n
\n
\n
Migration step-by-step guide<\/h3>\n
![\"Change](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/01.-change_credentials.png\")
<\/a><\/p>\n
\n\n
![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/02.-postman_import_button.png\")
<\/a><\/p>\n
\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/03.-postman_request_placeholder.png\")
<\/a><\/p>\n
\n\n
![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/04.-postman_import_upload_files_dialog.png\")
<\/a><\/p>\n
\n\n
![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/05.-postman_import_finish.png\")
<\/a><\/p>\n
\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/06.-postman_collections_after_import.png\")
<\/a><\/p>\n
\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/07.-postman_scripts.png\")
<\/a><\/p>\nMigrate design-time artifacts. Depending on your scenario use following collections:<\/h4>\n
\n
\n<\/div><\/li>\n<\/ul>\n\n
\n<\/div><\/li>\n<\/ul>\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/08.-postman_colleciton_execute.png\")
<\/a><\/p>\n\n
\n<\/div><\/li>\n<\/ul>\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/09.-postman_select_environment_credentials.png\")
<\/a><\/p>\n\n
\n<\/div><\/li>\n<\/ul>\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/10.-postman_successfull_run.png\")
<\/a><\/p>\n
\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/11.-postman_erroneus_run.png\")
<\/a><\/p>\n\n
\n<\/div><\/li>\n<\/ul>\n![\"Cpi](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/12.-cpi_manage_integration_content.png\")
<\/a><\/p>\n
\n![\"CPI](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/13.-CPI_source_design_tab.png\")
<\/a><\/p>\n
\n![\"CPI](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/14.-CPI_target_design_tab.png\")
<\/a><\/p>\n
\nAPI call to add user credential in target tenant<\/h3>\n
\n
![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/15.-postman_xsrf_token.png\")
<\/a><\/p>\n\n
![\"Csrf](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/16.-csrf_token_request.png\")
<\/a><\/p>\n\n
\n{\r\n\r\n\"Name\":\"<credential_name>\",\r\n\r\n\"Kind\":\"<default|openconncetors|successfactors>\",\r\n\r\n\"Description\":\"<description>\",\r\n\r\n\"User\":\"<username>\",\r\n\r\n\"Password\":\"<userpassword>\",\r\n\r\n\"CompanyId\":\"<companyid>\"\r\n\r\n}<\/pre>\n
\n![\"Postman](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/17.-postman_user_credentials.png\")
<\/a><\/p>\n
\n![\"CPI](\"https:\/\/int4.com\/wp-content\/uploads\/2020\/08\/18.-CPI_created_credentials.png\")
<\/a><\/p>\n
\n
\n{\r\n\r\n\"User\": \"user\",\r\n\r\n\"Certificate\": \"certificate in base64 encoded PEM-DER format\"\r\n\r\n}<\/pre>\n
\nSummary<\/h4>\n
Useful links:<\/h4>\n