Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupdate Apigee Edge 4.17.01 hingga 4.17.05

Edge for Private Cloud v. 4.17.05

Versi Edge mana yang dapat Anda perbarui ke 4.17.05

Anda dapat mengupdate Apigee Edge versi 4.17.01.0x ke 4.17.05 menggunakan prosedur ini.

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

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.

Komponen mana yang harus Anda update

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

Penyebaran properti otomatis pengaturan

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

Penambahan SMTMailFROM yang diperlukan parameter konfigurasi

Edge 4.17.05 menambahkan parameter wajib baru ke file konfigurasi yang digunakan saat Anda mengaktifkan server SMTP. Sekarang Anda harus menetapkan SMTPMailFROM di file konfigurasi saat mengaktifkan server SMTP. Parameter ini memiliki bentuk:

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

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 informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pulihkan.
Memastikan Edge berjalan
Pastikan Edge aktif dan berjalan selama proses update dengan menggunakan perintah:

> /opt/apigee/apigee-service/bin/apigee-all

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

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, dijelaskan dalam Mengaktifkan/Menonaktifkan Server (Pemroses/Router Pesan) Keterjangkauan.
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.17.01.

Prosedur untuk memperbarui ke versi 4.17.05 pada {i>node<i} 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 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 utilitas Edge apigee-setup.
Download file bootstrap_4.17.05.sh Edge 4.17.05 ke /tmp/bootstrap_4.17.05.sh:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
Instal utilitas apigee-service Edge 4.17.05 dan dependensi:
> {i>sudo bash<i} /tmp/bootstrap_4.17.05.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.
(Khusus CentOS-6.x dan RedHat-6.x) Pada semua node Qpid, jalankan perintah berikut untuk memastikan Anda mendownload versi Qpid yang benar:
> instal yum apigee-qpidd --disablerepo=epel
Menggunakan apigee-service untuk mengupdate apigee-setup utilitas:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Mengupdate apigee-validate di Server Pengelolaan:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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.

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

Prosedur untuk memperbarui ke 4.17.05 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.17.05 lokal:

Buat repo 4.17.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Instal utilitas Edge apigee-setup.
Catatan: Jika sudah memiliki repositori 4.17.01, Anda dapat menambahkan 4.17.05 ke repositori tersebut seperti yang dijelaskan di "Mengupdate repositori Apigee lokal" di Menginstal utilitas Edge apigee-setup.
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.17.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:
  > {i>tar -xzf<i} apigee-4.17.05.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.17.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 di bagian "Menginstal dari repo menggunakan Nginx webserver" di Menginstal Edge utilitas apigee-setup.
2. Pada node jarak jauh, download file Edge bootstrap_4.17.05.sh untuk /tmp/bootstrap_4.17.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.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.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  dengan uName:pWord adalah nama pengguna dan sandi repo.
Menggunakan apigee-service untuk update utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Mengupdate apigee-validate utilitas di Server Pengelolaan.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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.

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

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.
(Khusus CentOS-6.x dan RedHat-6.x) Pada semua node Qpid dengan parameter koneksi internet eksternal, pastikan Anda menjalankan perintah berikut untuk mengunduh versi Qpid yang benar seperti yang ditunjukkan di atas:
> enak install apigee-qpidd --disablerepo=epel