Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengupdate Apigee Edge 4.16.05.x ke rilis 4.16.05 terbaru

Edge for Private Cloud v. 4.16.05

Dokumen ini berisi prosedur yang Anda gunakan untuk mengupdate penginstalan 4.16.05 yang ada agar menggunakan RPM dan file dukungan terbaru dari Apigee. Prosedur ini menggunakan utilitas update.sh untuk melakukan update.

Versi Edge mana yang dapat Anda update ke rilis 4.16.05 terbaru

Anda hanya dapat mengupdate penginstalan Apigee Edge versi 4.16.05.x yang ada ke rilis 4.16.05 terbaru.

Jika saat ini Anda menjalankan Edge versi 4.16.01.0x atau yang lebih lama, Anda harus bermigrasi ke 4.16.05 terlebih dahulu. Lihat Mengupdate Apigee Edge 4.16.01 ke 4.16.05 untuk mengetahui informasi tentang cara bermigrasi ke versi 4.16.05.

Siapa yang dapat melakukan update

Pengguna yang menjalankan update harus sama dengan pengguna yang awalnya menginstal Edge, atau pengguna yang menjalankan sebagai root.

Setelah Anda menginstal RPM Edge, pengguna mana pun dapat mengonfigurasinya.

Persyaratan kapasitas disk untuk update

Pastikan Anda memiliki setidaknya 1 GB kapasitas disk kosong sebelum melakukan update.

Penyebaran otomatis setelan properti dari 4.16.05.x

Jika Anda telah menetapkan properti apa pun dengan mengedit file .properties di /opt/apigee/customer/application, nilai ini akan dipertahankan oleh update.

Prasyarat update

Penuhi prasyarat berikut sebelum mengupgrade Apigee Edge:

Cadangkan semua node
Sebelum melakukan update, sebaiknya lakukan pencadangan lengkap semua node untuk alasan keamanan. Gunakan prosedur untuk versi Edge Anda saat ini untuk melakukan pencadangan.

Dengan begitu, Anda akan memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
Pastikan Edge berjalan
Pastikan Edge aktif dan berjalan selama proses update menggunakan perintah:

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

Menangani update yang gagal

Jika update gagal, Anda dapat mencoba memperbaiki masalahnya, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari bagian terakhir yang ditinggalkan.

Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Proses Rollback 4.16.05.

Mencatat informasi update ke dalam log

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

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

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

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

Update tanpa periode nonaktif

Update tanpa periode nonaktif, atau update berkelanjutan, memungkinkan Anda mengupdate penginstalan Edge tanpa menonaktifkan Edge.

Update tanpa periode nonaktif hanya dapat dilakukan dengan konfigurasi 5 node dan yang lebih besar.

Kunci untuk melakukan upgrade tanpa periode nonaktif adalah dengan menghapus setiap Router, satu per satu, dari load balancer. Kemudian, Anda mengupdate Router dan komponen lainnya di mesin yang sama dengan Router, lalu menambahkan Router kembali ke load balancer.

Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan di bawah dalam "Urutan update mesin".
Jika sudah waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar tidak dapat dijangkau, seperti yang dijelaskan di bagian berikutnya "Membuat Router dan Message Processor tidak dapat dijangkau".
Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor di node yang sama.
Buat Router dapat dijangkau lagi.
Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
Lanjutkan update untuk mesin yang tersisa di penginstalan Anda.

Membuat Router dan Message Processor tidak dapat dijangkau

Dalam penyiapan produksi, Anda akan memiliki beberapa Router dan Message Processor untuk mencapai performa yang optimal dan Anda harus mengaktifkan/menonaktifkan keterjangkauan Router dan Message Processor ini sebelum/setelah update.

Panggilan API berikut mengonfigurasi node sebagai dapat dijangkau atau tidak dapat dijangkau:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

dengan UUID adalah UUID Pemroses Pesan atau Router, dan reachable ditetapkan ke true atau false.

Jika Anda perlu menentukan UUID Router, gunakan perintah cURL berikut:

> curl http://<routerIP>:8081/v1/servers/self

Jika Anda perlu menentukan UUID Message Processor, gunakan perintah cURL berikut:

> curl http://<mpIP>:8082/v1/servers/self

Perhatikan hal-hal berikut sebelum/setelah update:

Pada node Router dan Message Processor gabungan:
- Sebelum update – lakukan hal berikut:
  1. Buat Router tidak dapat dijangkau dengan menggunakan panggilan API yang ditampilkan di atas.
  2. Membuat Message Processor tidak dapat dijangkau.
- Setelah update - lakukan hal berikut:
  1. Buat Message Processor dapat dijangkau.
  2. Buat Router dapat dijangkau.
