Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Update Apigee Edge 4.51.00 atau 4.52.00 atau 4.52.01 ke 4.52.02

Apigee mendukung upgrade Edge untuk Private Cloud langsung dari versi 4.51.00, 4.52.00, atau 4.52.01 ke versi 4.52.02. Halaman ini menjelaskan cara melakukan upgrade tersebut.

Siapa yang dapat melakukan update

Orang yang menjalankan update harus sama dengan orang yang awalnya menginstal Edge, atau orang yang menjalankan sebagai root.

Setelah Anda menginstal RPM Edge, siapa pun dapat mengonfigurasinya.

Komponen mana yang harus Anda perbarui

Anda harus mengupdate semua komponen Edge. Edge tidak mendukung penyiapan yang berisi komponen dari beberapa versi.

Prasyarat pembaruan

Pastikan prasyarat berikut sebelum mengupgrade Apigee Edge:

Mencadangkan semua node
Sebelum melakukan update, sebaiknya lakukan pencadangan lengkap semua node untuk alasan keamanan. Gunakan prosedur untuk Edge versi saat ini guna melakukan pencadangan.
Dengan begitu, Anda dapat memiliki rencana cadangan jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
Pastikan Edge berjalan
Pastikan Edge berjalan selama proses update menggunakan perintah:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Catatan: Pastikan penyiapan edge-management-server di versi yang ada berjalan dengan berhasil tanpa kegagalan. Atasi kegagalan apa pun dalam penyiapan edge-management-server dari versi sebelumnya sebelum melanjutkan upgrade lebih lanjut.
Pastikan Strategi Pemadatan Cassandra adalah LeveledCompactionStrategy
Bergantung pada versi saat ini, lakukan perubahan yang diperlukan pada strategi pemadatan Cassandra. Ikuti langkah-langkah di bawah, lalu kembali ke prosedur upgrade utama:
- Jika Anda melakukan upgrade dari versi 4.51.00, lihat dokumen Strategi Pemadatan Cassandra untuk v4.51.00.
- Jika Anda melakukan upgrade dari versi 4.52.00, lihat dokumen Strategi Pemadatan Cassandra untuk v4.52.00.
- Jika Anda melakukan upgrade dari versi 4.52.01, lihat dokumen Strategi Pemadatan Cassandra untuk v4.52.01.

Langkah khusus yang perlu dipertimbangkan untuk upgrade

Untuk mengupgrade ke Edge for Private Cloud 4.52.02, pertimbangkan untuk menjalankan langkah-langkah khusus untuk mengupgrade software tertentu. Langkah-langkah yang diperlukan bergantung pada versi Anda saat ini. Lihat tabel di bawah untuk mengetahui berbagai software yang memerlukan langkah tambahan, dan ikuti petunjuk mendetail untuk setiap software. Setelah menyelesaikan tugas yang diperlukan, kembali ke prosedur upgrade utama untuk melanjutkan proses upgrade.

Versi saat ini	Software yang memerlukan langkah-langkah khusus untuk upgrade ke 4.52.02
4.52.01	Cassandra
4.52.00	Zookeeper, Cassandra, Qpid
4.51.00	Zookeeper, Postgres, Cassandra, Qpid

Setelah melakukan langkah-langkah yang diperlukan berdasarkan versi Anda, kembali ke prosedur upgrade utama untuk melanjutkan.

Penerapan otomatis setelan properti

Jika Anda telah menetapkan properti apa pun dengan mengedit file .properties di /opt/apigee/customer/application, nilai tersebut akan dipertahankan setelah update.

Mengupgrade ke Zookeeper 3.8.3

Edge untuk Private Cloud 4.52.02 tidak menyertakan upgrade Zookeeper. Namun, jika Anda mengupgrade dari versi yang lebih lama dari 4.52.01, Anda harus mengikuti langkah-langkah upgrade Zookeeper yang diuraikan di bawah.

Jika Anda melakukan upgrade dari Edge untuk Private Cloud versi 4.51.00 atau 4.52.00, lihat langkah-langkah di Upgrade yang diperlukan ke Zookeeper 3.8.3 untuk mengupgrade Zookeeper.
Jika Anda mengupgrade dari Edge untuk Private Cloud versi 4.52.01, Anda seharusnya sudah menggunakan Zookeeper versi 3.8.3, dan Anda tidak perlu mengikuti langkah-langkah khusus untuk mengupgrade Zookeeper.

Catatan:

Upgrade dari Edge untuk Private Cloud 4.52.01 ke 4.52.02 disederhanakan karena Zookeeper dan Cassandra biasanya ditempatkan bersama di host atau mesin virtual yang sama, sehingga tidak perlu prosedur upgrade Zookeeper terpisah bersama dengan upgrade Cassandra yang signifikan.

