Update Apigee Edge 4.51.00 atau 4.52.00 ke 4.52.01

Apigee mendukung upgrade Edge untuk Private Cloud dari versi 4.51.00 atau versi 4.52.00 langsung ke versi 4.52.01. Halaman ini menjelaskan cara melakukan upgrade.

Siapa yang dapat melakukan update

Orang yang menjalankan update harus sama dengan orang yang awalnya menginstal Edge, atau orang yang menjalankan sebagai root.

Setelah Anda menginstal RPM Edge, siapa 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.

Memperbarui prasyarat

Pastikan prasyarat berikut 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 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
  • Pastikan Strategi Kompaksi Cassandra adalah LeveledCompactionStrategy
    Pastikan strategi kompresi Cassandra ditetapkan ke LeveledCompactionStrategy, seperti yang dijelaskan dalam Mengubah strategi kompresi Cassandra.

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

Upgrade yang diperlukan ke Zookeeper 3.8.3

Rilis Edge for Private Cloud ini mencakup upgrade ke Zookeeper 3.8.3. Sebagai bagian dari upgrade tersebut, semua data Zookeeper akan dimigrasikan ke Zookeeper 3.8.3.

Sebelum mengupgrade Zookeeper, baca panduan pemeliharaan Zookeeper. Sebagian besar sistem produksi Edge menggunakan cluster node Zookeeper yang tersebar di beberapa pusat data. Beberapa node ini dikonfigurasi sebagai pemilih yang berpartisipasi dalam pemilihan pemimpin Zookeeper, dan sisanya dikonfigurasi sebagai observer. Lihat Tentang pemimpin, pengikut, pemilih, dan pengamat untuk mengetahui detail selengkapnya. Node pemilih memilih pemimpin, lalu node pemilih itu sendiri menjadi pengikut.

Selama proses update, mungkin ada penundaan sesaat atau kegagalan tulis ke Zookeeper saat node pemimpin dimatikan. Hal ini dapat memengaruhi operasi Pengelolaan yang menulis ke Zookeeper, seperti operasi deployment proxy, dan perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll. Tidak akan ada dampak pada API runtime Apigee (kecuali jika API runtime ini memanggil API pengelolaan) selama upgrade Zookeeper saat mengikuti prosedur di bawah.

Pada tingkat tinggi, proses upgrade melibatkan pembuatan cadangan setiap node. Hal ini diikuti dengan mengupgrade semua observer dan follower, lalu akhirnya mengupgrade node pemimpin.

Membuat cadangan

Buat cadangan semua node Zookeeper untuk digunakan jika diperlukan rollback. Perlu diperhatikan bahwa rollback akan memulihkan Zookeeper ke status saat pencadangan dilakukan. Catatan: Deployment atau perubahan infrastruktur apa pun di Apigee sejak pencadangan diambil (yang informasinya disimpan di Zookeeper) akan hilang selama pemulihan. 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Jika Anda menggunakan virtual machine dan memiliki kemampuan tersebut, snapshot atau cadangan VM juga dapat diambil untuk pemulihan atau rollback (jika diperlukan).

Mengidentifikasi pemimpin, pengikut, dan pengamat

Catatan: Contoh perintah di bawah menggunakan utilitas nc untuk mengirim data ke Zookeeper. Anda juga dapat menggunakan utilitas alternatif untuk mengirim data ke Zookeeper.

  1. Jika belum diinstal di node ZooKeeper, instal nc: 
      sudo yum install nc
  2. Jalankan perintah nc berikut di node, dengan 2181 adalah port ZooKeeper: 
      echo stat | nc localhost 2181

    Anda akan melihat output seperti berikut:

      Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    Pada baris Mode output untuk node, Anda akan melihat observer, leader, atau pengikut (yang berarti pemilih yang bukan leader) bergantung pada konfigurasi node. Catatan: Dalam penginstalan Edge mandiri dengan satu node ZooKeeper, Mode disetel ke mandiri.

  3. Ulangi langkah 1 dan 2 di setiap node ZooKeeper.

Mengupgrade Zookeeper di node observer dan follower

