Update Apigee Edge 4.17.09 ke 4.19.01

Edge for Private Cloud v4.19.01

Bagian ini menjelaskan cara melakukan upgrade berikut:

  • Dari 4.17.09 hingga 4.19.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.

Mempertahankan kompatibilitas

Saat mengupgrade Apigee Edge untuk Private Cloud ke 4.19.01, Anda harus memastikan bahwa implementasi yang dihasilkan hanya mereferensikan properti yang didukung dalam file konfigurasinya.

Properti Lokasi Deskripsi
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Hapus properti ini dari file router.properties Anda. Untuk mengatur opsi percobaan ulang di 4.19.01, gunakan kelas virtual properti konfigurasi host.

Penyebaran properti otomatis pengaturan

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

Upgrade yang diperlukan ke Postgres 9.6

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

Sebagian besar sistem produksi Edge menggunakan dua node Postgres yang dikonfigurasi untuk replikasi master-standby. Selama proses update, saat node Postgres tidak aktif untuk update, data analisis tetap yang ditulis ke {i>node<i} Qpid. Setelah node Postgres diperbarui dan kembali online, data analisis kemudian didorong ke node Postgres.

Cara Anda melakukan pembaruan Postgres bergantung pada cara Anda mengonfigurasi penyimpanan data untuk Node postgres:

  • Jika menggunakan penyimpanan data lokal untuk node Postgres, Anda harus menginstal node standby Postgres baru selama durasi upgrade. Setelah upgrade selesai, Anda dapat menonaktifkan node standby Postgres yang baru.

    Node standby Postgres tambahan diperlukan jika Anda harus melakukan roll back update untuk alasan apa pun. Jika Anda perlu melakukan roll back update, node standby Postgres baru menjadi node Postgres master setelah rollback. Oleh karena itu, saat Anda menginstal node standby Postgres baru, harus berada di node yang memenuhi semua hardware persyaratan server Postgres, seperti yang didefinisikan dalam Persyaratan penginstalan.

    Dalam konfigurasi Edge 1-node dan 2-node, topologi yang digunakan untuk pembuatan prototipe dan pengujian, Anda hanya memiliki satu node Postgres. Anda dapat memperbarui node Postgres ini secara langsung tanpa harus untuk membuat node Postgres baru.

  • Jika Anda menggunakan penyimpanan jaringan untuk node Postgres, sebagai direkomendasikan oleh Apigee, Anda tidak perlu menginstal node Postgres baru. Di kolom prosedur di bawah ini, Anda dapat melewati langkah-langkah yang menentukan untuk menginstal dan kemudian menonaktifkan Node standby postgres.

    Sebelum Anda memulai proses pembaruan, ambil cuplikan jaringan dari penyimpanan data yang digunakan oleh Postgres. Lalu, jika terjadi kesalahan saat pembaruan dan Anda dipaksa melakukan {i>rollback<i}, Anda dapat memulihkan node Postgres dari snapshot tersebut.

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.17.09), bukan untuk versi 4.19.01.

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

Untuk membuat node standby Postgres baru:

  1. Pada master Postgres saat ini, edit /opt/apigee/customer/application/postgresql.properties untuk menyetel token berikut. Jika file tersebut tidak ada, buat file tersebut: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Dengan existing_standby_ip adalah alamat IP Postgres saat ini server standby dan new_standby_ip adalah alamat IP node standby baru.

  2. Mulai ulang apigee-postgresql pada master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Pastikan bahwa node standby baru telah ditambahkan dengan menampilkan /opt/apigee/apigee-postgresql/conf/pg_hba.conf file di master. Anda akan melihat baris berikut dalam file tersebut: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Instal server standby Postgres baru:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini untuk menentukan hal berikut: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Nonaktifkan SELinux seperti yang dijelaskan di Instal utilitas Edge apigee-setup.
    3. Unduh file Edge bootstrap_4.17.09.sh ke /tmp/bootstrap_4.17.09.sh : 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    4. Instal utilitas dan dependensi Edge apigee-service: 
      sudo bash /tmp/bootstrap_4.17.09.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

      Validasi bahwa perangkat tersebut menyatakan mode standby.

Menonaktifkan node Postgres

