Update Apigee Edge 4.51.00 atau 4.52.00 atau 4.52.01 ke 4.52.02

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

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
  Bergantung pada versi Anda saat ini, lakukan perubahan yang diperlukan pada strategi pemadatan Cassandra. Ikuti langkah-langkah di bawah, lalu kembali ke prosedur upgrade utama:
  • Jika Anda mengupgrade dari versi 4.51.00, lihat dokumen Strategi Kompaksi Cassandra untuk v4.51.00.
  • Jika Anda mengupgrade dari versi 4.52.00, lihat dokumen Strategi Kompaksi Cassandra untuk v4.52.00.
  • Jika Anda mengupgrade dari versi 4.52.01, lihat dokumen Strategi Kompaksi Cassandra untuk v4.52.01.

Langkah-langkah khusus yang perlu dipertimbangkan untuk upgrade

Untuk mengupgrade ke Edge for Private Cloud 4.52.02, pertimbangkan untuk menjalankan langkah-langkah tertentu guna mengupgrade software tertentu. Langkah-langkah yang diperlukan bergantung pada versi Anda saat ini. Lihat tabel di bawah untuk berbagai software yang memerlukan langkah-langkah tambahan, dan ikuti petunjuk mendetail untuk masing-masing software. Setelah menyelesaikan tugas yang diperlukan, kembali ke prosedur upgrade utama untuk melanjutkan proses upgrade.

Setelah melakukan langkah-langkah yang diperlukan berdasarkan versi Anda, kembali ke prosedur upgrade utama untuk melanjutkan.

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 Cassandra 3.11.16

Apigee Edge untuk Private Cloud 4.52.02 menyertakan upgrade Cassandra ke versi 3.11.16. Cassandra adalah komponen penting Apigee, dan upgrade ini juga mencakup update pada software driver di berbagai komponen runtime dan pengelolaan yang digunakan untuk membuat kueri dan menulis ke Cassandra.

Karena ini adalah upgrade besar, perubahan tertentu pada model data Apigee di Cassandra diperlukan untuk memastikan performa yang optimal di versi yang lebih baru. Meskipun perubahan ini minimal, proses upgrade mengganggu API pengelolaan tertentu, yang memengaruhi UI Apigee dan portal developer. Dokumen di bawah ini menentukan API yang tidak akan berfungsi dan menguraikan langkah-langkah selama upgrade saat gangguan dimulai dan berakhir. Yang penting, tidak boleh ada gangguan pada traffic runtime selama upgrade.

Rollback tingkat tinggi

Terapkan upgrade Cassandra satu node pada satu waktu. Segera setelah node diperbarui, perubahan skema tertentu akan diterapkan yang tidak dapat di-roll back secara langsung. Baca bagian Rollback secara menyeluruh, karena teknik yang berbeda dapat digunakan bergantung pada seberapa banyak cluster yang telah diupgrade.

Jika Anda perlu melakukan rollback upgrade setelah seluruh cluster Cassandra diupgrade, satu-satunya opsi adalah memulihkan pencadangan. Bersiaplah untuk hal ini dan dapatkan pemahaman tentang pemulihan pencadangan Cassandra. Jika Anda dapat memulihkan snapshot tingkat VM lebih cepat daripada pencadangan Apigee, gunakan snapshot VM untuk memulihkan VM Cassandra ke status sebelumnya.

Untuk mengetahui detail selengkapnya, lihat bagian Melakukan rollback update Cassandra 3.11.16.

Mendokumentasikan API di portal developer

Portal developer Drupal Apigee menawarkan berbagai fitur untuk mendokumentasikan API Anda. Meskipun sebaiknya Anda beralih dari penggunaan portal developer berbasis Drupal 7, jika Anda masih menggunakannya dan memanfaatkan fitur SmartDocs-nya, dokumen Menggunakan SmartDocs API berlaku untuk Anda. Jika Anda menggunakan versi developer portal yang lebih baru, dokumentasi API Anda tidak akan terpengaruh selama upgrade ini.

Saat Anda mengupgrade Apigee ke versi 4.52.02, model API apa pun yang dibuat menggunakan fitur SmartDocs di portal developer Drupal 7 tidak akan dimigrasikan ke versi yang lebih baru secara otomatis. Anda diharapkan untuk mengekspor setiap model secara manual menggunakan portal developer dan mengimpornya lagi setelah menyelesaikan upgrade.