Pada satu node Router:
- Sebelum update, pastikan Router dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
Pada satu node Message Processor:
- Sebelum update, buat Message Processor tidak dapat dijangkau.
- Setelah update, buat Message Processor dapat dijangkau.

Menggunakan file konfigurasi senyap

Anda harus meneruskan file konfigurasi otomatis ke perintah update. File konfigurasi otomatis harus sama dengan yang Anda gunakan untuk menginstal Edge 4.16.05.

Prosedur untuk mengupdate 4.16.05 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

Jika ada, nonaktifkan cron job yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga update selesai.
Login ke node Anda sebagai root untuk menginstal RPM Edge
Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
Hapus semua cache Yum:
> sudo yum clean all
Download file bootstrap_4.16.05.sh Edge terbaru ke /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Perbarui utilitas dan dependensi apigee-service Edge:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.
Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Update pada apigee-service ini akan menginstal utilitas update.sh di /<inst_dir>/apigee/apigee-setup/bin.
Jalankan utilitas update pada node Anda sesuai urutan yang dijelaskan di bawah dalam "Urutan update mesin" di bawah:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee". Misalnya, tempatkan file di direktori /tmp pada node.

Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres
- ui = Edge UI
- all = mengupdate semua komponen di mesin (hanya digunakan untuk profil penginstalan Edge aio atau profil penginstalan API BaaS asa)
- e = ElasticSearch
- b = API BaaS Stack
- p = Portal API BaaS
- ebp = ElasticSearch, Stack API BaaS, dan Portal API BaaS di node yang sama
Uji update dengan menjalankan utilitas apigee-validate, Uji penginstalan.

Prosedur untuk mengupdate 4.16.05 dari repo lokal

Jika node Edge Anda berada di belakang firewall, atau dilarang mengakses repositori Apigee melalui Internet, Anda dapat melakukan update dari repositori lokal, atau mirror, dari repositori Apigee.

Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk mengupdate Edge dari repo lokal:

Buat file .tar dari repo, salin file .tar ke node, lalu update Edge dari file .tar.
Instal server web di node dengan repositori lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.

Untuk mengupdate dari repo 4.16.05 lokal:

Pastikan Anda memiliki repo 4.16.05 lokal seperti yang dijelaskan dalam Menginstal komponen Edge di node.
Perbarui repo lokal:
1. Download file bootstrap_4.16.05.sh Edge terbaru ke /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Lakukan sinkronisasi:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Untuk menginstal apigee-service dari file .tar:
1. Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.16.05.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:
  > tar -xzf apigee-4.16.05.tar.gz
  
  Perintah ini membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.
4. Login ke node Anda sebagai root untuk menginstal RPM Edge
  Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
5. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
6. Instal utilitas dan dependensi apigee-service Edge dari /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.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 dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal komponen Edge pada node.
2. Pada node jarak jauh, download file bootstrap_4.16.05.sh Edge ke /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS dari node repo.
3. Login ke node Anda sebagai root untuk menginstal RPM Edge
  Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
4. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
5. Di node jarak jauh, instal utilitas dan dependensi apigee-service Edge:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  dengan uName:pWord adalah nama pengguna dan sandi repo.
Jika ada, nonaktifkan cron job yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga update selesai.
Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Update pada apigee-service ini akan menginstal utilitas update.sh di <inst_dir>/apigee/apigee-setup/bin.
Jalankan utilitas update pada node Anda sesuai urutan yang dijelaskan di bawah dalam "Urutan update mesin" di bawah:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee". Misalnya, tempatkan file di direktori /tmp pada node.

Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres
- ui = Edge UI
- all = mengupdate semua komponen di mesin (hanya digunakan untuk profil penginstalan Edge aio atau profil penginstalan API BaaS asa)
- e = ElasticSearch
- b = API BaaS Stack
- p = Portal API BaaS
- ebp = ElasticSearch, Stack API BaaS, dan Portal API BaaS di node yang sama
Uji update dengan menjalankan utilitas apigee-validate, Menguji penginstalan.

Urutan update mesin

Urutan update mesin dalam penginstalan Edge sangat penting. Pertimbangan paling penting untuk update adalah:

Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
Anda harus mengupdate semua node qpidd dan postgresql sebelum mengupdate node Router dan Message Processor.
Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
Jika sebuah langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa mesin, lakukan langkah tersebut dalam urutan mesin yang ditentukan.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. File ini diperbarui saat Anda menentukan opsi "-c edge".
Setelah mengupdate node Router, Anda harus menghapus semua file dari direktori /opt/nginx/conf.d, lalu memulai ulang Router.