Setelah update selesai, hentikan node standby baru:

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

  2. Dapatkan UUID node standby baru dengan menjalankan perintah curl berikut di node baru node standby: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Anda akan melihat UUID node di akhir output, dalam bentuk: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Hentikan node standby baru dengan menjalankan perintah berikut pada node standby baru: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. 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_standby_ip/32 trust
  5. Mulai ulang apigee-postgresql pada master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Pastikan bahwa node standby baru telah dihapus dengan melihat /opt/apigee/apigee-postgresql/conf/pg_hba.conf file di master. Anda akan melihat hanya baris berikut dalam file tersebut: 
    host replication apigee existing_standby_ip/32 trust
  7. Hapus UUID node standby dari ZooKeeper dengan membuat pengelolaan Edge berikut Panggilan API pada node Server Pengelolaan: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

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.

    Hal ini memungkinkan Anda 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 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 me-roll back update ke versi sebelumnya, lihat Roll back 4.19.01 untuk mengetahui informasi selengkapnya.

Informasi pembaruan logging

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, file akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

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

Update tanpa periode nonaktif

Update tanpa periode nonaktif atau update berkelanjutan memungkinkan Anda memperbarui konfigurasi 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.

  1. Perbarui komputer dalam urutan yang benar untuk konfigurasi Anda seperti yang dijelaskan di Urutan update komputer.
  2. 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.
  3. 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.
  4. Buat Router dapat dijangkau lagi.
  5. Ulangi langkah 2 sampai 4 untuk Router lainnya.
  6. Lanjutkan pembaruan untuk komputer lainnya dalam konfigurasi 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.09.

Perbarui ke 4.19.01 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk memperbarui komponen Edge pada node:

  1. Jika saat ini Anda menggunakan replikasi master-standby Postgres dengan penyimpanan lokal, instal node standby Postgres baru seperti yang dijelaskan di Menginstal Postgres baru node standby.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, gunakan snapshot jaringan penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Jika ada, nonaktifkan tugas CRON apa pun yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga setelah pembaruan selesai.
  3. Login ke node Anda sebagai root untuk menginstal RPM Edge.
  4. Instal yum-utils dan yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas Edge apigee-setup.
  6. Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Jika Anda menginstal di AWS, jalankan perintah berikut Perintah yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Download file bootstrap_4.19.01.sh Edge 4.19.01 ke /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  9. Instal utilitas dan dependensi apigee-service Edge 4.19.01: 
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda 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 Java penginstalan. 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.
  10. Gunakan apigee-service untuk mengupdate utilitas apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Update utilitas apigee-validate di Server Pengelolaan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Update utilitas apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Jalankan utilitas update pada node Anda sesuai urutan yang dijelaskan di Urutan update komputer: 
    /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 "apigee" .

    Gunakan opsi -c untuk menentukan komponen yang akan diupdate. Daftar kemungkinan meliputi:

    • "cs" = Cassandra
    • "tepi" =Semua komponen Edge kecuali UI Edge. "Edge" komponen mencakup Server Pengelolaan, Pemroses Pesan, {i>Router<i}, Server QPID, Server Postgres Edge.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = SSO Edge
    • "ui" = UI Edge
    • "zk" = Zookeeper

    Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil konfigurasi Edge all-in-one (AIO). Contoh:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Mulai ulang komponen UI Edge pada semua mesin yang menjalankannya, jika Anda belum melakukannya: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Uji update dengan menjalankan utilitas apigee-validate pada bagian Pengelolaan Server, seperti yang dijelaskan dalam Menguji penginstalan.
  16. Jika Anda menginstal node standby Postgres baru, hentikan node seperti yang dijelaskan dalam Menghentikan Node Postgres.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Wajib mengupgrade ke Postgres 9.6 untuk mendapatkan lebih banyak.

Untuk me-roll back update di lain waktu, gunakan prosedur yang dijelaskan di Roll back 4.19.01.

