ゲスト検出を実行する

このドキュメントでは、mcdc CLI が提供するさまざまなゲスト検出方法を実行する手順について説明します。

概要

ゲスト検出を使用すると、仮想マシン（VM）インスタンスや物理サーバーなど、マシン上で実行されているアプリケーションに関するデータをスキャンして収集できます。また、マシンの構成、ハードウェア、ネットワーク、オープンファイル、サービス、プロセスに関するデータも収集します。

Azure で実行されている VM やオンプレミスで実行されているマシンなど、移行センターディスカバリークライアント CLI がインベントリ検出をサポートしていないプラットフォームで実行されているマシンや、VMware と AWS で実行されている VM の完全な評価で、ゲスト検出を実行できます。ゲスト検出は、ゲストコレクションスクリプトを使用してマシンに関するデータを収集し、そのデータを Linux マシンのゲストコレクション tar ファイルまたは Windows マシンの ZIP ファイルに書き込みます。

mcdc CLI をホストしているマシンは、スクリプトをターゲットマシンにアップロードして実行し、結果をダウンロードします。スクリプトは、ターゲットマシン上でローカルに実行することも、リモートで実行することもできます。インフラストラクチャに応じて、次の方法で mcdc CLI を使用できます。

VMware にデプロイされた Linux VM と Windows VM の場合、mcdc CLI は discover vsphere コマンドを使用したリモート実行をサポートします。
mcdc CLI からアクセスできる Linux マシンの場合、discover ssh コマンドで SSH を使用してリモート検出を実行できます。
mcdc CLI からアクセスできる Windows マシンでは、discover wmi コマンドで Windows Management Instrumentation（WMI）を使用してリモート検出を実行できます。
mcdc CLI への接続がない Linux マシンと Windows マシンの場合、ゲストコレクションスクリプトをローカルにダウンロードして実行した後、mcdc CLI をホストするマシンに収集したデータを手動でインポートします。

ゲストコレクションスクリプトは、一連のコマンドを実行して移行元のマシンに関する情報を収集します。また、マシン上の複数のファイルからも情報を収集します。

準備

VMware ツールを使用してリモートでデータを収集する

vSphere でホストされている VM の場合、mcdc CLI は VMware ツールを使用して、Linux VM と Windows VM の両方にリモートで収集スクリプトをデプロイして実行できます。VMware ツールを使用する場合、mcdc CLI ツールは次の処理を行います。

収集スクリプトを VM にアップロードします。
VM でスクリプトを実行する
結果をダウンロードしてインポートします。

リモートでデータを収集するには、次の 2 組の認証情報が必要です。

vSphere に接続するために　mcdc　CLI に渡される vCenter Server ユーザー名には、VM に対する次の権限が必要です。
- ゲストオペレーションの変更
- ゲストオペレーションプログラムの実行
- ゲストオペレーションクエリ
VM のユーザー認証情報:
- Windows の場合は、管理者権限が必要です。
- Linux の場合、root アクセス権は必要ありませんが、root アクセス権を使用すると、mcdc CLI は完全な評価に必要なデータを収集できます。

VMware ツールを使用してデータを収集するには、次の手順を行います。

mcdc CLI をホストする Linux VM にログインします。
mcdc CLI をダウンロードしたディレクトリに移動します。
VM の電源がオンになっていることを確認します。
ゲスト検出を実行します。
Linux
```
./mcdc discover vsphere guest --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER VM_ID
```
ウィンドウ
```
mcdc.exe discover vsphere guest --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER VM_ID
```
次のように置き換えます。
- VCENTER_USER: vCenter Server ユーザー
- VM_USER: VM ユーザー
- VM_ID: VM または MOREF の名前
重要: vSphere クラスタに複数のデータセンターがある場合は、--dc フラグを使用してデータセンター名を指定する必要があります。
プロンプトが表示されたら、VCENTER_USER と VM_USER のパスワードを入力します。

VMware ツールを使用して複数の vSphere VM から同時にデータを収集するには、次の手順を行います。