Jika Zookeeper perlu diupdate dengan langkah-langkah tertentu, upgrade Zookeeper di semua pusat data dengan mengupdate satu node dalam satu waktu. Setelah semua node Zookeeper di seluruh dunia diperbarui, upgrade Cassandra satu pusat data dalam satu waktu, dengan mematuhi prosedur yang diuraikan nanti dalam artikel ini.

Perintah berikut memfasilitasi upgrade Zookeeper terpisah:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Untuk rollback Zookeeper, gunakan prosedur rollback Zookeeper standar. Jika rollback diperlukan untuk Cassandra atau komponen lainnya, komponen tersebut harus di-rollback; rollback Zookeeper tidak diperlukan.

Mengupgrade ke Postgres 14

Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.51.00 ke 4.52.02, Anda harus mengikuti langkah-langkah untuk mengupgrade Postgres, meskipun Edge untuk Private Cloud 4.52.02 tidak menyertakan upgrade Postgres. Mengupgrade dari Edge untuk Private Cloud 4.51.00 ke 4.52.02 memerlukan langkah-langkah upgrade Postgres tambahan. Lihat bagian Upgrade yang diperlukan ke Postgres 14.
Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.52.00 atau 4.52.01 ke 4.52.02, tidak ada langkah upgrade Postgres tambahan yang diperlukan.

Upgrade ke Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 mencakup upgrade Cassandra ke versi 3.11.16. Cassandra adalah komponen penting Apigee, dan upgrade ini juga mencakup update pada software driver di berbagai komponen runtime dan pengelolaan yang digunakan untuk membuat kueri dan menulis ke Cassandra.

Karena ini adalah upgrade besar, perubahan tertentu pada model data Apigee di Cassandra diperlukan untuk memastikan performa optimal dalam versi yang lebih baru. Meskipun perubahan ini minimal, proses upgrade mengganggu API pengelolaan tertentu saat upgrade dimulai. API pengelolaan yang umumnya terganggu tercantum di bagian yang relevan di bawah.

Selain itu, proses upgrade menyebabkan gangguan pada serangkaian besar alur proxy runtime dan API pengelolaan di pusat data yang sedang diupgrade. Anda harus mengisolasi traffic runtime dan pengelolaan dari pusat data yang diupgrade untuk meminimalkan gangguan tersebut. Baca bagian untuk pusat data tunggal dan beberapa pusat data di bawah untuk mengetahui informasi selengkapnya.

Catatan: Alat cassandra-cli tidak lagi didukung di Cassandra 3.X dan tidak tersedia untuk Anda gunakan.

Developer Portal - Documenting APIs

Portal developer Apigee Drupal menawarkan berbagai fitur untuk mendokumentasikan API Anda. Meskipun sebaiknya Anda beralih dari penggunaan portal developer berbasis Drupal 7, jika Anda masih menggunakannya dan memanfaatkan fitur SmartDocs-nya, dokumen Menggunakan SmartDocs API berlaku untuk Anda. Jika Anda menggunakan versi portal developer yang lebih baru, tidak akan ada dampak pada dokumentasi API Anda selama upgrade ini.

Saat Anda mengupgrade Apigee ke versi 4.52.02, model API yang dibuat menggunakan fitur SmartDocs di portal developer Drupal 7 tidak akan otomatis dimigrasikan ke versi yang lebih baru. Anda diharapkan mengekspor setiap model secara manual menggunakan portal developer dan mengimpornya lagi setelah menyelesaikan upgrade.

Terminologi yang digunakan di bawah

Runtime: Runtime mencakup penanganan traffic proxy runtime Anda. Ini mencakup semua operasi yang dilakukan oleh Router dan Pemroses Pesan Anda untuk memproses permintaan API runtime secara efektif untuk proxy yang ada. Namun, hal ini tidak mencakup deployment proxy baru atau revisi proxy baru.

Pengelolaan: Pengelolaan mencakup administrasi sistem Apigee Edge Anda. Hal ini mencakup, tetapi tidak terbatas pada, deployment, modifikasi aplikasi, produk, server target, keystore, dll. Semua API pengelolaan (dan kliennya seperti UI Apigee dan portal developer) disertakan dalam cakupan ini.

Selama upgrade ini, traffic Runtime dan Pengelolaan akan terpengaruh di region atau pusat data (DC) tempat update sedang dijalankan. Terlepas dari pusat data yang sedang diupdate, ada dampak pada API pengelolaan tertentu di semua pusat data. Dampak ini dicatat setelah setiap langkah.

Di setiap langkah di bawah, status runtime dan pengelolaan dijelaskan saat Anda melanjutkan berbagai tahap prosedur upgrade.

Strategi upgrade

Beberapa pusat data

Upgrade harus dilakukan satu pusat data dalam satu waktu untuk memastikan kelangsungan traffic dan menghindari periode nonaktif. Sebelum mengupgrade DC, traffic harus dialihkan ke DC fungsional lainnya.