Pembaruan ke 4.19.01 dari repo lokal

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

  1. Jika saat ini Anda menggunakan replikasi master-standby Postgres, instal Postgres baru node standby sebagaimana dijelaskan dalam Menginstal Postgres baru node standby.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, gunakan snapshot jaringan penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Buat repo 4.19.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" pada pukul Instal utilitas Edge apigee-setup.
  3. 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.19.01.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.19.01tar.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: 
      sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.

  4. Untuk menginstal apigee-service menggunakan server web Nginx:
    1. Konfigurasikan server web Nginx seperti yang dijelaskan di bagian "Menginstal dari repo menggunakan Nginx webserver&quot; di Menginstal Edge Utilitas apigee-setup.
    2. Pada node jarak jauh, download file Edge bootstrap_4.19.01.sh untuk /tmp/bootstrap_4.19.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

      Dengan uName:pWord adalah nama pengguna dan sandi yang sebelumnya Anda tetapkan repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.

    3. Pada node jarak jauh, instal utilitas apigee-service Edge dan dependensi: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Dengan uName:pWord adalah nama pengguna dan sandi repo.

  5. Gunakan apigee-service untuk mengupdate utilitas apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Update utilitas apigee-validate di Server Pengelolaan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Update utilitas apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Jalankan utilitas update di node Anda sesuai urutan yang dijelaskan di Urutan update komputer: 
    /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:

    • "cs" = Cassandra
    • "tepi" =Semua komponen Edge kecuali UI Edge. "Edge" komponen mencakup Server Pengelolaan, Pemroses Pesan, {i>Router<i}, Server QPID, Server Postgres Edge.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = SSO Edge
    • "ui" = UI Edge
    • "zk" = Zookeeper

    Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil konfigurasi Edge all-in-one (AIO). Contoh:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Mulai ulang komponen UI Edge pada semua mesin yang menjalankannya, jika Anda belum melakukannya: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Uji update dengan menjalankan utilitas apigee-validate pada bagian Pengelolaan Server, seperti yang dijelaskan dalam Menguji penginstalan.
  11. Jika Anda menginstal node standby Postgres baru, hentikan node seperti yang dijelaskan dalam Penghentian node Postgres.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

Untuk melakukan roll back update nanti, gunakan prosedur yang dijelaskan dalam Melakukan roll back 4.19.01.

Urutan update mesin

Urutan Anda memperbarui mesin dalam konfigurasi 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.

Upgrade mandiri 1 node

  1. Perbarui Cassandra dan ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Perbarui LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Hentikan Postgres Server, server Qpid, dan PostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Perbarui postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Perbarui komponen Edge yang tersisa: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Update UI Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jika Anda menginstal SSO Edge) Update Edge SSO: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.

  10. Mulai ulang komponen UI Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade mandiri 2 node

Lihat Topologi pemasangan untuk daftar Edge topologi dan nomor node.

  1. Perbarui Cassandra dan ZooKeeper di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui Qpid di komputer 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Perbarui LDAP di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Perbarui komponen Edge di perangkat 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Update UI di perangkat 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Jika Anda menginstal SSO Edge) Update Edge SSO di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.

  8. Perbarui postgresql di komputer 2:
    1. Hentikan Postgres Server, server Qpid, dan postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/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 komponen Edge di perangkat 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Mulai ulang komponen UI Edge di perangkat 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade 5 node

Lihat Topologi pemasangan untuk daftar Edge topologi dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di Menginstal node standby Postgres baru.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, gunakan snapshot jaringan penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui Qpid di komputer 4 dan 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Perbarui LDAP di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Perbarui komponen Edge di perangkat 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Update UI di perangkat 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal SSO Edge) Update Edge SSO di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.

  9. 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 stop
/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 stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Jika diinstal, hentikan server Postgres dan postgresql di standby baru node yang Anda tambahkan untuk rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Perbarui postgresql di komputer 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Perbarui postgresql di komputer 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mulai server Postgres dan server Qpid di komputer 4 dan 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    7. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 5: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    8. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang identik di kedua server untuk memastikan replikasi berhasil:
      • Pada komputer 4, node master, jalankan: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Validasi bahwa dikatakan sebagai master.

      • Di komputer 5, node standby: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Validasi bahwa perangkat tersebut menyatakan mode standby.

  10. Perbarui komponen Edge di komputer 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Pastikan Anda menghentikan node standby baru seperti yang dijelaskan dalam Penghentian node Postgres.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  12. Mulai ulang komponen UI Edge di perangkat 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade dalam cluster 9 node

Lihat Topologi pemasangan untuk daftar Edge topologi dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, gunakan snapshot jaringan penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui Qpid di komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Perbarui LDAP di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Perbarui komponen Edge pada perangkat 6, 7, 1, 4, dan 5 dalam urutan tersebut: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Update UI di perangkat 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal SSO Edge) Update Edge SSO di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.

  9. 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 stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Hentikan server Qpid di komputer 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Jika diinstal, hentikan server Postgres dan postgresql di standby baru node yang Anda tambahkan untuk rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Perbarui postgresql di komputer 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Perbarui postgresql di komputer 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Mulai server server Postgres di komputer 8 dan 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Mulai server server Qpid pada komputer 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di perangkat 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang identik di kedua server untuk memastikan replikasi berhasil:
      • Pada komputer 8, node master, jalankan: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Validasi bahwa dikatakan sebagai master.

      • Di komputer 9, node standby: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Validasi bahwa perangkat tersebut menyatakan mode standby.

  10. Perbarui komponen Edge di komputer 8 dan 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Pastikan Anda menghentikan node standby baru seperti yang dijelaskan di Penghentian node Postgres.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  12. Mulai ulang komponen UI Edge di perangkat 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade dalam cluster 13 node