mcdc CLI をホストする Linux VM にログインします。
mcdc CLI をダウンロードしたディレクトリに移動します。
すべての VM の電源がオンになっていることを確認します。
ゲスト検出を実行します。
Linux
```
./mcdc discover vsphere guest all --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER --timeout TIMEOUT_IN_SECONDS
```
ウィンドウ
```
mcdc.exe discover vsphere guest all --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER --timeout TIMEOUT_IN_SECONDS
```
TIMEOUT_IN_SECONDS は秒単位のタイムアウトに置き換えます。

必要に応じて、--os-family フラグを使用して検出を Windows または Linux VM のみに制限するか、--max-parallelism フラグを使用して並列レベルを変更します。
プロンプトが表示されたら、VCENTER_USER と VM_USER のパスワードを入力します。
インベントリディスカバリを実行するにある VMware の説明のように、--path フラグを使用して検出範囲を特定の VM にスコープすることもできます。

この収集したデータはオンラインで移行センターでエクスポートして評価することも、オフライン評価を実行することもできます。

SSH 経由でリモートからデータを収集する

mcdc CLI をホストしているマシンに、ターゲット Linux マシン（Windows マシンはサポートされていません）への SSH アクセス権がある場合、mcdc CLI は、SSH 経由でターゲットマシンに接続してデータを収集できます。

SSH を使用する場合、mcdc CLI は次の処理を行います。

収集スクリプトをマシンにアップロードします。
mcdc CLI に渡されたマシンユーザー認証情報を使用して、マシンでスクリプトを実行します。

注: マシンユーザーの認証情報には root アクセス権は不要ですが、root アクセス権を使用すると、mcdc CLI ですべての評価データを収集できます。
結果をダウンロードしてインポートします。

サポートされている SSH モード

Linux マシンで mcdc CLI を使用している場合、SSH を実行するには次の 2 つのモードを使用できます。

デフォルト: mcdc CLI マシンの ssh バイナリと構成を使用します。デフォルトモードでは、~/.ssh/config や ~/.ssh/known_hosts など、ホストするワークステーションのローカル SSH 構成ファイルがデフォルトで使用されます。

プロンプトが表示されたらパスワードを入力します。または、sshpass を使用してコマンドラインでパスワードまたは秘密鍵ファイルのパスフレーズを渡します。次に例を示します。
```
sshpass -p password mcdc discover ssh IP_ADDRESS
```
IP_ADDRESS は、マシンの IP アドレスに置き換えます。
組み込み: 内蔵型のライブラリを使用します。このモードを使用すると、環境内でデフォルトモードが正常に動作しない場合は、埋め込み SSH クライアントを使用できます。ただし、デフォルトではローカル SSH 構成ファイルは使用されません。-i オプションを使用して、SSH 秘密鍵ファイルを指定できます。

Windows マシンで mcdc CLI を使用している場合は、埋め込みモードのみがサポートされます。

コレクションを実行する

SSH 経由でデータを収集するには、次の手順に沿って操作します。

mcdc CLI をホストしている Linux マシンにログインします。
mcdc CLI をダウンロードしたディレクトリに移動します。
データの収集：
Linux
```
./mcdc discover ssh IP_HOSTNAME
```
ウィンドウ
```
mcdc.exe discover ssh IP_HOSTNAME
```
IP_HOSTNAME は、マシンの IP ホスト名に置き換えます。
mcdc CLI を呼び出すユーザーの SSH 秘密鍵ファイルは、SSH 認証に使用されます。

Linux マシン上のアカウントのユーザー名を求められたら入力します。収集スクリプトはこれらの認証情報を使用して実行されます。mcdc CLI を呼び出したユーザーの SSH 秘密鍵がユーザー名でのマシンの認証に失敗した場合でも、パスワードの入力を求められます。

SSH を使用する場合の追加シナリオ

コマンドの変更が必要になる可能性があるシナリオを次に示します。

デフォルトモードでマシンユーザーを指定するには、-u フラグを使用します。
Linux
```
./mcdc discover ssh -u USER IP_HOSTNAME
```
ウィンドウ
```
mcdc.exe discover ssh -u USER IP_HOSTNAME
```
USER は、マシンのユーザーに置き換えます。

