Mengupdate Apigee Edge 4.16.09 hingga 4.17.01

Edge untuk Private Cloud v. 4.17.01

Versi Edge mana yang dapat Anda update ke 4.17.01

Anda dapat mengupdate Apigee Edge versi 4.16.09.0x hingga 4.17.01 menggunakan prosedur ini.

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

Siapa yang dapat melakukan update

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

Setelah Anda menginstal RPM Edge, setiap pengguna dapat mengonfigurasinya.

Komponen mana yang harus Anda update

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

Upgrade yang diperlukan ke Qpid 1.35

Rilis ini berisi update yang diperlukan ke Qpid 1.35. Sebagai bagian dari update node Qpid, Anda harus:

  • Untuk sementara, cegah Router dan Pemroses Pesan menulis ke node Qpid dengan memblokir port 5672 pada node Qpid. Anda dapat menggunakan perintah berikut untuk memblokir port ini pada 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 pembaruan. Gunakan perintah berikut untuk memastikan antrean pesan Qpid kosong:
    > qpid-stat -q
  • Update node Qpid.
  • Berhenti memblokir port 5672 pada node Qpid untuk mengizinkan akses dari Router dan Prosesor Pesan. Anda dapat menggunakan perintah berikut untuk membatalkan pemblokiran port ini:
    > sudo iptables -F

    Perhatikan bahwa jika Anda menggunakan iptables untuk aturan lain, Anda dapat menggunakan opsi -D untuk membalikkan perubahan tertentu:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP

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

Diperlukan untuk mengaktifkan repo EPEL

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

  • 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

Diperlukan jika mengupdate saat menggunakan autentikasi eksternal

Anda dapat mengintegrasikan layanan direktori eksternal ke penginstalan Apigee Edge Private Cloud yang ada. Fitur ini dirancang agar 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, di luar 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.01:

IS_EXTERNAL_AUTH="true"

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

Penerapan otomatis setelan properti

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

Perbarui prasyarat

Perhatikan prasyarat berikut sebelum mengupgrade Apigee Edge:

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

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

    > /opt/apigee/apigee-service/bin/apigee-all status

Menangani update yang gagal

Jika terjadi kegagalan update, Anda dapat mencoba memperbaiki masalahnya, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali untuk melanjutkan update dari bagian terakhir yang ditinggalkan.

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

Mencatat informasi update

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

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

Jika pengguna yang menjalankan utilitas update.sh tidak memiliki akses ke direktori tersebut, utilitas tersebut akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

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

Update tanpa periode nonaktif

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

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

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

  1. Perbarui mesin dalam urutan yang benar untuk penginstalan seperti yang dijelaskan di bawah ini di "Urutan update mesin".
  2. Jika sudah waktunya untuk mengupdate Router, pilih satu Router dan buat Router tidak dapat dijangkau, seperti dijelaskan dalam Mengaktifkan/Menonaktifkan 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 Pemroses Pesan pada node yang sama.
  4. Membuat Router dapat dijangkau lagi.
  5. Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
  6. Lanjutkan update untuk komputer lain dalam penginstalan.

Perhatikan hal berikut sebelum/setelah update:

  • Pada gabungan node Router dan Message Processor:
    • Sebelum update – lakukan tindakan berikut:
      1. Membuat Router tidak dapat dijangkau.
      2. Membuat Pemroses Pesan tidak dapat dijangkau.
    • Setelah update - lakukan tindakan berikut:
      1. Membuat Pemroses Pesan dapat dijangkau.
      2. Buat Router dapat dijangkau.
  • Pada node Router tunggal:
    • Sebelum update, buat Router tidak dapat dijangkau.
    • Setelah update, buat Router dapat dijangkau.
  • Pada node Message Processor tunggal:
    • Sebelum update, buat Pemroses Pesan tidak dapat dijangkau.
    • Setelah update, buat Pemroses Pesan dapat dijangkau.

Menggunakan file konfigurasi senyap

Anda harus meneruskan file konfigurasi senyap ke perintah update. File konfigurasi senyap harus sama dengan yang Anda gunakan untuk menginstal Edge 4.16.01 atau 4.16.05.

