Cập nhật Apigee Edge 4.52.02 lên 4.53.00

Apigee hỗ trợ nâng cấp Edge cho Private Cloud trực tiếp từ phiên bản 4.52.02 lên phiên bản 4.53.00. Trang này mô tả cách thực hiện các bản nâng cấp như vậy.

Để biết thông tin tổng quan về các đường dẫn nâng cấp tương thích, hãy xem ma trận khả năng tương thích khi nâng cấp cho các bản phát hành Edge cho Đám mây riêng.

Người có thể thực hiện việc cập nhật

Người chạy bản cập nhật phải giống với người đã cài đặt Edge ban đầu hoặc là người chạy với tư cách là người dùng root.

Sau khi bạn cài đặt các RPM của Edge, mọi người đều có thể định cấu hình chúng.

Bạn phải cập nhật những thành phần nào

Bạn phải cập nhật tất cả các thành phần của Edge. Edge không hỗ trợ chế độ thiết lập có các thành phần từ nhiều phiên bản.

Cập nhật các điều kiện tiên quyết

Đảm bảo bạn đáp ứng các điều kiện tiên quyết sau đây trước khi nâng cấp Apigee Edge:

• Sao lưu tất cả các nút
  Trước khi cập nhật, bạn nên sao lưu đầy đủ tất cả các nút vì lý do an toàn. Hãy dùng quy trình sao lưu cho phiên bản Edge hiện tại của bạn.

  Điều này giúp bạn có kế hoạch dự phòng trong trường hợp bản cập nhật lên phiên bản mới không hoạt động đúng cách. Để biết thêm thông tin về tính năng sao lưu, hãy xem bài viết Sao lưu và khôi phục.

• Đảm bảo Edge đang chạy
  Đảm bảo Edge đang chạy trong quá trình cập nhật bằng cách sử dụng lệnh:

  /opt/apigee/apigee-service/bin/apigee-all status

• Xác minh các điều kiện tiên quyết của Cassandra
  

  Nếu trước đây bạn đã nâng cấp từ phiên bản cũ hơn của Edge for Private Cloud lên phiên bản 4.52.02 và hiện đang có kế hoạch nâng cấp lên phiên bản 4.53.00, hãy đảm bảo rằng bạn đã hoàn tất các bước bắt buộc sau khi nâng cấp cho Cassandra. Các bước này được nêu trong tài liệu nâng cấp lên phiên bản 4.52.02 và cũng được đề cập trong phần Điều kiện tiên quyết để nâng cấp Cassandra. Nếu bạn không chắc liệu các bước này đã được hoàn tất trong lần nâng cấp trước hay chưa, hãy hoàn tất lại các bước này trước khi tiếp tục nâng cấp lên phiên bản 4.53.00.

• Định cấu hình khoá và chứng chỉ IDP trong Edge cho Đám mây riêng 4.53.00
  

  Trong Edge cho Đám mây riêng tư 4.53.00, các khoá và chứng chỉ IDP được dùng trong thành phần apigee-sso hiện được định cấu hình thông qua một kho khoá. Bạn sẽ cần xuất khoá và chứng chỉ mà bạn đã dùng trước đó vào một kho khoá. Hãy làm theo các bước trong phần Các bước cập nhật SSO Apigee từ các phiên bản cũ để biết các bước chi tiết trước khi cập nhật thành phần SSO.

• Yêu cầu về Python
  Đảm bảo rằng tất cả các nút, bao gồm cả nút Cassandra, đều đã cài đặt Python 3 trước khi thử nâng cấp.

Tự động truyền các chế độ cài đặt tài sản

Nếu bạn đã đặt bất kỳ thuộc tính nào bằng cách chỉnh sửa tệp .properties trong /opt/apigee/customer/application, thì bản cập nhật sẽ giữ lại các giá trị này.

Nâng cấp Nginx 1.26 trong Edge-Router

Việc nâng cấp lên Edge cho Đám mây riêng tư 4.53.00 từ các phiên bản trước đó sẽ không tự động nâng cấp phần mềm Nginx lên phiên bản mới nhất (1.26.x). Điều này nhằm ngăn chặn mọi tác dụng phụ không mong muốn trong thời gian chạy do những thay đổi được ghi lại trong Các thay đổi của Nginx 1.26 trong Apigee Edge 4.53.00. Bạn có thể nâng cấp Nginx từ 1.20.x lên 1.26.x theo cách thủ công sau khi xác minh trong các môi trường thấp hơn. Cách nâng cấp theo cách thủ công:

1. Đảm bảo nút bộ định tuyến biên có phần mềm 4.53.00 mới nhất

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

2. Kiểm tra và xác minh phiên bản Nginx mà bạn hiện đang chạy

   /opt/nginx/sbin/nginx -V

   Nếu đang vận hành phiên bản Nginx cũ, bạn có thể làm theo các bước bên dưới để nâng cấp Nginx lên phiên bản 1.26.X trên nút bộ định tuyến.

3. Dừng quy trình bộ định tuyến biên trên nút bộ định tuyến

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

4. Nâng cấp phần mềm nginx trên nút bộ định tuyến

   dnf update apigee-nginx

