Halaman ini diterjemahkan oleh Cloud Translation API.

Update Apigee Edge 4.51.00 atau 4.52.00 atau 4.52.01 ke 4.52.02

Apigee mendukung upgrade Edge for Private Cloud secara 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 pembaruan

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

Setelah Anda menginstal RPM Edge, siapa pun dapat mengonfigurasinya.

Komponen mana yang harus Anda update

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

Perbarui prasyarat

Pastikan prasyarat berikut sebelum mengupgrade Apigee Edge:

Cadangkan semua node
Sebelum mengupdate, sebaiknya lakukan pencadangan lengkap semua node untuk alasan keamanan. Gunakan prosedur untuk versi Edge Anda saat ini untuk melakukan pencadangan.
Dengan demikian, Anda dapat memiliki rencana cadangan, jika pembaruan ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
Pastikan Edge berjalan
Pastikan Edge sudah aktif dan berjalan selama proses update dengan menggunakan perintah:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Pastikan Strategi Pemadatan Cassandra adalah LeveledCompactionStrategy
Pastikan strategi pemadatan Cassandra ditetapkan ke LeveledCompactionStrategy, seperti yang dijelaskan dalam Mengubah strategi pemadatan Cassandra.

Langkah-langkah khusus yang perlu dipertimbangkan untuk upgrade

Untuk mengupgrade ke Edge untuk Private Cloud 4.52.02, pertimbangkan untuk menjalankan langkah spesifik guna mengupgrade software tertentu. Langkah-langkah yang diperlukan bergantung pada versi Anda saat ini. Lihat tabel di bawah ini untuk berbagai perangkat lunak yang memerlukan langkah-langkah tambahan. Bagian selanjutnya di halaman ini menyediakan diskusi terperinci dan langkah-langkah yang tepat untuk setiap perangkat lunak.

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

Penerapan otomatis setelan properti

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

Diperlukan upgrade ke Cassandra 3.11.16

Apigee Edge untuk Private Cloud 4.52.02 menyertakan 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 manajemen 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 di versi yang lebih baru. Meskipun perubahan ini tidak signifikan, proses upgrade akan mengganggu API pengelolaan tertentu, sehingga memengaruhi UI Apigee dan portal developer. Dokumen di bawah menentukan API persis yang tidak akan berfungsi dan menjelaskan langkah-langkah selama upgrade saat gangguan dimulai dan berakhir. Yang penting, tidak boleh ada gangguan pada traffic runtime selama upgrade.

Rollback tingkat tinggi

Terapkan Cassandra mengupgrade node satu per satu. Segera setelah node diupdate, perubahan skema tertentu akan diterapkan dan tidak dapat langsung di-roll back. Baca bagian tentang Melakukan rollback dengan teliti, karena berbagai teknik dapat digunakan bergantung pada seberapa banyak cluster yang telah diupgrade.

Jika Anda perlu melakukan roll back upgrade setelah seluruh cluster Cassandra diupgrade, satu-satunya opsi adalah memulihkan cadangan. Bersiaplah untuk hal ini dan pahami pemulihan cadangan Cassandra. Jika Anda dapat memulihkan snapshot tingkat VM lebih cepat daripada cadangan Apigee, gunakan snapshot VM untuk memulihkan VM Cassandra ke status sebelumnya.

Untuk detail selengkapnya, lihat bagian Melakukan rollback update Cassandra 3.11.16.

Mendokumentasikan API di portal developer

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

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

Terminologi yang digunakan di bagian berikut

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

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

Di setiap langkah di bawah ini, status runtime dan pengelolaan dijelaskan saat Anda melalui berbagai tahap prosedur upgrade. Perlu diperhatikan bahwa tidak ada dampak pada traffic runtime selama upgrade. Namun, ada gangguan pada sebagian kecil API pengelolaan dan fungsi portal developer.

Langkah 0: Status awal