Upgrade Zookeeper di setiap node observer dan follower sebagai berikut:

  1. Download dan jalankan bootstrap Edge for Private Cloud 4.52, seperti yang dijelaskan dalam Mengupdate ke 4.52.01 di node dengan koneksi internet eksternal. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda melakukan penginstalan offline.
  2. Upgrade komponen Zookeeper: 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     Catatan: Jika node ini telah menginstal komponen lain (seperti Cassandra), Anda juga dapat mengupgradenya sekarang (seperti dengan profil cs,zk) atau mengupgrade komponen lainnya nanti. Apigee merekomendasikan agar Anda mengupgrade Zookeeper terlebih dahulu dan memastikan cluster Anda berfungsi dengan benar sebelum mengupgrade komponen lainnya.
  3. Ulangi langkah-langkah di atas di setiap node observer dan follower Zookeeper.

Menonaktifkan varian terbaik

Setelah semua node observer dan follower diupgrade, matikan node leader. Pada node yang diidentifikasi sebagai pemimpin, jalankan perintah di bawah: 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Perhatikan bahwa selama peristiwa ini, sebelum pemimpin baru dipilih, mungkin ada penundaan sesaat atau kegagalan operasi tulis di Zookeeper. Hal ini dapat memengaruhi operasi yang menulis ke Zookeeper seperti tindakan deployment proxy atau perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll.

Memverifikasi bahwa pemimpin baru telah dipilih

Dengan menggunakan langkah-langkah di bagian Mengidentifikasi pemimpin, pengikut, dan pengamat di atas, pastikan pemimpin baru telah dipilih dari pengikut, setelah pemimpin yang ada dihentikan. Perhatikan bahwa pemimpin dapat dipilih di pusat data yang berbeda dengan pemimpin saat ini.

Mengupgrade varian terbaik

Ikuti langkah-langkah yang sama seperti dalam Mengupgrade Zookeeper di node observer dan follower di atas.

Setelah node pemimpin lama juga diupgrade, verifikasi status cluster dan pastikan ada node pemimpin.

Rollback

Jika rollback diperlukan:

  1. Lakukan langkah-langkah rollback pada observer dan follower terlebih dahulu.
  2. Download dan jalankan bootstrap versi yang akan Anda rollback—4.50 atau 4.51. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda mengikuti penginstalan offline.
  3. Hentikan Zookeeper jika sedang berjalan di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Uninstal zookeeper yang ada: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Instal Zookeeper seperti biasa: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Setelah semua pengikut dan observer di-roll back, roll back node pemimpin dengan mengikuti langkah 2 hingga 5 di node pemimpin.
  7. Setelah semua node di-rollback, verifikasi status cluster dan pastikan ada node leader di cluster.

Pulihkan cadangan

Lihat Memulihkan dari cadangan. Perhatikan bahwa pencadangan Zookeeper yang diambil dari versi Edge for Private Cloud sebelumnya seperti 4.50 dan 4.51 harus kompatibel dengan versi Zookeeper di Edge for Private Cloud 4.52.

Upgrade yang diperlukan ke Postgres 14

Rilis Edge untuk Private Cloud ini mencakup upgrade ke Postgres 14. Sebagai bagian dari upgrade ini, semua data Postgres dimigrasikan ke Postgres 14.

  • Jika Anda mengupgrade dari Edge for Private Cloud 4.51.00 ke 4.52.01, Anda harus mengikuti langkah-langkah upgrade Postgres tambahan. Lihat bagian Upgrade yang diperlukan ke Postgres 14 jika Anda mengupgrade dari versi 4.51.00 ke 4.52.01.
  • Jika Anda mengupgrade dari Edge for Private Cloud 4.52.00 ke 4.52.01, tidak diperlukan langkah upgrade Postgres tambahan.

Mengupgrade Qpid

Rilis Edge for Private Cloud ini mencakup upgrade ke Qpid J-Broker.

Sebaiknya pilih salah satu metode berikut untuk melakukan upgrade Qpid:

Upgrade langsung tanpa periode nonaktif

Metode ini memastikan tidak ada periode nonaktif untuk lingkungan runtime Edge Anda dan meminimalkan kehilangan data runtime, jika ada, yang diperoleh untuk analisis.

