Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengupdate Apigee Edge 4.53.00 atau 4.53.01 ke 4.54.00

Apigee mendukung upgrade Edge untuk Private Cloud langsung dari versi 4.53.00 atau 4.53.01 ke versi 4.54.00. Halaman ini menjelaskan cara melakukan upgrade tersebut.

Untuk ringkasan jalur upgrade yang kompatibel, lihat matriks kompatibilitas upgrade untuk rilis Edge for Private Cloud.

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.

Materi bacaan awal

Tinjau topik berikut untuk mengetahui informasi penting tentang perubahan yang diperkenalkan di Edge untuk Private Cloud 4.54.00:

Perubahan di 4.54.00: Tinjau perubahan di TLS dan Pemanggilan Java yang memerlukan persiapan sebelum melakukan upgrade. Untuk mengetahui informasi selengkapnya, lihat Perubahan di 4.54.00.
Arsitektur runtime Java ganda (Java 17 dan Java 21): Mulai dari 4.54.00, Edge for Private Cloud tidak lagi mendukung Java 8 dan menjalankan komponen di Java 17 atau Java 21. Untuk mengetahui informasi selengkapnya, lihat Perubahan di 4.54.00.
Tidak ada penginstalan Java otomatis selama bootstrap: Edge untuk Private Cloud 4.54.00 memiliki kemampuan untuk menemukan penginstalan Java dan memvalidasi bahwa Anda telah menginstal Java 17 dan 21.
UI Edge Baru di 4.54.00: Pelajari transisi ke UI Edge Baru sebagai antarmuka pengelolaan default dan penghapusan UI Klasik (edge-ui). Untuk mengetahui informasi selengkapnya, lihat UI Edge Baru.
Apigee SSO di 4.54.00: Pahami perubahan arsitektur dan konfigurasi SSO yang diperbarui untuk autentikasi. Untuk mengetahui informasi selengkapnya, lihat Apigee SSO.
Nginx 1.30 di 4.54.00: Tinjau upgrade otomatis Nginx 1.30.x di Router Edge, potensi dampak runtime, dan langkah-langkah mitigasi. Untuk mengetahui informasi selengkapnya, lihat Perubahan Nginx 1.30.

Prasyarat upgrade

Pastikan prasyarat berikut terpenuhi sebelum mengupgrade Apigee Edge:

Meninjau catatan rilis dan fitur baru

Pastikan Anda meninjau dan memahami secara menyeluruh semua fitur baru, perubahan perilaku, dan penghentian yang dijelaskan dalam catatan rilis Edge untuk Private Cloud versi 4.54.00 sebelum memulai proses upgrade.
Penemuan dan koeksistensi biner Java otomatis selama upgrade: Instal Java menggunakan pengelola paket standar (seperti yum) atau lokasi standar (seperti /usr/lib/jvm atau update-alternatives). Anda tidak perlu mengonfigurasi kedua versi di PATH sistem secara bersamaan. Jangan meng-uninstal Java 8 sebelum mengupgrade. Tetap instal Java 8 bersama Java 17 dan Java 21 agar layanan Edge for Private Cloud 4.53.xx yang ada terus berjalan tanpa terganggu hingga diupdate.
Mencadangkan semua node

Sebelum melakukan update, sebaiknya lakukan pencadangan lengkap semua node untuk alasan keamanan. Gunakan prosedur untuk versi Edge Anda saat ini untuk melakukan pencadangan. Dengan begitu, Anda akan memiliki rencana cadangan jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
Pencadangan file konfigurasi senyap

Pastikan salinan cadangan file konfigurasi senyap untuk Edge for Private Cloud 4.53.00 atau 4.53.01 disimpan untuk memfasilitasi rollback jika diperlukan.
Memastikan Edge berjalan

Pastikan Edge aktif dan berjalan selama proses update menggunakan perintah:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Memverifikasi prasyarat Cassandra

Jika sebelumnya Anda mengupgrade dari Edge untuk Private Cloud versi lama ke versi 4.53.00 (atau) 4.53.01 dan sekarang berencana mengupgrade ke versi 4.54.00, pastikan Anda telah menyelesaikan langkah-langkah pasca-upgrade yang diperlukan untuk Cassandra. Langkah-langkah ini diuraikan dalam dokumentasi upgrade versi 4.53.00 (atau) 4.53.01 dan juga disebutkan di bagian Prasyarat untuk upgrade Cassandra. Jika Anda tidak yakin apakah langkah-langkah ini telah diselesaikan selama upgrade sebelumnya, selesaikan lagi sebelum melanjutkan upgrade ke versi 4.54.00.
Hentikan apigee-monit: Jika apigee-monit berjalan di node, hentikan dengan /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop sebelum melakukan upgrade. Tindakan ini mencegah apigee-monit memulai ulang komponen secara otomatis saat sedang diupgrade. Aktifkan kembali dengan apigee-service apigee-monit start setelah upgrade selesai.

Penyebaran otomatis setelan properti

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

Mengupgrade Router dan Message Processor

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

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

Mengupgrade Server Pengelolaan

Upgrade semua node Server Pengelolaan di seluruh pusat data satu per satu:

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

Upgrade ke OpenLDAP 2.6.10

Edge for Private Cloud 4.54.00 memperkenalkan OpenLDAP 2.6.10. Upgrade ini berlaku untuk semua topologi deployment Apigee OpenLDAP: server tunggal, aktif-pasif, dan aktif-aktif (multi-master).

Persiapan dan penginstalan (Semua server LDAP)

Langkah-langkah untuk mengupgrade LDAP dari 4.53.00 ke 4.54.00

Prasyarat dan pertimbangan

Perlu diketahui bahwa selama proses migrasi OpenLDAP 2.4 ke 2.6.10 (saat mengupgrade dari 4.53.00), API pengelolaan dan akibatnya UI Apigee tidak akan tersedia di semua region. Semua tugas administratif—seperti mengelola pengguna, peran, aplikasi, dan organisasi—akan gagal dan harus dijeda. Tidak ada dampak pada pemrosesan traffic proxy API Anda. Matikan semua instance edge-management-server dan edge-ui sebelum melanjutkan migrasi LDAP.
Pencadangan Sangat Penting (saat mengupgrade dari 4.53.00): Saat mengupgrade dari Edge for Private Cloud 4.53.00 (OpenLDAP 2.4.46), pencadangan lengkap dan tervalidasi dari data LDAP yang ada wajib dilakukan. Melanjutkan tanpa cadangan yang valid akan menyebabkan kehilangan data yang tidak dapat dipulihkan. Mulai pencadangan saat layanan LDAP masih berjalan untuk mengambil snapshot data LDAP yang konsisten dan tepat waktu. Tanpa cadangan, Anda tidak dapat menjalankan migrasi dari 2.4 ke 2.6.10 atau melakukan roll back, karena langkah-langkah migrasi 4.53.00 menghapus direktori data LDAP lama.

