Edge untuk Private Cloud v4.19.01
Bagian ini menjelaskan cara melakukan upgrade berikut:
- Dari 4.17.09 hingga 4.19.01
Siapa yang dapat melakukan update
Pengguna yang menjalankan update harus sama dengan pengguna yang awalnya menginstal Edge, atau pengguna yang menjalankan root.
Setelah Anda menginstal RPM Edge, setiap pengguna dapat mengonfigurasinya.
Komponen mana yang harus Anda update
Anda harus mengupdate semua komponen Edge. Edge tidak mendukung penyiapan yang berisi komponen dari beberapa versi.
Mempertahankan kompatibilitas
Saat mengupgrade Apigee Edge untuk Private Cloud ke 4.19.01, Anda harus memastikan bahwa implementasi yang dihasilkan hanya mereferensikan properti yang didukung dalam file konfigurasinya.
Properti | Lokasi | Deskripsi |
---|---|---|
conf_load_balancing_load.balancing. |
router.properties |
Hapus properti ini dari file router.properties Anda. Untuk menetapkan opsi coba lagi di
4.19.01, gunakan properti
konfigurasi host virtual. |
Penerapan otomatis setelan properti
Jika Anda telah menetapkan properti dengan mengedit file .properties
di /opt/apigee/customer/application
, nilai ini akan dipertahankan oleh pembaruan.
Upgrade yang diperlukan ke Postgres 9.6
Rilis Edge ini mencakup upgrade ke Postgres 9.6. Sebagai bagian dari upgrade tersebut, semua data Postgres dimigrasikan ke Postgres 9.6.
Sebagian besar sistem produksi Edge menggunakan dua node Postgres yang dikonfigurasi untuk replikasi master-standby. Selama proses update, saat node Postgres tidak aktif untuk update, data analisis tetap ditulis ke node Qpid. Setelah node Postgres diperbarui dan kembali online, data analisis kemudian dikirim ke node Postgres.
Cara melakukan update Postgres bergantung pada cara Anda mengonfigurasi penyimpanan data untuk node Postgres:
- Jika menggunakan penyimpanan data lokal untuk node Postgres, Anda harus menginstal node standby Postgres baru selama upgrade. Setelah upgrade selesai, Anda dapat menonaktifkan node standby Postgres yang baru.
Node standby Postgres tambahan diperlukan jika Anda harus me-roll back update karena alasan apa pun. Jika Anda harus me-roll back update, node standby Postgres baru akan menjadi node Postgres master setelah rollback. Oleh karena itu, saat diinstal, node standby Postgres baru harus berada di node yang memenuhi semua persyaratan hardware server Postgres, seperti yang ditetapkan 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 menggunakan penyimpanan jaringan untuk node Postgres, seperti yang direkomendasikan oleh Apigee, Anda tidak perlu menginstal node Postgres baru. Dalam prosedur di bawah ini, Anda dapat melewati langkah-langkah yang menentukan penginstalan dan penonaktifan node standby Postgres yang baru di lain waktu.
Sebelum memulai proses update, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Kemudian, jika terjadi error selama update dan Anda dipaksa untuk melakukan roll back, Anda dapat memulihkan node Postgres dari snapshot tersebut.
Menginstal node standby Postgres baru
Prosedur ini membuat server standby Postgres pada node baru. Pastikan Anda menginstal server standby Postgres baru untuk Edge versi yang sudah ada (4.17.09), bukan untuk versi 4.19.01.
Untuk melakukan penginstalan, gunakan file konfigurasi yang sama dengan yang Anda gunakan untuk menginstal Edge versi saat ini.
Untuk membuat node standby Postgres baru:
- Di master Postgres saat ini, edit file
/opt/apigee/customer/application/postgresql.properties
untuk menetapkan token berikut. Jika file tersebut tidak ada, buat file tersebut: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 master Postgres:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Pastikan node standby baru telah ditambahkan dengan melihat
file
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
di master. Anda akan melihat baris berikut di file tersebut:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Instal server standby Postgres yang baru:
- Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini untuk menentukan hal berikut:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
- Download file Edge bootstrap_4.17.09.sh ke
/tmp/bootstrap_4.17.09.sh
:curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Instal utilitas dan dependensi Edge
apigee-service
:sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
- Gunakan
apigee-service
untuk menginstal utilitasapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Instal Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- Pada node standby yang baru, jalankan perintah berikut:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Pastikan bahwa pesan tersebut adalah standby.
- Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini untuk menentukan hal berikut:
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 yang baru dengan menjalankan perintah
curl
berikut pada node standby yang 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 yang baru:
/opt/apigee/apigee-service/bin/apigee-all stop
- Pada node master Postgres, edit
/opt/apigee/customer/application/postgresql.properties
untuk menghapus node standby baru dariconf_pg_hba_replication.connection
:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- Mulai ulang apigee-postgresql pada master Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Pastikan node standby baru telah dihapus dengan melihat
file
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
di master. 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 di node Management Server:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Perbarui prasyarat
Perhatikan prasyarat berikut sebelum mengupgrade Apigee Edge:
- Cadangkan semua node
Sebelum Anda melakukan update, sebaiknya lakukan pencadangan menyeluruh pada semua node untuk alasan keamanan. Gunakan prosedur untuk versi Edge saat ini guna melakukan pencadangan.Tindakan ini memungkinkan Anda memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
- Pastikan Edge berjalan
Pastikan Edge aktif dan berjalan selama proses update dengan menggunakan perintah:/opt/apigee/apigee-service/bin/apigee-all status
Menangani update yang gagal
Jika terjadi kegagalan update, Anda dapat mencoba memperbaiki masalahnya, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali untuk melanjutkan update dari bagian terakhir yang ditinggalkan.
Jika kegagalan tersebut mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Roll back 4.19.01 untuk mengetahui info selengkapnya.
Mencatat informasi update
Secara default, utilitas update.sh
menulis informasi log untuk:
/opt/apigee/var/log/apigee-setup/update.log
Jika pengguna yang menjalankan utilitas update.sh
tidak memiliki akses ke
direktori tersebut, ia akan menulis log ke direktori /tmp
sebagai file bernama
update_username.log
.
Jika pengguna tidak memiliki akses ke /tmp
, utilitas update.sh
akan gagal.
Update tanpa periode nonaktif
Update zero-down, atau update berkelanjutan, memungkinkan Anda mengupdate konfigurasi Edge tanpa menurunkan Edge.
Update zero-time hanya dapat dilakukan dengan konfigurasi 5 node dan lebih besar.
Kunci untuk mengupgrade tanpa periode nonaktif adalah dengan menghapus setiap Router, satu per satu, dari load balancer. Kemudian, Anda dapat mengupdate Router dan komponen lain di mesin yang sama dengan Router, lalu menambahkan Router kembali ke load balancer.
- Perbarui mesin dalam urutan yang benar untuk konfigurasi Anda seperti yang dijelaskan di Urutan update mesin.
- Jika sudah waktunya untuk mengupdate Router, pilih satu Router dan buat Router tidak dapat dijangkau, seperti dijelaskan dalam Mengaktifkan/Menonaktifkan Keterjangkauan Server (Pemroses Pesan/Router).
- Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan pada node yang sama.
- Membuat Router dapat dijangkau lagi.
- Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
- Lanjutkan update untuk komputer lainnya dalam konfigurasi Anda.
Perhatikan hal berikut sebelum/setelah update:
- Pada gabungan node Router dan Message Processor:
- Sebelum update – lakukan tindakan berikut:
- Membuat Router tidak dapat dijangkau.
- Membuat Pemroses Pesan tidak dapat dijangkau.
- Setelah update - lakukan tindakan berikut:
- Membuat Pemroses Pesan dapat dijangkau.
- Buat Router dapat dijangkau.
- Sebelum update – lakukan tindakan berikut:
- Pada node Router tunggal:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
- Pada node Message Processor tunggal:
- 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.17.09.
Update ke 4.19.01 pada node dengan koneksi internet eksternal
Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:
- Jika saat ini Anda menggunakan replikasi master-stand Postgres dengan penyimpanan lokal, instal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Jika ada, nonaktifkan semua tugas CRON yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga update selesai.
- Login ke node Anda sebagai root untuk menginstal RPM Edge.
- Instal
yum-utils
danyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
- Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
sudo yum-config-manager --enable ol7_optional_latest
- Jika Anda menginstal aplikasi 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
- Download file
bootstrap_4.19.01.sh
Edge 4.19.01 ke/tmp/bootstrap_4.19.01.sh
:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Instal utilitas dan dependensi
apigee-service
Edge 4.19.01:sudo bash /tmp/bootstrap_4.19.01.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 memeriksa untuk melihat bahwa Anda telah menginstal Java 1.8. Jika tidak, aplikasi akan diinstal untuk Anda. Gunakan opsi
JAVA_FIX
untuk menentukan cara menangani penginstalan Java.JAVA_FIX
menggunakan nilai berikut:- I = Instal OpenJDK 1.8 (default)
- C = Melanjutkan tanpa menginstal Java
- Q = Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
- Gunakan
apigee-service
untuk mengupdate utilitasapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas update pada node Anda sesuai urutan yang dijelaskan di Urutan update mesin:
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dapat dibaca oleh pengguna "apigee".
Gunakan opsi
-c
untuk menentukan komponen yang akan diupdate. Daftar kemungkinan komponen mencakup:- "cs" = Cassandra
- "edge" =Semua komponen Edge kecuali UI Edge. Komponen "edge" mencakup Server Pengelolaan, Prosesor Pesan, Router, Server QPID, Server Edge Postgres.
- "ldap" = OpenLDAP
- "ps" = postgresql
- "qpid" = qpidd
- "sso" = SSO Edge
- "ui" = UI Edge
- "zk" = Penjaga kebun binatang
Anda dapat menjalankan
update.sh
terhadap semua komponen dengan menetapkan component ke "all", tetapi hanya jika Anda memiliki profil konfigurasi all-in-one (AIO) Edge. Contoh:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- Mulai ulang komponen UI Edge pada semua mesin yang menjalankannya, jika Anda belum melakukannya:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Uji update dengan menjalankan utilitas
apigee-validate
di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan. - Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan dalam Menonaktifkan node Postgres.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
Untuk me-roll back update nanti, gunakan prosedur yang dijelaskan dalam Roll back 4.19.01.
Mengupdate ke 4.19.01 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 pencerminan, repo Apigee.
Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk mengupdate Edge dari repo lokal:
- Buat file .tar untuk repo, 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 Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.
Untuk mengupdate dari repo lokal 4.19.01:
- Jika saat ini Anda menggunakan replikasi master-standby Postgres, instal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Buat repo 4.19.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan Edge apigee.
- Untuk menginstal apigee-service dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar dengan nama
/opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori
/tmp
pada node baru. - Pada node baru, untar file ke direktori /tmp:
tar -xzf apigee-4.19.01tar.gz
Perintah ini membuat direktori baru, yang bernama repo, di direktori yang berisi file .tar. Misalnya, /tmp/repo.
- Instal utilitas dan dependensi layanan Edge apigee dari /tmp/repos:
sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Perhatikan bahwa Anda menyertakan jalur ke direktori repositori dalam perintah ini.
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar dengan nama
- Untuk menginstal layanan apigee menggunakan server web Nginx:
- Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Instal dari repo menggunakan server web
Nginx" pada Menginstal utilitas
apigee-setup
Edge. - Pada node jarak jauh, download file Edge
bootstrap_4.19.01.sh
ke/tmp/bootstrap_4.19.01.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.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.
- Pada node jarak jauh, instal utilitas dan dependensi
apigee-service
Edge:sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dengan uName:pWord adalah nama pengguna dan sandi repo.
- Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Instal dari repo menggunakan server web
Nginx" pada Menginstal utilitas
- Gunakan
apigee-service
untuk mengupdate utilitasapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
update
pada node Anda sesuai urutan yang dijelaskan di Urutan update mesin:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dapat dibaca oleh pengguna "apigee".
Gunakan opsi
-c
untuk menentukan komponen yang akan diupdate. Daftar kemungkinan komponen mencakup:- "cs" = Cassandra
- "edge" =Semua komponen Edge kecuali UI Edge. Komponen "edge" mencakup Server Pengelolaan, Prosesor Pesan, Router, Server QPID, Server Edge Postgres.
- "ldap" = OpenLDAP
- "ps" = postgresql
- "qpid" = qpidd
- "sso" = SSO Edge
- "ui" = UI Edge
- "zk" = Penjaga kebun binatang
Anda dapat menjalankan
update.sh
terhadap semua komponen dengan menetapkan component ke "all", tetapi hanya jika Anda memiliki profil konfigurasi all-in-one (AIO) Edge. Contoh:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- Mulai ulang komponen UI Edge pada semua mesin yang menjalankannya, jika Anda belum melakukannya:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Uji update dengan menjalankan utilitas
apigee-validate
di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan. - Jika Anda menginstal node standby Postgres baru, hentikan node tersebut seperti yang dijelaskan dalam Menonaktifkan node Postgres.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
Untuk me-roll back update nanti, gunakan prosedur yang dijelaskan dalam Melakukan roll back 4.19.01.
Urutan update mesin
Urutan Anda memperbarui mesin dalam konfigurasi Edge sangatlah penting. Pertimbangan yang paling penting untuk update adalah:
- Anda harus memperbarui semua node Cassandra dan ZooKeeper sebelum memperbarui node lainnya.
- Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Prosesor Pesan, Router, Server QPID, tetapi tidak Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
- Jika sebuah langkah menentukan bahwa tindakan tersebut harus dilakukan pada beberapa mesin, jalankan sesuai urutan mesin yang ditentukan.
- Tidak ada langkah terpisah untuk memperbarui Monetisasi. Ini diupdate saat Anda menentukan opsi "-c edge".
Upgrade mandiri 1 node
- Update Cassandra dan ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Perbarui LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Menghentikan Server Postgres, server Qpid, dan PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Mengupdate postgresql:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update komponen Edge yang tersisa:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate UI Edge:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Memperbarui utilitasapigee-adminapi
:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Edge) Update SSO Edge:
/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:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade mandiri 2 node
Lihat Topologi penginstalan untuk mengetahui daftar topologi dan nomor node Edge.
- Update Cassandra dan ZooKeeper di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Mengupdate Qpid di komputer 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mengupdate LDAP di perangkat 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge pada mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate UI pada mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Memperbarui utilitasapigee-adminapi
di mesin 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Edge) Update SSO Edge 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.
- Update postgresql di mesin 2:
- Menghentikan Server Postgres, server Qpid, dan postgresql:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Mengupdate postgresql:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui komponen Edge di mesin 2:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Menghentikan Server Postgres, server Qpid, dan postgresql:
- Mulai ulang komponen UI Edge pada mesin 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade 5 node
Lihat Topologi penginstalan untuk mengetahui daftar topologi dan nomor node Edge.
- Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Qpid di mesin 4 dan 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mengupdate LDAP di perangkat 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge pada mesin 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate UI pada mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Memperbarui utilitasapigee-adminapi
di mesin 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Edge) Update SSO Edge 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.
- Update komputer 4 dan 5:
- Hentikan server Postgres dan server Qpid di komputer 4:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- Hentikan server Postgres, server Qpid, dan postgresql di mesin 5:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Jika diinstal, hentikan server Postgres dan postgresql pada node standby baru yang Anda tambahkan untuk rollback:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Mengupdate postgresql pada mesin 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate postgresql pada mesin 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mulai server Postgres dan server Qpid pada komputer 4 dan 5:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 5:
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Verifikasi status replikasi dengan mengeluarkan skrip berikut di kedua server. Sistem
akan menampilkan hasil yang sama di kedua server untuk memastikan replikasi yang berhasil:
- Pada mesin 4, node master, jalankan:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Pastikan bahwa kata tersebut adalah master.
- Pada perangkat 5, node standby:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Pastikan bahwa pesan tersebut adalah standby.
- Pada mesin 4, node master, jalankan:
- Hentikan server Postgres dan server Qpid di komputer 4:
- Update komponen Edge di mesin 4, 5:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Mulai ulang komponen UI Edge pada mesin 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade dengan cluster 9 node
Lihat Topologi penginstalan untuk mengetahui daftar topologi dan nomor node Edge.
- Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Qpid di mesin 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mengupdate LDAP di perangkat 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge pada mesin 6, 7, 1, 4, dan 5 secara berurutan:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate UI pada mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Memperbarui utilitasapigee-adminapi
di mesin 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Edge) Update SSO Edge 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.
- Update mesin 8 dan 9:
- Hentikan server Postgres di komputer 8:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- Hentikan server Postgres dan postgresql di mesin 9:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Hentikan server Qpid di komputer 6 dan 7:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- Jika diinstal, hentikan server Postgres dan postgresql pada node standby baru yang Anda tambahkan untuk rollback:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Mengupdate postgresql pada mesin 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate postgresql pada mesin 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mulai server server Postgres pada komputer 8 dan 9:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- Mulai server server Qpid pada komputer 6 dan 7:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 9:
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Verifikasi status replikasi dengan mengeluarkan skrip berikut di kedua server. Sistem
akan menampilkan hasil yang sama di kedua server untuk memastikan replikasi yang berhasil:
- Pada mesin 8, node master, jalankan:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Pastikan bahwa kata tersebut adalah master.
- Pada perangkat 9, node standby:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Pastikan bahwa pesan tersebut adalah standby.
- Pada mesin 8, node master, jalankan:
- Hentikan server Postgres di komputer 8:
- Update komponen Edge di mesin 8 dan 9:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Mulai ulang komponen UI Edge pada mesin 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade dengan 13 node dalam cluster
Lihat Topologi penginstalan untuk mengetahui daftar topologi dan nomor node Edge.
- Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Qpid di mesin 12 dan 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update LDAP di perangkat 4 dan 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge pada mesin 12, 13, 6, 7, 10, dan 11 secara berurutan:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate UI pada mesin 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Mengupdate utilitasapigee-adminapi
di mesin 6 dan 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Edge) Update SSO Edge 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.
- Update mesin 8 dan 9:
- Hentikan server Postgres di komputer 8:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- Hentikan server Postgres dan postgresql di mesin 9:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Hentikan server Qpid di komputer 12 dan 13:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- Jika diinstal, hentikan server Postgres dan postgresql pada node standby baru yang Anda tambahkan untuk rollback:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Mengupdate postgresql pada mesin 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate postgresql pada mesin 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mulai server Postgres pada komputer 8 dan 9:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- Mulai server server Qpid pada komputer 12 dan 13:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 9:
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Verifikasi status replikasi dengan mengeluarkan skrip berikut di kedua server. Sistem
akan menampilkan hasil yang sama di kedua server untuk memastikan replikasi yang berhasil:
- Pada mesin 8, node master, jalankan:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Pastikan bahwa kata tersebut adalah master.
- Pada perangkat 9, node standby:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Pastikan bahwa pesan tersebut adalah standby.
- Pada mesin 8, node master, jalankan:
- Hentikan server Postgres di komputer 8:
- Update komponen Edge di mesin 8 dan 9:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Mulai ulang komponen UI Edge pada komputer 6 dan 7:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade dengan 12 node dalam cluster
Lihat Topologi penginstalan untuk mengetahui daftar topologi dan nomor node Edge.
- Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Perbarui Cassandra dan ZooKeeper:
- Pada mesin 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
- Pada mesin 1, 2, dan 3 di Pusat Data 1:
- Update qpidd:
- Mesin 4, 5 di Pusat Data 1
- Update
qpidd
di mesin 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Ulangi langkah 1 pada mesin 5.
- Update
- Mesin 10, 11 di Pusat Data 2
- Update
qpidd
pada komputer 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Ulangi langkah 1 pada mesin 11.
- Update
- Mesin 4, 5 di Pusat Data 1
- Perbarui LDAP:
- Komputer 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
- Komputer 1 di Pusat Data 1
- Update komponen Edge:
- Mesin 4, 5, 1, 2, 3 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 10, 11, 7, 8, 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 4, 5, 1, 2, 3 di Pusat Data 1
- Update UI:
- Mesin 1 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Mesin 7 di Pusat Data 2:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Mesin 1 di Pusat Data 1:
- (Jika Anda menginstal
apigee-adminapi
) Mengupdate utilitasapigee-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
- Mesin 1 di Pusat Data 1:
- (Jika Anda menginstal SSO Edge) Update SSO Edge:
- Mesin 1 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Mesin 7 di Pusat Data 2:
/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.
- Mesin 1 di Pusat Data 1:
- Update mesin 6 di Pusat Data 1 dan 12 di Pusat Data 2:
- Hentikan server Postgres di komputer 6:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- Hentikan server Postgres dan postgresql di mesin 12:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Hentikan server Qpid di komputer 4, 5, 10, dan 11:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- Jika diinstal, hentikan server Postgres dan postgresql pada node standby baru yang Anda tambahkan untuk rollback:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Mengupdate postgresql pada mesin 6:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate postgresql pada mesin 12:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mulai server server Postgres pada komputer 6 dan 12:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- Mulai server server Qpid pada komputer 4, 5, 10, dan 11:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 12:
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Verifikasi status replikasi dengan mengeluarkan skrip berikut di kedua server. Sistem
akan menampilkan hasil yang sama pada kedua server untuk memastikan
replikasi yang berhasil:
Pada mesin 6, node master, jalankan:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Pastikan bahwa kata tersebut adalah master.
Pada perangkat 12, node standby:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Pastikan bahwa pesan tersebut adalah standby.
- Hentikan server Postgres di komputer 6:
- Update komponen Edge pada mesin 6 dan 12:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.
Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.
- Mulai ulang komponen UI Edge pada mesin 1 dan 7:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Untuk upgrade non-standar
Jika Anda memiliki konfigurasi non-standar, update komponen Edge dengan urutan berikut:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, yang berarti profil "-c edge" pada semua node secara berurutan: node dengan server Qpid, Server Edge Postgres, Server Pengelolaan, Prosesor Pesan, dan Router.
- UI Edge
apigee-adminapi
- SSO Edge
Setelah selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua mesin yang menjalankannya.