5. Xác minh rằng phiên bản Nginx đã được cập nhật

   /opt/nginx/sbin/nginx -V

6. Bắt đầu quy trình bộ định tuyến trên nút

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

7. Lặp lại quy trình này trên từng nút bộ định tuyến, mỗi lần một nút

Bắt buộc phải nâng cấp lên Cassandra 4.0.13

Apigee Edge cho Private Cloud 4.53.00 bao gồm một bản nâng cấp Cassandra lên phiên bản 4.0.13.

Nâng cấp và khôi phục

• Việc nâng cấp từ Cassandra 3.11.X lên Cassandra 4.0.X diễn ra suôn sẻ. Cassandra 4.0.X, được phát hành cùng với Edge cho Đám mây riêng tư 4.53.00, tương thích với các thành phần thời gian chạy và quản lý của Đám mây riêng tư 4.52.02.
• Bạn không thể khôi phục trực tiếp tại chỗ từ Cassandra 4.0.X về 3.11.X. Việc khôi phục bằng cách sử dụng bản sao hoặc bản sao lưu là một quy trình phức tạp và có thể dẫn đến thời gian ngừng hoạt động và/hoặc mất dữ liệu. Bạn nên khắc phục sự cố và nâng cấp lên Cassandra 4.0.X thay vì quay lại phiên bản cũ.
• Bạn cần nắm rõ các quy trình khôi phục trước khi thử nâng cấp. Việc xem xét các sắc thái của quy trình khôi phục trong quá trình nâng cấp là rất quan trọng để đảm bảo có sẵn các đường dẫn khôi phục phù hợp.

Một trung tâm dữ liệu

Việc nâng cấp Cassandra từ 3.11.X lên 4.0.X trong một trung tâm dữ liệu duy nhất diễn ra liền mạch, nhưng việc khôi phục rất phức tạp và có thể dẫn đến thời gian ngừng hoạt động cũng như mất dữ liệu. Đối với các khối lượng công việc sản xuất, bạn nên thêm một trung tâm dữ liệu mới có ít nhất các nút Cassandra trong trung tâm dữ liệu mới trước khi bắt đầu nâng cấp. Điều này sẽ cho phép bạn khôi phục Cassandra mà không làm mất dữ liệu hoặc gián đoạn lưu lượng truy cập API. Bạn có thể ngừng hoạt động trung tâm dữ liệu bổ sung này sau khi quá trình nâng cấp hoàn tất hoặc đạt đến Điểm kiểm tra 2.

Nếu không thể thêm một trung tâm dữ liệu mới nhưng bạn vẫn muốn có khả năng khôi phục, thì bạn sẽ cần sao lưu để khôi phục Cassandra 3.11.X. Tuy nhiên, phương pháp này có thể dẫn đến cả thời gian ngừng hoạt động và mất dữ liệu.

Nhiều trung tâm dữ liệu

Việc vận hành nhiều trung tâm dữ liệu bằng Edge cho Đám mây riêng tư 4.52.02 mang lại sự linh hoạt hơn cho các lần khôi phục trong quá trình nâng cấp lên Edge cho Đám mây riêng tư 4.53.00.

• Việc khôi phục phụ thuộc vào việc có ít nhất một trung tâm dữ liệu đang chạy phiên bản Cassandra cũ hơn (3.11.X).
• Nếu nâng cấp toàn bộ cụm Cassandra lên phiên bản 4.0.X, bạn không được quay lại phiên bản Cassandra 3.11.X. Bạn phải tiếp tục sử dụng phiên bản Cassandra mới hơn với các thành phần khác của Đám mây riêng tư 4.53.00 hoặc 4.52.02.

Phương pháp nâng cấp được đề xuất

1. Nâng cấp từng trung tâm dữ liệu Cassandra: Bắt đầu bằng cách nâng cấp từng nút Cassandra trong một trung tâm dữ liệu. Hoàn tất việc nâng cấp tất cả các nút Cassandra trong một trung tâm dữ liệu trước khi chuyển sang trung tâm dữ liệu tiếp theo.
2. Tạm dừng và xác thực: Sau khi nâng cấp một trung tâm dữ liệu, hãy tạm dừng để đảm bảo cụm Đám mây riêng tư của bạn, đặc biệt là trung tâm dữ liệu đã nâng cấp, đang hoạt động đúng cách.
3. Lưu ý: Bạn chỉ có thể khôi phục về phiên bản Cassandra trước đó nếu có ít nhất một trung tâm dữ liệu vẫn đang chạy phiên bản cũ.
4. Nhạy cảm về thời gian: Mặc dù có thể tạm dừng trong một khoảng thời gian ngắn (nên là vài giờ) để xác thực chức năng, nhưng bạn không thể duy trì trạng thái hỗn hợp vô thời hạn. Điều này là do một cụm Cassandra không đồng nhất (với các nút trên các phiên bản khác nhau) có những hạn chế về hoạt động.
5. Kiểm thử kỹ lưỡng: Apigee đặc biệt khuyến khích bạn kiểm thử toàn diện hiệu suất và chức năng trước khi nâng cấp trung tâm dữ liệu tiếp theo. Sau khi tất cả trung tâm dữ liệu được nâng cấp, bạn sẽ không thể quay lại phiên bản trước đó.

