EasyYitian migration tool

更新时间:
复制 MD 格式

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:

Install EasyYitian

  1. Log on to the Linux server where you want to install the EasyYitian migration tool.

  2. Download the Docker image for EasyYitian.

    Important

    If 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.tar
  3. Load the Docker image for EasyYitian.

    sudo docker load -i easyyitian_1.0.0.tar

    When a message similar to the following one is returned, the Docker image is loaded successfully.

    image.png

  4. View the Docker image ID.

    sudo docker images

    The value in the IMAGE ID column is the image ID.

    image.png

  5. Start the easyyitian service.

    sudo docker run -itd -p <port>:8000 -v </path/to/local/volume>:/app/workspace --name easyyitian <imageId>
    Important
    • Replace <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.

    image.png

Use EasyYitian

Log on to the EasyYitian migration tool

  1. 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.

  2. 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.

  1. In the navigation pane on the left, click Code Compatibility Scan.

  2. 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.

  3. In the Actions column for the task, click Details to go to the scan details page.

  4. On the task scan details page, click Trigger Scan.

    Note

    Scanning large files may take a long time. You can click View Execution Records in the Operation column to view the scan progress.

  5. When the scan task status is image.png, 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.

      image.png

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.