Terminologi yang digunakan di bagian berikut

Runtime: Runtime mencakup penanganan traffic proxy runtime Anda. Ini mencakup semua operasi yang dilakukan oleh Router dan Message Processor untuk memproses permintaan API runtime secara efektif untuk proxy yang ada. Namun, hal ini tidak mencakup deployment proxy baru atau revisi proxy baru.

Pengelolaan: Pengelolaan mencakup administrasi sistem Apigee Edge Anda. Hal ini mencakup, tetapi tidak terbatas pada, deployment, modifikasi aplikasi, produk, server target, keystore, dll. Semua API pengelolaan (dan kliennya seperti UI Apigee dan portal developer) disertakan dalam cakupan ini.

Pada setiap langkah di bawah, status runtime dan pengelolaan dijelaskan saat Anda melanjutkan berbagai tahap prosedur upgrade. Perhatikan bahwa tidak ada dampak pada traffic runtime selama upgrade. Namun, ada gangguan pada sebagian kecil API pengelolaan dan fungsi portal developer.

Langkah 0: Status awal

1. Cassandra di Apigee berjalan dengan versi 2.1.22.
2. Komponen Edge untuk Private Cloud 4.52.02:
• Server pengelolaan berkomunikasi dengan Cassandra melalui protokol thrift lama.
• Server runtime (Pemroses & Router Pesan) yang berkomunikasi dengan Cassandra melalui protokol thrift lama.

Langkah 1: Bersiap untuk upgrade

Langkah-langkah di bawah ini adalah tambahan untuk file standar yang biasanya Anda buat, seperti file konfigurasi standar Apigee untuk mengaktifkan upgrade komponen.

1. Ubah Cassandra agar menggunakan LeveledCompactionStrategy.
2. Cadangkan Cassandra menggunakan Apigee.
3. Ambil snapshot VM node Cassandra (jika memungkinkan).
4. Buat file konfigurasi upgrade Cassandra di setiap node Cassandra di /opt/apigee/apigee-cassandra/cass_upgrade.conf dengan konten berikut:

   # IP Address of node
   HOSTIP=10.0.0.1
   
   # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
   CASS_USERNAME=<cassuser>
   
   # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
   CASS_PASSWORD=<casspass>
   
   # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
   CASS_PORT=9160
   
   # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
   CASS_CQL_PORT=9042
   
   # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
   # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
   CASS_TMP_DIR=/tmp/cass_upgrade_scripts
       

   Jika file tidak dapat dibuat di /opt/apigee/apigee-cassandra/cass_upgrade.conf, buat file /opt/silent.conf dengan konten yang sama di setiap node Cassandra.

• Jika Anda menggunakan fitur SmartDocs di portal developer Drupal 7 Apigee, ekspor setiap model dengan mendownloadnya dalam format JSON dari UI portal developer. Model ini harus diimpor kembali ke Apigee setelah server pengelolaan diupdate.
• Pastikan port 9160 dan 9042 dapat diakses dari semua komponen Edge for Private Cloud 4.52.02 ke node Cassandra jika belum ada. Lihat Persyaratan port untuk mengetahui informasi selengkapnya.

Langkah 2: Upgrade semua node Cassandra

1. Upgrade semua node Cassandra di semua region satu per satu. Jalankan perintah berikut di setiap node:

   /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

2. Setelah node diupdate, jalankan perintah berikut di node untuk menjalankan beberapa validasi sebelum melanjutkan:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

3. Perintah di atas akan menghasilkan output seperti:

   Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Langkah 3: Upgrade semua node Pengelolaan

Upgrade semua node Pengelolaan di semua region satu per satu:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Langkah 3a: [opsional] Impor SmartDocs yang sebelumnya diekspor

Setelah semua server pengelolaan diupgrade, Anda dapat mengimpor model SmartDocs yang telah diekspor di Langkah 1. Anda juga dapat memutuskan untuk melakukannya nanti.

Langkah 4: Upgrade semua node Runtime

Upgrade semua node Router dan Message Processor di semua region satu per satu:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Langkah 5: Upgrade semua komponen Edge for Private Cloud 4.52.02 yang tersisa

Upgrade semua node edge-qpid-server dan edge-postgres-server yang tersisa di semua region satu per satu.