プロンプトが表示されたら、ユーザーのパスワードを入力します。

詳細モードを指定するには、-v フラグを使用します。

Linux

./mcdc discover ssh -u USER -v IP_HOSTNAME

ウィンドウ

mcdc.exe discover ssh -u USER -v IP_HOSTNAME

SSH 秘密鍵ファイルを指定するには、-i フラグを使用します。たとえば、.ssh/my_private_key を指定する場合:
Linux
```
./mcdc discover ssh -i ~/.ssh/my_private_key -u USER IP_HOSTNAME
```
ウィンドウ
```
mcdc.exe discover ssh -i ~/.ssh/my_private_key -u USER IP_HOSTNAME
```
コマンドラインでパスワードを指定するには、埋め込みモードを使用します。
Linux
```
./mcdc discover ssh --ssh-client embedded -u USER --passphrase PASSWORD IP_HOSTNAME
```
ウィンドウ
```
mcdc.exe discover ssh --ssh-client embedded -u USER --passphrase PASSWORD IP_HOSTNAME
```
コマンドの埋め込み形式では、デフォルトでローカル SSH 構成ファイルが使用されないため、コマンドで指定したユーザーが SSH を介してマシンにアクセスできることと、マシンで収集スクリプトを実行する権限を持っていることを確認します。

埋め込みモードで SSH 秘密鍵ファイルを指定するには、-i フラグを使用します。

Linux

./mcdc discover ssh --ssh-client embedded -i ~/.ssh/id_rsa -u USER --password PASSWORD IP_HOSTNAME

ウィンドウ

mcdc.exe discover ssh --ssh-client embedded -i ~/.ssh/id_rsa -u USER --password PASSWORD IP_HOSTNAME

mcdc CLI コマンドでは、ほとんどの SSH フラグを指定できます。次に、-a フラグまたは --ssh-args フラグを使用して、これらのフラグを ssh コマンドに渡します。たとえば、socks プロキシを使用するには:
Linux
```
./mcdc discover ssh -u USER -a '-o' -a 'ProxyCommand=nc -X 5 -x 127.0.0.1:proxy port %h %p' IP_HOSTNAME
```
ウィンドウ
```
mcdc.exe discover ssh -u USER -a '-o' -a 'ProxyCommand=nc -X 5 -x 127.0.0.1:proxy port %h %p' IP_HOSTNAME
```

この収集したデータはオンラインで移行センターでエクスポートして評価することも、オフライン評価を実行することもできます。

WMI 経由でリモートでデータを収集する

WMI をサポートするターゲット Windows マシンでゲスト検出を実行する場合は、mcdc CLI をホストしている Windows マシンで mcdc discover wmi コマンドを使用します。WMI コレクションは、Windows CLI の mcdc バージョンでのみサポートされています。

WMI を使用する場合、mcdc CLI は次の処理を行います。

収集スクリプトをマシンにアップロードします。
mcdc CLI に渡されたマシンユーザー認証情報を使用して、マシンでスクリプトを実行します。

注: マシンユーザーの認証情報には管理者権限は必要ありませんが、root アクセス権を使用すると、mcdc CLI ですべての評価データを収集できます。
結果をダウンロードしてインポートします。

WMI でデータを収集するには、次の手順を行います。

mcdc CLI をホストする Windows マシンにログインします。
mcdc CLI をダウンロードしたディレクトリに移動します。
データの収集：
```
mcdc.exe discover wmi IP_HOSTNAME
```
IP_HOSTNAME は、マシンの IP ホスト名に置き換えます。
プロンプトが表示されたら、認証情報を入力します。

個々の Linux マシンでデータを収集する

Linux マシンでローカルにゲストコレクションを実行するには、mcdc-linux-collect.sh スクリプトを実行します。次に、スクリプトによって生成された tar ファイルを、mcdc CLI をホストするマシンにコピーし、discover import コマンドでインポートできます。