Matikan Server dan UI Pengelolaan: Matikan semua instance edge-management-server dan edge-ui sebelum melanjutkan migrasi LDAP dari versi 4.53.00.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
Cadangkan data LDAP yang ada: Sebelum melakukan perubahan apa pun saat mengupgrade dari versi 4.53.00 (OpenLDAP 2.4.46), lakukan pencadangan penuh data LDAP saat ini dari semua server LDAP. Tindakan ini akan membuat titik pemulihan yang aman. (Saat mengupgrade dari versi 4.53.01 ke 4.54.00, urutan pencadangan, penghentian, dan pembersihan ini tidak diperlukan.)
- Jalankan perintah pencadangan. Tindakan ini membuat arsip cadangan yang diberi stempel waktu dalam direktori /opt/apigee/backup/openldap.
```
apigee-service apigee-openldap backup
```
- Mendapatkan jumlah total catatan: Ambil jumlah catatan di direktori Anda untuk validasi setelah upgrade. (Jumlah data harus sama di semua server LDAP.)
```
# Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
Hentikan LDAP dan bersihkan direktori data: Lakukan langkah ini di semua server LDAP hanya jika Anda melakukan upgrade dari versi 4.53.00 (OpenLDAP 2.4.46). Jangan menghentikan LDAP atau menghapus /opt/apigee/data/apigee-openldap/* jika Anda mengupgrade dari versi 4.53.01 (OpenLDAP 2.6.7). Untuk upgrade 4.53.00, langkah ini wajib dilakukan karena perubahan versi utama dan perbedaan struktural database pokok. Saat semua server LDAP dihentikan, gangguan pada Management API dan UI akan dimulai.
- Hentikan layanan LDAP.
```
apigee-service apigee-openldap stop
```
- Hapus direktori data dan konfigurasi LDAP lama secara permanen.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
Instal dan konfigurasi versi LDAP baru Di semua server LDAP, gunakan skrip Apigee standar untuk mendownload dan menginstal versi komponen baru.
- Menginstal komponen LDAP baru: Skrip update membaca file konfigurasi Anda dan menginstal paket apigee-openldap baru.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
- Validasi versi LDAP baru: Setelah penginstalan selesai, muat ulang profil dan verifikasi bahwa versi LDAP baru (2.6.10) telah diinstal:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
  Output perintah yang ditentukan di atas harus memverifikasi LDAP versi 2.6.10 seperti yang ditunjukkan di bawah:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```
Hentikan LDAP di semua server sebelum pemulihan data: Lakukan Langkah 5, 6, dan 7 hanya jika Anda melakukan upgrade dari versi 4.53.00 (OpenLDAP 2.4.46) (jika Anda melakukan upgrade di tempat dari versi 4.53.01 di Langkah 4, data LDAP yang ada akan dipertahankan dan upgrade Anda selesai). Sebelum memulihkan cadangan dari 4.53.00, pastikan layanan LDAP yang baru diinstal dihentikan di semua server. Di setiap server LDAP, jalankan perintah berikut:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*
```
Memulihkan data LDAP: Strateginya adalah memulihkan cadangan di server aktif pertama. Server ini kemudian akan bertindak sebagai sumber tepercaya, yang mereplikasi data ke peer-nya dalam penyiapan multi-server.
1. Identifikasi server aktif pertama untuk pemulihan:
  - Untuk penyiapan server tunggal: Ini adalah satu-satunya server LDAP Anda. Anda dapat langsung melanjutkan ke langkah berikutnya.
  - Untuk penyiapan aktif-pasif dan aktif-aktif: Jalankan perintah diagnostik berikut di setiap server LDAP:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
```
    Catatan:
    - Jika perintah di atas menampilkan output, berarti server tersebut adalah server pasif.
    - Jika tidak menampilkan output, berarti server tersebut adalah server aktif.
2. Pulihkan data cadangan: Sebelum melanjutkan, periksa kembali apakah Langkah 5 telah berhasil diselesaikan di semua server LDAP.
  - Di server aktif pertama yang Anda identifikasi di atas, buka direktori cadangan.
```
cd /opt/apigee/backup/openldap
```
  - Jalankan perintah pemulihan. Tentukan stempel waktu pencadangan yang tepat dari Langkah 2 untuk mencegah pemulihan versi yang tidak diinginkan atau lebih lama.
```
# To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
```
  - Setelah proses pemulihan berhasil diselesaikan, mulai layanan LDAP di server aktif pertama.
```
apigee-service apigee-openldap start
```
Mulai server LDAP yang tersisa: Jika Anda memiliki penyiapan multi-server, di setiap server LDAP, mulai layanan:
```
apigee-service apigee-openldap start
```
Catatan: Anda tidak perlu memulihkan data secara manual di server rekan ini. Setelah dimulai, server tersebut akan terhubung ke server pertama (yang kini berisi data yang dipulihkan) dan otomatis menyinkronkan seluruh direktori melalui replikasi.
Validasi akhir Langkah terakhir adalah memverifikasi bahwa upgrade berhasil dan data konsisten di seluruh cluster LDAP.
- Jalankan perintah validasi di semua server LDAP. Jumlah data harus sama di semua server dan harus cocok dengan jumlah yang Anda ambil di Langkah 2:
```
# Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
- Setelah Anda mengonfirmasi bahwa data sudah benar dan konsisten, upgrade LDAP Anda selesai. Sekarang Anda dapat memulai edge-management-server, edge-ui, dan komponen dependen lainnya sesuai dengan prosedur upgrade standar organisasi Anda.

Langkah-langkah untuk mengupgrade LDAP dari 4.53.01 ke 4.54.00

Instal dan konfigurasi versi LDAP baru Di semua server LDAP, gunakan skrip Apigee standar untuk mendownload dan menginstal versi komponen baru.

Menginstal komponen LDAP baru: Skrip update membaca file konfigurasi Anda dan menginstal paket apigee-openldap baru.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
Validasi versi LDAP baru: Setelah penginstalan selesai, muat ulang profil dan verifikasi bahwa versi LDAP baru (2.6.10) telah diinstal:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
Output perintah yang ditentukan di atas harus memverifikasi LDAP versi 2.6.10 seperti yang ditunjukkan di bawah:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```

Mengupgrade ke UI Edge Baru dan Apigee SSO (Jika Diinstal)

Di Apigee Edge untuk Private Cloud 4.54.00, UI Klasik (edge-ui) dihapus dan digantikan oleh UI Edge Baru (edge-management-ui). Bergantung pada apakah Single Sign-On (SSO) Apigee diinstal dan digunakan dalam penyiapan Anda, ikuti salah satu dari dua opsi di bawah:

Opsi 1: Upgrade UI (tanpa Apigee SSO)

Bagian ini berlaku khusus jika Apigee SSO (apigee-sso) tidak dikonfigurasi / diinstal di penginstalan Edge for Private Cloud versi 4.53.00 atau 4.53.01 yang ada

Sebagai bagian dari proses upgrade Edge for Private Cloud versi 4.54.00, UI Klasik (edge-ui) akan dihapus. Menjalankan perintah upgrade berikut akan mentransisikan node UI dari Classic UI (edge-ui) ke New Edge UI (edge-management-ui).

Langkah 1: Mencadangkan file konfigurasi

Sebelum memulai, lakukan pencadangan file konfigurasi senyap (configFile) yang ada dan direktori /opt/apigee/customer/application/ di semua node UI.

Langkah 2: Perbarui file konfigurasi senyap untuk Autentikasi Dasar

Edit file konfigurasi senyap Anda (misalnya, /opt/silent.conf) dan tambahkan properti UI New Edge berikut untuk Autentikasi Dasar:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

Langkah 3: Upgrade komponen UI

Jalankan skrip update.sh dengan komponen -c ue untuk mengupgrade dari UI Klasik (edge-ui) ke UI Edge Baru (edge-management-ui):

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

Langkah 4: Verifikasi upgrade Edge UI Baru

Setelah berhasil menyelesaikan proses upgrade di semua node UI, pastikan bahwa UI Edge Baru versi 4.54.00 beroperasi sepenuhnya dan dapat diakses:

Pastikan layanan edge-management-ui berjalan:
```
apigee-service edge-management-ui status
```
Buka browser dan buka:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
Setelah diverifikasi, lewati Opsi 2: Upgrade UI (dengan Apigee SSO) dan lanjutkan langsung ke Upgrade yang Diperlukan ke Qpid.

