Mengupdate Apigee Edge 4.52.02 atau 4.53.00 ke 4.53.01

Apigee mendukung upgrade Edge untuk Private Cloud langsung dari versi 4.52.02 atau 4.53.00 ke versi 4.53.01. Halaman ini menjelaskan cara melakukan upgrade tersebut.

Untuk ringkasan jalur upgrade yang kompatibel, lihat matriks kompatibilitas upgrade untuk rilis Edge untuk Private Cloud.

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.

Prasyarat pembaruan

Meninjau perubahan di Edge untuk Private Cloud 4.53.01

Sejumlah masalah keamanan telah diatasi dalam versi ini. Meskipun peningkatan keamanan ini sangat penting, peningkatan ini memperkenalkan beberapa perubahan yang tidak kompatibel ke belakang. Artinya, upgrade akan memerlukan langkah tambahan untuk memastikan tidak ada gangguan selama atau setelah upgrade. Untuk mengetahui informasi selengkapnya, tinjau topik ini secara menyeluruh saat mengupgrade ke versi 4.53.01 dari versi cloud pribadi yang lebih lama.

Pastikan prasyarat berikut sebelum mengupgrade Apigee Edge:

  • Mencadangkan semua node
    Sebelum melakukan update, sebaiknya lakukan pencadangan lengkap semua node untuk alasan keamanan. Gunakan prosedur untuk Edge versi saat ini guna melakukan pencadangan.

    Dengan begitu, Anda dapat memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.

  • Pastikan Edge berjalan
    Pastikan Edge berjalan selama proses update menggunakan perintah: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Verifikasi prasyarat Cassandra

    Jika sebelumnya Anda mengupgrade dari Edge untuk Private Cloud versi lama ke versi 4.52.02 dan sekarang berencana mengupgrade ke versi 4.53.01, pastikan Anda telah menyelesaikan langkah-langkah pasca-upgrade yang diperlukan untuk Cassandra. Langkah-langkah ini diuraikan dalam dokumentasi upgrade versi 4.52.02 dan juga disebutkan di bagian Prasyarat untuk upgrade Cassandra. Jika Anda tidak yakin apakah langkah-langkah ini telah diselesaikan selama upgrade sebelumnya, selesaikan lagi sebelum melanjutkan upgrade ke versi 4.53.01.

  • Mengonfigurasi kunci dan sertifikat IDP di Edge untuk Private Cloud 4.53.01

    Di Edge untuk Private Cloud 4.53.01, kunci dan sertifikat IDP yang digunakan dalam komponen apigee-sso kini dikonfigurasi melalui keystore. Anda harus mengekspor kunci dan sertifikat yang sebelumnya digunakan ke keystore. Ikuti langkah-langkah di bagian Langkah-langkah untuk mengupdate Apigee SSO dari versi yang lebih lama untuk mengetahui langkah-langkah mendetail sebelum mengupdate komponen SSO.

  • Persyaratan Python
    Pastikan semua node, termasuk node Cassandra, telah menginstal Python 3 sebelum mencoba upgrade.

Langkah khusus yang perlu dipertimbangkan untuk upgrade

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

Versi saat ini Software yang memerlukan langkah-langkah khusus untuk upgrade ke 4.53.01
4.52.02 LDAP, Cassandra, Zookeeper, Postgres
4.53.00 LDAP, Zookeeper, Postgres

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

Penyebaran otomatis setelan properti

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

Upgrade yang Diperlukan ke OpenLDAP 2.6

Berikut prosedur langkah demi langkah untuk mengupgrade layanan LDAP yang mendasari Apigee Edge untuk Private Cloud dari OpenLDAP 2.4 lama ke OpenLDAP 2.6. Upgrade ini merupakan persyaratan wajib untuk update ke Apigee Edge untuk Private Cloud versi 4.53.01 dan yang lebih baru. Upgrade ini berlaku untuk semua topologi deployment LDAP Apigee: server tunggal, aktif-pasif, dan aktif-aktif (multi-master).