Untuk melakukan upgrade langsung tanpa downtime ke Qpid:

  1. Pilih satu node Qpid untuk memulai.
  2. Hentikan broker Qpid di node: 
    apigee-service apigee-qpidd stop
  3. Blokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini di tingkat instance node Qpid atau beberapa komponen jaringan/firewall eksternal lainnya.

    Sebaiknya lakukan langkah yang sama untuk semua alamat IP pemroses pesan. Misalnya, untuk DROP permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid di port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Mulai ulang broker Qpid untuk menghabiskan pesan yang ada, jika ada: 
    apigee-service apigee-qpidd start
  5. Pastikan antrean yang ada kosong: 
    qpid-stat -q

    Jika pesan macet di antrean pesan mati (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), kosongkan antrean menggunakan langkah-langkah untuk menyelesaikan data analisis yang macet di antrean pesan mati.

  6. Setelah memverifikasi bahwa antrean telah habis di node lama, hentikan apigee-qpidd: 
    apigee-service apigee-qpidd stop
  7. Upgrade Qpid di node: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Mulai ulang edge-qpid-server: 
    apigee-service edge-qpid-server restart

  9. Hapus aturan firewall yang diterapkan di Langkah 3.

    Lakukan langkah penghapusan yang sama untuk semua alamat IP pemroses pesan tempat firewall diterapkan. Setelah firewall dihapus, permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid di port 5672 akan diterima. Jika Anda menggunakan iptables untuk menambahkan firewall, untuk menghapus firewall dan mencantumkan setelan yang ada, Anda dapat menggunakan perintah seperti berikut:

    iptables -F
  iptables -L
  10. Gunakan pemantauan web untuk memverifikasi bahwa antrean Qpid menerima pesan: 
    http://QPID_NODE_IP:8090
  11. Ulangi Langkah 1 hingga 9 untuk setiap node Qpid.

Mengaktifkan node Qpid baru

Metode ini menyiapkan dan menginstal apigee-qpidd dan edge-qpid-server di node baru.

  1. Tambahkan node Qpid baru. Langkah ini menyiapkan node Qpid dengan J-broker. Untuk mengetahui langkah-langkah mendetail, lihat Menambahkan server Qpid.
  2. Pilih node Qpid yang ada (node dari versi yang Anda upgrade).
  3. Hentikan broker Qpid di node: 
    apigee-service apigee-qpidd stop
  4. Blokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini di tingkat instance node Qpid atau beberapa komponen jaringan/firewall eksternal lainnya.

    Sebaiknya lakukan langkah yang sama untuk semua alamat IP pemroses pesan. Misalnya, untuk DROP permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid di port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. Mulai ulang broker Qpid untuk menghabiskan pesan yang ada, jika ada: 
    apigee-service apigee-qpidd start
  6. Periksa untuk memastikan antrean yang ada kosong: 
    qpid-stat -q

    Jika pesan macet di antrean pesan tidak terkirim (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), kosongkan antrean dengan mengikuti langkah-langkah dalam topik pemecahan masalah Data Analytics macet di antrean pesan tidak terkirim Qpidd.

  7. Setelah memverifikasi bahwa antrean telah habis di node lama, hentikan apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. Batalkan pendaftaran node Qpid lama dengan mengikuti langkah-langkah di Menghapus server Qpid.
  9. Terus tambahkan node baru dan hapus node lama, satu per satu, hingga semua node Qpid telah diupgrade.

Rollback

Untuk melakukan rollback ke Rilis Fitur sebelumnya, pastikan untuk mendownload file bootstrap.sh untuk versi yang ingin Anda rollback. Untuk melakukan rollback ke v 4.52.00, download bootstrap_4.52.00.sh.

Untuk melakukan rollback Qpid, ikuti langkah-langkah berikut di semua host Qpid:

  1. Menghentikan broker Qpid yang ada 
    apigee-service apigee-qpidd stop
  2. Blokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini di tingkat instance node Qpid atau beberapa komponen jaringan/firewall eksternal lainnya.

    Sebaiknya lakukan langkah yang sama untuk semua alamat IP pemroses pesan. Misalnya, untuk DROP permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid di port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Mulai broker qpid lagi untuk menghabiskan pesan yang ada jika ada: 
    apigee-service apigee-qpidd start
  4. Pastikan antrean yang ada kosong. Untuk memeriksanya, login ke portal pengelolaan Qpid: 
    http://QPID_NODE_IP:8090
     Catatan: Jika port 8090 di node QPID ini tidak dapat diakses, Anda dapat menggunakan mekanisme alternatif seperti penerusan port SSH untuk mengakses URL ini.
  5. Setelah memverifikasi bahwa antrean telah habis, hentikan dan uninstal Qpid: 
    apigee-service apigee-apidd uninstall
  6. Hapus direktori data Qpid: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Instal ulang broker Qpid: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Setelah broker Qpid diinstal ulang, hapus setelan firewall dan cantumkan setelan yang ada menggunakan perintah berikut: 
    iptables -F
     
    iptables -L

