Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupdate Apigee Edge ke 4.16.09

Edge for Private Cloud v. 4.16.09

Versi Edge mana yang dapat Anda perbarui ke 4.16.09

Anda dapat mengupdate Apigee Edge versi 4.16.01.0x dan 4.16.05.x ke 4.16.09.

Jika Anda memiliki versi Edge sebelum versi 4.16.01, Anda harus bermigrasi terlebih dahulu ke versi 4.16.01.x lalu perbarui ke versi 4.16.09.

Siapa yang dapat melakukan pembaruan

Pengguna yang menjalankan pembaruan harus sama dengan pengguna yang awalnya menginstal Edge, atau pengguna berjalan sebagai {i>root<i}.

Setelah Anda menginstal RPM Edge, semua pengguna dapat mengonfigurasinya.

Upgrade yang diperlukan ke Java JDK Versi 8

Rilis Edge ini mengharuskan Anda menginstal Java JDK versi 8 di semua Edge untuk memproses node. Anda dapat menginstal Oracle JDK 8 atau OpenJDK 8. Jika Java JDK 8 tidak diinstal skrip pembaruan dapat menginstalnya untuk Anda.

Sebagai bagian dari update untuk Java 8, beberapa cipher TLS tidak lagi tersedia di Oracle JDK 8. Sebagai daftar lengkapnya, lihat bagian "Suite Cipher Nonaktif Default" di http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Menurunkan Zookeeper jika memperbarui dari 4.16.01

Versi RPM Zookeeper di Edge untuk Private Cloud 4.16.01 adalah apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Pada versi Edge berikutnya, versi Zookeeper selanjutnya diubah kembali menjadi apigee-zookeeper-3.4.5-0.0.94x. Hal ini mencegah yum mengupgrade Zookeeper ke versi yang lebih baru dari 4.16.01. Cara melakukan corrct situasi ini adalah menjalankan yum downgrade apigee-zookeeper sebelum mengupdate Zookeeper.

Anda dapat memeriksa versi Zookeeper dengan menggunakan perintah berikut:

> rpm -qa |grep apigee-zookeeper

Jika perintah ini menampilkan versi Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Selanjutnya, Anda harus melakukan downgrade.

Penyebaran properti otomatis pengaturan

Jika Anda telah menetapkan properti dengan mengedit file .properties di /opt/apigee/customer/application, nilai tersebut dipertahankan oleh pembaruan.

Perbarui prasyarat

Selesaikan 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.

Dengan demikian, Anda dapat memiliki rencana cadangan, jika pembaruan ke versi baru tidak apakah 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:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Menangani update yang gagal

Jika gagal update, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan update.sh untuk mencoba lagi perintah. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari titik terakhir terakhir dibuka nonaktif.

Jika kegagalan tersebut mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Proses Rollback 4.16.09 untuk mengetahui informasi selengkapnya.

Informasi pembaruan logging

Secara default, antarmuka update.sh utilitas menulis informasi log ke:

/opt/apigee/var/log/apigee-setup/update.log

Jika pengguna yang menjalankan utilitas update.sh tidak memiliki akses ke pada direktori tersebut, komputer akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

Jika pengguna tidak memiliki akses ke /tmp, utilitas update.sh akan gagal.

Upgrade yang diperlukan ke Postgres 9.4

Rilis Edge ini menyertakan upgrade ke Postgres 9.4. Sebagai bagian dari peningkatan tersebut, semua Data Postgres dimigrasikan ke Postgres 9.4.

Selama proses update, saat node Postgres tidak aktif untuk update, data analisis masih ditulis ke {i>node<i} Qpid. Setelah node Postgres diperbarui dan kembali online, analisis data kemudian dikirim ke node Postgres.

Node standby Postgres tambahan diperlukan jika Anda harus melakukan roll back update untuk alasan. Jika Anda harus melakukan roll back update, node standby Postgres baru akan menjadi master Node postgres setelah rollback. Oleh karena itu, saat Anda menginstal node standby Postgres baru, harus berada di {i>node<i} yang memenuhi semua persyaratan perangkat keras server Postgres, seperti Penginstalan Edge Persyaratan.

Menginstal Postgres baru node standby

Prosedur ini akan membuat server standby Postgres pada node baru. Pastikan Anda menginstal Server standby postgres untuk Edge versi yang sudah ada (4.16.01 atau 4.16.05), bukan untuk versi 4.16.09.