通常は、sudo オプションを指定してスクリプトを実行します。必要に応じて、mcdc CLI を実行しているユーザーの権限を使用してスクリプトを実行できます。ただし、スクリプトによっては、必要なデータがすべて収集されない場合があります。

マシンにログインします。
ゲストコレクションスクリプトをダウンロードしたディレクトリに移動します。

マシンで収集スクリプトを実行します。

sudo ./mcdc-linux-collect.sh

このスクリプトは、mcdc-collect-MACHINE_NAME-TIMESTAMP.tar という名前の tar ファイルを現在のディレクトリに出力します。タイムスタンプの形式は YYYY-MM-DD-hh-mm です。

クリックしてゲストコレクションの tar ファイル形式を表示

tar ファイルの形式は次のとおりです。

collect.log # Log output of the script
 files # Directory containing files with their full path from root. For example:
   |- etc/fstab
   |- etc/hostname
   |- etc/network/interfaces
   |- ...
 commands # Output of commands run by the script:
   |- dpkg
   |- netstat
   |- ps
   |- ...
 found_paths # Text file with the list of installation directories
 machinename # Text file with machine name
 ostype # Text file with operating system type (Linux)
 timestamp # Text file with collection timestamp
 version # Text file with the version of the script

必要に応じて、引数 --output を渡して、tar ファイルを保存するパスを指定できます。

収集したデータをターゲットマシンからホストマシンにコピーします。
収集したデータをホストマシンにインポートします。
Linux
```
./mcdc discover import PATH_TO_TAR
```
ウィンドウ
```
mcdc.exe discover import PATH_TO_TAR
```
PATH_TO_TAR は、YAML ファイルのパスに置き換えます。

この収集したデータはオンラインで移行センターでエクスポートして評価することも、オフライン評価を実行することもできます。

個々の Windows マシンでデータを収集する

Windows マシンでローカルでゲストコレクションを実行するには、mcdc-windows-collect.ps1 スクリプトを実行します。次に、スクリプトによって生成された ZIP ファイルを mcdc CLI をホストするマシンにコピーし、discover import コマンドを使用してインポートできます。

マシンにログインします。
[管理者として実行] オプションを使用して PowerShell を開きます。
mcdc CLI をダウンロードしたディレクトリに移動します。

マシンで収集スクリプトを実行します。

powershell -ExecutionPolicy ByPass -File .\mcdc-windows-collect.ps1

このスクリプトは、mcdc-collect-MACHINE_NAME-TIMESTAMP.zip という名前の ZIP ファイルを現在のディレクトリに出力します。

必要に応じて、出力パスを追加して別の場所を指定できます。
```
.\mcdc-windows-collect.ps1 PATH_FOR_OUTPUT.zip
```
収集したデータをホストマシンにインポートします。
Linux
```
./mcdc discover import PATH_TO_TAR
```
ウィンドウ
```
mcdc.exe discover import PATH_TO_TAR
```
PATH_TO_TAR は、YAML ファイルのパスに置き換えます。

収集したデータをエクスポートして、移行センターでオンラインで評価することも、オフライン評価を実行することもできます。

次のステップ

IP 範囲スキャンを実行する方法を学習する。
収集したデータを移行センターにエクスポートする方法を確認する。

ゲスト検出を実行する

概要

準備

VMware ツールを使用してリモートでデータを収集する

Linux

ウィンドウ

Linux

ウィンドウ

SSH 経由でリモートからデータを収集する

サポートされている SSH モード

コレクションを実行する

Linux

ウィンドウ

SSH を使用する場合の追加シナリオ

Linux

ウィンドウ

Linux

ウィンドウ

Linux

ウィンドウ

Linux

ウィンドウ

Linux

ウィンドウ

Linux

ウィンドウ

WMI 経由でリモートでデータを収集する

個々の Linux マシンでデータを収集する

クリックしてゲスト コレクションの tar ファイル形式を表示

Linux

ウィンドウ

個々の Windows マシンでデータを収集する

Linux

ウィンドウ

次のステップ

クリックしてゲストコレクションの tar ファイル形式を表示