Mengupdate Apigee Edge ke 4.16.09

Edge untuk Private Cloud v. 4.16.09

Versi Edge mana yang dapat Anda perbarui ke 4.16.09

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

Jika Anda memiliki versi Edge sebelum 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 pembaruan

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

Setelah Anda menginstal RPM Edge, pengguna dapat mengonfigurasinya.

Mengupgrade ke Java JDK Versi 8 diperlukan

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 "Suite Cipher Dinonaktifkan Default" di http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Mendowngrade Zookeeper jika mengupdate dari 4.16.01

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

Anda dapat memeriksa versi Zookeeper dengan 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 update.

Memperbarui prasyarat

Perhatikan prasyarat berikut sebelum mengupgrade Apigee Edge:

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

    Hal ini memungkinkan Anda memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan benar. Untuk informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
  • Pastikan Edge berjalan
    Pastikan Edge sudah aktif dan berjalan selama proses update dengan menggunakan perintah:

    > /<inst_root>/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 tersebut akan dilanjutkan dari bagian terakhir yang ditinggalkan.

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

Mencatat informasi update ke dalam log

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

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

Jika pengguna yang menjalankan utilitas update.sh tidak memiliki akses ke direktori tersebut, server 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, meskipun node Postgres tidak diupdate, data analisis tetap ditulis ke node Qpid. Setelah node Postgres diupdate dan kembali online, data analisis akan didorong ke node Postgres.

Node standby Postgres tambahan diperlukan jika Anda harus melakukan roll back update karena alasan apa pun. Jika Anda harus me-roll back update, node standby Postgres yang baru akan menjadi node Postgres master setelah rollback. Oleh karena itu, saat Anda menginstal node standby Postgres 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 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:

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

    conf_pg_hba_replication.connection=host replikasi apigee existing_slave_ip/32 trust\ \ntrust replikasi apigee new_slave_ip/32 trust

    dengan existing_slave_ip adalah alamat IP server saat ini yang baru
  2. Mulai ulang apigee-postgresql di master Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifikasi bahwa 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 replikasi apigee existing_slave_ip/32 trust
    host replikasi apigee new_slave_ip/32 trust
  4. Instal server standby Postgres baru:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal versi Edge Anda saat ini untuk menentukan berikut:

      # alamat IP master saat ini:
      PG_MASTER=192.168.56.103
      # Alamat IP dari node standby baru
      PG_standBY=192.168.56.102
    2. Nonaktifkan SELinux seperti yang dijelaskan di Menginstal utilitas penyiapan apigee 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

      Catatan1, jika Anda memperbarui file dari bagian bawah.
    4. Instal utilitas dan dependensi Edge apigee-service:
      > 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

      Validasi bahwa node tersebut merupakan standby.

Menonaktifkan node Postgres

Setelah update selesai, nonaktifkan node standby baru:

  1. Pastikan Postgres 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 pada node standby baru:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    Anda akan melihat UUID node di akhir output, dalam bentuk:
    -
  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 replikasi apigee existing_slave_ip/32 trust
  5. Mulai ulang apigee-postgresql di master Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Verifikasi bahwa 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 replikasi apigee trust_slave_ip/32 yang ada
  7. Hapus UUID node standby dari ZooKeeper dengan melakukan panggilan API pengelolaan Edge berikut di node Server Pengelolaan:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Update periode nonaktif

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

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

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

  1. Update komputer sesuai urutan penginstalan yang benar seperti yang dijelaskan di bawah dalam "Urutan update mesin".
  2. Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan Server (Pemroses Pesan/Router) Server.
  3. Update Router yang dipilih dan semua komponen Edge lainnya pada mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan pada node yang sama.
  4. Buat Router dapat dijangkau lagi.
  5. Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
  6. Lanjutkan pembaruan untuk mesin yang tersisa dalam penginstalan.

