Opsi tingkat lanjut Pembaruan Sadar Kluster dan memperbarui profil eksekusi
Berlaku untuk: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Azure Stack HCI, versi 21H2 dan 20H2
Topik ini menjelaskan opsi Memperbarui Eksekusi yang dapat dikonfigurasi untuk Eksekusi Pembaruan Sadar Kluster (CAU). Opsi tingkat lanjut ini dapat dikonfigurasi saat Anda menggunakan UI CAU atau cmdlet Cau Windows PowerShell untuk menerapkan pembaruan atau untuk mengonfigurasi opsi pembaruan mandiri.
Sebagian besar pengaturan konfigurasi dapat disimpan sebagai file XML yang disebut Memperbarui Profil Eksekusi dan digunakan kembali untuk Memperbarui Eksekusi nanti. Nilai default untuk opsi Eksekusi Pembaruan yang disediakan oleh CAU juga dapat digunakan di banyak lingkungan kluster.
Untuk informasi tentang opsi tambahan yang bisa Anda tentukan untuk setiap Eksekusi Pembaruan dan tentang Memperbarui Profil Eksekusi, lihat bagian berikut nanti dalam topik ini:
Opsi yang Anda tentukan saat meminta Opsi Memperbarui Eksekusi Gunakan Memperbarui Profil Eksekusi yang dapat diatur dalam Memperbarui Profil Eksekusi
Tabel berikut ini mencantumkan opsi yang bisa Anda atur dalam Profil Eksekusi Pembaruan CAU.
Catatan
Untuk mengatur opsi PreUpdateScript atau PostUpdateScript, pastikan bahwa Windows PowerShell dan .NET Framework 4.6 atau 4.5 diinstal dan remoting PowerShell diaktifkan pada setiap simpul dalam kluster. Untuk informasi selengkapnya, lihat Mengonfigurasi simpul untuk manajemen jarak jauh dalam Persyaratan dan Praktik Terbaik untuk Pembaruan Sadar Kluster.
| Opsi | Nilai default | Detail |
|---|---|---|
| StopAfter | Waktu tidak terbatas | Waktu dalam menit setelah Eksekusi Pembaruan akan dihentikan jika belum selesai. Catatan: Jika Anda menentukan pra-pembaruan atau skrip PowerShell pasca-pembaruan, seluruh proses menjalankan skrip dan melakukan pembaruan harus selesai dalam batas waktu StopAfter . |
| WarnAfter | Secara default, tidak ada peringatan yang muncul | Waktu dalam menit setelah peringatan akan muncul jika Eksekusi Pembaruan (termasuk skrip pra-pembaruan dan skrip pasca-pembaruan, jika dikonfigurasi) belum selesai. |
| MaxRetriesPerNode | 3 | Frekuensi maksimum proses pembaruan (termasuk skrip pra-pembaruan dan skrip pasca-pembaruan, jika dikonfigurasi) akan dicoba ulang per simpul. Maksimum adalah 64. |
| MaxFailedNodes | Untuk sebagian besar kluster, bilangan bulat yang sekitar sepertiga dari jumlah node kluster | Jumlah maksimum simpul di mana pembaruan dapat gagal, baik karena node gagal atau layanan Kluster berhenti berjalan. Jika satu simpul lagi gagal, Eksekusi Pembaruan dihentikan. Rentang nilai yang valid adalah 0 hingga 1 kurang dari jumlah node kluster. |
| RequireAllNodesOnline | Tidak ada | Menentukan bahwa semua simpul harus online dan dapat dijangkau sebelum pembaruan dimulai. |
| RebootTimeoutMinutes | 15 | Waktu dalam menit yang akan diizinkan CAU untuk memulai ulang simpul (jika perlu menghidupkan ulang) dan memulai semua layanan mulai otomatis. Jika proses hidupkan ulang tidak selesai dalam waktu ini, Eksekusi Pembaruan pada simpul tersebut ditandai sebagai gagal. |
| PreUpdateScript | Tidak ada | Jalur dan nama file untuk skrip PowerShell yang akan dijalankan pada setiap simpul sebelum pembaruan dimulai, dan sebelum simpul dimasukkan ke dalam mode pemeliharaan. Ekstensi nama file harus .ps1, dan panjang total jalur ditambah nama file tidak boleh melebihi 260 karakter. Sebagai praktik terbaik, skrip harus terletak pada disk di penyimpanan kluster, atau pada berbagi file jaringan yang sangat tersedia, untuk memastikan bahwa skrip selalu dapat diakses oleh semua node kluster. Jika skrip terletak di berbagi file jaringan, pastikan Anda mengonfigurasi berbagi file untuk izin Baca untuk grup Semua Orang, dan membatasi akses tulis untuk mencegah perubahan pada file oleh pengguna yang tidak sah. Jika Anda menentukan skrip pra-pembaruan, pastikan bahwa pengaturan seperti batas waktu (misalnya, StopAfter) dikonfigurasi untuk memungkinkan skrip berjalan dengan sukses. Batas ini mencakup seluruh proses menjalankan skrip dan menginstal pembaruan, bukan hanya proses menginstal pembaruan. |
| PostUpdateScript | Tidak ada | Jalur dan nama file untuk skrip PowerShell yang akan dijalankan setelah pembaruan selesai (setelah simpul meninggalkan mode pemeliharaan). Ekstensi nama file harus .ps1 dan panjang total jalur ditambah nama file tidak boleh melebihi 260 karakter. Sebagai praktik terbaik, skrip harus terletak pada disk di penyimpanan kluster, atau pada berbagi file jaringan yang sangat tersedia, untuk memastikan bahwa skrip selalu dapat diakses oleh semua node kluster. Jika skrip terletak di berbagi file jaringan, pastikan Anda mengonfigurasi berbagi file untuk izin Baca untuk grup Semua Orang, dan membatasi akses tulis untuk mencegah perubahan pada file oleh pengguna yang tidak sah. Jika Anda menentukan skrip pasca-pembaruan, pastikan bahwa pengaturan seperti batas waktu (misalnya, StopAfter) dikonfigurasi untuk memungkinkan skrip berjalan dengan sukses. Batas ini mencakup seluruh proses menjalankan skrip dan menginstal pembaruan, bukan hanya proses menginstal pembaruan. |
| ConfigurationName | Pengaturan ini hanya berpengaruh jika Anda menjalankan skrip. Jika Anda menentukan skrip pra-pembaruan atau skrip pasca-pembaruan, tetapi Anda tidak menentukan ConfigurationName, konfigurasi sesi default untuk PowerShell (Microsoft.PowerShell) digunakan. |
Menentukan konfigurasi sesi PowerShell yang menentukan sesi tempat skrip (ditentukan oleh PreUpdateScript dan PostUpdateScript) dijalankan, dan dapat membatasi perintah yang dapat dijalankan. |
| CauPluginName | Microsoft.WindowsUpdatePlugin | Plug-in yang Anda konfigurasikan Pembaruan Sadar Kluster untuk digunakan untuk mempratinjau pembaruan atau melakukan Eksekusi Pembaruan. Untuk informasi selengkapnya, lihat Cara kerja plug-in Pembaruan Kluster-Sadar. |
| CauPluginArguments | Tidak ada | Sekumpulan pasangan nama=nilai (argumen) untuk memperbarui plug-in yang akan digunakan, misalnya: Domain=Domain.local Pasangan nama=nilai ini harus bermakna bagi plug-in yang Anda tentukan di CauPluginName. Untuk menentukan argumen menggunakan UI CAU, ketik nama, tekan tombol Tab, lalu ketik nilai yang sesuai. Tekan tombol Tab lagi untuk memberikan argumen berikutnya. Setiap nama dan nilai secara otomatis dipisahkan dengan tanda sama dengan (=). Beberapa pasangan secara otomatis dipisahkan dengan titik koma. Untuk plug-in Microsoft.WindowsUpdatePlugin default, tidak diperlukan argumen. Namun, Anda dapat menentukan argumen opsional, misalnya untuk menentukan string kueri Agen Pembaruan Windows standar untuk memfilter kumpulan pembaruan yang diterapkan oleh plug-in. Untuk nama, gunakan QueryString, dan untuk nilai, sertakan kueri lengkap dalam tanda kutip. Untuk informasi selengkapnya, lihat Cara kerja plug-in Pembaruan Kluster-Sadar. |
Opsi yang Anda tentukan saat meminta Eksekusi Pembaruan
Tabel berikut ini mencantumkan opsi (selain opsi di Memperbarui Profil Eksekusi) yang bisa Anda tentukan saat meminta Eksekusi Pembaruan. Untuk informasi tentang opsi yang bisa Anda atur di Memperbarui Profil Eksekusi, lihat tabel sebelumnya.
| Opsi | Nilai default | Detail |
|---|---|---|
| ClusterName | Tidak Catatan: Opsi ini harus diatur hanya ketika UI CAU tidak dijalankan pada node kluster failover, atau Anda ingin mereferensikan kluster failover yang berbeda dari tempat UI CAU dijalankan. |
Nama NetBIOS kluster tempat melakukan Eksekusi Pembaruan. |
| Informasi masuk | Kredensial akun saat ini | Kredensial administratif untuk kluster target tempat Eksekusi Pembaruan akan dilakukan. Anda mungkin sudah memiliki kredensial yang diperlukan jika Anda memulai UI CAU (atau membuka sesi PowerShell, jika Anda menggunakan cmdlet Cau PowerShell) dari akun yang memiliki hak dan izin administrator pada kluster. |
| NodeOrder | Secara default, CAU dimulai dengan simpul yang memiliki jumlah terkecil dari peran berkluster, lalu maju ke simpul yang memiliki angka terkecil kedua, dan sebagainya. | Nama node kluster dalam urutan yang harus diperbarui (jika memungkinkan). |
Gunakan Memperbarui Profil Eksekusi
Setiap Eksekusi Pembaruan dapat dikaitkan dengan Memperbarui Profil Eksekusi tertentu. Profil Eksekusi Pembaruan default disimpan di folder %windir%\cluster . Jika Anda menggunakan UI CAU dalam mode pembaruan jarak jauh, Anda dapat menentukan Memperbarui Profil Eksekusi pada saat Anda menerapkan pembaruan, atau Anda dapat menggunakan profil Eksekusi Pembaruan default. Jika Anda menggunakan CAU dalam mode pembaruan mandiri, Anda dapat mengimpor pengaturan dari Memperbarui Profil Eksekusi yang ditentukan saat mengonfigurasi opsi pembaruan mandiri. Dalam kedua kasus, Anda dapat mengambil alih nilai yang ditampilkan untuk opsi Eksekusi Pembaruan sesuai dengan kebutuhan Anda. Jika mau, Anda dapat menyimpan opsi Eksekusi Pembaruan sebagai Memperbarui Profil Eksekusi dengan nama file yang sama atau nama file yang berbeda. Saat berikutnya Anda menerapkan pembaruan atau mengonfigurasi opsi pembaruan mandiri, CAU secara otomatis memilih Memperbarui Profil Eksekusi yang sebelumnya dipilih.
Anda dapat mengubah Memperbarui Profil Eksekusi yang sudah ada atau membuat profil baru dengan memilih Buat atau ubah Memperbarui Profil Eksekusi di UI CAU.
Berikut adalah beberapa catatan penting tentang menggunakan Memperbarui Profil Eksekusi:
- Memperbarui Profil Eksekusi tidak menyimpan informasi khusus kluster seperti kredensial administratif. Jika Anda menggunakan CAU dalam mode pembaruan mandiri, Memperbarui Profil Eksekusi juga tidak menyimpan informasi jadwal pembaruan mandiri. Ini memungkinkan untuk berbagi Memperbarui Profil Eksekusi di semua kluster failover di kelas tertentu.
- Jika Anda mengonfigurasi opsi pembaruan mandiri menggunakan Memperbarui Profil Eksekusi dan kemudian mengubah profil dengan nilai yang berbeda untuk opsi Perbarui Eksekusi, konfigurasi pembaruan mandiri tidak berubah secara otomatis. Untuk menerapkan pengaturan Eksekusi Pembaruan baru, Anda harus mengonfigurasi opsi pembaruan mandiri lagi.
- Editor Jalankan Profil sayangnya tidak mendukung jalur file yang menyertakan spasi, seperti C:\Program Files. Sebagai solusinya, simpan skrip pra dan pasca pembaruan Anda di jalur yang tidak menyertakan spasi, atau gunakan PowerShell secara eksklusif untuk mengelola Jalankan Profil, menempatkan tanda kutip di sekitar jalur saat menjalankan Invoke-CauRun.
Perintah setara Windows PowerShell
Anda dapat mengimpor pengaturan dari cmdlet Eksekusi Pembaruan saat menjalankan cmdlet Invoke-CauRun, Add-CauClusterRole, atau Set-CauClusterRole.
Contoh berikut melakukan pemindaian dan Eksekusi Pembaruan penuh pada kluster bernama CONTOSO-FC1, menggunakan opsi Eksekusi Pembaruan yang ditentukan dalam C:\Windows\Cluster\DefaultParameters.xml. Nilai default digunakan untuk parameter cmdlet yang tersisa.
$MyRunProfile = Import-Clixml C:\Windows\Cluster\DefaultParameters.xml
Invoke-CauRun –ClusterName CONTOSO-FC1 @MyRunProfile
Dengan menggunakan Memperbarui Profil Eksekusi, Anda dapat memperbarui kluster failover dengan cara yang dapat diulang dengan pengaturan yang konsisten untuk manajemen pengecualian, batas waktu, dan parameter operasional lainnya. Karena pengaturan ini biasanya khusus untuk kelas kluster failover—seperti "Semua kluster Microsoft SQL Server", atau "Kluster penting bisnis saya"—Anda mungkin ingin memberi nama setiap Memperbarui Profil Eksekusi sesuai dengan kelas Kluster Failover yang akan digunakannya. Selain itu, Anda mungkin ingin mengelola Memperbarui Profil Eksekusi pada berbagi file yang dapat diakses oleh semua kluster failover kelas tertentu di organisasi TI Anda.