Lihat Topologi pemasangan untuk daftar Edge topologi dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan dalam Menginstal node standby Postgres baru.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, gunakan snapshot jaringan penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui Qpid pada komputer 12 dan 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Perbarui LDAP di komputer 4 dan 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Perbarui 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
  6. Update UI di komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 6 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal SSO Edge) Update Edge SSO pada komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.

  9. 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 stop
/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. Jika diinstal, hentikan server Postgres dan postgresql di standby baru node yang Anda tambahkan untuk rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Perbarui postgresql di komputer 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Perbarui postgresql di komputer 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Mulai server Postgres di komputer 8 dan 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Mulai server server Qpid pada komputer 12 dan 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Konfigurasi Postgres sebagai node standby dengan menjalankan perintah berikut di perangkat 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Tujuan sistem harus menampilkan hasil yang identik di kedua server untuk memastikan replikasi berhasil:
      • Pada komputer 8, node master, jalankan: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Validasi bahwa dikatakan sebagai master.

      • Di komputer 9, node standby: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Validasi bahwa perangkat tersebut menyatakan mode standby.

  10. Perbarui komponen Edge di komputer 8 dan 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Pastikan Anda menghentikan node standby baru seperti yang dijelaskan di Penghentian node Postgres.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  12. Mulai ulang komponen UI Edge di komputer 6 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade dalam cluster 12 node

Lihat Topologi pemasangan untuk daftar Edge topologi dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di Menginstal node standby Postgres baru.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Sebagai gantinya, gunakan snapshot jaringan penyimpanan data yang digunakan oleh Postgres. Lihat Wajib mengupgrade ke Postgres 9.6 untuk mendapatkan lebih banyak.

  2. Perbarui Cassandra dan ZooKeeper:
    1. Pada komputer 1, 2, dan 3 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Pada komputer 7, 8, dan 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui qpidd:
    1. Mesin 4, 5 di Pusat Data 1
      1. Perbarui qpidd di komputer 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Ulangi langkah 1 pada mesin 5.
    2. Mesin 10, 11 di Pusat Data 2
      1. Update qpidd di komputer 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Ulangi langkah 1 pada mesin 11.
  4. 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
  5. 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
  6. 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
  7. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi:
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Mesin 7 di Pusat Data 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal SSO Edge) Update Edge SSO:
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Mesin 7 di Pusat Data 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Dengan sso_config_file adalah file konfigurasi yang Anda buat saat Anda SSO yang diinstal.

  9. Update komputer 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 stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Hentikan server Qpid pada komputer 4, 5, 10, dan 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Jika diinstal, hentikan server Postgres dan postgresql di standby baru node yang Anda tambahkan untuk rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Perbarui postgresql di komputer 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Update postgresql di komputer 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Mulai server server Postgres di komputer 6 dan 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Mulai server server Qpid pada komputer 4, 5, 10, dan 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut di perangkat 12: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. 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:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa dikatakan sebagai master.

      Di perangkat 12, node standby:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa perangkat tersebut menyatakan mode standby.

  10. Update komponen Edge di komputer 6 dan 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Pastikan Anda menghentikan node standby baru seperti yang dijelaskan di Menonaktifkan Postgres node.

    Jika menggunakan penyimpanan jaringan, Anda tidak perlu menginstal node baru. Lihat Wajib mengupgrade ke Postgres 9.6 untuk mendapatkan lebih banyak.

  12. Mulai ulang komponen UI Edge di komputer 1 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Untuk upgrade non-standar

Jika Anda memiliki konfigurasi non-standar, perbarui komponen Edge pada berikut:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Tepi, yang berarti "-c tepi" profil pada semua {i>node<i} dengan urutan: {i>node<i} dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
  6. UI Edge
  7. apigee-adminapi
  8. SSO Edge

Setelah selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua komputer yang berjalan anotasi.