Catatan:

Untuk menghindari dampak traffic selama upgrade, ikuti pendekatan pusat data demi pusat data (DC-by-DC) dengan mengalihkan traffic sementara dari pusat data yang sedang diupgrade. Hal ini memastikan proses upgrade yang terkontrol untuk Cassandra, Server Pengelolaan, dan node Runtime sambil mempertahankan ketersediaan layanan.

Untuk penyiapan dua pusat data, ikuti langkah-langkah umum berikut:

Alihkan traffic dari DC-1 ke DC-2 dan blokir traffic masuk ke DC-1.
Upgrade DC-1, termasuk Cassandra, Server Pengelolaan, dan komponen Runtime.
Alihkan traffic kembali ke DC-1 dan blokir traffic masuk ke DC-2.
Upgrade DC-2, termasuk Cassandra, Server Pengelolaan, dan Komponen runtime.

Proses ini memastikan pengelolaan traffic yang lancar saat melakukan upgrade. Pola serupa harus diikuti untuk penyiapan dengan lebih dari dua pusat data, yang mengalihkan traffic untuk sementara ke pusat data yang telah diupgrade sepenuhnya atau belum diupgrade.

Pusat data tunggal

Untuk penyiapan pusat data tunggal, prosedur upgrade akan berdampak signifikan pada traffic runtime dan API pengelolaan tertentu. Opsi berikut tersedia untuk penyiapan pusat data tunggal.

Perluas cluster Edge for Private Cloud Anda ke pusat data sementara dengan menambahkan pusat data di samping pusat data yang ada untuk menangani traffic selama upgrade, lalu hentikan penggunaan salah satu pusat data setelah proses upgrade selesai.
Jika Anda tidak dapat melakukan perluasan ke pusat data tambahan, bersiaplah untuk periode nonaktif dan jadwalkan upgrade selama periode traffic rendah untuk meminimalkan dampak pada API pengelolaan dan traffic runtime.

Sebaiknya perluas ke pusat data tambahan untuk menghindari dampak pada traffic runtime dan API pengelolaan. Selama upgrade, dampak pada pusat data yang diupgrade mencakup, tetapi tidak terbatas pada area berikut:

API Runtime memperbarui token OAuth
Runtime API menggunakan Kebijakan Entitas Akses
API pengelolaan yang mencantumkan aplikasi developer
API pengelolaan yang mencantumkan produk

Dampak yang dijelaskan di atas merupakan tambahan dari API pengelolaan tertentu yang akan tetap tidak berfungsi di semua pusat data hingga semua pusat data diupgrade. API pengelolaan tersebut tercantum dalam langkah-langkah di bagian berikutnya.

Rollback - tingkat tinggi

Dampak Selama Rollback
Melakukan rollback dari Cassandra 3.11.x ke 2.1.x akan memengaruhi traffic runtime dan pengelolaan dalam pusat data (DC) tempat rollback dilakukan. Selain itu, API pengelolaan tertentu mungkin mengalami gangguan di semua pusat data, terlepas dari DC mana yang saat ini di-roll back.
Mengikuti Pendekatan Rollback DC per DC
Rollback harus dieksekusi satu pusat data dalam satu waktu untuk mempertahankan kontinuitas layanan dan mencegah periode nonaktif. Sebelum memulai rollback di DC tertentu, pastikan traffic aplikasi dialihkan ke pusat data lain yang beroperasi penuh.
Mengembalikan Cluster yang Diupgrade Sebagian
Jika setidaknya satu pusat data tetap beroperasi penuh pada Cassandra versi lama (2.1.22), DC yang diupgrade lainnya dapat di-roll back dengan melakukan pembangunan ulang dari DC Cassandra 2.1.X yang berfungsi penuh.
Rollback di Seluruh Cluster
Jika seluruh cluster Cassandra telah diupgrade dan rollback diperlukan, rollback harus dilakukan menggunakan cadangan atau snapshot VM. Pendekatan ini rumit dan kemungkinan akan menyebabkan periode nonaktif sementara atau kehilangan data.
Pertimbangan Sebelum Upgrade
Anda harus memahami prosedur rollback sebelum mencoba upgrade. Nuansa rollback harus dipertimbangkan saat melakukan upgrade untuk memastikan jalur rollback yang sesuai tersedia.

Melakukan rollback cluster dengan satu pusat data

Mengupgrade Cassandra dari versi 2.1.x ke 3.11.x dapat memengaruhi traffic runtime dan API pengelolaan tertentu secara signifikan. Dampak ini juga berlaku selama pengembalian dan dapat menyebabkan periode nonaktif atau hilangnya data.

Untuk beban kerja produksi, sebaiknya sediakan pusat data baru sebelum melakukan upgrade. Hal ini memungkinkan jalur rollback yang lebih aman tanpa kehilangan data atau gangguan pada traffic API. Pusat data tambahan dapat dinonaktifkan setelah upgrade berhasil diselesaikan.

