tencent cloud

オンライン移行ツールの使用ガイドライン
最終更新日:2025-12-09 14:41:53
オンライン移行ツールの使用ガイドライン
最終更新日: 2025-12-09 14:41:53
ここでは、go2tencentcloudマイグレーションツールを使用して、Linux OSサーバーのオンラインマイグレーションを行う方法についてご紹介いたします。

準備事項

Tencent Cloudアカウント、および移行先のCVMがすでにあることが必要です。
移行中に既存のアプリケーションへの影響を回避するために、ソースサーバーのアプリケーションを一時停止することをお勧めします。
移行ツール圧縮パッケージをダウンロードするには、ここ をクリックしてください。
APIキー管理 ページでSecretIdおよびSecretKeyを作成し、取得します。
ソースサーバーと移行先CVMの両方が移行要件を満たしていることを確認します。例えば、移行先CVMのクラウドディスクには、移行元サーバーから移行されたデータを保存するための十分な容量が必要です。
マイグレーション前に、次の方式でデータをバックアップすることをお勧めします:
移行元サーバー:ソースサーバーのスナップショット機能などの方式を選択してデータをバックアップできます。
移行先CVM:スナップショットの作成 などの方式を選択して、移行先CVMのデータをバックアップできます。

マイグレーションツールキットの説明

圧縮パッケージ内のファイルの説明

go2tencentcloud.zipを解凍後のファイルの説明は次のとおりです:
ファイル名
説明
go2tencentcloud-linux.zip
Linux OSのマイグレーション圧縮パッケージです。
readme.txt
ディレクトリ概要ファイルです。
release_notes.txt
マイグレーションツールの変更ログです。
go2tencentcloud-linux.zipを解凍後のファイルの説明は次のとおりです:
ファイル名
説明
go2tencentcloud_x64
64ビット Linux OS用の移行ツールの実行可能プログラムです。
go2tencentcloud_x32
32ビット Linux OS用の移行ツールの実行可能プログラムです。
user.json
マイグレーション時のユーザー情報です。
client.json
マイグレーションツールの設定ファイルです。
rsync_excludes_linux.txt
rsync設定ファイル。Linuxシステムで移行する必要のないファイルとディレクトリを除外します。
ご注意:
設定ファイルは削除できません。設定ファイルはgo2tencentcloudの実行可能なプログラムと同じ階層のディレクトリ下に置いてください。

user.jsonファイルパラメータの説明