Opsi 2: Upgrade UI (dengan Apigee SSO)

Gunakan bagian ini jika Apigee SSO (apigee-sso) dikonfigurasi / diinstal di lingkungan Edge for Private Cloud 4.53.00 atau 4.53.01 Anda.

Di Apigee Edge for Private Cloud 4.54.00:

Layanan Apigee SSO yang mendasarinya bertransisi dari komponen apigee-sso lama ke Apigee SSO yang dikelola di bagian apigee-openldap. Upgrade ini wajib dilakukan saat mengupgrade ke Apigee Edge for Private Cloud versi 4.54.00 jika SSO diaktifkan di Edge for Private Cloud versi 4.53.00 atau 4.53.01.
4.53.x Classic UI (edge-ui) dengan SSO dan 4.53.x New Edge UI (edge-management-ui) dengan SSO diupgrade ke 4.54.00 New Edge UI (edge-management-ui) dengan Apigee SSO.

Baca artikel berikut untuk memahami desain Apigee SSO baru dan dampaknya terhadap utilitas dan alur otomatisasi dengan Management API:
Tentang struktur Apigee SSO Baru
Tugas Otomatis menggunakan SSO

Ikuti langkah-langkah end-to-end gabungan di bawah untuk mengupgrade UI dan Apigee SSO Anda dengan lancar tanpa langkah-langkah konfigurasi duplikat:

Langkah 1: Mencadangkan file konfigurasi

Cadangkan configFile senyap yang ada dan direktori /opt/apigee/customer/application/ di semua node UI dan SSO sebelum melanjutkan.

Langkah 2: Hapus variabel UI/SSO yang tidak digunakan lagi dan perbarui file konfigurasi senyap (`configFile`)

Sebelum mengupgrade UI Edge Baru dan mengonfigurasi modul Apigee SSO, perbarui file konfigurasi senyap (configFile) dalam satu langkah berdasarkan penyiapan UI 4.53.x Anda saat ini:

Hapus atau jadikan sebagai komentar variabel UI dan SSO 4.53.x yang tidak digunakan lagi dari configFile:

Jika mengupgrade dari UI Klasik (edge-ui) dengan apigee-sso: Hapus atau jadikan sebagai komentar properti terkait UI Klasik dan SSO:

EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

Jika mengupgrade dari New Edge UI (edge-management-ui) dengan apigee-sso: Hapus atau jadikan sebagai komentar properti terkait SSO, Shoehorn, dan UI Klasik 4.53.x yang tidak digunakan lagi:

EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
EDGEUI_ENABLE_UNIFIED_UI=n
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000
CLASSIC_UI_SCHEME=http
CLASSIC_UI_PORT=9000
MANAGEMENT_UI_PUBLIC_URIS=http://Public_IP:3001
MANAGEMENT_UI_SSO_REGISTERD_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
ROUTES_CLASSICUI=""
ROUTES_SHOEHORN=""

Gunakan perintah berikut di node apigee-openldap untuk membuat pengguna mesin bagi UI Edge Baru, dan pastikan untuk menggunakan kredensial yang sama persis saat menentukan properti dalam file konfigurasi senyap (configFile) pada langkah berikutnya. Untuk mengetahui informasi selengkapnya, lihat Membuat pengguna mesin untuk UI.
```
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
```

Tambahkan atau perbarui properti Apigee SSO 4.54.00 dan UI Edge Baru yang diperlukan di configFile:

# ==========================================
# SSO Enablement
# ==========================================
ENABLE_SSO=y

# ==========================================
# SSO Hostname/IP and Port config for Apigee SSO
# ==========================================
SSO_PUBLIC_URL_SCHEME=http
SSO_PUBLIC_URL_HOSTNAME=YOUR_SSO_NODE_IP_OR_HOSTNAME #Replace YOUR_SSO_NODE_IP_OR_HOSTNAME with the IP address or hostname of the SSO node.
SSO_PUBLIC_URL_PORT=9099

# ==========================================
# Static Client UI credentials
# ==========================================
MANAGEMENT_UI_SSO_CLIENT_ID=YOUR_SSO_CLIENT_ID #Example : MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui
MANAGEMENT_UI_SSO_CLIENT_SECRET=YOUR_SSO_CLIENT_SECRET #Example : MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123

# ==========================================
# Management UI & SSO redirect URLs
# ==========================================
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_PORT=3001

# ==========================================
# Management Server parameters (Required for SSO registration)
# ==========================================
MSIP=MS_IP_OR_HOSTNAME #Replace MS_IP_OR_HOSTNAME with the IP address or hostname of the Management Server node.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password

# ==========================================
# Machine user for UI
# ==========================================
UI_MACHINE_USER=ui-machine-user@apigee.com
UI_MACHINE_PWD=Secret123

# ==========================================
# Postgres connection parameters
# ==========================================
# Postgres username and password as set when you installed Edge.
PG_HOST=PG_IP_OR_HOSTNAME
PG_USER=apigee
PG_PWD=YOUR_PG_PASSWORD

# ==========================================
# Other UI Parameters
# ==========================================
AUTH_MODE=sso

# Y to use Internal/Local LDAP for authentication, N to use external IDP
SSO_LOCAL_LDAP=y

MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

Langkah 3: Upgrade komponen UI Edge Baru

Hentikan dan Uninstal komponen edge-management-ui (UI Edge Baru) dan edge-ui (UI Shoehorn), jika UI Edge Baru sedang digunakan :

#Remove 4.53.xx New Edge UI from installation node 
apigee-service edge-management-ui stop
apigee-service edge-management-ui uninstall

#Remove Shoehorn UI from the node with 4.53.xx New Edge UI
apigee-service edge-ui stop
apigee-service edge-ui uninstall