UI Edge Baru

Bagian ini mencantumkan pertimbangan terkait UI Edge. Untuk informasi selengkapnya, lihat UI Edge baru untuk Cloud Pribadi.

Menginstal UI Edge

Setelah menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal UI Edge, yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge untuk Private Cloud.

Perhatikan bahwa UI Edge mengharuskan Anda menonaktifkan Autentikasi dasar dan menggunakan IDP seperti SAML atau LDAP.

Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.

Mengupdate UI Edge

Untuk mengupdate komponen UI Edge, pertimbangkan versi Edge untuk Private Cloud yang Anda upgrade:

Memperbarui dengan mTLS Apigee

Untuk mengupdate mTLS Apigee , lakukan langkah-langkah berikut:

Me-roll back update

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

Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.52.00 untuk mengetahui petunjuk mendetail.

Mencatat informasi pembaruan

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

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

Jika orang 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 orang tersebut 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 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 mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan 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 keterjangkauan server (Message Processor/Router).
  3. Perbarui Router yang dipilih dan semua komponen Edge lainnya di komputer 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 komputer yang tersisa dalam penginstalan Anda.

Lakukan hal berikut sebelum dan sesudah update:

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.50.00 atau 4.51.00.

Mengupdate ke 4.52.01 di node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge di node:

  1. Jika ada, nonaktifkan tugas cron yang dikonfigurasi untuk melakukan operasi perbaikan di Cassandra hingga setelah update selesai.
  2. Login ke node sebagai root untuk menginstal RPM Edge.
  3. Instal yum-utils dan yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
  5. Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Jika Anda menginstal di AWS, jalankan perintah yum-configure-manager berikut: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  7. Jika saat ini Anda menggunakan Edge 4.51.00:

    1. Download file bootstrap_4.52.01.sh Edge ke /tmp/bootstrap_4.52.01.sh: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. Instal utilitas dan dependensi apigee-service Edge 4.52.01 dengan menjalankan perintah berikut: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

      Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, penginstal akan menginstalnya untuk Anda.

      Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX menggunakan nilai berikut:

      • I: Menginstal OpenJDK 1.8 (default).
      • C: Lanjutkan tanpa menginstal Java.
      • Q: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
    3. Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Jalankan utilitas update di node Anda dengan menjalankan perintah berikut: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Lakukan hal ini dalam urutan yang dijelaskan dalam Urutan update mesin.

      Dengan keterangan:

      • component adalah komponen Edge yang akan diperbarui. Nilai yang memungkinkan mencakup:
        • cs: Cassandra
        • edge: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO Apigee (jika Anda menginstal SSO)
        • ue: UI Edge baru
        • ui: UI Edge Klasik
        • zk: Zookeeper
      • configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Mulai ulang komponen UI Edge di semua node yang menjalankannya, jika Anda belum melakukannya: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

Jika nanti Anda memutuskan untuk melakukan rollback update, gunakan prosedur yang dijelaskan di Melakukan rollback 4.52.01.

Mengupdate ke 4.52.01 dari repo lokal

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

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

  • Buat file .tar repo, salin file .tar ke node, lalu update Edge dari file .tar.
  • Instal server web di node dengan repo 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.52.01 lokal:

  1. Buat repo 4.52.01 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
  2. 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.52.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. Di node baru, ekstrak file ke direktori /tmp: 
      tar -xzf apigee-4.52.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.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Perhatikan bahwa Anda menyertakan jalur ke direktori repo dalam perintah ini.

  3. Untuk menginstal apigee-service menggunakan server web Nginx:
    1. Konfigurasikan server web Nginx seperti yang dijelaskan di "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas penyiapan apigee Edge.
    2. Di node jarak jauh, download file bootstrap_4.52.01.sh Edge ke /tmp/bootstrap_4.52.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh

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

    3. Di node jarak jauh, instal utilitas dan dependensi apigee-setup Edge: 
      sudo bash /tmp/bootstrap_4.52.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 mengupdate utilitas apigee-setup, seperti yang ditunjukkan pada contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Jalankan utilitas update di node Anda dalam urutan yang dijelaskan dalam Urutan update mesin: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Dengan keterangan:

    • component adalah komponen Edge yang akan diperbarui. Anda biasanya memperbarui komponen berikut:
      • cs: Cassandra
      • edge: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pemroses Pesan, Router, Server QPID, Server Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO Apigee (jika Anda menginstal SSO)
      • ue UI Edge Baru
      • ui: UI Edge Klasik
      • zk: Zookeeper
    • configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Mulai ulang komponen UI di semua node yang menjalankannya, jika Anda belum melakukannya: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.