user.json設定ファイルの説明は下表のとおりです:
パラメータ名
タイプ
入力必須かどうか
説明
SecretId
String
はい
アカウントAPIアクセスキーのSecretIdです。詳細情報については アクセスキー をご参照ください。
SecretKey
String
はい
アカウントAPIアクセスキーのSecretKeyです。詳細情報については アクセスキー をご参照ください。
Region
String
はい
移行先CVMのリージョンです。入力はリージョンだけでよく、アベイラビリティーゾーンの入力は不要です。値については リージョン リストをご参照ください。
InstanceId
String
はい
移行先CVMのインスタンスIDです。形式は ins-xxxxxxxxのようにします。
DataDisks
Array
いいえ
移行元サーバーからマイグレーションするデータディスクのリストです。各要素はデータディスクを表し、最大20個のデータディスクをサポートします。
DataDisks.Index
Integer
いいえ
データディスクの番号(数値の範囲:[1,20])です。数値1は、このデータディスクが移行先CVMにマウントされた最初のデータディスクにマイグレーションされることを表します。数値 2は、移行先CVMにマウントされた2番目のデータディスクにマイグレーションされることを表します。これにより類推します。
DataDisks.Size
Integer
いいえ
移行元のデータディスクのサイズです。単位はGB、数値の範囲は[10,16000]です。
DataDisks.MountPoint
String
いいえ
移行元のデータディスクのマウントポイントです。 "/mnt/disk1"のようにします。
次の事例を参照して、実際のサービスケースに従って設定ファイルを修正できます。
事例1:Linux移行元サーバー1基をTencent Cloud広州リージョンのCVM1基にマイグレーションする場合、user.json ファイルは次のように構成されます:
{
"SecretId": "your secretId",
"SecretKey": "your secretKey",
"Region": "ap-guangzhou",
"InstanceId": "your instance id"
}
事例2:Linux移行元サーバー1基(データディスク1枚を含む。マウントポイントは/mnt/disk1、サイズは10GB)をTencent Cloud広州リージョンの移行先CVM1基(少なくとも1枚のデータディスクがマウントされている)にマイグレーションする場合、user.jsonファイルは次のように構成されます:
{
"SecretId": "your secretId",
"SecretKey": "your secretKey",
"Region": "ap-guangzhou",
"InstanceId": "your instance id",
"DataDisks": [
{
"Index": 1,
"Size": 10,
"MountPoint": "/mnt/disk1"
}
]
}
事例3:Linux移行元サーバー1基(データディスク2枚を含む。ディスク1のマウントポイントは/mnt/disk1、サイズは10GBで、移行先CVMの最初のデータディスクにマイグレーションしたい場合。ディスク2のマウントポイントは/mnt/disk2、サイズは20GBで、移行先CVMの2番目のデータディスクにマイグレーションしたい場合)をTencent Cloud広州リージョンの移行先CVM1基(少なくとも2枚のデータディスクがマウントされている)にマイグレーションする場合、user.jsonファイルは次のように構成されます:
{
"SecretId": "your secretId",
"SecretKey": "your secretKey",
"Region": "ap-guangzhou",
"InstanceId": "your instance id",
"DataDisks": [
{
"Index": 1,
"Size": 10,
"MountPoint": "/mnt/disk1"
},
{
"Index": 2,
"Size": 20,
"MountPoint": "/mnt/disk2"
}
]
}

client.json ファイルパラメータの説明

client.json設定ファイルの一部の説明は下表のとおりです:
パラメータ名
タイプ
入力必須かどうか
説明
Client.ToolMode
bool
いいえ
ツールマイグレーションモードの識別パラメータです。デフォルトの値はfalseです。ツールモードを使用してマイグレーションする場合は、trueに修正するか、またはツールを実行するときに--no-consoleパラメータを追加してください。
Client.Net.Mode
Integer
はい
マイグレーションモードのパラメータです。デフォルトでは、パブリックネットワークを使用して転送します。数値は0で、数値の範囲:0(パブリックネットワークマイグレーションモード)、1(プライベートネットワークマイグレーションモード:シナリオ1)、2(プライベートネットワークマイグレーションモード:シナリオ2)、3(プライベートネットワークマイグレーションモード:シナリオ3)です。
Client.Extra.IgnoreCheck
Bool
いいえ
デフォルト値はfalseです。デフォルトでは、マイグレーションツールは、ツールの実行開始時に移行元サーバー環境を自動的にチェックします。チェックをスキップする必要がある場合は、trueに設定してください。
Client.Rsync.BandwidthLimit
String
いいえ
速度制限設定項目です。単位はKBytes/s、デフォルト値は空であり、その場合、転送時の速度は制限されません。
Client.Rsync.Checksum
Bool
いいえ
転送検証の項目です。trueに設定すると、転送の整合性の検証を強化することができますが、移行元サーバーCPUは増加します。 転送速度をロードして遅くします。デフォルト値はfalseです。すなわち、デフォルトでは検証を行いません。
移行元サーバーまたは移行先CVMのいずれかがパブリックネットワークに直接アクセスできない場合、まず VPC Peering ConnectionVPN ConnectionCCN または Direct Connection などの方法で接続チャネルを確立してから、プライベートネットワークモードでのマイグレーションを実施する方法を選択することができます。移行元サーバーと移行先CVMのネットワーク環境に応じて、適切なマイグレーションモードを決定してください。

rsync_excludes_linux.txtファイル説明