Cassandra di Apigee berjalan dengan versi 2.1.22.
Edge untuk komponen Private Cloud 4.52.02:

Server-manajemen yang berkomunikasi dengan Cassandra melalui protokol {i>thrift<i} yang lebih lama.
Server runtime (Prosesor & Router Pesan) yang berkomunikasi dengan Cassandra melalui protokol thrift yang lebih 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 untuk file standar yang biasa Anda buat, seperti file konfigurasi standar Apigee untuk mengaktifkan upgrade komponen.

Ubah Cassandra untuk menggunakan LeveledCompactionStrategy.
Mencadangkan Cassandra menggunakan Apigee.
Ambil snapshot VM dari node Cassandra (jika memungkinkan).
Buat file konfigurasi upgrade Cassandra pada 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 tersebut 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 pada 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, sama halnya dengan memulai layanan Cassandra jika 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 untuk setiap model dengan mendownloadnya dalam format JSON dari UI portal developer. Model-model ini perlu diimpor kembali ke Apigee setelah server pengelolaan diupdate.
Pastikan port 9160 dan 9042 dapat diakses dari semua komponen Edge untuk Private Cloud 4.52.02 hingga node Cassandra jika belum ada. Lihat Persyaratan port untuk informasi selengkapnya.

Langkah 2: Upgrade semua node Cassandra

Mengupgrade semua node Cassandra di semua region satu per satu. Jalankan perintah berikut di setiap node:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Setelah node diupdate, jalankan perintah berikut pada 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 sesuatu seperti:

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

Status runtime pada tahap ini	Status pengelolaan pada tahap ini
Runtime berfungsi sepenuhnya	Fungsi pengelolaan berikut menurun setelah Cassandra diupgrade: Management API untuk membuat produk API dengan lingkungan Management API untuk memperbarui produk API dengan lingkungan Management API untuk menghapus organisasi

Catatan: Jika Anda melakukan upgrade dari Edge Private Cloud 4.51.00 atau 4.52.00, Anda juga harus mengikuti langkah tambahan untuk mengupgrade Zookeeper. Meskipun Zookeeper dan Cassandra mungkin ditempatkan di node yang sama, sebaiknya upgrade Zookeeper dan Cassandra secara terpisah.

Anda dapat menggunakan perintah berikut pada node untuk mengupgrade Zookeeper:

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

Perintah berikut dapat digunakan pada node untuk mengupgrade Cassandra:

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

Jika Anda melakukan upgrade dari Edge Private Cloud 4.52.01 ke 4.52.02, upgrade Zookeeper adalah upgrade kecil dan dapat dilakukan bersama Cassandra. Untuk mengupgrade Cassandra dan Zookeeper melalui satu perintah pada node tempat keduanya ditempatkan, gunakan perintah di bawah. Sebaiknya lakukan ini hanya jika Anda sudah menjalankan Zookeeper versi 3.8.3 di Private Cloud versi 4.52.01:

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

Langkah 3: Upgrade semua node Pengelolaan

Upgrade semua node Pengelolaan di semua region satu per satu:

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

Status Runtime	Status Pengelolaan
Runtime berfungsi sepenuhnya	Management API menurun: Fitur SmartDocs di portal developer Drupal 7 tidak menampilkan data

Langkah 3a: [opsional] Impor SmartDocs yang sebelumnya diekspor

Setelah semua server pengelolaan diupgrade, Anda dapat mengimpor model SmartDocs yang telah diekspor pada Langkah 1. Anda juga dapat memutuskan untuk melakukannya nanti.

Status Runtime	Status Pengelolaan
Runtime berfungsi sepenuhnya	Pengelolaan berfungsi sepenuhnya

Langkah 4: Upgrade semua node Runtime

Upgrade semua node Router dan Pemroses Pesan di semua region satu per satu:

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

Status Runtime	Status Pengelolaan
Runtime berfungsi sepenuhnya	Pengelolaan berfungsi sepenuhnya