Prasyarat dan pertimbangan

  • Perlu diketahui bahwa selama proses upgrade LDAP, API pengelolaan dan akibatnya, UI Apigee tidak akan tersedia sama sekali di semua wilayah. Semua tugas administratif - seperti mengelola pengguna, peran, aplikasi, dan organisasi akan gagal dan harus dijeda. Tidak akan ada dampak pada pemrosesan traffic proxy API Anda. Pastikan untuk mematikan semua edge-management-server dan edge-ui sebelum melanjutkan upgrade LDAP.

  • Pencadangan Sangat Penting: Pencadangan data LDAP yang ada secara lengkap dan tervalidasi adalah hal yang tidak dapat dinegosiasikan. Melanjutkan tanpa pencadangan yang valid akan menyebabkan kehilangan data yang tidak dapat dipulihkan. Pencadangan harus dimulai saat layanan LDAP masih berjalan untuk mengambil snapshot data LDAP yang konsisten dan point-in-time. Pencadangan diperlukan untuk melakukan upgrade yang sebenarnya. Tanpa pencadangan, Anda tidak akan dapat menjalankan upgrade maupun melakukan rollback karena langkah-langkah upgrade melibatkan penghapusan data LDAP.

Persiapan dan penginstalan (Semua server LDAP)

Langkah-langkah di bagian ini (Langkah 2 hingga Langkah 5) sama untuk semua topologi deployment LDAP. Tindakan ini harus dilakukan di setiap server tempat komponen apigee-openldap diinstal, terlepas dari perannya.

  1. Pastikan untuk mematikan semua edge-management-server dan edge-ui sebelum melanjutkan upgrade LDAP. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop

  2. Mencadangkan data LDAP yang ada

    Sebelum melakukan perubahan apa pun, lakukan pencadangan penuh data LDAP saat ini dari semua server LDAP. Tindakan ini akan membuat titik pemulihan yang aman.

    • Jalankan perintah pencadangan. Tindakan ini akan membuat arsip cadangan yang diberi stempel waktu dalam direktori /opt/apigee/backup/openldap. 
      apigee-service apigee-openldap backup
    • Mendapatkan Jumlah total catatan: Catat jumlah catatan di direktori Anda untuk validasi pasca-upgrade (Jumlah catatan harus sama di semua server LDAP). Ini adalah pemeriksaan stabilitas. 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

  3. Menghentikan LDAP dan membersihkan direktori data

    Langkah ini harus dilakukan di semua server LDAP. Migrasi ini wajib dilakukan karena perubahan versi utama dan perbedaan struktural yang mendasarinya. Direktori yang bersih memastikan tidak ada konflik. Jika semua server LDAP dihentikan, gangguan pada API dan UI Pengelolaan akan dimulai.

    • Hentikan layanan LDAP. 
      apigee-service apigee-openldap stop
    • Hapus direktori konfigurasi dan data LDAP lama secara permanen. 
      rm -rf /opt/apigee/data/apigee-openldap/*

  4. Menginstal dan mengonfigurasi versi LDAP baru

    Di semua server LDAP, gunakan skrip Apigee standar untuk mendownload dan menginstal versi komponen baru.

    • Instal komponen LDAP baru: Skrip update membaca file konfigurasi Anda dan menginstal paket apigee-openldap baru. 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
    • Validasi versi LDAP baru:Setelah penginstalan selesai, muat ulang profil, verifikasi bahwa versi LDAP baru telah diinstal dengan benar. 
      source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

  5. Hentikan LDAP di semua server sebelum pemulihan data

    Ini adalah langkah sinkronisasi penting. Sebelum memulihkan cadangan, Anda harus memastikan layanan LDAP yang baru diinstal dihentikan di semua server. Di setiap server LDAP, jalankan perintah berikut: 

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*

  6. Memulihkan data LDAP

    Strateginya adalah memulihkan cadangan di server aktif pertama. Server ini kemudian akan bertindak sebagai sumber tepercaya, mereplikasi data ke server lain dalam penyiapan multi-server.

    1. Mengidentifikasi server aktif pertama untuk pemulihan

      • Untuk penyiapan server tunggal: Ini adalah satu-satunya server LDAP Anda. Anda dapat langsung melanjutkan ke langkah berikutnya.
      • Untuk penyiapan aktif-pasif dan aktif-aktif: Jalankan perintah diagnostik berikut di setiap server LDAP: 
        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.

    2. Memulihkan data cadangan

      Sebelum melanjutkan, periksa kembali bahwa Langkah 5 telah berhasil diselesaikan di semua server LDAP.

      • Di server aktif pertama yang Anda identifikasi di atas, buka direktori cadangan. 
        cd /opt/apigee/backup/openldap
      • Jalankan perintah restore. Sebaiknya tentukan stempel waktu cadangan yang tepat dari Langkah 2 untuk mencegah pemulihan versi yang tidak diinginkan atau lebih lama. 
        # To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
      • Setelah proses pemulihan berhasil diselesaikan, mulai layanan LDAP di server aktif pertama. 
        apigee-service apigee-openldap start

  7. Mulai server LDAP yang tersisa

    Jika Anda memiliki penyiapan multi-server, di setiap server LDAP, mulai layanan: 

    apigee-service apigee-openldap start

  8. Validasi akhir

    Langkah terakhir adalah memverifikasi bahwa upgrade berhasil dan data konsisten di seluruh cluster LDAP.

    • Jalankan perintah validasi di semua server LDAP. Jumlah data harus sama di semua server dan harus cocok dengan jumlah yang Anda ambil di Langkah 2.
      • # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • Setelah Anda mengonfirmasi bahwa data sudah benar dan konsisten, upgrade LDAP Anda selesai. Sekarang Anda dapat melanjutkan dengan memulai edge-management-server dan edge-ui serta komponen dependen lainnya sesuai dengan prosedur upgrade standar organisasi Anda.

Upgrade wajib ke Cassandra 4.0.18

Apigee Edge for Private Cloud 4.53.01 mencakup upgrade Cassandra ke versi 4.0.18.

Upgrade dan rollback

  • Upgrade dari Cassandra 3.11.X ke Cassandra 4.0.X adalah proses yang lancar. Cassandra 4.0.X, yang dirilis dengan Edge untuk Private Cloud 4.53.00, kompatibel dengan komponen runtime dan pengelolaan Private Cloud 4.52.02.
  • Rollback langsung di tempat dari Cassandra 4.0.X ke 3.11.X tidak dapat dilakukan. Melakukan rollback menggunakan replika atau cadangan adalah prosedur yang rumit dan dapat menyebabkan periode nonaktif dan/atau kehilangan data. Memecahkan masalah dan mengupgrade ke Cassandra 4.0.X lebih baik daripada melakukan rollback.
  • Anda harus memahami prosedur rollback sebelum mencoba upgrade. Mempertimbangkan nuansa rollback selama upgrade sangat penting untuk memastikan jalur rollback yang sesuai tersedia.

Pusat data tunggal

Mengupgrade Cassandra dari 3.11.X ke 4.0.X dalam satu pusat data berjalan lancar, tetapi rollback rumit dan dapat menyebabkan periode nonaktif dan kehilangan data. Untuk beban kerja produksi, sebaiknya tambahkan pusat data baru dengan setidaknya node Cassandra yang tersedia di pusat data baru sebelum memulai upgrade. Hal ini akan memungkinkan rollback Cassandra tanpa menyebabkan kehilangan data atau gangguan pada traffic API Anda. Pusat data tambahan ini dapat dinonaktifkan setelah upgrade selesai atau Checkpoint 2 tercapai.

Jika penambahan pusat data baru tidak memungkinkan, tetapi kemampuan rollback masih diinginkan, pencadangan akan diperlukan untuk memulihkan Cassandra 3.11.X. Namun, metode ini kemungkinan akan menyebabkan periode nonaktif dan kehilangan data.

Beberapa pusat data

Mengoperasikan beberapa pusat data dengan Edge untuk Private Cloud 4.52.02 menawarkan fleksibilitas yang lebih besar untuk rollback selama upgrade ke Edge untuk Private Cloud 4.53.00.

  • Rollback bergantung pada setidaknya satu pusat data yang menjalankan Cassandra versi lama (3.11.X).
  • Jika seluruh cluster Cassandra Anda diupgrade ke 4.0.X, Anda tidak boleh melakukan rollback ke Cassandra 3.11.X. Anda harus terus menggunakan Cassandra versi yang lebih baru dengan komponen lain dari Private Cloud 4.53.00 atau 4.52.02.
  1. Upgrade satu pusat data Cassandra dalam satu waktu: Mulai dengan mengupgrade setiap node Cassandra dalam satu pusat data. Selesaikan upgrade semua node Cassandra di satu pusat data sebelum melanjutkan ke pusat data berikutnya.
  2. Jeda dan validasi: Setelah mengupgrade satu pusat data, jeda untuk memastikan cluster Private Cloud Anda, terutama pusat data yang diupgrade, berfungsi dengan benar.
  3. Ingat: Anda hanya dapat melakukan roll back ke versi Cassandra sebelumnya jika Anda memiliki setidaknya satu pusat data yang masih menjalankan versi lama.
  4. Sensitif terhadap waktu: Meskipun Anda dapat menjeda untuk jangka waktu singkat (sebaiknya beberapa jam) guna memvalidasi fungsi, Anda tidak dapat terus berada dalam status versi campuran tanpa batas waktu. Hal ini karena cluster Cassandra yang tidak seragam (dengan node pada versi yang berbeda) memiliki batasan operasional.
  5. Pengujian menyeluruh: Apigee sangat merekomendasikan pengujian performa dan fungsi yang komprehensif sebelum mengupgrade pusat data berikutnya. Setelah semua pusat data diupgrade, rollback ke versi sebelumnya tidak dapat dilakukan.
Rollback sebagai proses dua titik pemeriksaan
  1. Checkpoint 1: Status awal, dengan semua komponen pada versi 4.52.02. Rollback penuh dapat dilakukan selama setidaknya satu pusat data Cassandra tetap menggunakan versi lama.
  2. Checkpoint 2: Setelah semua node Cassandra di semua pusat data diperbarui. Anda dapat melakukan roll back ke status ini, tetapi Anda tidak dapat mengembalikan ke Checkpoint 1.
Contoh

Pertimbangkan cluster dua pusat data (DC):

  1. Status awal: Node Cassandra di kedua DC menggunakan versi 3.11.X. Semua node lainnya berada di Edge untuk Private Cloud versi 4.52.02. Asumsikan tiga node Cassandra per DC.
  2. Upgrade DC-1: Upgrade tiga node Cassandra di DC-1 satu per satu.
  3. Jeda dan validasi: Jeda untuk memastikan cluster, terutama DC-1, berfungsi dengan benar (periksa performa, fungsi). Anda dapat melakukan roll back ke status awal menggunakan node Cassandra di DC-2. Ingat, jeda ini harus bersifat sementara karena batasan cluster Cassandra versi campuran.
  4. Upgrade DC-2: Upgrade tiga node Cassandra yang tersisa di DC-2. Ini akan menjadi titik pemeriksaan rollback baru Anda.
  5. Mengupgrade komponen lain: Upgrade node pengelolaan, runtime, dan analisis seperti biasa di semua pusat data, satu node dan satu pusat data dalam satu waktu. Jika muncul masalah, Anda dapat melakukan roll back ke status langkah 4.

Prasyarat untuk upgrade Cassandra

Anda harus menjalankan Cassandra 3.11.16 dengan Edge untuk Private Cloud 4.52.02 dan memastikan hal berikut:
  1. Seluruh cluster beroperasi dan berfungsi penuh dengan Cassandra 3.11.16.
  2. Strategi pemadatan ditetapkan ke LeveledCompactionStrategy (prasyarat untuk upgrade ke versi 4.52.02).

  3. Pastikan setiap langkah di bawah telah diselesaikan sebagai bagian dari upgrade awal Cassandra 3.11 di Edge untuk Private Cloud 4.52.02.

    • Perintah post_upgrade dijalankan di setiap node Cassandra selama upgrade sebelumnya
    • Perintah drop_old_tables dieksekusi di seluruh cluster Cassandra selama upgrade sebelumnya.

Jika Anda tidak yakin bahwa perintah post_upgrade dan drop_old_tables dijalankan di Cassandra 3.11 saat menggunakan Edge untuk Private Cloud 4.52.02, Anda dapat menjalankannya kembali dengan aman sebelum mencoba upgrade ke 4.53.01.

Langkah 1: Bersiap untuk upgrade

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

  1. Mencadangkan Cassandra menggunakan Apigee.
  2. Buat snapshot VM node Cassandra (jika memungkinkan).
  3. Pastikan port 9042 dapat diakses dari semua komponen Edge untuk Private Cloud, termasuk Server Pengelolaan, Pemroses Pesan, Router, Qpid, dan Postgres, ke node Cassandra jika belum dikonfigurasi. Lihat Persyaratan port untuk mengetahui informasi selengkapnya.

Langkah 2: Upgrade semua node Cassandra

Semua node Cassandra harus diperbarui satu per satu di setiap pusat data, satu pusat data dalam satu waktu. Di antara upgrade node dalam pusat data, tunggu beberapa menit untuk memastikan bahwa node yang diupdate telah dimulai sepenuhnya dan bergabung dengan cluster sebelum melanjutkan upgrade node lain di pusat data yang sama.

Setelah mengupgrade semua node Cassandra dalam pusat data, tunggu beberapa saat (30 menit hingga beberapa jam) sebelum melanjutkan dengan node di pusat data berikutnya. Selama waktu ini, tinjau secara menyeluruh pusat data yang diperbarui dan pastikan metrik fungsional dan performa cluster Apigee Anda tetap utuh. Langkah ini sangat penting untuk memastikan stabilitas pusat data tempat Cassandra telah diupgrade ke versi 4.0.X, sementara komponen Apigee lainnya tetap menggunakan versi 4.52.02.

  1. Untuk mengupgrade node Cassandra, jalankan perintah berikut: 
    /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 sesuatu seperti: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. Jalankan perintah post_upgrade berikut di node Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. Jalankan perintah nodetool berikut untuk membangun ulang indeks di node Cassandra: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     Jika Anda menggunakan monetisasi, jalankan juga perintah bangun ulang indeks berikut yang terkait dengan keyspace monetisasi: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

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 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.53.01 yang tersisa

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

Upgrade wajib ke Zookeeper 3.8.4

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

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

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

Secara umum, proses upgrade melibatkan pembuatan cadangan setiap node. Hal ini diikuti dengan mengupgrade semua observer dan follower, lalu mengupgrade node pemimpin.

Membuat cadangan

Buat cadangan semua node Zookeeper untuk digunakan jika rollback diperlukan. Perhatikan bahwa rollback akan memulihkan Zookeeper ke status saat pencadangan dilakukan. Catatan: Setiap deployment atau perubahan infrastruktur di Apigee sejak pencadangan dilakukan (yang informasinya disimpan di Zookeeper) akan hilang selama pemulihan. 

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

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

Mengidentifikasi pemimpin, pengikut, dan pengamat

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

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

    Anda akan melihat output seperti berikut:

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

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

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

Mengupgrade Zookeeper di node observer dan follower

Upgrade Zookeeper di setiap node pengamat dan pengikut sebagai berikut:

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

Mematikan pemimpin

Setelah semua node pengamat dan pengikut diupgrade, matikan pemimpin. Di node yang diidentifikasi sebagai pemimpin, jalankan perintah di bawah: 

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

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

Pastikan pemimpin baru terpilih

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

Pemimpin upgrade

Ikuti langkah-langkah yang sama seperti pada Mengupgrade Zookeeper di node pengamat dan pengikut di atas.

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

Upgrade Nginx 1.26 di Edge-Router

Mengupgrade ke Edge untuk Private Cloud 4.53.01 dari versi sebelumnya tidak otomatis mengupgrade software Nginx ke versi terbaru (1.26.x). Hal ini untuk mencegah efek samping runtime yang tidak disengaja sebagai akibat dari perubahan yang didokumentasikan dalam Perubahan Nginx 1.26 di Apigee Edge 4.53.01. Anda dapat mengupgrade Nginx secara manual dari 1.20.x ke 1.26.x setelah verifikasi di lingkungan yang lebih rendah. Untuk mengupgrade secara manual:

  1. Pastikan node router tepi memiliki software 4.53.01 terbaru

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. Periksa dan verifikasi versi Nginx yang saat ini Anda jalankan

    /opt/nginx/sbin/nginx -V

    Jika Anda menjalankan Nginx versi lama, Anda dapat mengikuti langkah-langkah di bawah untuk mengupgrade Nginx ke versi 1.26.X di node router.

  3. Hentikan proses edge-router pada node router

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. Mengupgrade software nginx di node router

    dnf update apigee-nginx

  5. Pastikan versi Nginx telah diupdate

    /opt/nginx/sbin/nginx -V

  6. Mulai proses router di node

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

  7. Ulangi proses di setiap node router, satu per satu

Upgrade yang Diperlukan ke Postgres 17

Rilis Edge ini mencakup upgrade ke Postgres 17. Sebagai bagian dari upgrade tersebut, semua data Postgres dimigrasikan ke Postgres 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 diperbarui 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 Anda 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 mengembalikan update karena alasan apa pun. Jika Anda harus mengembalikan update, node standby Postgres baru akan menjadi node Postgres utama setelah pengembalian. Oleh karena itu, saat Anda menginstal node standby Postgres baru, node tersebut harus berada di node yang memenuhi semua persyaratan hardware server Postgres, sebagaimana ditentukan dalam Persyaratan penginstalan Edge.

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

  • Jika Anda 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 harus melakukan roll back, 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 Edge versi yang ada (4.52.02 atau 4.53.00), bukan untuk versi 4.53.01.

Untuk melakukan penginstalan, gunakan file konfigurasi yang sama dengan yang Anda gunakan untuk menginstal Edge versi 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: 
    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. Verifikasi bahwa 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 berikut ini: 
      # 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 apigee-setup Edge.

    3. Jika saat ini Anda menggunakan Edge 4.52.02:

      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.51.00.sh
      2. Instal utilitas dan dependensi Edge apigee-service: 
        sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Jika saat ini Anda menggunakan Edge 4.53.00:

      1. Download file Edge bootstrap_4.53.00.sh ke /tmp/bootstrap_4.53.00.sh : 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Instal utilitas dan dependensi Edge apigee-service: 
        sudo bash /tmp/bootstrap_4.53.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. Di node standby baru, jalankan perintah berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Pastikan perangkat dalam mode standby.

Melakukan upgrade Postgres di tempat

Catatan: Anda harus melakukan langkah pendahuluan berikut sebelum melakukan upgrade di tempat Postgres.

Langkah awal

Sebelum melakukan upgrade di tempat ke Postgres, lakukan langkah-langkah berikut di host master dan standby, untuk memperbarui properti max_locks_per_transaction di apigee-postgresql:

  1. Jika tidak ada, buat file /opt/apigee/customer/application/postgresql.properties.
  2. Ubah kepemilikan file ini menjadi apigee: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. Tambahkan properti berikut ke file: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. Konfigurasi apigee-postgresql: 
    apigee-service apigee-postgresql configure
  5. Mulai ulang apigee-postgresql: 
    apigee-service apigee-postgresql restart

Melakukan upgrade di tempat

Untuk melakukan upgrade langsung ke Postgres 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 utama: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Jalankan perintah configure di host utama: 
    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 standby: 
    apigee-service apigee-postgresql stop
  8. Mengupgrade mode standby.

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

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Pastikan 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
  12. Hapus baris conf/postgresql.conf+max_locks_per_transaction=30000 dari file /opt/apigee/customer/application/postgresql.properties di host utama dan standby. Baris ini ditambahkan pada langkah awal.

Setelah menyelesaikan prosedur ini, standby akan berhasil dimulai.

Menonaktifkan node Postgres

Setelah update selesai, nonaktifkan 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 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 bahwa 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 API pengelolaan Edge berikut di node Server Pengelolaan: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Langkah-langkah pasca-upgrade untuk Postgres

Setelah upgrade Postgres utama, statistik internal Postgres akan dihapus. Statistik ini membantu perencana kueri Postgres dalam memanfaatkan indeks dan jalur yang paling optimal untuk menjalankan kueri.

Postgres dapat secara bertahap membangun kembali statistiknya dari waktu ke waktu saat kueri dieksekusi dan saat daemon autovacuum berjalan. Namun, hingga statistik dibangun ulang, kueri Anda mungkin lambat.

Untuk mengatasi masalah ini, jalankan ANALYZE di semua tabel dalam database di node Postgres utama. Atau, Anda dapat menjalankan ANALYZE untuk beberapa tabel sekaligus.

Langkah-langkah untuk mengupdate Apigee SSO dari versi yang lebih lama

Di Edge untuk Private Cloud 4.53.01, kunci dan sertifikat IDP yang digunakan dalam komponen apigee-sso kini dikonfigurasi melalui keystore. Anda harus mengekspor kunci dan sertifikat yang digunakan sebelumnya ke dalam keystore, mengonfigurasinya, lalu melanjutkan update SSO seperti biasa.

  1. Identifikasi kunci dan sertifikat yang ada yang digunakan untuk mengonfigurasi IDP:

    1. Ambil sertifikat dengan mencari nilai SSO_SAML_SERVICE_PROVIDER_CERTIFICATE di file konfigurasi penginstalan SSO atau dengan membuat kueri komponen apigee-sso untuk conf_login_service_provider_certificate.

      Gunakan perintah berikut di node SSO untuk membuat kueri apigee-sso untuk jalur sertifikat IDP. Di output, cari nilai di baris terakhir. 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. Ambil kunci dengan mencari nilai SSO_SAML_SERVICE_PROVIDER_KEY di file konfigurasi penginstalan SSO atau dengan membuat kueri komponen apigee-sso untuk conf_login_service_provider_key.

      Gunakan perintah berikut di node SSO untuk membuat kueri apigee-sso untuk jalur kunci IDP. Di output, cari nilai pada baris terakhir.

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. Ekspor kunci dan sertifikat ke keystore:
    1. Ekspor kunci dan sertifikat ke keystore PKCS12: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      Parameter:

      • certificate_path: Jalur ke file sertifikat yang diambil di Langkah 1.a.
      • key_path: Jalur ke file kunci pribadi yang diambil di Langkah 1.b.
      • keystore_path: Jalur ke keystore yang baru dibuat yang berisi sertifikat dan kunci pribadi.
      • alias: Alias yang digunakan untuk pasangan kunci dan sertifikat dalam keystore.

      Lihat dokumentasi OpenSSL untuk mengetahui detail selengkapnya.

    2. (Opsional) Ekspor kunci dan sertifikat dari PKCS12 ke keystore JKS: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      Parameter:

      • PKCS12_keystore_path: Jalur ke keystore PKCS12 yang dibuat di Langkah 2.a, yang berisi sertifikat dan kunci.
      • destination_keystore_path: Jalur ke keystore JKS baru tempat sertifikat dan kunci akan diekspor.
      • alias: Alias yang digunakan untuk pasangan kunci dan sertifikat dalam keystore JKS.

      3. Baca dokumentasi keytool untuk mengetahui detail selengkapnya.

  3. Ubah pemilik file keystore output menjadi pengguna "apigee": 
    sudo chown apigee:apigee <keystore_file>
  4. Tambahkan properti berikut di file konfigurasi Apigee SSO dan perbarui dengan jalur file keystore, sandi, jenis keystore, dan alias: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. Perbarui software Apigee SSO di node SSO seperti biasa menggunakan perintah berikut: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

UI Edge Baru

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

Menginstal UI Edge

Setelah menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal Edge UI, 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.

Update dengan mTLS Apigee

Untuk mengupdate Apigee mTLS , lakukan langkah-langkah berikut:

Me-roll back update

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

Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.53.01 untuk mengetahui 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, 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 upgrade tanpa periode nonaktif adalah menghapus setiap Router, satu per satu, dari load balancer. Kemudian, perbarui Router dan komponen lainnya di mesin yang sama dengan Router, lalu tambahkan kembali Router 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 aksesibilitas server (Message Processor/Router).
  3. Perbarui Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor pada node yang sama.
  4. Pastikan 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 untuk Private Cloud 4.52.02 atau 4.53.00.

Update ke 4.53.01 di node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

  1. Jika ada, nonaktifkan semua tugas cron yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga setelah update selesai.
  2. Login ke node Anda sebagai root untuk menginstal RPM Edge.
  3. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
  4. 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

  5. Jika saat ini Anda menggunakan Edge 4.52.02 atau 4.53.00:

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

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

      Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika 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 dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Perbarui utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Perbarui 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:

      • component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
        • cs: Cassandra
        • edge: Semua komponen Edge kecuali Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (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 Edgeselama penginstalan 4.52.02 atau 4.53.00.

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

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

Jika Anda kemudian memutuskan untuk mengembalikan update, gunakan prosedur yang dijelaskan dalam Mengembalikan 4.53.01.

Memperbarui ke 4.53.01 dari repo lokal

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

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

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

  1. Buat repo lokal 4.53.01 seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
  2. Untuk menginstal apigee-service dari file .tar:
    1. Di node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
    3. Di node baru, ekstrak file ke direktori /tmp: 
      tar -xzf apigee-4.53.01.tar.gz

      Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.

    4. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Untuk menginstal apigee-service menggunakan server web Nginx:
    1. Konfigurasi server web Nginx seperti yang dijelaskan dalam "Install from the repo using the Nginx webserver" di Install the Edge apigee-setup utility.
    2. Di node jarak jauh, download file bootstrap_4.53.01.sh Edge ke /tmp/bootstrap_4.53.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

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

    3. Di node jarak jauh, instal utilitas dan dependensi apigee-setup Edge: 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Tempat uName:pWord nama pengguna dan sandi repo berada.

  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. Perbarui utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Perbarui 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:

    • component adalah komponen Edge yang akan diupdate. Biasanya, Anda memperbarui komponen berikut:
      • cs: Cassandra
      • edge: Semua komponen Edge kecuali Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (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.52.02 atau 4.53.00.

    Anda dapat menjalankan update.sh terhadap semua komponen dengan menyetel component ke "all", tetapi hanya jika Anda memiliki profil penginstalan all-in-one (AIO) Edge. 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 Anda kemudian memutuskan untuk mengembalikan update, gunakan prosedur yang dijelaskan dalam Mengembalikan 4.53.01.

Urutan update mesin

Urutan pembaruan komputer dalam penginstalan Edge sangat penting:

  • Anda harus mengupdate semua node LDAP sebelum mengupdate komponen lainnya. Anda harus mengikuti langkah-langkah khusus untuk mengupgrade LDAP.
  • Anda harus memperbarui semua node Cassandra dan ZooKeeper. Jika Anda melakukan upgrade dari 4.52.02, ikuti langkah-langkah khusus untuk mengupgrade Cassandra. Anda harus mengikuti langkah-langkah khusus untuk mengupgrade Zookeeper untuk 4.52.02 atau 4.53.00.
  • Anda harus mengupgrade semua Server Pengelolaan dan Router & Pemroses Pesan menggunakan opsi edge -c untuk mengupdatenya.
  • Anda harus mengupgrade semua node Postgres dengan mengikuti langkah-langkah khusus untuk mengupgrade Postgres.
  • Anda harus mengupdate komponen edge-qpid-server & edge-postgres-server di semua pusat data.
  • Anda harus mengupgrade semua node Qpid.
  • Anda harus mengupgrade node UI Edge dan juga mengupgrade node UI Edge Baru dan SSO(jika berlaku).
  • Tidak ada langkah terpisah untuk memperbarui Monetisasi. Opsi ini diperbarui saat Anda menentukan opsi edge -c.

Upgrade mandiri 1 node

Untuk mengupgrade konfigurasi mandiri 1 node ke 4.53.01:

  1. Perbarui 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

Perbarui komponen berikut untuk penginstalan mandiri 2 node:

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

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

Upgrade 5 node

Perbarui komponen berikut untuk penginstalan 5 node:

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

  1. Perbarui LDAP di mesin 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. Perbarui Cassandra dan ZooKeeper di mesin 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui komponen Edge di mesin 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Update Postgres di mesin 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Perbarui Postgres di mesin 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Perbarui komponen Edge di mesin 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Perbarui Qpid di mesin 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Perbarui Qpid di mesin 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Perbarui 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, update komponen ue di komputer yang sesuai (mungkin bukan komputer 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (Jika Anda menginstal apigee-adminapi) Memperbarui utilitas apigee-adminapi di komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO di mesin 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.

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

Upgrade berkluster 9 node

Perbarui komponen berikut untuk penginstalan berkluster 9 node:

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

  1. Perbarui LDAP di mesin 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. Perbarui Cassandra dan ZooKeeper di mesin 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Perbarui komponen Edge di mesin 1, 4, dan 5 (Server pengelolaan, pemroses pesan, router) dalam urutan tersebut: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Perbarui Postgres di mesin 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Perbarui Postgres di mesin 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Perbarui komponen Edge di komputer 6, 7, 8, dan 9 dalam urutan tersebut: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Perbarui Qpid di mesin 6 dan 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Perbarui UI baru (ue) atau UI klasik (ui) di komputer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di komputer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO di mesin 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 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 yang sesuai (mungkin bukan komputer 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade berkluster 13 node

Perbarui komponen berikut untuk penginstalan berkluster 13 node:

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

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

  11. Mulai ulang komponen UI:
    • UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di 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 di komputer 6 dan 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade cluster 12 node

Perbarui komponen berikut untuk penginstalan berkluster 12 node:

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

  1. Perbarui LDAP:
    1. Machine 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
  2. Perbarui Cassandra dan ZooKeeper:
    1. Mesin 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
  3. Perbarui komponen Edge:
    1. Di mesin 1, 2, dan 3 di Pusat Data 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Di mesin 7, 8, dan 9 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. 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
  5. Perbarui komponen Edge:
    1. Mesin 4, 5, 6 di Pusat Data 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Mesin 10, 11, 12 di Pusat Data 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Perbarui qpidd:
    1. Mesin 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. Mesin 10, 11 di Pusat Data 2
      1. Update qpidd di mesin 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Perbarui qpidd di mesin 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 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. Mesin 7 di Pusat Data 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (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. Mesin 7 di Pusat Data 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (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. 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 menginstal SSO.

  10. 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. LDAP
  2. Cassandra
  3. Zookeeper
  4. Server Pengelolaan
  5. Message Processor
  6. Router
  7. Postgres
  8. Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, Edge Postgres Server.
  9. qpidd
  10. UI Edge (klasik atau baru)
  11. apigee-adminapi
  12. Apigee SSO

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