Mengelola dan memelihara agen Connnected Machine

  • Artikel

Perhatian

Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan perencanaan Anda yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.

Setelah penyebaran awal agen Azure Koneksi ed Machine, Anda mungkin perlu mengonfigurasi ulang agen, meningkatkannya, atau menghapusnya dari komputer. Tugas pemeliharaan rutin ini dapat dilakukan secara manual atau melalui otomatisasi (yang mengurangi kesalahan operasional dan pengeluaran). Artikel ini menjelaskan aspek operasional agen. Lihat dokumentasi CLI azcmagent untuk informasi referensi baris perintah.

Menginstal versi agen tertentu

Microsoft merekomendasikan penggunaan versi terbaru agen Azure Koneksi ed Machine untuk pengalaman terbaik. Namun, jika Anda perlu menjalankan versi agen yang lebih lama karena alasan apa pun, Anda dapat mengikuti instruksi ini untuk menginstal versi agen tertentu.

Tautan ke rilis agen Windows saat ini dan sebelumnya tersedia di bawah judul setiap catatan rilis. Jika Anda mencari versi agen yang berusia lebih dari 6 bulan, lihat arsip catatan rilis.

Meningkatkan agen

Agen Azure Connected Machine diperbarui secara berkala dengan perbaikan bug, peningkatan stabilitas, dan fungsionalitas baru. Azure Advisor mengidentifikasi sumber daya yang tidak menggunakan versi terbaru agen mesin dan merekomendasikan agar Anda meningkatkan ke versi terbaru. Anda akan diberi tahu saat Anda memilih server yang didukung Azure Arc dengan menampilkan banner di halaman Gambaran Umum atau saat Anda mengakses Advisor melalui portal Microsoft Azure.

Agen Azure Connected Machine untuk Windows dan Linux dapat ditingkatkan ke rilis terbaru secara manual atau otomatis tergantung pada kebutuhan Anda. Menginstal, meningkatkan, atau menghapus instalan Azure Koneksi ed Machine Agent tidak akan mengharuskan Anda untuk memulai ulang server Anda.

Tabel berikut menjelaskan metode yang didukung untuk melakukan peningkatan agen:

Sistem operasi Metode peningkatan
Windows Secara manual…
Microsoft Update
Ubuntu Apt
SUSE Linux Enterprise Server zypper

Agen Windows

Versi terbaru agen Azure Koneksi ed Machine untuk komputer berbasis Windows dapat diperoleh dari:

Konfigurasi Microsoft Update

Cara yang direkomendasikan untuk selalu memperbarui agen Windows adalah dengan mendapatkan versi terbaru secara otomatis melalui Microsoft Update. Ini memungkinkan Anda untuk menggunakan infrastruktur pembaruan yang ada (seperti Microsoft Configuration Manager atau Windows Server Update Services) dan menyertakan pembaruan agen Azure Koneksi ed Machine dengan jadwal pembaruan OS reguler Anda.

Windows Server tidak memeriksa pembaruan di Microsoft Update secara default. Untuk menerima pembaruan otomatis untuk Azure Koneksi ed Machine Agent, Anda harus mengonfigurasi klien Windows Update pada komputer untuk memeriksa produk Microsoft lainnya.

Untuk Windows Server yang termasuk dalam grup kerja dan tersambung ke Internet untuk memeriksa pembaruan, Anda bisa mengaktifkan Microsoft Update dengan menjalankan perintah berikut di PowerShell sebagai administrator:

$ServiceManager = (New-Object -com "Microsoft.Update.ServiceManager")
$ServiceID = "7971f918-a847-4430-9279-4a52d1efe18d"
$ServiceManager.AddService2($ServiceId,7,"")

