EasyYitian migration tool
EasyYitian is an Alibaba Cloud tool platform that helps you migrate applications to YiTian ECS. The platform provides software compatibility scanning, environment compatibility analysis, cross-architecture compilation, and pre-configured images. It also offers performance comparison and tuning. EasyYitian is a unified platform of tools, images, and migration guides that supports the entire migration process. This platform helps you solve common migration problems and quickly move your services and applications to YiTian ECS instances.
Prerequisites
The server on which you install the EasyYitian migration tool must meet the following conditions:
It must be a Linux server with an x86 architecture.
Docker must be installed. For more information, see Install and use Docker and Docker Compose.
Install EasyYitian
Log on to the Linux server where you want to install the EasyYitian migration tool.
Download the Docker image for EasyYitian.
ImportantIf the server cannot access the Internet, download the image on another server and then upload it to this server.
wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20231024/ohqx/easyyitian_1.0.0.tarLoad the Docker image for EasyYitian.
sudo docker load -i easyyitian_1.0.0.tarWhen a message similar to the following one is returned, the Docker image is loaded successfully.
[ecs-user@test ~]$ sudo docker load -i easyyitian_1.0.0.tar 1652fa8f3795: Loading layer [==================================================>] 222.6MB/222.6MB 8d514f4d6278: Loading layer [==================================================>] 390.4MB/390.4MB f516b8432e65: Loading layer [==================================================>] 1.536kB/1.536kB 73ae67fdbf8f: Loading layer [==================================================>] 2.56kB/2.56kB 24a817cd24e0: Loading layer [==================================================>] 16.15MB/16.15MB c9b7b0c69de4: Loading layer [==================================================>] 212.8MB/212.8MB 1cfb3610f214: Loading layer [==================================================>] 297.3MB/297.3MB 2a9b359a60d8: Loading layer [==================================================>] 35.3MB/35.3MB 86e44d82033e: Loading layer [==================================================>] 21.53MB/21.53MB f40a8316b7d1: Loading layer [==================================================>] 18.82MB/18.82MB a25679096dbf: Loading layer [==================================================>] 728.1kB/728.1kB 3652aa10708d: Loading layer [==================================================>] 35.52MB/35.52MB 791c07d33d50: Loading layer [==================================================>] 13.82kB/13.82kB 31ae7eac9d06: Loading layer [==================================================>] 5.12kB/5.12kB Loaded image ID: sha256:18d3c49bec8a73022fa0ebbd298eb9eea335588adcf712725fb72db198025a07View the Docker image ID.
sudo docker imagesThe value in the IMAGE ID column is the image ID.
[ecs-user@test ~]$ sudo docker images REPOSITORY TAG IMAGE ID CREATED SIZE <none> <none> 18d3c49bec8a 5 days ago 1.23GBStart the easyyitian service.
sudo docker run -itd -p <port>:8000 -v </path/to/local/volume>:/app/workspace --name easyyitian <imageId>ImportantReplace
<port>with an actual port number, such as 8000. You must open this port in the security group.Replace
</path/to/local/volume>with the path of the local volume that you want to mount, such as /home/user.Replace
<imageId>with the image ID that you obtained in step 4.
When a message similar to the following one is returned, the easyyitian service is started successfully.
[ecs-user@test ~]$ sudo docker run -itd -p 8000:8000 -v /home/esc-user:/app/workspace --name easyytitian 18d3c49bec8a 578ac0122c0da956bda739c172c0981027a970 6d6a7e527b3c32ec
Use EasyYitian
Log on to the EasyYitian migration tool
In your local browser, enter
http://{hostip}:{port}/. Enter your Account and Password, and then click Logon.Note{hostip}is the public IP address of the server on which the EasyYitian tool is installed.{port}is the port number that you set in step 5.The default account is admin and the default password is easyyitian.
If you install the EasyYitian migration tool on an Elastic Compute Service (ECS) instance, add an inbound rule to the security group to allow traffic from the IP address of your local machine. For more information, see Add a security group rule.
On the server on which the EasyYitian tool is installed, shut down the firewall:
sudo systemctl stop firewalld.service.
After you log on, you can view an introduction to the EasyYitian platform and its features.
Code Compatibility Scan
The code compatibility scan feature scans C/C++, Assembly, Java, Python, Node.js, Golang, and Rust code. This feature helps you resolve code compatibility issues when you migrate your software stack to YiTian ECS.
In the navigation pane on the left, click Code Compatibility Scan.
Click Create Task. In the Code Compatibility Scan dialog box, enter the task parameters and click Create.
Parameter
Description
Task Name
Enter a name for the code scan task. The name can contain only uppercase letters, lowercase letters, digits, underscores (_), and hyphens (-).
Scan Method
Currently, only uploading a source code package is supported. The maximum size of a source code package is 2 GB.
Target Instruction Set Architecture
This can only be set to arm64.
Language Selection
Select the language of the source code package.
Task Description
Enter a description for the scan task.
In the Actions column for the task, click Details to go to the scan details page.
On the task scan details page, click Trigger Scan.
NoteScanning large files may take a long time. You can click View Execution Records in the Operation column to view the scan progress.
When the scan task status is
, you can click View in the Actions column to view the scan results.The Scan Result area displays the issues found in the source code package and provides specific suggestions. You can modify the source code based on these suggestions to ensure compatibility with YiTian ECS.
Below the Scan Result area, all potential issue paths and detailed suggestions are displayed. You can modify the code based on these suggestions to ensure compatibility with YiTian ECS.
Use EasyBuild to build applications for YiTian servers
EasyBuild is a container image solution for cross-architecture compilation and building. It lets you compile and build services and applications for YiTian ECS in an x86 environment. This simple, reliable, and easy-to-use solution resolves issues with the compilation and build environment during your migration to YiTian.
In the navigation pane on the left, click EasyBuild to view detailed instructions on how to use EasyBuild.