Mengupdate Apigee Edge 4.16.09 hingga 4.17.01

Edge for 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 ke 4.17.01 menggunakan prosedur ini.

Jika Anda memiliki versi Edge sebelum versi 4.16.01, Anda harus bermigrasi terlebih dahulu ke versi 4.16.01.x, 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 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.

Upgrade yang diperlukan ke Qpid 1.35

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

  • Cegah Router dan Message Processor menulis ke node Qpid untuk sementara dengan memblokir port 5672 pada node Qpid. Anda dapat menggunakan perintah berikut untuk memblokir port ini di node Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -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 bahwa antrean pesan Qpid kosong:
    > qpid-stat -q
  • Mengupdate node Qpid.
  • Berhenti memblokir port 5672 di node Qpid untuk mengizinkan akses dari Router dan Message Processor. 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 `hostname` -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 Anda gunakan 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 memperbarui saat menggunakan autentikasi eksternal

Anda dapat mengintegrasikan layanan direktori eksternal ke dalam penginstalan Apigee Edge cloud pribadi 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, di luar sistem seperti Apigee Edge yang menggunakannya.

Lihat Konfigurasi Autentikasi Eksternal untuk mengetahui informasi selengkapnya.

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

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.

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 akan memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan baik. 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 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 Proses Rollback 4.17.01 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 di bawah dalam "Urutan update mesin".
  2. Saat tiba waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan Jangkauan 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.16.01 atau 4.16.05.

Prosedur untuk mengupdate ke 4.17.01 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

  1. Jika ada, nonaktifkan cron job yang dikonfigurasi untuk melakukan operasi perbaikan pada 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 apigee-setup 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 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 mengambil nilai berikut:

    I = Menginstal OpenJDK 1.8 (default)
    C = Melanjutkan 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. Perbarui utilitas apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. Jalankan utilitas update pada node Anda sesuai 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 mesin (hanya digunakan untuk profil penginstalan aio Edge atau profil penginstalan asa API BaaS)
    e = ElasticSearch
    b = Stack API BaaS
    p = Portal API BaaS
    ebp = ElasticSearch, Stack API BaaS, dan Portal API BaaS pada node yang sama
  11. Uji update dengan menjalankan utilitas apigee-validate di 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 untuk mengupdate ke 4.17.01 dari repositori lokal

Jika node Edge Anda berada di belakang firewall, atau dilarang mengakses repositori Apigee melalui Internet, Anda dapat melakukan update dari repositori lokal, atau mirror, dari repositori 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.17.01 lokal:

  1. Buat repositori 4.17.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
    Catatan: Jika sudah memiliki repo 4.16.09, Anda dapat menambahkan repo 4.17.01 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
  2. Untuk menginstal apigee-service dari file .tar:
    1. Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.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 di node baru.
    3. Pada node baru, untar file ke direktori /tmp:
      > tar -xzf apigee-4.17.01.tar.gz

      Perintah ini 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.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
  3. 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.17.01.sh Edge ke /tmp/bootstrap_4.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.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 apigee-service Edge:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      dengan uName:pWord adalah nama pengguna dan sandi repo.
  4. Gunakan apigee-service untuk memperbarui 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 update
  6. Perbarui utilitas apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Jalankan utilitas update pada node Anda sesuai 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 mesin (hanya digunakan untuk profil penginstalan aio Edge atau profil penginstalan asa API BaaS)
    e = ElasticSearch
    b = Stack API BaaS
    p = Portal API BaaS
    ebp = ElasticSearch, Stack API BaaS, dan Portal API BaaS pada node yang sama
  8. Uji update dengan menjalankan utilitas apigee-validate di 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.

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. File ini diperbarui saat Anda menentukan opsi "-c edge".
  • (Khusus CentOS-6.x dan RedHat-6.x) Di semua node Qpid dengan 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 `hostname` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid:
    > qpid-stat -q

    Terus periksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
  4. Update qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Hapus iptables:
    > sudo iptables -F
  6. Update 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. Perbarui LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Perbarui komponen Edge yang tersisa:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Update Edge UI:
    > /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. Perbarui Cassandra dan ZooKeeper di mesin 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Tetapkan aturan iptables berikut di mesin 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di mesin 2:
    > qpid-stat -q

    Terus periksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
  4. Update qpidd di mesin 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Hapus iptables di mesin 2:
    > sudo iptables -F
  6. Update postgresql di komputer 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. Perbarui 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. Update UI di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan dalam cluster dengan 5 host

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

  1. Perbarui 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 di mesin 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di mesin 4:
    > qpid-stat -q

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

Untuk penginstalan dalam cluster dengan 9 host

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

  1. Perbarui 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 di mesin 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di mesin 6:
    > qpid-stat -q

    Terus periksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
  4. Update qpidd di mesin 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Hapus iptables di mesin 6:
    > sudo iptables -F
  6. Ulangi langkah 2 sampai 5 di komputer 7.
  7. Update 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. Perbarui 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. Update UI di komputer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan berkluster 13 host

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

  1. Perbarui 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 di mesin 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Periksa antrean pesan Qpid di mesin 12:
    > qpid-stat -q

    Terus periksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
  4. Update qpidd di mesin 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Hapus iptables di mesin 12:
    > sudo iptables -F
  6. Ulangi langkah 2 sampai 5 di mesin 13.
  7. Update postgresql di mesin 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Mulai postgresql di komputer 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ulangi langkah 7 dan 8 pada mesin 13.
  10. Perbarui LDAP di mesin 4 dan 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Update komponen Edge pada mesin 12, 13, 8, 9, 6, 7, 10, dan 11 dalam urutan berikut:
    > /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

Untuk penginstalan dalam cluster dengan 12 host

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

  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. Di mesin 7, 8, dan 9 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 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

        Terus periksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
      3. Update qpidd di mesin 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. Mesin 10, 11 di Pusat Data 2
      1. Tetapkan aturan iptables berikut di mesin 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Periksa antrean pesan Qpid di mesin 10:
        > qpid-stat -q

        Terus periksa antrean hingga jumlah di kolom "msg" adalah 0. Anda tidak dapat mengupgrade Qpid sebelum semua pesan diproses.
      3. Update qpidd di mesin 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Hapus iptables di mesin 10:
        > sudo iptables -F
      5. Ulangi langkah 1 hingga 4 pada mesin 11.
  3. Update 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. Update 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, 6, 1, 2, 3 di Pusat Data 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Mesin 10, 11, 12, 7, 8, 9 di Pusat Data 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Mengupdate UI:
    1. Mesin 1 di Pusat Data 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Mesin 7 di Pusat Data 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Untuk penginstalan API BaaS 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 di semua node Stack untuk akses dari semua node Stack lainnya.

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

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

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

Untuk penginstalan API BaaS 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 di semua node Stack untuk akses dari semua node Stack lainnya.

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

  1. Update Cassandra di mesin 8, 9, dan 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Update ElasticSearch di mesin 1, 2, dan 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Update Stack API BaaS di mesin 4, 5, dan 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Update Portal API BaaS di mesin 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" di semua node dalam urutan: node dengan server Qpid, server Postgres, Server Pengelolaan, Message Processor, dan Router.
    Catatan: Jika node telah menginstal server Qpid dan server Postgres, jalankan langkah profil "-c edge".
  6. Edge UI