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 sedang berjalan di komputer Anda, yang mencakup instance virtual machine (VM) dan server fisik. Google Cloud Storage juga mengumpulkan data tentang konfigurasi mesin, hardware, jaringan, serta file, layanan, dan proses yang terbuka.

Untuk mesin yang berjalan di platform dengan CLI klien penemuan Pusat Migrasi yang tidak mendukung penemuan inventaris, 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 koleksi tamu untuk mengumpulkan data tentang mesin dan menulis data tersebut ke file tar koleksi tamu untuk komputer Linux, atau file zip untuk komputer Windows.

Komputer yang menghosting CLI mcdc akan mengupload skrip ke mesin target, menjalankannya, lalu mendownload hasilnya. Anda dapat menjalankan skrip secara lokal pada komputer 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 dengan CLI mcdc, Anda dapat melakukan penemuan jarak jauh menggunakan SSH dengan perintah discover ssh.
• Untuk komputer Windows yang dapat diakses oleh CLI mcdc, 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 mesin 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.

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 dikirimkan ke Google atau pihak ketiga lainnya. Data tersebut akan tetap berada di komputer tempat data tersebut dikumpulkan selama mcdc CLI berjalan.

Sebelum memulai

1. Tinjau persyaratan untuk mendownload dan menjalankan mcdc CLI.
2. Tinjau persyaratan untuk mendownload dan menjalankan skrip koleksi 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 koleksi 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 set kredensial diperlukan untuk mengumpulkan data dari jarak jauh:

• Nama pengguna server vCenter diteruskan ke CLI mcdc untuk terhubung ke vSphere, yang harus memiliki hak istimewa berikut di VM:
  • Perubahan 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 mcdc CLI mengumpulkan data yang diperlukan untuk penilaian lengkap.

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

1. Login ke VM Linux yang menghosting CLI mcdc.
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 Anda memiliki kredensial terpisah untuk VM Windows atau Linux, Anda dapat memilih sistem operasi menggunakan flag --os-family.

1. Login ke VM Linux yang menghosting CLI mcdc.
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 ingin, Anda dapat membatasi penemuan hanya pada VM Windows atau Linux menggunakan tanda --os-family, atau mengubah 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 dalam artikel 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 komputer yang menghosting CLI mcdc memiliki akses SSH ke komputer Linux target (komputer Windows tidak didukung), CLI mcdc dapat terhubung ke komputer target melalui SSH untuk mengumpulkan data.

Saat menggunakan SSH, CLI mcdc akan melakukan hal berikut:

1. Mengupload skrip pengumpulan ke mesin.

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

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

3. Mendownload dan mengimpor hasilnya.

Mode SSH yang didukung

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

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

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

Jika Anda menggunakan CLI mcdc pada komputer Windows, hanya mode sematan yang didukung.

Menjalankan pengumpulan

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

1. Login ke komputer Linux yang menghosting CLI mcdc.
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 dari pengguna yang memanggil CLI mcdc digunakan untuk autentikasi SSH.

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

Skenario tambahan saat menggunakan SSH

Lihat skenario berikut saat Anda mungkin perlu 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 pada 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 yang tersemat secara default tidak menggunakan file konfigurasi SSH lokal, 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 akan 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 Pusat Migrasi, atau menjalankan penilaian offline.

Mengumpulkan data dari jarak jauh melalui WMI

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

Saat menggunakan WMI, CLI mcdc akan melakukan hal berikut:

1. Mengupload skrip pengumpulan ke mesin.

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

   Catatan: Meskipun kredensial pengguna mesin tidak memerlukan hak administrator, memiliki akses root memungkinkan mcdc CLI untuk 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 CLI mcdc.
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 jika diminta.

Mengumpulkan data di setiap mesin Linux

Untuk menjalankan pengumpulan tamu secara lokal di mesin Linux, Anda dapat menjalankan skrip mcdc-linux-collect.sh. Kemudian, Anda dapat menyalin file tar yang dihasilkan oleh skrip ke dalam 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 mesin:

   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
    

   Jika ingin, 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 pada setiap komputer Windows

Untuk menjalankan 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 mesin:

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

Langkah selanjutnya

• Pelajari cara menjalankan pemindaian rentang IP.
• Pelajari cara mengekspor data yang dikumpulkan ke Pusat Migrasi.