Lakukan tindakan berikut sebelum/sesudah update:

  • Pada kombinasi node Router dan Pemroses Pesan:
    • Sebelum update, lakukan tindakan berikut:
      1. Membuat Router tidak dapat dijangkau.
      2. Membuat Pemroses Pesan tidak dapat dijangkau.
    • Setelah diupdate - lakukan langkah berikut:
      1. Pemroses Pesan dapat dijangkau.
      2. Membuat Router dapat dijangkau.
  • Di satu node Router:
    • Sebelum mengupdate, buat Router tidak dapat dijangkau.
    • Setelah diupdate, buat Router dapat dijangkau.
  • Pada satu node Pemroses Pesan:
    • Sebelum update, buat Pemroses Pesan tidak dapat dijangkau.
    • Setelah diupdate, pastikan 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:

  1. Jika Anda saat ini menggunakan replikasi standby standby Postgres, instal node standby Postgres baru seperti yang dijelaskan di atas pada bagian Menginstal node standby Postgres baru.
  2. Jika ada, nonaktifkan semua tugas CRON yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga setelah update selesai.
  3. Login ke node Anda sebagai root untuk menginstal RPM Edge.
    Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
  4. Nonaktifkan SELinux seperti yang dijelaskan di Menginstal utilitas penyiapan apigee Edge.
  5. 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
  6. 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. Jika menghilangkan pWord, Anda akan diminta untuk memasukkannya.

    Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, tindakan ini akan menginstalnya untuk Anda. Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX mengambil nilai berikut:

    I = Instal OpenJDK 1.8 (default)
    C = Lanjutkan tanpa menginstal Java
    Q = Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
  7. Gunakan apigee-service untuk mengupdate utilitas penyiapan apigee:
    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/gege/geins_binbin.

      Jika Anda sudah menginstal utilitas apigee-setup, lalu mengupdatenya:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup
    2. Jika Anda menginstal 4.16.01 secara langsung, artinya Anda tidak melakukan upgrade dari 4.15.07.0x, Anda harus mengupdate utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup
      Update untuk apigee-service ini menginstal utilitas apigee-servicesh.
    3. Jika Anda menginstal 4.16.05 secara langsung atau melalui update, Anda harus mengupdate utilitas penyiapan apigee:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup

      Update untuk apigee-service ini menginstal utilitas update.sh di <inst_dir/api/api/
  8. Bergantung pada versi Edge saat ini, Anda harus menginstal atau mengupdate utilitas apigee-validate pada Management Server.
    1. Jika saat ini Anda menggunakan Edge 4.16.05: update utilitas apigee-validate di Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. 20





    3. Jika Anda melakukan upgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke utilitas apigee-validate. Dalam rilis 4.16.01 Edge, file konfigurasi yang digunakan oleh apigee-validate memerlukan properti berikut:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      Dalam rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
  9. Perbarui utilitas apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision
  10. Jalankan utilitas update pada node Anda dalam urutan yang dijelaskan di bawah dalam "Order of machine update" di bawah:
    > /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 dibaca oleh pengguna "apigee".

    Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar kemungkinan komponen meliputi:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = All edge dari bawaha





  11. Uji update dengan menjalankan utilitas apigee-validate pada Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
  12. Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas pada Menonaktifkan node Postgres.

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

Prosedur mengupdate 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, dari repo Apigee.

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

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

Untuk mengupdate dari repo 4.16.09 lokal:

  1. Jika Anda saat ini menggunakan replikasi standby standby Postgres, instal node standby Postgres baru seperti yang dijelaskan di atas pada bagian Menginstal node standby Postgres baru.
  2. Buat repo 4.16.09 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
    Catatan: Jika sudah memiliki repo 4.16.01 atau 4.16.05 yang ada, Anda dapat menambahkan repo 4.16.09 ke dalamnya seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
  3. Untuk menginstal apigee-service dari file .tar:
    1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service paket apigee-mirror
    2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin dan tempel ke direktori /tmp pada node baru.
    3. Pada node baru, hapus centang 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/repos.
    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 repo dalam perintah ini.
  4. Untuk menginstal apigee-service menggunakan server web Nginx:
    1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas penyiapan apigee 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
      dulukan ke, di sini dulukan di bawah, nama Anda dan sistem .b S video/seiring di sini .
    3. Pada node jarak jauh, instal utilitas dan dependensi Edge API


  5. Gunakan apigee-service untuk mengupdate utilitas penyiapan apigee:
    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/gege/geins_binbin.

      Jika Anda sudah menginstal utilitas apigee-setup, lalu mengupdatenya:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup
    2. Jika Anda menginstal 4.16.01 secara langsung, artinya Anda tidak melakukan upgrade dari 4.15.07.0x, Anda harus mengupdate utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup
      Update untuk apigee-service ini menginstal utilitas apigee-servicesh.
    3. Jika Anda menginstal versi 4.16.05 secara langsung atau melalui update, Anda harus mengupdate utilitas penyiapan apigee:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup

      Update untuk apigee-service ini menginstal utilitas update.sh di <inst_dir/api/api/
  6. Bergantung pada versi Edge saat ini, Anda harus menginstal atau mengupdate utilitas apigee-validate pada Management Server.
    1. Jika saat ini Anda menggunakan Edge 4.16.05: update utilitas apigee-validate di Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Jika saat ini Anda menggunakan Edge 4.16.01: instal utilitas validasi apigee di Server Pengelolaan:
      > /opt/apigee/apigee-service/bin/apigee-service API




    3. Jika Anda melakukan upgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke utilitas apigee-validate. Dalam rilis 4.16.01 Edge, file konfigurasi yang digunakan oleh apigee-validate memerlukan properti berikut:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      Dalam rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
  7. Perbarui utilitas apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision
  8. 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 bahwa file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".

    Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar kemungkinan komponen meliputi:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = All edge dari bawaha





  9. Uji update dengan menjalankan utilitas apigee-validate pada Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
  10. Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas pada Menonaktifkan node Postgres.

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

