Migration tool for Cloud Integration
Description
This tool aims to assist SAP customers using SAP Cloud Integration on Neo datacenters who wish to upgrade to SAP Integration Suite on Multi-Cloud datacenters.
Important: There is an official migration pack available via SAP Note 2937549 which leverages a collection of Postman scripts. This Github repository is not related with the official migration pack mentioned in the SAP Note. However, the functionality is very similar (as compared to Postman collection version 1.5.0 (Feb 2021)).
This Github repository is an alternative tool which aims to achieve the same as the Postman collection while offering greater flexibility and control over your migration project. Areas where this tool provides an advantage over the Postman collection:
- Creation of 'Migration Tasks' which focus on a subset of the content in the tenant;
- Advanced features like script scanning;
- Area for customization to include your own code or migration logic;
- API enabled, to run specific Migration Tasks from external triggers (e.g. CI-CD or Job Scheduling);
This tool is provided as-is and is not covered by SAP Support.
Requirements
You will need:
- A SAP Cloud Integration tenant on Neo (source system)
- A SAP Integration Suite tenant on Cloud Foundry (target system)
If you don't have a SAP Integration Suite license yet, you can use the BTP Free Tier available at no cost. See https://blogs.sap.com/2021/11/17/sap-integration-suite-free-tier-is-now-available-on-sap-btp/
Download & Installation
This tool is designed to run locally on your own laptop, server or VM. It is developed using the SAP Cloud Application Programming Model, using Node.js as server language.
Locally stored data is kept in a local SQLite database file.
Use Docker
You can use the provided Dockerfile to install and run the application:
In Terminal or Command Prompt, run:
- Download this tool from git:
git clone https://github.com/SAP/migration-tool-for-cloud-integration.git
- Build this tool:
docker build -t migrationtool ./migration-tool-for-cloud-integration
Now the tool is build and can be started:
- Start the tool:
docker run -p 4004:4004 migrationtool
- Open your local browser to:
http://localhost:4004/home.html
To stop the tool, in Terminal or Command Prompt, press control-C
Manual Install
It is required to have an active installation of Node.js (version 14.5 or later), available from the Node.js website, including Node Package Manager (NPM). You can verify your installed version via node -v
.
To install, in Terminal or Command Prompt, run:
- Install the SAP CAP SDK 'CDS-DK':
npm i -g @sap/cds-dk
- Download this tool from git:
git clone https://github.com/SAP/migration-tool-for-cloud-integration.git
- Install this tool:
npm install
- Prepare/rebuild the SQLite database:
cds deploy --to sqlite --with-mocks
Now the tool is installed and can be started:
- Start the tool:
npm start
- Open your local browser to:
http://localhost:4004/home.html
To stop the tool, in Terminal or Command Prompt, press control-C
Documentation
To learn how to use the tool, please refer to the user documentation.
Version Dependencies
SAP UI5 version info and issue log
- 1.95.0: Most stable, but does not support showCount=true (manifest) for Task Items table in MigrationTasks > Detail screen
- 1.96.2: Issue: does not show Integration Artifacts table in Explore Tenant > Integration Packages > Detail screen
- 1.97.0: Issue: does not show Integration Artifacts table in Explore Tenant > Integration Packages > Detail screen, but solves the showCount issue of 1.95.0
Specify the version to be used in /app/home.html
Version availability: https://ui5.sap.com/versionoverview.html
SAP CDS version info and issue log
- 5.5.4: Works
- 5.6.2: Issue: UPDATE function to update ExistInSource columns in MigrationTasks has bugs
- 5.7.3: Stable
More information on changelog: https://cap.cloud.sap/docs/releases
Known Issues
The very first time that the tool is started, it might not start correctly. If the following line is not shown when starting the script you should restart it for it to function correctly:
[cds] - mocking IntegrationContent.sap.hci.api { at: '/api' }
See also: FAQ and Limitations
How to Obtain Support
Please search or create a new Issue in this Github repository to obtain support.
Contributing
Contributions are certainly welcome, see ways to contribute.
Code of Conduct
See Our Code of Conduct.
Licensing
Copyright 2021 SAP SE or an SAP affiliate company and migration-tool-for-cloud-integration contributors. Please see our LICENSE for copyright and license information.