Menjalankan penemuan tamu

Dokumen ini menjelaskan langkah-langkah untuk menjalankan berbagai metode penemuan tamu yang disediakan oleh CLI mcdc.

Ringkasan

Penemuan tamu memungkinkan Anda memindai dan mengumpulkan data tentang aplikasi yang berjalan di komputer Anda, yang mencakup instance virtual machine (VM) dan server fisik. Alat ini juga mengumpulkan data tentang konfigurasi mesin, hardware, jaringan, serta file, layanan, dan proses yang terbuka.

Untuk mesin yang berjalan di platform yang tidak mendukung penemuan inventaris oleh CLI discovery client Migration Center, seperti VM yang berjalan di Azure atau mesin yang berjalan secara lokal, serta untuk penilaian lengkap VM yang berjalan di VMware dan AWS, Anda dapat menjalankan penemuan tamu. Penemuan tamu menggunakan skrip pengumpulan tamu untuk mengumpulkan data tentang mesin dan menulis data tersebut ke file tar pengumpulan tamu untuk mesin Linux, atau file zip untuk mesin Windows.

Mesin yang menghosting mcdc CLI mengupload skrip ke mesin target, menjalankannya, lalu mendownload hasilnya. Anda dapat menjalankan skrip secara lokal di mesin target, atau menjalankannya dari jarak jauh. Bergantung pada infrastruktur Anda, Anda dapat memilih untuk menggunakan CLI mcdc dengan cara berikut:

  • Untuk VM Linux dan Windows yang di-deploy di VMware, CLI mcdc mendukung eksekusi jarak jauh dengan perintah discover vsphere.
  • Untuk mesin Linux yang dapat diakses oleh CLI mcdc, Anda dapat melakukan penemuan jarak jauh menggunakan SSH dengan perintah discover ssh.
  • Untuk komputer Windows yang dapat diakses oleh mcdc CLI, Anda dapat melakukan penemuan jarak jauh menggunakan Windows Management Instrumentation (WMI) dengan perintah discover wmi.
  • Untuk komputer Linux dan Windows tanpa koneksi ke CLI mcdc, Anda dapat mendownload dan menjalankan skrip pengumpulan tamu secara lokal, lalu mengimpor data yang dikumpulkan secara manual ke komputer yang menghosting CLI mcdc.

Skrip pengumpulan tamu menjalankan serangkaian perintah untuk mengumpulkan informasi tentang mesin sumber dan juga mengumpulkan informasi dari beberapa file di mesin.

Sebelum memulai

  1. Tinjau persyaratan untuk mendownload dan menjalankan mcdc CLI.
  2. Tinjau persyaratan untuk mendownload dan menjalankan skrip pengumpulan tamu.
  3. Selesaikan langkah-langkah untuk mendownload mcdc CLI.

Mengumpulkan data dari jarak jauh menggunakan alat VMware

Untuk VM yang dihosting di vSphere, CLI mcdc dapat menggunakan alat VMware untuk men-deploy dan menjalankan skrip pengumpulan secara jarak jauh di VM Linux dan Windows. Saat menggunakan alat VMware, alat CLI mcdc melakukan hal berikut:

  • Mengupload skrip pengumpulan ke VM.
  • Menjalankan skrip di VM.
  • Mendownload dan mengimpor hasilnya.

Dua set kredensial diperlukan untuk mengumpulkan data dari jarak jauh:

  • Nama pengguna server vCenter yang diteruskan ke CLI mcdc untuk terhubung ke vSphere, yang harus memiliki hak istimewa berikut di VM:
    • Modifikasi operasi tamu
    • Eksekusi program operasi tamu
    • Kueri operasi tamu
  • Kredensial pengguna untuk VM:
    • Di Windows, Anda harus memiliki hak istimewa administrator.
    • Di Linux, akses root tidak diperlukan, tetapi akses root memungkinkan CLI mcdc mengumpulkan data yang diperlukan untuk penilaian lengkap.