Khôi phục dưới dạng quy trình gồm 2 điểm kiểm tra

1. Chốt kiểm tra 1: Trạng thái ban đầu, với tất cả các thành phần ở phiên bản 4.52.02. Bạn có thể khôi phục hoàn toàn miễn là có ít nhất một trung tâm dữ liệu Cassandra vẫn dùng phiên bản cũ.
2. Điểm kiểm tra 2: Sau khi tất cả các nút Cassandra trong mọi trung tâm dữ liệu được cập nhật. Bạn có thể quay lại trạng thái này, nhưng không thể quay lại Trạm kiểm soát 1.

Ví dụ:

Hãy cân nhắc một cụm gồm 2 trung tâm dữ liệu (DC):

1. Trạng thái ban đầu: Các nút Cassandra ở cả hai DC đều ở phiên bản 3.11.X. Tất cả các nút khác đều nằm trên Edge for Private Cloud phiên bản 4.52.02. Giả sử có 3 nút Cassandra trên mỗi DC.
2. Nâng cấp DC-1: Nâng cấp từng nút Cassandra trong DC-1.
3. Tạm dừng và xác thực: Tạm dừng để đảm bảo cụm, đặc biệt là DC-1, đang hoạt động đúng cách (kiểm tra hiệu suất, chức năng). Bạn có thể quay lại trạng thái ban đầu bằng cách sử dụng các nút Cassandra trong DC-2. Xin lưu ý rằng bạn chỉ có thể tạm dừng tạm thời do những hạn chế của cụm Cassandra có nhiều phiên bản.
4. Nâng cấp DC-2: Nâng cấp 3 nút Cassandra còn lại trong DC-2. Đây sẽ là điểm khôi phục mới của bạn.
5. Nâng cấp các thành phần khác: Nâng cấp các nút quản lý, thời gian chạy và phân tích như bình thường trên tất cả các trung tâm dữ liệu, mỗi lần một nút và một trung tâm dữ liệu. Nếu gặp vấn đề, bạn có thể quay lại trạng thái của bước 4.

Điều kiện tiên quyết để nâng cấp Cassandra

1. Toàn bộ cụm đang hoạt động và có đầy đủ chức năng với Cassandra 3.11.16.
2. Chiến lược nén được đặt thành LeveledCompactionStrategy (điều kiện tiên quyết để nâng cấp lên phiên bản 4.52.02).
3. Đảm bảo rằng bạn đã hoàn tất tất cả các bước bên dưới trong quá trình nâng cấp ban đầu Cassandra 3.11 trong Edge cho Đám mây riêng tư 4.52.02:
   • Lệnh post_upgrade phải được thực thi trên mỗi nút Cassandra trong quá trình nâng cấp trước đó.
   • Lệnh drop_old_tables phải được thực thi trên toàn bộ cụm Cassandra trong quá trình nâng cấp trước đó.

Nếu không chắc chắn đã hoàn tất các bước trước đó hay chưa, bạn có thể chạy lại các bước đó một cách an toàn. Đảm bảo rằng bạn thực hiện các bước này trên Cassandra 3.11 khi vẫn đang dùng Edge cho Private Cloud 4.52.02, trước khi thử nâng cấp lên 4.53.00:

1. Chạy lệnh post_upgrade sau đây trên từng nút Cassandra theo thứ tự:

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

2. Chạy lệnh sau để xoá các bảng cũ không dùng đến khỏi cụm Cassandra. Bạn chỉ nên thực thi lệnh này trên 1 nút trong cụm:

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

Bước 1: Chuẩn bị cho quá trình nâng cấp

Các bước dưới đây là các bước bổ sung cho những tệp tiêu chuẩn mà bạn thường tạo, chẳng hạn như tệp cấu hình tiêu chuẩn của Apigee để bật các bản nâng cấp thành phần.

1. Sao lưu Cassandra bằng Apigee.
2. Chụp nhanh máy ảo của các nút Cassandra (nếu có thể).
3. Đảm bảo rằng tất cả các thành phần Edge cho Đám mây riêng tư (bao gồm cả Máy chủ quản lý, Trình xử lý thông báo, Bộ định tuyến, Qpid và Postgres) đều có thể truy cập vào cổng 9042 đối với các nút Cassandra nếu chưa được định cấu hình. Hãy tham khảo Yêu cầu về cổng để biết thêm thông tin.

Bước 2: Nâng cấp tất cả các nút Cassandra

Bạn nên cập nhật từng nút Cassandra trong mỗi trung tâm dữ liệu, mỗi lần một trung tâm dữ liệu. Giữa các lần nâng cấp nút trong một trung tâm dữ liệu, hãy đợi vài phút để đảm bảo rằng một nút đã cập nhật đã khởi động hoàn toàn và tham gia vào cụm trước khi tiếp tục nâng cấp một nút khác trong cùng một trung tâm dữ liệu.

