Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupdate Apigee Edge ke 4.16.09

Edge untuk Private Cloud v. 4.16.09

Versi Edge mana yang dapat Anda update ke 4.16.09

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

Jika memiliki versi Edge yang lebih lama ke versi 4.16.01, Anda harus bermigrasi ke versi 4.16.01.x terlebih dahulu, lalu mengupdate ke versi 4.16.09.

Siapa yang dapat melakukan update

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

Setelah Anda menginstal RPM Edge, setiap pengguna dapat mengonfigurasinya.

Upgrade yang diperlukan ke Java JDK Versi 8

Rilis Edge ini mengharuskan Anda menginstal Java JDK versi 8 di semua node pemrosesan Edge. Anda dapat menginstal Oracle JDK 8 atau OpenJDK 8. Jika Java JDK 8 belum diinstal, skrip update dapat menginstalnya untuk Anda.

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

Mendowngrade Zookeeper jika diupdate dari 4.16.01

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

Anda dapat memeriksa versi Zookeeper menggunakan perintah berikut:

> rpm -qa |grep apigee-zookeeper

Jika perintah ini menampilkan versi Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Kemudian, Anda harus melakukan downgrade.

Penerapan otomatis setelan properti

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

Perbarui prasyarat

Perhatikan prasyarat berikut sebelum mengupgrade Apigee Edge:

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

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.
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 terjadi kegagalan update, Anda dapat mencoba memperbaiki masalahnya, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali untuk melanjutkan update dari bagian terakhir yang ditinggalkan.

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

Mencatat informasi update

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 tersebut 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 mencakup upgrade ke Postgres 9.4. Sebagai bagian dari upgrade tersebut, semua data Postgres dimigrasikan ke Postgres 9.4.

Selama proses update, saat node Postgres tidak aktif untuk melakukan update, data analisis tetap ditulis ke node Qpid. Setelah node Postgres diupdate dan kembali online, data analisis kemudian dikirim ke node Postgres.

Node standby Postgres tambahan diperlukan jika Anda harus me-roll back update karena alasan apa pun. Jika Anda harus me-roll back update, node standby Postgres baru akan menjadi node Postgres master setelah rollback. Oleh karena itu, saat Anda menginstal node standby Postgres yang baru, node tersebut harus berada di node yang memenuhi semua persyaratan hardware server Postgres, seperti yang ditetapkan dalam Persyaratan Penginstalan Edge.

Menginstal node standby Postgres baru

Prosedur ini membuat server standby Postgres pada node baru. Pastikan Anda menginstal server standby Postgres baru 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 Edge versi saat ini.

Untuk membuat node standby Postgres baru:

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

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee existing_slave_ip/32 trust

dengan existing_slave_ip adalah alamat IP standby_slave_ip server baru dan existing_slave_ip server standby.
Mulai ulang apigee-postgresql pada master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Pastikan node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf pada master. Anda akan melihat baris berikut dalam file tersebut:
host replication apigee existing_slave_ip/32 trust
host replication 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 hal berikut:
  
  # alamat IP master saat ini:
  PG_MASTER=192.168.56.103
  # alamat IP node standby baru
  PG_STANDBY=192.168.56.102
2. Nonaktifkan SELinux seperti yang dijelaskan pada Menginstal utilitas apigee-setup Edge.
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 file Edge.6.0
4. Instal utilitas dan dependensi layanan Edge apigee:
  > sudo bash /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:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. Pada node standby baru, jalankan perintah berikut:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Pastikan bahwa server tersebut berstatus standby.

Menonaktifkan node Postgres

Setelah update selesai, nonaktifkan node standby baru:

Pastikan Postgres 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 yang baru dengan menjalankan perintah cURL berikut pada node standby yang baru:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Anda akan melihat UUID node di akhir output, dalam bentuk:
Hentikan node standby baru dengan menjalankan perintah berikut pada node standby yang baru:
> /opt/apigee/apigee-service/bin/apigee-all stop
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 replication apigee existing_slave_ip/32 trust
Mulai ulang apigee-postgresql di master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Pastikan node standby baru telah dihapus dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf pada master. Anda hanya akan melihat baris berikut dalam file tersebut:
host replication apigee existing_slave_ip/32 trust
Hapus UUID node standby dari ZooKeeper dengan melakukan panggilan API pengelolaan Edge berikut di node Management Server:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Update tanpa periode nonaktif

Update zero-down, atau update berkelanjutan, memungkinkan Anda mengupdate penginstalan Edge tanpa menurunkan Edge.

Update zero-time hanya dapat dilakukan dengan konfigurasi 5 node dan lebih besar.

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

Perbarui mesin dalam urutan yang benar untuk penginstalan seperti yang dijelaskan di bawah ini di "Urutan update mesin".
Jika sudah waktunya untuk mengupdate Router, pilih satu Router dan buat Router tidak dapat dijangkau, seperti dijelaskan dalam Mengaktifkan/Menonaktifkan Server (Message Processor/Router).
Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan pada node yang sama.
Membuat Router dapat dijangkau lagi.
Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
Lanjutkan update untuk komputer lain dalam penginstalan.

Perhatikan hal berikut sebelum/setelah update:

Pada gabungan node Router dan Message Processor:
- Sebelum update – lakukan tindakan berikut:
  1. Membuat Router tidak dapat dijangkau.
  2. Membuat Pemroses Pesan tidak dapat dijangkau.
- Setelah update - lakukan tindakan berikut:
  1. Membuat Pemroses Pesan dapat dijangkau.
  2. Buat Router dapat dijangkau.
Pada node Router tunggal:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
Pada node Message Processor tunggal:
- 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 versi 4.16.09 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

