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 upgrade tersebut.
Siapa yang dapat melakukan pembaruan
Orang yang menjalankan pembaruan harus sama dengan orang yang awalnya menginstal Edge, atau seseorang berlari sebagai {i>root<i}.
Setelah Anda menginstal RPM Edge, siapa pun dapat mengonfigurasinya.
Komponen mana yang harus Anda update
Anda harus memperbarui semua komponen Edge. Edge tidak mendukung penyiapan yang berisi komponen dari beberapa versi.
Perbarui prasyarat
Pastikan prasyarat berikut sebelum mengupgrade Apigee Edge:
- Cadangkan semua node
Sebelum mengupdate, sebaiknya lakukan pencadangan lengkap semua node demi keamanan alasan. Gunakan prosedur untuk versi Edge Anda saat ini untuk melakukan pencadangan.Hal ini memungkinkan Anda memiliki rencana cadangan, jika pembaruan ke versi baru tidak apakah berfungsi dengan baik. Untuk informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pulihkan.
- Memastikan Edge berjalan
Pastikan Edge aktif dan berjalan selama proses update dengan menggunakan perintah:/opt/apigee/apigee-service/bin/apigee-all status
- Pastikan Strategi Comptifikasi Cassandra memiliki
LeveledCompactionStrategy
Pastikan strategi kompatibilitas Cassandra ditetapkan keLeveledCompactionStrategy
, sebagaimana dijelaskan dalam Ubah atribut Strategi pemadatan Cassandra.
Penerapan otomatis setelan properti
Jika Anda telah menetapkan properti apa pun dengan mengedit .properties
file di
/opt/apigee/customer/application
, nilai tersebut akan dipertahankan oleh update.
Upgrade yang diperlukan ke Zookeeper 3.8.3
Rilis Edge untuk Private Cloud ini mencakup upgrade ke Zookeeper 3.8.3. Sebagai bagian dari maka seluruh data Zookeeper akan dimigrasikan ke Zookeeper 3.8.3.
Sebelum mengupgrade Zookeeper, baca Zookeeper panduan pemeliharaan. Sebagian besar sistem produksi Edge menggunakan cluster penyebaran node Zookeeper di beberapa pusat data. Beberapa node ini dikonfigurasi sebagai pemilih yang berpartisipasi dalam pemilihan pemimpin Zookeeper, dan sisanya dikonfigurasi sebagai pengamat. Lihat Tentang pemimpin, pengikut, pemilih, dan pengamat untuk mengetahui detail selengkapnya. {i>Node<i} pemilih memilih {i>leader<i} setelah {i>node<i} pemilih menjadi pengikut.
Selama proses pembaruan, mungkin ada penundaan sesaat atau kegagalan penulisan ke Zookeeper saat node pemimpin dimatikan. Hal ini dapat mempengaruhi operasi Manajemen yang menulis ke Zookeeper, seperti operasi deployment proxy, dan perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll. Seharusnya tidak ada dampak pada runtime API Apigee (kecuali API runtime ini memanggil API pengelolaan) selama upgrade Zookeeper saat dengan mengikuti prosedur di bawah ini.
Pada level yang tinggi, proses upgrade melibatkan pencadangan setiap node. Ini diikuti dengan mengupgrade semua observer dan pengikut, dan terakhir, mengupgrade node pemimpin.
Buat cadangan
Ambil cadangan semua node Zookeeper untuk digunakan jika rollback diperlukan. Perlu diketahui bahwa {i>rollback<i} akan mengembalikan {i> Zookeeper<i} ke kondisi ketika cadangan itu diambil. Catatan: Setiap deployment atau perubahan infrastruktur di Apigee sejak pencadangan diambil (yang informasinya disimpan Zookeeper) akan hilang selama pemulihan.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup
Jika Anda menggunakan virtual machine dan memiliki kemampuan tersebut, snapshot atau pencadangan VM juga dapat untuk pemulihan atau rollback (jika perlu).
Identifikasi pemimpin, pengikut, dan pengamat
Catatan: Contoh perintah di bawah ini menggunakan utilitas nc untuk mengirim data ke Zookeeper. Anda bisa menggunakan utilitas alternatif untuk mengirim data ke Zookeeper juga.
- Jika tidak diinstal pada node ZooKeeper, instal nc:
sudo 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.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
Mode
output untuk node, Anda akan melihat observer, posisi teratas, atau pengikut (artinya pemilih yang bukan pemimpin) bergantung pada konfigurasi node. Catatan: Dalam penginstalan Edge mandiri dengan satu node ZooKeeper,Mode
ditetapkan ke mandiri. - Ulangi langkah 1 dan 2 pada setiap node ZooKeeper.
Upgrade Zookeeper di node observer dan pengikut
Upgrade Zookeeper di setiap node observer dan pengikut sebagai berikut:
- Download dan jalankan bootstrap Edge untuk Private Cloud 4.52, seperti yang dijelaskan dalam Update ke versi 4.52.01 di node dengan koneksi internet eksternal. Proses ini kemungkinan akan bervariasi, tergantung apakah {i>node<i} memiliki koneksi internet eksternal atau Anda melakukan instalasi offline.
- Upgrade komponen Zookeeper:
Catatan: Jika node ini memiliki komponen lain yang diinstal (seperti Cassandra), Anda dapat mengupgrade sekarang juga (seperti dengan profil cs,zk) atau Anda dapat meningkatkan komponen lainnya nanti. Apigee sebaiknya Anda hanya mengupgrade Zookeeper terlebih dahulu dan memastikan cluster berfungsi dengan baik sebelum meningkatkan komponen lainnya./opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
- Ulangi langkah-langkah di atas pada setiap node pengikut dan pengamat Zookeeper.
Hentikan pemimpin
Setelah semua node observer dan pengikut diupgrade, nonaktifkan pemimpin. Di node yang diidentifikasi sebagai pemimpin, jalankan perintah di bawah ini:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
Perhatikan bahwa selama acara ini, sebelum pemimpin baru dipilih, mungkin akan terjadi penundaan sesaat atau terjadi kegagalan penulisan di Zookeeper. Hal ini dapat memengaruhi operasi yang ditulis ke Zookeeper seperti tindakan deployment proxy atau perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll.
Memverifikasi bahwa pimpinan baru dipilih
Menggunakan langkah-langkah dalam artikel Mengidentifikasi pemimpin, pengikut dan pengamat di atas, memverifikasi bahwa pemimpin baru telah dipilih dari pengikut, setelah posisi teratas yang ada dihentikan. Perhatikan bahwa pemimpin bisa saja dipilih dalam pusat data yang berbeda dengan pemimpin saat ini.
Upgrade pemimpin
Ikuti langkah-langkah yang sama seperti di Mengupgrade Zookeeper pada node observer dan pengikut di atas.
Setelah node pemimpin lama juga diupgrade, verifikasi kondisi cluster dan memastikan ada node pemimpin.
Rollback
Jika rollback diperlukan:
- Lakukan langkah rollback pada observer dan pengikut terlebih dahulu.
- Download dan jalankan bootstrap versi yang Anda roll back—4.50 atau 4.51. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau tidak atau Anda mengikuti instalasi {i>offline<i}.
- Hentikan Zookeeper jika Zookeeper berjalan di node:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- Uninstal penjaga kebun binatang 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, roll back node pemimpin dengan mengikuti langkah 2 sampai 5 pada {i>leader node<i}.
- Setelah semua node di-roll back, verifikasi kondisi cluster dan pastikan ada node pemimpin di cluster.
Pulihkan cadangan
Lihat Memulihkan dari cadangan. Perhatikan bahwa cadangan Zookeeper yang diambil dari Edge versi sebelumnya untuk Private Cloud seperti 4.50 dan 4.51 seharusnya kompatibel dengan versi Zookeeper di Edge untuk Private Cloud 4.52.
Upgrade yang diperlukan ke Postgres 14
Rilis Edge untuk Private Cloud ini menyertakan upgrade ke Postgres 14. Sebagai bagian dari upgrade ini, semua data Postgres dimigrasikan ke Postgres 14.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.51.00 ke 4.52.01, Anda perlu mengikuti langkah-langkah upgrade Postgres tambahan. Lihat bagian Upgrade yang diperlukan ke Postgres 14 jika Anda melakukan upgrade dari versi 4.51.00 ke 4.52.01.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.52.00 ke 4.52.01, tidak diperlukan langkah-langkah upgrade Postgres tambahan.
Mengupgrade Qpid
Rilis Edge untuk Private Cloud ini menyertakan upgrade ke Qpid J-Broker.
Sebaiknya pilih salah satu metode berikut untuk melakukan upgrade Qpid:
Upgrade yang sudah diterapkan 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:
- Untuk memulai, pilih satu node Qpid.
- Hentikan broker Qpid pada node:
apigee-service apigee-qpidd stop
- Memblokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan
{i>firewall<i}. Anda dapat menerapkan {i>firewall<i} ini di tingkat
instance node Qpid atau
firewall eksternal/jaringan.
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 pada port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Mulai kembali broker Qpid untuk mengosongkan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Pastikan antrean yang ada kosong:
qpid-stat -q
Jika pesan terjebak dalam antrean huruf mati (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), kuras antrean menggunakan langkah-langkah untuk menyelesaikan data analisis yang tertahan di antrean.
- Setelah memastikan antrean telah habis di 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 tempat firewall diterapkan. Setelah firewall dihapus, permintaan yang berasal dari alamat IP pemroses pesan ke {i>node Qpid<i} pada porta 5672 akan diterima. Jika Anda menggunakan
iptables
untuk menambahkan firewall, menghapus firewall dan untuk membuat daftar 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 sampai 9 untuk setiap node Qpid.
Melakukan commissioning untuk node Qpid baru
Metode ini menyiapkan dan menginstal apigee-qpidd
dan edge-qpid-server
di
{i>node<i} baru.
- Menambahkan node Qpid baru. Langkah ini akan menyiapkan node Qpid dengan J-broker. Untuk langkah-langkah mendetailnya, lihat Menambahkan server Qpid.
- Pilih node Qpid yang ada (node dari versi tempat Anda melakukan upgrade).
- Hentikan broker Qpid pada node:
apigee-service apigee-qpidd stop
- Memblokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan
{i>firewall<i}. Anda dapat menerapkan {i>firewall<i} ini di tingkat
instance node Qpid atau
firewall eksternal/jaringan.
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 pada port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Mulai kembali broker Qpid untuk mengosongkan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Periksa untuk memastikan antrean yang ada kosong:
qpid-stat -q
Jika pesan terjebak dalam antrean huruf mati (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) maka kuras antrean dengan mengikuti langkah-langkah dalam topik pemecahan masalah Data analisis tertahan di antrean surat mati Qpidd.
- Setelah memastikan antrean telah habis di node lama, hentikan
apigee-qpidd
apigee-service apigee-qpidd stop
- Batalkan pendaftaran node Qpid lama dengan mengikuti langkah-langkah dalam Menghapus server Qpid.
- Terus tambahkan node baru dan hapus node lama, satu per satu, hingga semua node Qpid memiliki telah diupgrade.
Rollback
Untuk melakukan roll back ke Rilis Fitur sebelumnya, pastikan mengunduh file bootstrap.sh
untuk
ke versi yang ingin Anda 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 pada semua host Qpid:
- Menghentikan broker Qpid yang ada
apigee-service apigee-qpidd stop
- Memblokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan
{i>firewall<i}. Anda dapat menerapkan {i>firewall<i} ini di tingkat
instance node Qpid atau
firewall eksternal/jaringan.
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 pada port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Mulai kembali broker qpid untuk mengosongkan pesan yang ada jika ada:
apigee-service apigee-qpidd start
- Pastikan antrean yang ada kosong. Untuk memeriksanya, masuk ke Qpid
portal pengelolaan:
Catatan: Jika port 8090 pada 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 habis, 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 mengenai UI Edge. Untuk informasi selengkapnya, lihat UI Edge baru untuk Private Cloud.
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, UI Edge mengharuskan Anda menonaktifkan autentikasi Dasar dan menggunakan IDP seperti SAML atau LDAP.
Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge yang baru.
Mengupdate UI Edge
Untuk mengupdate komponen UI Edge, pertimbangkan versi Edge untuk Private Cloud yang mengupgrade dari:
- Dari 4.51.00 hingga 4.52.00 (dengan UI Edge baru yang sudah diinstal): Gunakan
petunjuk upgrade di bagian ini untuk
komponen
edge-management-ui
.
Update dengan mTLS Apigee
Untuk mengupdate Apigee mTLS , lakukan hal berikut langkah:
Me-roll back update
Jika gagal pembaruan, Anda dapat mencoba memperbaiki masalah itu, lalu menjalankan
update.sh
lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan
dari bagian terakhir yang ditinggalkan.
Jika kegagalan tersebut mengharuskan Anda me-roll back update ke versi sebelumnya, lihat Roll back 4.52.00 untuk mendapatkan petunjuk mendetail.
Informasi pembaruan logging
Secara default, utilitas update.sh
menulis informasi log ke:
/opt/apigee/var/log/apigee-setup/update.log
Jika orang yang menjalankan utilitas update.sh
tidak memiliki akses ke
direktori tersebut, file akan menulis log ke
direktori /tmp
sebagai file bernama
update_username.log
.
Jika orang tersebut tidak memiliki akses ke /tmp
, utilitas update.sh
gagal.
Update tanpa periode nonaktif
Update tanpa periode nonaktif atau update berkelanjutan memungkinkan Anda mengupdate penginstalan Edge tanpa yang merusak Edge.
Update tanpa periode nonaktif hanya dapat dilakukan dengan konfigurasi 5 node atau yang lebih besar.
Kunci untuk mengupgrade tanpa periode nonaktif adalah dengan menghapus setiap Router, satu per satu, dari beban dengan load balancer Jaringan Passthrough Eksternal Regional. Anda kemudian memperbarui {i>Router<i} dan komponen lainnya di komputer yang sama dengan {i>Router<i}, lalu menambahkan Router kembali ke load balancer.
- Perbarui komputer dalam urutan yang benar untuk pemasangan Anda seperti yang dijelaskan Urutan update komputer.
- Ketika tiba waktunya untuk memperbarui {i>Router<i}, pilih salah satu {i>Router<i} dan membuatnya tidak dapat dijangkau, yang dijelaskan dalam Mengaktifkan/Menonaktifkan server (Keterjangkauan Pemroses/Router Pesan).
- Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan di node yang sama.
- Buat Router dapat dijangkau lagi.
- Ulangi langkah 2 sampai 4 untuk Router lainnya.
- Lanjutkan pembaruan untuk komputer apa pun yang tersisa dalam pemasangan Anda.
Lakukan tindakan berikut sebelum dan sesudah update:
- Pada gabungan node Router dan Pemroses Pesan:
- Sebelum update – lakukan hal berikut:
- Membuat Router tidak dapat dijangkau.
- Membuat Pemroses Pesan tidak dapat dijangkau.
- Setelah update – lakukan tindakan berikut:
- Buat Pemroses Pesan dapat dijangkau.
- Buat Router dapat dijangkau.
- Sebelum update – lakukan hal berikut:
- Pada satu node Router:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
- Pada satu node Pemroses Pesan:
- Sebelum update, buat Pemroses Pesan tidak dapat dijangkau.
- Setelah update, buat Pemroses Pesan dapat dijangkau.
Menggunakan file konfigurasi senyap
Anda harus meneruskan file konfigurasi senyap ke perintah update. File konfigurasi senyap harus sama dengan yang Anda gunakan untuk menginstal Edge 4.50.00 atau 4.51.00.
Perbarui ke 4.52.01 pada node dengan koneksi internet eksternal
Gunakan prosedur berikut untuk memperbarui komponen Edge pada node:
- Jika ada, nonaktifkan tugas
cron
apa pun yang dikonfigurasi untuk melakukan operasi perbaikan pada 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 Edge apigee-setup.
- 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 berikut
Perintah
yum-configure-manager
:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Jika saat ini Anda menggunakan Edge 4.51.00:
- Download file
bootstrap_4.52.01.sh
Edge untuk/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-service
Edge 4.52.01 dengan 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 menghapus pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, {i>installer<i} akan menginstalnya untuk Anda.
Gunakan opsi
JAVA_FIX
untuk menentukan cara menangani Penginstalan Java.JAVA_FIX
menggunakan nilai berikut:I
: Instal OpenJDK 1.8 (default).C
: Lanjutkan tanpa menginstal Java.Q
: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
- Gunakan
apigee-service
untuk mengupdate utilitasapigee-setup
, sebagai contoh berikut menunjukkan:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan, sebagai berikut contoh menampilkan:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
di Server Pengelolaan, sebagai berikut contoh menampilkan:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
update
di node Anda dengan menjalankan perintah berikut:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Lakukan ini sesuai urutan yang dijelaskan dalam Urutan mesin perbarui.
Dengan keterangan:
- component adalah komponen Edge yang akan diperbarui. Nilai yang memungkinkan mencakup:
cs
: Cassandraedge
: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pesan Prosesor, Router, Server QPID, Server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (jika Anda menginstal SSO)ue
: UI Edge Baruui
: UI Edge Klasikzk
: Zookeeper
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk definisikan Edge Anda komponen selama penginstalan 4.50.00 atau 4.51.00.
Anda dapat menjalankan
update.sh
terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil penginstalan Edge all-in-one (AIO). Contoh:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component adalah komponen Edge yang akan diperbarui. Nilai yang memungkinkan mencakup:
- Mulai ulang komponen UI Edge pada semua node yang menjalankannya, jika Anda belum melakukannya:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Uji update dengan menjalankan utilitas
apigee-validate
pada bagian Pengelolaan Server, seperti yang dijelaskan dalam Menguji penginstalan.
- Download file
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan di Roll back 4.52.01.
Pembaruan ke 4.52.01 dari repo lokal
Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui Internet, maka Anda dapat melakukan pembaruan dari repositori lokal, atau duplikat, dari repositori Apigee.
Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk memperbarui Edge dari repo lokal:
- Buat file .tar repo, salin file .tar ke node, lalu perbarui Edge dari {i>.tar<i}.
- 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 dengan server web
Untuk memperbarui dari repo 4.52.01 lokal:
- Buat repo 4.52.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" pada pukul Instal utilitas Edge apigee-setup.
- Untuk menginstal apigee-service dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal
menjadi 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
/tmp
pada node baru. - Pada node baru, untar file ke direktori
/tmp
:tar -xzf apigee-4.52.01.tar.gz
Perintah ini membuat direktori baru, bernama
repos
, di direktori yang berisi file {i> .tar<i}. Misalnya,/tmp/repos
. - Instal utilitas dan dependensi Edge
apigee-service
dari/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
menjadi satu file .tar bernama
- Untuk menginstal apigee-service menggunakan server web Nginx:
- Konfigurasikan server web Nginx seperti yang dijelaskan di bagian "Menginstal dari repo menggunakan Nginx webserver" di Menginstal Edge utilitas apigee-setup.
- Pada node jarak jauh, download file Edge
bootstrap_4.52.01.sh
untuk/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 sebelumnya Anda tetapkan repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.
- Pada node jarak jauh, instal utilitas dan dependensi Edge
apigee-setup
: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-service
untuk mengupdate utilitasapigee-setup
, sebagai contoh berikut menunjukkan:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan, sebagai berikut contoh menampilkan:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
di Server Pengelolaan, sebagai berikut contoh menampilkan:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
update
di node Anda sesuai urutan yang dijelaskan di Urutan update komputer:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Dengan keterangan:
- component adalah komponen Edge yang akan diperbarui. Anda biasanya memperbarui
komponen berikut:
cs
: Cassandraedge
: Semua komponen Edge kecuali UI Edge: Management Server, Message Processor, Router, Server QPID, Server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (jika Anda menginstal SSO)- UI Edge Baru
ue
ui
: UI Edge Klasikzk
: Zookeeper
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama instalasi 4.50.00 atau 4.51.00.
Anda dapat menjalankan
update.sh
terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil penginstalan Edge all-in-one (AIO). Contoh:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component adalah komponen Edge yang akan diperbarui. Anda biasanya memperbarui
komponen berikut:
- Mulai ulang komponen UI pada 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-validate
pada bagian Pengelolaan Server, seperti yang dijelaskan dalam Menguji penginstalan.
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan di Roll back 4.52.01.
Urutan update mesin
Urutan Anda memperbarui komputer dalam penginstalan Edge adalah hal penting:
- Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
- Untuk mesin apa pun yang memiliki beberapa komponen Edge (Management Server, Message Processor,
Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi
-c edge
untuk mengupdate secara bersamaan. - Jika sebuah langkah menentukan bahwa itu harus dilakukan pada beberapa komputer, lakukan dalam urutan mesin tertentu.
- Tidak ada langkah terpisah untuk memperbarui Monetisasi. Halaman ini diperbarui saat Anda menentukan
-c edge
.
Upgrade mandiri 1 node
Untuk mengupgrade konfigurasi mandiri 1 node ke 4.52.01:
- Update semua komponen:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Update 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 pemasangan untuk mengetahui daftar topologi Edge dan nomor node.
- Perbarui Cassandra dan ZooKeeper di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Perbarui Postgres di komputer 2:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge di perangkat 2 dan 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Perbarui Qpid di Komputer 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI di perangkat 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Update utilitasapigee-adminapi
pada komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.
- Mulai ulang komponen UI Edge di perangkat 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade 5 node
Update komponen berikut untuk penginstalan 5 node:
Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.
- Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Perbarui Postgres di komputer 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui Postgres di komputer 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge di komputer 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Perbarui Qpid di komputer 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Perbarui Qpid di komputer 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI Edge:
- UI klasik: Jika Anda menggunakan UI klasik, update
Komponen
ui
di komputer 1, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- UI Edge Baru: Jika Anda menginstal UI Edge baru, perbarui
Komponen
ue
pada komputer 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
) Update utilitasapigee-adminapi
pada komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.
- Mulai ulang komponen UI:
- UI klasik: Jika Anda menggunakan UI klasik, mulai ulang
Komponen
edge-ui
di komputer 1, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang
Komponen
edge-management-ui
pada komputer yang sesuai (mungkin bukan perangkat 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI klasik: Jika Anda menggunakan UI klasik, mulai ulang
Komponen
Upgrade dalam cluster 9 node
Update komponen berikut untuk penginstalan yang dikelompokkan 9 node:
Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.
- Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Perbarui Postgres di komputer 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui Postgres di komputer 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge pada perangkat 6, 7, 8, 9, 1, 4, dan 5 dalam urutan tersebut:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Perbarui Qpid pada komputer 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI baru (
ue
) atau UI klasik (ui
) di perangkat 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Update utilitasapigee-adminapi
pada komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.
- Mulai ulang komponen UI:
- UI klasik: Jika Anda menggunakan UI klasik, mulai ulang
Komponen
edge-ui
di komputer 1, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang
Komponen
edge-management-ui
pada komputer yang sesuai (mungkin bukan perangkat 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI klasik: Jika Anda menggunakan UI klasik, mulai ulang
Komponen
Upgrade dalam cluster 13 node
Update komponen berikut untuk penginstalan yang dikelompokkan 13 node:
Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.
- Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Perbarui Postgres di komputer 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui Postgres di komputer 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di komputer 4 dan 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Perbarui komponen Edge pada komputer 12, 13, 8, 9, 6, 7, 10, dan 11 dalam urutan tersebut:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Perbarui Qpid pada komputer 12 dan 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI baru (
ue
) atau UI klasik (ui
) di komputer 6 dan 7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Update utilitasapigee-adminapi
pada komputer 6 dan 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal SSO Apigee) Update SSO Apigee di komputer 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.
- Mulai ulang komponen UI:
- UI klasik: Jika Anda menggunakan UI klasik, mulai ulang
Komponen
edge-ui
pada mesin 6 dan 7, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang
Komponen
edge-management-ui
pada komputer 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 dalam cluster 12 node
Update komponen berikut untuk penginstalan yang dikelompokkan 12 node:
Lihat Topologi pemasangan untuk mengetahui daftar topologi Edge dan nomor node.
- Perbarui Cassandra dan ZooKeeper:
- Pada komputer 1, 2, dan 3 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Pada komputer 7, 8, dan 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Pada komputer 1, 2, dan 3 di Pusat Data 1:
- 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
- Mesin 6 di Pusat Data 1
- Perbarui LDAP:
- Mesin 1 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Mesin 7 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Mesin 1 di Pusat Data 1
- Update komponen Edge:
- Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 10, 11, 12, 7, 8, 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
- Perbarui qpidd:
- Mesin 4, 5 di Pusat Data 1
- Perbarui
qpidd
di komputer 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Perbarui
qpidd
di komputer 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Perbarui
- Mesin 10, 11 di Pusat Data 2
- Update
qpidd
di komputer 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
qpidd
di komputer 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
- 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
) Update 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 Apigee) Update SSO Apigee:
- 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 Anda SSO yang diinstal.
- Mesin 1 di Pusat Data 1:
- Mulai ulang UI Edge baru (
edge-management-ui
) atau UI Edge klasik (edge-ui
) di komputer 1 dan 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
Untuk konfigurasi non-standar
Jika Anda memiliki konfigurasi non-standar, perbarui komponen Edge pada berikut:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Tepi, yang berarti "-c tepi" profil pada semua {i>node<i} dengan urutan: {i>node<i} dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
- qpidd
- UI Edge (baik klasik maupun baru)
apigee-adminapi
- SSO Apigee
Setelah selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua komputer yang berjalan anotasi.