Jalankan skrip update.sh di node Classic UI (edge-ui) untuk menginstal dan mengupgrade ke komponen New Edge UI (edge-management-ui):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```

Langkah 4: Hentikan `apigee-sso`

Hentikan layanan apigee-sso lama di semua node tempat layanan tersebut diinstal:

apigee-service apigee-sso stop

Langkah 5: Buat database `apigee_dex` untuk Apigee SSO di node Postgres

Di node utama Postgres, login ke Postgresql menggunakan perintah berikut:
```
psql -h $(hostname -i) -U apigee
```
Jalankan perintah berikut di prompt psql untuk membuat database Apigee SSO:
```
create database apigee_dex;
```

Langkah 6: Siapkan Apigee SSO di node OpenLDAP

Jalankan perintah berikut pada node apigee-openldap tempat Apigee SSO akan diinstal:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

Langkah 7: Konfigurasi UI Pengelolaan untuk Apigee SSO dan mulai ulang UI

Jalankan perintah berikut di setiap node yang telah menginstal Edge untuk Private Cloud 4.54.00 edge-management-ui:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

Langkah 8: Verifikasi upgrade UI Edge Baru dan Apigee SSO

Setelah menyelesaikan langkah-langkah di atas, pastikan UI Edge Baru dan Apigee SSO versi 4.54.00 berjalan dan dapat diakses:

Pastikan layanan edge-management-ui berjalan:
```
apigee-service edge-management-ui status
```
Buka browser dan buka:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
Login menggunakan kredensial SSO yang telah dikonfigurasi.

Langkah 9: Uninstal `apigee-sso` lama

Di semua node tempat apigee-sso lama diinstal, uninstal komponen apigee-sso:

apigee-service apigee-sso uninstall

Upgrade ke Qpid 10.0.1

Metode ini memastikan tidak ada periode nonaktif untuk lingkungan runtime Edge Anda dan meminimalkan kehilangan data runtime, jika ada, yang diperoleh untuk analisis.

Untuk melakukan upgrade langsung tanpa periode nonaktif ke Qpid:

Pilih satu node Qpid untuk memulai.
Hentikan broker Qpid pada node:
```
apigee-service apigee-qpidd stop
```
Blokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini di tingkat instance node Qpid atau komponen firewall/jaringan eksternal lainnya.

Sebaiknya lakukan langkah yang sama untuk semua alamat IP pemroses pesan. Misalnya, untuk MENGHAPUS permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid di port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
Mulai broker Qpid lagi untuk menguras pesan yang ada, jika ada:
```
apigee-service apigee-qpidd start
```
Pastikan antrean yang ada kosong:
```
/opt/apigee/apigee-qpidd/bin/qpid-stat -q
```
Jika pesan macet di dead letter queue (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), kosongkan antrean menggunakan langkah-langkah untuk menyelesaikan data analisis yang macet di dead letter queue.
Setelah memverifikasi bahwa antrean telah dikosongkan di node lama, hentikan apigee-qpidd:
```
apigee-service apigee-qpidd stop
```

Upgrade Qpid di node:

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

Mulai ulang edge-qpid-server:
```
apigee-service edge-qpid-server restart
```
Hapus aturan firewall yang diterapkan di Langkah 3.

Lakukan langkah penghapusan yang sama untuk semua alamat IP pemroses pesan yang menerapkan firewall. Setelah firewall dihapus, permintaan yang berasal dari alamat IP Message Processor ke node Qpid di port 5672 akan diterima. Jika Anda menggunakan iptables untuk menambahkan firewall, untuk menghapus firewall dan mencantumkan setelan yang ada, Anda dapat menggunakan perintah seperti berikut:
```
iptables -F
iptables -L
```
Gunakan pemantauan web untuk memverifikasi bahwa antrean Qpid menerima pesan:
```
http://QPID_NODE_IP:8090
```
Ulangi Langkah 1 hingga 9 untuk setiap node Qpid.

Upgrade ke Postgres 18.6

Rilis Edge ini mencakup upgrade ke Postgres 18.6. Sebagai bagian dari upgrade tersebut, semua data Postgres dimigrasikan ke Postgres 18.6

Sebagian besar sistem produksi Edge menggunakan dua node Postgres yang dikonfigurasi untuk replikasi utama-standby. Selama proses update, saat node Postgres tidak aktif untuk update, data analisis masih ditulis ke node Qpid. Setelah node Postgres diperbarui dan kembali online, data analisis akan dikirim ke node Postgres.

Cara Anda melakukan update Postgres bergantung pada cara Anda mengonfigurasi penyimpanan data untuk node Postgres:

Jika Anda menggunakan penyimpanan data lokal untuk node Postgres , Anda harus menginstal node standby Postgres baru selama durasi upgrade. Setelah upgrade selesai, Anda dapat menonaktifkan node standby Postgres baru. Node standby Postgres tambahan diperlukan jika Anda harus mengembalikan update karena alasan apa pun. Jika Anda harus melakukan roll back update, node standby Postgres baru akan menjadi node Postgres utama setelah roll back. Oleh karena itu, saat menginstal node standby Postgres baru, node tersebut harus berada di node yang memenuhi semua persyaratan hardware server Postgres, sebagaimana ditentukan dalam Persyaratan penginstalan Edge.

Dalam konfigurasi Edge 1 node dan 2 node, topologi yang digunakan untuk pembuatan prototipe dan pengujian, Anda hanya memiliki satu node Postgres. Anda dapat memperbarui node Postgres ini secara langsung tanpa harus membuat node Postgres baru.
Jika Anda menggunakan penyimpanan jaringan untuk node Postgres , seperti yang direkomendasikan oleh Apigee, Anda tidak perlu menginstal node Postgres baru. Dalam prosedur di bawah, Anda dapat melewati langkah-langkah yang menentukan untuk menginstal dan kemudian menonaktifkan node standby Postgres baru. Sebelum memulai proses update, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Kemudian, jika terjadi error selama update dan Anda harus melakukan rollback, Anda dapat memulihkan node Postgres dari snapshot tersebut.

Menginstal node standby Postgres baru

Prosedur ini membuat server standby Postgres di node baru. Pastikan Anda menginstal server standby Postgres baru untuk Edge versi yang ada (4.53.00 atau 4.53.01), bukan untuk versi 4.54.00.

Untuk melakukan penginstalan, gunakan file konfigurasi yang sama dengan yang Anda gunakan untuk menginstal Edge versi saat ini.

Untuk membuat node standby Postgres baru:

Pada Postgres utama saat ini, edit file /opt/apigee/customer/application/postgresql.properties untuk menetapkan token berikut. Jika file tersebut tidak ada, buat file:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Dengan existing_standby_ip adalah alamat IP server standby Postgres saat ini dan new_standby_ip adalah alamat IP node standby baru.

Mulai ulang apigee-postgresql di Postgres utama:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Verifikasi bahwa node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di node utama. Anda akan melihat baris berikut dalam file tersebut:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Instal server standby Postgres baru:
1. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini guna menentukan hal berikut:
```
# IP address of the current primary(master):
PG_MASTER=PG_MASTER_NODE_IP
# IP address of the new standby node
PG_STANDBY=PG_STANDBY_NODE_IP
```
2. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
3. Download dan jalankan skrip bootstrap berdasarkan versi Edge Anda saat ini:
  - Jika Anda saat ini menggunakan Edge 4.53.00:
    
    Download file bootstrap_4.53.00.sh Edge ke /tmp/bootstrap_4.53.00.sh:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
    Instal utilitas dan dependensi apigee-service Edge:
```
bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  - Jika Anda saat ini menggunakan Edge 4.53.01:
    
    Download file bootstrap_4.53.01.sh Edge ke /tmp/bootstrap_4.53.01.sh:
```
curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
    Instal utilitas dan dependensi apigee-service Edge:
```
bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
```
4. Gunakan apigee-service untuk menginstal utilitas apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Menginstal Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Di node standby baru, jalankan perintah berikut dan verifikasi bahwa node tersebut adalah standby:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```

Melakukan upgrade Postgres di tempat

Langkah awal

Sebelum melakukan upgrade langsung ke Postgres, lakukan langkah-langkah berikut pada host utama dan standby, untuk memperbarui properti max_locks_per_transaction di apigee-postgresql:

Jika tidak ada, buat file /opt/apigee/customer/application/postgresql.properties .

Ubah kepemilikan file ini menjadi apigee :

chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Tambahkan properti berikut ke file:

conf/postgresql.conf+max_locks_per_transaction=30000

Konfigurasikan apigee-postgresql :

apigee-service apigee-postgresql configure

Mulai ulang apigee-postgresql :

apigee-service apigee-postgresql restart

Melakukan upgrade di tempat

Untuk melakukan upgrade langsung ke Postgres 18, lakukan langkah-langkah berikut:

Mengupgrade postgres di host utama

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

Jalankan perintah penyiapan di host utama:

apigee-service apigee-postgresql setup -f configFile

Jalankan perintah configure di host utama:

apigee-service apigee-postgresql configure

Mulai ulang host utama:

apigee-service apigee-postgresql restart

Konfigurasikan sebagai utama:

apigee-service apigee-postgresql setup-replication-on-master -f configFile

Pastikan host utama telah dimulai:

apigee-service apigee-postgresql wait_for_ready

Hentikan standby:
```
apigee-service apigee-postgresql stop
```
Upgrade standby.

Catatan: Jika langkah ini error/gagal, langkah ini dapat diabaikan. update.sh akan mencoba memulai server standby dengan konfigurasi yang salah. Jika penginstalan Postgres diupgrade ke versi 18, error ini dapat diabaikan.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Pastikan standby dihentikan:
```
apigee-service apigee-postgresql stop
```