Prosedur untuk mengupdate ke versi 4.17.01 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

  1. Jika ada, nonaktifkan semua tugas CRON yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga update selesai.
  2. 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.
  3. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
  4. Download file bootstrap_4.17.01.sh Edge 4.17.01 ke /tmp/bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  5. Instal utilitas dan dependensi apigee-service Edge 4.17.01:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

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

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

    I = Install OpenJDK 1.8 (default)
    C = Lanjutkan tanpa menginstal Java
    Q = Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
  6. (Khusus CentOS-6.x dan RedHat-6.x) Di semua node Qpid, jalankan perintah berikut untuk memastikan Anda mendownload versi Qpid yang benar:
    > yum install apigee-qpidd --disablerepo=epel
  7. Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. Update utilitas apigee-validate di Server Pengelolaan:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. Update utilitas apigee-available:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provide
  10. Jalankan utilitas update pada node Anda dalam urutan yang dijelaskan di bawah dalam "Urutan update mesin" di bawah:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Semua komponen kecuali Edge UI: Management Server, Message Processor Edge Processor, Qpid Server, Postgres API Server





  11. Uji update dengan menjalankan utilitas apigee-validate pada Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

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

Prosedur update ke 4.17.01 dari repo lokal

Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui Internet, Anda dapat melakukan update dari repositori lokal, atau pencerminan, repo Apigee.

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

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

Untuk mengupdate dari repo 4.17.01 lokal:

  1. Buat repo 4.17.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan Edge apigee.
    Catatan: Jika sudah memiliki repo 4.16.09, Anda dapat menambahkan repo 4.17.01 ke dalamnya seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
  2. Untuk menginstal layanan apigee dari file .tar:
    1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal menjadi satu file .tar dengan nama /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp pada node baru.
    3. Pada node baru, untar file ke direktori /tmp:
      > tar -xzf apigee-4.17.01.tar.gz

      Perintah ini akan membuat direktori baru, bernama repo, di direktori yang berisi file .tar. Misalnya, /tmp/repo.
    4. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

    3. Pada node jarak jauh, instal utilitas dan dependensi layanan Edge apigee:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=://pWord apigeeprotocol=://pName dan password.

  4. Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Update utilitas apigee-validate di Server Pengelolaan.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
  6. Update utilitas apigee-available:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provide
  7. Jalankan utilitas update pada node Anda dalam urutan yang dijelaskan di bawah pada "Urutan update mesin" di bawah:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    Gunakan opsi “-c” untuk menentukan komponen yang akan diupdate. Daftar komponen yang mungkin mencakup:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Semua komponen kecuali Edge UI: Management Server, Message Processor Edge Processor, Qpid Server, Postgres API Server





  8. Uji update dengan menjalankan utilitas apigee-validate pada Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

Untuk melakukan rollback update nanti, gunakan prosedur yang dijelaskan pada Proses Rollback 4.16.09.

Urutan update mesin

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

  • Anda harus memperbarui semua node Cassandra dan ZooKeeper sebelum memperbarui node lainnya.
  • Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Prosesor Pesan, Router, Server QPID, tetapi tidak Server Postgres), gunakan opsi "-c edge" untuk mengupdate semuanya secara bersamaan.
  • Jika sebuah langkah menentukan bahwa tindakan tersebut harus dilakukan pada beberapa mesin, jalankan sesuai urutan mesin yang ditentukan.
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Ini diupdate saat Anda menentukan opsi "-c edge".
  • (Khusus CentOS-6.x dan RedHat-6.x) Di semua node Qpid yang memiliki koneksi internet eksternal, pastikan Anda menjalankan perintah berikut untuk mendownload versi Qpid yang benar seperti yang ditunjukkan di atas:
    > yum install apigee-qpidd --disablerepo=epel

