Cập nhật Apigee Edge 4.52.02 hoặc 4.53.00 lên 4.53.01

Apigee hỗ trợ nâng cấp Edge cho Private Cloud trực tiếp từ phiên bản 4.52.02 hoặc 4.53.00 lên phiên bản 4.53.01. 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

Phiên bản này đã giải quyết một số vấn đề về bảo mật. Mặc dù những điểm cải tiến về bảo mật này là cần thiết, nhưng chúng sẽ mang đến một số thay đổi không tương thích ngược. Điều này có nghĩa là quá trình nâng cấp sẽ cần thêm các bước để đảm bảo không bị gián đoạn trong hoặc sau khi nâng cấp. Để biết thêm thông tin, hãy xem kỹ chủ đề này trong khi nâng cấp lên phiên bản 4.53.01 từ các phiên bản cũ hơn của đám mây riêng.

Đả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 cho Đám mây riêng tư 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.01, 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.01.

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

  Trong Edge cho Đám mây riêng tư 4.53.01, 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.

Những bước đặc biệt cần cân nhắc khi nâng cấp

Để nâng cấp lên Edge cho Đám mây riêng tư 4.53.01, hãy cân nhắc việc chạy các bước cụ thể để nâng cấp một số phần mềm. Các bước cần thiết tuỳ thuộc vào phiên bản hiện tại của bạn. Hãy tham khảo bảng dưới đây để biết các phần mềm yêu cầu các bước bổ sung và làm theo hướng dẫn chi tiết cho từng phần mềm. Sau khi hoàn tất các nhiệm vụ cần thiết, hãy quay lại quy trình nâng cấp chính để tiếp tục quá trình nâng cấp.

Sau khi thực hiện các bước cần thiết dựa trên phiên bản của bạn, hãy quay lại quy trình nâng cấp chính để tiếp tục.

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.

Bạn cần nâng cấp lên OpenLDAP 2.6

Sau đây là quy trình từng bước để nâng cấp dịch vụ LDAP cơ bản của Apigee Edge cho Đám mây riêng tư từ OpenLDAP 2.4 cũ lên OpenLDAP 2.6. Đây là yêu cầu bắt buộc đối với việc cập nhật lên Apigee Edge cho Private Cloud phiên bản 4.53.01 trở lên. Quy trình nâng cấp này áp dụng cho tất cả các cấu trúc liên kết triển khai LDAP của Apigee: một máy chủ, chủ động-thụ động và chủ động-chủ động (nhiều máy chủ chính).

Điều kiện tiên quyết và điểm cần cân nhắc

• Xin lưu ý rằng trong quá trình nâng cấp LDAP, các API quản lý và do đó, giao diện người dùng Apigee sẽ hoàn toàn không hoạt động ở tất cả các khu vực. Tất cả các tác vụ quản trị (chẳng hạn như quản lý người dùng, vai trò, ứng dụng và tổ chức) sẽ không thực hiện được và cần phải tạm dừng. Việc này sẽ không ảnh hưởng đến quá trình xử lý lưu lượng truy cập của proxy API. Hãy nhớ tắt tất cả edge-management-server và edge-ui trước khi tiếp tục nâng cấp LDAP.

• Sao lưu là việc bắt buộc: Bạn phải sao lưu đầy đủ và xác thực dữ liệu LDAP hiện có. Nếu tiếp tục mà không có bản sao lưu hợp lệ, bạn sẽ bị mất dữ liệu vĩnh viễn. Bạn phải bắt đầu sao lưu trong khi dịch vụ LDAP vẫn đang chạy để ghi lại ảnh chụp nhanh nhất quán về dữ liệu LDAP tại một thời điểm. Bạn cần sao lưu để thực hiện quy trình nâng cấp thực tế. Nếu không sao lưu, bạn sẽ không thể thực hiện quy trình nâng cấp cũng như không thể khôi phục vì các bước nâng cấp liên quan đến việc xoá dữ liệu LDAP.

Chuẩn bị và cài đặt (Tất cả các máy chủ LDAP)

Các bước trong phần này (từ Bước 2 đến Bước 5) đều giống nhau đối với mọi cấu trúc liên kết triển khai LDAP. Bạn phải thực hiện các thao tác này trên mọi máy chủ đã cài đặt thành phần apigee-openldap, bất kể vai trò của máy chủ đó.