Untuk Windows Server yang termasuk dalam domain dan tersambung ke Internet untuk memeriksa pembaruan, Anda dapat mengonfigurasi pengaturan ini dalam skala besar menggunakan Kebijakan Grup:

  1. Masuk ke komputer yang digunakan untuk administrasi server dengan akun yang dapat mengelola Objek Kebijakan Grup (GPO) untuk organisasi Anda.

  2. Buka Konsol Manajemen Kebijakan Grup.

  3. Perluas unit forest, domain, dan organisasi untuk memilih cakupan yang sesuai untuk GPO baru Anda. Jika Anda sudah memiliki GPO yang ingin Anda ubah, lewati ke langkah 6.

  4. Klik kanan kontainer dan pilih Buat GPO di domain ini, dan Tautkan di sini....

  5. Berikan nama untuk kebijakan Anda seperti "Aktifkan Pembaruan Microsoft".

  6. Klik kanan kebijakan dan pilih Edit.

  7. Navigasi ke Templat > Administratif Konfigurasi > Komputer Windows Komponen > Windows Update.

  8. Pilih pengaturan Konfigurasi Pembaruan Otomatis untuk mengeditnya.

  9. Pilih tombol radio Diaktifkan untuk memungkinkan kebijakan diterapkan.

  10. Di bagian bawah bagian Opsi , centang kotak untuk Menginstal pembaruan untuk produk Microsoft lainnya di bagian bawah.

  11. Pilih OK.

Lain kali komputer dalam cakupan yang Anda pilih me-refresh kebijakannya, komputer akan mulai memeriksa pembaruan di Pembaruan Windows dan Pembaruan Microsoft.

Untuk organisasi yang menggunakan Microsoft Configuration Manager (MECM) atau Windows Server Update Services (WSUS) untuk memberikan pembaruan ke server mereka, Anda perlu mengonfigurasi WSUS untuk menyinkronkan paket Azure Koneksi ed Machine Agent dan menyetujuinya untuk penginstalan di server Anda. Ikuti panduan untuk Windows Server Update Services atau MECM untuk menambahkan produk dan klasifikasi berikut ke konfigurasi Anda:

  • Nama Produk: Azure Koneksi ed Machine Agent (pilih semua 3 sub-opsi)
  • Klasifikasi: Pembaruan Penting, Pembaruan

Setelah pembaruan disinkronkan, Anda dapat secara opsional menambahkan produk Azure Koneksi ed Machine Agent ke aturan persetujuan otomatis Anda sehingga server Anda secara otomatis tetap terbarui dengan perangkat lunak agen terbaru.

Untuk memutakhirkan secara manual menggunakan Wizard Penyetelan

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Unduh alat penginstal agen terbaru dari https://aka.ms/AzureConnectedMachineAgent

  3. Jalankan Azure Koneksi edMachineAgent.msi untuk memulai Wizard Penyetelan.

Jika Wizard Penyetelan menemukan versi agen sebelumnya, Wizard akan memutakhirkannya secara otomatis. Ketika pemutakhiran selesai, Wizard Penyetelan akan ditutup secara otomatis.

Untuk memutakhirkan dari baris perintah

Jika Anda tidak terbiasa dengan opsi baris perintah untuk paket Penginstal Windows, tinjau opsi baris perintah standar Msiexec dan opsi baris perintah Msiexec.

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Unduh alat penginstal agen terbaru dari https://aka.ms/AzureConnectedMachineAgent

  3. Untuk meningkatkan agen secara diam-diam dan membuat file log penyiapan di C:\Support\Logs folder, jalankan perintah berikut:

    msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\azcmagentupgradesetup.log"

Agen Linux

Memperbarui agen pada komputer Linux melibatkan dua perintah; satu perintah untuk memperbarui indeks paket lokal dengan daftar paket terbaru yang tersedia dari repositori, dan perintah lain untuk meningkatkan paket lokal.

Anda dapat mengunduh paket agen terbaru dari repositori paket milik Microsoft.

Catatan

Untuk meningkatkan agen, Anda harus memiliki izin akses root atau akun yang memiliki hak yang ditingkatkan menggunakan Sudo.

Meningkatkan agen di Ubuntu

  1. Untuk memperbarui indeks paket lokal dengan perubahan terbaru yang dilakukan di repositori, jalankan perintah berikut:

    sudo apt update

  2. Untuk memutakhirkan sistem Anda, jalankan perintah berikut:

    sudo apt upgrade azcmagent