Untuk melakukan penginstalan, gunakan file konfigurasi yang sama dengan yang Anda gunakan untuk menginstal versi saat ini Edge.

Untuk membuat node standby Postgres baru:

Pada master Postgres saat ini, edit elemen /opt/apigee/customer/application/postgresql.properties untuk menyetel token berikut. Jika file tersebut tidak ada, buat:

conf_pg_hba_replication.connection=host replikasi apigee existing_slave_ip/32 trust\ \nreplikasi host apigee new_slave_ip/32 trust

dengan existing_slave_ip adalah alamat IP Postgres saat ini server standby dan new_slave_ip adalah alamat IP dari mode standby baru {i>node<i}.
Memulai ulang apigee-postgresql di master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Pastikan node standby baru telah ditambahkan dengan menampilkan /opt/apigee/apigee-postgresql/conf/pg_hba.conf file pada master. Anda akan melihat baris berikut dalam file tersebut:
apigee replikasi host existing_slave_ip/32 trust
replikasi host apigee new_slave_ip/32 trust
Instal server standby Postgres baru:
1. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini untuk menentukan berikut ini:
  
  # alamat IP saat ini master:
  PG_MASTER=192.168.56.103
  # alamat IP node standby baru
  PG_STANDBY=192.168.56.102
2. Nonaktifkan SELinux seperti yang dijelaskan di bagian Menginstal Edge utilitas apigee-setup.
3. Download file Edge bootstrap_4.16.05.sh ke /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Catatan: Jika Anda mengupdate dari versi 4.16.01, download file bootstrap.sh Edge.
4. Instal utilitas dan dependensi layanan Edge apigee:
  > {i>sudo bash<i} /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Gunakan apigee-service untuk menginstal utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Instal Postgres:
  > {i>/opt/apigee/apigee-setup/bin/setup.sh -p ps -f<i} configFile
7. Di node standby baru, jalankan perintah berikut:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-standby
  
  Validasi bahwa perangkat tersebut menyatakan mode standby.

Menonaktifkan Postgres {i>node<i}

Setelah update selesai, hentikan node standby baru:

Pastikan Postgres sedang berjalan:
> /opt/apigee/apigee-service/bin/apigee-all status