Untuk mengumpulkan data menggunakan alat VMware, ikuti langkah-langkah berikut:

  1. Login ke VM Linux yang menghosting mcdc CLI.
  2. Ubah ke direktori tempat Anda mendownload CLI mcdc.
  3. Pastikan VM dinyalakan.

  4. Jalankan penemuan tamu:

    Linux

    ./mcdc discover vsphere guest --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER VM_ID

    Windows

    mcdc.exe discover vsphere guest --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER VM_ID

    Ganti kode berikut:

    • VCENTER_USER: pengguna server vCenter
    • VM_USER: pengguna VM
    • VM_ID: nama VM atau MOREF

  5. Saat diminta, masukkan sandi untuk VCENTER_USER dan VM_USER.

Untuk mengumpulkan data dari beberapa VM vSphere secara paralel menggunakan alat VMware, ikuti langkah-langkah berikut:

  1. Login ke VM Linux yang menghosting mcdc CLI.
  2. Ubah ke direktori tempat Anda mendownload CLI mcdc.
  3. Pastikan semua VM dinyalakan.

  4. Jalankan penemuan tamu:

    Linux

    ./mcdc discover vsphere guest all --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER --timeout TIMEOUT_IN_SECONDS

    Windows

    mcdc.exe discover vsphere guest all --url https://VSPHERE_URL -u VCENTER_USER --vm-user VM_USER --timeout TIMEOUT_IN_SECONDS

    Ganti TIMEOUT_IN_SECONDS dengan waktu tunggu dalam detik.

    Jika perlu, batasi penemuan hanya untuk VM Windows atau Linux menggunakan tanda --os-family, atau ubah tingkat paralelisme menggunakan tanda --max-parallelism.

  5. Saat diminta, masukkan sandi untuk VCENTER_USER dan VM_USER.

  6. Anda juga dapat mencakup penemuan ke VM tertentu menggunakan flag --path, seperti yang dijelaskan untuk VMware di Menjalankan penemuan inventaris.

Anda dapat mengekspor dan menilai data yang dikumpulkan ini secara online di Migration Center, atau menjalankan penilaian offline.

Mengumpulkan data dari jarak jauh melalui SSH

Jika komputer yang menghosting mcdc CLI memiliki akses SSH ke komputer Linux target (komputer Windows tidak didukung), maka mcdc CLI dapat terhubung ke komputer target melalui SSH untuk mengumpulkan data.

Saat menggunakan SSH, CLI mcdc melakukan hal berikut:

  1. Mengupload skrip pengumpulan ke komputer.

  2. Menjalankan skrip di komputer dengan kredensial pengguna komputer yang diteruskan ke mcdc CLI.

  3. Mendownload dan mengimpor hasilnya.

Mode SSH yang didukung

Jika Anda menggunakan mcdc CLI di komputer Linux, Anda dapat menggunakan dua mode untuk menjalankan SSH:

  • Default: menggunakan biner dan konfigurasi ssh di komputer CLI mcdc. Mode default dapat menggunakan file konfigurasi SSH lokal secara default, seperti ~/.ssh/config dan ~/.ssh/known_hosts, dari workstation yang menghostingnya.

    Masukkan sandi saat diminta, atau gunakan sshpass untuk meneruskan sandi atau frasa sandi file kunci pribadi di command line. Contoh:

    sshpass -p password mcdc discover ssh IP_ADDRESS

    Ganti IP_ADDRESS dengan alamat IP mesin.

  • Disematkan: menggunakan library SSH bawaan. Mode ini memungkinkan Anda menggunakan klien SSH tersemat jika mode default tidak berfungsi di lingkungan Anda. Namun, secara default, perintah ini tidak menggunakan file konfigurasi SSH lokal. Anda dapat menggunakan flag -i untuk menentukan file kunci pribadi SSH.

Jika Anda menggunakan CLI mcdc di komputer Windows, hanya mode tersemat yang didukung.

Menjalankan koleksi

