Mengupdate Apigee Edge 4.19.06 atau 4.50.00 ke 4.51.00

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

Siapa yang dapat melakukan pembaruan

Orang yang menjalankan pembaruan harus sama dengan orang yang awalnya menginstal Edge, atau seseorang berlari sebagai {i>root<i}.

Setelah Anda menginstal RPM Edge, siapa pun dapat mengonfigurasinya.

Komponen mana yang harus Anda update

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

Penerapan otomatis setelan properti

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

Upgrade yang diperlukan ke Postgres 10.17

Rilis Edge ini menyertakan upgrade ke Postgres 10.17. Sebagai bagian dari peningkatan 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 tetap yang ditulis ke {i>node<i} Qpid. Setelah node Postgres diperbarui dan kembali online, data analisis kemudian didorong ke node Postgres.

Cara Anda melakukan pembaruan 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 yang baru.

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

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

  • Jika Anda menggunakan penyimpanan jaringan untuk node Postgres, sebagai direkomendasikan oleh Apigee, Anda tidak perlu menginstal node Postgres baru. Di kolom prosedur di bawah ini, Anda dapat melewati langkah-langkah yang menentukan untuk menginstal dan kemudian menonaktifkan Node standby postgres.

    Sebelum Anda memulai proses pembaruan, ambil cuplikan jaringan dari penyimpanan data yang digunakan oleh Postgres. Lalu, jika terjadi kesalahan saat pembaruan dan Anda dipaksa melakukan {i>rollback<i}, Anda dapat memulihkan node Postgres dari snapshot tersebut.

Menginstal Postgres baru node standby

Prosedur ini akan membuat server standby Postgres pada node baru. Pastikan Anda menginstal Server standby postgres untuk Edge versi yang sudah 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 saat ini Edge.

Untuk membuat node standby Postgres baru:

  1. Pada master Postgres saat ini, edit /opt/apigee/customer/application/postgresql.properties untuk menyetel 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 Postgres saat ini server standby dan new_standby_ip adalah alamat IP node standby baru.

  2. Mulai ulang apigee-postgresql pada master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Pastikan bahwa node standby baru telah ditambahkan dengan menampilkan /opt/apigee/apigee-postgresql/conf/pg_hba.conf file 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 untuk 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 di Instal utilitas Edge apigee-setup.
    3. Lakukan salah satu hal berikut, bergantung pada versi Edge yang Anda tingkatkan:
      • Jika Anda meningkatkan dari Edge 4.19.06, unduh file Edge bootstrap_4.19.06.sh 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 Edge apigee-service: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Jika Anda mengupgrade dari Edge 4.50.00, unduh file Edge bootstrap_4.50.00.sh 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 Edge apigee-service: 

        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. Instal Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Pada node standby baru, jalankan perintah berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Validasi bahwa perangkat tersebut menyatakan mode standby.

Melakukan upgrade langsung untuk Postgres

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

  1. Upgrade postgres pada host master 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Jalankan perintah penyiapan pada host master: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Jalankan perintah konfigurasi pada 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. Menghentikan mode standby: 
    apigee-service apigee-postgresql stop
  8. Upgrade mode standby.

    Catatan: Jika langkah ini mengalami error/gagal, Anda dapat mengabaikannya. update.sh akan mencoba untuk memulai server cadangan dengan konfigurasi yang salah. Menyediakan Postgres instalasi diupgrade ke 10.17, kesalahan 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, mode standby akan berhasil dimulai.

Menonaktifkan node Postgres

Setelah update selesai, hentikan node standby baru:

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

    Jika Postgres tidak berjalan, mulai: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Dapatkan UUID node standby baru dengan menjalankan perintah curl berikut di node baru node standby: 
    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 pada node standby baru: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Pada 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 pada master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Pastikan bahwa node standby baru telah dihapus dengan melihat /opt/apigee/apigee-postgresql/conf/pg_hba.conf file di master. Anda akan melihat hanya baris berikut dalam file tersebut: 
    host replication apigee existing_standby_ip/32 trust
  7. Hapus UUID node standby dari ZooKeeper dengan membuat pengelolaan Edge berikut Panggilan API pada node Server Pengelolaan: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Perbarui prasyarat

Selesaikan prasyarat berikut sebelum mengupgrade Apigee Edge:

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

    Hal ini memungkinkan Anda memiliki rencana cadangan, jika pembaruan ke versi baru tidak apakah berfungsi dengan baik. Untuk informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pulihkan.

  • 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 mengenai UI Edge. Untuk informasi selengkapnya, lihat UI Edge baru untuk Private Cloud.

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, UI Edge mengharuskan Anda menonaktifkan autentikasi Dasar dan menggunakan IDP seperti SAML atau LDAP.

Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge yang baru.

Mengupdate UI Edge

Untuk mengupdate komponen UI Edge, pertimbangkan versi Edge untuk Private Cloud yang mengupgrade dari:

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