Jika nanti Anda memutuskan untuk melakukan rollback update, gunakan prosedur yang dijelaskan di Melakukan rollback 4.52.01.

Urutan update mesin

Urutan pembaruan mesin dalam penginstalan Edge sangat penting:

  • 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 langkah tersebut dalam urutan komputer yang ditentukan.
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Nilai ini diperbarui saat Anda menentukan opsi -c edge.

Upgrade mandiri 1 node

Untuk mengupgrade konfigurasi mandiri 1 node ke 4.52.01:

  1. Perbarui semua komponen: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Upgrade mandiri 2 node

Update komponen berikut untuk penginstalan mandiri 2 node:

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

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

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

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

Upgrade 5 node

Update komponen berikut untuk penginstalan 5 node:

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

  1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Update Postgres di mesin 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update Postgres di mesin 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Perbarui LDAP di mesin 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Update komponen Edge di mesin 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Update Qpid di mesin 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Update Qpid di mesin 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Update UI Edge:
    • UI Klasik: Jika Anda menggunakan UI klasik, update komponen ui di mesin 1, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • UI Edge baru: Jika Anda menginstal UI Edge baru, update komponen ue di komputer yang sesuai (mungkin bukan komputer 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi di komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. Mulai ulang komponen UI:
    • UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 1, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI Edge baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di mesin yang sesuai (mungkin bukan mesin 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade cluster 9 node

Update komponen berikut untuk penginstalan cluster 9 node:

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

  1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Update Postgres di mesin 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update Postgres di mesin 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Perbarui LDAP di mesin 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Update komponen Edge di mesin 6, 7, 8, 9, 1, 4, dan 5 dalam urutan tersebut: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Update Qpid di mesin 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Update UI baru (ue) atau UI klasik (ui) di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Mulai ulang komponen UI:
    • UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 1, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI Edge baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di mesin yang sesuai (mungkin bukan mesin 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade cluster 13 node

Update komponen berikut untuk penginstalan cluster 13 node:

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

  1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Update Postgres di mesin 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update Postgres di mesin 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Perbarui LDAP di mesin 4 dan 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 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
  6. Update Qpid di mesin 12 dan 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Update UI baru (ue) atau UI klasik (ui) di komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi di komputer 6 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Mulai ulang komponen UI:
    • UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 6 dan 7, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI Edge baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di komputer 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade cluster 12 node

Update komponen berikut untuk penginstalan cluster 12 node:

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

  1. Update Cassandra dan ZooKeeper:
    1. Di komputer 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 Postgres:
    1. Mesin 6 di Pusat Data 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Komputer 12 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Memperbarui LDAP:
    1. Mesin 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
  4. Perbarui komponen Edge:
    1. Komputer 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
  5. Update qpidd:
    1. Komputer 4, 5 di Pusat Data 1
      1. Update qpidd di mesin 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Update qpidd di mesin 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Komputer 10, 11 di Pusat Data 2
      1. Update qpidd di mesin 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Update qpidd di mesin 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Update UI baru (ue) atau UI klasik (ui):
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Komputer 7 di Pusat Data 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi:
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Komputer 7 di Pusat Data 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO:
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Komputer 7 di Pusat Data 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Dengan sso_config_file adalah file konfigurasi yang Anda buat saat menginstal SSO.

  9. Mulai ulang komponen UI Edge baru (edge-management-ui) atau UI Edge klasik (edge-ui) di komputer 1 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Untuk konfigurasi non-standar

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

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, Server Postgres Edge, Server Pengelolaan, Pemroses Pesan, dan Router.
  6. qpidd
  7. UI Edge (klasik atau baru)
  8. apigee-adminapi
  9. SSO Apigee

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