Jika penambahan pusat data baru tidak memungkinkan, tetapi kemampuan rollback masih diperlukan, pastikan cadangan yang andal diambil sebelum upgrade. Memulihkan Cassandra 2.1.x dari cadangan dapat dilakukan, tetapi pendekatan ini dapat menyebabkan periode nonaktif layanan dan potensi kehilangan data.

Mengembalikan cluster dengan beberapa pusat data

Mengembalikan beberapa pusat data mengikuti pendekatan pusat data demi pusat data (DC-by-DC). Dalam pendekatan ini, traffic dari pusat data yang di-rollback dialihkan ke pusat data fungsional lainnya, sehingga memastikan proses rollback yang terkontrol dan terisolasi untuk Cassandra, Management Server, dan node Runtime untuk menghindari gangguan traffic.

Lihat bagian Rollback update Cassandra 3.11.16 untuk mengetahui detailnya.

Langkah 0: Status awal

Komponen Zookeeper, Postgres, dan LDAP sudah diupgrade ke versi 4.52.02. Edge untuk cluster cloud pribadi Anda stabil dan berfungsi. Jika rollback diperlukan, cluster akan di-rollback ke status ini.
Cassandra di Apigee yang berjalan dengan versi 2.1.22.
Komponen edge:

Server pengelolaan berkomunikasi dengan Cassandra melalui protokol thrift yang lebih lama.
Server runtime (Prosesor Pesan & Router) berkomunikasi dengan Cassandra melalui protokol thrift lama.

Status runtime pada tahap ini	Status pengelolaan pada tahap ini
Runtime berfungsi sepenuhnya	Pengelolaan berfungsi sepenuhnya

Langkah 1: Bersiap untuk upgrade

Langkah-langkah di bawah ini merupakan tambahan pada file standar yang biasanya Anda buat, seperti file konfigurasi standar Apigee untuk mengaktifkan upgrade komponen.

Ubah Cassandra untuk menggunakan LeveledCompactionStrategy.
Mencadangkan Cassandra menggunakan Apigee.
Buat snapshot VM node Cassandra (jika memungkinkan).

Buat file konfigurasi upgrade Cassandra di setiap node Cassandra di /opt/apigee/apigee-cassandra/cass_upgrade.conf dengan konten berikut:

# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts

Jika file tidak dapat dibuat di /opt/apigee/apigee-cassandra/cass_upgrade.conf, buat file /opt/silent.conf dengan konten yang sama di setiap node Cassandra.

Perhatian: Penginstal upgrade Apigee akan mencari file di lokasi yang tercantum di atas. Jika file tidak ada di salah satu lokasi yang tercantum di atas, upgrade akan gagal dengan pesan seperti di bawah:

could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced

Jika hal ini terjadi, upgrade akan gagal, tetapi layanan Cassandra di node kemungkinan akan berada dalam status berhenti. Anda dapat memulai layanan Cassandra seperti biasa dan mencoba lagi upgrade dengan menempatkan file konfigurasi di salah satu lokasi yang diharapkan. Selain itu, jika file ditemukan tetapi konfigurasi yang diberikan salah (misalnya, kredensial Cassandra salah), upgrade akan gagal dengan error seperti di bawah:

Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch

Dalam hal ini, mulai layanan Cassandra jika layanan tersebut dihentikan saat upgrade gagal dan coba lagi upgrade setelah memperbaiki konfigurasi dalam file.

Jika Anda menggunakan fitur SmartDocs di portal developer Apigee Drupal 7, lakukan ekspor setiap model dengan mendownloadnya dalam format JSON dari UI portal developer. Model ini harus diimpor kembali ke Apigee setelah server pengelolaan diupdate.
Pastikan port 9160 dan 9042 dapat diakses dari semua komponen Edge ke node Cassandra jika belum ada. Lihat Persyaratan port untuk mengetahui informasi selengkapnya.

Langkah 2: Alihkan traffic dari pusat data pertama

Blokir traffic runtime dan pengelolaan yang masuk dari pusat data pertama.
Mengarahkan ulang semua traffic runtime dan API pengelolaan ke pusat data fungsional lainnya.
Validasi bahwa traffic runtime dan pengelolaan berhasil ditangani oleh DC lain.

Langkah 3: Upgrade semua node Cassandra di pusat data pertama

Upgrade semua node Cassandra di pusat data satu per satu. Jalankan perintah berikut di setiap node satu per satu:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```

Setelah node diperbarui, jalankan perintah berikut di node untuk menjalankan beberapa validasi sebelum melanjutkan:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

Perintah di atas akan menghasilkan output yang mirip dengan:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Jalankan perintah post_upgrade berikut di setiap node Cassandra satu per satu setelah upgrade selesai:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
```