このファイルは、移行や転送が不要なLinuxの移行元サーバーのファイル、または指定されたディレクトリにある設定ファイルを除外するために使用されます。次のディレクトリとファイルはデフォルトで除外されていますので、設定を削除または変更しないでください
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
他のディレクトリやファイルを削除する必要がある場合は、このファイルの最後に内容を追加してください。例えば、/mnt/disk1にマウントされているデータディスクのすべての内容は削除されます。
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
/mnt/disk1/*

移行ツールのパラメーター

パラメータオプション
説明
--help
ヘルプ情報を印刷します。
--no-console
ツールモードのみを使用したマイグレーション(非コンソールモードのマイグレーション)です。
--check
移行元サーバーをチェックします
--log-file
ログファイルの名前を設定します。デフォルトはlogです。
--log-level
ログ出力レベルです。値の範囲は1(ERRORレベル)、2(INFOレベル)、3(DEBUGレベル)です。デフォルト値は2です。
--clean
移行先CVMは、マイグレーションモードを終了してサイトをクリーンアップすることを強制されます。例えば、コンソールでPlease execute '--clean' option manually.が表示された場合、このオプションを使用してツールを実行し、移行先CVMにマイグレーションモードを終了させてください。
--version
バージョン番号を印刷します。

移行手順

データのバックアップ

移行元サーバー:ソースサーバーのスナップショット機能などの方式を選択してデータをバックアップできます。
移行先CVM:スナップショットの作成 などの方式を選択してデータをバックアップできます。

マイグレーション前の確認

マイグレーションする前に、移行元サーバーと移行先CVMをそれぞれ確認してください。確認する内容は下表のとおりです:
移行先CVM
1. ストレージ容量:移行先CVMのクラウドディスク(システムディスクとデータディスクを含む)には、移行元サーバーから移行されたデータを保存するための十分な容量が必要です。
2. セキュリティグループ:セキュリティグループでは443ポート、80ポートは制限できません。
3. 帯域幅設定:マイグレーションをより迅速に行えるようにするため、できる限り両側の帯域幅を広くすることをお勧めします。マイグレーション中にはデータ量とほぼ同等のトラフィック消費が発生する場合があります。必要に応じ、事前にネットワーク課金モデルの調整を行ってください。
4. 移行先CVMと移行元サーバーのOSタイプが一致しているか:OSが一致していないと、その後に作成するイメージの情報と実際のOSが一致しない場合がありますので、移行先CVMのOSはできる限り移行元サーバーのOSタイプと一致させることをお勧めします。例えば、CentOS 7システムの移行元サーバーのマイグレーションの場合は、CentOS 7システムのCVMを移行先として選択してください。
Linux移行元サーバー
1. Virtioをチェックまたはインストールします。操作の詳細については LinuxでのVirtioドライバーの確認 をご参照ください。
2. 実行which rsyncコマンドで、rsyncがインストールされているかどうかをチェックします。インストールされていない場合は、Rsyncのインストール方法 を参照してインストールしてください。
3. SELinuxが有効になっているかどうかをチェックします。SELinuxが有効になっている場合は、SELinuxを無効化する方法 を参照して無効化してください。
4. Tencent Cloud APIに対しマイグレーションリクエストを送信すると、Tencent Cloud APIは現在のUNIX時間をチェックして発行された Tokenを使用する場合があります。現在のシステム時間が正確であることを確認してください。
説明:
./go2tencentcloud_x64 --no-console --checkなどのツールコマンドを使用して、移行元サーバーを自動的にチェックできます。
go2tencentcloudマイグレーションツールは、実行を開始すると、デフォルトで自動的にチェックします。このチェックをスキップして強制的に移行する場合は、client.json ファイルのClient.Extra.IgnoreCheckフィールドの値をtrueに設定してください。

マイグレーションの開始

Tencent Cloudが提供するgo2tencentcloudマイグレーションツールはブレークポイント転送をサポートし、マイグレーションプロセス全体を次の3つの段階に分割します。ユーザーは、ツールの実行中にマイグレーションの進行状況を直観的に理解することができます。
ステージ1:移行先CVMが移行モードに入り、移行を準備します
ステージ2:移行先CVMが移行モードにあり、データを移行しています
ステージ3:移行先CVMが移行モードを終了し、移行が完了します
各ステージではいずれもいくつかのサブタスクが発生し、関連の操作を実行します。時間がかかる一部のサブタスクには、デフォルトの最大タイムアウト時間が存在します。データ転送の消費時間は、移行元データのサイズ、ネットワーク帯域幅などの要因に左右されます。マイグレーションフローが完了するまでお待ちください。
ご注意:
マイグレーションの開始後、移行先CVMはマイグレーションモードに入ります。マイグレーションが完了してマイグレーションモードを終了するまで、移行先CVMに対してシステムの再インストール、シャットダウン、破棄、パスワードのリセットなどの操作を行わないでください。
パブリックネットワークのマイグレーション
プライベートネットワークマイグレーションシナリオ1
プライベートネットワークマイグレーションシナリオ2
プライベートネットワークマイグレーションシナリオ3
1. マイグレーションツールgo2tencentcloud.zipをダウンロードするか、または移行元サーバーにアップロードし、次のコマンドを実行して対応するディレクトリに進みます。
2. 次のコマンドを順に実行し、go2tencentcloud.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud.zip
cd go2tencentcloud
3. 次のコマンドを順に実行し、go2tencentcloud-linux.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud-linux.zip
cd go2tencentcloud-linux
説明:
go2tencentcloudディレクトリ下のファイルは移行されません。移行が必要なファイルをこのディレクトリ下に置かないでください。
4. user.jsonファイルで移行先CVMを設定します。 user.jsonファイルのパラメータの説明 に従って、必要な項目と必要な値を設定してください。
5. client.jsonファイルでマイグレーションモードとその他の項目を設定します。 client.jsonファイルのClient.ToolModeの値をtrueに設定すると、ツールモードのマイグレーションが標識されます。また、その他の設定が必要な場合は、client.jsonファイルのパラメータの説明 に従って設定してください。
6. (オプション)移行元サーバー上でマイグレーション不要のファイルまたはディレクトリを削除します。 Linux移行元サーバー上でマイグレーション不要のファイルおよびディレクトリがある場合、ファイルおよびディレクトリをrsync_excludes_linux.txtファイル に追加できます。
7. ツールを実行する。 例えば、64ビットのLinux移行元サーバーで、root権限を指定して次のコマンドを実行し、ツールを実行します。
sudo ./go2tencentcloud_x64
ご注意:
client.jsonのClient.ToolModetrueに修正していない場合は、ツールを実行するとき、パラメータ--no-consoleを追加してください。次のとおりです:
sudo ./go2tencentcloud_x64 --no-console
ツール実行後、マイグレーションプロセスが完了するまでしばらく、お待ちください。一般的なパブリックネットワークマイグレーションモードでは、マイグレーションに成功した場合のコンソール出力は、次の図に示したとおりです:


1. 移行元サーバーと移行先CVMの間に接続チャネルを確立します。 VPN Peering Connection / VPN Connection / CCN などの方法によって移行元サーバーと移行先CVMの間に接続チャネルを確立します。
2. マイグレーションツールgo2tencentcloud.zipをダウンロードするか、または移行元サーバーにアップロードし、次のコマンドを実行して対応するディレクトリに進みます。
2.1 次のコマンドを順に実行し、go2tencentcloud.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud.zip
cd go2tencentcloud
2.1 次のコマンドを順に実行し、go2tencentcloud-linux.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud-linux.zip
cd go2tencentcloud-linux
説明:
go2tencentcloudディレクトリ下のファイルは移行されません。移行が必要なファイルをこのディレクトリ下に置かないでください。
3. user.jsonファイルで移行先CVMを設定します。 user.jsonファイルのパラメータの説明 に従って、必要な項目と必要な値を設定してください。
4. client.jsonファイルでマイグレーションモードとその他の項目を設定します。
client.jsonファイルのClient.ToolModeの値をtrueに設定すると、ツールマイグレーションモードが標識されます。
client.jsonファイルのClient.Net.Modeの項目を1に設定すると、プライベートネットワークマイグレーションモード:シナリオ1のマイグレーションを実行します。また、その他の設定が必要な場合は、client.jsonファイルパラメータの説明 に従って設定してください。
5. (オプション)移行元サーバー上でマイグレーション不要のファイルまたはディレクトリを削除します。 Linux移行元サーバー上でマイグレーション不要のファイルおよびディレクトリがある場合、ファイルおよびディレクトリをrsync_excludes_linux.txtファイル に追加できます。
6. パブリックネットワ
ークにアクセスで
きるサーバー(ゲートウェイなど)上でツールを実行します。
例えば、パブリックネットワークにアクセスできるサーバーで、次のコマンドを実行し、ツールを実行して、ステージ1の移行を実行します。
sudo ./go2tencentcloud_x64
ご注意:
client.jsonのClient.ToolModetrueに修正していない場合は、ツールを実行するとき、パラメータ--no-consoleを追加してください。次のとおりです:
sudo ./go2tencentcloud_x64 --no-console
下図に示すように、Stage 1 is finished and please run next stage at source machine.と表示された場合は、ステージ1が完了しています:


7. 移行対象の移行
元サーバー上
でツールを実行します。
ステップ6(ステージ1)が完了した後、まずステージ1のツールディレクトリ全体を移行対象の移行元サーバーにコピーし、次にツールを実行してステージ2の移行を実行します。 例えば、次のコマンドを実行してツールを実行し、ステージ2の移行を実行します。
sudo ./go2tencentcloud_x64
ご注意:
client.jsonのClient.ToolModetrueに修正していない場合は、ツールを実行するとき、パラメータ--no-consoleを追加する必要があります。次のとおりです:
sudo ./go2tencentcloud_x64 --no-console
下図に示すように、Stage 2 is finished and please run next stage at gateway machine.と表示された場合は、ステージ2が完了しています。


8. パブリックネットワークにアクセスできるサーバー(ゲートウェイなど)でツールを実行します。 ステップ7(ステージ2)が完了した後、まずステージ2のツールディレクトリ全体をステージ1のサーバーにコピーし、次にツールを実行してステージ3の移行を実行します。 例えば、次のコマンドを実行してツールを実行し、ステージ3の移行を実行します。
sudo ./go2tencentcloud_x64
ご注意:
client.jsonのClient.ToolModetrueに修正していない場合は、ツールを実行するとき、パラメータ--no-consoleを追加する必要があります。次のとおりです:
sudo ./go2tencentcloud_x64 --no-console
下図に示すように、Migrate successfully.と表示された場合は、すべての移行タスクが完了しています。


1. 移行元サーバーと移行先CVMの間に接続チャネルを確立します。 VPN Peering Connection / VPN Connection / CCN などの方法によって移行元サーバーと移行先CVMの間に接続チャネルを確立します。
2. マイグレーションツールgo2tencentcloud.zipをダウンロードするか、または移行元サーバーにアップロードし、次のコマンドを実行して対応するディレクトリに進みます。
2.1 次のコマンドを順に実行し、go2tencentcloud.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud.zip
cd go2tencentcloud
2.1 次のコマンドを順に実行し、go2tencentcloud-linux.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud-linux.zip
cd go2tencentcloud-linux
説明:
go2tencentcloudディレクトリ下のファイルは移行されません。移行が必要なファイルをこのディレクトリ下に置かないでください。
3. user.jsonファイルで移行先CVMを設定します。 user.jsonファイルのパラメータの説明 に従って、必要な項目と必要な値を設定してください。
4. client.jsonファイルでマイグレーションモードとその他の項目を設定します。
client.jsonファイルのClient.ToolModeの値をtrueに設定すると、ツールマイグレーションモードが標識されます。
client.jsonファイルのClient.Net.Modeの項目を2に設定すると、プライベートネットワークマイグレーションモード:シナリオ2のマイグレーションを実行します。また、その他の設定が必要な場合は、client.jsonファイルパラメータの説明 に従って設定してください。
5. (オプション)移行元サーバー上でマイグレーション不要のファイルまたはディレクトリを削除します。 Linux移行元サーバー上でマイグレーション不要のファイルおよびディレクトリがある場合、ファイルおよびディレクトリをrsync_excludes_linux.txtファイル に追加できます。
6. ツールを実行する。 例えば、64ビットのLinux移行元サーバーで、root権限を指定して次のコマンドを実行し、ツールを実行します。
sudo ./go2tencentcloud_x64
ご注意:
client.jsonのClient.ToolModetrueに修正していない場合は、ツールを実行するとき、パラメータ--no-consoleを追加する必要があります。次のとおりです:
sudo ./go2tencentcloud_x64 --no-console
ツール実行後、マイグレーションプロセスが完了するまでしばらく、お待ちください。一般的には、マイグレーションに成功した場合のコンソール出力情報は、次の図に示したとおりです:


1. 移行元サーバーと移行先CVMの間に接続チャネルを確立します。 VPN Peering Connection / VPN Connection / CCN などの方法によって移行元サーバーと移行先CVMの間に接続チャネルを確立します。
2. マイグレーションツールgo2tencentcloud.zipをダウンロードするか、または移行元サーバーにアップロードし、次のコマンドを実行して対応するディレクトリに進みます。
2.1 次のコマンドを順に実行し、go2tencentcloud.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud.zip
cd go2tencentcloud
2.1 次のコマンドを順に実行し、go2tencentcloud-linux.zipを解凍してディレクトリに進みます。
unzip go2tencentcloud-linux.zip
cd go2tencentcloud-linux
説明:
go2tencentcloudディレクトリ下のファイルは移行されません。移行が必要なファイルをこのディレクトリ下に置かないでください。
3. user.jsonファイルで移行先CVMを設定します。 user.jsonファイルのパラメータの説明に従って、必要な項目と必要な値を設定してください。
4. client.jsonファイルでマイグレーションモードとその他の項目を設定します。
client.jsonファイルのClient.ToolModeの値をtrueに設定すると、ツールマイグレーションモードが標識されます。
client.jsonファイルのClient.Net.Modeの項目を3に設定すると、プライベートネットワークマイグレーションモード:シナリオ3のマイグレーションを実行します。
client.jsonファイルのClient.Net.Proxy.IpClient.Net.Proxy.Portの項目をネットワークプロキシのIPアドレスとポートに設定します。ネットワークプロキシに認証が必要である場合、Client.Net.Proxy.UserClient.Net.Proxy.Passwordの項目にネットワークプロキシのユーザー名とパスワードを記入してください。認証が不要な場合は、空白のままにします。 また、その他の設定が必要な場合は、client.jsonファイルパラメータの説明に従って設定してください。
5. (オプション)移行元サーバー上でマイグレーション不要のファイルまたはディレクトリを削除します。 Linux移行元サーバー上でマイグレーション不要のファイルおよびディレクトリがある場合、ファイルおよびディレクトリをrsync_excludes_linux.txtファイルに追加できます。
6. ツールを実行する。 例えば、64ビットのLinux移行元サーバーで、root権限を指定して次のコマンドを実行し、ツールを実行します。
sudo ./go2tencentcloud_x64
注意:
client.jsonのClient.ToolModetrueに修正していない場合は、ツールを実行するとき、パラメータ--no-consoleを追加してください。次のとおりです:
sudo ./go2tencentcloud_x64 --no-console
ツール実行後、マイグレーションプロセスが完了するまでしばらく、お待ちください。一般的には、マイグレーションに成功した場合のコンソール出力情報は、次の図に示したとおりです:



マイグレーション後の確認

マイグレーションが失敗した場合は、ログファイル(デフォルトではマイグレーションツールディレクトリ下のログファイル)からのエラーメッセージ出力、ガイドラインドキュメントまたは サービスマイグレーションに関するよくあるご質問 を確認し、トラブルシューティングと問題の修正を行ってください。
マイグレーションが成功した場合は、移行先CVMが正常に起動できるか、移行先CVMのデータが移行元サーバーと一致しているか、ネットワークが正常か、他のシステムサービスが正常かなどを確認してください。
ご不明な点やマイグレーションの異常など、ご質問がありましたら、サービスマイグレーションに関するよくあるご質問 をご参照いただくか、または お問い合わせで解決してください。
この記事はお役に立ちましたか?
営業担当者に お問い合わせ いただくか チケットを提出 してサポートを求めることができます。
はい
いいえ

フィードバック