Mengupdate Apigee Edge 4.16.01/4.16.05 hingga 4.17.09

Edge for Private Cloud v. 4.17.09

Versi Edge mana yang dapat Anda update ke 4.17.09

Anda dapat mengupdate Apigee Edge versi 4.16.01.0x dan 4.16.05.x ke 4.17.09 menggunakan prosedur ini.

Jika memiliki versi Edge sebelum versi 4.16.01, Anda harus bermigrasi terlebih dahulu ke versi 4.16.01, lalu mengupdate ke versi 4.17.09.

  • Anda dapat memigrasikan Apigee Edge versi 4.15.07 ke 4.16.01.
  • Jika memiliki versi Edge sebelum versi 4.15.07, Anda harus bermigrasi terlebih dahulu ke versi 4.15.07, lalu ke versi 4.16.01.
    • Jika Anda bermigrasi dari Edge versi 4.14.04 atau yang lebih baru: Langsung bermigrasi ke versi 4.15.07.
    • Jika bermigrasi dari Edge versi 4.14.01: Anda harus bermigrasi ke versi 4.14.04 terlebih dahulu, lalu bermigrasi ke versi 4.15.07.

Siapa yang dapat melakukan update

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

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

Komponen mana yang harus Anda perbarui

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

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. Di versi Edge berikutnya, versi Zookeeper diubah kembali menjadi apigee-zookeeper-3.4.5-0.0.94x. Hal ini mencegah yum mengupgrade Zookeeper ke versi yang lebih baru dari 4.16.01. Cara 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.

Penerusan otomatis setelan properti

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

Memperbarui prasyarat

Pastikan prasyarat berikut terpenuhi sebelum mengupgrade Apigee Edge:

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

    Hal ini memungkinkan Anda memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan benar. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
  • 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 update gagal, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari tempat terakhir update berhenti.

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

Mencatat informasi pembaruan

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.

Upgrade yang diperlukan ke Java JDK Versi 8

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

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

Diperlukan untuk mengaktifkan repo EPEL

Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge. Perintah yang Anda gunakan bergantung pada versi RedHat/CentOS:

  • Untuk RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Untuk RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Penambahan parameter konfigurasi SMTPMAILFROM yang diperlukan

Edge 4.17.05 menambahkan parameter baru yang diperlukan ke file konfigurasi yang digunakan saat Anda mengaktifkan server SMTP. Jika mengupdate dari versi 4.17.01, Anda harus menetapkan SMTPMAILFROM dalam file konfigurasi saat mengaktifkan server SMTP.

API BaaS versi 4.17.09 juga menambahkan dukungan untuk properti SMTPMailFROM. Saat mengupdate API BaaS, Anda harus menetapkan SMTPMAILFROM dalam file konfigurasi.

Parameter ini memiliki bentuk:

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

Wajib jika diupdate saat menggunakan autentikasi eksternal

Anda dapat mengintegrasikan layanan direktori eksternal ke dalam penginstalan Private Cloud Apigee Edge yang ada. Fitur ini dirancang untuk berfungsi dengan layanan direktori apa pun yang mendukung LDAP, seperti Active Directory, OpenLDAP, dan lainnya. Solusi LDAP eksternal memungkinkan administrator sistem mengelola kredensial pengguna dari layanan pengelolaan direktori terpusat, yang bersifat eksternal terhadap sistem seperti Apigee Edge yang menggunakannya.

Lihat Konfigurasi Autentikasi Eksternal untuk mengetahui informasi selengkapnya.

Saat autentikasi eksternal diaktifkan, sebagian besar pelanggan menggunakan kolom nama akun SAM Active Directory sebagai nama pengguna untuk autentikasi, bukan alamat email yang digunakan oleh server OpenLDAP Edge.

Jika Anda telah berintegrasi dengan layanan direktori eksternal, tambahkan baris berikut ke file konfigurasi saat mengupdate Edge ke 4.17.09:

IS_EXTERNAL_AUTH="true"

