Mengupdate Apigee Edge 4.17.05 atau 4.17.09 ke 4.18.05

Edge for Private Cloud v4.18.05

Bagian ini menjelaskan cara melakukan upgrade berikut:

  • Dari 4.17.05 ke 4.18.05
  • Dari 4.17.09 ke 4.18.05

Siapa yang dapat melakukan update

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

Setelah Anda menginstal RPM Edge, pengguna mana pun dapat mengonfigurasinya.

Komponen mana yang harus Anda update

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

Mempertahankan kompatibilitas

Saat mengupgrade Apigee Edge untuk Private Cloud ke 4.18.05, 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 menetapkan opsi percobaan ulang di 4.18.05, gunakan properti konfigurasi host virtual.

Penyebaran otomatis setelan properti

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

Penambahan parameter konfigurasi SMTPMAILFROM diperlukan

Edge 4.17.05 menambahkan parameter wajib baru ke file konfigurasi yang digunakan saat Anda mengaktifkan server SMTP.

Upgrade yang diperlukan ke Postgres 9.6

Rilis Edge ini mencakup upgrade ke Postgres 9.6. Sebagai bagian dari upgrade 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 masih ditulis ke node Qpid. Setelah node Postgres diupdate dan kembali online, data analisis kemudian akan dikirim ke node Postgres.

Cara Anda melakukan update Postgres bergantung pada cara Anda mengonfigurasi penyimpanan data untuk node Postgres:

  • Jika Anda 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 baru.

    Node standby Postgres tambahan diperlukan jika Anda harus melakukan roll back update karena alasan apa pun. Jika Anda harus melakukan roll back update, node standby Postgres 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 ditentukan dalam Persyaratan Penginstalan Edge.

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

  • Jika menggunakan penyimpanan jaringan untuk node Postgres, seperti yang direkomendasikan oleh Apigee, Anda tidak perlu menginstal node Postgres baru. Dalam prosedur di bawah, Anda dapat melewati langkah-langkah yang menentukan untuk menginstal dan kemudian menonaktifkan node standby Postgres baru.

    Sebelum memulai proses update, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Kemudian, jika terjadi error selama update dan Anda terpaksa melakukan roll back, Anda dapat memulihkan node Postgres dari snapshot tersebut.

Menginstal node standby Postgres baru

Prosedur ini membuat server standby Postgres di node baru. Pastikan Anda menginstal server standby Postgres baru untuk Edge versi yang ada (4.17.05 atau 4.17.09), bukan untuk versi 4.18.05.

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 replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    Dengan existing_slave_ip adalah alamat IP server standby Postgres saat ini dan new_slave_ip adalah alamat IP node standby baru.

  2. Mulai ulang apigee-postgresql di master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Pastikan node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di 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
  4. Instal server standby Postgres baru:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal versi Edge saat ini guna 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 dalam Menginstal utilitas apigee-setup Edge.
    3. Download file bootstrap_4.17.0x.sh Edge, dengan x adalah 5 (untuk 4.17.05) atau 9 (untuk 4.17.09) ke /tmp/bootstrap_4.17.0x.sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Instal utilitas dan dependensi apigee-service Edge: 
      sudo bash /tmp/bootstrap_4.17.0x.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. Menginstal Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Di node standby baru, jalankan perintah berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Pastikan statusnya adalah 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: 

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

Prasyarat update

Penuhi prasyarat berikut sebelum mengupgrade Apigee Edge:

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

    Dengan begitu, Anda memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.

  • Memastikan Edge berjalan
    Pastikan Edge aktif dan berjalan selama proses update menggunakan perintah: 
    /opt/apigee/apigee-service/bin/apigee-all status

Menangani update yang gagal

Jika update gagal, Anda dapat mencoba memperbaiki masalahnya, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari bagian terakhir yang ditinggalkan.

Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.18.05 untuk mengetahui 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, utilitas akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

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

Update tanpa periode nonaktif

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

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

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

  1. Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan dalam Urutan update mesin.
  2. Jika sudah waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan Keterjangkauan Server (Message Processor/Router).
  3. Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor di node yang sama.
  4. Buat Router dapat dijangkau lagi.
  5. Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
  6. Lanjutkan update untuk mesin yang tersisa di penginstalan Anda.