Untuk penginstalan mandiri 1-host

  1. Update Cassandra dan ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Tetapkan aturan iptables berikut:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid:
    > qpid-stat -q

    Lanjutkan untuk memeriksa antrean hingga hitungan di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga selesai memproses semua pesan.
  4. Update qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Flush iptables:
    > sudo iptables -F
  6. Mengupdate postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Mulai postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. Mengupdate LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Update komponen Edge yang tersisa:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Mengupdate 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 dan nomor node Edge.

  1. Update Cassandra dan ZooKeeper di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Tetapkan aturan iptables berikut pada komputer 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di komputer 2:
    > qpid-stat -q

    Lanjutkan untuk memeriksa antrean hingga hitungan di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga selesai memproses semua pesan.
  4. Update qpidd di komputer 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Menghapus iptables di mesin 2:
    > sudo iptables -F
  6. Mengupdate postgresql di mesin 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Mulai postgresql di mesin 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. Mengupdate LDAP di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Update komponen Edge di mesin 2 dan 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Mengupdate UI di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan dengan 5 cluster host

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

  1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Tetapkan aturan iptables berikut pada komputer 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di komputer 4:
    > qpid-stat -q

    Lanjutkan untuk memeriksa antrean hingga hitungan di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga selesai memproses semua pesan.
  4. Update qpidd di komputer 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Menghapus iptables di mesin 4:
    > sudo iptables -F
  6. Ulangi langkah 2 sampai 5 pada mesin 5.
  7. Mengupdate postgresql di mesin 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Mulai postgresql di mesin 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ulangi langkah 7 dan 8 pada mesin 5.
  10. Mengupdate LDAP di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge di komputer 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Mengupdate UI di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan dengan 9 cluster host

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

  1. Update Cassandra dan ZooKeeper di komputer 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Tetapkan aturan iptables berikut pada komputer 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di komputer 6:
    > qpid-stat -q

    Lanjutkan untuk memeriksa antrean sampai hitungan di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga selesai memproses semua pesan.
  4. Update qpidd di komputer 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Menghapus iptables di mesin 6:
    > sudo iptables -F
  6. Ulangi langkah 2 sampai 5 pada mesin 7.
  7. Mengupdate postgresql di mesin 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Mulai postgresql di mesin 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ulangi langkah 7 dan 8 pada mesin 7.
  10. Mengupdate LDAP di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge pada mesin 6, 7, 8, 9, 1, 4, dan 5 dalam urutan tersebut:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Mengupdate UI di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan dengan 13 host yang dikelompokkan

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

  1. Update Cassandra dan ZooKeeper di komputer 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Tetapkan aturan iptables berikut pada komputer 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di komputer 12:
    > qpid-stat -q

    Lanjutkan untuk memeriksa antrean sampai hitungan di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga selesai memproses semua pesan.
  4. Update qpidd di komputer 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Menghapus iptables di mesin 12:
    > sudo iptables -F
  6. Ulangi langkah 2 sampai 5 pada mesin 13.
  7. Mengupdate postgresql di mesin 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Mulai postgresql di mesin 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ulangi langkah 7 dan 8 pada mesin 13.
  10. Mengupdate LDAP di mesin 4 dan 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge di komputer 12, 13, 8, 9, 6, 7, 10, dan 11 dalam urutan tersebut:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Mengupdate UI di mesin 6 dan 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan dengan 12 cluster host

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

  1. Update Cassandra dan ZooKeeper:
    1. Pada mesin 1, 2, dan 3 di Pusat Data 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Pada komputer 7, 8, dan 9 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Mengupdate qpidd:
    1. Mesin 4, 5 di Pusat Data 1
      1. Tetapkan aturan iptables berikut pada komputer 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nama host` -i eth0 -j DROP
      2. Periksa antrean pesan Qpid di komputer 4:
        > qpid-stat -q

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

        Lanjutkan untuk memeriksa antrean sampai hitungan di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid hingga selesai memproses semua pesan.
      3. Update qpidd di komputer 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Flush iptables di mesin 10:
        > sudo iptables -F
      5. Ulangi langkah 1 sampai 4 pada mesin 11.
  3. Memperbarui postgresql:
    1. Mesin 6 di Pusat Data 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Mesin 12 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  4. Perbarui LDAP:
    1. Komputer 1 di Pusat Data 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Komputer 7 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Update komponen Edge:
    1. Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Komputer 10, 11, 12, 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

Untuk penginstalan BaaS API 7 host

Anda harus menambahkan dua properti baru ke file konfigurasi sebelum menjalankan prosedur upgrade:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Untuk contoh file konfigurasi lengkap, lihat Penginstalan BaaS API.

Anda juga harus memastikan bahwa port 2551 terbuka pada semua node Stack untuk akses dari semua node Stack lainnya.

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

  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 di mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Mengupdate Portal BaaS API di komputer 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Untuk penginstalan BaaS API 10 host

Anda harus menambahkan dua properti baru ke file konfigurasi sebelum menjalankan prosedur upgrade:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Untuk contoh file konfigurasi lengkap, lihat Penginstalan BaaS API.

Anda juga harus memastikan bahwa port 2551 terbuka pada semua node Stack untuk akses dari semua node Stack lainnya.

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

  1. Mengupdate Cassandra di mesin 8, 9, dan 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Mengupdate ElasticSearch di mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Mengupdate Stack BaaS API di 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, update komponen Edge dengan urutan berikut:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, yang berarti profil "-c edge" pada semua node secara berurutan: node dengan server Qpid, server Postgres, Server Pengelolaan, Prosesor Pesan, dan Router.
    Catatan: Jika node memiliki server Qpid dan server Postgres yang terinstal, jalankan langkah profil "-c edge".
  6. UI Edge