Untuk mengumpulkan data melalui SSH, ikuti langkah-langkah berikut:

  1. Login ke mesin Linux yang menghosting mcdc CLI.
  2. Ubah ke direktori tempat Anda mendownload CLI mcdc.

  3. Kumpulkan data.

    Linux

    ./mcdc discover ssh IP_HOSTNAME

    Windows

    mcdc.exe discover ssh IP_HOSTNAME

    Untuk menemukan dan mengumpulkan aset database, gunakan tanda --db-engine:

    Linux

    ./mcdc discover ssh IP_HOSTNAME --db-engine=DB_ENGINE

    Windows

    mcdc.exe discover ssh IP_HOSTNAME --db-engine=DB_ENGINE

    Ganti kode berikut:

    • IP_HOSTNAME: nama host IP mesin.
    • DB_ENGINE: mesin database yang akan dikumpulkan. Nilai yang didukung adalah sqlserver, mysql, postgresql.

  4. File kunci pribadi SSH pengguna yang memanggil CLI mcdc digunakan untuk autentikasi SSH.

    Saat diminta, masukkan nama pengguna akun di komputer Linux. Skrip pengumpulan berjalan menggunakan kredensial ini. Jika kunci pribadi SSH pengguna yang memanggil CLI mcdc gagal melakukan autentikasi ke mesin dengan nama pengguna, Anda juga akan dimintai sandi.

Skenario tambahan saat menggunakan SSH

Lihat skenario berikut yang mungkin mengharuskan Anda mengubah perintah:

  • Untuk menentukan pengguna mesin dengan mode default, gunakan tanda -u:

    Linux

    ./mcdc discover ssh -u USER IP_HOSTNAME

    Windows

    mcdc.exe discover ssh -u USER IP_HOSTNAME

    Ganti USER dengan pengguna mesin.

    Saat diminta, masukkan sandi untuk pengguna.

  • Untuk menentukan mode panjang, gunakan tanda -v:

    Linux

    ./mcdc discover ssh -u USER -v IP_HOSTNAME

    Windows

    mcdc.exe discover ssh -u USER -v IP_HOSTNAME

  • Untuk menentukan file kunci pribadi SSH, gunakan flag -i. Misalnya, untuk menentukan .ssh/my_private_key:

    Linux

    ./mcdc discover ssh -i ~/.ssh/my_private_key -u USER IP_HOSTNAME

    Windows

    mcdc.exe discover ssh -i ~/.ssh/my_private_key -u USER IP_HOSTNAME

  • Untuk menentukan sandi di command line, gunakan mode sematan:

    Linux

    ./mcdc discover ssh --ssh-client embedded -u USER --passphrase PASSWORD IP_HOSTNAME

    Windows

    mcdc.exe discover ssh --ssh-client embedded -u USER --passphrase PASSWORD IP_HOSTNAME

    Karena bentuk perintah yang disematkan tidak menggunakan file konfigurasi SSH lokal secara default, pastikan pengguna yang Anda tentukan dalam perintah dapat mengakses mesin melalui SSH dan memiliki hak istimewa di mesin untuk menjalankan skrip pengumpulan.

  • Untuk menentukan file kunci pribadi SSH dengan mode sematan, gunakan tanda -i:

    Linux

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

    Windows

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

  • Perintah CLI mcdc memungkinkan Anda menentukan sebagian besar tanda SSH. Kemudian, meneruskan flag ini ke perintah ssh menggunakan flag -a atau --ssh-args. Misalnya, untuk menggunakan proxy 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

    Windows

    mcdc.exe discover ssh -u USER -a '-o' -a 'ProxyCommand=nc -X 5 -x 127.0.0.1:proxy port %h %p' IP_HOSTNAME

Anda dapat mengekspor dan menilai data yang dikumpulkan ini secara online di Migration Center, atau menjalankan penilaian offline.

Mengumpulkan data dari jarak jauh melalui WMI

Jika Anda ingin melakukan penemuan tamu di mesin Windows target dengan dukungan WMI, Anda dapat menggunakan perintah mcdc discover wmi di mesin Windows yang menghosting CLI mcdc. Pengumpulan WMI hanya didukung di CLI mcdc versi Windows.