Urutan update mesin

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

  • Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lain.
  • Untuk komputer apa pun dengan beberapa komponen Edge (Server Pengelolaan, Pemroses Pesan, Router, Server QPID, bukan Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
  • Jika langkah menentukan bahwa tindakan tersebut harus dilakukan di beberapa perangkat, lakukan dalam urutan mesin yang ditetapkan.
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Nama ini akan diperbarui saat Anda menentukan opsi "-c edge".

Untuk penginstalan mandiri 1 host

  1. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper:
    > yum downgrade apigee-zookeeper
  2. Mengupdate Cassandra dan ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Memperbarui LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Menghentikan Postgres Server, Qpid server, 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/service-apigepost
  6. Memperbarui postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Memperbarui database Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Update komponen Edge yang tersisa:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Mengupdate UI Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan mandiri 2 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di mesin 1:
    > yum downgrade apigee-zookeeper
  2. Mengupdate Cassandra dan ZooKeeper di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Mengupdate qpidd di mesin 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Mengupdate LDAP di perangkat 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Mengupdate komponen Edge pada mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Mengupdate UI di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Update postgresql di mesin 2:
    1. Menghentikan Server Postgres, 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/service-apigepostapi
    2. Memperbarui postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Memperbarui database Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Mengupdate komponen Edge pada mesin 2 dan mesin 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Mengupdate komponen Edge pada mesin 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Untuk penginstalan dengan cluster 5 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di bagian Menginstal node standby Postgres baru.
  2. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3:
    > yum downgrade apigee-zookeeper
  3. Mengupdate Cassandra dan ZooKeeper di komputer 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mengupdate qpidd di mesin 4 dan 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mengupdate LDAP di perangkat 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mengupdate komponen Edge pada mesin 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Mengupdate UI di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Mengupdate mesin 4 dan 5:
    1. Hentikan server Postgres dan server Qpid di mesin 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 mesin 5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/ege/apigre-post/apige-service
    3. Menghentikan server Postgres dan postgresql di node standby baru 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. Mengupdate postgresql di mesin 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Mengupdate database Postgres di mesin 4 (khusus master Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Mengupdate postgresql di mesin 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 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
    8. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service-apigee-postgresql setup-rereline
    9. Verifikasi status replikasi dengan menerbitkan skrip berikut ke kedua server. Sistem akan menampilkan hasil yang identik di kedua server guna memastikan replikasi yang berhasil:

      Di mesin 4, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa itu adalah master.

      Di mesin 5, node standby:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa node tersebut merupakan standby.
  9. Mengupdate komponen Edge pada mesin 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas di Menonaktifkan node Postgres.

Untuk penginstalan cluster 9 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di bagian Menginstal node standby Postgres baru.
  2. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3:
    > yum downgrade apigee-zookeeper
  3. Mengupdate Cassandra dan ZooKeeper pada mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mengupdate qpidd pada komputer 6 dan 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Mengupdate LDAP di perangkat 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Perbarui komponen Edge pada mesin 6, 7, 1, 4, dan 5 dalam urutan tersebut:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Mengupdate UI di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Mengupdate mesin 8 dan 9:
    1. Hentikan server Postgres di mesin 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Hentikan server Postgres dan postgresql di mesin 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. Menghentikan server Postgres dan postgresql di node standby baru 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. Mengupdate postgresql di mesin 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mengupdate database Postgres di mesin 8 (khusus master Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mengupdate postgresql di mesin 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Mulai server server Postgres di komputer 8 dan 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai server server Qpid di komputer 6 dan 7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-rerescript
    11. Verifikasi status replikasi dengan menerbitkan skrip berikut ke kedua server. Sistem akan menampilkan hasil yang identik di kedua server guna memastikan replikasi yang berhasil:
      Di mesin 8, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa itu adalah master.

      Di mesin 9, node standby:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa node tersebut merupakan standby.
  9. Mengupdate komponen Edge pada mesin 8 dan 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas di Menonaktifkan node Postgres.

Untuk penginstalan cluster 13 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di bagian Menginstal node standby Postgres baru.
  2. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3:
    > yum downgrade apigee-zookeeper
  3. Mengupdate Cassandra dan ZooKeeper pada mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mengupdate qpidd di komputer 12 dan 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Update LDAP di komputer 4 dan 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Perbarui komponen Edge pada mesin 12, 13, 6, 7, 10, dan 11 dalam urutan tersebut:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Mengupdate UI di mesin 6 dan 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Mengupdate mesin 8 dan 9:
    1. Hentikan server Postgres di mesin 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Hentikan server Postgres dan postgresql di mesin 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. Menghentikan server Postgres dan postgresql di node standby baru 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. Mengupdate postgresql di mesin 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mengupdate database Postgres di mesin 8 (khusus master Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mengupdate postgresql di mesin 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Mulai server Postgres di komputer 8 dan 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai server server Qpid di komputer 12 dan 13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-rerescript
    11. Verifikasi status replikasi dengan menerbitkan skrip berikut ke kedua server. Sistem akan menampilkan hasil yang identik di kedua server guna memastikan replikasi yang berhasil:
      Di mesin 8, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa itu adalah master.

      Di mesin 9, node standby:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa node tersebut merupakan standby.
  9. Mengupdate komponen Edge pada mesin 8 dan 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas di Menonaktifkan node Postgres.

Untuk penginstalan cluster 12 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas di bagian Menginstal node standby Postgres baru.
  2. Perbarui Cassandra dan ZooKeeper:
    1. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3 di Data Center 1:
      > yum downgrade apigee-zookeeper
    2. Di komputer 1, 2, dan 3 di Pusat Data 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Jika Anda mengupdate dari versi 4.16.01, downgrade Zookeeper di mesin 7, 8, dan 9 di Data Center 2:
      > yum downgrade apigee-zookeeper
    4. Di 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
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Mesin 10, 11 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  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. Memperbarui 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. Mengupdate 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. Perbarui mesin 6 di Pusat Data 1 dan 12 di Pusat Data 2:
    1. Hentikan server Postgres di mesin 6:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Menghentikan server Postgres dan postgresql di mesin 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 di komputer 4, 5, 10, dan 11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Menghentikan server Postgres dan postgresql di node standby baru 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. Mengupdate postgresql di mesin 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mengupdate database Postgres di mesin 6 (khusus master Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mengupdate postgresql di mesin 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Mulai server server Postgres di komputer 6 dan 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai server server Qpid di komputer 4, 5, 10, dan 11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut pada mesin 12:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
      -
    11. Verifikasi status replikasi dengan menerbitkan skrip berikut ke kedua server. Sistem akan menampilkan hasil yang identik di kedua server guna memastikan replikasi yang berhasil:
      Di mesin 6, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa itu adalah master.

      Di mesin 12, node standby:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa node tersebut merupakan standby.
  8. Mengupdate komponen Edge pada mesin 6 dan 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas di Menonaktifkan node Postgres.

Untuk penginstalan BaaS API 7 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Mengupdate Cassandra di mesin 5, 6, dan 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Mengupdate ElasticSearch dan API BaaS Stack pada mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. Mengupdate Portal BaaS API di mesin 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Untuk penginstalan BaaS API dengan 10 host

Lihat Topologi Instalasi untuk daftar topologi Edge dan nomor node.

  1. Mengupdate Cassandra di mesin 8, 9, dan 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Mengupdate ElasticSearch di perangkat 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Mengupdate Stack BaaS API pada mesin 4, 5, dan 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Mengupdate Portal BaaS API di komputer 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Untuk penginstalan non-standar

Jika Anda memiliki penginstalan non-standar, perbarui komponen Edge dalam urutan berikut:

  1. Penjaga Kebun Binatang
  2. Cassandra
  3. Qpidd
  4. LDAP
  5. Edge, yang berarti profil "-c edge" pada semua node dalam urutan: node dengan server Qpid, tetapi bukan server Postgres, Management Server, Message Processor, dan Router.
    Catatan: Jika node sudah menginstal server Qpid dan server Postgres, jalankan langkah profil "-c edge" sebagai bagian dari langkah 8.
  6. UI Edge
  7. postgresql di master Postgres, termasuk upgrade.
  8. postgresql di mode standby Postgres.
  9. Edge, yang berarti profil "-c edge" pada semua node Qpid dan Postgres gabungan, atau pada node Postgres mandiri.