Sau khi nâng cấp tất cả các nút Cassandra trong một trung tâm dữ liệu, hãy đợi một khoảng thời gian (từ 30 phút đến vài giờ) trước khi tiếp tục với các nút trong trung tâm dữ liệu tiếp theo. Trong thời gian này, hãy xem xét kỹ lưỡng trung tâm dữ liệu đã được cập nhật và đảm bảo rằng các chỉ số về chức năng và hiệu suất của cụm Apigee vẫn nguyên vẹn. Bước này rất quan trọng để đảm bảo tính ổn định của trung tâm dữ liệu nơi Cassandra đã được nâng cấp lên phiên bản 4.0.X, trong khi các thành phần còn lại của Apigee vẫn ở phiên bản 4.52.02.

1. Để nâng cấp một nút Cassandra, hãy chạy lệnh sau:

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

2. Sau khi cập nhật một nút, hãy chạy lệnh sau trên nút đó để chạy một số quy trình xác thực trước khi tiếp tục:

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

3. Thao tác trên sẽ xuất ra nội dung tương tự như sau:

   Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
   Metadata is verified

4. Chạy lệnh post_upgrade sau đây trên nút Cassandra:

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

5. Chạy các lệnh nodetool sau đây để tạo lại chỉ mục trên nút 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

   Nếu bạn đang sử dụng tính năng kiếm tiền, hãy chạy cả các lệnh tạo lại chỉ mục sau đây liên quan đến các không gian khoá kiếm tiền:

   /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

Bước 3: Nâng cấp tất cả các nút Quản lý

Nâng cấp từng nút Quản lý trong tất cả các khu vực:

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

Bước 4: Nâng cấp tất cả các nút Thời gian chạy

Nâng cấp tất cả các nút Router và Message Processor trong tất cả các khu vực theo từng bước:

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

Bước 5: Nâng cấp tất cả các thành phần còn lại của Edge cho Đám mây riêng tư 4.53.00

Nâng cấp tất cả các nút edge-qpid-server và edge-postgres-server còn lại trong tất cả các khu vực theo từng nút.

Các bước cập nhật Apigee SSO từ các phiên bản cũ

Trong Edge cho Đám mây riêng tư 4.53.00, các khoá và chứng chỉ IDP được dùng trong thành phần apigee-sso hiện được định cấu hình thông qua một kho khoá. Bạn sẽ cần xuất khoá và chứng chỉ đã dùng trước đó vào một kho khoá, định cấu hình kho khoá đó, rồi tiến hành cập nhật SSO như bình thường.

1. Xác định khoá và chứng chỉ hiện có được dùng để định cấu hình IDP:

   1. Truy xuất chứng chỉ bằng cách tra cứu giá trị của SSO_SAML_SERVICE_PROVIDER_CERTIFICATE trong tệp cấu hình cài đặt SSO hoặc bằng cách truy vấn thành phần apigee-sso cho conf_login_service_provider_certificate.

      Sử dụng lệnh sau trên nút SSO để truy vấn apigee-sso cho đường dẫn chứng chỉ IDP. Trong dữ liệu đầu ra, hãy tìm giá trị ở dòng cuối cùng.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. Truy xuất khoá bằng cách tra cứu giá trị của SSO_SAML_SERVICE_PROVIDER_KEY trong tệp cấu hình cài đặt SSO hoặc bằng cách truy vấn thành phần apigee-sso cho conf_login_service_provider_key.

      Sử dụng lệnh sau trên nút SSO để truy vấn apigee-sso cho đường dẫn khoá IDP. Trong dữ liệu đầu ra, hãy tìm giá trị ở dòng cuối cùng.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. Xuất khoá và chứng chỉ sang kho khoá:
   1. Xuất khoá và chứng chỉ sang kho khoá PKCS12:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      Các thông số:

      • certificate_path: Đường dẫn đến tệp chứng chỉ được truy xuất trong Bước 1.a.
      • key_path: Đường dẫn đến tệp khoá riêng tư được truy xuất trong Bước 1.b.
      • keystore_path: Đường dẫn đến kho khoá mới tạo có chứa chứng chỉ và khoá riêng tư.
      • alias: Bí danh dùng cho cặp khoá và chứng chỉ trong kho khoá.

      Hãy tham khảo tài liệu OpenSSL để biết thêm thông tin chi tiết.

   2. (Không bắt buộc) Xuất khoá và chứng chỉ từ PKCS12 sang kho khoá JKS:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      Các thông số:

      • PKCS12_keystore_path: Đường dẫn đến kho khoá PKCS12 được tạo ở Bước 2.a, chứa chứng chỉ và khoá.
      • destination_keystore_path: Đường dẫn đến kho khoá JKS mới nơi chứng chỉ và khoá sẽ được xuất.
      • alias: Bí danh dùng cho cặp khoá và chứng chỉ trong kho khoá JKS.

   Hãy tham khảo tài liệu về keytool để biết thêm thông tin chi tiết.

3. Thay đổi chủ sở hữu của tệp kho khoá đầu ra thành người dùng "apigee":

   sudo chown apigee:apigee <keystore_file>