Update dengan mTLS Apigee

Untuk mengupdate Apigee mTLS , lakukan hal berikut langkah:

Me-roll back update

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

Jika kegagalan tersebut mengharuskan Anda me-roll back update ke versi sebelumnya, lihat Roll back 4.51.00 untuk mendapatkan petunjuk mendetail.

Informasi pembaruan logging

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, file akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

Jika orang tersebut tidak memiliki akses ke /tmp, utilitas update.sh gagal.

Update tanpa periode nonaktif

Update tanpa periode nonaktif atau update berkelanjutan memungkinkan Anda mengupdate penginstalan Edge tanpa yang merusak Edge.

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

Kunci untuk mengupgrade tanpa periode nonaktif adalah dengan menghapus setiap Router, satu per satu, dari beban dengan load balancer Jaringan Passthrough Eksternal Regional. Anda kemudian memperbarui {i>Router<i} dan komponen lainnya di komputer yang sama dengan {i>Router<i}, lalu menambahkan Router kembali ke load balancer.

  1. Perbarui komputer dalam urutan yang benar untuk pemasangan Anda seperti yang dijelaskan Urutan update komputer.
  2. Ketika tiba waktunya untuk memperbarui {i>Router<i}, pilih salah satu {i>Router<i} dan membuatnya tidak dapat dijangkau, yang dijelaskan dalam Mengaktifkan/Menonaktifkan server (Keterjangkauan Pemroses/Router Pesan).
  3. Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Pemroses Pesan di node yang sama.
  4. Buat Router dapat dijangkau lagi.
  5. Ulangi langkah 2 sampai 4 untuk Router lainnya.
  6. Lanjutkan pembaruan untuk komputer apa pun yang tersisa dalam pemasangan Anda.

Lakukan tindakan 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.

Perbarui ke 4.51.00 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk memperbarui komponen Edge pada node:

  1. Jika ada, nonaktifkan tugas cron apa pun yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga update selesai.
  2. Login ke node Anda 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 Edge apigee-setup.
  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 berikut Perintah yum-configure-manager: 
    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 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 Anda menghapus pWord, Anda akan diminta untuk memasukkannya.

    Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, {i>installer<i} akan menginstalnya untuk Anda.

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

    • I: Instal OpenJDK 1.8 (default).
    • C: Lanjutkan tanpa menginstal Java.
    • Q: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
  9. Gunakan apigee-service untuk mengupdate utilitas apigee-setup, sebagai contoh berikut menunjukkan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Update utilitas apigee-validate di Server Pengelolaan, sebagai berikut contoh menampilkan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Update utilitas apigee-provision di Server Pengelolaan, sebagai berikut contoh menampilkan: 
    /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 ini sesuai urutan yang dijelaskan dalam Urutan mesin perbarui.

    Dengan keterangan:

    • component adalah komponen Edge yang akan diperbarui. Nilai yang memungkinkan mencakup:
      • cs: Cassandra
      • edge: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pesan Prosesor, 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 definisikan Edge Anda komponen selama penginstalan 4.19.06 atau 4.50.00.

    Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel 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 pada 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 pada bagian Pengelolaan Server, seperti yang dijelaskan dalam Menguji penginstalan.

Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan di Roll back 4.51.00.

Pembaruan ke 4.51.00 dari repo lokal

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

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

  • Buat file .tar repo, salin file .tar ke node, lalu perbarui Edge dari {i>.tar<i}.
  • Instal server web pada node dengan repo lokal sehingga node lain dapat mengaksesnya. Apigee menyediakan server web NGINX untuk Anda, atau Anda dapat menggunakan server web dengan server web

Untuk memperbarui dari repo 4.51.00 lokal:

  1. Buat repo 4.51.00 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" pada pukul Instal utilitas Edge apigee-setup.
  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.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 pada node baru.
    3. Pada node baru, untar file ke direktori /tmp: 
      tar -xzf apigee-4.51.00.tar.gz

      Perintah ini membuat direktori baru, bernama repos, di direktori yang berisi file {i> .tar<i}. Misalnya, /tmp/repos.

    4. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.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 di bagian "Menginstal dari repo menggunakan NGINX webserver&quot; di Menginstal Edge utilitas apigee-setup.
    2. Pada node jarak jauh, download file Edge bootstrap_4.51.00.sh untuk /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 sebelumnya Anda tetapkan repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.

    3. Pada node jarak jauh, instal utilitas dan dependensi Edge apigee-setup: 
      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, sebagai contoh berikut menunjukkan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Update utilitas apigee-validate di Server Pengelolaan, sebagai berikut contoh menampilkan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Update utilitas apigee-provision di Server Pengelolaan, sebagai berikut contoh menampilkan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Jalankan utilitas update di node Anda sesuai urutan yang dijelaskan di Urutan update komputer: 
    /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: Management Server, Message Processor, Router, Server QPID, Server Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO Apigee (jika Anda menginstal SSO)
      • UI Edge Baru ue
      • ui: UI Edge Klasik
      • zk: Zookeeper
    • configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama instalasi 4.19.06 atau 4.50.00.

    Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel 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 pada 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 pada bagian Pengelolaan Server, seperti yang dijelaskan dalam Menguji penginstalan.

Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan di Roll back 4.51.00.