Hapus konfigurasi standby lama:

rm -rf /opt/apigee/data/apigee-postgresql/

Siapkan replikasi di server standby:

apigee-service apigee-postgresql setup-replication-on-standby -f configFile

Hapus baris conf/postgresql.conf+max_locks_per_transaction=30000 dari file /opt/apigee/customer/application/postgresql.properties di host utama dan standby. Baris ini ditambahkan di langkah awal .

Setelah menyelesaikan prosedur ini, standby akan berhasil dimulai.

Menonaktifkan node Postgres

Setelah update selesai, nonaktifkan node standby baru:

Pastikan Postgres berjalan:

/opt/apigee/apigee-service/bin/apigee-all status

Jika Postgres tidak berjalan, mulai:

/opt/apigee/apigee-service/bin/apigee-all start

Dapatkan UUID node standby baru dengan menjalankan perintah curl berikut pada node standby baru:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Anda akan melihat UUID node di akhir output, dalam bentuk:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Hentikan node standby baru dengan menjalankan perintah berikut pada node standby baru:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Di node utama Postgres, edit /opt/apigee/customer/application/postgresql.properties untuk menghapus node standby baru dari conf_pg_hba_replication.connection:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Mulai ulang apigee-postgresql di Postgres utama:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Verifikasi bahwa node standby baru telah dihapus dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di instance utama. Anda hanya akan melihat baris berikut dalam file tersebut:
```
host replication apigee existing_standby_ip/32 trust
```
Hapus UUID node standby dari ZooKeeper dengan melakukan panggilan API pengelolaan Edge berikut pada node Server Pengelolaan:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Langkah-langkah pasca-upgrade untuk Postgres

Setelah upgrade Postgres utama, statistik internal Postgres akan dihapus. Statistik ini membantu perencana kueri Postgres dalam menggunakan indeks dan jalur yang paling optimal untuk menjalankan kueri.

Postgres dapat secara bertahap membangun kembali statistiknya dari waktu ke waktu saat kueri dijalankan dan saat daemon autovacuum berjalan. Namun, hingga statistik dibuat ulang, kueri Anda mungkin lambat.

Untuk mengatasi masalah ini, jalankan ANALYZE di semua tabel dalam database pada node Postgres utama. Atau, Anda dapat menjalankan ANALYZE untuk beberapa tabel sekaligus.

Mengupgrade ke ZooKeeper 3.8.5

Rilis Edge for Private Cloud ini mencakup upgrade ke ZooKeeper 3.8.5. Sebagai bagian dari upgrade tersebut, semua data ZooKeeper akan dimigrasikan ke ZooKeeper 3.8.5.

Sebelum mengupgrade ZooKeeper, baca panduan pemeliharaan ZooKeeper. Sebagian besar sistem produksi Edge menggunakan cluster node ZooKeeper yang tersebar di beberapa pusat data. Beberapa node ini dikonfigurasi sebagai pemilih yang berpartisipasi dalam pemilihan pemimpin ZooKeeper, dan sisanya dikonfigurasi sebagai pengamat. Lihat Tentang leader, follower, voter, dan observer untuk mengetahui detail selengkapnya. Node pemilih memilih pemimpin, setelah itu node pemilih itu sendiri menjadi pengikut.

Selama proses update, mungkin akan ada penundaan sesaat atau kegagalan penulisan di ZooKeeper saat node pemimpin dinonaktifkan. Hal ini dapat memengaruhi operasi Pengelolaan yang menulis ke ZooKeeper, seperti operasi deployment proxy, dan perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll. Tidak akan ada dampak pada API runtime Apigee (kecuali jika API runtime ini memanggil API pengelolaan) selama upgrade ZooKeeper sambil mengikuti prosedur di bawah.

Secara umum, proses upgrade melibatkan pencadangan setiap node. Langkah ini diikuti dengan mengupgrade semua observer dan follower, lalu mengupgrade node leader.

Membuat cadangan

Buat cadangan semua node ZooKeeper untuk digunakan jika diperlukan rollback. Perhatikan bahwa rollback akan memulihkan ZooKeeper ke status saat cadangan dibuat.

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Jika Anda menggunakan virtual machine dan memiliki kemampuan, snapshot atau cadangan VM juga dapat diambil untuk pemulihan atau rollback (jika perlu).

Mengidentifikasi pemimpin, pengikut, dan pengamat

Jika belum diinstal di node ZooKeeper, instal nc:
```
yum install nc
```

Jalankan perintah nc berikut pada node, dengan 2181 adalah port ZooKeeper:

echo stat | nc localhost 2181

Anda akan melihat output seperti berikut:

Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
Clients:
 /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)

Latency min/avg/max: 3/4.3333/6
Received: 4
Sent: 3
Connections: 1
Outstanding: 0
Zxid: 0x500000005
Mode: follower

Di baris Mode pada output untuk node, Anda akan melihat observer, leader, atau follower (artinya pemilih yang bukan leader) bergantung pada konfigurasi node.

Ulangi langkah 1 dan 2 pada setiap node ZooKeeper.

Mengupgrade ZooKeeper di node observer dan pengikut

Upgrade ZooKeeper di setiap node pengamat dan pengikut sebagai berikut:

Download dan jalankan bootstrap Edge for Private Cloud 4.54.00, seperti yang dijelaskan dalam Update ke 4.54.00 di node dengan koneksi internet eksternal . Prosesnya mungkin akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda melakukan penginstalan offline.
Upgrade komponen ZooKeeper:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f silent-config-file
```
Catatan: Jika node ini telah menginstal komponen lain (seperti Cassandra), Anda juga dapat mengupgradenya sekarang (seperti dengan profil zk,cs) atau mengupgrade komponen lain nanti. Apigee merekomendasikan agar Anda mengupgrade ZooKeeper terlebih dahulu dan memastikan cluster Anda berfungsi dengan baik sebelum mengupgrade komponen lainnya.
Ulangi langkah-langkah di atas pada setiap node observer dan follower ZooKeeper.

Mematikan leader

Setelah semua node observer dan follower diupgrade, matikan pemimpin. Pada node yang diidentifikasi sebagai pemimpin, jalankan perintah di bawah:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Perhatikan bahwa selama peristiwa ini, sebelum pemimpin baru dipilih, mungkin ada penundaan sementara atau kegagalan penulisan di ZooKeeper. Hal ini dapat memengaruhi operasi yang menulis ke ZooKeeper, seperti tindakan deployment proxy atau perubahan infrastruktur Apigee, seperti penambahan atau penghapusan Message Processor, dll.

Memastikan leader baru terpilih

Dengan menggunakan langkah-langkah di bagian Mengidentifikasi pemimpin, pengikut, dan pengamat di atas, pastikan pemimpin baru telah dipilih dari pengikut, setelah pemimpin yang ada dihentikan. Perhatikan bahwa leader dapat dipilih di pusat data yang berbeda dari leader saat ini.

Upgrade pemimpin

Ikuti langkah-langkah yang sama seperti di Mengupgrade ZooKeeper di node observer dan follower di atas.

Setelah node pemimpin lama juga diupgrade, verifikasi kondisi cluster dan pastikan ada node pemimpin.

Upgrade ke Cassandra 5.0.8

Apigee Edge for Private Cloud 4.54.00 menyertakan upgrade Cassandra ke versi 5.0.8.

Upgrade dan rollback

Upgrade dari Cassandra 4.0.X ke Cassandra 5.0.X adalah proses bertahap.
Rollback langsung di tempat dari Cassandra 5.0.X ke 4.0.X tidak dapat dilakukan. Melakukan roll back menggunakan replika atau cadangan adalah prosedur yang kompleks dan dapat menyebabkan periode nonaktif dan/atau kehilangan data. Memecahkan masalah dan mengupgrade ke Cassandra 5.0.X lebih disarankan daripada melakukan rollback.
Anda harus memahami prosedur rollback sebelum mencoba melakukan upgrade. Mempertimbangkan nuansa rollback selama upgrade sangat penting untuk memastikan jalur rollback yang sesuai tersedia.

Pusat data tunggal

Mengupgrade Cassandra dari 4.0.X ke 5.0.X dalam satu pusat data dapat dilakukan dengan lancar, tetapi rollback-nya rumit dan dapat menyebabkan periode nonaktif serta kehilangan data. Untuk workload produksi, sebaiknya tambahkan pusat data baru dengan setidaknya node Cassandra yang tersedia di pusat data baru sebelum memulai upgrade. Hal ini akan memungkinkan rollback Cassandra tanpa menyebabkan kehilangan data atau gangguan pada traffic API Anda. Pusat data tambahan ini dapat dinonaktifkan setelah upgrade selesai.

Jika penambahan pusat data baru tidak memungkinkan, tetapi kemampuan rollback masih diinginkan, pencadangan akan diperlukan untuk memulihkan Cassandra 4.0.X. Namun, metode ini kemungkinan akan menyebabkan periode nonaktif dan kehilangan data.

Beberapa pusat data

Mengoperasikan beberapa pusat data dengan Edge for Private Cloud 4.53.00 (atau) 4.53.01 menawarkan lebih banyak fleksibilitas untuk rollback selama upgrade ke Edge for Private Cloud 4.54.00.

Rollback memerlukan minimal satu pusat data yang menjalankan versi Cassandra sebelumnya (4.0.X).

Metodologi upgrade yang direkomendasikan

Upgrade satu pusat data Cassandra dalam satu waktu: Mulailah dengan mengupgrade node Cassandra satu per satu dalam satu pusat data. Selesaikan upgrade semua node Cassandra di satu pusat data sebelum melanjutkan ke pusat data berikutnya.
Jeda dan validasi: Setelah mengupgrade satu pusat data, jeda untuk memastikan cluster Private Cloud Anda, terutama pusat data yang diupgrade, berfungsi dengan benar.
Ingat: Anda hanya dapat melakukan roll back ke versi Cassandra sebelumnya jika Anda memiliki setidaknya satu pusat data yang masih menjalankan versi lama.
Sensitif terhadap waktu: Meskipun Anda dapat menjeda selama jangka waktu singkat (disarankan beberapa jam) untuk memvalidasi fungsi, Anda tidak dapat tetap berada dalam status versi campuran tanpa batas waktu. Hal ini karena cluster Cassandra yang tidak seragam (dengan node pada versi yang berbeda) memiliki batasan operasional.
Pengujian menyeluruh: Apigee sangat merekomendasikan pengujian performa dan fungsi yang komprehensif sebelum mengupgrade pusat data berikutnya. Setelah semua pusat data diupgrade, rollback ke versi sebelumnya tidak dapat dilakukan.

Proses checkpoint rollback

Satu Checkpoint Rollback: Jika semua komponen diupgrade ke 4.54.00, rollback Cassandra tetap dapat dilakukan hanya jika setidaknya satu pusat data Cassandra terus menjalankan versi yang lebih lama. Setelah pusat data Cassandra terakhir diupgrade, upgrade ke Edge for Private Cloud 4.54.00 selesai, dan rollback tidak dapat dilakukan lagi.

Contoh

Pertimbangkan cluster dua pusat data (DC):

Status awal: Node Cassandra di kedua DC menggunakan versi 4.0.X. Semua node lainnya berada di Edge for Private Cloud versi 4.54.00. Asumsikan tiga node Cassandra per DC.
Mengupgrade DC-1: Upgrade tiga node Cassandra di DC-1 satu per satu.
Jeda dan validasi: Jeda untuk memastikan cluster, terutama DC-1, berfungsi dengan benar (periksa performa, fungsi). Anda dapat melakukan roll back ke status awal menggunakan node Cassandra di DC-2. Ingat, jeda ini harus bersifat sementara karena batasan cluster Cassandra versi campuran.
Mengupgrade DC-2: Upgrade tiga node Cassandra yang tersisa di DC-2. Setelah semua node Cassandra di DC-2 berhasil diupgrade, upgrade Edge for Private Cloud 4.54.00 selesai.

Prasyarat untuk upgrade Cassandra

Anda harus menjalankan Cassandra 4.0.X dengan Edge for Private Cloud 4.53.00 (atau) 4.53.01 dan memastikan hal berikut:

Tetapkan Java 17 sebagai versi Java default di server: Cassandra 5.0.X menghapus dukungan Java 8. Anda tidak dapat menjalankan Cassandra 5.0.X atau utilitas nodetool-nya dengan Java 8. Pastikan Java 17 diinstal di setiap node Cassandra dan tetapkan Java 17 sebagai versi Java default sebelum menjalankan langkah-langkah upgrade Cassandra agar perintah nodetool dijalankan dengan Java 17:
```
alternatives --set java JAVA_17_PATH/bin/java
```
Pastikan versi Java default yang aktif adalah Java 17:
```
java -version
```
Seluruh cluster beroperasi dan berfungsi sepenuhnya dengan Cassandra 4.0.X.
Strategi pemadatan ditetapkan ke LeveledCompactionStrategy (prasyarat untuk upgrade ke versi 4.53.00 (atau) 4.53.01).
Pastikan setiap langkah di bawah telah diselesaikan sebagai bagian dari upgrade awal Cassandra 4.0.X di Edge for Private Cloud versi 4.53.00 (atau) 4.53.01.
- Perintah post_upgrade dijalankan di setiap node Cassandra selama upgrade sebelumnya
- Perintah drop_old_tables dijalankan di seluruh cluster Cassandra selama upgrade sebelumnya.

Jika Anda tidak yakin bahwa perintah post_upgrade dan drop_old_tables telah dieksekusi di Cassandra 4.0.X saat menggunakan Edge untuk Private Cloud 4.53.00 (atau) 4.53.01, Anda dapat menjalankannya kembali dengan aman sebelum mencoba upgrade ke 4.54.00.

Langkah 1: Bersiap untuk upgrade

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

Mencadangkan Cassandra menggunakan Apigee.
Ambil snapshot VM dari node Cassandra (jika memungkinkan).
Pastikan port 9042 dapat diakses dari semua komponen Edge for Private Cloud, termasuk Management Server, Message Processor, Router, Qpid, dan Postgres, ke node Cassandra jika belum dikonfigurasi. Lihat Persyaratan port untuk mengetahui informasi selengkapnya.

Langkah 2: Upgrade semua node Cassandra

Semua node Cassandra harus diupdate satu per satu di setiap pusat data, satu pusat data dalam satu waktu. Di antara upgrade node dalam pusat data, tunggu beberapa menit untuk memastikan bahwa node yang diupdate telah dimulai sepenuhnya dan bergabung dengan cluster sebelum melanjutkan upgrade node lain di pusat data yang sama.

Setelah mengupgrade semua node Cassandra dalam pusat data, tunggu beberapa saat (30 menit hingga beberapa jam) sebelum melanjutkan dengan node di pusat data berikutnya. Selama waktu ini, tinjau secara menyeluruh pusat data yang diupdate dan pastikan metrik fungsional dan performa cluster Apigee Anda tetap utuh. Langkah ini sangat penting untuk memastikan stabilitas pusat data tempat Cassandra telah diupgrade ke versi 5.0.X, sementara komponen Apigee lainnya diupgrade ke 4.54.00.

Untuk mengupgrade node Cassandra, jalankan perintah berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Setelah node diupdate, 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 seperti berikut:

Cassandra version is verified - [cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Metadata is verified

Jalankan perintah post_upgrade berikut di node Cassandra:

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

Jalankan perintah cleanup_old_index berikut di node Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

Jalankan perintah nodetool berikut untuk membangun ulang indeks pada node Cassandra:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx    
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx

Jika Anda menggunakan monetisasi, jalankan juga perintah rebuild indeks berikut yang terkait dengan keyspace monetisasi:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

Mengupdate dengan mTLS Apigee

Untuk mengupdate Apigee mTLS , lakukan langkah-langkah berikut:

Me-roll back update

Jika update gagal, Anda dapat mencoba memperbaiki masalahnya, 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.54.00 untuk mengetahui petunjuk mendetail.

Mencatat informasi update ke dalam log

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

Update tanpa periode nonaktif, 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, Anda mengupdate Router dan komponen lainnya di mesin yang sama dengan Router, lalu menambahkan kembali Router ke load balancer.

Perbarui komputer dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan dalam Urutan update komputer .
Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar 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 Message Processor di node yang sama.
Buat Router dapat dijangkau lagi.
Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
Lanjutkan update untuk mesin yang tersisa di penginstalan Anda.

Lakukan hal berikut sebelum dan setelah update:

Pada node Router dan Message Processor gabungan:
- Sebelum update – lakukan hal berikut:
  1. Membuat Router tidak dapat dijangkau.
  2. Membuat Message Processor tidak dapat dijangkau.
- Setelah update – lakukan hal berikut:
  1. Buat Pemroses Pesan dapat dijangkau.
  2. Membuat Router dapat dijangkau.
Pada node Router tunggal:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, 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. Meskipun file konfigurasi otomatis sebagian besar mirip dengan yang Anda gunakan untuk menginstal Edge for Private Cloud 4.53.00 atau 4.53.01, Anda mungkin perlu melakukan perubahan untuk komponen seperti UI dan SSO, seperti yang dijelaskan dalam Mengupgrade ke UI Edge Baru dan Apigee SSO (Jika Diinstal).

Update ke 4.54.00 di node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

Jika ada, nonaktifkan 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.
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge .

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

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

Jika Anda saat ini menggunakan Edge for Private Cloud 4.53.00 (atau) 4.53.01:
1. Download file Edge bootstrap_4.54.00.sh ke /tmp/bootstrap_4.54.00.sh :
```
curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
2. Instal utilitas apigee-service dan dependensi Edge 4.54.00 dengan menjalankan perintah berikut:
```
bash /tmp/bootstrap_4.54.00.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 17 & 21.
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 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 hal ini sesuai urutan yang dijelaskan dalam Urutan update mesin.
  
  Dengan:
  - component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
    - edge : Semua komponen Edge kecuali UI Edge Baru: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres
    - ldap : OpenLDAP
    - ue : UI Edge Baru
    - qpid : Apigee Qpid
    - ps : Apigee Postgresql
    - zk : ZooKeeper
    - cs : Cassandra
  - configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.53.00 (atau) 4.53.01.
  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 menetapkan 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 configFile
```
7. Mulai ulang komponen UI Edge Baru di semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-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.54.00