Saat menggunakan WMI, CLI mcdc akan melakukan hal berikut:

  1. Mengupload skrip pengumpulan ke komputer.

  2. Menjalankan skrip di komputer dengan kredensial pengguna komputer yang diteruskan ke mcdc CLI.

  3. Mendownload dan mengimpor hasilnya.

Untuk mengumpulkan data melalui WMI, ikuti langkah-langkah berikut:

  1. Login ke komputer Windows yang menghosting mcdc CLI.
  2. Ubah ke direktori tempat Anda mendownload CLI mcdc.

  3. Mengumpulkan data:

    mcdc.exe discover wmi IP_HOSTNAME

    Ganti IP_HOSTNAME dengan nama host IP mesin.

  4. Masukkan kredensial Anda saat diminta.

Mengumpulkan data di setiap mesin Linux

Untuk melakukan pengumpulan tamu secara lokal di komputer Linux, Anda dapat menjalankan skrip mcdc-linux-collect.sh. Kemudian, Anda dapat menyalin file tar yang dihasilkan oleh skrip ke mesin yang menghosting CLI mcdc, dan mengimpornya dengan perintah discover import.

Anda biasanya menjalankan skrip dengan menentukan opsi sudo. Secara opsional, Anda dapat menjalankan skrip menggunakan hak istimewa pengguna yang menjalankan CLI mcdc. Namun, skrip mungkin tidak dapat mengumpulkan semua data yang diperlukan.

  1. Login ke komputer Anda.
  2. Ubah ke direktori tempat Anda mendownload skrip pengumpulan tamu.

  3. Jalankan skrip pengumpulan di komputer:

    sudo ./mcdc-linux-collect.sh

    Skrip ini akan menghasilkan file tar bernama mcdc-collect-MACHINE_NAME-TIMESTAMP.tar ke direktori saat ini. Stempel waktu menggunakan format YYYY-MM-DD-hh-mm.

    Klik untuk melihat format file tar koleksi tamu

    File tar memiliki format berikut:

    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

    Secara opsional, Anda dapat meneruskan argumen --output dan menentukan jalur tempat Anda ingin menyimpan file tar.

  4. Salin data yang dikumpulkan dari komputer target ke komputer host.

  5. Impor data yang dikumpulkan di mesin host:

    Linux

    ./mcdc discover import PATH_TO_TAR

    Windows

    mcdc.exe discover import PATH_TO_TAR

    Ganti PATH_TO_TAR dengan jalur ke file tar.

Anda dapat mengekspor dan menilai data yang dikumpulkan ini secara online di Migration Center, atau menjalankan penilaian offline.

Mengumpulkan data di masing-masing mesin Windows

Untuk melakukan pengumpulan tamu secara lokal di komputer Windows, Anda dapat menjalankan skrip mcdc-windows-collect.ps1. Kemudian, Anda dapat menyalin file zip yang dihasilkan oleh skrip ke mesin yang menghosting mcdc CLI, dan mengimpornya dengan perintah discover import.

  1. Login ke komputer Anda.
  2. Buka PowerShell menggunakan opsi Run as Administrator.
  3. Ubah ke direktori tempat Anda mendownload CLI mcdc.

  4. Jalankan skrip pengumpulan di komputer:

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

  5. Skrip ini akan menghasilkan file zip bernama mcdc-collect-MACHINE_NAME-TIMESTAMP.zip ke direktori saat ini.

    Secara opsional, Anda dapat menyertakan jalur output untuk menentukan lokasi yang berbeda:

    .\mcdc-windows-collect.ps1 PATH_FOR_OUTPUT.zip

  6. Impor data yang dikumpulkan di mesin host:

    Linux

    ./mcdc discover import PATH_TO_TAR

    Windows

    mcdc.exe discover import PATH_TO_TAR

    Ganti PATH_TO_TAR dengan jalur ke file tar.

Anda dapat mengekspor data yang dikumpulkan dan menilainya secara online di Migration Center, atau menjalankan penilaian offline.

Langkah berikutnya