4. Thêm các thuộc tính sau vào tệp cấu hình Apigee SSO rồi cập nhật các thuộc tính đó bằng đường dẫn tệp kho khoá, mật khẩu, loại kho khoá và bí danh:

   # 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. Cập nhật phần mềm Apigee SSO trên nút SSO như bình thường bằng lệnh sau:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

Giao diện người dùng mới của Edge

Phần này liệt kê những điểm cần cân nhắc liên quan đến giao diện người dùng Edge. Để biết thêm thông tin, hãy xem phần Giao diện người dùng Edge mới cho Đám mây riêng tư.

Cài đặt giao diện người dùng Edge

Sau khi hoàn tất quy trình cài đặt ban đầu, Apigee đề xuất bạn cài đặt Giao diện người dùng Edge. Đây là một giao diện người dùng nâng cao dành cho nhà phát triển và quản trị viên của Apigee Edge cho Đám mây riêng tư.

Xin lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt Xác thực cơ bản và sử dụng một IDP (nhà cung cấp danh tính) như SAML hoặc LDAP.

Để biết thêm thông tin, hãy xem phần Cài đặt giao diện người dùng Edge mới.

Cập nhật bằng Apigee mTLS

Để cập nhật Apigee mTLS , hãy thực hiện các bước sau:

• Gỡ cài đặt Apigee mTLS.
• Cài đặt lại Apigee mTLS.

Quay lại phiên bản trước của bản cập nhật

Trong trường hợp cập nhật không thành công, bạn có thể thử khắc phục vấn đề, sau đó thực thi lại update.sh. Bạn có thể chạy quy trình cập nhật nhiều lần và quy trình này sẽ tiếp tục cập nhật từ lần cập nhật gần đây nhất.

Nếu lỗi này yêu cầu bạn khôi phục bản cập nhật về phiên bản trước, hãy xem phần Khôi phục phiên bản 4.53.00 để biết hướng dẫn chi tiết.

Ghi nhật ký thông tin cập nhật

Theo mặc định, tiện ích update.sh sẽ ghi thông tin nhật ký vào:

/opt/apigee/var/log/apigee-setup/update.log

Nếu người chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích sẽ ghi nhật ký vào thư mục /tmp dưới dạng một tệp có tên là update_username.log.

Nếu người đó không có quyền truy cập vào /tmp, thì tiện ích update.sh sẽ không hoạt động.

Cập nhật mà không có thời gian ngừng hoạt động

Bản cập nhật không có thời gian ngừng hoạt động hoặc bản cập nhật từng bước cho phép bạn cập nhật bản cài đặt Edge mà không cần tắt Edge.

Bạn chỉ có thể cập nhật mà không bị gián đoạn với cấu hình 5 nút trở lên.

Chìa khoá để nâng cấp mà không bị gián đoạn là xoá từng Bộ định tuyến, mỗi lần một Bộ định tuyến, khỏi bộ cân bằng tải. Sau đó, bạn cập nhật Bộ định tuyến và mọi thành phần khác trên cùng một máy với Bộ định tuyến, rồi thêm Bộ định tuyến trở lại trình cân bằng tải.

1. Cập nhật các máy theo đúng thứ tự cho quá trình cài đặt như mô tả trong phần Thứ tự cập nhật máy.
2. Khi đến thời điểm cập nhật Bộ định tuyến, hãy chọn một Bộ định tuyến bất kỳ và khiến Bộ định tuyến đó không thể truy cập được, như mô tả trong phần Bật/Tắt khả năng truy cập của máy chủ (Bộ xử lý thông báo/Bộ định tuyến).
3. Cập nhật Bộ định tuyến đã chọn và tất cả các thành phần Edge khác trên cùng một máy với Bộ định tuyến. Tất cả các cấu hình Edge đều cho thấy Bộ định tuyến và Trình xử lý thông báo trên cùng một nút.
4. Đảm bảo có thể truy cập lại vào Bộ định tuyến.
5. Lặp lại các bước từ 2 đến 4 cho các Bộ định tuyến còn lại.
6. Tiếp tục cập nhật cho mọi máy còn lại trong quá trình cài đặt.

Hãy lưu ý những điều sau đây trước và sau khi cập nhật:

• Trên nút Bộ định tuyến và Bộ xử lý thông báo kết hợp:
  • Trước khi cập nhật – thực hiện những việc sau:
    1. Khiến Bộ định tuyến không thể truy cập.
    2. Khiến Message Processor không thể truy cập.
  • Sau khi cập nhật – thực hiện các bước sau:
    1. Đảm bảo Trình xử lý tin nhắn có thể truy cập được.
    2. Đảm bảo có thể truy cập vào Bộ định tuyến.
• Trên các nút Bộ định tuyến đơn:
  • Trước khi cập nhật, hãy khiến Bộ định tuyến không thể truy cập được.
  • Sau khi cập nhật, hãy đảm bảo có thể truy cập vào Bộ định tuyến.
• Trên các nút Bộ xử lý thông báo đơn lẻ:
  • Trước khi cập nhật, hãy khiến Message Processor không thể truy cập được.
  • Sau khi cập nhật, hãy đảm bảo Message Processor có thể truy cập được.