Mengupdate ke 4.54.00 dari repositori 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, dari repositori Apigee.

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 update 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.54.00 lokal:

Buat repositori 4.54.00 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.

Catatan: Jika sudah memiliki repositori, Anda dapat menambahkan repositori 4.54.00 ke repositori tersebut seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
Instal apigee-service di node target menggunakan salah satu metode berikut:
- Opsi 1: 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.54.00.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. Pada node baru, untar file ke direktori /tmp:
```
tar -xzf apigee-4.54.00.tar.gz
```
    Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.
  4. Instal utilitas dan dependensi apigee-service Edge dari /tmp/repos:
```
bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
- Opsi 2: Instal apigee-service menggunakan server web Nginx
  1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
  2. Di node jarak jauh, download file bootstrap_4.54.00.sh Edge ke /tmp/bootstrap_4.54.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
    Dengan uName:pWord adalah nama pengguna dan sandi yang sebelumnya Anda tetapkan untuk repo, dan remoteRepo adalah alamat IP atau nama DNS dari node repo.
  3. Di node jarak jauh, instal utilitas dan dependensi apigee-service Edge:
```
bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Dengan uName:pWord adalah nama pengguna dan sandi repositori.
Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Perbarui 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 dalam Urutan update mesin:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Dengan:
- component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
  - edge : Semua komponen Edge kecuali UI Edge Baru: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres
  - ldap : OpenLDAP
  - ue : UI Edge Baru
  - qpid : Apigee Qpid
  - ps : Apigee Postgresql
  - zk : ZooKeeper
  - cs : Cassandra
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.53.00 (atau) 4.53.01.
  
  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 configFile
```
Mulai ulang komponen UI di semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

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

Urutan update mesin

Urutan update mesin dalam penginstalan Edge sangat penting. Upgrade komponen Anda dalam urutan di bawah.

Upgrade semua node Router dan Message Processor di semua pusat data menggunakan opsi -c edge.
Upgrade semua node Server Pengelolaan di semua pusat data menggunakan opsi -c edge.
Upgrade semua node LDAP di semua pusat data. Jika Anda mengupgrade dari Edge for Private Cloud 4.53.00, Anda harus mengikuti langkah-langkah tambahan untuk langkah-langkah khusus upgrade LDAP
Upgrade UI dan Apigee SSO (jika diinstal) di semua pusat data:
1. Jika apigee-sso tidak diinstal: Ikuti Opsi 1: Upgrade UI (tanpa Apigee SSO) untuk mengupgrade ke UI Edge Baru.
2. Jika apigee-sso diinstal: Ikuti Opsi 2: Upgrade UI (dengan Apigee SSO) untuk mengupgrade ke UI Edge Baru dan Apigee SSO.
Upgrade semua komponen Qpid dan edge-qpid-server di semua pusat data dengan mengikuti langkah-langkah khusus Qpid.
Upgrade semua komponen Postgresql dan edge-postgres-server di semua pusat data dengan mengikuti langkah-langkah khusus Postgres
Upgrade semua komponen Zookeeper di semua pusat data dengan mengikuti langkah-langkah khusus upgrade Zookeeper.
Upgrade semua komponen Cassandra di semua pusat data dengan mengikuti langkah-langkah khusus upgrade Cassandra.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. Nilai ini diperbarui saat Anda menentukan opsi -c edge.

Upgrade mandiri 1 node

Untuk mengupgrade konfigurasi mandiri 1 node ke 4.54.00:

Saat mengupgrade dari Edge untuk Private Cloud 4.53.00, LDAP harus diupgrade terlebih dahulu dengan mengikuti Langkah-langkah untuk mengupgrade dari 4.53.00 ke 4.54.00 sebelum memulai upgrade semua komponen.

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

Perbarui komponen berikut untuk penginstalan mandiri 2 node:

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

Update komponen Edge di mesin 1:

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

Update LDAP di mesin 1:

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

Update UI Edge Baru di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Catatan: Jika apigee-sso diinstal, lihat Opsi 2: Mengupgrade UI (dengan Apigee SSO) untuk mengetahui petunjuk cara mengonfigurasinya ke Apigee SSO.

Update komponen Edge di mesin 2:

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

Update Qpid di Mesin 2:

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

Update Postgres di mesin 2:

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

Perbarui Cassandra dan ZooKeeper di mesin 1:

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

(Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di mesin 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Upgrade 5 node

Update komponen berikut untuk penginstalan 5 node:

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

Update komponen Edge di mesin 2, 3, 1:

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

Update LDAP di mesin 1:

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

Perbarui UI New Edge di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Catatan: Jika apigee-sso diinstal, lihat Opsi 2: Mengupgrade UI (dengan Apigee SSO) untuk mengetahui petunjuk cara mengonfigurasinya ke Apigee SSO.

Perbarui komponen Edge di mesin 4, 5:

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

Update Qpid di mesin 4, 5:

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

Perbarui Postgres di mesin 4, 5:

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

Perbarui Cassandra dan ZooKeeper di mesin 1, 2, dan 3:

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

(Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Upgrade cluster 9 node

Perbarui komponen berikut untuk penginstalan berkluster 9 node:

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

Update komponen Edge di mesin 4, 5, dan 1 (router, message-processor & management-server) dalam urutan tersebut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Perbarui LDAP di mesin 1:

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

Update UI Edge Baru di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Catatan: Jika apigee-sso diinstal, lihat Opsi 2: Upgrade UI (dengan Apigee SSO) untuk mengetahui petunjuk cara mengonfigurasinya ke Apigee SSO.
Perbarui komponen Edge di mesin 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

Update Postgres di mesin 8:

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

Update Postgres di mesin 9:

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

Perbarui Cassandra dan ZooKeeper di mesin 1, 2, dan 3:

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

(Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di komputer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Upgrade cluster 13 node

Update komponen berikut untuk penginstalan cluster 13 node:

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

Update komponen Edge di mesin 10, 11, 6, dan 7 dalam urutan berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Perbarui LDAP di mesin 4 dan 5:

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

Update UI Edge Baru di mesin 6, 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Catatan: Jika apigee-sso diinstal, lihat Opsi 2: Upgrade UI (dengan Apigee SSO) untuk mengetahui petunjuk cara mengonfigurasinya ke Apigee SSO.
Update komponen Edge di mesin 12, 13, 8, dan 9 dalam urutan tersebut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid di mesin 12 dan 13:

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

Update 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 Cassandra dan ZooKeeper di mesin 1, 2, dan 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -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
```

