Apigee mendukung upgrade Edge untuk Private Cloud langsung dari versi 4.52.02 ke versi 4.53.00. Halaman ini menjelaskan cara melakukan upgrade tersebut.
Untuk ringkasan jalur upgrade yang kompatibel, lihat matriks kompatibilitas upgrade untuk rilis Edge for 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.
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.Dengan begitu, 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
- Memverifikasi prasyarat Cassandra
Jika sebelumnya Anda mengupgrade dari Edge for Private Cloud versi lama ke versi 4.52.02 dan sekarang berencana mengupgrade ke versi 4.53.00, pastikan Anda telah menyelesaikan langkah-langkah pasca-upgrade yang diperlukan untuk Cassandra. Langkah-langkah ini diuraikan dalam dokumentasi upgrade versi 4.52.02 di bagian Langkah-langkah pasca-upgrade. Jika Anda tidak yakin apakah langkah-langkah ini telah diselesaikan selama upgrade sebelumnya, selesaikan lagi sebelum melanjutkan upgrade ke versi 4.53.00. - Mengonfigurasi kunci dan sertifikat IDP di Edge untuk Private Cloud 4.53.00
Di Edge for Private Cloud 4.53.00, 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 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.
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 4.0.13
Apigee Edge untuk Private Cloud 4.53.00 menyertakan upgrade Cassandra ke versi 4.0.13.
Upgrade dan rollback
- Mengupgrade dari Cassandra 3.11.X ke Cassandra 4.0.X adalah proses yang lancar. Cassandra 4.0.X, yang dirilis dengan Edge for 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 pencadangan adalah prosedur yang rumit dan dapat melibatkan periode nonaktif dan/atau kehilangan data. Memecahkan masalah dan mengupgrade ke Cassandra 4.0.X lebih disarankan daripada melakukan rollback.
- Anda harus memahami prosedur rollback sebelum mencoba upgrade. Mempertimbangkan nuansa rollback selama upgrade sangatlah penting untuk memastikan jalur rollback yang sesuai tersedia.
Satu pusat data
Mengupgrade Cassandra dari 3.11.X ke 4.0.X dalam satu pusat data berjalan lancar, tetapi rollback-nya rumit dan dapat menyebabkan periode nonaktif dan kehilangan data. Untuk beban kerja produksi, sebaiknya tambahkan pusat data baru dengan minimal node Cassandra yang tersedia di pusat data baru sebelum memulai upgrade. Tindakan 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 menambahkan pusat data baru tidak memungkinkan, tetapi kemampuan rollback masih diinginkan, pencadangan akan diperlukan untuk memulihkan Cassandra 3.11.X. Namun, metode ini kemungkinan akan melibatkan periode nonaktif dan kehilangan data.
Beberapa pusat data
Mengoperasikan beberapa pusat data dengan Edge for Private Cloud 4.52.02 menawarkan fleksibilitas yang lebih besar untuk rollback selama upgrade ke Edge for Private Cloud 4.53.00.
- Rollback bergantung pada setidaknya satu pusat data yang menjalankan versi Cassandra yang lebih lama (3.11.X).
- Jika seluruh cluster Cassandra diupgrade ke 4.0.X, Anda tidak boleh melakukan rollback ke Cassandra 3.11.X. Anda harus terus menggunakan versi Cassandra yang lebih baru dengan komponen lain dari Cloud Pribadi 4.53.00 atau 4.52.02.
Metodologi upgrade yang direkomendasikan
- Upgrade satu pusat data Cassandra satu per satu: Mulailah dengan mengupgrade node Cassandra satu per satu dalam satu pusat data. Selesaikan upgrade semua node Cassandra di satu pusat data sebelum melanjutkan ke node berikutnya.
- Jeda dan validasi: Setelah mengupgrade satu pusat data, jeda untuk memastikan cluster Cloud Pribadi Anda, terutama pusat data yang diupgrade, berfungsi dengan benar.
- Ingat: Anda hanya dapat melakukan roll back ke versi Cassandra sebelumnya jika memiliki minimal satu pusat data yang masih menjalankan versi yang lebih lama.
- Sensitif waktu: Meskipun Anda dapat menjeda selama jangka waktu singkat (sebaiknya beberapa jam) untuk memvalidasi fungsi, Anda tidak dapat tetap 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.
- Pengujian menyeluruh: Apigee sangat merekomendasikan pengujian komprehensif terhadap performa dan fungsi sebelum mengupgrade pusat data berikutnya. Setelah semua pusat data diupgrade, rollback ke versi sebelumnya tidak dapat dilakukan.
Rollback sebagai proses dua titik pemeriksaan
- Pemeriksaan 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.
- Pemeriksaan 2: Setelah semua node Cassandra di semua pusat data diperbarui. Anda dapat melakukan rollback ke status ini, tetapi tidak dapat kembali ke Pemeriksaan 1.
Contoh
Pertimbangkan cluster dua pusat data (DC):
- Status awal: Node Cassandra di kedua DC menggunakan versi 3.11.X. Semua node lainnya menggunakan Edge untuk Private Cloud versi 4.52.02. Asumsikan tiga node Cassandra per DC.
- Upgrade DC-1: Upgrade tiga node Cassandra di DC-1 satu per satu.
- Jeda dan validasi: Jeda untuk memastikan cluster, terutama DC-1, berfungsi dengan benar (periksa performa, fungsi). Anda dapat melakukan rollback ke status awal menggunakan node Cassandra di DC-2. Ingat, jeda ini harus bersifat sementara karena batasan cluster Cassandra versi campuran.
- Upgrade DC-2: Upgrade tiga node Cassandra yang tersisa di DC-2. Tindakan ini akan menjadi titik pemeriksaan rollback baru Anda.
- Mengupgrade komponen lain: Mengupgrade node pengelolaan, runtime, dan analisis seperti biasa di semua pusat data, satu node dan satu pusat data dalam satu waktu. Jika masalah muncul, Anda dapat melakukan rollback ke status langkah 4.
Prasyarat untuk upgrade Cassandra
Anda harus menjalankan Cassandra 3.11.16 dengan Edge for Private Cloud 4.52.02 dan memastikan hal berikut:- Seluruh cluster beroperasi dan berfungsi penuh dengan Cassandra 3.11.16.
- Strategi pemadatan ditetapkan ke
LeveledCompactionStrategy
(prasyarat untuk upgrade ke versi 4.52.02). - Semua langkah pasca-upgrade dari upgrade awal ke Cassandra 3.11.16 sebagai bagian dari upgrade 4.52.02 telah selesai. Jika belum, jalankan kembali langkah-langkah ini. Hal ini hanya berlaku jika Anda mengupgrade ke Private Cloud versi 4.52.02 dari versi yang lebih 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.
- Cadangkan Cassandra menggunakan Apigee.
- Ambil snapshot VM node Cassandra (jika memungkinkan).
- Pastikan port 9042 dapat diakses dari semua komponen Edge for Private Cloud, termasuk Server Pengelolaan, Pemroses Pesan, Router, Qpid, dan Postgres, ke node Cassandra jika belum dikonfigurasi. Lihat Persyaratan port untuk informasi selengkapnya.
Langkah 2: Upgrade semua node Cassandra
Semua node Cassandra harus diupdate satu per satu di setiap pusat data, satu pusat data pada 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 pusat data yang diperbarui secara menyeluruh dan pastikan metrik fungsional dan performa cluster Apigee Anda tidak rusak. 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.
-
Untuk mengupgrade node Cassandra, Jalankan perintah berikut:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
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
-
Perintah di atas akan menghasilkan output seperti:
Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] Metadata is verified
-
Jalankan perintah
post_upgrade
berikut di node Cassandra:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
-
Jalankan perintah nodetool berikut untuk mem-build ulang indeks di node Cassandra:
Jika Anda menggunakan monetisasi, jalankan juga perintah buat ulang indeks berikut yang terkait dengan ruang kunci monetisasi:/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
/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.00 yang tersisa
Upgrade semua node edge-qpid-server
dan edge-postgres-server
yang tersisa di semua region satu per satu.
Langkah-langkah untuk mengupdate Apigee SSO dari versi lama
Di Edge for Private Cloud 4.53.00, kunci dan sertifikat IdP yang digunakan dalam komponen apigee-sso
kini dikonfigurasi melalui keystore. Anda harus mengekspor kunci dan sertifikat yang digunakan sebelumnya ke keystore, mengonfigurasinya, lalu melanjutkan update SSO seperti biasa.
-
Identifikasi kunci dan sertifikat yang ada yang digunakan untuk mengonfigurasi IdP:
-
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. Pada output, cari nilai di baris terakhir.apigee-service apigee-sso configure -search conf_login_service_provider_certificate
-
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. Pada output, cari nilai di baris terakhir.apigee-service apigee-sso configure -search conf_login_service_provider_key
-
-
Ekspor kunci dan sertifikat ke keystore:
-
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.
-
(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.
Lihat dokumentasi keytool untuk mengetahui detail selengkapnya.
-
Ekspor kunci dan sertifikat ke keystore PKCS12:
- Ubah pemilik file keystore output menjadi pengguna "apigee":
sudo chown apigee:apigee <keystore_file>
-
Tambahkan properti berikut di file konfigurasi SSO Apigee 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
-
Update 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 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.
Melakukan update dengan mTLS Apigee
Untuk mengupdate mTLS Apigee , lakukan langkah-langkah berikut:
Me-roll back update
Jika update gagal, Anda dapat mencoba memperbaiki masalah, lalu menjalankan
update.sh
lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan
dari bagian terakhir yang ditinggalkan.
Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.53.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.
- Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan dalam Urutan update mesin.
- 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).
- Perbarui Router yang dipilih dan semua komponen Edge lainnya di komputer yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor di node yang sama.
- Buat Router dapat dijangkau lagi.
- Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
- Lanjutkan update untuk mesin yang tersisa dalam penginstalan Anda.
Lakukan hal berikut sebelum dan sesudah update:
- Pada node Router dan Message Processor gabungan:
- Sebelum update – lakukan hal berikut:
- Membuat Router tidak dapat dijangkau.
- Membuat Pemroses Pesan tidak dapat dijangkau.
- Setelah update – lakukan hal berikut:
- Buat Pemroses Pesan dapat dijangkau.
- Buat Router dapat dijangkau.
- Sebelum update – lakukan hal berikut:
- 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 for Private Cloud 4.52.02.
Mengupdate ke 4.53.00 di node dengan koneksi internet eksternal
Gunakan prosedur berikut untuk mengupdate komponen Edge di node:
- Jika ada, nonaktifkan tugas
cron
yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga setelah update selesai. - Login ke node sebagai root untuk menginstal RPM Edge.
- Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
- 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
-
Jika saat ini Anda menggunakan Edge 4.52.02:
- Download file
bootstrap_4.53.00.sh
Edge ke/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instal utilitas dan dependensi
apigee-service
Edge 4.53.00 dengan menjalankan perintah berikut:sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, penginstal akan menginstalnya untuk Anda.
Gunakan opsi
JAVA_FIX
untuk menentukan cara menangani penginstalan Java.JAVA_FIX
menggunakan nilai berikut:I
: Menginstal OpenJDK 1.8 (default).C
: Lanjutkan tanpa menginstal Java.Q
: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
- Gunakan
apigee-service
untuk mengupdate utilitasapigee-setup
, seperti yang ditunjukkan pada contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 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
: Cassandraedge
: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (jika Anda menginstal SSO)ue
: UI Edge baruui
: UI Edge Klasikzk
: Zookeeper
- configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.52.02.
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
- component adalah komponen Edge yang akan diperbarui. Nilai yang memungkinkan mencakup:
- Mulai ulang komponen UI Edge di semua node yang menjalankannya, jika Anda belum melakukannya:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Uji update dengan menjalankan utilitas
apigee-validate
di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
- Download file
Jika nanti Anda memutuskan untuk melakukan rollback update, gunakan prosedur yang dijelaskan di Melakukan rollback 4.53.00.
Mengupdate ke 4.53.00 dari repo lokal
Jika node Edge Anda berada di balik firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui Internet, Anda dapat melakukan update dari repositori lokal, atau mirror, dari repo Apigee.
Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk mengupdate Edge dari repo lokal:
- Buat file .tar repo, salin file .tar ke node, lalu update Edge dari file .tar.
- Instal server web di node dengan repo lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.
Untuk mengupdate dari repo 4.53.00 lokal:
- Buat repo 4.53.00 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan apigee Edge.
- Untuk menginstal apigee-service dari file .tar:
- 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.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori
/tmp
di node baru. - Di node baru, ekstrak file ke direktori
/tmp
:tar -xzf apigee-4.53.00.tar.gz
Perintah ini membuat direktori baru, bernama
repos
, di direktori yang berisi file .tar. Misalnya,/tmp/repos
. - Instal utilitas dan dependensi
apigee-service
Edge dari/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Perhatikan bahwa Anda menyertakan jalur ke direktori repo dalam perintah ini.
- Di node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal
ke dalam satu file .tar bernama
- Untuk menginstal apigee-service menggunakan server web Nginx:
- Konfigurasikan server web Nginx seperti yang dijelaskan di "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas penyiapan apigee Edge.
- Di node jarak jauh, download file
bootstrap_4.53.00.sh
Edge ke/tmp/bootstrap_4.53.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan sebelumnya untuk repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.
- Di node jarak jauh, instal utilitas dan dependensi
apigee-setup
Edge:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dengan uName:pWord adalah nama pengguna dan sandi repo.
- Gunakan
apigee-service
untuk mengupdate utilitasapigee-setup
, seperti yang ditunjukkan pada contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Update utilitas
apigee-validate
di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Update utilitas
apigee-provision
di Server Pengelolaan, seperti yang ditunjukkan dalam contoh berikut:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 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
: Cassandraedge
: Semua komponen Edge kecuali UI Edge: Server Pengelolaan, Pemroses Pesan, Router, Server QPID, Server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (jika Anda menginstal SSO)ue
UI Edge Baruui
: UI Edge Klasikzk
: 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
- component adalah komponen Edge yang akan diperbarui. Anda biasanya memperbarui
komponen berikut:
- 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
- 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.53.00.
Urutan update mesin
Urutan pembaruan mesin dalam penginstalan Edge sangat penting:
- Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
- Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Pemroses Pesan,
Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi
-c edge
untuk mengupdate semuanya secara bersamaan. - Jika langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa komputer, lakukan 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.53.00:
- Perbarui semua komponen:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Update utilitasapigee-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.
- Update Cassandra dan ZooKeeper di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Postgres di mesin 2:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge di mesin 2 dan 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Update Qpid di Mesin 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Mengupdate utilitasapigee-adminapi
di komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- Mulai ulang komponen UI Edge di mesin 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade 5 node
Update komponen berikut untuk penginstalan 5 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Postgres di mesin 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update Postgres di mesin 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Update komponen Edge di mesin 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Update Qpid di mesin 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update Qpid di mesin 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI Edge:
- UI Klasik: Jika Anda menggunakan UI klasik, update
komponen
ui
di mesin 1, seperti yang ditunjukkan pada contoh berikut:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- UI Edge baru: Jika Anda menginstal UI Edge baru, update komponen
ue
di komputer yang sesuai (mungkin bukan komputer 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- UI Klasik: Jika Anda menggunakan UI klasik, update
komponen
- (Jika Anda menginstal
apigee-adminapi
) Mengupdate utilitasapigee-adminapi
di komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang
komponen
Upgrade cluster 9 node
Update komponen berikut untuk penginstalan cluster 9 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Postgres di mesin 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update Postgres di mesin 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di mesin 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- Update Qpid di mesin 6 dan 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update UI baru (
ue
) atau UI klasik (ui
) di komputer 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jika Anda menginstal
apigee-adminapi
) Update utilitasapigee-adminapi
di komputer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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 komputer yang sesuai (mungkin bukan komputer 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang
komponen
Upgrade cluster 13 node
Update komponen berikut untuk penginstalan cluster 13 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Update Postgres di mesin 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Update Postgres di mesin 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Perbarui LDAP di mesin 4 dan 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- Update Qpid di mesin 12 dan 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 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
- (Jika Anda menginstal
apigee-adminapi
) Memperbarui utilitasapigee-adminapi
di komputer 6 dan 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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.
- 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
- UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang
komponen
Upgrade cluster 12 node
Update komponen berikut untuk penginstalan cluster 12 node:
Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
- Update Cassandra dan ZooKeeper:
- Di komputer 1, 2, dan 3 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Di mesin 7, 8, dan 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Di komputer 1, 2, dan 3 di Pusat Data 1:
- Update Postgres:
- Mesin 6 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Komputer 12 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Mesin 6 di Pusat Data 1
- Memperbarui LDAP:
- Mesin 1 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Komputer 7 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Mesin 1 di Pusat Data 1
- Perbarui komponen Edge:
- Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Komputer 10, 11, 12, 7, 8, 9 di Pusat Data 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
- Update qpidd:
- Komputer 4, 5 di Pusat Data 1
- Update
qpidd
di mesin 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
qpidd
di mesin 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
- Komputer 10, 11 di Pusat Data 2
- Update
qpidd
di mesin 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
qpidd
di mesin 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Update
- Komputer 4, 5 di Pusat Data 1
- Update UI baru (
ue
) atau UI klasik (ui
):- Mesin 1 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Komputer 7 di Pusat Data 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Mesin 1 di Pusat Data 1:
- (Jika Anda menginstal
apigee-adminapi
) Mengupdate utilitasapigee-adminapi
:- Mesin 1 di Pusat Data 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Komputer 7 di Pusat Data 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Mesin 1 di Pusat Data 1:
- (Jika Anda menginstal Apigee SSO) Perbarui Apigee SSO:
- Mesin 1 di Pusat Data 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- 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.
- Mesin 1 di Pusat Data 1:
- 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:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, Server Postgres Edge, Server Pengelolaan, Pemroses Pesan, dan Router.
- qpidd
- UI Edge (klasik atau baru)
apigee-adminapi
- SSO Apigee
Setelah Anda selesai mengupdate, pastikan untuk memulai ulang komponen UI Edge di semua mesin yang menjalankannya.