Sử dụng tệp cấu hình im lặng

Bạn phải truyền một tệp cấu hình im lặng vào lệnh cập nhật. Tệp cấu hình im lặng phải là tệp mà bạn đã dùng để cài đặt Edge cho Đám mây riêng tư 4.52.02.

Cập nhật lên phiên bản 4.53.00 trên một nút có kết nối Internet bên ngoài

Hãy làm theo quy trình sau để cập nhật các thành phần Edge trên một nút:

1. Nếu có, hãy vô hiệu hoá mọi công việc cron được định cấu hình để thực hiện thao tác sửa chữa trên Cassandra cho đến khi quá trình cập nhật hoàn tất.
2. Đăng nhập vào nút của bạn với tư cách là người dùng root để cài đặt các RPM Edge.
3. Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup Edge.
4. Nếu bạn đang cài đặt trên AWS, hãy thực thi các lệnh yum-configure-manager sau:

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

5. Nếu bạn đang dùng Edge 4.52.02:

   1. Tải tệp bootstrap_4.53.00.sh Edge xuống /tmp/bootstrap_4.53.00.sh:

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

   2. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge 4.53.00 bằng cách thực thi lệnh sau:

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

      Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã này.

      Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo bạn đã cài đặt Java 1.8. Nếu bạn chưa cài đặt, trình cài đặt sẽ cài đặt cho bạn.

      Sử dụng lựa chọn JAVA_FIX để chỉ định cách xử lý quá trình cài đặt Java. JAVA_FIX nhận các giá trị sau:

      • I: Cài đặt OpenJDK 1.8 (mặc định).
      • C: Tiếp tục mà không cần cài đặt Java.
      • Q: Thoát. Đối với lựa chọn này, bạn phải tự cài đặt Java.
   3. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như ví dụ sau đây minh hoạ:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như ví dụ sau đây minh hoạ:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như ví dụ sau đây minh hoạ:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. Chạy tiện ích update trên các nút bằng cách thực thi lệnh sau:

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

      Hãy thực hiện theo thứ tự được mô tả trong phần Thứ tự cập nhật máy.

      Trong trường hợp:

      • component là thành phần Edge cần cập nhật. Các giá trị có thể là:
        • cs: Cassandra
        • edge: Tất cả các thành phần Edge, ngoại trừ giao diện người dùng Edge: Máy chủ quản lý, Trình xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (nếu bạn đã cài đặt SSO)
        • ue: Giao diện người dùng mới của Edge
        • ui: Giao diện người dùng Edge cổ điển
        • zk: Zookeeper
      • configFile là tệp cấu hình mà bạn đã dùng để xác định các thành phần Edge trong quá trình cài đặt 4.52.02.

      Bạn có thể chạy update.sh trên tất cả các thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có một hồ sơ cài đặt Edge tất cả trong một (AIO). Ví dụ:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. Khởi động lại các thành phần giao diện người dùng Edge trên tất cả các nút đang chạy các thành phần đó (nếu bạn chưa làm):

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

   8. Kiểm thử bản cập nhật bằng cách chạy tiện ích apigee-validate trên Máy chủ quản lý, như mô tả trong phần Kiểm thử quá trình cài đặt.

Nếu sau này bạn quyết định quay lại bản cập nhật, hãy sử dụng quy trình được mô tả trong phần Quay lại phiên bản 4.53.00.

Cập nhật lên 4.53.00 từ kho lưu trữ cục bộ

Nếu các nút Edge của bạn nằm sau tường lửa hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet theo một cách nào đó, thì bạn có thể thực hiện việc cập nhật từ một kho lưu trữ cục bộ hoặc bản sao của kho lưu trữ Apigee.

Sau khi tạo một kho lưu trữ Edge cục bộ, bạn có hai lựa chọn để cập nhật Edge từ kho lưu trữ cục bộ:

• Tạo tệp .tar của kho lưu trữ, sao chép tệp .tar vào một nút, rồi cập nhật Edge từ tệp .tar.
• Cài đặt một máy chủ web trên nút có kho lưu trữ cục bộ để các nút khác có thể truy cập vào máy chủ đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng hoặc bạn có thể sử dụng máy chủ web của riêng mình.

Cách cập nhật từ kho lưu trữ 4.53.00 cục bộ:

1. Tạo một kho lưu trữ cục bộ 4.53.00 như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại Cài đặt tiện ích apigee-setup của Edge.
2. Cách cài đặt apigee-service từ tệp .tar:
   1. Trên nút có kho lưu trữ cục bộ, hãy dùng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar duy nhất có tên là /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz:

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. Sao chép tệp .tar vào nút mà bạn muốn cập nhật Edge. Ví dụ: sao chép tệp đó vào thư mục /tmp trên nút mới.
   3. Trên nút mới, hãy giải nén tệp vào thư mục /tmp:

      tar -xzf apigee-4.53.00.tar.gz

      Lệnh này sẽ tạo một thư mục mới có tên repos trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.

   4. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge từ /tmp/repos:

      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Xin lưu ý rằng bạn đưa đường dẫn đến thư mục repos vào lệnh này.