Langkah 5: Upgrade semua komponen Edge 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 meng-upgrade dari versi sebelum Edge untuk Private Cloud 4.52.01, dan mengikuti langkah tambahan untuk meng-upgrade Qpid atau Postgres, ikuti langkah-langkah masing-masing untuk meng-upgrade sama.

Status Runtime	Status Pengelolaan
Runtime berfungsi sepenuhnya	Pengelolaan berfungsi sepenuhnya

Langkah 6: Langkah-langkah setelah upgrade

Jalankan perintah berikut pada setiap node Cassandra satu per satu setelah upgrade selesai:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

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

Selesaikan langkah 3a jika Anda belum melakukannya.

Status Runtime	Status Pengelolaan
Runtime berfungsi sepenuhnya	Pengelolaan berfungsi sepenuhnya

Upgrade yang diperlukan ke Zookeeper 3.8.3

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

Jika Anda melakukan upgrade dari Edge untuk Private Cloud versi 4.51.00 atau 4.52.00, lihat langkah-langkah dalam Upgrade yang diperlukan ke Zookeeper 3.8.3 untuk mengupgrade Zookeeper.
Jika Anda melakukan upgrade 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 melakukan upgrade Zookeeper.

Upgrade yang diperlukan 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 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, Anda tidak perlu melakukan langkah upgrade Postgres tambahan.

Upgrade yang diperlukan 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 melakukan upgrade dari Edge untuk Private Cloud 4.51.00 atau 4.52.00 ke 4.52.02, Anda perlu mengikuti langkah-langkah upgrade QPID tambahan. Lihat bagian Upgrade Qpid jika Anda melakukan upgrade dari versi 4.51.00 atau 4.52.00 ke 4.52.02.
Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.52.01 ke 4.52.02, Anda seharusnya sudah menggunakan Qpid Broker versi terbaru, dan tidak ada langkah upgrade QPID tambahan yang diperlukan.

UI Edge Baru

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

Menginstal UI Edge

Setelah Anda menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal UI Edge, 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 yang baru.

Mengupdate UI Edge

Untuk mengupdate komponen UI Edge, pertimbangkan versi Edge untuk Private Cloud tempat Anda mengupgrade:

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 mTLS Apigee

Untuk mengupdate Apigee mTLS , lakukan langkah-langkah berikut:

Me-roll back update

Jika terjadi kegagalan update, 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 terakhir dibuka.

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

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 orang tersebut tidak memiliki akses ke /tmp, utilitas update.sh akan gagal.

Update tanpa periode nonaktif

Dengan update tanpa periode nonaktif, atau update berkelanjutan, Anda dapat mengupdate penginstalan Edge tanpa menurunkan Edge.

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

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

Update komputer dalam urutan yang benar untuk penginstalan Anda, seperti yang dijelaskan Urutan update mesin.
Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar router tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan keterjangkauan server (Message Processor/Router).
Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan di node yang sama.
Buat Router dapat dijangkau lagi.
Ulangi langkah 2 sampai 4 untuk Router lainnya.
Lanjutkan pembaruan untuk komputer apa pun yang tersisa dalam pemasangan Anda.

Lakukan tindakan berikut sebelum dan sesudah update:

Pada gabungan node Router dan Pemroses Pesan:
- Sebelum update – lakukan tindakan berikut:
  1. Membuat Router tidak dapat dijangkau.
  2. Membuat Pemroses Pesan tidak dapat dijangkau.
- Setelah update, lakukan tindakan berikut:
  1. Buat Pemroses Pesan dapat dijangkau.
  2. Buat Router dapat dijangkau.
Pada satu node Router:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
Pada satu node Pemroses Pesan:
- Sebelum update, buat Pemroses Pesan 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 versi 4.52.02 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk memperbarui komponen Edge pada node:

Jika ada, nonaktifkan semua tugas cron yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga 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 penyiapan Edge apigee.
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 dan dependensi apigee-service 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 menghapus 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: Instal 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 contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan 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 ini sesuai urutan yang dijelaskan dalam Urutan update mesin.
  
  Dengan keterangan:
  - component adalah komponen Edge yang akan diperbarui. Nilai yang memungkinkan mencakup:
    - cs: Cassandra
    - edge: Semua komponen Edge kecuali UI Edge: Management Server, Message Processor, Router, QPID Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO Apigee (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.
  Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil penginstalan Edge all-in-one (AIO). Contoh:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Mulai ulang komponen UI Edge pada semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

Jika nantinya Anda memutuskan untuk melakukan roll back update, gunakan prosedur yang dijelaskan dalam Melakukan roll back 4.52.02.

Pembaruan ke 4.52.02 dari repo lokal

Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui internet, Anda dapat melakukan update dari repositori lokal atau duplikasi repo Apigee.

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

Buat file .tar untuk repositori tersebut, salin file .tar ke node, lalu update Edge dari file .tar.
Instal server web pada node dengan repo lokal sehingga node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk digunakan, atau Anda dapat menggunakan server web Anda sendiri.

Untuk memperbarui dari repo 4.52.02 lokal:

Buat repo 4.52.02 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas Edge apigee-setup.
CATATAN: Jika sudah memiliki repo, Anda dapat menambahkan repo 4.52.02 ke dalamnya seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal utilitas Edge apigee-setup.
Untuk menginstal apigee-service dari file .tar:
1. Pada node yang berisi repo lokal, gunakan perintah berikut untuk memaketkan 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 pada node baru.
3. Pada node baru, untar file ke direktori /tmp:
```
tar -xzf apigee-4.52.02.tar.gz
```
  Perintah ini membuat direktori baru, bernama repos, di dalam 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 layanan apigee menggunakan server web Nginx:
1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Install from the repo using the Nginx webserver" di Menginstal utilitas penyiapan apigee Edge.
2. Pada 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. Pada node jarak jauh, instal utilitas dan dependensi Edge apigee-setup:
```
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 contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Jalankan utilitas update di node Anda sesuai urutan yang dijelaskan di Urutan update mesin:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Dengan keterangan:
- component adalah komponen Edge yang akan diperbarui. Anda biasanya mengupdate komponen berikut:
  - cs: Cassandra
  - edge: Semua komponen Edge kecuali UI Edge: Management Server, Message Processor, Router, QPID Server, Postgres Server
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: SSO Apigee (jika Anda menginstal SSO)
  - UI Edge Baru ue
  - 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 Edge all-in-one (AIO). Contoh:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
Jika Anda belum melakukannya, mulai ulang komponen UI pada semua node yang menjalankannya:
```
/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 nantinya Anda memutuskan untuk melakukan roll back update, gunakan prosedur yang dijelaskan dalam Melakukan roll back 4.52.02.

Urutan update mesin

Urutan Anda memperbarui komputer dalam penginstalan Edge adalah hal penting:

Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
Untuk mesin dengan beberapa komponen Edge (Management Server, Message Processor, Router, Server QPID, tetapi bukan Postgres Server), gunakan opsi -c edge untuk mengupdate semuanya secara bersamaan.
Jika sebuah langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa mesin, jalankan dalam urutan mesin yang ditentukan.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. Opsi ini diperbarui saat Anda menentukan opsi -c edge.

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) Update utilitas apigee-adminapi:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Upgrade mandiri 2 node

Update komponen berikut untuk penginstalan mandiri 2 node:

Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.

Update Cassandra dan ZooKeeper pada komputer 1:

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

Perbarui Postgres di komputer 2:

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

Update LDAP di komputer 1:

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

Update komponen Edge di perangkat 2 dan 1:

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

Update Qpid di Komputer 2:

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

Update UI di perangkat 1:

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

(Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi pada komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 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 Edge di perangkat 1:

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

Upgrade 5 node

Update komponen berikut untuk penginstalan 5 node:

Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.

Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:

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

Update Postgres di komputer 4:

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

Update Postgres di komputer 5:

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

Update LDAP di komputer 1:

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

Update komponen Edge di perangkat 4, 5, 1, 2, 3:

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

Perbarui Qpid di komputer 4:

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

Update Qpid di komputer 5:

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

Update UI Edge:
- UI klasik: Jika Anda menggunakan UI klasik, update komponen ui di perangkat 1, seperti yang ditampilkan dalam 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 mesin yang sesuai (mungkin bukan mesin 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi pada komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 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 perangkat 1, seperti yang ditampilkan dalam 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 mesin yang sesuai (mungkin bukan mesin 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Upgrade dalam cluster 9 node

Update komponen berikut untuk penginstalan yang dikelompokkan 9 node:

Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.

Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:

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

Perbarui Postgres di komputer 8:

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

Update Postgres di komputer 9:

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

Update LDAP di komputer 1:

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

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

Update Qpid di komputer 6 dan 7:

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

Update UI baru (ue) atau UI klasik (ui) di perangkat 1:

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

(Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 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 perangkat 1, seperti yang ditampilkan dalam 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 mesin yang sesuai (mungkin bukan mesin 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Upgrade dalam cluster 13 node

Update komponen berikut untuk penginstalan yang dikelompokkan 13 node:

Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.

Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:

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

Perbarui Postgres di komputer 8:

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

Update Postgres di komputer 9:

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

Update LDAP di komputer 4 dan 5:

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

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

Update Qpid pada komputer 12 dan 13:

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

Update 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) utilitas apigee-adminapi pada komputer 6 dan 7 telah diupdate:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 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 komputer 6 dan 7, seperti yang ditampilkan dalam 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 dalam cluster 12 node

Update komponen berikut untuk penginstalan yang dikelompokkan 12 node:

Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.

Perbarui Cassandra dan ZooKeeper:

Pada komputer 1, 2, dan 3 di Pusat Data 1:

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

Pada komputer 7, 8, dan 9 di Pusat Data 2

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

Perbarui Postgres:

Mesin 6 di Pusat Data 1

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

Mesin 12 di Pusat Data 2

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

Perbarui LDAP:

Mesin 1 di Pusat Data 1

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

Mesin 7 di Pusat Data 2

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

Update komponen Edge:

Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1

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

Mesin 10, 11, 12, 7, 8, 9 di Pusat Data 2

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

Perbarui qpidd:

Mesin 4, 5 di Pusat Data 1

Update qpidd di komputer 4:

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

Update qpidd di komputer 5:

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

Mesin 10, 11 di Pusat Data 2

Update qpidd di komputer 10:

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

Update qpidd di komputer 11:

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

Update UI baru (ue) atau UI klasik (ui):

Mesin 1 di Pusat Data 1:

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

Mesin 7 di Pusat Data 2:

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

(Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi:

Mesin 1 di Pusat Data 1:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Mesin 7 di Pusat Data 2:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

(Jika Anda menginstal SSO Apigee) Update SSO Apigee:
1. Mesin 1 di Pusat Data 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. Mesin 7 di Pusat Data 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Mulai ulang UI Edge baru (edge-management-ui) atau komponen UI Edge klasik (edge-ui) di komputer 1 dan 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

Untuk konfigurasi non-standar

Jika Anda memiliki konfigurasi non-standar, perbarui komponen Edge dengan urutan berikut:

ZooKeeper
Cassandra
ps
LDAP
Edge, artinya profil "-c edge" pada semua node dalam urutan: node dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
CATATAN: Jika node memiliki server Qpid dan Edge Postgres Server yang terinstal, jalankan langkah profil "-c edge".
qpidd
UI Edge (baik klasik maupun baru)
apigee-adminapi
SSO Apigee

Setelah selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua mesin yang menjalankannya.