Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupdate Apigee Edge 4.16.09 hingga 4.17.09

Edge for Private Cloud v. 4.17.09

Versi Edge mana yang dapat Anda update ke 4.17.09

Anda dapat mengupdate Apigee Edge versi 4.16.09.0x ke 4.17.09 menggunakan prosedur ini.

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

Siapa yang dapat melakukan update

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

Setelah Anda menginstal RPM Edge, semua pengguna dapat mengonfigurasinya.

Komponen mana yang harus Anda perbarui

Anda harus mengupdate semua komponen Edge. Edge tidak mendukung penyiapan yang berisi komponen dari beberapa versi.

Upgrade yang diperlukan ke Qpid 1.35

Rilis ini berisi update yang diperlukan ke Qpid 1.35. Sebagai bagian dari update node Qpid, Anda harus:

Cegah Router dan Prosesor Pesan menulis ke node Qpid untuk sementara dengan memblokir port 5672 pada node Qpid. Anda dapat menggunakan perintah berikut untuk memblokir port ini di node Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
Tunggu hingga antrean Qpid kosong dari pesan untuk memastikan bahwa node Qpid telah memproses semua pesan sebelum update. Gunakan perintah berikut untuk memastikan bahwa antrean pesan Qpid kosong:
> qpid-stat -q
Update node Qpid.
Berhenti memblokir port 5672 pada node Qpid untuk mengizinkan akses dari Router dan Pemroses Pesan. Anda dapat menggunakan perintah berikut untuk berhenti memblokir port ini:
> sudo iptables -F

Perlu diperhatikan bahwa jika menggunakan iptables untuk aturan lain, Anda dapat menggunakan opsi -D untuk membatalkan perubahan tertentu:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP

Proses ini dijelaskan secara mendetail di bawah untuk setiap topologi Edge.

Diperlukan untuk mengaktifkan repo EPEL

Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge. Perintah yang Anda gunakan bergantung pada versi RedHat/CentOS Anda:

Untuk RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
Untuk RedHat/CentOS/Oracle 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Penambahan parameter konfigurasi SMTPMAILFROM yang diperlukan

Edge 4.17.05 menambahkan parameter baru yang diperlukan ke file konfigurasi yang digunakan saat Anda mengaktifkan server SMTP. Jika mengupdate dari versi 4.17.01, Anda harus menetapkan SMTPMAILFROM dalam file konfigurasi saat mengaktifkan server SMTP.

API BaaS versi 4.17.09 juga menambahkan dukungan untuk properti SMTPMAILFROM. Saat mengupdate API BaaS, Anda harus menetapkan SMTPMAILFROM dalam file konfigurasi.

Parameter ini memiliki bentuk:

SMTPMAILFROM="My Company <myco@company.com>"

Diperlukan jika mengupdate saat menggunakan autentikasi eksternal

Anda dapat mengintegrasikan layanan direktori eksternal ke dalam penginstalan Private Cloud Apigee Edge yang ada. Fitur ini dirancang untuk berfungsi dengan layanan direktori apa pun yang mendukung LDAP, seperti Active Directory, OpenLDAP, dan lainnya. Solusi LDAP eksternal memungkinkan administrator sistem mengelola kredensial pengguna dari layanan pengelolaan direktori terpusat, yang bersifat eksternal terhadap sistem seperti Apigee Edge yang menggunakannya.

Lihat Konfigurasi Autentikasi Eksternal untuk mengetahui informasi selengkapnya.

Jika autentikasi eksternal diaktifkan, sebagian besar pelanggan menggunakan kolom nama akun SAM Active Directory sebagai nama pengguna untuk autentikasi, bukan alamat email yang digunakan oleh server OpenLDAP Edge.

Jika Anda telah berintegrasi dengan layanan direktori eksternal, tambahkan baris berikut ke file konfigurasi saat mengupdate Edge ke 4.17.09:

IS_EXTERNAL_AUTH="true"

Baris ini mengonfigurasi Edge untuk mendukung nama akun, bukan alamat email, sebagai nama pengguna.

Penerusan otomatis setelan properti

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

Memperbarui prasyarat

Pastikan prasyarat berikut terpenuhi 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.

Hal ini memungkinkan Anda memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan benar. 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

Menangani update yang gagal

Jika terjadi kegagalan update, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari tempat terakhir update berhenti.

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

