Mengupdate Apigee Edge 4.19.06 atau 4.50.00 ke 4.51.00

Bagian ini menjelaskan cara mengupgrade dari Apigee Edge 4.19.06 atau 4.50.00 ke 4.51.00.

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.

Penerusan otomatis setelan properti

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

Upgrade yang diperlukan ke Postgres 10.17

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

Sebagian besar sistem produksi Edge menggunakan dua node Postgres yang dikonfigurasi untuk replikasi master-standby. Selama proses update, saat node Postgres tidak aktif untuk update, data analisis masih ditulis ke node Qpid. Setelah node Postgres diupdate dan kembali online, data analisis akan dikirim ke node Postgres.

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

  • Jika menggunakan penyimpanan data lokal untuk node Postgres, Anda harus menginstal node standby Postgres baru selama durasi upgrade. Setelah upgrade selesai, Anda dapat menonaktifkan node standby Postgres baru.

    Node standby Postgres tambahan diperlukan jika Anda harus melakukan rollback update karena alasan apa pun. Jika Anda harus melakukan rollback update, node standby Postgres baru akan menjadi node Postgres master setelah rollback. Oleh karena itu, saat Anda menginstal node standby Postgres baru, node tersebut harus berada di node yang memenuhi semua persyaratan hardware server Postgres, seperti yang ditentukan dalam Persyaratan penginstalan Edge.

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

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

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

Menginstal node standby Postgres baru

Prosedur ini membuat server standby Postgres di node baru. Pastikan Anda menginstal server standby Postgres baru untuk versi Edge yang ada (4.19.06 atau 4.50.00), bukan untuk versi 4.51.00.

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

Untuk membuat node standby Postgres baru:

  1. Di master Postgres saat ini, edit file /opt/apigee/customer/application/postgresql.properties untuk menetapkan token berikut. Jika file tersebut tidak ada, buat file tersebut: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Dengan existing_standby_ip adalah alamat IP server standby Postgres saat ini dan new_standby_ip adalah alamat IP node standby baru.

  2. Mulai ulang apigee-postgresql di master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Pastikan node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master. Anda akan melihat baris berikut dalam file tersebut: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Instal server standby Postgres baru:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini guna menentukan hal berikut: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
    3. Lakukan salah satu hal berikut, bergantung pada versi Edge yang Anda gunakan untuk mengupgrade:
      • Jika Anda mengupgrade dari Edge 4.19.06, download file bootstrap_4.19.06.sh Edge ke /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Selanjutnya, instal utilitas dan dependensi apigee-service Edge: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Jika Anda mengupgrade dari Edge 4.50.00, download file bootstrap_4.50.00.sh Edge ke /tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Selanjutnya, instal utilitas dan dependensi apigee-service Edge: 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    4. Gunakan apigee-service untuk menginstal utilitas apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Menginstal Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Di node standby baru, jalankan perintah berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa layar menampilkan mode standby.

Melakukan upgrade Postgres di tempat

Untuk melakukan upgrade langsung ke Postgres 10.17, lakukan langkah-langkah berikut:

  1. Mengupgrade postgres di host master 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Jalankan perintah penyiapan di host master: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Jalankan perintah konfigurasi di host master: 
    apigee-service apigee-postgresql configure
  4. Mulai ulang host master: 
    apigee-service apigee-postgresql restart
  5. Konfigurasikan sebagai master: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Pastikan host master telah dimulai: 
    apigee-service apigee-postgresql wait_for_ready
  7. Hentikan mode standby: 
    apigee-service apigee-postgresql stop
  8. Mengupgrade mode standby.

    Catatan: Jika terjadi error/gagal, langkah ini dapat diabaikan. update.sh akan mencoba memulai server standby dengan konfigurasi yang salah. Jika penginstalan Postgres diupgrade ke 10.17, error ini dapat diabaikan.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Pastikan mode standby dihentikan: 
    apigee-service apigee-postgresql stop
  10. Hapus konfigurasi standby lama: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Siapkan replikasi di server standby: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Setelah menyelesaikan prosedur ini, standby akan berhasil dimulai.

Menonaktifkan node Postgres