Tindakan perintah apt, seperti instalasi dan penghapusan paket, dicatat dalam file log /var/log/dpkg.log.

Meningkatkan agen di Red Hat/CentOS/Oracle Linux/Amazon Linux

  1. Untuk memperbarui indeks paket lokal dengan perubahan terbaru yang dilakukan di repositori, jalankan perintah berikut:

    sudo yum check-update

  2. Untuk memutakhirkan sistem Anda, jalankan perintah berikut:

    sudo yum update azcmagent

Tindakan perintah apt, seperti instalasi dan penghapusan paket, dicatat dalam file log /var/log/yum.log.

Meningkatkan agen di SUSE Linux Enterprise

  1. Untuk memperbarui indeks paket lokal dengan perubahan terbaru yang dilakukan di repositori, jalankan perintah berikut:

    sudo zypper refresh

  2. Untuk memutakhirkan sistem Anda, jalankan perintah berikut:

    sudo zypper update azcmagent

Tindakan perintah zypper, seperti instalasi dan penghapusan paket, dicatat dalam file log /var/log/zypper.log.

Peningkatan agen otomatis

Agen Azure Koneksi ed Machine tidak secara otomatis meningkatkan dirinya sendiri saat versi baru dirilis. Anda harus menyertakan versi terbaru agen dengan siklus patch terjadwal Anda.

Mengganti nama sumber daya server dengan dukungan Azure Arc

Saat Anda mengubah nama komputer Linux atau Windows yang terhubung ke server dengan dukungan Azure Arc, nama baru tidak dikenali secara otomatis karena nama sumber daya di Azure tidak dapat diubah. Seperti halnya sumber daya Azure lainnya, Anda harus menghapus sumber daya dan membuatnya kembali untuk menggunakan nama baru.