Perhatikan hal-hal berikut sebelum/setelah update:

  • Pada node Router dan Message Processor gabungan:
    • Sebelum update – lakukan hal berikut:
      1. Membuat Router tidak dapat dijangkau.
      2. Membuat Message Processor tidak dapat dijangkau.
    • Setelah update - lakukan hal berikut:
      1. Buat Message Processor 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 Message Processor:
    • Sebelum update, buat Message Processor tidak dapat dijangkau.
    • Setelah update, buat Message Processor dapat dijangkau.

Menggunakan file konfigurasi senyap

Anda harus meneruskan file konfigurasi otomatis ke perintah update. File konfigurasi otomatis harus sama dengan yang Anda gunakan untuk menginstal Edge 4.17.0x.

Update ke 4.18.05 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

  1. Jika Anda saat ini menggunakan replikasi master-standby Postgres dengan penyimpanan lokal, instal 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, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Jika ada, nonaktifkan cron job yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga update 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 apigee-setup Edge.
  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 yum-configure-manager berikut: 
    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.18.05.sh Edge 4.18.05 ke /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Instal utilitas dan dependensi apigee-service Edge 4.18.05: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.

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

    • I = Instal OpenJDK 1.8 (default)
    • C = Lanjutkan tanpa menginstal Java
    • Q = Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
  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 dalam urutan yang dijelaskan dalam Urutan update mesin: 
    /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 kemungkinan komponen mencakup:

    • "cs" = Cassandra
    • "e" = ElasticSearch
    • "edge" =Semua komponen Edge kecuali Edge UI. Komponen "edge" mencakup Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres Edge.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = Edge UI
    • "zk" = Zookeeper

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Mulai ulang komponen Edge UI di 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 di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
  16. Jika Anda menginstal node standby Postgres baru, nonaktifkan node tersebut seperti yang dijelaskan dalam Menonaktifkan 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 di lain waktu, gunakan prosedur yang dijelaskan dalam Melakukan roll back 4.18.05.

Mengupdate ke 4.18.05 dari repositori 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 mirror, 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 update Edge dari file .tar.
  • Instal server web di node dengan repositori lokal agar 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.18.05 lokal:

  1. Jika saat ini Anda menggunakan replikasi standby master Postgres, instal 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, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Buat repositori 4.18.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
  3. Untuk menginstal apigee-service dari file .tar:
    1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal menjadi satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
    3. Pada node baru, ekstrak file ke direktori /tmp: 
      tar -xzf apigee-4.18.05tar.gz

      Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.

    4. Instal utilitas dan dependensi apigee-service Edge dari /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.18.05.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 dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
    2. Pada node jarak jauh, download file bootstrap_4.18.05.sh Edge ke /tmp/bootstrap_4.18.05.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

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

    3. Pada node jarak jauh, instal utilitas dan dependensi apigee-service Edge: 
      sudo bash /tmp/bootstrap_4.18.05.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 pada node Anda sesuai urutan yang dijelaskan dalam Urutan update mesin: 
    /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 kemungkinan komponen mencakup:

    • "cs" = Cassandra
    • "e" = ElasticSearch
    • "edge" =Semua komponen Edge kecuali Edge UI. Komponen "edge" mencakup Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres Edge.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = Edge UI
    • "zk" = Zookeeper

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Mulai ulang komponen Edge UI di 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 di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
  11. Jika Anda menginstal node standby Postgres baru, nonaktifkan node tersebut seperti yang dijelaskan dalam Menonaktifkan 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 di lain waktu, gunakan prosedur yang dijelaskan dalam Melakukan roll back 4.18.05.

Urutan update mesin

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

  • Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
  • Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Message Processor, Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
  • Jika sebuah langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa mesin, lakukan langkah tersebut dalam urutan mesin yang ditentukan.
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Versi ini akan diperbarui saat Anda menentukan opsi "-c edge".

Penginstalan mandiri 1 node

  1. Perbarui Cassandra dan ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Update Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Memperbarui LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Hentikan 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/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Update postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Perbarui database Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. Update komponen Edge yang tersisa: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Mengupdate Edge UI: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (Jika Anda menginstal Edge SSO) Update Edge SSO: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.

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

