Apigee mendukung upgrade Edge untuk Private Cloud dari versi 4.51.00 atau versi 4.52.00 langsung ke versi 4.52.01. Halaman ini menjelaskan cara melakukan upgrade.
Siapa yang dapat melakukan pembaruan
Orang yang menjalankan update harus sama dengan orang yang pertama menginstal Edge, atau orang yang menjalankan update 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.
Memperbarui prasyarat
Pastikan prasyarat berikut sebelum mengupgrade Apigee Edge:
- Cadangkan semua node
Sebelum mengupdate, sebaiknya cadangkan semua node secara menyeluruh untuk alasan keamanan. Gunakan prosedur bagi versi Edge Anda saat ini untuk 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
- Pastikan Strategi Comptification Cassandra adalah
LeveledCompactionStrategy
Pastikan strategi kompatibilitas Cassandra ditetapkan keLeveledCompactionStrategy
, seperti yang dijelaskan dalam Mengubah strategi pemadatan Cassandra.
Penerapan otomatis setelan properti
Jika Anda telah menetapkan properti 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 Cloudes 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 sekumpulan node Zookeeper yang tersebar di beberapa pusat data. Beberapa node ini dikonfigurasi sebagai pemilih yang berpartisipasi dalam pemilihan pemimpin Zookeeper, dan sisanya dikonfigurasi sebagai observer. Lihat Tentang pemimpin, pengikut, pemilih, dan pengamat untuk mengetahui detail selengkapnya. Node pemilih memilih pemimpin, yang setelahnya node pemilih itu sendiri menjadi pengikut.
Selama proses update, mungkin ada penundaan sementara atau kegagalan tulis ke Zookeeper saat node pemimpin dimatikan. 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 dengan mengikuti prosedur di bawah.
Pada level yang tinggi, proses upgrade melibatkan pencadangan setiap node. Hal ini diikuti dengan mengupgrade semua observer dan pengikut, lalu mengupgrade node pemimpin.
Buat cadangan
Cadangkan semua node Zookeeper untuk digunakan jika rollback diperlukan. Perlu diketahui bahwa rollback akan memulihkan Zookeeper ke status saat cadangan diambil. Catatan: Setiap perubahan deployment atau infrastruktur di Apigee sejak pencadangan diambil (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 tersebut, snapshot atau cadangan VM juga dapat diambil untuk pemulihan atau rollback (jika perlu).
Mengidentifikasi pemimpin, pengikut, dan pengamat
Catatan: Contoh perintah di bawah ini menggunakan utilitas nc untuk mengirim data ke Zookeeper. Anda juga dapat menggunakan utilitas alternatif untuk mengirim data ke Zookeeper.
- Jika tidak 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
Pada baris
Mode
output untuk node, Anda akan melihat observer, pemimpin, atau pengikut (artinya pemilih yang bukan pemimpin), bergantung pada konfigurasi node. Catatan: Dalam penginstalan Edge mandiri dengan satu node ZooKeeper,Mode
disetel ke mandiri. - Ulangi langkah 1 dan 2 pada setiap node ZooKeeper.
Mengupgrade Zookeeper pada 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 Mengupdate ke versi 4.52.01 pada node dengan koneksi internet eksternal. Prosesnya mungkin akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda melakukan penginstalan offline.
- Upgrade komponen Zookeeper:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
Catatan: Jika node ini memiliki komponen lain yang terinstal (seperti Cassandra), Anda juga dapat mengupgradenya sekarang (seperti dengan profil cs,zk) atau mengupgrade komponen lain nanti. Apigee merekomendasikan agar Anda hanya mengupgrade Zookeeper terlebih dahulu dan memastikan cluster berfungsi dengan baik sebelum mengupgrade komponen lain. - Ulangi langkah-langkah di atas pada setiap node observer dan observer Zookeeper.
Nonaktifkan pemimpin
Setelah semua node observer dan pengikut diupgrade, nonaktifkan pemimpin. Pada node yang diidentifikasi sebagai pemimpin, jalankan perintah di bawah:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
Perlu diperhatikan bahwa selama peristiwa ini, sebelum pemimpin baru dipilih, mungkin akan ada penundaan sementara atau kegagalan tulis di Zookeeper. Hal ini dapat memengaruhi operasi yang menulis ke Zookeeper, seperti tindakan deployment proxy atau perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll.
Memverifikasi bahwa pemimpin baru yang dipilih
Dengan menggunakan langkah-langkah di bagian Mengidentifikasi pemimpin, pengikut, dan pengamat di atas, verifikasi bahwa pemimpin baru telah dipilih dari pengikut, setelah pemimpin yang ada dihentikan. Perhatikan bahwa pemimpin dapat dipilih di pusat data yang berbeda dengan pemimpin saat ini.
Pemimpin upgrade
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 pastikan ada node pemimpin.
Rollback
Jika rollback diperlukan:
- Lakukan langkah-langkah rollback pada observer dan pengikut terlebih dahulu.
- Unduh dan jalankan bootstrap dari versi yang Anda gunakan kembali—baik 4.50 atau 4.51. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda mengikuti penginstalan offline.
- Menghentikan Zookeeper jika sedang 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 di node pemimpin.
- 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 for Private Cloud versi sebelumnya seperti 4.50 dan 4.51 harus kompatibel dengan versi Zookeeper di Edge untuk Private Cloud 4.52.
Upgrade Qpid
Rilis Edge untuk 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 hilangnya data runtime, jika ada, yang diperoleh untuk analisis.
Untuk melakukan upgrade tanpa periode nonaktif ke Qpid:
- Pilih satu node Qpid untuk memulai.
- Hentikan broker Qpid pada node:
apigee-service apigee-qpidd stop
- Blokir traffic masuk pada port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini pada level 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 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 lagi broker Qpid untuk menghabiskan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Pastikan antrean yang ada kosong:
qpid-stat -q
Jika pesan tertahan di antrean surat mati (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), maka habiskan antrean menggunakan langkah-langkah untuk menyelesaikan data analisis yang terperangkap di antrean surat mati.
- Setelah memverifikasi antrean telah dihabiskan 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 tempat firewall diterapkan. Setelah firewall dihapus, permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid pada port 5672 akan diterima. Jika Anda menggunakan
iptables
untuk menambahkan firewall, untuk menghapus firewall dan menampilkan 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.
Menetapkan node Qpid baru
Metode ini akan menyiapkan dan menginstal apigee-qpidd
dan edge-qpid-server
pada node baru.
- Tambahkan node Qpid baru. Langkah ini akan menyiapkan node Qpid dengan J-broker. Untuk langkah-langkah detailnya, 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 pada port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini pada level 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 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 lagi broker Qpid untuk menghabiskan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Periksa untuk memastikan antrean yang ada kosong:
qpid-stat -q
Jika pesan tertahan di antrean surat mati (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), maka habiskan antrean tersebut dengan mengikuti langkah-langkah dalam topik pemecahan masalah Data Analytics yang tertahan di antrean surat mati Qpidd.
- Setelah memastikan antrean telah dihabiskan pada 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 telah diupgrade.
Rollback
Untuk melakukan roll back ke Rilis Fitur sebelumnya, pastikan untuk mendownload file bootstrap.sh
untuk versi yang ingin Anda roll back. Untuk melakukan roll back ke v4.52.00, download bootstrap_4.52.00.sh
.
Untuk me-roll back Qpid, ikuti langkah-langkah berikut di semua host Qpid:
- Hentikan broker Qpid yang sudah ada
apigee-service apigee-qpidd stop
- Blokir traffic masuk pada port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini pada level 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 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 lagi broker qpid untuk menghabiskan pesan yang ada, jika ada:
apigee-service apigee-qpidd start
- Pastikan antrean yang ada kosong. Untuk memeriksanya, login ke portal
pengelolaan Qpid:
http://QPID_NODE_IP:8090
Catatan: Jika port 8090 pada node QPID tidak dapat diakses, Anda dapat menggunakan mekanisme alternatif seperti penerusan port SSH untuk mengakses URL ini. - Setelah memverifikasi antrean telah dikuras, 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 semua setelan yang ada menggunakan perintah berikut:
iptables -F
iptables -L
UI Edge baru
Bagian ini mencantumkan pertimbangan terkait UI Edge. Untuk mengetahui 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 kualitasnya untuk developer dan administrator Apigee Edge untuk Private Cloud.
Perlu diperhatikan bahwa UI Edge mengharuskan Anda menonaktifkan Autentikasi dasar dan menggunakan IDP seperti SAML atau LDAP.
Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.
Mengupdate UI Edge
Untuk mengupdate komponen UI Edge, pertimbangkan versi Edge untuk Private Cloud tempat Anda melakukan upgrade:
- Dari 4.51.00 hingga 4.52.00 (dengan UI Edge baru yang sudah terinstal): Gunakan
petunjuk upgrade di bagian ini untuk
komponen
edge-management-ui
.
Mengupdate dengan Apigee mTLS
Untuk mengupdate Apigee mTLS , lakukan langkah-langkah berikut:
Me-roll back update
Jika update gagal, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan update.sh
lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan
dari bagian terakhir update.
Jika kegagalan mengharuskan Anda me-roll back update ke versi sebelumnya, lihat Roll back 4.52.00 untuk mendapatkan petunjuk mendetail.
Mencatat informasi update
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 tersebut 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 zero-time, atau update berkelanjutan, memungkinkan Anda mengupdate penginstalan Edge tanpa menurunkan Edge.
Update tanpa periode nonaktif hanya dapat dilakukan dengan konfigurasi 5 node dan yang lebih besar.
Kunci untuk upgrade nol periode nonaktif adalah menghapus setiap Router, satu per satu, dari load balancer. Kemudian, Anda akan mengupdate Router dan komponen lainnya di mesin yang sama dengan Router, lalu menambahkan Router kembali ke load balancer.
- Perbarui mesin dalam urutan yang benar untuk penginstalan seperti yang dijelaskan Urutan update mesin.
- Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat Router tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan server (Message Processor/Router).
- Update Router yang dipilih dan semua komponen Edge lainnya di komputer yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan di node yang sama.
- Membuat Router dapat dijangkau lagi.
- Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
- Lanjutkan update untuk komputer lainnya dalam penginstalan Anda.
Perhatikan hal berikut sebelum dan sesudah update:
- Di gabungan node Router dan Pemroses Pesan:
- 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.
- Membuat Router dapat dijangkau.
- Sebelum update – lakukan tindakan berikut:
- Di 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 pembaruan, 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.
Update ke 4.52.01 pada node dengan koneksi internet eksternal
Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:
- Jika ada, nonaktifkan semua tugas
cron
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 penyiapan apigee 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-manager
berikut: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 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-service
Edge 4.52.01 dengan menjalankan perintah berikut:sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal memeriksa apakah Anda telah menginstal Java 1.8. Jika belum, penginstal akan menginstalnya untuk Anda.
Gunakan opsi
JAVA_FIX
untuk menentukan cara menangani penginstalan Java.JAVA_FIX
menggunakan nilai berikut:I
: Menginstal 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
, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
update
pada node Anda dengan menjalankan perintah berikut:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Lakukan hal ini sesuai urutan yang dijelaskan dalam Urutan update komputer.
Dengan keterangan:
- component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
cs
: Cassandraedge
: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pemroses Pesan, Router, Server QPID, Server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (jika Anda menginstal SSO)ue
: UI Edge Baruui
: UI Edge Klasikzk
: Penjaga kebun binatang
- 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.sh
terhadap semua komponen dengan menetapkan 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 diupdate. 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
di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
- Download file
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan dalam Roll back 4.52.01.
Mengupdate 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, 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 dari repo tersebut, salin file .tar ke node, lalu update Edge dari file .tar.
- Menginstal 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 4.52.01 lokal:
- Buat repo lokal 4.52.01 seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di bagian Menginstal 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 akan membuat direktori baru, bernama
repos
, dalam direktori yang berisi file .tar. Misalnya,/tmp/repos
. - Instal utilitas dan dependensi
apigee-service
Edge dari/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.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 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 bagian Menginstal utilitas apigee-setup Edge.
- Pada node jarak jauh, download file
bootstrap_4.52.01.sh
Edge 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 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
, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Jalankan utilitas
update
di node Anda sesuai urutan yang dijelaskan di Urutan update mesin:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Dengan keterangan:
- component adalah komponen Edge yang akan diupdate. Biasanya Anda mengupdate
komponen berikut:
cs
: Cassandraedge
: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pemroses Pesan, Router, Server QPID, Server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (jika Anda menginstal SSO)ue
UI Edge Baruui
: UI Edge Klasikzk
: Penjaga kebun binatang
- 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.sh
terhadap semua komponen dengan menetapkan 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 diupdate. Biasanya Anda mengupdate
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
di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan dalam Roll back 4.52.01.
Urutan update mesin
Urutan Anda mengupdate mesin dalam penginstalan Edge penting:
- Anda harus memperbarui semua node Cassandra dan ZooKeeper sebelum memperbarui node lainnya.
- Untuk komputer apa pun dengan beberapa komponen Edge (Server Pengelolaan, Pemroses Pesan, Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi
-c edge
untuk mengupdate semuanya secara bersamaan. - Jika sebuah langkah menentukan bahwa tindakan tersebut harus dilakukan pada beberapa mesin, lakukan sesuai urutan mesin yang ditentukan.
- Tidak ada langkah terpisah untuk memperbarui Monetisasi. Kolom ini diperbarui saat Anda menentukan opsi
-c edge
.
Upgrade mandiri 1 node
Untuk mengupgrade konfigurasi mandiri 1 node ke versi 4.52.01:
- Update 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 komputer 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
- Mengupdate LDAP di komputer 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-adminapi
di komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) 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 menginstal SSO.
- Mulai ulang komponen UI Edge pada mesin 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade 5 node
Update 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 komputer 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update Postgres di komputer 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate LDAP di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge di komputer 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate Qpid di komputer 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mengupdate 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, maka update
komponen
ue
di perangkat 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-adminapi
di komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) 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 menginstal SSO.
- 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, lalu mulai ulang
komponen
edge-management-ui
di komputer yang sesuai (mungkin bukan mesin 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 komputer 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate LDAP di komputer 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge pada komputer 6, 7, 8, 9, 1, 4, dan 5 secara berurutan:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mengupdate Qpid di komputer 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update 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-adminapi
di komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) 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 menginstal SSO.
- 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, lalu mulai ulang
komponen
edge-management-ui
di komputer yang sesuai (mungkin bukan mesin 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 komputer 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 komputer 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mengupdate LDAP di komputer 4 dan 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update 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
- Mengupdate Qpid di 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
) Mengupdate utilitasapigee-adminapi
pada komputer 6 dan 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Jika Anda menginstal Apigee SSO) 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 menginstal SSO.
- Mulai ulang komponen UI:
- UI klasik: Jika Anda menggunakan UI klasik, mulai ulang
komponen
edge-ui
pada komputer 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 cluster 12 node
Update komponen berikut untuk penginstalan cluster 12 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update 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:
- 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
- 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
- Update qpidd:
- Mesin 4, 5 di Pusat Data 1
- Mengupdate
qpidd
di perangkat 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mengupdate
qpidd
di komputer 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Mengupdate
- 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
) 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 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 menginstal SSO.
- Mesin 1 di Pusat Data 1:
- Mulai ulang komponen UI Edge baru (
edge-management-ui
) atau UI Edge klasik (edge-ui
) pada 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, update komponen Edge dengan urutan berikut:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge, yang berarti profil "-c edge" pada semua node secara berurutan: node dengan server Qpid, Server Edge Postgres, Server Pengelolaan, Pemroses Pesan, dan Router.
- {i>qpidd<i}
- UI Edge (baik klasik maupun baru)
apigee-adminapi
- SSO Apigee
Setelah selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua mesin yang menjalankannya.