3. Cách cài đặt apigee-service bằng máy chủ web Nginx:
   1. Định cấu hình máy chủ web Nginx như mô tả trong phần "Cài đặt từ kho lưu trữ bằng máy chủ web Nginx" tại Cài đặt tiện ích apigee-setup của Edge.
   2. Trên nút từ xa, hãy tải tệp bootstrap_4.53.00.sh Edge xuống /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

      Trong đó, uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt trước đó cho kho lưu trữ, còn remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.

   3. Trên nút từ xa, hãy cài đặt tiện ích apigee-setup và các phần phụ thuộc của Edge:

      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Trong đó uName:pWord là tên người dùng và mật khẩu của kho lưu trữ.

4. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như ví dụ sau đây minh hoạ:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như ví dụ sau đây minh hoạ:

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như ví dụ sau đây minh hoạ:

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. Chạy tiện ích update trên các nút theo thứ tự được mô tả trong phần Thứ tự cập nhật máy:

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

   Trong trường hợp:

   • component là thành phần Edge cần cập nhật. Bạn thường cập nhật các thành phần sau:
     • cs: Cassandra
     • edge: Tất cả các thành phần Edge, ngoại trừ giao diện người dùng Edge: Máy chủ quản lý, Trình xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: Apigee SSO (nếu bạn đã cài đặt SSO)
     • ue Giao diện người dùng mới của Edge
     • ui: Giao diện người dùng Edge cổ điển
     • zk: Zookeeper
   • configFile là tệp cấu hình mà bạn đã dùng để xác định các thành phần Edge trong quá trình cài đặt 4.50.00 hoặc 4.51.00.

   Bạn có thể chạy update.sh trên tất cả các thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có một hồ sơ cài đặt Edge tất cả trong một (AIO). Ví dụ:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. Khởi động lại các thành phần giao diện người dùng trên tất cả các nút đang chạy thành phần đó (nếu bạn chưa làm):

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. Kiểm thử bản cập nhật bằng cách chạy tiện ích apigee-validate trên Máy chủ quản lý, như mô tả trong phần Kiểm thử quá trình cài đặt.

Nếu sau này bạn quyết định quay lại bản cập nhật, hãy sử dụng quy trình được mô tả trong phần Quay lại phiên bản 4.53.00.

Thứ tự cập nhật máy

Thứ tự cập nhật các máy trong quá trình cài đặt Edge là rất quan trọng:

• Bạn phải cập nhật tất cả các nút Cassandra và ZooKeeper trước khi cập nhật bất kỳ nút nào khác.
• Đối với mọi máy có nhiều thành phần Edge (Máy chủ quản lý, Trình xử lý thông báo, Bộ định tuyến, Máy chủ QPID nhưng không phải Máy chủ Postgres), hãy sử dụng lựa chọn -c edge để cập nhật tất cả các thành phần cùng một lúc.
• Nếu một bước chỉ định rằng bước đó phải được thực hiện trên nhiều máy, hãy thực hiện theo thứ tự máy được chỉ định.
• Không có bước riêng để cập nhật phần Kiếm tiền. Thư viện này được cập nhật khi bạn chỉ định tuỳ chọn -c edge.

Bản nâng cấp độc lập 1 nút

Cách nâng cấp cấu hình độc lập gồm 1 nút lên phiên bản 4.53.00:

1. Cập nhật tất cả các thành phần:

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

2. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Bản nâng cấp độc lập gồm 2 nút

Cập nhật các thành phần sau cho một bản cài đặt độc lập gồm 2 nút:

Hãy xem phần Cấu trúc liên kết cài đặt để biết danh sách các cấu trúc liên kết Edge và số lượng nút.

1. Cập nhật Cassandra và ZooKeeper trên máy 1:

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

2. Cập nhật Postgres trên máy 2:

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

3. Cập nhật LDAP trên máy 1:

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

4. Cập nhật các thành phần Edge trên máy 2 và 1:

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

5. Cập nhật Qpid trên Máy 2:

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

6. Cập nhật giao diện người dùng trên máy 1:

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

7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO trên máy 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Trong đó, sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

9. Khởi động lại thành phần giao diện người dùng Edge trên máy 1:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Nâng cấp 5 nút

Cập nhật các thành phần sau cho một bản cài đặt 5 nút:

Hãy xem phần Cấu trúc liên kết cài đặt để biết danh sách các cấu trúc liên kết Edge và số lượng nút.

1. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:

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

2. Cập nhật Postgres trên máy 4:

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

3. Cập nhật Postgres trên máy 5:

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

4. Cập nhật LDAP trên máy 1:

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

5. Cập nhật các thành phần Edge trên máy 4, 5, 1, 2, 3:

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

6. Cập nhật Qpid trên máy 4:

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

7. Cập nhật Qpid trên máy 5:

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

8. Cập nhật giao diện người dùng Edge:
   • Giao diện người dùng cũ: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy cập nhật thành phần ui trên máy 1, như ví dụ sau đây:

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

   • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy cập nhật thành phần ue trên máy thích hợp (có thể không phải là máy 1):

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

9. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO trên máy 1:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó, sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

11. Khởi động lại thành phần giao diện người dùng:
    • Giao diện người dùng cũ: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như ví dụ sau đây:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Nâng cấp cụm 9 nút

Cập nhật các thành phần sau cho một bản cài đặt cụm gồm 9 nút:

Hãy xem phần Cấu trúc liên kết cài đặt để biết danh sách các cấu trúc liên kết Edge và số lượng nút.

1. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:

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

2. Cập nhật Postgres trên máy 8:

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

3. Cập nhật Postgres trên máy 9:

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

4. Cập nhật LDAP trên máy 1:

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

5. Cập nhật các thành phần Edge trên máy 6, 7, 8, 9, 1, 4 và 5 theo thứ tự đó:

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

6. Cập nhật Qpid trên máy 6 và 7:

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

7. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cổ điển (ui) trên máy 1:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO trên máy 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Trong đó, sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

10. Khởi động lại thành phần giao diện người dùng:
    • Giao diện người dùng cũ: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như ví dụ sau đây:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Nâng cấp cụm 13 nút

Cập nhật các thành phần sau cho một bản cài đặt cụm gồm 13 nút:

Hãy xem phần Cấu trúc liên kết cài đặt để biết danh sách các cấu trúc liên kết Edge và số lượng nút.

1. Cập nhật Cassandra và ZooKeeper trên các máy 1, 2 và 3:

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

2. Cập nhật Postgres trên máy 8:

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

3. Cập nhật Postgres trên máy 9:

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

4. Cập nhật LDAP trên máy 4 và 5:

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

5. Cập nhật các thành phần Edge trên các máy 12, 13, 8, 9, 6, 7, 10 và 11 theo thứ tự đó:

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

6. Cập nhật Qpid trên máy 12 và 13:

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

7. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cổ điển (ui) trên các máy 6 và 7:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (Nếu bạn đã cài đặt apigee-adminapi) Đã cập nhật tiện ích apigee-adminapi trên máy 6 và 7:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO trên máy 6 và 7:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Trong đó, sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

10. Khởi động lại thành phần giao diện người dùng:
    • Giao diện người dùng cũ: Nếu đang dùng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 6 và 7, như ví dụ sau đây:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên các máy 6 và 7:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Nâng cấp cụm 12 nút

Cập nhật các thành phần sau cho một bản cài đặt cụm gồm 12 nút:

Hãy xem phần Cấu trúc liên kết cài đặt để biết danh sách các cấu trúc liên kết Edge và số lượng nút.

1. Cập nhật Cassandra và ZooKeeper:
   1. Trên các máy 1, 2 và 3 trong Trung tâm dữ liệu 1:

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

   2. Trên các máy 7, 8 và 9 trong Trung tâm dữ liệu 2

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

2. Cập nhật Postgres:
   1. Máy 6 trong Trung tâm dữ liệu 1

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

   2. Máy 12 trong Trung tâm dữ liệu 2

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

3. Cập nhật LDAP:
   1. Máy 1 trong Trung tâm dữ liệu 1

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

   2. Máy 7 trong Trung tâm dữ liệu 2

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

4. Cập nhật các thành phần Edge:
   1. Máy 4, 5, 6, 1, 2, 3 trong Trung tâm dữ liệu 1

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

   2. Máy 10, 11, 12, 7, 8, 9 trong Trung tâm dữ liệu 2

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

5. Cập nhật qpidd:
   1. Máy 4, 5 trong Trung tâm dữ liệu 1
      1. Cập nhật qpidd trên máy 4:

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

      2. Cập nhật qpidd trên máy 5:

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

   2. Máy 10, 11 trong Trung tâm dữ liệu 2
      1. Cập nhật qpidd trên máy 10:

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

      2. Cập nhật qpidd trên máy 11:

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

6. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cổ điển (ui):
   1. Máy 1 trong Trung tâm dữ liệu 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. Máy 7 trong Trung tâm dữ liệu 2:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:
   1. Máy 1 trong Trung tâm dữ liệu 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. Máy 7 trong Trung tâm dữ liệu 2:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO:
   1. Máy 1 trong Trung tâm dữ liệu 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. Máy 7 trong Trung tâm dữ liệu 2:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Trong đó, sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

9. Khởi động lại thành phần giao diện người dùng Edge mới (edge-management-ui) hoặc giao diện người dùng Edge cũ (edge-ui) trên máy 1 và 7:

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Đối với cấu hình không chuẩn

Nếu bạn có cấu hình không chuẩn, hãy cập nhật các thành phần Edge theo thứ tự sau:

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge, tức là hồ sơ "-c edge" trên tất cả các nút theo thứ tự: các nút có máy chủ Qpid, Máy chủ Edge Postgres, Máy chủ quản lý, Trình xử lý thông báo và Bộ định tuyến.
6. qpidd
7. Giao diện người dùng Edge (cũ hoặc mới)
8. apigee-adminapi
9. Apigee SSO

Sau khi hoàn tất việc cập nhật, hãy nhớ khởi động lại thành phần giao diện người dùng Edge trên tất cả các máy đang chạy thành phần này.