Jika saat ini Anda menggunakan replikasi master-standby Postgres, instal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
Jika ada, nonaktifkan semua tugas CRON yang dikonfigurasi untuk melakukan operasi perbaikan di 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.
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 dan dependensi apigee-service Edge 4.16.09:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apiege. Jika pWord dihapus, Anda akan diminta untuk memasukkannya.

Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, aplikasi akan diinstal untuk Anda. Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX menggunakan nilai berikut:

I = Install 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:
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 menginstal utilitas update.sh di <inst_setup_dir>
  
  Jika Anda sudah menginstal utilitas apigee-setup, lalu update utilitas tersebut:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jika Anda menginstal 4.16.01 secara langsung, yang berarti 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 ini untuk apigee/setup
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 menginstal utilitas update.sh di <inst_apige/setup>
Bergantung pada versi Edge saat ini, Anda harus menginstal atau mengupdate utilitas apigee-validate di Server Pengelolaan.
1. Jika saat ini Anda menggunakan Edge 4.16.05: update 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 pada Management Server:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Catatan: Jika Anda telah menginstal utilitas apigee-validate pada server Management Server:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Catatan: Jika Anda telah menginstal utilitas apigee-validate pada node Management Service Processor. Anda dapat menginstalnya pada node Processor service1.
3. Jika Anda melakukan upgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke utilitas apigee-validate. Dalam rilis Edge 4.16.01, file konfigurasi yang digunakan oleh apigee-validate memerlukan properti berikut:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Pada rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
Update utilitas apigee-available:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provide
Jalankan utilitas update pada 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 dapat dibaca oleh pengguna "apigee".

Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
ldap = OpenLDAP
cs = Cassandra
zk = Instalasi Zookeeper
qpid = qpidd
ps = postgresql
edge =Semua komponen kecuali Edge UI: Management Server, Message Processor Edge Processor, Qpid Server, Postgres API Server
Uji update dengan menjalankan utilitas apigee-validate pada Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas dalam Menonaktifkan node Postgres.

Untuk melakukan rollback update di lain waktu, gunakan prosedur yang dijelaskan dalam Proses Rollback 4.16.09.

Prosedur update ke 4.16.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 pencerminan, repo Apigee.

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

Buat file .tar untuk 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 mengupdate dari repo 4.16.09 lokal:

Jika saat ini Anda menggunakan replikasi master-standby Postgres, instal node standby Postgres baru 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 utilitas konfigurasi Edge apigee.
Catatan: Jika sudah memiliki repositori 4.16.01 atau 4.16.05, Anda dapat menambahkan repo 4.16.09 ke dalamnya seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal utilitas penyiapan Edge apigee.
Untuk menginstal layanan apigee dari file .tar:
1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal menjadi satu file .tar dengan nama /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 pada node baru.
3. Pada node baru, untar file ke direktori /tmp:
  > tar -xzf apigee-4.16.09.tar.gz
  
  Perintah ini akan membuat direktori baru, bernama repo, di direktori yang berisi file .tar. Misalnya, /tmp/repo.
4. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Perhatikan bahwa Anda menyertakan jalur ke direktori repositori dalam perintah ini.
Untuk menginstal layanan apigee menggunakan server web Nginx:
1. Konfigurasikan server web Nginx seperti dijelaskan dalam "Instal dari repo menggunakan server web Nginx" pada Menginstal utilitas apigee-setup Edge.
2. Pada node jarak jauh, download 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 -
3. Pada node jarak jauh, instal utilitas dan dependensi layanan Edge apigee:
  > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=://pword dan nama pengguna: http:
Gunakan apigee-service untuk mengupdate 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 menginstal utilitas update.sh di <inst_setup_dir>
  
  Jika Anda sudah menginstal utilitas apigee-setup, lalu update utilitas tersebut:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jika Anda menginstal 4.16.01 secara langsung, yang berarti 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 ini untuk apigee/setup
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 menginstal utilitas update.sh di <inst_apige/setup>
Bergantung pada versi Edge saat ini, Anda harus menginstal atau mengupdate utilitas apigee-validate di Server Pengelolaan.
1. Jika saat ini Anda menggunakan Edge 4.16.05: update 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 dan apigee-validate Anda di Server Management:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Catatan: Jika Anda telah menginstal utilitas apigee-validate pada node Management Server
3. Jika Anda melakukan upgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke utilitas apigee-validate. Dalam rilis Edge 4.16.01, file konfigurasi yang digunakan oleh apigee-validate memerlukan properti berikut:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Pada rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
Update utilitas apigee-available:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provide
Jalankan utilitas update pada node Anda dalam urutan yang dijelaskan di bawah pada "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 = Instalasi Zookeeper
qpid = qpidd
ps = postgresql
edge =Semua komponen kecuali Edge UI: Management Server, Message Processor Edge Processor, Qpid Server, Postgres API Server
Uji update dengan menjalankan utilitas apigee-validate pada Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas dalam Menonaktifkan node Postgres.

Untuk melakukan rollback update di lain waktu, gunakan prosedur yang dijelaskan dalam Proses Rollback 4.16.09.

Urutan update mesin

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

Anda harus memperbarui semua node Cassandra dan ZooKeeper sebelum memperbarui node lainnya.
Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Prosesor Pesan, Router, Server QPID, tetapi tidak Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
Jika sebuah langkah menentukan bahwa tindakan tersebut harus dilakukan pada beberapa mesin, jalankan sesuai urutan mesin yang ditentukan.
Tidak ada langkah terpisah untuk memperbarui Monetisasi. Ini diupdate saat Anda menentukan opsi "-c edge".