Apigee mendukung upgrade Edge for Private Cloud secara langsung dari versi 4.51.00, 4.52.00, atau 4.52.01 ke versi 4.52.02. 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 orang yang menjalankan pembaruan sebagai root.
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 untuk alasan keamanan. Gunakan prosedur untuk versi Edge Anda saat ini untuk melakukan pencadangan.Dengan demikian, Anda dapat memiliki rencana cadangan, jika pembaruan 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 dengan menggunakan perintah:/opt/apigee/apigee-service/bin/apigee-all status
- Pastikan Strategi Pemadatan Cassandra adalah
LeveledCompactionStrategy
Pastikan strategi pemadatan Cassandra ditetapkan keLeveledCompactionStrategy
, seperti yang dijelaskan dalam Mengubah strategi pemadatan Cassandra.
Langkah-langkah khusus yang perlu dipertimbangkan untuk upgrade
Untuk mengupgrade ke Edge untuk Private Cloud 4.52.02, pertimbangkan untuk menjalankan langkah spesifik guna mengupgrade software tertentu. Langkah-langkah yang diperlukan bergantung pada versi Anda saat ini. Lihat tabel di bawah ini untuk berbagai perangkat lunak yang memerlukan langkah-langkah tambahan. Bagian selanjutnya di halaman ini menyediakan diskusi terperinci dan langkah-langkah yang tepat untuk setiap perangkat lunak.
Versi saat ini | Software yang memerlukan langkah khusus untuk mengupgrade ke versi 4.52.02 |
---|---|
4.52.01 | Cassandra |
4.52.00 | Cassandra, Zookeeper, Qpid |
4.51.00 | Cassandra, Zookeeper, Qpid, Postgres |
Penerapan otomatis setelan properti
Jika Anda telah menetapkan properti dengan mengedit file .properties
di /opt/apigee/customer/application
, nilai tersebut akan dipertahankan oleh update.
Diperlukan upgrade ke Cassandra 3.11.16
Apigee Edge untuk Private Cloud 4.52.02 menyertakan upgrade Cassandra ke versi 3.11.16. Cassandra adalah komponen penting Apigee, dan upgrade ini juga mencakup update pada software driver di berbagai komponen runtime dan manajemen yang digunakan untuk membuat kueri dan menulis ke Cassandra.
Karena ini adalah upgrade besar, perubahan tertentu pada model data Apigee di Cassandra diperlukan untuk memastikan performa optimal di versi yang lebih baru. Meskipun perubahan ini tidak signifikan, proses upgrade akan mengganggu API pengelolaan tertentu, sehingga memengaruhi UI Apigee dan portal developer. Dokumen di bawah menentukan API persis yang tidak akan berfungsi dan menjelaskan langkah-langkah selama upgrade saat gangguan dimulai dan berakhir. Yang penting, tidak boleh ada gangguan pada traffic runtime selama upgrade.
Rollback tingkat tinggi
Terapkan Cassandra mengupgrade node satu per satu. Segera setelah node diupdate, perubahan skema tertentu akan diterapkan dan tidak dapat langsung di-roll back. Baca bagian tentang Melakukan rollback dengan teliti, karena berbagai teknik dapat digunakan bergantung pada seberapa banyak cluster yang telah diupgrade.
Jika Anda perlu melakukan roll back upgrade setelah seluruh cluster Cassandra diupgrade, satu-satunya opsi adalah memulihkan cadangan. Bersiaplah untuk hal ini dan pahami pemulihan cadangan Cassandra. Jika Anda dapat memulihkan snapshot tingkat VM lebih cepat daripada cadangan Apigee, gunakan snapshot VM untuk memulihkan VM Cassandra ke status sebelumnya.
Untuk detail selengkapnya, lihat bagian Melakukan rollback update Cassandra 3.11.16.
Mendokumentasikan API di portal developer
Portal developer Apigee Drupal menawarkan berbagai fitur untuk mendokumentasikan API Anda. Meskipun sebaiknya Anda tidak beralih dari portal developer berbasis Drupal 7, jika Anda masih menggunakannya dan memanfaatkan fitur SmartDocs, dokumen Menggunakan API SmartDocs berlaku untuk Anda. Jika Anda menggunakan versi portal developer yang lebih baru, dokumentasi API tidak akan terpengaruh selama upgrade ini.
Saat Anda mengupgrade Apigee ke versi 4.52.02, semua model API yang dibuat menggunakan fitur SmartDocs di portal developer Drupal 7 tidak akan otomatis dimigrasikan ke versi yang lebih baru. Anda diharapkan untuk mengekspor setiap model secara manual menggunakan portal developer dan mengimpornya lagi setelah menyelesaikan upgrade.
Terminologi yang digunakan di bagian berikut
Runtime: Runtime mencakup penanganan traffic proxy runtime. Ini mencakup semua operasi yang dilakukan oleh Router dan Pemroses Pesan Anda guna memproses permintaan API runtime secara efektif untuk proxy yang ada. Namun, hal ini tidak termasuk deployment proxy baru atau revisi proxy yang baru.
Pengelolaan: Pengelolaan mencakup administrasi sistem Apigee Edge Anda. Hal ini termasuk, tetapi tidak terbatas pada, deployment, modifikasi aplikasi, produk, server target, keystore, dll. Semua API pengelolaan (dan kliennya seperti Apigee UI dan portal developer) disertakan dalam cakupan ini.
Di setiap langkah di bawah ini, status runtime dan pengelolaan dijelaskan saat Anda melalui berbagai tahap prosedur upgrade. Perlu diperhatikan bahwa tidak ada dampak pada traffic runtime selama upgrade. Namun, ada gangguan pada sebagian kecil API pengelolaan dan fungsi portal developer.
Langkah 0: Status awal
- Cassandra di Apigee berjalan dengan versi 2.1.22.
- Edge untuk komponen Private Cloud 4.52.02:
- Server-manajemen yang berkomunikasi dengan Cassandra melalui protokol {i>thrift<i} yang lebih lama.
- Server runtime (Prosesor &Router Pesan) yang berkomunikasi dengan Cassandra melalui protokol thrift yang lebih lama.
Status runtime pada tahap ini | Status pengelolaan pada tahap ini |
---|---|
Runtime berfungsi sepenuhnya | Pengelolaan berfungsi sepenuhnya |
Langkah 1: Bersiap untuk upgrade
Langkah-langkah di bawah ini merupakan tambahan untuk file standar yang biasa Anda buat, seperti file konfigurasi standar Apigee untuk mengaktifkan upgrade komponen.
- Ubah Cassandra untuk menggunakan LeveledCompactionStrategy.
- Mencadangkan Cassandra menggunakan Apigee.
- Ambil snapshot VM dari node Cassandra (jika memungkinkan).
-
Buat file konfigurasi upgrade Cassandra pada setiap node Cassandra di
/opt/apigee/apigee-cassandra/cass_upgrade.conf
dengan konten berikut:# IP Address of node HOSTIP=10.0.0.1 # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication. CASS_USERNAME=<cassuser> # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication. CASS_PASSWORD=<casspass> # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped. CASS_PORT=9160 # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped. CASS_CQL_PORT=9042 # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped. # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly. CASS_TMP_DIR=/tmp/cass_upgrade_scripts
Jika file tidak dapat dibuat di/opt/apigee/apigee-cassandra/cass_upgrade.conf
, buat file/opt/silent.conf
dengan konten yang sama di setiap node Cassandra.
- Jika Anda menggunakan fitur SmartDocs dari portal developer Apigee Drupal 7, ekspor setiap model Anda dengan mendownloadnya dalam format JSON dari UI portal developer. Model-model ini perlu diimpor kembali ke Apigee setelah server pengelolaan diupdate.
- Pastikan port 9160 dan 9042 dapat diakses dari semua komponen Edge untuk Private Cloud 4.52.02 hingga node Cassandra jika belum ada. Rujuk ke Persyaratan port untuk informasi selengkapnya.
Langkah 2: Upgrade semua node Cassandra
-
Mengupgrade semua node Cassandra di semua region satu per satu. Jalankan perintah berikut pada setiap node:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
Setelah node diupdate, jalankan perintah berikut pada node untuk menjalankan beberapa validasi sebelum melanjutkan:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
-
Perintah di atas akan menampilkan sesuatu seperti:
Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Status runtime pada tahap ini | Status pengelolaan pada tahap ini |
---|---|
Runtime berfungsi sepenuhnya | Fungsi pengelolaan berikut menurun setelah Cassandra diupgrade: |
Langkah 3: Upgrade semua node Pengelolaan
Upgrade semua node Pengelolaan di semua region satu per satu:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Status Runtime | Status Pengelolaan |
---|---|
Runtime berfungsi sepenuhnya |
Management API mengalami penurunan performa:
|
Langkah 3a: [opsional] Impor SmartDocs yang sebelumnya diekspor
Setelah semua server pengelolaan diupgrade, Anda dapat impor model SmartDocs yang telah Anda ekspor pada Langkah 1. Anda juga dapat memutuskan untuk melakukannya nanti.
Status Runtime | Status Pengelolaan |
---|---|
Runtime berfungsi sepenuhnya | Pengelolaan berfungsi sepenuhnya |
Langkah 4: Upgrade semua node Runtime
Upgrade semua node Router dan Pemroses Pesan di semua region satu per satu:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Status Runtime | Status Pengelolaan |
---|---|
Runtime berfungsi sepenuhnya | Pengelolaan berfungsi sepenuhnya |
Langkah 5: Upgrade semua komponen Edge yang tersisa untuk Private Cloud 4.52.02
Upgrade semua node edge-qpid-server
dan edge-postgres-server
yang tersisa di semua region satu per satu.
Pada tahap ini, jika Anda meng-upgrade dari versi sebelum Edge untuk Private Cloud 4.52.01, dan mengikuti langkah tambahan untuk meng-upgrade Qpid atau Postgres, ikuti langkah-langkah masing-masing untuk meng-upgrade sama.
Status Runtime | Status Pengelolaan |
---|---|
Runtime berfungsi sepenuhnya | Pengelolaan berfungsi sepenuhnya |
Langkah 6: Langkah-langkah setelah upgrade
Jalankan perintah berikut pada setiap node Cassandra satu per satu setelah upgrade selesai:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Jalankan perintah berikut untuk menghapus tabel lama yang tidak digunakan dari cluster Cassandra. Sebelum layanan ini dijalankan, Anda tidak dapat menggunakan fitur tertentu dari Cassandra (seperti menyiapkan autentikasi baru - mekanisme autentikasi lama akan terus berfungsi). Perintah ini hanya dapat dijalankan pada 1 node dalam cluster saja:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
Selesaikan langkah 3a jika Anda belum melakukannya.
Status Runtime | Status Pengelolaan |
---|---|
Runtime berfungsi sepenuhnya | Pengelolaan berfungsi sepenuhnya |
Upgrade yang diperlukan ke Zookeeper 3.8.3
Meskipun Edge untuk Private Cloud 4.52.02 tidak menyertakan upgrade ke Zookeeper, jika Anda melakukan upgrade dari versi yang lebih lama dari 4.52.01, Anda harus mengikuti langkah-langkah untuk mengupgrade Zookeeper.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud versi 4.51.00 atau 4.52.00, lihat langkah-langkah dalam Upgrade yang diperlukan ke Zookeeper 3.8.3 untuk mengupgrade Zookeeper.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud versi 4.52.01, Anda seharusnya sudah menggunakan Zookeeper versi 3.8.3, dan Anda tidak perlu mengikuti langkah-langkah khusus untuk melakukan upgrade Zookeeper.
Upgrade yang diperlukan ke Postgres 14
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.51.00 ke 4.52.02, Anda harus mengikuti langkah-langkah untuk mengupgrade Postgres, meskipun Edge untuk Private Cloud 4.52.02 tidak menyertakan upgrade Postgres. Mengupgrade dari Edge untuk Private Cloud 4.51.00 ke 4.52.02 memerlukan langkah upgrade Postgres tambahan. Lihat bagian Upgrade yang diperlukan ke Postgres 14.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.52.00 atau 4.52.01 ke 4.52.02, Anda tidak perlu melakukan langkah upgrade Postgres tambahan.
Upgrade yang diperlukan ke Qpid J-Broker
Meskipun Edge untuk Private Cloud 4.52.02 tidak menyertakan upgrade ke QPID, jika Anda melakukan upgrade dari versi yang lebih lama dari 4.52.01, Anda harus mengikuti langkah-langkah untuk mengupgrade QPID.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.51.00 atau 4.52.00 ke 4.52.02, Anda perlu mengikuti langkah-langkah upgrade QPID tambahan. Lihat bagian Upgrade Qpid jika Anda melakukan upgrade dari versi 4.51.00 atau 4.52.00 ke 4.52.02.
- Jika Anda melakukan upgrade dari Edge untuk Private Cloud 4.52.01 ke 4.52.02, Anda seharusnya sudah menggunakan Qpid Broker versi terbaru, dan tidak ada langkah upgrade QPID tambahan yang diperlukan.
UI Edge Baru
Bagian ini mencantumkan pertimbangan mengenai UI Edge. Untuk informasi selengkapnya, lihat UI Edge baru untuk Private Cloud.
Menginstal UI Edge
Setelah Anda 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.02 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.02.sh
Edge untuk/tmp/bootstrap_4.52.02.sh
:curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
- Instal utilitas dan dependensi
apigee-service
Edge 4.52.02 dengan dengan menjalankan perintah berikut:sudo bash /tmp/bootstrap_4.52.02.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.02.
Pembaruan ke 4.52.02 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.02 lokal:
- Buat repo 4.52.02 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.02.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.02.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.02.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.02.sh
untuk/tmp/bootstrap_4.52.02.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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.02.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.02.
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.02:
- 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 komputer 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.