Urutan update mesin

Urutan Anda memperbarui komputer dalam penginstalan Edge adalah hal penting:

  • Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
  • Untuk mesin apa pun yang memiliki beberapa komponen Edge (Management Server, Message Processor, Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi -c edge untuk mengupdate secara bersamaan.
  • Jika sebuah langkah menentukan bahwa itu harus dilakukan pada beberapa komputer, lakukan dalam urutan mesin tertentu.
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Halaman ini diperbarui saat Anda menentukan -c edge.

Upgrade mandiri 1 node

Untuk mengupgrade konfigurasi mandiri 1 node ke 4.51.00:

  1. Update semua komponen: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Jika Anda menginstal apigee-adminapi) Update 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 pemasangan untuk mengetahui daftar topologi Edge dan nomor node.

  1. Perbarui Cassandra dan ZooKeeper di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui 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 perangkat 2 dan 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Update UI di perangkat 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Jika Anda menginstal SSO Apigee) Update SSO Apigee 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 Anda SSO yang diinstal.

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

Upgrade 5 node

Update komponen berikut untuk penginstalan 5 node:

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

  1. Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui Qpid dan Postgres di komputer 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Perbarui 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. Perbarui komponen Edge di komputer 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Update UI Edge:
    • UI klasik: Jika Anda menggunakan UI klasik, update Komponen ui di komputer 1, seperti yang ditunjukkan contoh berikut: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • UI Edge Baru: Jika Anda menginstal UI Edge baru, perbarui Komponen ue pada komputer yang sesuai (mungkin bukan mesin 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal SSO Apigee) Update SSO Apigee 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 Anda SSO yang diinstal.

  9. Mulai ulang komponen UI:
    • UI klasik: Jika Anda menggunakan UI klasik, mulai ulang Komponen edge-ui di komputer 1, seperti yang ditunjukkan 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 pada komputer yang sesuai (mungkin bukan perangkat 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade dalam cluster 9 node

Update komponen berikut untuk penginstalan yang dikelompokkan 9 node:

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

  1. Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui Qpid pada komputer 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Perbarui Postgres di komputer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Perbarui 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. Perbarui komponen Edge pada perangkat 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 perangkat 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi pada komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jika Anda menginstal SSO Apigee) Update SSO Apigee 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 Anda SSO yang diinstal.

  10. Mulai ulang komponen UI:
    • UI klasik: Jika Anda menggunakan UI klasik, mulai ulang Komponen edge-ui di komputer 1, seperti yang ditunjukkan 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 pada komputer yang sesuai (mungkin bukan perangkat 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade dalam cluster 13 node

Update komponen berikut untuk penginstalan yang dikelompokkan 13 node:

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

  1. Perbarui Cassandra dan ZooKeeper pada komputer 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui Qpid pada komputer 12 dan 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Perbarui Postgres di komputer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Perbarui 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. Perbarui komponen Edge pada 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. 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) Update utilitas apigee-adminapi pada komputer 6 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jika Anda menginstal SSO Apigee) Update SSO Apigee 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 Anda SSO yang diinstal.

  10. Mulai ulang komponen UI:
    • UI klasik: Jika Anda menggunakan UI klasik, mulai ulang Komponen edge-ui pada mesin 6 dan 7, seperti yang ditunjukkan 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 pada komputer 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade dalam cluster 12 node

Update komponen berikut untuk penginstalan yang dikelompokkan 12 node:

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

  1. Perbarui Cassandra dan ZooKeeper:
    1. Pada komputer 1, 2, dan 3 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Pada komputer 7, 8, dan 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Perbarui qpidd:
    1. Mesin 4, 5 di Pusat Data 1
      1. Perbarui qpidd di komputer 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Perbarui qpidd di komputer 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Mesin 10, 11 di Pusat Data 2
      1. Update qpidd di komputer 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Update qpidd di komputer 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Perbarui 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. Perbarui 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. Update komponen Edge:
    1. Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Mesin 10, 11, 12, 7, 8, 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -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. Mesin 7 di Pusat Data 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi:
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Mesin 7 di Pusat Data 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jika Anda menginstal SSO Apigee) Update SSO Apigee:
    1. Mesin 1 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Mesin 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 Anda SSO yang diinstal.

  9. Mulai ulang 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 pada berikut:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Tepi, yang berarti "-c tepi" profil pada semua {i>node<i} dengan urutan: {i>node<i} dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
  6. UI Edge (baik klasik maupun baru)
  7. apigee-adminapi
  8. SSO Apigee

Setelah selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua komputer yang berjalan anotasi.