Penginstalan mandiri 2 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.

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

    Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.

  7. Update postgresql di mesin 2:
    1. Hentikan 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/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Update postgresql: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Perbarui database Postgres: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Update komponen Edge di mesin 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Mulai ulang komponen Edge UI di mesin 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Penginstalan 5 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge 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, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

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

    Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.

  8. Update 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/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Jika diinstal, hentikan 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. Update postgresql di mesin 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Update database Postgres di mesin 4 (khusus master Postgres): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Update 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 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
    9. Verifikasi status replikasi dengan menjalankan skrip berikut di kedua server. Sistem harus menampilkan hasil yang sama di kedua server untuk memastikan replikasi berhasil:
      • Di mesin 4, node master, jalankan: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Pastikan bahwa pod tersebut adalah master.

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

        Pastikan statusnya adalah standby.

  9. Update komponen Edge di mesin 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.

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

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

Penginstalan berkluster 9 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge 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, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

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

    Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.

  8. Update 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 mesin 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Jika diinstal, hentikan 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. Update postgresql di mesin 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Perbarui database Postgres di mesin 8 (khusus master Postgres): 
      /-->
opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Update postgresql di mesin 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Mulai server Postgres di mesin 8 dan 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai server Qpid di mesin 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 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
    11. Verifikasi status replikasi dengan menjalankan skrip berikut di kedua server. Sistem harus menampilkan hasil yang sama di kedua server untuk memastikan replikasi berhasil:
      • Di mesin 8, node master, jalankan: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Pastikan bahwa pod tersebut adalah master.

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

        Pastikan statusnya adalah standby.

  9. Update komponen Edge di mesin 8 dan 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.

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

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

Penginstalan cluster 13 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge 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, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

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

    Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.

  8. Update 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 mesin 12 dan 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Jika diinstal, hentikan 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. Update postgresql di mesin 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Perbarui database Postgres di mesin 8 (khusus master Postgres): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Update postgresql di mesin 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Mulai server Postgres di mesin 8 dan 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai server Qpid di mesin 12 dan 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurasikan Postgres sebagai node standby dengan menjalankan perintah berikut di mesin 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
    11. Verifikasi status replikasi dengan menjalankan skrip berikut di kedua server. Sistem harus menampilkan hasil yang sama di kedua server untuk memastikan replikasi berhasil:
      • Di mesin 8, node master, jalankan: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Pastikan bahwa pod tersebut adalah master.

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

        Pastikan statusnya adalah standby.

  9. Update komponen Edge di mesin 8 dan 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Pastikan Anda menonaktifkan node standby baru seperti yang dijelaskan dalam Menonaktifkan node Postgres.

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

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

Penginstalan berkluster 12 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge 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, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Lihat Upgrade yang diperlukan ke Postgres 9.6 untuk mengetahui informasi selengkapnya.

  2. Update Cassandra dan ZooKeeper:
    1. Di mesin 1, 2, dan 3 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Di mesin 7, 8, dan 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Update qpidd:
    1. Mesin 4, 5 di Pusat Data 1
      1. Update qpidd di mesin 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 mesin 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Ulangi langkah 1 pada mesin 11.
  4. Memperbarui 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. Perbarui 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 Edge SSO) 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 sebagai file konfigurasi yang Anda buat saat menginstal SSO.

  8. Mengupdate 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. Hentikan 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 mesin 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 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. Update postgresql di mesin 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Update database Postgres di mesin 6 (khusus master Postgres): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Update postgresql di mesin 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Mulai server Postgres di mesin 6 dan 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai server Qpid di mesin 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 di mesin 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
    11. Verifikasi status replikasi dengan menjalankan skrip berikut di kedua server. Sistem akan menampilkan hasil yang sama di kedua server untuk memastikan replikasi berhasil:

      Di mesin 6, node master, jalankan:

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

      Pastikan bahwa pod tersebut adalah master.

      Di mesin 12, node standby:

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

      Pastikan statusnya adalah standby.

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

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

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

Untuk penginstalan non-standar

Jika Anda memiliki penginstalan non-standar, update komponen Edge dengan urutan berikut:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
  6. Edge UI
  7. SSO Edge

Setelah selesai mengupdate, pastikan untuk memulai ulang komponen Edge UI di semua mesin yang menjalankannya.