tencent cloud

Feedback

Compatibility and Tool Configuration Description

Last updated: 2022-09-19 17:03:42

    Supported OS

    Operating systems supported by the online migration tool include but not limited to the following:

    LinuxWindows
    CentOS 5/6/7/8Windows Server 2008
    Windows Server 2012
    Windows Server 2016
    Windows Server 2019
    Windows Server 2022
    Ubuntu 10/12/14/16/18/20
    Debian 7/8/9/10
    SUSE 11/12/15
    openSUSE 42
    Amazon Linux AMI
    Red Hat 5/6/7/8
    Oracle Linux 5/6/7/8

    Supported Migration Modes

    If both your source server and destination CVM can access the public network, you can use the public network migration mode.
    In the current public network migration mode, the source server calls Tencent Cloud APIs through the Internet to initiate a migration request, and transfers data to the destination CVM to complete the migration. The public network migration scenario is shown below:

    Files in the compressed package

    After go2tencentcloud.zip is decompressed, it contains the following files:

    File NameDescription
    go2tencentcloud-linux.zipThe migration zip for Linux system.
    go2tencentcloud-windows.zipThe migration zip for Windows system.
    readme.txtDirectory overview file.
    release_notes.txtMigration tool change log.

    After go2tencentcloud-linux.zip is decompressed, it contains the following files:

    File NameDescription
    go2tencentcloud_x64Executable program of the migration tool for the 64-bit Linux operating system.
    go2tencentcloud_x32Executable program of the migration tool for the 32-bit Linux operating system.
    user.jsonUser information in the migration.
    client.jsonConfiguration file of the migration tool.
    rsync_excludes_linux.txtrsync configuration file, which excludes files and directories that do not need to be migrated in the Linux system.

    After go2tencentcloud-windows.zip is decompressed, it contains the following files:

    File NameDescription
    go2tencentcloud_x64.exeExecutable program of the migration tool for the 64-bit Windows operating system.
    user.jsonUser information in the migration.
    client.jsonConfiguration file of the migration tool.
    client.exeExecutable program of the migration tool for the Windows operating system.
    Note

    The configuration files cannot be deleted. You must store them under the same folder as the go2tencentcloud executable program.

    Parameters in the user.json file

    The user.json configuration file is described as below:

    ParameterTypeRequiredDescription
    SecretIdStringYesSecret ID for your account to access APIs. For more information, see Access Key.
    SecretKeyStringYesSecret key for your account to access APIs. For more information, see Access Key.

    Parameters in the client.json file

    The client.json configuration file is described as below:

    Parameter Type Required
    Description
    Client.Extra.IgnoreCheck Bool No The default value is false. The default value is false. The migration tool automatically checks the source server environment upon startup by default. To skip the check, set this parameter to true.
    Client.Extra.Daemon Bool No The default value is false. If you need the migration tool to run in the background, set this parameter to true.
    Client.Net.Proxy.Ip String No The default value is empty. In the private network migration Scenario 3, the IP address of the network proxy needs to be configured.
    Client.Net.Proxy.Port String No The default value is empty. In the private network migration Scenario 3, the port of the network proxy needs to be configured.
    Client.Net.Proxy.User String No The default value is empty. In the private network migration Scenario 3, if your network proxy needs to be verified, configure the username of the network proxy.
    Client.Net.Proxy.Password String No The default value is empty. In the private network migration Scenario 3, if your network proxy needs to be verified, configure the password of the network proxy.
    Note

    Except for the above parameters, other configuration items in the client.json file usually don't need to be entered.

    rsync_excludes_linux.txt file description

    This file is used to exclude files on the Linux source server or configuration files under specified directories that do not need to be migrated. By default, the rsync_excludes_linux.txt file already excludes the following directories and files. Do not delete or modify the existing configurations.

    /dev/*
    /sys/*
    /proc/*
    /var/cache/yum/*
    /lost+found/*
    /var/lib/lxcfs/*
    /var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
    

    To exclude other directories or files, append them to the rsync_excludes_linux.txt file. For example, to exclude all content on the data disk attached to /mnt/disk1, configure the rsync_excludes_linux.txt file as follows:

    /dev/*
    /sys/*
    /proc/*
    /var/cache/yum/*
    /lost+found/*
    /var/lib/lxcfs/*
    /var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
    /mnt/disk1/*
    

    Parameters of the migration tool

    Parameter Description
    --help Prints help information.
    --check Checks the source server
    --log-file Configures the log file name, which is log by default.
    --log-level Configures the logging level. Valid values: 1(ERROR level), 2 (INFO level) and 3(DEBUG level). Default value: 2.
    --version Prints the version number.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support