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, 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 CLI klien penemuan Pusat Migrasi tidak mendukung penemuan inventaris, seperti VM yang berjalan di Azure atau mesin yang berjalan di 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.

Komputer yang menghosting mcdc CLI mengupload skrip ke komputer target, menjalankannya, lalu mendownload hasilnya. Anda dapat menjalankan skrip secara lokal di mesin target, atau menjalankannya dari jarak jauh. Bergantung pada infrastruktur, 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 mcdc CLI, Anda dapat mendownload dan menjalankan skrip pengumpulan tamu secara lokal, lalu mengimpor data yang dikumpulkan secara manual ke komputer yang menghosting mcdc CLI.

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

Penting: CLI mcdc dapat mengumpulkan data yang berpotensi sensitif seperti argumen command line, informasi jaringan, atau variabel dan argumen lingkungan dalam proses yang sedang berjalan. Data sensitif seperti informasi identitas pribadi (PII) tidak pernah dikirim ke Google atau pihak ketiga lainnya. Data tetap berada di mesin tempat data dikumpulkan selama CLI mcdc dijalankan.

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 dari jarak jauh di VM Linux dan Windows. Saat menggunakan alat VMware, alat CLI mcdc akan melakukan hal berikut:

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

Dua kumpulan 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
   Penting: Jika cluster vSphere memiliki beberapa pusat data, Anda harus menggunakan flag --dc untuk menentukan nama pusat data.

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:

Penting: Semua VM yang ingin Anda kumpulkan harus memiliki nama pengguna dan sandi yang sama. Jika memiliki kredensial terpisah untuk VM Windows atau Linux, Anda dapat memilih sistem operasi menggunakan flag --os-family.

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

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.

   Secara opsional, batasi penemuan hanya ke 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 menentukan cakupan 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 Pusat Migrasi, atau menjalankan penilaian offline.

Mengumpulkan data dari jarak jauh melalui SSH

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

Saat menggunakan SSH, CLI mcdc melakukan hal berikut:

1. Mengupload skrip pengumpulan ke mesin.

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

   Catatan: Meskipun kredensial pengguna mesin tidak memerlukan akses root, memiliki akses root memungkinkan CLI mcdc mengumpulkan semua data penilaian.

3. Mendownload dan mengimpor hasilnya.

Mode SSH yang didukung

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

• Default: menggunakan biner dan konfigurasi ssh di mesin 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.

• Tersemat: menggunakan library SSH bawaan. Mode ini memungkinkan Anda menggunakan klien SSH tersemat jika mode default mengalami malfungsi di lingkungan Anda. Namun, file ini tidak menggunakan file konfigurasi SSH lokal secara default. 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. Mengumpulkan data:

   Linux

   ./mcdc discover ssh IP_HOSTNAME

   Windows

   mcdc.exe discover ssh IP_HOSTNAME

   Ganti IP_HOSTNAME dengan nama host IP mesin.

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

   Jika 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 flag -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 flag -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 tersemat:

  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 tersemat 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 tersemat, gunakan flag -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 flag SSH. Kemudian, flag ini diteruskan 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 Pusat Migrasi, atau menjalankan penilaian offline.

Mengumpulkan data dari jarak jauh melalui WMI

Jika 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 mcdc CLI versi Windows.

Saat menggunakan WMI, mcdc CLI akan melakukan hal berikut:

1. Mengupload skrip pengumpulan ke mesin.

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

   Catatan: Meskipun kredensial pengguna komputer tidak memerlukan hak administrator, memiliki akses root memungkinkan mcdc CLI mengumpulkan semua data penilaian.

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 perangkat 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 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 mesin target ke mesin 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 Pusat Migrasi, atau menjalankan penilaian offline.

Mengumpulkan data di setiap komputer 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 CLI mcdc, 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 menghasilkan file zip bernama mcdc-collect-MACHINE_NAME-TIMESTAMP.zip ke direktori saat ini.

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

   .\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 Pusat Migrasi, atau menjalankan penilaian offline.

Langkah selanjutnya

• Pelajari cara menjalankan pemindaian rentang IP.
• Pelajari cara mengekspor data yang dikumpulkan ke Migration Center.