Untuk server berkemampuan Azure Arc, sebelum Anda mengganti nama komputer, perlu untuk menghapus ekstensi VM sebelum melanjutkan:

  1. Audit ekstensi VM yang diinstal pada komputer dan catat konfigurasinya menggunakan Azure CLI atau Azure PowerShell.

  2. Hapus ekstensi VM apa pun yang diinstal pada komputer. Anda dapat melakukan ini menggunakan portal Azure, Azure CLI, atau Azure PowerShell.

  3. Gunakan alat azcmagent dengan parameter Putuskan koneksi untuk memutuskan sambungan mesin dari Azure Arc dan menghapus sumber daya alat berat dari Azure. Anda dapat menjalankan ini secara manual saat masuk secara interaktif, dengan token akses identitas Microsoft, atau dengan perwakilan layanan yang Anda gunakan untuk onboarding (atau dengan perwakilan layanan baru yang Anda buat.

    Memutuskan sambungan komputer dari server dengan dukungan Azure Arc tidak menghapus agen Mesin yang Koneksi, dan Anda tidak perlu menghapus agen sebagai bagian dari proses ini.

  4. Daftarkan ulang agen Connected Machine dengan server yang didukung Azure Arc. Jalankan azcmagent alat dengan parameter Koneksi untuk menyelesaikan langkah ini. Agen akan default menggunakan nama host komputer saat ini, tetapi Anda dapat memilih nama sumber daya Anda sendiri dengan meneruskan --resource-name parameter ke perintah sambungkan.

  5. Sebarkan kembali ekstensi mesin virtual yang awalnya disebarkan untuk mesin dari server berkemampuan Azure Arc. Jika Anda menyebarkan agen Azure Monitor untuk VM (insight) atau agen Log Analytics definisi Azure Policy, agen akan disebarkan ulang setelah siklus evaluasi berikutnya.

Menghapus pemasangan agen

Untuk server yang tidak ingin Anda kelola lagi dengan server berkemampuan Azure Arc, ikuti langkah-langkah di bawah ini untuk menghapus ekstensi VM apa pun dari server, memutuskan sambungan agen, dan menghapus instalan perangkat lunak dari server Anda. Penting untuk menyelesaikan semua langkah ini untuk sepenuhnya menghapus semua komponen perangkat lunak terkait dari sistem Anda.

Langkah 1: Hapus ekstensi VM

Jika Anda telah menyebarkan ekstensi Azure VM ke server berkemampuan Azure Arc, Anda harus menghapus instalan ekstensi sebelum memutuskan sambungan agen atau menghapus instalan perangkat lunak. Menghapus instalasi agen Azure Koneksi ed Machine tidak secara otomatis menghapus ekstensi, dan ekstensi ini tidak akan dikenali jika Anda menyambungkan kembali server ke Azure Arc.

Untuk panduan tentang cara mengidentifikasi dan menghapus ekstensi apa pun di server dengan dukungan Azure Arc Anda, lihat sumber daya berikut ini:

Langkah 2: Putuskan sambungan server dari Azure Arc

Memutuskan sambungan agen akan menghapus sumber daya Azure yang sesuai untuk server dan menghapus status lokal agen. Untuk memutuskan sambungan agen, jalankan azcmagent disconnect perintah sebagai administrator di server. Anda akan diminta untuk masuk dengan akun Azure yang memiliki izin untuk menghapus sumber daya di langganan Anda. Jika sumber daya telah dihapus di Azure, Anda harus meneruskan bendera tambahan untuk membersihkan status lokal: azcmagent disconnect --force-local-only.

Langkah 3a: Hapus instalan agen Windows

Kedua metode berikut menghapus agen, tetapi tidak menghapus folder C:\Program Files\AzureConnectedMachineAgent di komputer.

Hapus instalan dari Panel Kontrol

Ikuti langkah-langkah ini untuk menghapus instalan agen Windows dari komputer:

  1. Masuk ke komputer dengan akun yang memiliki izin administrator.

  2. Di panel Kontrol, pilih Program dan Fitur.

  3. Di Program dan Fitur, pilih Azure Connected Machine Agent, pilih Hapus instalasi, lalu pilih Ya.

Anda juga dapat menghapus agen Windows langsung dari wizard penyetelan agen. Jalankan paket penginstal Azure Koneksi edMachineAgent.msi untuk melakukannya.

Hapus instalan dari baris perintah

Anda dapat menghapus instalan agen secara manual dari Prompt Perintah atau dengan menggunakan metode otomatis (seperti skrip) dengan mengikuti contoh di bawah ini. Pertama Anda perlu mengambil kode produk, yaitu GUID yang merupakan pengidentifikasi utama paket aplikasi, dari sistem operasi. Penghapusan instalasi dilakukan dengan menggunakan baris Msiexec.exe - msiexec /x {Product Code}.

  1. Buka Editor Registri.

  2. Di bawah kunci registri HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall, cari dan salin GUID kode produk.

  3. Hapus instalan agen menggunakan Msiexec, seperti dalam contoh berikut:

    • Dari baris perintah, ketikkan:

      msiexec.exe /x {product code GUID} /qn

    • Anda bisa melakukan langkah yang sama menggunakan PowerShell:

      Get-ChildItem -Path HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall | `
Get-ItemProperty | `
Where-Object {$_.DisplayName -eq "Azure Connected Machine Agent"} | `
ForEach-Object {MsiExec.exe /x "$($_.PsChildName)" /qn}

Langkah 3b: Hapus instalan agen Linux

Catatan

Untuk menghapus instalan agen, Anda harus memiliki izin akses root atau akun yang memiliki hak yang ditingkatkan menggunakan sudo.

Perintah yang digunakan untuk menghapus instalan agen Linux tergantung pada sistem operasi Linux.

  • Untuk Ubuntu, jalankan perintah berikut:

    sudo apt purge azcmagent

  • Untuk RHEL, CentOS, Oracle Linux, dan Amazon Linux, jalankan perintah berikut:

    sudo yum remove azcmagent

  • Untuk SLES, jalankan perintah berikut:

    sudo zypper remove azcmagent

Memperbarui atau menghapus pengaturan proksi

Untuk mengonfigurasi agen untuk berkomunikasi ke layanan melalui server proksi atau untuk menghapus konfigurasi ini setelah penyebaran, gunakan salah satu metode yang dijelaskan di bawah ini. Perhatikan bahwa agen berkomunikasi keluar menggunakan protokol HTTP di bawah skenario ini.

Pada agen versi 1.13, pengaturan proksi dapat dikonfigurasi menggunakan azcmagent config perintah atau variabel lingkungan sistem. Jika server proksi ditentukan dalam konfigurasi agen dan variabel lingkungan sistem, konfigurasi agen akan diutamakan dan menjadi pengaturan yang efektif. Gunakan azcmagent show untuk melihat konfigurasi proksi yang efektif untuk agen.

Catatan

Server dengan dukungan Azure Arc tidak mendukung penggunaan server proksi yang memerlukan autentikasi, koneksi TLS (HTTPS), atau gateway Analitik Log sebagai proksi untuk agen Mesin yang Koneksi.

Konfigurasi proksi khusus agen

Konfigurasi proksi khusus agen tersedia dimulai dengan versi 1.13 dari agen Azure Koneksi ed Machine dan merupakan cara yang lebih disukai untuk mengonfigurasi pengaturan server proksi. Pendekatan ini mencegah pengaturan proksi untuk agen Azure Koneksi ed Machine mengganggu aplikasi lain di sistem Anda.

Catatan

Ekstensi yang disebarkan oleh Azure Arc tidak akan mewarisi konfigurasi proksi khusus agen. Lihat dokumentasi untuk ekstensi yang Anda sebarkan untuk panduan tentang cara mengonfigurasi pengaturan proksi untuk setiap ekstensi.

Untuk mengonfigurasi agen untuk berkomunikasi melalui server proksi, jalankan perintah berikut:

azcmagent config set proxy.url "http://ProxyServerFQDN:port"

Anda dapat menggunakan alamat IP atau nama host sederhana sebagai pengganti FQDN jika jaringan Anda memerlukannya. Jika server proksi Anda berjalan pada port 80, Anda dapat menghilangkan ":80" di akhir.

Untuk memeriksa apakah URL server proksi dikonfigurasi di pengaturan agen, jalankan perintah berikut:

azcmagent config get proxy.url

Untuk menghentikan agen berkomunikasi melalui server proksi, jalankan perintah berikut:

azcmagent config clear proxy.url

Anda tidak perlu memulai ulang layanan apa pun saat mengonfigurasi ulang pengaturan proksi dengan azcmagent config perintah .

Bypass proksi untuk titik akhir privat

Dimulai dengan agen versi 1.15, Anda juga dapat menentukan layanan yang seharusnya tidak menggunakan server proksi yang ditentukan. Ini dapat membantu dengan desain jaringan terpisah dan skenario titik akhir privat di mana Anda ingin lalu lintas Microsoft Entra ID dan Azure Resource Manager melalui server proksi Anda ke titik akhir publik tetapi ingin lalu lintas Azure Arc melewati proksi dan berkomunikasi dengan alamat IP privat di jaringan Anda.

Fitur bypass proksi tidak mengharuskan Anda memasukkan URL tertentu untuk dilewati. Sebagai gantinya, Anda memberikan nama layanan yang seharusnya tidak menggunakan server proksi. Parameter lokasi mengacu pada wilayah Azure dari Arc Server.

Nilai bypass proksi saat diatur ke ArcData hanya melewati lalu lintas ekstensi Azure untuk SQL Server dan bukan agen Arc.

Nilai bypass proksi Titik akhir yang terpengaruh
AAD login.windows.net
login.microsoftonline.com
pas.windows.net
ARM management.azure.com
Arc his.arc.azure.com
guestconfiguration.azure.com
ArcData1 *.<region>.arcdataservices.com

1 Nilai bypass ArcData proksi tersedia dimulai dengan agen Azure Koneksi ed Machine versi 1.36 dan Ekstensi Azure untuk SQL Server versi 1.1.2504.99. Versi sebelumnya termasuk SQL Server yang diaktifkan oleh titik akhir Azure Arc dalam nilai bypass proksi "Arc".

Untuk mengirim ID Microsoft Entra dan lalu lintas Azure Resource Manager melalui server proksi tetapi melewati proksi untuk lalu lintas Azure Arc, jalankan perintah berikut:

azcmagent config set proxy.url "http://ProxyServerFQDN:port"
azcmagent config set proxy.bypass "Arc"

Untuk menyediakan daftar layanan, pisahkan nama layanan menurut koma:

azcmagent config set proxy.bypass "ARM,Arc"

Untuk menghapus bypass proksi, jalankan perintah berikut:

azcmagent config clear proxy.bypass

Anda dapat melihat server proksi dan konfigurasi bypass proksi yang efektif dengan menjalankan azcmagent show.

Variabel lingkungan Windows

Di Windows, agen Azure Koneksi ed Machine akan terlebih dahulu memeriksa proxy.url properti konfigurasi agen (dimulai dengan agen versi 1.13), lalu variabel lingkungan di seluruh HTTPS_PROXY sistem untuk menentukan server proksi mana yang akan digunakan. Jika keduanya kosong, tidak ada server proksi yang digunakan, bahkan jika pengaturan proksi seluruh sistem Windows default dikonfigurasi.

Microsoft merekomendasikan penggunaan konfigurasi proksi khusus agen alih-alih variabel lingkungan sistem.

Untuk mengatur variabel lingkungan server proksi, jalankan perintah berikut:

# If a proxy server is needed, execute these commands with the proxy URL and port.
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://ProxyServerFQDN:port", "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
# For the changes to take effect, the agent services need to be restarted after the proxy environment variable is set.
Restart-Service -Name himds, ExtensionService, GCArcService

Untuk mengonfigurasi agen agar berhenti berkomunikasi melalui server proksi, jalankan perintah berikut:

[Environment]::SetEnvironmentVariable("HTTPS_PROXY", $null, "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
# For the changes to take effect, the agent services need to be restarted after the proxy environment variable removed.
Restart-Service -Name himds, ExtensionService, GCArcService

Variabel lingkungan Linux

Di Linux, agen Azure Koneksi ed Machine pertama-tama proxy.url memeriksa properti konfigurasi agen (dimulai dengan agen versi 1.13), lalu HTTPS_PROXY variabel lingkungan yang ditetapkan untuk himd, GC_Ext, dan daemon GCArcService. Ada skrip yang disertakan yang akan mengonfigurasi pengaturan proksi default systemd untuk agen Azure Koneksi ed Machine dan semua layanan lain di komputer untuk menggunakan server proksi tertentu.

Untuk mengonfigurasi agen untuk berkomunikasi melalui server proksi, jalankan perintah berikut:

sudo /opt/azcmagent/bin/azcmagent_proxy add "http://ProxyServerFQDN:port"

Untuk menghapus variabel lingkungan, jalankan perintah berikut:

sudo /opt/azcmagent/bin/azcmagent_proxy remove

Migrasi dari variabel lingkungan ke konfigurasi proksi khusus agen

Jika Anda sudah menggunakan variabel lingkungan untuk mengonfigurasi server proksi untuk agen Azure Koneksi ed Machine dan ingin bermigrasi ke konfigurasi proksi khusus agen berdasarkan pengaturan agen lokal, ikuti langkah-langkah berikut:

  1. Tingkatkan agen Azure Koneksi ed Machine ke versi terbaru (dimulai dengan versi 1.13) untuk menggunakan pengaturan konfigurasi proksi baru.

  2. Konfigurasikan agen dengan informasi server proksi Anda dengan menjalankan azcmagent config set proxy.url "http://ProxyServerFQDN:port".

  3. Hapus variabel lingkungan yang tidak digunakan dengan mengikuti langkah-langkah untuk Windows atau Linux.

Langkah berikutnya