Status runtime pada tahap ini	Status pengelolaan pada tahap ini
Traffic runtime diblokir di pusat data yang sedang diupgrade Runtime berfungsi penuh di pusat data lain	Traffic pengelolaan diblokir di pusat data yang sedang diupgrade. Fungsi pengelolaan berikut akan terdegradasi setelah Cassandra diupgrade di pusat data lain: Management API untuk membuat produk API dengan lingkungan Management API untuk memperbarui produk API dengan lingkungan Management API untuk menghapus organisasi

Langkah 4: Upgrade semua node pengelolaan di pusat data pertama

Upgrade semua node pengelolaan di pusat data:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Status runtime pada tahap ini	Status pengelolaan pada tahap ini
Traffic runtime diblokir di pusat data yang sedang diupgrade Runtime berfungsi sepenuhnya	Traffic pengelolaan diblokir di pusat data yang sedang diupgrade. Fungsi pengelolaan berikut mengalami penurunan kualitas setelah Cassandra diupgrade: Management API untuk membuat produk API dengan lingkungan Management API untuk memperbarui produk API dengan lingkungan Management API untuk menghapus organisasi

Langkah 5: Upgrade semua node runtime di pusat data pertama

Upgrade semua node Router dan Message Processor di pusat data satu per satu:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Status runtime pada tahap ini	Status pengelolaan pada tahap ini
Traffic runtime diblokir di pusat data yang sedang diupgrade Runtime berfungsi penuh di pusat data lain	Traffic pengelolaan diblokir di pusat data yang sedang diupgrade. Fungsi pengelolaan berikut akan terganggu setelah Cassandra diupgrade di pusat data lain: Management API untuk membuat produk API dengan lingkungan Management API untuk memperbarui produk API dengan lingkungan Management API untuk menghapus organisasi

Langkah 6: Alihkan kembali traffic ke pusat data pertama

Setelah pusat data Pertama diupgrade dengan Cassandra, komponen runtime, dan server pengelolaan, aktifkan kembali traffic runtime dan pengelolaan ke pusat data Pertama.
Pastikan traffic runtime dan pengelolaan berhasil di seluruh DC.

Langkah 7: Upgrade pusat data lainnya

Ulangi Langkah 1 hingga Langkah 6 di pusat data yang tersisa, satu per satu dengan mengalihkan traffic dari pusat data tersebut, memperbarui software Apigee, dan mengaktifkan kembali traffic di pusat data tersebut.

Langkah 8: Jalankan kembali langkah upgrade di semua node Pengelolaan

Jalankan kembali perintah upgrade berikut di semua node pengelolaan di seluruh pusat data:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Langkah 9 - [Opsional] Mengimpor smartdoc yang sebelumnya diekspor

Setelah semua server pengelolaan diupgrade, Anda dapat mengimpor model dokumen smart yang telah Anda ekspor di Langkah 1. Anda dapat memutuskan untuk melakukannya nanti.

Anda hanya perlu melakukan langkah ini jika menggunakan portal developer berbasis Drupal 7 dan menggunakan fitur smartdocs.

Status runtime pada tahap ini	Status pengelolaan pada tahap ini
Runtime berfungsi sepenuhnya	Pengelolaan berfungsi sepenuhnya

Langkah 10 - Hapus tabel yang tidak digunakan

Jalankan perintah berikut untuk menghapus tabel lama yang tidak digunakan dari cluster Cassandra. Sebelum dijalankan, Anda tidak dapat menggunakan fitur tertentu Cassandra (seperti menyiapkan autentikasi baru - mekanisme autentikasi lama akan terus berfungsi). Perintah ini hanya dapat dieksekusi di satu node dalam cluster

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Langkah 11 - Upgrade semua komponen Edge dan komponen lainnya yang tersisa untuk Private Cloud 4.52.02

Upgrade semua node edge-qpid-server dan edge-postgres-server yang tersisa di semua region satu per satu.

Pada tahap ini, jika Anda melakukan upgrade dari versi sebelum Edge untuk Private Cloud 4.52.01 seperti di bawah, lakukan langkah-langkah tambahan untuk mengupgrade Qpid dan Postgres, lalu upgrade komponen yang tersisa sesuai dengan langkah-langkah ini.

Upgrade ke Qpid J-Broker

Meskipun Edge untuk Private Cloud 4.52.02 tidak menyertakan upgrade ke Qpid, jika Anda melakukan upgrade dari versi yang lebih lama dari 4.52.01, Anda harus mengikuti langkah-langkah untuk mengupgrade QPID.

