Jika mengalami error selama update ke Edge 4.19.06, Anda dapat melakukan rollback komponen yang menyebabkan error, lalu mencoba update lagi.
Anda dapat melakukan roll back Edge 4.19.06 ke versi Rilis Fitur berikut:
- Versi 4.19.01
- Versi 4.18.05
- Versi 4.18.01
Ada dua skenario yang mungkin perlu Anda lakukan untuk melakukan rollback:
- Melakukan roll back ke Rilis Fitur sebelumnya. Misalnya dari 4.19.06 hingga 4.18.05.
- Melakukan roll back ke versi update sebelumnya dalam rilis yang sama. Misalnya, dari 4.19.01.02 ke 4.19.01.01.
Untuk informasi selengkapnya, lihat Proses rilis Apigee Edge.
Siapa yang dapat melakukan rollback
Pengguna yang melakukan rollback harus sama dengan pengguna yang awalnya mengupdate Edge, atau pengguna yang berjalan sebagai root.
Secara default, komponen Edge berjalan sebagai pengguna "apigee". Dalam beberapa kasus, Anda mungkin menjalankan komponen Edge sebagai pengguna yang berbeda. Misalnya, jika Router harus mengakses port dengan hak istimewa, seperti port di bawah 1.000, Anda harus menjalankan Router sebagai root atau sebagai pengguna dengan akses ke port tersebut. Atau, Anda dapat menjalankan satu komponen sebagai satu pengguna, dan komponen lain sebagai pengguna lain.
Komponen dengan kode umum
Komponen Edge berikut memiliki kode yang sama. Oleh karena itu, untuk melakukan rollback salah satu komponen ini di node, Anda harus melakukan rollback semua komponen ini yang ada di node tersebut.
edge-management-server
(Server Pengelolaan)edge-message-processor
(Message Processor)edge-router
(Router)edge-postgres-server
(Server Postgres)edge-qpid-server
(Server Qpid)
Misalnya, jika Anda menginstal Server Pengelolaan, Router, dan Pemroses Pesan di node, untuk melakukan rollback salah satunya, Anda harus melakukan rollback ketiganya.
Roll back ke Rilis Fitur sebelumnya
Untuk melakukan roll back ke Rilis Fitur sebelumnya, lakukan hal berikut pada setiap node yang menghosting komponen:
-
Download file
bootstrap.sh
untuk versi yang ingin Anda roll back:- Untuk melakukan roll back ke 4.19.01, download
bootstrap_4.19.01.sh
:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Untuk melakukan roll back ke 4.18.05, download
bootstrap_4.18.05.sh
:curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- Untuk melakukan rollback ke 4.18.01, download
bootstrap_4.18.01.sh
:curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
- Untuk melakukan roll back ke 4.19.01, download
- Hentikan komponen untuk melakukan rollback:
- Untuk melakukan rollback pada komponen dengan kode umum di node, Anda harus menghentikan semuanya, seperti yang ditunjukkan pada contoh berikut:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- Untuk mengembalikan komponen lain di node, hentikan komponen tersebut saja:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Untuk melakukan rollback pada komponen dengan kode umum di node, Anda harus menghentikan semuanya, seperti yang ditunjukkan pada contoh berikut:
- Jika Anda ingin mengembalikan Monetisasi, uninstal dari semua node Server Pengelolaan dan Message Processor:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- Uninstal komponen untuk melakukan rollback di node:
- Untuk me-roll back salah satu komponen dengan kode umum pada node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen
edge-gateway
, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- Untuk melakukan rollback komponen lain di node, cukup uninstal komponen tersebut, seperti yang ditunjukkan dalam contoh berikut:
/opt/apigee/apigee-service/bin/apigee-service component uninstall
Dengan component adalah nama komponennya.
- Untuk melakukan rollback Edge Router, Anda harus menghapus konten file
/opt/nginx/conf.d
selain meng-uninstal grup komponenedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- Untuk me-roll back salah satu komponen dengan kode umum pada node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen
- Uninstal
apigee-setup
versi 4.19.06:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- Instal utilitas
apigee-service
versi 4.19.01, 4.18.05, atau 4.18.01 dan dependensinya. Contoh berikut menginstalapigee-service
versi 4.18.01:sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
Dengan uName dan pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
Jika Anda mendapatkan error, pastikan Anda mendownload file
bootstrap.sh
di langkah 1. - Instal
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Instal komponen versi lama:
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
Dengan component adalah komponen yang akan diinstal dan configFile adalah file konfigurasi Anda untuk versi yang lebih lama.
- Jika Anda melakukan rollback Qpid, hapus iptables:
sudo iptables -F
- Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda rollback.
Melakukan roll back ke versi update sebelumnya
Untuk melakukan roll back komponen ke versi rilis tertentu, lakukan hal berikut di setiap node yang menghosting komponen:
- Download versi komponen tertentu:
/opt/apigee/apigee-service/bin/apigee-service component_version install
Dengan component_version adalah komponen dan versi update yang akan diinstal. Contoh:
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-0.0.3749 install
Jika menggunakan repo online Apigee, Anda dapat menentukan versi komponen yang tersedia menggunakan perintah berikut:
yum --showduplicates list comp
Contoh:
yum --showduplicates list edge-ui
- Gunakan
apigee-setup
untuk menginstal komponen:/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
Contoh:
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
Perhatikan bahwa Anda hanya menentukan nama komponen saat menginstalnya, bukan versinya.
- Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda rollback.