Baris ini mengonfigurasi Edge untuk mendukung nama akun, bukan alamat email, sebagai nama pengguna.

Upgrade yang diperlukan ke Qpid 1.35

Rilis ini berisi update wajib untuk Qpid 1.35. Sebagai bagian dari update node Qpid, Anda harus:

  • Cegah Router dan Message Processor menulis ke node Qpid untuk sementara dengan memblokir port 5672 di node Qpid. Anda dapat menggunakan perintah berikut untuk memblokir port ini di node Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  • Tunggu hingga antrean Qpid kosong dari pesan untuk memastikan bahwa node Qpid telah memproses semua pesan sebelum update. Gunakan perintah berikut untuk memastikan antrean pesan Qpid kosong:
    > qpid-stat -q
  • Update node Qpid.
  • Hapus pemblokiran port 5672 di node Qpid untuk mengizinkan akses dari Router dan Message Processor. Anda dapat menggunakan perintah berikut untuk berhenti memblokir port ini:
    > sudo iptables -F

    Perlu diperhatikan bahwa jika menggunakan iptables untuk aturan lain, Anda dapat menggunakan opsi -D untuk membatalkan perubahan tertentu:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Proses ini dijelaskan secara mendetail di bawah untuk setiap topologi Edge.

Upgrade yang diperlukan ke Postgres 9.4

Rilis Edge ini mencakup upgrade ke Postgres 9.4. Sebagai bagian dari upgrade tersebut, semua data Postgres dimigrasikan ke Postgres 9.4.

Selama proses update, saat node Postgres tidak aktif untuk update, data analisis masih ditulis ke node Qpid. Setelah node Postgres diupdate dan kembali online, data analytics akan dikirim ke node Postgres.

Node standby Postgres tambahan diperlukan jika Anda harus melakukan rollback update karena alasan apa pun. Jika Anda harus melakukan rollback 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.

Menginstal node standby Postgres baru

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

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

Untuk membuat node standby Postgres baru:

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

    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee 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 Edge versi saat ini guna menentukan hal berikut:

      # Alamat IP master saat ini:
      PG_MASTER=192.168.56.103
      # Alamat IP node standby baru
      PG_STANDBY=192.168.56.102
    2. Nonaktifkan SELinux seperti yang dijelaskan di Menginstal utilitas apigee-setup Edge.
    3. Download file bootstrap_4.16.05.sh Edge ke /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Catatan: Jika Anda mengupdate dari 4.16.01, download file bootstrap.sh Edge.
    4. Instal utilitas dan dependensi layanan apigee Edge:
      > 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 yang baru, jalankan perintah berikut:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasikan bahwa yang dinyatakan adalah standby.

Menonaktifkan node Postgres

Setelah update selesai, hentikan 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 dari node standby standby baru dengan menjalankan perintah cURL berikut pada node standby baru dengan menjalankan perintah cURL berikut pada node standby baru:
    > curl -u sysAdminEmail:password:password http://<node_IP>:8084/v1/servers/self standby baru dengan menjalankan perintah cURL berikut pada node standby baru:.



  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 yang baru telah dihapus dengan menampilkan file /opt/apigee/apigee-postgresql/conf/pg_hba.conf pada master. Anda hanya akan melihat baris berikut dalam file tersebut:
    host replication apigee existing_slave_ip/32 trust
  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>