Pada tahap ini, jika Anda mengupgrade dari versi yang lebih lama dari Edge for Private Cloud 4.52.01, dan mengikuti langkah-langkah tambahan untuk mengupgrade Qpid atau Postgres, ikuti langkah-langkah masing-masing untuk mengupgradenya.

Langkah 6: Langkah-langkah pasca-upgrade

Jalankan perintah berikut di setiap node Cassandra satu per satu setelah upgrade selesai:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Jalankan perintah berikut untuk menghapus tabel lama yang tidak digunakan dari cluster Cassandra. Sebelum dijalankan, Anda tidak dapat menggunakan fitur tertentu dari Cassandra (seperti menyiapkan autentikasi baru - mekanisme autentikasi lama akan terus berfungsi). Perintah ini hanya dapat dieksekusi di 1 node dalam cluster:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Selesaikan langkah 3a jika Anda belum melakukannya.

Upgrade yang diperlukan ke Zookeeper 3.8.3

Meskipun Edge for Private Cloud 4.52.02 tidak menyertakan upgrade ke Zookeeper, jika Anda mengupgrade dari versi yang lebih lama dari 4.52.01, Anda harus mengikuti langkah-langkah untuk mengupgrade Zookeeper.

• Jika Anda mengupgrade dari Edge for Private Cloud versi 4.51.00 atau 4.52.00, lihat langkah-langkah di Upgrade yang diperlukan ke Zookeeper 3.8.3 untuk mengupgrade Zookeeper.
• Jika mengupgrade dari Edge for Private Cloud versi 4.52.01, Anda seharusnya sudah menggunakan Zookeeper versi 3.8.3, dan Anda tidak perlu mengikuti langkah khusus apa pun untuk mengupgrade Zookeeper.

Upgrade yang diperlukan ke Postgres 14

• Jika mengupgrade dari Edge for Private Cloud 4.51.00 ke 4.52.02, Anda harus mengikuti langkah-langkah untuk mengupgrade Postgres, meskipun Edge for Private Cloud 4.52.02 tidak menyertakan upgrade Postgres. Mengupgrade dari Edge for Private Cloud 4.51.00 ke 4.52.02 memerlukan langkah upgrade Postgres tambahan. Lihat bagian Upgrade yang diperlukan ke Postgres 14.
• Jika Anda mengupgrade dari Edge for Private Cloud 4.52.00 atau 4.52.01 ke 4.52.02, tidak ada langkah upgrade Postgres tambahan yang diperlukan.

Upgrade yang diperlukan ke Qpid J-Broker

Meskipun Edge for Private Cloud 4.52.02 tidak menyertakan upgrade ke QPID, jika Anda mengupgrade dari versi yang lebih lama dari 4.52.01, Anda harus mengikuti langkah-langkah untuk mengupgrade QPID.

• Jika Anda mengupgrade dari Edge for Private Cloud 4.51.00 atau 4.52.00 ke 4.52.02, Anda harus mengikuti langkah-langkah upgrade QPID tambahan. Lihat bagian Mengupgrade Qpid jika Anda mengupgrade dari versi 4.51.00 atau 4.52.00 ke 4.52.02.
• Jika mengupgrade dari Edge for Private Cloud 4.52.01 ke 4.52.02, Anda seharusnya sudah menggunakan Qpid Broker versi terbaru, dan tidak perlu langkah upgrade QPID tambahan.

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.51.00 ke 4.52.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:

• Uninstal mTLS Apigee.
• Instal ulang mTLS Apigee.

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

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

Menggunakan file konfigurasi senyap

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

Mengupdate ke 4.52.02 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. Jika saat ini Anda menggunakan Edge 4.51.00:

   1. Download file bootstrap_4.52.02.sh Edge ke /tmp/bootstrap_4.52.02.sh:

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

   2. Instal utilitas dan dependensi apigee-service Edge 4.52.02 dengan menjalankan perintah berikut:

      sudo bash /tmp/bootstrap_4.52.02.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, 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.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-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.02.

Mengupdate ke 4.52.02 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.02 lokal:

1. Buat repo 4.52.02 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.02.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.02.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.02.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.02.sh Edge ke /tmp/bootstrap_4.52.02.sh:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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.02.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.02.

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.52.02:

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

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

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. Perbarui 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) Memperbarui 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

   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.