1. Hãy nhớ tắt tất cả edge-management-server và edge-ui trước khi tiếp tục nâng cấp LDAP.

   apigee-service edge-management-server stop
   apigee-service edge-ui stop

2. Sao lưu dữ liệu LDAP hiện có

   Trước khi thực hiện bất kỳ thay đổi nào, hãy sao lưu toàn bộ dữ liệu LDAP hiện tại từ tất cả các máy chủ LDAP. Thao tác này sẽ tạo một điểm khôi phục an toàn.

   • Thực thi lệnh sao lưu. Thao tác này sẽ tạo một tệp lưu trữ sao lưu có dấu thời gian trong thư mục /opt/apigee/backup/openldap.

     apigee-service apigee-openldap backup

   • Lấy tổng số bản ghi: Ghi lại số lượng bản ghi trong thư mục của bạn để xác thực sau khi nâng cấp (Số lượng bản ghi phải khớp trên tất cả các máy chủ LDAP). Đây là một quy trình kiểm tra sơ bộ.

     # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
     ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
     -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

3. Dừng LDAP và dọn dẹp các thư mục dữ liệu

   Bạn phải thực hiện bước này trên tất cả các máy chủ LDAP. Đây là yêu cầu bắt buộc do có sự thay đổi lớn về phiên bản và những khác biệt về cấu trúc cơ bản. Thư mục sạch sẽ đảm bảo không có xung đột. Khi tất cả các máy chủ LDAP đều dừng hoạt động, API quản lý và giao diện người dùng sẽ bắt đầu gặp sự cố.

   • Dừng dịch vụ LDAP.

     apigee-service apigee-openldap stop

   • Xoá vĩnh viễn dữ liệu LDAP cũ và các thư mục cấu hình.

     rm -rf /opt/apigee/data/apigee-openldap/*

4. Cài đặt và định cấu hình phiên bản LDAP mới

   Trên tất cả các máy chủ LDAP, hãy sử dụng các tập lệnh Apigee tiêu chuẩn để tải xuống và cài đặt phiên bản thành phần mới.

   • Cài đặt thành phần LDAP mới: Tập lệnh cập nhật sẽ đọc tệp cấu hình của bạn và cài đặt gói apigee-openldap mới.

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

   • Xác thực phiên bản LDAP mới: Sau khi quá trình cài đặt hoàn tất, hãy tải lại hồ sơ, xác minh rằng phiên bản LDAP mới đã được cài đặt đúng cách.

     source ~/.bash_profile
     ldapsearch -VV
     Expected output:
     ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

5. Dừng LDAP trên tất cả các máy chủ trước khi khôi phục dữ liệu

   Đây là một bước đồng bộ hoá quan trọng. Trước khi khôi phục bản sao lưu, bạn phải đảm bảo rằng dịch vụ LDAP mới cài đặt đã dừng trên tất cả các máy chủ. Trên mỗi máy chủ LDAP, hãy thực thi các lệnh sau:

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

6. Khôi phục dữ liệu LDAP

   Chiến lược là khôi phục bản sao lưu trên máy chủ đang hoạt động đầu tiên. Sau đó, máy chủ này sẽ đóng vai trò là nguồn tin cậy, sao chép dữ liệu cho các máy chủ ngang hàng trong chế độ thiết lập nhiều máy chủ.

   1. Xác định máy chủ đang hoạt động đầu tiên để khôi phục

      • Đối với chế độ thiết lập một máy chủ: Đây là máy chủ LDAP duy nhất của bạn. Bạn có thể chuyển thẳng đến bước tiếp theo.
      • Đối với chế độ thiết lập chủ động-thụ động và chủ động-chủ động: Chạy lệnh chẩn đoán sau trên mỗi máy chủ LDAP:

        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
        Note:
        -If this command returns output, the server is a passive server.
        -If it returns no output, the server is the active server.

   2. Khôi phục dữ liệu sao lưu

      Trước khi tiếp tục, hãy kiểm tra kỹ để đảm bảo rằng Bước 5 đã hoàn tất thành công trên tất cả các máy chủ LDAP.

      • Trên máy chủ đang hoạt động đầu tiên mà bạn xác định ở trên, hãy chuyển đến thư mục sao lưu.

        cd /opt/apigee/backup/openldap

      • Thực thi lệnh restore. Bạn nên chỉ định chính xác dấu thời gian sao lưu từ Bước 2 để tránh khôi phục một phiên bản không mong muốn hoặc cũ hơn.

        # To restore a specific backup (recommended):
        apigee-service apigee-openldap restore 2025.08.11,23.34.00
        
        # To restore the latest available backup by default:
        apigee-service apigee-openldap restore

      • Sau khi quá trình khôi phục hoàn tất thành công, hãy khởi động dịch vụ LDAP trên máy chủ đang hoạt động đầu tiên.

        apigee-service apigee-openldap start

7. Khởi động các máy chủ LDAP còn lại

   Nếu bạn thiết lập nhiều máy chủ, hãy khởi động dịch vụ trên từng máy chủ LDAP:

   apigee-service apigee-openldap start

8. Xác thực cuối cùng

   Bước cuối cùng là xác minh rằng quá trình nâng cấp đã thành công và dữ liệu nhất quán trên toàn bộ cụm LDAP.

   • Chạy lệnh xác thực trên tất cả các máy chủ LDAP. Số lượng bản ghi phải giống nhau trên tất cả các máy chủ và phải khớp với số lượng bạn đã ghi lại ở Bước 2.

   # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
   ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
   -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

   • Sau khi bạn xác nhận rằng dữ liệu chính xác và nhất quán, quá trình nâng cấp LDAP sẽ hoàn tất. Giờ đây, bạn có thể tiếp tục khởi động edge-management-server và edge-ui cũng như mọi thành phần phụ thuộc khác theo quy trình nâng cấp tiêu chuẩn của tổ chức.

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

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

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. Xác nhận rằng bạn đã hoàn tất từng 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ư phiên bản 4.52.02.

   • Lệnh post_upgrade đã đượ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 đã đượ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 rằng các lệnh post_upgrade và drop_old_tables đã được thực thi trên Cassandra 3.11 trong khi sử dụng Edge cho Đám mây riêng tư 4.52.02, bạn có thể chạy lại các lệnh này một cách an toàn trước khi thử nâng cấp lên 4.53.01.

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.18 | 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 for Private Cloud 4.53.01

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.

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

Bản phát hành Edge cho Đám mây riêng tư này bao gồm bản nâng cấp lên Zookeeper 3.8.4. Trong quá trình nâng cấp đó, tất cả dữ liệu Zookeeper sẽ được di chuyển sang Zookeeper 3.8.4.

Trước khi nâng cấp Zookeeper, hãy đọc hướng dẫn bảo trì Zookeeper. Hầu hết các hệ thống sản xuất Edge đều sử dụng một cụm các nút Zookeeper trải rộng trên nhiều trung tâm dữ liệu. Một số nút trong số này được định cấu hình làm cử tri tham gia bầu cử người lãnh đạo Zookeeper và phần còn lại được định cấu hình làm người quan sát. Hãy xem bài viết Giới thiệu về người lãnh đạo, người theo dõi, người bỏ phiếu và người quan sát để biết thêm thông tin chi tiết. Các nút bỏ phiếu sẽ bầu ra một nút chính, sau đó các nút bỏ phiếu sẽ trở thành nút phụ.

Trong quá trình cập nhật, có thể xảy ra tình trạng chậm trễ hoặc lỗi ghi tạm thời vào Zookeeper khi nút chính bị tắt. Điều này có thể ảnh hưởng đến các thao tác Quản lý ghi vào Zookeeper, chẳng hạn như thao tác triển khai của một proxy và các thay đổi về cơ sở hạ tầng Apigee, chẳng hạn như việc thêm hoặc xoá một trình xử lý thông báo, v.v. Sẽ không có tác động nào đến các API thời gian chạy của Apigee (trừ phi các API thời gian chạy này gọi API quản lý) trong quá trình nâng cấp Zookeeper khi làm theo quy trình bên dưới.

Nhìn chung, quy trình nâng cấp bao gồm việc sao lưu từng nút. Sau đó, nâng cấp tất cả các quan sát viên và người theo dõi, cuối cùng là nâng cấp nút chính.

Tạo bản sao lưu

Sao lưu tất cả các nút của Zookeeper để sử dụng trong trường hợp cần khôi phục. Xin lưu ý rằng thao tác khôi phục sẽ đưa Zookeeper về trạng thái khi bản sao lưu được tạo. Lưu ý: Mọi hoạt động triển khai hoặc thay đổi về cơ sở hạ tầng trong Apigee kể từ khi bản sao lưu được tạo (thông tin được lưu trữ trong Zookeeper) sẽ bị mất trong quá trình khôi phục.

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

Nếu đang sử dụng máy ảo và có khả năng, bạn cũng có thể chụp ảnh nhanh hoặc sao lưu máy ảo để khôi phục hoặc quay lại (nếu cần).

Xác định người lãnh đạo, người theo dõi và người quan sát

Lưu ý: Các lệnh mẫu bên dưới sử dụng tiện ích nc để gửi dữ liệu đến Zookeeper. Bạn cũng có thể sử dụng các tiện ích thay thế để gửi dữ liệu đến Zookeeper.

1. Nếu nc chưa được cài đặt trên nút ZooKeeper, hãy cài đặt nc:

     sudo yum install nc

2. Chạy lệnh nc sau trên nút, trong đó 2181 là cổng ZooKeeper:

     echo stat | nc localhost 2181

   Bạn sẽ thấy kết quả như sau:

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

   Trong dòng Mode của đầu ra cho các nút, bạn sẽ thấy observer, leader hoặc follower (nghĩa là một cử tri không phải là người lãnh đạo) tuỳ thuộc vào cấu hình nút. Lưu ý: Trong một bản cài đặt độc lập của Edge có một nút ZooKeeper duy nhất, Mode được đặt thành độc lập.

3. Lặp lại bước 1 và 2 trên mỗi nút ZooKeeper.

Nâng cấp Zookeeper trên các nút đối tượng tiếp nhận dữ liệu và nút theo dõi

Nâng cấp Zookeeper trên từng nút quan sát và nút theo dõi như sau:

1. Tải xuống và chạy chương trình khởi động của Edge cho Đám mây riêng 4.53.01, như mô tả trong phần Cập nhật lên phiên bản 4.53.01 trên một nút có kết nối Internet bên ngoài. Quá trình này có thể sẽ khác nhau tuỳ thuộc vào việc nút có kết nối Internet bên ngoài hay bạn đang thực hiện quy trình cài đặt ngoại tuyến.
2. Nâng cấp thành phần Zookeeper:

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   Lưu ý: Nếu các nút này đã cài đặt các thành phần khác (chẳng hạn như Cassandra), bạn cũng có thể nâng cấp chúng ngay bây giờ (chẳng hạn như với hồ sơ cs,zk) hoặc bạn có thể nâng cấp các thành phần khác sau. Apigee khuyến nghị bạn chỉ nâng cấp Zookeeper trước và đảm bảo cụm của bạn hoạt động đúng cách trước khi nâng cấp các thành phần khác.
3. Lặp lại các bước trên cho từng nút quan sát và nút theo dõi Zookeeper.

Tắt máy chủ chính

Sau khi tất cả các nút quan sát và nút theo dõi được nâng cấp, hãy tắt nút chính. Trên nút được xác định là nút chính, hãy chạy lệnh bên dưới:

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

Xin lưu ý rằng trong sự kiện này, trước khi một người lãnh đạo mới được bầu, có thể xảy ra tình trạng chậm trễ tạm thời hoặc lỗi ghi trong Zookeeper. Điều này có thể ảnh hưởng đến các thao tác ghi vào Zookeeper, chẳng hạn như thao tác triển khai của các proxy hoặc thay đổi về cơ sở hạ tầng Apigee, chẳng hạn như việc thêm hoặc xoá các trình xử lý thông báo, v.v.

Xác minh rằng người lãnh đạo mới đã được bầu

Bằng cách làm theo các bước trong phần Xác định người dẫn đầu, người theo dõi và người quan sát ở trên, hãy xác minh rằng một người dẫn đầu mới đã được bầu chọn trong số những người theo dõi sau khi người dẫn đầu hiện tại dừng hoạt động. Xin lưu ý rằng người dẫn đầu có thể đã được bầu chọn ở một trung tâm dữ liệu khác so với người dẫn đầu hiện tại.

Nâng cấp biến thể dẫn đầu

Làm theo các bước tương tự như trong phần Nâng cấp Zookeeper trên các nút quan sát và nút theo dõi ở trên.

Sau khi nút chính cũ cũng được nâng cấp, hãy xác minh trạng thái của cụm và đảm bảo có một nút chính.

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.01 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ụ ngoài ý 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.01. 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.01 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ạn cần nâng cấp lên Postgres 17

Bản phát hành Edge này bao gồm bản nâng cấp lên Postgres 17. Trong quá trình nâng cấp đó, tất cả dữ liệu Postgres sẽ được di chuyển sang Postgres 17.

Hầu hết các hệ thống sản xuất Edge đều sử dụng 2 nút Postgres được định cấu hình để sao chép chính-dự phòng. Trong quá trình cập nhật, trong khi các nút Postgres ngừng hoạt động để cập nhật, dữ liệu phân tích vẫn được ghi vào các nút Qpid. Sau khi các nút Postgres được cập nhật và hoạt động trở lại, dữ liệu phân tích sẽ được chuyển đến các nút Postgres.

Cách bạn thực hiện quy trình cập nhật Postgres sẽ tuỳ thuộc vào cách bạn định cấu hình bộ nhớ dữ liệu cho các nút Postgres:

• Nếu sử dụng bộ nhớ dữ liệu cục bộ cho các nút Postgres, bạn phải cài đặt một nút dự phòng Postgres mới trong thời gian nâng cấp. Sau khi quá trình nâng cấp hoàn tất, bạn có thể ngừng hoạt động nút dự phòng Postgres mới.

  Bạn cần có nút dự phòng Postgres bổ sung nếu phải khôi phục bản cập nhật vì bất kỳ lý do nào. Nếu bạn phải khôi phục bản cập nhật, thì nút dự phòng Postgres mới sẽ trở thành nút Postgres chính sau khi khôi phục. Do đó, khi bạn cài đặt nút dự phòng Postgres mới, nút này phải nằm trên một nút đáp ứng mọi yêu cầu về phần cứng của máy chủ Postgres, như được xác định trong phần Yêu cầu khi cài đặt Edge.

  Trong cấu hình 1 nút và 2 nút của Edge, các cấu trúc liên kết được dùng để tạo mẫu và kiểm thử, bạn chỉ có một nút Postgres duy nhất. Bạn có thể cập nhật trực tiếp các nút Postgres này mà không cần tạo nút Postgres mới.

• Nếu sử dụng bộ nhớ mạng cho các nút Postgres, theo đề xuất của Apigee, bạn không cần cài đặt một nút Postgres mới. Trong các quy trình bên dưới, bạn có thể bỏ qua các bước chỉ định cài đặt và sau đó ngừng hoạt động một nút dự phòng Postgres mới.

  Trước khi bắt đầu quá trình cập nhật, hãy chụp ảnh nhanh mạng của kho dữ liệu mà Postgres sử dụng. Sau đó, nếu có lỗi xảy ra trong quá trình cập nhật và bạn buộc phải thực hiện thao tác khôi phục, thì bạn có thể khôi phục nút Postgres từ ảnh chụp nhanh đó.

Cài đặt một nút dự phòng Postgres mới

Quy trình này sẽ tạo một máy chủ dự phòng Postgres trên một nút mới. Đảm bảo bạn cài đặt một máy chủ dự phòng Postgres mới cho phiên bản Edge hiện có (4.52.02 hoặc 4.53.00), chứ không phải cho phiên bản 4.53.01.

Để thực hiện quy trình cài đặt, hãy dùng chính tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại.

Cách tạo một nút dự phòng Postgres mới:

1. Trên máy chủ chính Postgres hiện tại, hãy chỉnh sửa tệp /opt/apigee/customer/application/postgresql.properties để đặt mã thông báo sau. Nếu tệp đó không tồn tại, hãy tạo tệp:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   Trong đó existing_standby_ip là địa chỉ IP của máy chủ dự phòng Postgres hiện tại và new_standby_ip là địa chỉ IP của nút dự phòng mới.

2. Khởi động lại apigee-postgresql trên máy chủ chính Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. Xác minh rằng nút dự phòng mới đã được thêm bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên máy chủ chính. Bạn sẽ thấy các dòng sau trong tệp đó:

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. Cài đặt máy chủ dự phòng Postgres mới:
   1. Chỉnh sửa tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định những nội dung sau:

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.

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

      1. Tải tệp bootstrap_4.52.02.sh của Edge xuống /tmp/bootstrap_4.52.02.sh :

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

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

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

      Nếu bạn đang dùng Edge 4.53.00:

      1. Tải tệp Edge bootstrap_4.53.00.sh 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:

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

   4. Dùng apigee-service để cài đặt tiện ích apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. Cài đặt Postgres:

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile

   6. Trên nút dự phòng mới, hãy chạy lệnh sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác minh rằng đó là chế độ chờ.

Thực hiện nâng cấp tại chỗ Postgres

Bước sơ bộ

Trước khi thực hiện quy trình nâng cấp tại chỗ lên Postgres, hãy thực hiện các bước sau trên cả máy chủ chính và máy chủ dự phòng để cập nhật thuộc tính max_locks_per_transaction trên apigee-postgresql:

1. Nếu chưa có, hãy tạo tệp /opt/apigee/customer/application/postgresql.properties.
2. Thay đổi quyền sở hữu tệp này thành apigee:

   sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. Thêm thuộc tính sau vào tệp:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. Định cấu hình apigee-postgresql:

   apigee-service apigee-postgresql configure

5. Khởi động lại apigee-postgresql:

   apigee-service apigee-postgresql restart

Thực hiện quy trình nâng cấp tại chỗ

Để nâng cấp tại chỗ lên Postgres 17, hãy làm theo các bước sau:

1. Nâng cấp postgres trên máy chủ lưu trữ chính

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

2. Chạy lệnh thiết lập trên máy chủ lưu trữ chính:

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. Chạy lệnh định cấu hình trên máy chủ lưu trữ chính:

   apigee-service apigee-postgresql configure

4. Khởi động lại máy chủ lưu trữ chính:

   apigee-service apigee-postgresql restart

5. Định cấu hình thiết bị này làm thiết bị chính:

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. Đảm bảo người tổ chức chính đã bắt đầu:

   apigee-service apigee-postgresql wait_for_ready

7. Dừng chế độ chờ:

   apigee-service apigee-postgresql stop

8. Nâng cấp chế độ chờ.

   Lưu ý: Nếu bước này gặp lỗi/thất bại, bạn có thể bỏ qua. update.sh sẽ cố gắng khởi động máy chủ dự phòng bằng cấu hình không chính xác. Nếu bản cài đặt Postgres được nâng cấp lên phiên bản 17, thì bạn có thể bỏ qua lỗi này.

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

9. Đảm bảo chế độ chờ đã dừng:

   apigee-service apigee-postgresql stop

10. Xoá cấu hình dự phòng cũ:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. Thiết lập quy trình sao chép trên máy chủ dự phòng:

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

12. Xoá dòng conf/postgresql.conf+max_locks_per_transaction=30000 khỏi tệp /opt/apigee/customer/application/postgresql.properties trên cả máy chủ chính và máy chủ dự phòng. Dòng này đã được thêm vào bước sơ bộ.

Sau khi hoàn tất quy trình này, chế độ chờ sẽ bắt đầu thành công.

Ngừng hoạt động một nút Postgres

Sau khi quá trình cập nhật hoàn tất, hãy ngừng hoạt động nút dự phòng mới:

1. Đảm bảo Postgres đang chạy:

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

   Nếu Postgres chưa chạy, hãy khởi động:

   /opt/apigee/apigee-service/bin/apigee-all start

2. Lấy UUID của nút dự phòng mới bằng cách chạy lệnh curl sau trên nút dự phòng mới:

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   Bạn sẽ thấy UUID của nút ở cuối đầu ra, dưới dạng:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. Dừng nút dự phòng mới bằng cách chạy lệnh sau trên nút dự phòng mới:

   /opt/apigee/apigee-service/bin/apigee-all stop

4. Trên nút chính Postgres, hãy chỉnh sửa /opt/apigee/customer/application/postgresql.properties để xoá nút dự phòng mới khỏi conf_pg_hba_replication.connection:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. Khởi động lại apigee-postgresql trên máy chủ Postgres chính:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. Xác minh rằng nút dự phòng mới đã bị xoá bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên máy chủ chính. Bạn chỉ nên thấy dòng sau trong tệp đó:

   host replication apigee existing_standby_ip/32 trust

7. Xoá UUID của nút dự phòng khỏi ZooKeeper bằng cách thực hiện lệnh gọi API quản lý Edge sau đây trên nút Máy chủ quản lý:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Các bước sau khi nâng cấp cho Postgres

Sau khi nâng cấp Postgres lên phiên bản chính, số liệu thống kê nội bộ của Postgres sẽ bị xoá. Những số liệu thống kê này hỗ trợ trình lập kế hoạch truy vấn Postgres trong việc sử dụng các chỉ mục và đường dẫn tối ưu nhất để thực thi các truy vấn.

Postgres có thể dần dần tạo lại số liệu thống kê theo thời gian khi các truy vấn được thực thi và khi trình nền autovacuum chạy. Tuy nhiên, cho đến khi số liệu thống kê được tạo lại, các truy vấn của bạn có thể diễn ra chậm.

Để giải quyết vấn đề này, hãy thực thi ANALYZE trên tất cả các bảng trong cơ sở dữ liệu trên nút Postgres chính. Ngoài ra, bạn có thể thực thi ANALYZE cho một vài bảng cùng một lúc.

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.01, 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 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.01 để 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 giống với tệp mà bạn đã dùng để cài đặt Edge cho Đám mây riêng tư 4.52.02 hoặc 4.53.00.

Cập nhật lên 4.53.01 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 hoặc 4.53.00:

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

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

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

      sudo bash /tmp/bootstrap_4.53.01.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 hoặc 4.53.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 ./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 khôi phục bản cập nhật, hãy sử dụng quy trình được mô tả trong phần Khôi phục phiên bản 4.53.01.

Cập nhật lên phiên bản 4.53.01 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.01 cục bộ:

1. Tạo một kho lưu trữ cục bộ 4.53.01 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.01.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.01.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.01.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.01.sh Edge xuống /tmp/bootstrap_4.53.01.sh:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

      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.01.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.52.02 hoặc 4.53.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 khôi phục bản cập nhật, hãy sử dụng quy trình được mô tả trong phần Khôi phục phiên bản 4.53.01.

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 LDAP trước khi cập nhật bất kỳ thành phần nào khác. Bạn cần làm theo các bước đặc biệt để nâng cấp LDAP.
• Bạn phải cập nhật tất cả các nút Cassandra và ZooKeeper. Nếu bạn đang nâng cấp từ phiên bản 4.52.02, hãy làm theo các bước đặc biệt để nâng cấp cassandra. Bạn sẽ cần làm theo các bước đặc biệt để nâng cấp Zookeeper cho phiên bản 4.52.02 hoặc 4.53.00.
• Bạn phải nâng cấp tất cả Máy chủ quản lý, Bộ định tuyến và Bộ xử lý thông báo bằng cách sử dụng lựa chọn -c edge để cập nhật các thành phần này.
• Bạn phải nâng cấp tất cả các nút Postgres theo các bước đặc biệt để nâng cấp Postgres.
• Bạn phải cập nhật các thành phần edge-qpid-server và edge-postgres-server trên tất cả các trung tâm dữ liệu.
• Bạn phải nâng cấp tất cả các nút Qpid.
• Bạn phải nâng cấp các nút giao diện người dùng Edge, cũng như nâng cấp các nút Giao diện người dùng Edge mới và SSO(nếu có).
• Không có bước riêng để cập nhật phần Kiếm tiền. Nội dung này sẽ được cập nhật khi bạn chỉ định lựa 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 1 nút lên 4.53.01:

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 LDAP trên máy 1:

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

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

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

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

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

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

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

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

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

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

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

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

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 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 LDAP trên máy 1:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

10. (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

11. (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.

12. 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 LDAP trên máy 1:

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

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

3. Cập nhật các thành phần Edge trên máy 1, 4 và 5 (Máy chủ quản lý, trình xử lý thông báo, bộ định tuyến) theo thứ tự đó:

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

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

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

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

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

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

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

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

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

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

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 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 LDAP trên máy 4 và 5:

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

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

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

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

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

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

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

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

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

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

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

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

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

9. (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

10. (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.

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 đ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 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

2. Cập nhật Cassandra và ZooKeeper:
   1. 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

3. Cập nhật các thành phần Edge:
   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 edge -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 edge -f configFile

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

5. Cập nhật các thành phần Edge:
   1. Máy 4, 5, 6 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 trong Trung tâm dữ liệu 2

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

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

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

8. (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

9. (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.

10. 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. LDAP
2. Cassandra
3. Nhân viên sở thú
4. Máy chủ quản lý
5. Trình xử lý thông báo
6. Bộ định tuyến
7. Postgres
8. 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.
9. qpidd
10. Giao diện người dùng Edge (cũ hoặc mới)
11. apigee-adminapi
12. 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.