Upgrade cluster 12 node

Update komponen berikut untuk penginstalan cluster 12 node:

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

Mengupdate komponen Edge (Router & Message Processor):

Di mesin 2, 3 di Pusat Data 1:

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

Di mesin 8, 9 di Pusat Data 2:

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

Mengupdate komponen Edge (Server Pengelolaan):

Di mesin 1 di Pusat Data 1:

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

Di mesin 7 di Pusat Data 2:

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

Memperbarui 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 UI Edge Baru:
- Di mesin 1 di Pusat Data 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  Catatan: Jika apigee-sso diinstal, lihat Opsi 2: Upgrade UI (dengan Apigee SSO) untuk mengetahui petunjuk cara mengonfigurasinya ke Apigee SSO.
- Di mesin 7 di Pusat Data 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  Catatan: Jika apigee-sso diinstal, lihat Opsi 2: Mengupgrade UI (dengan Apigee SSO) untuk mengetahui petunjuk cara mengonfigurasinya ke Apigee SSO.

Mengupdate komponen Edge:

Mesin 4, 5, 6 di Pusat Data 1:

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

Mesin 10, 11, 12 di Pusat Data 2:

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

Update qpidd:

Mesin 4, 5 di Pusat Data 1:

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

Mesin 10, 11 di Pusat Data 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -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 Cassandra dan ZooKeeper:

Mesin 1, 2, dan 3 di Pusat data 1:

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

Di mesin 7, 8, dan 9 di Pusat Data 2:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -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

Untuk konfigurasi non-standar

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

Router
Message Processor
Server Pengelolaan
LDAP
UI (UI klasik atau UI Baru)
SSO (jika ada)
Qpid dan edge-qpid-server
Postgres dan edge-postgres-server
ZooKeeper
Cassandra
apigee-adminapi

Mengupdate Apigee Edge 4.53.00 atau 4.53.01 ke 4.54.00

Siapa yang dapat melakukan update

Komponen mana yang harus Anda perbarui

Materi bacaan awal

Prasyarat upgrade

Penyebaran otomatis setelan properti

Mengupgrade Router dan Message Processor

Mengupgrade Server Pengelolaan

Upgrade ke OpenLDAP 2.6.10

Persiapan dan penginstalan (Semua server LDAP)

Langkah-langkah untuk mengupgrade LDAP dari 4.53.00 ke 4.54.00

Prasyarat dan pertimbangan

Langkah-langkah untuk mengupgrade LDAP dari 4.53.01 ke 4.54.00

Mengupgrade ke UI Edge Baru dan Apigee SSO (Jika Diinstal)

Opsi 1: Upgrade UI (tanpa Apigee SSO)

Langkah 1: Mencadangkan file konfigurasi

Langkah 2: Perbarui file konfigurasi senyap untuk Autentikasi Dasar

Langkah 3: Upgrade komponen UI

Langkah 4: Verifikasi upgrade Edge UI Baru

Opsi 2: Upgrade UI (dengan Apigee SSO)

Langkah 1: Mencadangkan file konfigurasi

Langkah 2: Hapus variabel UI/SSO yang tidak digunakan lagi dan perbarui file konfigurasi senyap (configFile)

Langkah 3: Upgrade komponen UI Edge Baru

Langkah 4: Hentikan apigee-sso

Langkah 5: Buat database apigee_dex untuk Apigee SSO di node Postgres

Langkah 6: Siapkan Apigee SSO di node OpenLDAP

Langkah 7: Konfigurasi UI Pengelolaan untuk Apigee SSO dan mulai ulang UI

Langkah 8: Verifikasi upgrade UI Edge Baru dan Apigee SSO

Langkah 9: Uninstal apigee-sso lama

Upgrade ke Qpid 10.0.1

Upgrade ke Postgres 18.6

Menginstal node standby Postgres baru

Melakukan upgrade Postgres di tempat

Langkah awal

Melakukan upgrade di tempat

Menonaktifkan node Postgres

Langkah-langkah pasca-upgrade untuk Postgres

Mengupgrade ke ZooKeeper 3.8.5

Membuat cadangan

Mengidentifikasi pemimpin, pengikut, dan pengamat

Mengupgrade ZooKeeper di node observer dan pengikut

Mematikan leader

Memastikan leader baru terpilih

Upgrade pemimpin

Upgrade ke Cassandra 5.0.8

Upgrade dan rollback

Pusat data tunggal

Beberapa pusat data

Metodologi upgrade yang direkomendasikan

Proses checkpoint rollback

Contoh

Prasyarat untuk upgrade Cassandra

Langkah 1: Bersiap untuk upgrade

Langkah 2: Upgrade semua node Cassandra

Mengupdate dengan mTLS Apigee

Me-roll back update

Mencatat informasi update ke dalam log

Update tanpa periode nonaktif

Menggunakan file konfigurasi senyap

Update ke 4.54.00 di node dengan koneksi internet eksternal

Mengupdate ke 4.54.00 dari repositori lokal

Urutan update mesin

Upgrade mandiri 1 node

Upgrade mandiri 2 node

Upgrade 5 node

Upgrade cluster 9 node

Upgrade cluster 13 node

Upgrade cluster 12 node

Untuk konfigurasi non-standar

Langkah 2: Hapus variabel UI/SSO yang tidak digunakan lagi dan perbarui file konfigurasi senyap (`configFile`)

Langkah 4: Hentikan `apigee-sso`

Langkah 5: Buat database `apigee_dex` untuk Apigee SSO di node Postgres

Langkah 9: Uninstal `apigee-sso` lama