Apigee mendukung upgrade Edge for Private Cloud dari versi 4.51.00 atau versi 4.52.00 langsung ke versi 4.52.01. Halaman ini menjelaskan cara melakukan salah satu upgrade.
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 update
Anda harus mengupdate semua komponen Edge. Edge tidak mendukung penyiapan yang berisi komponen dari beberapa versi.
Prasyarat update
Pastikan prasyarat berikut terpenuhi sebelum mengupgrade Apigee Edge:
- Cadangkan 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.
- Memastikan Edge berjalan
Pastikan Edge aktif dan berjalan selama proses update menggunakan perintah:/opt/apigee/apigee-service/bin/apigee-all status
- Pastikan Strategi Kompatifikasi Cassandra adalah
LeveledCompactionStrategy
Pastikan strategi kompatifikasi Cassandra ditetapkan keLeveledCompactionStrategy, seperti yang dijelaskan dalam Mengubah strategi pemadatan Cassandra.
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.
Upgrade yang diperlukan ke Zookeeper 3.8.3
Rilis Edge for Private Cloud ini mencakup upgrade ke Zookeeper 3.8.3. Sebagai bagian dari upgrade tersebut, semua data Zookeeper akan dimigrasikan ke Zookeeper 3.8.3.
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 ke 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. Seharusnya tidak ada dampak pada API runtime Apigee (kecuali jika API runtime ini memanggil API pengelolaan) selama upgrade Zookeeper saat mengikuti prosedur di bawah.
Secara umum, proses upgrade melibatkan pencadangan setiap node. Tindakan ini diikuti dengan mengupgrade semua observer dan follower, lalu mengupgrade node leader.
Membuat cadangan
Buat cadangan semua node ZooKeeper untuk digunakan jika diperlukan rollback. Perlu diperhatikan bahwa rollback akan memulihkan Zookeeper ke status saat pencadangan dilakukan. Catatan: Setiap deployment atau perubahan infrastruktur di Apigee sejak pencadangan dilakukan (yang informasinya disimpan di Zookeeper) akan hilang selama pemulihan.
/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 diperlukan).
Mengidentifikasi pemimpin, pengikut, dan pengamat
Catatan: Contoh perintah di bawah menggunakan utilitas nc untuk mengirim data ke Zookeeper. Anda juga dapat menggunakan utilitas alternatif untuk mengirim data ke Zookeeper.
- Jika belum diinstal di node ZooKeeper, instal nc:
sudo yum install nc
- Jalankan perintah nc berikut pada node, dengan 2181 sebagai port ZooKeeper:
echo stat | nc localhost 2181
Anda akan melihat output seperti berikut:
Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC Clients: /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0.2518/41 Received: 647228 Sent: 647339 Connections: 4 Outstanding: 0 Zxid: 0x400018b15 Mode: follower Node count: 100597
Di baris
Modepada output untuk node, Anda akan melihat observer, leader, atau follower (artinya pemilih yang bukan leader) bergantung pada konfigurasi node. Catatan: Dalam penginstalan mandiri Edge dengan satu node ZooKeeper,Modedisetel ke mandiri. - Ulangi langkah 1 dan 2 pada setiap node ZooKeeper.
Mengupgrade Zookeeper di node observer dan follower
Upgrade Zookeeper di setiap node observer dan follower sebagai berikut:
- Download dan jalankan bootstrap Edge for Private Cloud 4.52, seperti yang dijelaskan dalam Update ke 4.52.01 di node dengan koneksi internet eksternal. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda melakukan penginstalan offline.
- Upgrade komponen Zookeeper:
Catatan: Jika node ini memiliki komponen lain yang diinstal (seperti Cassandra), Anda juga dapat mengupgradenya sekarang (seperti dengan profil cs,zk) atau Anda dapat mengupgrade komponen lainnya nanti. Apigee merekomendasikan agar Anda mengupgrade Zookeeper terlebih dahulu dan memastikan cluster Anda berfungsi dengan baik sebelum mengupgrade komponen lainnya./opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
- Ulangi langkah-langkah di atas pada setiap node observer dan follower Zookeeper.
Mematikan leader
Setelah semua node observer dan follower diupgrade, matikan leader. Pada node yang diidentifikasi sebagai leader, 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 sesaat 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 leader
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.
Rollback
Jika rollback diperlukan:
- Lakukan langkah-langkah rollback pada observer dan follower terlebih dahulu.
- Download dan jalankan bootstrap versi yang akan Anda gunakan untuk melakukan roll back, baik 4.50 maupun 4.51. Prosesnya mungkin akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda mengikuti penginstalan offline.
- Hentikan Zookeeper jika sedang berjalan di node:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- Uninstal zookeeper yang ada:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
- Instal Zookeeper seperti biasa:
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
- Setelah semua pengikut dan pengamat di-roll back, lakukan roll back pada node pemimpin dengan mengikuti langkah 2 hingga 5 pada node pemimpin.
- Setelah semua node di-roll back, verifikasi kondisi cluster dan pastikan ada node leader di cluster.
Memulihkan cadangan
Lihat Memulihkan dari cadangan. Perhatikan bahwa cadangan Zookeeper yang diambil dari versi Edge for Private Cloud yang lebih lama seperti 4.50 dan 4.51 harus kompatibel dengan versi Zookeeper di Edge for Private Cloud 4.52.
Upgrade yang diperlukan ke Postgres 14
Rilis Edge for Private Cloud ini mencakup upgrade ke Postgres 14. Sebagai bagian dari upgrade ini, semua data Postgres dimigrasikan ke Postgres 14.
- Jika Anda mengupgrade dari Edge for Private Cloud 4.51.00 ke 4.52.01, Anda harus mengikuti langkah-langkah upgrade Postgres tambahan. Lihat bagian Upgrade yang diperlukan ke Postgres 14 jika Anda mengupgrade dari versi 4.51.00 ke 4.52.01.
- Jika Anda mengupgrade dari Edge for Private Cloud 4.52.00 ke 4.52.01, langkah-langkah upgrade Postgres tambahan tidak diperlukan.
Mengupgrade Qpid
Rilis Edge for Private Cloud ini mencakup upgrade ke Qpid J-Broker.
Sebaiknya pilih salah satu metode berikut untuk melakukan upgrade Qpid:
Upgrade langsung tanpa periode nonaktif
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 DROP 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 mengosongkan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Pastikan antrean yang ada kosong:
qpid-stat -q
Jika pesan macet di antrean pesan yang tidak terkirim (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), kosongkan antrean menggunakan langkah-langkah untuk menyelesaikan data analisis yang macet di antrean pesan yang tidak terkirim.
- Setelah memverifikasi bahwa antrean telah dikosongkan pada node lama, hentikan
apigee-qpidd:apigee-service apigee-qpidd stop
- Upgrade Qpid pada 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
iptablesuntuk 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.
Menugaskan node Qpid baru
Metode ini menyiapkan dan menginstal apigee-qpidd dan edge-qpid-server pada
node baru.
- Tambahkan node Qpid baru. Langkah ini menyiapkan node Qpid dengan J-broker. Untuk mengetahui langkah-langkah mendetail, lihat Menambahkan server Qpid.
- Pilih node Qpid yang ada (node dari versi yang Anda upgrade).
- 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 DROP 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 mengosongkan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Periksa untuk memastikan antrean yang ada kosong:
qpid-stat -q
Jika pesan macet di antrean pesan yang tidak terkirim (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), kosongkan antrean dengan mengikuti langkah-langkah dalam topik pemecahan masalah Data analisis macet di antrean pesan yang tidak terkirim Qpidd.
- Setelah memverifikasi bahwa antrean telah dikosongkan di node lama, hentikan
apigee-qpiddapigee-service apigee-qpidd stop
- Batalkan pendaftaran node Qpid lama dengan mengikuti langkah-langkah di Menghapus server Qpid.
- Terus tambahkan node baru dan hapus node lama, satu per satu, hingga semua node Qpid telah diupgrade.
Rollback
Untuk melakukan roll back ke Rilis Fitur sebelumnya, pastikan untuk mendownload file bootstrap.sh untuk
versi yang ingin Anda gunakan untuk roll back. Untuk melakukan roll back ke v 4.52.00, download bootstrap_4.52.00.sh.
Untuk melakukan roll back Qpid, ikuti langkah-langkah berikut di semua host Qpid:
- Menghentikan broker Qpid yang ada
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 DROP 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 mengosongkan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Pastikan antrean yang ada kosong. Untuk memeriksanya, login ke portal pengelolaan Qpid:
Catatan: Jika port 8090 di node QPID ini tidak dapat diakses, Anda dapat menggunakan mekanisme alternatif seperti penerusan port SSH untuk mengakses URL ini.http://QPID_NODE_IP:8090
- Setelah memastikan antrean telah dikosongkan, hentikan dan uninstal Qpid:
apigee-service apigee-apidd uninstall
- Hapus direktori data Qpid:
rm -r APIGEE_ROOT/data/apigee-qpidd
- Instal ulang broker Qpid:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Setelah broker Qpid diinstal ulang, hapus setelan firewall dan cantumkan setelan yang ada menggunakan perintah berikut:
iptables -F
iptables -L
UI Edge Baru
Bagian ini mencantumkan pertimbangan terkait Edge UI. Untuk mengetahui informasi selengkapnya, lihat UI Edge baru untuk cloud pribadi.
Menginstal UI Edge
Setelah menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal UI Edge, yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge untuk Private Cloud.
Perhatikan bahwa Edge UI mengharuskan Anda menonaktifkan autentikasi Dasar dan menggunakan IDP seperti SAML atau LDAP.
Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.
Mengupdate Edge UI
Untuk mengupdate komponen UI Edge, pertimbangkan versi Edge untuk cloud pribadi yang Anda upgrade:
- Dari 4.51.00 ke 4.52.00 (dengan UI Edge baru yang sudah diinstal): Gunakan
petunjuk upgrade di bagian ini untuk
komponen
edge-management-ui.
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 ditinggalkan.
Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.52.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 menonaktifkan 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.
- Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan dalam Urutan update mesin.
- Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat 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.
Perhatikan hal-hal berikut sebelum dan setelah update:
- Pada node Router dan Message Processor gabungan:
- Sebelum update – lakukan hal berikut:
- Membuat Router tidak dapat dijangkau.
- Membuat Message Processor tidak dapat dijangkau.
- Setelah update – lakukan hal berikut:
- Buat Message Processor dapat dijangkau.
- Buat Router dapat dijangkau.
- Sebelum update – lakukan hal berikut:
- Pada node Router tunggal:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
- Pada node Message Processor tunggal:
- Sebelum melakukan update, buat Message Processor tidak dapat dijangkau.
- Setelah update, buat Message Processor dapat dijangkau.
Menggunakan file konfigurasi senyap
Anda harus meneruskan file konfigurasi senyap ke perintah update. File konfigurasi senyap harus sama dengan yang Anda gunakan untuk menginstal Edge 4.50.00 atau 4.51.00.
Mengupdate ke 4.52.01 pada node dengan koneksi internet eksternal
Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:
- Jika ada, nonaktifkan tugas
cronyang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga setelah update selesai. - Login ke node Anda sebagai root untuk menginstal RPM Edge.
- Instal
yum-utilsdanyum-plugin-priorities:sudo yum install yum-utils
sudo yum install yum-plugin-priorities - Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
- Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
sudo yum-config-manager --enable ol7_optional_latest
- Jika Anda menginstal di AWS, jalankan perintah
yum-configure-managerberikut:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional Jika Anda saat ini menggunakan Edge 4.51.00:
- Download file
bootstrap_4.52.01.shEdge ke/tmp/bootstrap_4.52.01.sh:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- Instal utilitas dan dependensi
apigee-serviceEdge 4.52.01 dengan menjalankan perintah berikut:sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, penginstal akan menginstalnya untuk Anda.
Gunakan opsi
JAVA_FIXuntuk menentukan cara menangani penginstalan Java.JAVA_FIXmenggunakan nilai berikut:I: Menginstal OpenJDK 1.8 (default).C: Lanjutkan tanpa menginstal Java.Q: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
- Gunakan
apigee-serviceuntuk mengupdate utilitasapigee-setup, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validatedi Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provisiondi Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
updatedi node Anda dengan menjalankan perintah berikut:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Lakukan ini sesuai urutan yang dijelaskan dalam Urutan update mesin.
Dengan:
- component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
cs: Cassandraedge: Semua komponen Edge kecuali Edge UI: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgresldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO (jika Anda menginstal SSO)ue: UI Edge Baruui: UI Edge Klasikzk: Zookeeper
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.
Anda dapat menjalankan
update.shterhadap 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 ./sa_silent_config
- component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
- Mulai ulang komponen Edge UI di semua node yang menjalankannya, jika Anda belum melakukannya:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Uji update dengan menjalankan utilitas
apigee-validatedi Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
- Download file
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan dalam Me-roll back 4.52.01.
Mengupdate ke 4.52.01 dari repositori 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 mirror, dari repo Apigee.
Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk mengupdate Edge dari repo lokal:
- Buat file .tar dari repo, salin file .tar ke node, lalu update Edge dari file .tar.
- Instal server web di node dengan repositori lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.
Untuk mengupdate dari repo 4.52.01 lokal:
- Buat repositori 4.52.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
- Untuk menginstal apigee-service dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal
ke dalam satu file .tar bernama
/opt/apigee/data/apigee-mirror/apigee-4.52.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
/tmpdi node baru. - Pada node baru, untar file ke direktori
/tmp:tar -xzf apigee-4.52.01.tar.gz
Perintah ini akan membuat direktori baru, bernama
repos, di direktori yang berisi file .tar. Misalnya,/tmp/repos. - Instal utilitas dan dependensi Edge
apigee-servicedari/tmp/repos:sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal
ke dalam satu file .tar bernama
- Untuk menginstal apigee-service menggunakan server web Nginx:
- Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
- Di node jarak jauh, download file
bootstrap_4.52.01.shEdge ke/tmp/bootstrap_4.52.01.sh:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.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-setupEdge:sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dengan uName:pWord adalah nama pengguna dan sandi repo.
- Gunakan
apigee-serviceuntuk mengupdate utilitasapigee-setup, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validatedi Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provisiondi Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
updatepada 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. Anda biasanya mengupdate
komponen berikut:
cs: Cassandraedge: Semua komponen Edge kecuali Edge UI: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgresldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO (jika Anda menginstal SSO)ueUI Edge Baruui: UI Edge Klasikzk: Zookeeper
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.
Anda dapat menjalankan
update.shterhadap 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 /tmp/sa_silent_config
- component adalah komponen Edge yang akan diupdate. Anda biasanya mengupdate
komponen berikut:
- Mulai ulang komponen UI di semua node yang menjalankannya, jika Anda belum melakukannya:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Uji update dengan menjalankan utilitas
apigee-validatedi 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.52.01.
Urutan update mesin
Urutan update mesin dalam penginstalan Edge sangat penting:
- Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
- Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Message Processor,
Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi
-c edgeuntuk mengupdate semuanya secara bersamaan. - Jika sebuah langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa mesin, lakukan langkah tersebut dalam urutan mesin yang ditentukan.
- 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.52.01:
- Perbarui semua komponen:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Jika Anda menginstal
apigee-adminapi) Mengupdate utilitasapigee-adminapi:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Upgrade mandiri 2 node
Update komponen berikut untuk penginstalan mandiri 2 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Postgres di mesin 2:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update LDAP di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge di mesin 2 dan 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate Qpid di Mesin 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi) Mengupdate utilitasapigee-adminapidi mesin 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
- Mulai ulang komponen Edge UI di komputer 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade 5 node
Perbarui komponen berikut untuk penginstalan 5 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Postgres di mesin 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update Postgres di mesin 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update LDAP di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge di mesin 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Update Qpid di mesin 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update Qpid di mesin 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI Edge:
- UI Klasik: Jika Anda menggunakan UI klasik, update komponen
uidi mesin 1, seperti yang ditunjukkan pada contoh berikut:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- UI Edge Baru: Jika Anda menginstal UI Edge baru, update komponen
uedi mesin yang sesuai (mungkin bukan mesin 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- UI Klasik: Jika Anda menggunakan UI klasik, update komponen
- (Jika Anda menginstal
apigee-adminapi) Mengupdate utilitasapigee-adminapidi mesin 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
- Mulai ulang komponen UI:
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen
edge-uidi mesin 1, seperti yang ditunjukkan pada contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen
edge-management-uidi komputer yang sesuai (mungkin bukan komputer 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen
Upgrade cluster 9 node
Update komponen berikut untuk penginstalan cluster 9 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -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
- Update LDAP di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge pada mesin 6, 7, 8, 9, 1, 4, dan 5 dalam urutan tersebut:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Update Qpid di mesin 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Perbarui UI baru (
ue) atau UI klasik (ui) di mesin 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jika Anda menginstal
apigee-adminapi) Update utilitasapigee-adminapidi mesin 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
- Mulai ulang komponen UI:
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen
edge-uidi mesin 1, seperti yang ditunjukkan pada contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen
edge-management-uidi komputer yang sesuai (mungkin bukan komputer 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen
Upgrade cluster 13 node
Update komponen berikut untuk penginstalan cluster 13 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -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
- Update LDAP di mesin 4 dan 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge pada mesin 12, 13, 8, 9, 6, 7, 10, dan 11 dalam urutan berikut:
/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 UI baru (
ue) atau UI klasik (ui) di mesin 6 dan 7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jika Anda menginstal
apigee-adminapi) Mengupdate utilitasapigee-adminapidi mesin 6 dan 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
- Mulai ulang komponen UI:
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen
edge-uidi mesin 6 dan 7, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen
edge-management-uidi mesin 6 dan 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen
Upgrade cluster 12 node
Update komponen berikut untuk penginstalan dalam cluster 12 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper:
- Di mesin 1, 2, dan 3 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Di mesin 7, 8, dan 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Di mesin 1, 2, dan 3 di Pusat Data 1:
- Update 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
- Mesin 6 di Pusat Data 1
- Update 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
- Mesin 1 di Pusat Data 1
- Perbarui komponen Edge:
- Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 10, 11, 12, 7, 8, 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
- Update qpidd:
- Mesin 4, 5 di Pusat Data 1
- Update
qpidddi mesin 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
qpidddi mesin 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
- Mesin 10, 11 di Pusat Data 2
- Update
qpidddi mesin 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
qpidddi mesin 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
- Mesin 4, 5 di Pusat Data 1
- Update UI baru (
ue) atau UI klasik (ui):- Mesin 1 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Mesin 7 di Pusat Data 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 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 Apigee SSO) Update Apigee SSO:
- 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 sebagai file konfigurasi yang Anda buat saat menginstal SSO.
- Mesin 1 di Pusat Data 1:
- Mulai ulang komponen UI Edge baru (
edge-management-ui) atau UI Edge klasik (edge-ui) di mesin 1 dan 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
Untuk konfigurasi non-standar
Jika Anda memiliki konfigurasi non-standar, update komponen Edge dengan urutan berikut:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
- qpidd
- UI Edge (klasik atau baru)
apigee-adminapi- Apigee SSO
Setelah selesai mengupdate, pastikan untuk memulai ulang komponen Edge UI di semua mesin yang menjalankannya.