Jika Anda mengupgrade dari Edge untuk Private Cloud 4.51.00 atau 4.52.00 ke 4.52.02, Anda harus mengikuti langkah-langkah upgrade Qpid tambahan. Lihat bagian Mengupgrade Qpid jika Anda mengupgrade dari versi 4.51.00 atau 4.52.00 ke 4.52.02.
Jika Anda mengupgrade dari Edge untuk Private Cloud 4.52.01 ke 4.52.02, Anda seharusnya sudah menggunakan versi terbaru Qpid Broker, dan tidak ada langkah-langkah Qpidupgrade tambahan yang diperlukan.

UI Edge Baru

Bagian ini mencantumkan pertimbangan terkait UI Edge. Untuk mengetahui informasi selengkapnya, lihat UI Edge baru untuk Private Cloud.

Menginstal UI Edge

Setelah menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal Edge UI, yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge untuk Private Cloud.

Perhatikan bahwa UI Edge mengharuskan Anda menonaktifkan Autentikasi dasar dan menggunakan IDP seperti SAML atau LDAP.

Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.

Memperbarui UI Edge

Untuk mengupdate komponen Edge UI, pertimbangkan versi Edge untuk Private Cloud yang Anda upgrade:

Dari 4.51.00 ke 4.52.00 (dengan UI Edge baru yang sudah diinstal): Gunakan petunjuk upgrade di bagian ini untuk komponen edge-management-ui.

Update dengan Apigee mTLS

Untuk mengupdate Apigee mTLS , lakukan langkah-langkah berikut:

Me-roll back update

Jika pembaruan gagal, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari bagian terakhir yang dihentikan.

Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.52.00 untuk mengetahui petunjuk mendetail.

Informasi pembaruan logging

Secara default, utilitas update.sh menulis informasi log ke:

/opt/apigee/var/log/apigee-setup/update.log

Jika orang yang menjalankan utilitas update.sh tidak memiliki akses ke direktori tersebut, utilitas akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

Jika Anda tidak memiliki akses ke /tmp, utilitas update.sh akan gagal.

Update tanpa periode nonaktif

Update tanpa waktu non-operasional, atau update berkelanjutan, memungkinkan Anda mengupdate penginstalan Edge tanpa menghentikan Edge.

Update tanpa periode nonaktif hanya dapat dilakukan dengan konfigurasi 5 node dan yang lebih besar.

Kunci untuk upgrade tanpa periode nonaktif adalah menghapus setiap Router, satu per satu, dari load balancer. Kemudian, update Router dan komponen lain di mesin yang sama dengan Router, lalu tambahkan kembali Router ke load balancer.

Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan dalam Urutan update mesin.
Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan kemampuan server (Message Processor/Router) untuk dijangkau.
Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor pada node yang sama.
Pastikan Router dapat dijangkau lagi.
Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
Lanjutkan update untuk komputer yang tersisa dalam penginstalan Anda.

Lakukan hal berikut sebelum dan sesudah update:

Pada node Router dan Message Processor gabungan:
- Sebelum melakukan update – lakukan langkah-langkah berikut:
  1. Membuat Router tidak dapat dijangkau.
  2. Buat Pemroses Pesan tidak dapat dijangkau.
- Setelah update – lakukan hal berikut:
  1. Pastikan Pemroses Pesan dapat dijangkau.
  2. Pastikan Router dapat dijangkau.
Pada node Router tunggal:
- Sebelum melakukan update, buat Router tidak dapat dijangkau.
- Setelah pembaruan, buat Router dapat dijangkau.
Di node Message Processor tunggal:
- Sebelum melakukan update, buat Message Processor tidak dapat dijangkau.
- Setelah update, buat Pemroses Pesan dapat dijangkau.

Menggunakan file konfigurasi senyap

Anda harus meneruskan file konfigurasi senyap ke perintah update. File konfigurasi senyap harus sama dengan yang Anda gunakan untuk menginstal Edge 4.50.00 atau 4.51.00.

Update ke 4.52.02 di node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

Jika ada, nonaktifkan semua tugas cron yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga setelah update selesai.
Login ke node Anda sebagai root untuk menginstal RPM Edge.
CATATAN: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
Instal yum-utils dan yum-plugin-priorities:
Catatan: Jika sistem operasi Anda adalah RHEL 8.0 - 8.6, lewati langkah ini.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Jika Anda menginstal di AWS, jalankan perintah yum-configure-manager berikut:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Jika saat ini Anda menggunakan Edge 4.51.00:
1. Download file bootstrap_4.52.02.sh Edge ke /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Instal utilitas apigee-service dan dependensi Edge 4.52.02 dengan menjalankan perintah berikut:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.
  
  Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, penginstal akan menginstalnya untuk Anda.
  
  Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX menggunakan nilai berikut:
  - I: Menginstal OpenJDK 1.8 (default).
  - C: Lanjutkan tanpa menginstal Java.
  - Q: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
3. Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Perbarui utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Perbarui utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Jalankan utilitas update di node Anda dengan menjalankan perintah berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Lakukan hal ini dalam urutan yang dijelaskan dalam Urutan update mesin.
  
  Dengan:
  - component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
    - cs: Cassandra
    - edge: Semua komponen Edge kecuali Edge UI: Management Server, Message Processor, Router, Qpid Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (jika Anda menginstal SSO)
    - ue: UI Edge Baru
    - ui: UI Edge Klasik
    - zk: Zookeeper
  - configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge Anda selama penginstalan 4.50.00 atau 4.51.00.
  Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil penginstalan all-in-one (AIO) Edge. Contoh:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Mulai ulang komponen Edge UI di semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

Jika Anda kemudian memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan dalam Me-roll back 4.52.02.

Update ke 4.52.02 dari repo lokal

Jika node Edge Anda berada di belakang firewall, atau dilarang mengakses repositori Apigee melalui Internet, Anda dapat melakukan update dari repositori lokal, atau mirror repositori Apigee.#heading

Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk mengupdate Edge dari repositori lokal:

Buat file .tar repo, salin file .tar ke node, lalu perbarui Edge dari file .tar.
Instal server web di node dengan repo lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.

Untuk mengupdate dari repo 4.52.02 lokal:

Buat repo 4.52.02 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
CATATAN: Jika sudah memiliki repo, Anda dapat menambahkan repo 4.52.02 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
Untuk menginstal apigee-service dari file .tar:
1. Di node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
3. Di node baru, ekstrak file ke direktori /tmp:
```
tar -xzf apigee-4.52.02.tar.gz
```
  Perintah ini membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.
4. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
Untuk menginstal apigee-service menggunakan server web Nginx:
1. Konfigurasi server web Nginx seperti yang dijelaskan dalam "Install from the repo using the Nginx webserver" di Install the Edge apigee-setup utility.
2. Di node jarak jauh, download file bootstrap_4.52.02.sh Edge ke /tmp/bootstrap_4.52.02.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  Dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan sebelumnya untuk repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.
3. Di node jarak jauh, instal utilitas dan dependensi apigee-setup Edge:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  Dengan uName:pWord adalah nama pengguna dan sandi repo.
Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Perbarui utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Perbarui utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Jalankan utilitas update di node Anda dalam urutan yang dijelaskan dalam Urutan update mesin:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Dengan:
- component adalah komponen Edge yang akan diupdate. Biasanya, Anda memperbarui komponen berikut:
  - cs: Cassandra
  - edge: Semua komponen Edge kecuali Edge UI: Server Pengelolaan, Pemroses Pesan, Router, Server Qpid, Server Postgres
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: Apigee SSO (jika Anda menginstal SSO)
  - ue UI Edge Baru
  - ui: UI Edge Klasik
  - zk: Zookeeper
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.
  CATATAN: File konfigurasi harus dapat dibaca oleh pengguna "apigee". Untuk mengubah pemilik, gunakan perintah berikut:
```
chown apigee:apigee configFile
```
Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil penginstalan all-in-one (AIO) Edge. Contoh:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
Mulai ulang komponen UI di semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

Jika Anda kemudian memutuskan untuk mengembalikan update, gunakan prosedur yang dijelaskan dalam Mengembalikan 4.52.02.

Urutan update mesin - upgrade dari 4.51.00 (atau) 4.52.00 (atau) 4.52.01

Urutan pembaruan komputer dalam penginstalan Edge sangat penting:

Anda harus memperbarui semua node ZooKeeper di seluruh pusat data sebelum mengupgrade semua komponen lainnya. Jika Anda melakukan upgrade dari Edge Private Cloud 4.51.00 (atau) 4.52.00, Anda juga harus mengikuti langkah-langkah tambahan untuk mengupgrade zookeeper.
Anda harus mengupdate Postgresql di semua pusat data. Jika Anda mengupgrade dari Edge Private Cloud 4.51.00, Anda juga harus mengikuti langkah-langkah tambahan untuk mengupgrade postgres.
Anda harus memperbarui node LDAP di semua pusat data.
Anda harus mengupdate semua node Cassandra, Server Pengelolaan, Pemroses Pesan, dan Router, satu pusat data dalam satu waktu, hingga semua pusat data diupgrade.
Anda harus memperbarui komponen edge-qpid-server & edge-postgres-server di semua pusat data.
Anda harus mengupgrade node Qpid di semua pusat data. Jika Anda melakukan upgrade dari Edge Private Cloud 4.51.00 (atau) 4.52.00, Anda juga harus mengikuti langkah-langkah tambahan untuk mengupgrade Qpid.
Perbarui Edge UI dan New Edge UI, node SSO di semua pusat data.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. Opsi ini diperbarui saat Anda menentukan opsi edge -c.
Catatan: Setelah memperbarui komponen Edge UI, Anda harus memulai ulang layanan Edge UI, seperti yang dijelaskan dalam petunjuk penginstalan update.