Setelah update selesai, nonaktifkan node standby baru:

  1. Pastikan Postgres berjalan: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Jika Postgres tidak berjalan, mulailah: 

    /opt/apigee/apigee-service/bin/apigee-all start

  2. Dapatkan UUID node standby baru dengan menjalankan perintah curl berikut di node standby baru: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Anda akan melihat UUID node di akhir output, dalam bentuk: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Hentikan node standby baru dengan menjalankan perintah berikut di node standby baru: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Di node master Postgres, edit /opt/apigee/customer/application/postgresql.properties untuk menghapus node standby baru dari conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Mulai ulang apigee-postgresql di master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Pastikan node standby baru telah dihapus dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master. Anda hanya akan melihat baris berikut dalam file tersebut: 
    host replication apigee existing_standby_ip/32 trust
  7. Hapus UUID node standby dari ZooKeeper dengan melakukan panggilan Edge Management API berikut di node Server Pengelolaan: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Memperbarui prasyarat

Pastikan prasyarat berikut terpenuhi sebelum mengupgrade Apigee Edge:

  • Cadangkan semua node
    Sebelum mengupdate, sebaiknya Anda melakukan 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

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:

  • Dari 4.19.06 atau 4.50.00 ke 4.51.00 (dengan UI Edge baru yang sudah diinstal): Gunakan petunjuk upgrade di bagian ini untuk komponen edge-management-ui.

Melakukan update dengan mTLS Apigee

Untuk mengupdate mTLS Apigee , lakukan langkah-langkah berikut:

Me-roll back update

Jika update gagal, Anda dapat mencoba memperbaiki masalah, 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.51.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. Update 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.19.06 atau 4.50.00.

Mengupdate ke 4.51.00 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 pada 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. Download file bootstrap_4.51.00.sh Edge 4.51.00 ke /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Instal utilitas dan dependensi apigee-service Edge 4.51.00 dengan menjalankan perintah berikut: 
    sudo bash /tmp/bootstrap_4.51.00.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.
  9. Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan dalam contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. 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, Prosesor 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.19.06 atau 4.50.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
  13. Mulai ulang komponen UI Edge di semua node yang menjalankannya, jika Anda belum melakukannya: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. 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.51.00.

Mengupdate ke 4.51.00 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.51.00 lokal:

  1. Buat repo 4.51.00 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.51.00.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.51.00.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.51.00.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.51.00.sh Edge ke /tmp/bootstrap_4.51.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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.51.00.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 dalam 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.19.06 atau 4.50.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.51.00.

Urutan update mesin

Urutan Anda mengupdate mesin dalam penginstalan Edge sangatlah 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 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.51.00:

  1. Perbarui semua komponen: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Jika Anda menginstal apigee-adminapi) Memperbarui 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 Qpid dan Postgres di komputer 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. Perbarui LDAP di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Perbarui komponen Edge di mesin 2 dan 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Update UI di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi di komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Jika Anda menginstal Apigee SSO) Perbarui 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.

  8. 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 Qpid dan Postgres di mesin 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Update Qpid dan Postgres di komputer 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. Perbarui LDAP di komputer 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. Memperbarui 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
  7. (Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi di komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal Apigee SSO) Perbarui 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:
    • 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 Qpid di komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Update Postgres di komputer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Update Postgres di komputer 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Perbarui LDAP di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  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) Perbarui 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 Qpid di mesin 12 dan 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Update Postgres di komputer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Update Postgres di komputer 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Perbarui LDAP di komputer 4 dan 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  7. Perbarui 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 komputer 7, 8, dan 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Update qpidd:
    1. Komputer 4, 5 di Pusat Data 1
      1. Perbarui 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. Perbarui qpidd di komputer 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Memperbarui qpidd di mesin 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Update Postgres:
    1. Mesin 6 di Pusat Data 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Mesin 12 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Memperbarui LDAP:
    1. Komputer 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. Komputer 10, 11, 12, 7, 8, 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Perbarui UI baru (ue) atau UI klasik (ui):
    1. Komputer 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) Memperbarui utilitas apigee-adminapi:
    1. Komputer 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. Komputer 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. qpidd, 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. UI Edge (klasik atau baru)
  7. apigee-adminapi
  8. SSO Apigee

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