Mencatat informasi pembaruan

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, aplikasi 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 menghentikan Edge.

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

Kunci untuk mengupgrade tanpa periode nonaktif adalah dengan menghapus setiap Router, satu per satu, dari load balancer. Selanjutnya, update Router dan komponen lainnya di mesin yang sama dengan Router, lalu tambahkan kembali Router ke load balancer.

Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan di bawah dalam "Urutan update mesin".
Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan Kemampuan Dijangkau Server (Pemroses Pesan/Router).
Update Router yang dipilih dan semua komponen Edge lainnya di komputer yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor di node yang sama.
Buat Router dapat dijangkau lagi.
Ulangi langkah 2 sampai 4 untuk Router lainnya.
Lanjutkan update untuk mesin yang tersisa dalam penginstalan Anda.

Lakukan hal berikut sebelum/setelah update:

Pada node Router dan Message Processor gabungan:
- 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 diupdate, pastikan Router dapat dijangkau.
Pada satu node Pemroses Pesan:
- Sebelum update, buat Pemroses Pesan tidak dapat dijangkau.
- Setelah diupdate, 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.09.

Prosedur untuk mengupdate ke 4.17.09 di node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge di node:

Jika ada, nonaktifkan tugas CRON yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga update selesai.
Login ke node sebagai root untuk menginstal RPM Edge.
Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
Instal yum-utils dan yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
Aktifkan repo EPEL seperti yang dijelaskan di atas.
Jika Anda menginstal di AWS, jalankan perintah yum-configure-manager berikut:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Download file bootstrap_4.17.09.sh Edge 4.17.09 ke /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Instal utilitas dan dependensi apigee-service Edge 4.17.09:
> sudo bash /tmp/bootstrap_4.17.09.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.

Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, aplikasi 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 utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Update utilitas apigee-validate di Server Pengelolaan:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Update utilitas apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Jalankan utilitas update di node Anda dalam urutan yang dijelaskan di bawah dalam "Urutan update komputer" 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".

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, Pemroses Pesan, Router, Server QPID, Server Postgres
ui = UI Edge
all = mengupdate semua komponen di komputer (hanya gunakan untuk profil penginstalan aio Edge atau profil penginstalan asa API BaaS)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack, dan API BaaS Portal di node yang sama
Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

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

Prosedur untuk mengupdate ke 4.17.09 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 duplikasi repo 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 update Edge dari file .tar.
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 Anda sendiri.

Untuk memperbarui dari repo 4.17.09 lokal:

Buat repo 4.17.09 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
Catatan: Jika sudah memiliki repo 4.16.09, Anda dapat menambahkan repo 4.17.09 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
Untuk menginstal apigee-service dari file .tar:
1. Di node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.17.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. Di node baru, ekstrak file ke direktori /tmp:
  > tar -xzf apigee-4.17.09.tar.gz
  
  Perintah ini akan membuat direktori baru, bernama repo, di direktori yang berisi file .tar. Misalnya /tmp/repos.
4. Instal utilitas dan dependensi layanan apigee Edge dari /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Perhatikan bahwa Anda menyertakan jalur ke direktori repo dalam perintah ini.
Untuk menginstal apigee-service menggunakan server web Nginx:
1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Install from the repo using the Nginx webserver" di Menginstal utilitas penyiapan apigee Edge.
2. Di node jarak jauh, download file bootstrap_4.17.09.sh Edge ke /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.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. Di node jarak jauh, instal utilitas dan dependensi layanan apigee Edge:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  dengan uName:pWord adalah nama pengguna dan sandi repo.
Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Perbarui utilitas apigee-validate di Server Pengelolaan.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Update utilitas apigee-Provide:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Provide
Jalankan utilitas update di node Anda dalam 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".

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, Pemroses Pesan, Router, Server QPID, Server Postgres
ui = UI Edge
all = mengupdate semua komponen di komputer (hanya gunakan untuk profil penginstalan aio Edge atau profil penginstalan asa API BaaS)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack, dan API BaaS Portal di node yang sama
Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

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

Urutan update mesin

Urutan Anda mengupdate mesin dalam penginstalan Edge sangatlah penting. Pertimbangan paling penting untuk update adalah:

Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
Untuk mesin 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 langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa komputer, lakukan dalam urutan komputer yang ditentukan.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. Nilai ini diperbarui saat Anda menentukan opsi "-c edge".