Jika Postgres tidak berjalan, mulai:
> /opt/apigee/apigee-service/bin/apigee-all start
Dapatkan UUID node standby baru dengan menjalankan perintah cURL berikut di node baru node standby:
> {i>curl -u<i} sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Anda akan melihat UUID node di akhir output, dalam bentuk:
"jenis" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Hentikan node standby baru dengan menjalankan perintah berikut pada node standby baru:
> /opt/apigee/apigee-service/bin/apigee-semua perhentian
Pada node master Postgres, edit /opt/apigee/customer/application/postgresql.properties untuk menghapus node standby baru dari conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replikasi apigee existing_slave_ip/32 trust
Mulai ulang apigee-postgresql pada master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Pastikan node standby yang baru telah dihapus dengan menampilkan /opt/apigee/apigee-postgresql/conf/pg_hba.conf file pada master. Anda hanya akan melihat baris berikut dalam file tersebut:
apigee replikasi host existing_slave_ip/32 trust
Hapus UUID node standby dari ZooKeeper dengan membuat pengelolaan Edge berikut Panggilan API pada node Server Pengelolaan:
> {i>curl -u<i} sysAdminEmail:password -X HAPUS http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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 instalasi Anda seperti dijelaskan di bawah ini dalam "Pesanan update mesin".
Ketika tiba waktunya untuk memperbarui {i>Router<i}, pilih salah satu {i>Router<i} dan membuatnya tidak dapat dijangkau, yang dijelaskan dalam Mengaktifkan/Menonaktifkan Jangkauan Server (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 hal berikut sebelum/sesudah pembaruan:

Pada gabungan node Router dan Pemroses Pesan:
- Sebelum update – lakukan hal berikut:
  1. Membuat Router tidak dapat dijangkau.
  2. Membuat Pemroses Pesan tidak dapat dijangkau.
- Setelah update - lakukan hal berikut:
  1. Buat Pemroses Pesan dapat dijangkau.
  2. Buat Router dapat dijangkau.
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.16.01 atau 4.16.05.

Prosedur untuk Mengupdate ke 4.16.09 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk memperbarui komponen Edge pada node:

Jika saat ini Anda menggunakan replikasi master-standby Postgres, instal Postgres baru node standby seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
Jika ada, nonaktifkan tugas CRON apa pun yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga setelah pembaruan selesai.
Login ke node Anda sebagai root untuk menginstal RPM Edge.
Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan Edge konfigurasi tanpa akses {i>root<i}.
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal Edge apigee-setup utilitas.
Download file bootstrap_4.16.09.sh Edge 4.16.09 ke /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Instal utilitas apigee-service Edge 4.16.09 dan dependensi:
> {i>sudo bash<i} /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.

Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, Anda 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 = Melanjutkan tanpa menginstal Java
T = Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
Menggunakan apigee-service untuk perbarui utilitas apigee-setup:
1. Jika Anda menginstal 4.16.01 dengan mengupgrade Edge versi 4.15.07.0x, Anda harus menginstal utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Perintah ini akan menginstal utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
  
  Jika Anda sudah menginstal utilitas apigee-setup, update Ini:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jika Anda menginstal 4.16.01 secara langsung, artinya Anda tidak melakukan upgrade dari 4.15.07.0x, Anda harus mengupdate utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Update untuk apigee-service ini akan menginstal Utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
3. Jika Anda menginstal 4.16.05 secara langsung atau melalui update, Anda harus mengupdate utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Update untuk apigee-service ini akan menginstal Utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
Bergantung pada versi Edge Anda saat ini, Anda harus menginstal atau memperbarui apigee-validate di Server Pengelolaan.
1. Jika saat ini Anda menggunakan Edge 4.16.05: perbarui utilitas apigee-validate di Server Pengelolaan:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Jika saat ini Anda menggunakan Edge 4.16.01: instal utilitas apigee-validate di Server Pengelolaan:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Catatan: Jika Anda telah menginstal utilitas apigee-validate di Message Saat menginstal 4.16.01, Anda dapat mengupdate node prosesor dengan menggunakan perintah berikut di node tersebut:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Namun, mulai 4.16.05 dan yang lebih baru, Apigee menyarankan agar Anda menginstal dan menjalankan Utilitas apigee-validate aktif di Server Pengelolaan.
3. Jika Anda mengupgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke aplikasi utilitas apigee-validate. Di beberapa rilis Edge 4.16.01, file konfigurasi yang digunakan oleh apigee-validate memerlukan hal berikut properti:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  WILAYAH=dc-1
  
  Dalam rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
Mengupdate apigee-provision utilitas:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Provide
Jalankan utilitas pembaruan pada simpul Anda dengan urutan yang dijelaskan di bawah ini pada "Urutan mesin perbarui" di bawah ini:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Satu-satunya persyaratan pada file konfigurasi adalah bahwa file konfigurasi harus dapat diakses atau dapat dibaca oleh "apigee" .

Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar kemungkinan meliputi:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Prosesor Pesan, Router, Server QPID, Server Postgres
ui = UI Edge
all = mengupdate semua komponen di komputer (hanya gunakan untuk profil penginstalan Edge aio atau penginstalan API BaaS asa (profil)
e = ElasticSearch
b = Stack BaaS API
p = Portal BaaS API
ebp = ElasticSearch, API BaaS Stack, dan API BaaS Portal di node yang sama
Uji pembaruan dengan menjalankan utilitas apigee-validate di Server Pengelolaan, yang dijelaskan dalam Menguji penginstalan.
Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas Menghentikan node Postgres.

Untuk melakukan rollback update nanti, gunakan prosedur yang dijelaskan dalam Proses Rollback 4.16.09.

Prosedur untuk memperbarui ke 4.16.09 dari repositori

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.16.09 lokal:

Jika saat ini Anda menggunakan replikasi master-standby Postgres, instal Postgres baru node standby seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
Buat repo 4.16.09 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal the Edge apigee-setup utilitas.
Catatan: Jika sudah memiliki repositori 4.16.01 atau 4.16.05, Anda dapat menambahkan 4.16.09, seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal penyiapan apigee Edge aplikasi utilitas.
Untuk menginstal apigee-service dari file .tar:
1. Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
3. Pada node baru, untar file ke direktori /tmp:
  > {i>tar -xzf<i} apigee-4.16.09.tar.gz
  
  Perintah ini membuat direktori baru, bernama {i>repos<i}, di direktori yang berisi file {i> .tar<i} . Misalnya, {i> /tmp/repos<i}.
4. Instal utilitas dan dependensi apigee-service Edge dari /tmp/repos:
  > {i>sudo bash<i} /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
Untuk menginstal apigee-service menggunakan server web Nginx:
1. Konfigurasikan server web Nginx seperti yang dijelaskan di bagian "Menginstal dari repo menggunakan Nginx webserver" di Menginstal Edge utilitas apigee-setup.
2. Pada {i>node<i} jarak jauh, unduh file Edge bootstrap_4.16.09.sh ke /tmp/bootstrap_4.16.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  
  dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas dan remoteRepo adalah alamat IP atau nama DNS repo Anda.
3. Di node jarak jauh, instal utilitas dan dependensi layanan Edge apigee:
  > {i>sudo bash<i} /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  dengan uName:pWord adalah nama pengguna dan sandi repo.
Menggunakan apigee-service untuk perbarui utilitas apigee-setup:
1. Jika Anda menginstal 4.16.01 dengan mengupgrade Edge versi 4.15.07.0x, Anda harus menginstal utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Perintah ini akan menginstal utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
  
  Jika Anda sudah menginstal utilitas apigee-setup, update Ini:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jika Anda menginstal 4.16.01 secara langsung, artinya Anda tidak melakukan upgrade dari 4.15.07.0x, Anda harus mengupdate utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Update untuk apigee-service ini akan menginstal Utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
3. Jika Anda menginstal 4.16.05 secara langsung atau melalui update, Anda harus mengupdate utilitas apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Update untuk apigee-service ini akan menginstal Utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
Bergantung pada versi Edge Anda saat ini, Anda harus menginstal atau memperbarui apigee-validate di Server Pengelolaan.
1. Jika saat ini Anda menggunakan Edge 4.16.05: perbarui utilitas apigee-validate di Server Pengelolaan:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Jika saat ini Anda menggunakan Edge 4.16.01: instal apigee-validate di Server Pengelolaan:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Catatan: Jika Anda telah menginstal utilitas apigee-validate di Message Saat menginstal 4.16.01, Anda dapat mengupdate node prosesor dengan menggunakan perintah berikut di node tersebut:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Namun, mulai 4.16.05 dan yang lebih baru, Apigee menyarankan agar Anda menginstal dan menjalankan utilitas apigee-validate di Server Pengelolaan.
3. Jika Anda mengupgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke aplikasi utilitas apigee-validate. Di beberapa rilis Edge 4.16.01, file konfigurasi yang digunakan oleh apigee-validate memerlukan hal berikut properti:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  WILAYAH=dc-1
  
  Dalam rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
Mengupdate apigee-provision utilitas:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Provide
Jalankan utilitas pembaruan pada {i>node<i} Anda sesuai urutan yang dijelaskan di bawah ini pada "Urutan mesin memperbarui" di bawah:
> {i>/opt/apigee/apigee-setup/bin/update.sh -c component -f<i} configFile

Satu-satunya persyaratan pada file konfigurasi adalah bahwa file konfigurasi harus dapat diakses atau dapat dibaca oleh "apigee" .

Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar kemungkinan meliputi:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Prosesor Pesan, Router, Server QPID, Server Postgres
ui = UI Edge
all = mengupdate semua komponen di komputer (hanya gunakan untuk profil penginstalan Edge aio atau penginstalan API BaaS asa (profil)
e = ElasticSearch
b = Stack BaaS API
p = Portal BaaS API
ebp = ElasticSearch, API BaaS Stack, dan API BaaS Portal di node yang sama
Uji pembaruan dengan menjalankan utilitas apigee-validate di Server Pengelolaan, yang dijelaskan dalam Menguji penginstalan.
Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas Menghentikan node Postgres.

Untuk melakukan rollback update nanti, gunakan prosedur yang dijelaskan dalam Proses Rollback 4.16.09.

Urutan update mesin

Urutan Anda memperbarui komputer dalam penginstalan Edge adalah hal penting. Paling sering pertimbangan penting untuk pembaruan adalah:

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 "-c edge" untuk memperbarui semuanya perangkat lain di waktu yang sama.
Jika sebuah langkah menentukan bahwa itu harus dilakukan pada beberapa komputer, lakukan dalam urutan mesin tertentu.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. Ini diperbarui ketika Anda menentukan "-c tepi" sebelumnya.

Untuk 1-host mandiri penginstalan

Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper:
> downgrade yum apigee-zookeeper
Perbarui Cassandra dan ZooKeeper:
> {i>/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f<i} configFile
Perbarui qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Perbarui LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Hentikan Postgres Server, server Qpid, dan PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server berhenti
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
Perbarui postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Perbarui database Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Update komponen Edge yang tersisa:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Mengupdate UI Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk mandiri 2 host penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di komputer 1:
> downgrade yum apigee-zookeeper
Perbarui Cassandra dan ZooKeeper pada komputer 1:
> {i>/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f<i} configFile
Perbarui qpidd di komputer 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Perbarui LDAP di komputer 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Update komponen Edge di perangkat 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Update UI di perangkat 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Perbarui postgresql di komputer 2:
1. Hentikan Postgres Server, server Qpid, dan postgresql:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
2. Perbarui postgresql:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
3. Perbarui database Postgres:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
4. Update komponen Edge di perangkat 2 dan mesin 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Update komponen Edge di perangkat 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Untuk 5 host yang dikelompokkan penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di Menginstal Postgres baru node standby.
Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper pada komputer 1, 2, dan 3.
> downgrade yum apigee-zookeeper
Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
> {i>/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f<i} configFile
Perbarui qpidd di komputer 4 dan 5:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Perbarui LDAP di komputer 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Update komponen Edge di perangkat 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Update UI di perangkat 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Mengupdate komputer 4 dan 5:
1. Hentikan server Postgres dan server Qpid di komputer 4:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
2. Hentikan server Postgres, server Qpid, dan postgresql di komputer 5:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Hentikan server Postgres dan postgresql di node standby baru yang Anda tambahkan rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
4. Update postgresql di komputer 4:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
5. Perbarui database Postgres di komputer 4 (khusus master Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
6. Update postgresql di komputer 5:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. Mulai server Postgres dan server Qpid di komputer 4 dan 5:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server mulai
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
8. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 5.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} setup-replication-on-standby -f configFile
9. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang sama pada kedua server untuk memastikan replikasi:
  
  Pada komputer 4, node master, jalankan:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-master
  
  Validasi bahwa dikatakan sebagai master.
  
  Di komputer 5, node standby:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-standby
  
  Validasi bahwa perangkat tersebut menyatakan mode standby.
Memperbarui komponen Edge di komputer 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas dalam Menghentikan Postgres node.

Untuk 9 host yang dikelompokkan penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di Menginstal Postgres baru node standby.
Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper pada komputer 1, 2, dan 3.
> enak mendowngrade apigee-zookeeper
Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Perbarui qpidd di komputer 6 dan 7:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Perbarui LDAP di komputer 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Update komponen Edge di perangkat 6, 7, 1, 4, dan 5 dalam urutan tersebut:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Update UI di perangkat 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Mengupdate komputer 8 dan 9:
1. Hentikan server Postgres di komputer 8:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Hentikan server Postgres dan postgresql di komputer 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Menghentikan server Qpid di komputer 6 dan 7:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. Hentikan server Postgres dan postgresql di node standby baru yang Anda tambahkan rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. Update postgresql di komputer 8:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. Perbarui database Postgres di komputer 8 (khusus master Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Update postgresql di komputer 9:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Mulai server server Postgres di komputer 8 dan 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Mulai server server Qpid di komputer 6 dan 7:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 9.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} setup-replication-on-standby -f configFile
11. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang sama pada kedua server untuk memastikan replikasi:
  Pada komputer 8, node master, jalankan:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-master
  
  Validasi bahwa dikatakan sebagai master.
  
  Di komputer 9, node standby:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-standby
  
  Validasi bahwa perangkat tersebut menyatakan mode standby.
Memperbarui komponen Edge di komputer 8 dan 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas dalam Menghentikan Postgres node.

Untuk 13 host yang dikelompokkan penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di Menginstal Postgres baru node standby.
Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper pada komputer 1, 2, dan 3.
> enak mendowngrade apigee-zookeeper
Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Perbarui qpidd di komputer 12 dan 13:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Update LDAP di komputer 4 dan 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Update komponen Edge pada perangkat 12, 13, 6, 7, 10, dan 11 dalam urutan tersebut:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Mengupdate UI di komputer 6 dan 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Mengupdate komputer 8 dan 9:
1. Hentikan server Postgres di komputer 8:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Hentikan server Postgres dan postgresql di komputer 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Hentikan server Qpid di komputer 12 dan 13:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. Hentikan server Postgres dan postgresql di node standby baru yang Anda tambahkan rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. Update postgresql di komputer 8:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. Perbarui database Postgres di komputer 8 (khusus master Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Update postgresql di komputer 9:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Mulai server Postgres di komputer 8 dan 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Mulai server server Qpid pada komputer 12 dan 13:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 9.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} setup-replication-on-standby -f configFile
11. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang sama pada kedua server untuk memastikan replikasi:
  Pada komputer 8, node master, jalankan:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-master
  
  Validasi bahwa dikatakan sebagai master.
  
  Di komputer 9, node standby:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-standby
  
  Validasi bahwa perangkat tersebut menyatakan mode standby.
Memperbarui komponen Edge di komputer 8 dan 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas dalam Menghentikan Postgres node.

Untuk 12 host yang dikelompokkan penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di Menginstal Postgres baru node standby.
Perbarui Cassandra dan ZooKeeper:
1. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper pada komputer 1, 2, dan 3 di Pusat Data 1:
  > enak mendowngrade apigee-zookeeper
2. Pada komputer 1, 2, dan 3 di Pusat Data 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di komputer 7, 8, dan 9 di Pusat Data 2:
  > enak mendowngrade apigee-zookeeper
4. Pada komputer 7, 8, dan 9 di Pusat Data 2
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Perbarui qpidd:
1. Mesin 4, 5 di Pusat Data 1
  > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
2. Mesin 10, 11 di Pusat Data 2
  > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Perbarui LDAP:
1. Mesin 1 di Pusat Data 1
  > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
2. Mesin 7 di Pusat Data 2
  > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Update komponen Edge:
1. Mesin 4, 5, 1, 2, 3 di Pusat Data 1
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
2. Mesin 10, 11, 7, 8, 9 di Pusat Data 2
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Update UI:
1. Mesin 1 di Pusat Data 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
2. Mesin 7 di Pusat Data 2:
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Update mesin 6 di Pusat Data 1 dan 12 di Pusat Data 2:
1. Hentikan server Postgres di komputer 6:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Hentikan server Postgres dan postgresql di komputer 12:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Menghentikan server Qpid di komputer 4, 5, 10, dan 11:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. Hentikan server Postgres dan postgresql di node standby baru yang Anda tambahkan rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server berhenti
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. Update postgresql di komputer 6:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. Perbarui database Postgres di komputer 6 (khusus master Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Update postgresql di komputer 12:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Mulai server server Postgres di komputer 6 dan 12:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Mulai server server Qpid di komputer 4, 5, 10, dan 11:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 12.
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} setup-replication-on-standby -f configFile
11. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang sama pada kedua server untuk memastikan replikasi:
  Pada komputer 6, node master, jalankan:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-master
  
  Validasi bahwa dikatakan sebagai master.
  
  Di komputer 12, node standby:
  > {i>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql<i} postgres-check-standby
  
  Validasi bahwa perangkat tersebut menyatakan mode standby.
Update komponen Edge di perangkat 6 dan 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas dalam Menghentikan Postgres node.

Untuk BaaS API 7 host penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Update Cassandra di komputer 5, 6, dan 7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Mengupdate ElasticSearch dan API BaaS Stack pada perangkat 1, 2, dan 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
Update Portal BaaS API di komputer 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Untuk BaaS API 10 host penginstalan

Lihat Topologi Penginstalan untuk daftar topologi Edge dan nomor node.

Update Cassandra di komputer 8, 9, dan 10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Memperbarui ElasticSearch di perangkat 1, 2, dan 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
Update API BaaS Stack pada komputer 4, 5, dan 6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
Update Portal BaaS API di komputer 7:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Untuk penginstalan non-standar

Jika Anda memiliki penginstalan non-standar, update komponen Edge pada berikut:

ZooKeeper
Cassandra
qpidd
LDAP
Tepi, yang berarti "-c tepi" profil pada semua {i>node<i} dengan urutan: node dengan server Qpid tetapi bukan server Postgres, Server Pengelolaan, Pemroses Pesan, dan {i>Router<i}.
Catatan: Jika node memiliki server Qpid dan server Postgres yang terinstal, jalankan "-c tepi" sebagai bagian dari langkah 8.
UI Edge
{i>postgresql<i} di master Postgres, termasuk upgrade.
postgresql di standby Postgres.
Tepi, yang berarti "-c tepi" profil di semua node Qpid dan Postgres gabungan, atau pada node Postgres mandiri.