Update tanpa periode nonaktif

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

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

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

  1. Update komputer dalam urutan yang benar untuk penginstalan Anda, seperti yang dijelaskan di bawah ini dalam "Urutan update mesin".
  2. Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan Kemampuan Dijangkau Server (Pemroses Pesan/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 pembaruan untuk komputer apa pun yang tersisa dalam pemasangan Anda.

Lakukan 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 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 diupdate, pastikan Router dapat dijangkau.
  • Pada satu node Message Processor:
    • 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 4.17.09 di node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge di node:

  1. Jika saat ini Anda menggunakan replik master-standby Postgres, instal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
  2. Jika ada, nonaktifkan semua tugas CRON yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga update selesai.
  3. Login ke node sebagai root untuk menginstal RPM Edge.
    Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
  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 penyiapan apigee Edge.
  6. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  7. Jika Anda menginstal di AWS, jalankan perintah yum-configure-manager berikut:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Download file bootstrap_4.17.09.sh Edge 4.17.09 ke /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  9. Instal utilitas dan dependensi apigee-service Edge 4.17.09:
    > sudo bash /tmp/bootstrap_4.17.09.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 tidak, aplikasi 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 memperbarui utilitas apigee-setup:
    1. Jika Anda menginstal 4.16.01 dengan mengupgrade Edge versi 4.15.07.0x, Anda harus menginstal utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Perintah ini menginstal utilitas update.sh di /opt/apigee/apigee-setup/bin.

      Jika Anda telah menginstal utilitas apigee-setup, update utility tersebut:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Jika Anda menginstal 4.16.01 secara langsung, yang berarti Anda tidak melakukan upgrade dari 4.15.07.0x, Anda harus mengupdate utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Update ini ke apigee-service akan menginstal utilitas update.sh di /opt/apigee/apigee-setup/bin.
    3. Jika Anda menginstal 4.16.05 secara langsung atau melalui update, Anda harus mengupdate utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Update ini ke apigee-service akan menginstal utilitas update.sh di /opt/apigee/apigee-setup/bin.
  11. Bergantung pada versi Edge saat ini, Anda harus menginstal atau mengupdate utilitas apigee-validate di Server Pengelolaan.
    1. Jika saat ini Anda menggunakan Edge 4.16.05: update utilitas apigee-validate di Server Pengelolaan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Jika saat ini Anda menggunakan Edge 4.16.01: instal utilitas apigee-validate di Server Pengelolaan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Catatan: Jika telah menginstal utilitas apigee-validate di node Message Processor saat menginstal 4.16.01, Anda dapat mengupdatenya menggunakan perintah berikut di node tersebut:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      Namun, mulai versi 4.16.05 dan yang lebih baru, Apigee merekomendasikan agar Anda menginstal dan menjalankan utilitas apigee-validate di Server Pengelolaan.
    3. Jika Anda mengupgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke utilitas apigee-validate. Dalam rilis Edge 4.16.01, file konfigurasi yang digunakan oleh apigee-validate memerlukan properti berikut:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      Dalam rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
  12. Update utilitas apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Jalankan utilitas update di node Anda dalam urutan yang dijelaskan di bawah dalam "Urutan update komputer" di bawah:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".

    Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pemroses Pesan, Router, Server QPID, Server Postgres
    ui = UI Edge
    all = mengupdate semua komponen di komputer (hanya gunakan untuk profil penginstalan aio Edge atau profil penginstalan asa API BaaS)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack, dan API BaaS Portal di node yang sama
  14. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
  15. Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas dalam Menonaktifkan node Postgres.

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

Prosedur untuk mengupdate ke 4.17.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 duplikasi repo Apigee.

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

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

Untuk mengupdate dari repo 4.17.09 lokal:

  1. Jika saat ini Anda menggunakan replik master-standby Postgres, instal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
  2. Buat repo 4.17.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, Anda dapat menambahkan repo 4.17.09 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
  3. Untuk menginstal apigee-service dari file .tar:
    1. Di node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
    3. Di node baru, ekstrak file ke direktori /tmp:
      > tar -xzf apigee-4.17.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 layanan apigee Edge dari /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Perhatikan bahwa Anda menyertakan jalur ke direktori repo dalam perintah ini.
  4. Untuk menginstal layanan apigee menggunakan server web Nginx:
    1. Konfigurasikan server web Nginx seperti yang dijelaskan di "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
    2. Di node jarak jauh, download file bootstrap_4.17.09.sh Edge ke /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS dari node repo.
    3. Pada node jarak jauh, instal utilitas dan dependensi Edge apigee-service:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotokol: http://

  5. Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
    1. Jika Anda menginstal 4.16.01 dengan mengupgrade Edge versi 4.15.07.0x, Anda harus menginstal utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Perintah ini menginstal utilitas update.sh di /opt/apigee/apigee-setup/bin.

      Jika Anda telah menginstal utilitas apigee-setup, update utility tersebut:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    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 apigee-setup update

      Update ini untuk apigee-setup/apige-setup di utilitas apigee/setup
    3. Jika Anda menginstal 4.16.05 secara langsung atau melalui update, Anda harus mengupdate utilitas apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Update ini ke apigee-service akan menginstal utilitas update.sh di /opt/apigee/apigee-setup/bin.
  6. Bergantung pada versi Edge saat ini, Anda harus menginstal atau mengupdate utilitas apigee-validate di Server Pengelolaan.
    1. Jika saat ini Anda menggunakan Edge 4.16.05: update utilitas apigee-validate di Server Pengelolaan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Jika saat ini Anda menggunakan Edge 4.16.01: instal utilitas apigee-validate di Server Pengelolaan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Catatan: Jika telah menginstal utilitas apigee-validate di node Message Processor saat menginstal 4.16.01, Anda dapat mengupdatenya menggunakan perintah berikut di node tersebut:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      Namun, mulai versi 4.16.05 dan yang lebih baru, Apigee merekomendasikan agar Anda menginstal dan menjalankan utilitas apigee-validate di Server Pengelolaan.
    3. Jika Anda mengupgrade dari 4.16.01: Edit file konfigurasi yang diteruskan ke utilitas apigee-validate. Dalam rilis Edge 4.16.01, file konfigurasi yang digunakan oleh apigee-validate memerlukan properti berikut:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      Dalam rilis ini, file konfigurasi hanya memerlukan properti APIGEE_ADMINPW. Anda dapat menghapus dua properti lainnya dari file.
  7. Update utilitas apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Jalankan utilitas update di node Anda dalam urutan yang dijelaskan di bawah dalam "Urutan update mesin" di bawah:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".

    Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pemroses Pesan, Router, Server QPID, Server Postgres
    ui = UI Edge
    all = mengupdate semua komponen di komputer (hanya gunakan untuk profil penginstalan aio Edge atau profil penginstalan asa API BaaS)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack, dan API BaaS Portal di node yang sama
  9. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
  10. Jika Anda menginstal node standby Postgres baru, nonaktifkan node seperti yang dijelaskan di atas dalam Menonaktifkan node Postgres.

Untuk melakukan rollback update nanti, gunakan prosedur yang dijelaskan di 4.17.09 Proses Rollback.

Urutan update mesin

Urutan Anda mengupdate mesin dalam penginstalan Edge sangatlah 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, Pemroses Pesan, Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
  • Jika langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa komputer, lakukan dalam urutan komputer yang ditentukan.
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Nilai ini diperbarui saat Anda menentukan opsi "-c edge".

Untuk penginstalan mandiri 1 host

  1. Tetapkan SMTPMAILFROM di file konfigurasi jika Anda telah mengaktifkan SMTP di Edge. Parameter ini memiliki bentuk:
    SMTPMailFROM="Perusahaan Saya <myco@company.com>"
  2. Jika mengupdate dari 4.16.01, downgrade Zookeeper:
    > yum downgrade apigee-zookeeper
  3. Update Cassandra dan ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Tetapkan aturan iptables berikut:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. Periksa antrean pesan Qpid:
    > qpid-stat -q

    Lanjutkan memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga memproses semua pesan.
  6. Update qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Flush iptables:
    > sudo iptables -F
  8. Perbarui LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 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
  10. Update postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Update database Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. Perbarui komponen Edge lainnya:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Memperbarui UI Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan mandiri 2 host

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

  1. Tetapkan SMTPMailFROM di file konfigurasi jika Anda telah mengaktifkan SMTP di Edge. Parameter ini memiliki format:
    SMTPMAILFROM="Perusahaan Saya <myco@company.com>"
  2. Jika mengupdate dari 4.16.01, downgrade Zookeeper di mesin 1:
    > yum downgrade apigee-zookeeper
  3. Update Cassandra dan ZooKeeper di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Tetapkan aturan iptables berikut di mesin 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. Periksa antrean pesan Qpid di komputer 2:
    > qpid-stat -q

    Lanjutkan memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga memproses semua pesan.
  6. Update qpidd di komputer 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Hapus iptables di mesin 2:
    > sudo iptables -F
  8. Perbarui LDAP di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Update komponen Edge di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Update UI pada komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. Update postgresql di komputer 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. Update database Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Update komponen Edge di komputer 2 dan komputer 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Update komponen Edge di perangkat 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Untuk penginstalan cluster 5 host

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

  1. Tetapkan SMTPMAILFROM di file konfigurasi jika Anda telah mengaktifkan SMTP di Edge. Parameter ini memiliki format:
    SMTPMAILFROM="Perusahaan Saya <myco@company.com>"
  2. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
  3. Jika mengupdate dari 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3:
    > yum downgrade apigee-zookeeper
  4. Update Cassandra dan ZooKeeper di komputer 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Tetapkan aturan iptables berikut di mesin 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Periksa antrean pesan Qpid di mesin 4:
    > qpid-stat -q

    Lanjutkan memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
  7. Update qpidd di komputer 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Hapus iptables di mesin 4:
    > sudo iptables -F
  9. Ulangi langkah 5 hingga 8 pada mesin 5.
  10. Perbarui LDAP di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge di mesin 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Memperbarui UI di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Perbarui mesin 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. 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 komputer 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 menerbitkan skrip berikut di kedua server. Sistem akan menampilkan hasil yang identik di kedua server untuk memastikan replika berhasil:

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

      Validasi bahwa node tersebut adalah master.

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

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

Untuk penginstalan cluster 9 host

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

  1. Tetapkan SMTPMAILFROM di file konfigurasi jika Anda telah mengaktifkan SMTP di Edge. Parameter ini memiliki format:
    SMTPMAILFROM="Perusahaan Saya <myco@company.com>"
  2. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
  3. Jika mengupdate dari 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3:
    > yum downgrade apigee-zookeeper
  4. Update Cassandra dan ZooKeeper pada komputer 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Tetapkan aturan iptables berikut di mesin 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Periksa antrean pesan Qpid di komputer 6:
    > qpid-stat -q

    Lanjutkan untuk memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga memproses semua pesan.
  7. Update qpidd di mesin 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Hapus iptables di komputer 6:
    > sudo iptables -F
  9. Ulangi langkah 5 sampai 8 di mesin 7.
  10. Perbarui LDAP di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge pada perangkat 6, 7, 1, 4, dan 5 dalam urutan tersebut:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Memperbarui UI di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Update mesin 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. 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. Mengupdate database Postgres di komputer 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 server Postgres di komputer 8 dan 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai 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 di komputer 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlon setup-replication apigee-postgresqlconfigFile
    11. Verifikasi status replikasi dengan menerbitkan skrip berikut di kedua server. Sistem akan menampilkan hasil yang identik di kedua server untuk memastikan replika berhasil:
      Di mesin 8, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa node tersebut adalah master.

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

      Pastikan bahwa node tersebut adalah standby.
  14. Update komponen Edge di mesin 8 dan 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas dalam Menghentikan node Postgres.

Untuk penginstalan cluster 13 host

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

  1. Tetapkan SMTPMailFROM di file konfigurasi jika Anda telah mengaktifkan SMTP di Edge. Parameter ini memiliki format:
    SMTPMAILFROM="Perusahaan Saya <myco@company.com>"
  2. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
  3. Jika mengupdate dari 4.16.01, downgrade Zookeeper di mesin 1, 2, dan 3:
    > yum downgrade apigee-zookeeper
  4. Update Cassandra dan ZooKeeper di komputer 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Tetapkan aturan iptables berikut di mesin 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  6. Periksa antrean pesan Qpid di mesin 12:
    > qpid-stat -q

    Lanjutkan memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga memproses semua pesan.
  7. Update qpidd di mesin 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Hapus iptables di komputer 12:
    > sudo iptables -F
  9. Ulangi langkah 5 hingga 8 di mesin 13.
  10. Perbarui LDAP di komputer 4 dan 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge di mesin 12, 13, 6, 7, 10, dan 11 dalam urutan tersebut:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Update UI di mesin 6 dan 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Update 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. 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. Mengupdate database Postgres di komputer 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 komputer 8 dan 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Mulai 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 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 menerbitkan skrip berikut di kedua server. Sistem akan menampilkan hasil yang identik di kedua server untuk memastikan replika berhasil:
      Di mesin 8, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Validasi bahwa node tersebut adalah master.

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

      Pastikan bahwa node tersebut adalah standby.
  14. Update komponen Edge di mesin 8 dan 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Pastikan Anda menonaktifkan node standby baru menggunakan prosedur di atas dalam Menghentikan node Postgres.

Untuk penginstalan cluster 12 host

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

  1. Tetapkan SMTPMAILFROM di file konfigurasi jika Anda telah mengaktifkan SMTP di Edge. Parameter ini memiliki bentuk:
    SMTPMailFROM="Perusahaan Saya <myco@company.com>"
  2. Pastikan Anda telah menginstal node standby Postgres baru seperti yang dijelaskan di atas dalam Menginstal node standby Postgres baru.
  3. Update Cassandra dan ZooKeeper:
    1. Jika mengupdate dari versi 4.16.01, downgrade Zookeeper di macine 1, 2, dan 3 di Pusat Data 1:
      > yum downgrade apigee-zookeeper
    2. Di komputer 1, 2, dan 3 di Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Jika mengupdate dari versi 4.16.01, downgrade Zookeeper di macine 7, 8, dan 9 di Pusat Data 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
  4. Update qpidd:
    1. Mesin 4, 5 di Pusat Data 1
      1. Tetapkan aturan iptables berikut di mesin 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Periksa antrean pesan Qpid di mesin 4:
        > qpid-stat -q

        Lanjutkan memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga memproses semua pesan.
      3. Update qpidd di komputer 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Hapus iptables di mesin 4:
        > sudo iptables -F
      5. Ulangi langkah 1 hingga 4 di mesin 5.
    2. Komputer 10, 11 di Pusat Data 2
      1. Tetapkan aturan iptables berikut pada mesin 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Periksa antrean pesan Qpid di komputer 10:
        > qpid-stat -q

        Lanjutkan memeriksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum proses ini selesai memproses semua pesan.
      3. Update qpidd di komputer 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Hapus iptables di komputer 10:
        > sudo iptables -F
      5. Ulangi langkah 1 hingga 4 di komputer 11.
  5. Memperbarui LDAP:
    1. Komputer 1 di Pusat Data 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Komputer 7 di Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Update komponen Edge:
    1. Komputer 4, 5, 1, 2, 3 di Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Komputer 10, 11, 7, 8, 9 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Memperbarui UI:
    1. Komputer 1 di Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Komputer 7 di Data Center 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Update mesin 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 di komputer 4, 5, 10, dan 11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. 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 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 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 menerbitkan skrip berikut di kedua server. Sistem harus menampilkan hasil yang identik di kedua server untuk memastikan replikasi berhasil:
      Di komputer 6, node master, jalankan:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Pastikan bahwa node tersebut adalah master.

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

      Validasi bahwa node tersebut adalah node 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 menggunakan prosedur di atas di Menonaktifkan node Postgres.

Untuk penginstalan BaaS API 7 host atau 10 host

Untuk penginstalan non-standar

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. LDAP
  5. Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, tetapi bukan server Postgres, Server Pengelolaan, Pemroses Pesan, dan Router.
    Catatan: Jika node telah 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 standby Postgres.
  9. Edge, yang berarti profil "-c edge" di semua node Qpid dan Postgres gabungan, atau di node Postgres mandiri.