Upgrade mandiri 1 node

Untuk mengupgrade konfigurasi mandiri 1 node ke 4.52.02:

Perbarui semua komponen:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

(Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Upgrade mandiri 2 node

Perbarui komponen berikut untuk penginstalan mandiri 2 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

Perbarui Zookeeper di mesin 1:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Perbarui Postgres di mesin 2:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui LDAP di mesin 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Perbarui Cassandra di mesin 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Perbarui komponen Edge di mesin 1 dan 2:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Perbarui Qpid di Machine 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Perbarui UI di mesin 1:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi di komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat menginstal SSO.

Mulai ulang komponen Edge UI di komputer 1:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade 5 node

Perbarui komponen berikut untuk penginstalan 5 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

Perbarui ZooKeeper di komputer 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Perbarui Postgres di mesin 4:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui Postgres di mesin 5:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui LDAP di mesin 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Update Cassandra di mesin 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Perbarui komponen Edge di mesin 1, 2, 3, 4, 5:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Perbarui Qpid di mesin 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Perbarui Qpid di mesin 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Perbarui UI Edge:
- UI Klasik: Jika Anda menggunakan UI klasik, perbarui komponen ui di komputer 1, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- UI Edge Baru: Jika Anda menginstal UI Edge baru, update komponen ue di komputer yang sesuai (mungkin bukan komputer 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi di komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat menginstal SSO.
Mulai ulang komponen UI:
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di komputer 1, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di komputer yang sesuai (mungkin bukan komputer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Upgrade cluster 9 node

Perbarui komponen berikut untuk penginstalan berkluster 9 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

Perbarui ZooKeeper di mesin 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Perbarui Postgres di mesin 8:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui Postgres di mesin 9:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui LDAP di mesin 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Perbarui Cassandra di mesin 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Perbarui komponen Edge di mesin 1, 4, 5, 6, 7, 8, dan 9 dalam urutan tersebut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Perbarui Qpid di mesin 6 dan 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Perbarui UI baru (ue) atau UI klasik (ui) di komputer 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat menginstal SSO.
Mulai ulang komponen UI:
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di komputer 1, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di komputer yang sesuai (mungkin bukan komputer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Upgrade cluster 13 node

Perbarui komponen berikut untuk penginstalan berkluster 13 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

Perbarui ZooKeeper di komputer 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Perbarui Postgres di mesin 8:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui Postgres di mesin 9:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui LDAP di mesin 4 dan 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Update Cassandra di mesin 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Perbarui komponen Edge di komputer 6, 7, 10, 11, 12, 13, 8, dan 9 dalam urutan tersebut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Perbarui Qpid di mesin 12 dan 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Perbarui UI baru (ue) atau UI klasik (ui) di komputer 6 dan 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(Jika Anda menginstal apigee-adminapi) Perbarui utilitas apigee-adminapi di mesin 6 dan 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO di mesin 6 dan 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat menginstal SSO.
Mulai ulang komponen UI:
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 6 dan 7, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di komputer 6 dan 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Upgrade cluster 12 node

Perbarui komponen berikut untuk penginstalan berkluster 12 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

Update ZooKeeper di mesin 1,2,3,7,8,9 di kedua DC:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Perbarui Postgres di mesin 6,12 di kedua DC:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Perbarui LDAP di mesin 1,7 di kedua DC:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Blokir traffic di DC-1 dan pastikan semua traffic dialihkan ke DC-2 lainnya

Perbarui Cassandra di mesin 1,2,3 di DC-1:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Perbarui Server Pengelolaan di mesin 1 di DC-1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Perbarui Router, Message Processor di mesin 2,3 di DC-1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Buka blokir traffic di DC-1 dan validasi DC-1, lalu lanjutkan dengan DC-2 dengan memblokir traffic di DC-2 dan mengalihkan traffic ke DC-1

Perbarui Cassandra di mesin 7,8,9 di DC-2:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Perbarui Server Pengelolaan di komputer 7 di DC-2:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Perbarui Router, Message Processor di mesin 8,9 di DC-2:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Berhenti memblokir traffic di DC-2 dan sekarang, kedua DC akan menangani traffic
Jalankan kembali perintah update di semua server pengelolaan di seluruh DC pada mesin 1 & 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Perbarui edge-qpid-server & edge-postgres-server di mesin 4,5,6,10,11,12 di kedua DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid di mesin 4,5,10,11 di kedua DC:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Perbarui UI baru (ue) atau UI klasik (ui) di kedua DC:

/opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile

(Jika Anda menginstal apigee-adminapi) Perbarui apigee-adminapi di kedua DC:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal Apigee SSO) Perbarui node Apigee SSO di kedua DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
```
Mulai ulang komponen UI Edge baru (edge-management-ui) atau UI Edge klasik (edge-ui) di kedua DC:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```