Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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

Apigee hỗ trợ nâng cấp Edge cho đám mây riêng tư trực tiếp từ phiên bản 4.53.00 hoặc 4.53.01 lên phiên bản 4.54.00. Trang này mô tả cách thực hiện các bản nâng cấp đó.

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

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

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

Sau khi bạn cài đặt các RPM của Edge, mọi người đều có thể định cấu hình các RPM này.

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ả thành phần của Edge. Edge không hỗ trợ chế độ thiết lập chứa các thành phần của nhiều phiên bản.

Tài liệu đọc trước

Hãy xem các chủ đề sau để biết thông tin quan trọng về những thay đổi được giới thiệu trong Edge cho Đám mây riêng tư 4.54.00:

Thay đổi trong phiên bản 4.54.00: Xem xét các thay đổi trong TLS và Java Callout cần chuẩn bị trước khi nâng cấp. Để biết thêm thông tin, hãy xem phần Thay đổi trong phiên bản 4.54.00.
Kiến trúc thời gian chạy Dual-Java (Java 17 và Java 21): Kể từ phiên bản 4.54.00, Edge cho đám mây riêng tư sẽ ngừng hỗ trợ Java 8 và chạy các thành phần trên Java 17 hoặc Java 21. Để biết thêm thông tin, hãy xem phần Thay đổi trong phiên bản 4.54.00.
Không tự động cài đặt Java trong quá trình khởi động: Edge cho Private Cloud 4.54.00 có khả năng phát hiện các bản cài đặt Java và xác thực rằng bạn đã cài đặt cả Java 17 và 21.
Giao diện người dùng mới của Edge trong phiên bản 4.54.00: Tìm hiểu về quá trình chuyển đổi sang Giao diện người dùng mới của Edge làm giao diện quản lý mặc định và việc xoá Giao diện người dùng cũ (edge-ui). Để biết thêm thông tin, hãy xem phần Giao diện người dùng mới của Edge.
Apigee SSO trong phiên bản 4.54.00: Tìm hiểu về cấu trúc SSO mới và các thay đổi về cấu hình để xác thực. Để biết thêm thông tin, hãy xem phần SSO của Apigee.
Nginx 1.30 trong phiên bản 4.54.00: Xem xét việc tự động nâng cấp Nginx 1.30.x trên Bộ định tuyến Edge, các tác động tiềm ẩn đối với thời gian chạy và các bước giảm thiểu. Để biết thêm thông tin, hãy xem bài viết Thay đổi về Nginx 1.30.

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

Đả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:

Xem ghi chú phát hành và các tính năng mới

Đảm bảo bạn xem xét kỹ lưỡng và hiểu rõ tất cả các tính năng mới, thay đổi về hành vi và việc ngừng sử dụng được nêu chi tiết trong ghi chú phát hành Edge cho Đám mây riêng tư phiên bản 4.54.00 trước khi bắt đầu quy trình nâng cấp.
Tự động phát hiện và cùng tồn tại các tệp nhị phân Java trong quá trình nâng cấp: Cài đặt Java bằng cách sử dụng trình quản lý gói tiêu chuẩn (chẳng hạn như yum) hoặc các vị trí tiêu chuẩn (chẳng hạn như /usr/lib/jvm hoặc update-alternatives). Bạn không cần phải định cấu hình cả hai phiên bản trên PATH hệ thống cùng một lúc. Đừng gỡ cài đặt Java 8 trước khi nâng cấp. Hãy cài đặt Java 8 cùng với Java 17 và Java 21 để các dịch vụ Edge cho đám mây riêng tư 4.53.xx hiện có tiếp tục chạy mà không bị gián đoạn cho đến khi được cập nhật.
Sao lưu tất cả các nút

Trước khi cập nhật, bạn nên sao lưu toàn bộ tất cả các nút vì lý do an toàn. Sử dụng quy trình cho phiên bản Edge hiện tại của bạn để thực hiện sao lưu. Đ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 phần Sao lưu và khôi phục.
Sao lưu tệp cấu hình tự động

Đảm bảo rằng các bản sao lưu của tệp cấu hình im lặng cho Edge cho đám mây riêng tư 4.53.00 hoặc 4.53.01 được giữ lại để hỗ trợ khôi phục nếu cần.
Đả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 Edge for Private Cloud cũ hơn lên phiên bản 4.53.00 (hoặc) 4.53.01 và hiện đang có kế hoạch nâng cấp lên phiên bản 4.54.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 phiên bản 4.53.00 (hoặc) 4.53.01 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 chắn 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ến hành nâng cấp lên phiên bản 4.54.00.
Dừng apigee-monit: Nếu apigee-monit đang chạy trên nút, hãy dừng nút này bằng /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop trước khi nâng cấp. Thao tác này ngăn apigee-monit tự động khởi động lại các thành phần trong khi chúng đang được nâng cấp. Bật lại bằng apigee-service apigee-monit start sau khi quá trình nâng cấp hoàn tất.

Tự động truyền bá 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 Bộ định tuyến và Bộ xử lý thông báo

Nâng cấp từng Bộ định tuyến và nút Bộ xử lý thông báo trên các trung tâm dữ liệu:

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

Nâng cấp máy chủ quản lý

Nâng cấp từng nút Máy chủ quản lý trên các trung tâm dữ liệu:

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

Nâng cấp lên OpenLDAP 2.6.10

Edge cho Đám mây riêng tư 4.54.00 ra mắt OpenLDAP 2.6.10. Bản nâng cấp này áp dụng cho tất cả cấu trúc liên kết triển khai Apigee OpenLDAP: máy chủ đơn, chủ động-bị động và chủ động-chủ động (nhiều máy chủ chính).

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

Các bước nâng cấp LDAP từ 4.53.00 lên 4.54.00

Đ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 di chuyển từ OpenLDAP 2.4 sang 2.6.10 (khi nâng cấp từ 4.53.00), các API quản lý và do đó, giao diện người dùng Apigee sẽ 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à phải tạm dừng. Không ảnh hưởng đến quá trình xử lý lưu lượng truy cập của proxy API. Tắt tất cả các phiên bản edge-management-server và edge-ui trước khi tiến hành di chuyển LDAP.
Sao lưu là việc bắt buộc (khi nâng cấp từ phiên bản 4.53.00): Khi nâng cấp từ Edge cho Đám mây riêng tư phiên bản 4.53.00 (OpenLDAP 2.4.46), 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ẽ mất dữ liệu vĩnh viễn. Bắt đầu sao lưu trong khi dịch vụ LDAP vẫn đang chạy để chụp nhanh dữ liệu LDAP nhất quán tại một thời điểm. Nếu không có bản sao lưu, bạn không thể thực hiện quy trình di chuyển từ phiên bản 2.4 sang 2.6.10 hoặc quay lại phiên bản cũ, vì các bước di chuyển 4.53.00 sẽ xoá các thư mục dữ liệu LDAP cũ.

Tắt Máy chủ quản lý và giao diện người dùng: Tắt tất cả các phiên bản edge-management-server và edge-ui trước khi tiến hành di chuyển LDAP từ phiên bản 4.53.00.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
Sao lưu dữ liệu LDAP hiện có: Trước khi thực hiện bất kỳ thay đổi nào khi nâng cấp từ phiên bản 4.53.00 (OpenLDAP 2.4.46), 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. (Khi nâng cấp từ phiên bản 4.53.01 lên 4.54.00, bạn không cần thực hiện trình tự sao lưu, dừng và dọn dẹp này.)
- Thực thi lệnh sao lưu. Thao tác này sẽ tạo một bản 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.)
```
# 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
```
Dừng LDAP và dọn dẹp các thư mục dữ liệu: Chỉ thực hiện bước này trên tất cả các máy chủ LDAP nếu bạn đang nâng cấp từ phiên bản 4.53.00 (OpenLDAP 2.4.46). Đừng dừng LDAP hoặc xoá /opt/apigee/data/apigee-openldap/* nếu bạn đang nâng cấp từ phiên bản 4.53.01 (OpenLDAP 2.6.7). Đối với các bản nâng cấp 4.53.00, bước này là bắt buộc do thay đổi phiên bản lớn và sự khác biệt về cấu trúc cơ sở dữ liệu cơ bản. Khi tất cả máy chủ LDAP đều ngừ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 các thư mục cấu hình và dữ liệu LDAP cũ.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
Cài đặt và định cấu hình phiên bản LDAP mới Trên tất cả máy chủ LDAP, hãy sử dụng 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 và cài đặt gói apigee-openldap mới.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
- Xác thực phiên bản LDAP mới: Sau khi cài đặt xong, hãy tải lại hồ sơ và xác minh rằng phiên bản LDAP mới (2.6.10) đã được cài đặt:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
  Kết quả của lệnh được chỉ định ở trên phải xác minh LDAP phiên bản 2.6.10 như minh hoạ dưới đây:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```
Dừng LDAP trên tất cả máy chủ trước khi khôi phục dữ liệu: Chỉ thực hiện Bước 5, 6 và 7 nếu bạn đang nâng cấp từ phiên bản 4.53.00 (OpenLDAP 2.4.46) (nếu bạn đã nâng cấp tại chỗ từ phiên bản 4.53.01 ở Bước 4, thì dữ liệu LDAP hiện có của bạn sẽ được giữ nguyên và quá trình nâng cấp đã hoàn tất). Trước khi khôi phục bản sao lưu từ phiên bản 4.53.00, hãy đả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/*
```
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 dữ liệu đáng tin cậy duy nhất, sao chép dữ liệu sang 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
```
    Lưu ý:
    - Nếu lệnh trên trả về kết quả, thì máy chủ đó là máy chủ thụ động.
    - Nếu không trả về đầu ra nào, thì máy chủ đó là máy chủ đang hoạt động.
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ạn đã hoàn tất thành công Bước 5 trên tất 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 khôi phục. Chỉ định chính xác dấu thời gian sao lưu từ Bước 2 để tránh khôi phục phiên bản không mong muốn hoặc phiên bản 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
```
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
```
Lưu ý: Bạn không cần khôi phục dữ liệu theo cách thủ công trên các máy chủ ngang hàng này. Khi khởi động, các máy chủ này sẽ kết nối với máy chủ đầu tiên (hiện chứa dữ liệu đã khôi phục) và tự động đồng bộ hoá toàn bộ thư mục thông qua quá trình sao chép.
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ả 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 là 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ể bắt đầu edge-management-server, edge-ui và 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.

Các bước nâng cấp LDAP từ 4.53.01 lên 4.54.00

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 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 và cài đặt gói apigee-openldap mới.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
Xác thực phiên bản LDAP mới: Sau khi cài đặt xong, hãy tải lại hồ sơ và xác minh rằng phiên bản LDAP mới (2.6.10) đã được cài đặt:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
Kết quả của lệnh được chỉ định ở trên phải xác minh LDAP phiên bản 2.6.10 như dưới đây:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```

Nâng cấp lên giao diện người dùng Edge mới và SSO Apigee (nếu đã cài đặt)

Trong Apigee Edge cho Private Cloud 4.54.00, Giao diện người dùng cũ (edge-ui) sẽ bị xoá và thay thế bằng Giao diện người dùng Edge mới (edge-management-ui). Tuỳ thuộc vào việc bạn có cài đặt và sử dụng tính năng Đăng nhập một lần (SSO) của Apigee trong quá trình thiết lập hay không, hãy làm theo một trong hai lựa chọn dưới đây:

Cách 1: Nâng cấp giao diện người dùng (không có SSO của Apigee)

Phần này chỉ áp dụng nếu Apigee SSO (apigee-sso) chưa được định cấu hình / cài đặt trong bản cài đặt Edge cho Đám mây riêng tư phiên bản 4.53.00 hoặc 4.53.01 hiện có của bạn

Trong quá trình nâng cấp Edge for Private Cloud phiên bản 4.54.00, Giao diện người dùng cổ điển (edge-ui) sẽ bị xoá. Việc thực thi lệnh nâng cấp sau đây sẽ chuyển nút giao diện người dùng từ Giao diện người dùng cổ điển (edge-ui) sang Giao diện người dùng Edge mới(edge-management-ui).

Bước 1: Sao lưu các tệp cấu hình

Trước khi bắt đầu, hãy sao lưu tệp cấu hình tự động hiện có (configFile) và thư mục /opt/apigee/customer/application/ trên tất cả các nút giao diện người dùng.

Bước 2: Cập nhật tệp cấu hình im lặng cho Xác thực cơ bản

Chỉnh sửa tệp cấu hình im lặng (ví dụ: /opt/silent.conf) và thêm các thuộc tính Giao diện người dùng Edge mới sau đây cho Xác thực cơ bản:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

Bước 3: Nâng cấp thành phần giao diện người dùng

Chạy tập lệnh update.sh bằng thành phần -c ue để nâng cấp từ Giao diện người dùng cổ điển (edge-ui) lên Giao diện người dùng Edge mới (edge-management-ui):

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

Bước 4: Xác minh việc nâng cấp giao diện người dùng Edge mới

Sau khi hoàn tất thành công quy trình nâng cấp trên tất cả(các) nút giao diện người dùng, vui lòng xác minh rằng Giao diện người dùng Edge mới phiên bản 4.54.00 đã hoạt động đầy đủ và có thể truy cập được:

Kiểm tra để đảm bảo dịch vụ edge-management-ui đang chạy:
```
apigee-service edge-management-ui status
```
Mở trình duyệt rồi chuyển đến:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
Sau khi xác minh, hãy bỏ qua Cách 2: Nâng cấp giao diện người dùng (bằng SSO Apigee) và chuyển thẳng đến phần Nâng cấp bắt buộc lên Qpid.

Cách 2: Nâng cấp giao diện người dùng (bằng SSO của Apigee)

Sử dụng phần này nếu bạn đã định cấu hình / cài đặt Apigee SSO (apigee-sso) trong môi trường Edge cho Private Cloud 4.53.00 hoặc 4.53.01.

Trong Apigee Edge for Private Cloud 4.54.00:

Dịch vụ SSO Apigee cơ bản chuyển đổi từ thành phần apigee-sso cũ sang SSO Apigee được quản lý trong apigee-openldap. Đây là bản nâng cấp bắt buộc khi nâng cấp lên Apigee Edge cho Private Cloud phiên bản 4.54.00 nếu bạn bật tính năng SSO trong Edge cho Private Cloud phiên bản 4.53.00 hoặc 4.53.01.
Cả Giao diện người dùng cổ điển 4.53.x (edge-ui) có SSO và Giao diện người dùng Edge mới 4.53.x (edge-management-ui) có SSO đều nâng cấp lên Giao diện người dùng Edge mới 4.54.00 (edge-management-ui) có SSO Apigee.

Hãy đọc các bài viết sau để tìm hiểu về thiết kế mới của Apigee SSO và tác động của thiết kế này đối với các tiện ích và quy trình tự động hoá bằng API Quản lý:
Giới thiệu về cấu trúc SSO mới của Apigee
Nhiệm vụ tự động sử dụng SSO

Hãy làm theo các bước hợp nhất từ đầu đến cuối dưới đây để nâng cấp cả giao diện người dùng và SSO của Apigee một cách rõ ràng mà không cần lặp lại các bước định cấu hình:

Bước 1: Sao lưu các tệp cấu hình

Sao lưu configFile im lặng hiện có và thư mục /opt/apigee/customer/application/ trên tất cả các nút giao diện người dùng và SSO trước khi tiếp tục.

Bước 2: Xoá các biến UI/SSO không dùng nữa và cập nhật tệp cấu hình im lặng (`configFile`)

Trước khi nâng cấp Giao diện người dùng New Edge và định cấu hình mô-đun Apigee SSO, hãy cập nhật tệp cấu hình im lặng (configFile) trong một bước dựa trên chế độ thiết lập giao diện người dùng 4.53.x hiện tại:

Xoá hoặc đánh dấu là nội dung nhận xét đối với các biến SSO và giao diện người dùng 4.53.x không dùng nữa khỏi configFile:

Nếu nâng cấp từ Giao diện người dùng cũ (edge-ui) bằng apigee-sso: Hãy xoá hoặc đánh dấu là nội dung nhận xét đối với các thuộc tính liên quan đến Giao diện người dùng cũ và SSO:
```
EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
```

Nếu nâng cấp từ Giao diện người dùng Edge mới (edge-management-ui) bằng apigee-sso: Hãy xoá hoặc đánh dấu là nội dung nhận xét đối với các thuộc tính liên quan đến Giao diện người dùng cũ, Shoehorn và SSO phiên bản 4.53.x không còn được dùng nữa:

EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
EDGEUI_ENABLE_UNIFIED_UI=n
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000
CLASSIC_UI_SCHEME=http
CLASSIC_UI_PORT=9000
MANAGEMENT_UI_PUBLIC_URIS=http://Public_IP:3001
MANAGEMENT_UI_SSO_REGISTERD_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
ROUTES_CLASSICUI=""
ROUTES_SHOEHORN=""

Sử dụng lệnh sau trên nút apigee-openldap để tạo người dùng máy cho Giao diện người dùng Edge mới và nhớ sử dụng chính xác thông tin đăng nhập khi xác định thuộc tính trong tệp cấu hình im lặng (configFile) ở bước tiếp theo. Để biết thêm thông tin, hãy xem bài viết Tạo người dùng máy cho giao diện người dùng.
```
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
```

Thêm hoặc cập nhật các thuộc tính bắt buộc của Apigee SSO 4.54.00 và Giao diện người dùng Edge mới trong configFile:

# ==========================================
# SSO Enablement
# ==========================================
ENABLE_SSO=y

# ==========================================
# SSO Hostname/IP and Port config for Apigee SSO
# ==========================================
SSO_PUBLIC_URL_SCHEME=http
SSO_PUBLIC_URL_HOSTNAME=YOUR_SSO_NODE_IP_OR_HOSTNAME #Replace YOUR_SSO_NODE_IP_OR_HOSTNAME with the IP address or hostname of the SSO node.
SSO_PUBLIC_URL_PORT=9099

# ==========================================
# Static Client UI credentials
# ==========================================
MANAGEMENT_UI_SSO_CLIENT_ID=YOUR_SSO_CLIENT_ID #Example : MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui
MANAGEMENT_UI_SSO_CLIENT_SECRET=YOUR_SSO_CLIENT_SECRET #Example : MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123

# ==========================================
# Management UI & SSO redirect URLs
# ==========================================
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_PORT=3001

# ==========================================
# Management Server parameters (Required for SSO registration)
# ==========================================
MSIP=MS_IP_OR_HOSTNAME #Replace MS_IP_OR_HOSTNAME with the IP address or hostname of the Management Server node.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password

# ==========================================
# Machine user for UI
# ==========================================
UI_MACHINE_USER=ui-machine-user@apigee.com
UI_MACHINE_PWD=Secret123

# ==========================================
# Postgres connection parameters
# ==========================================
# Postgres username and password as set when you installed Edge.
PG_HOST=PG_IP_OR_HOSTNAME
PG_USER=apigee
PG_PWD=YOUR_PG_PASSWORD

# ==========================================
# Other UI Parameters
# ==========================================
AUTH_MODE=sso

# Y to use Internal/Local LDAP for authentication, N to use external IDP
SSO_LOCAL_LDAP=y

MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

Bước 3: Nâng cấp thành phần giao diện người dùng Edge mới

Lưu ý:

Về Giao diện người dùng Edge mới có cấu trúc liên kết nhiều nút (trước phiên bản Edge cho đám mây riêng tư 4.53.01, bạn bắt buộc phải duy trì các nút riêng biệt cho Giao diện người dùng cũ và Giao diện người dùng Edge mới): Ví dụ: Trong một chế độ thiết lập 4.53.01 nhiều nút, trong đó Nút 1 vận hành edge-ui (được định cấu hình thông qua ui.properties) và Nút 2 vận hành edge-management-ui cùng với Shoehorn UI edge-ui (được định cấu hình thông qua management-ui.properties):

Sao chép cấu hình tuỳ chỉnh (CWC) : Chuyển tệp /opt/apigee/customer/application/management-ui.properties từ Nút 2 sang Nút 1 theo cùng một đường dẫn. Đảm bảo xoá mọi chế độ ghi đè apigee-sso cũ đối với CWC và đảm bảo quyền sở hữu tệp cho apigee:apigee.

Dừng và gỡ cài đặt cả hai thành phần edge-management-ui (Giao diện người dùng Edge mới) và edge-ui (Giao diện người dùng Shoehorn), nếu Giao diện người dùng Edge mới đang được sử dụng :

#Remove 4.53.xx New Edge UI from installation node 
apigee-service edge-management-ui stop
apigee-service edge-management-ui uninstall

#Remove Shoehorn UI from the node with 4.53.xx New Edge UI
apigee-service edge-ui stop
apigee-service edge-ui uninstall

Chạy tập lệnh update.sh trên (các) nút Giao diện người dùng cũ(edge-ui) để cài đặt và nâng cấp lên thành phần Giao diện người dùng Edge mới (edge-management-ui):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```

Bước 4: Dừng `apigee-sso`

Dừng dịch vụ apigee-sso cũ trên tất cả các nút đã cài đặt dịch vụ này:

apigee-service apigee-sso stop

Bước 5: Tạo cơ sở dữ liệu `apigee_dex` cho Apigee SSO trong nút Postgres

Trên nút chính Postgres, hãy đăng nhập vào Postgresql bằng lệnh sau:
```
psql -h $(hostname -i) -U apigee
```
Chạy lệnh sau tại dấu nhắc psql để tạo cơ sở dữ liệu SSO của Apigee:
```
create database apigee_dex;
```

Bước 6: Thiết lập dịch vụ đăng nhập một lần (SSO) của Apigee trên các nút OpenLDAP

Thực thi lệnh sau trên nút apigee-openldap nơi bạn sẽ cài đặt SSO của Apigee:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

Bước 7: Định cấu hình giao diện người dùng quản lý cho SSO của Apigee và khởi động lại giao diện người dùng

Thực thi các lệnh sau trên mọi nút đã cài đặt Edge cho đám mây riêng tư 4.54.00 edge-management-ui:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

Bước 8: Xác minh việc nâng cấp Giao diện người dùng Edge mới và SSO Apigee

Sau khi hoàn tất các bước ở trên, hãy xác minh rằng 4.54.00 Giao diện người dùng Edge mới và Apigee SSO đang chạy và có thể truy cập được:

Kiểm tra để đảm bảo dịch vụ edge-management-ui đang chạy:
```
apigee-service edge-management-ui status
```
Mở trình duyệt rồi chuyển đến:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
Đăng nhập bằng thông tin đăng nhập SSO mà bạn đã định cấu hình.

Bước 9: Gỡ cài đặt `apigee-sso` cũ

Trên tất cả các nút đã cài đặt apigee-sso cũ, hãy gỡ cài đặt thành phần apigee-sso:

apigee-service apigee-sso uninstall

Nâng cấp lên Qpid 10.0.1

Phương thức này đảm bảo không có thời gian ngừng hoạt động cho môi trường thời gian chạy Edge và giảm thiểu tổn thất về dữ liệu thời gian chạy (nếu có) được thu thập cho hoạt động phân tích.

Cách nâng cấp tại chỗ lên Qpid mà không bị gián đoạn:

Chọn một nút Qpid để bắt đầu.
Dừng Qpid broker trên nút:
```
apigee-service apigee-qpidd stop
```
Chặn lưu lượng truy cập đến trên cổng 5672 của môi giới từ tất cả các trình xử lý thông báo bằng cách áp dụng tường lửa. Bạn có thể áp dụng tường lửa này ở cấp phiên bản nút Qpid hoặc một số thành phần mạng/tường lửa bên ngoài khác.

Bạn nên thực hiện bước tương tự cho tất cả địa chỉ IP của bộ xử lý thư. Ví dụ: để DROP các yêu cầu đến từ địa chỉ IP của bộ xử lý thông báo đến nút Qpid trên cổng 5672 bằng IPTables, bạn có thể sử dụng một lệnh như sau:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
Khởi động lại trình trung gian Qpid để loại bỏ các thông báo hiện có (nếu có):
```
apigee-service apigee-qpidd start
```
Kiểm tra để đảm bảo các hàng đợi hiện có đều trống:
```
/opt/apigee/apigee-qpidd/bin/qpid-stat -q
```
Nếu thông báo bị kẹt trong hàng đợi thư không gửi được (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), hãy rút hết thông báo trong hàng đợi bằng cách làm theo các bước để giải quyết vấn đề dữ liệu phân tích bị kẹt trong hàng đợi thư không gửi được.
Sau khi xác minh rằng các hàng đợi đã được xử lý hết trên nút cũ, hãy dừng apigee-qpidd:
```
apigee-service apigee-qpidd stop
```

Nâng cấp Qpid trên nút:

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

Khởi động lại edge-qpid-server:
```
apigee-service edge-qpid-server restart
```
Xoá quy tắc tường lửa đã áp dụng ở Bước 3.

Thực hiện cùng một bước xoá cho tất cả địa chỉ IP của trình xử lý thông báo mà tường lửa đã được áp dụng. Sau khi tường lửa được gỡ bỏ, các yêu cầu đến từ địa chỉ IP của bộ xử lý thông báo đến nút Qpid trên cổng 5672 sẽ được chấp nhận. Nếu đã sử dụng iptables để thêm tường lửa, thì bạn có thể dùng các lệnh như sau để xoá tường lửa và liệt kê các chế độ cài đặt hiện có:
```
iptables -F
iptables -L
```
Sử dụng tính năng giám sát web để xác minh rằng hàng đợi Qpid đang nhận được thông báo:
```
http://QPID_NODE_IP:8090
```
Lặp lại các bước từ 1 đến 9 cho từng nút Qpid.

Nâng cấp lên Postgres 18.6

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

Hầu hết các hệ thống sản xuất Edge đều sử dụng hai 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, 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 việc cập nhật Postgres phụ 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 Postgres dự phòng 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ấu trúc liên kết dùng để tạo nguyên mẫu và thử nghiệm, 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 phải 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 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 nhanh mạng của kho dữ liệu mà Postgres sử dụng. Sau đó, nếu xảy ra lỗi trong quá trình cập nhật và bạn buộc phải khôi phục, 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 tạo một máy chủ dự phòng Postgres trên một nút mới. Đảm bảo rằng bạn cài đặt một máy chủ dự phòng Postgres mới cho phiên bản Edge hiện tại (4.53.00 hoặc 4.53.01), chứ không phải cho phiên bản 4.54.00.

Để thực hiện quy trình cài đặt, hãy sử 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 nút dự phòng Postgres mới:

Trên cơ sở dữ liệu chính hiện tại của Postgres, 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.

Khởi động lại apigee-postgresql trên Postgres chính:

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

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 nút 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
```
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 nhằm chỉ định những nội dung sau:
```
# IP address of the current primary(master):
PG_MASTER=PG_MASTER_NODE_IP
# IP address of the new standby node
PG_STANDBY=PG_STANDBY_NODE_IP
```
2. Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
3. Tải xuống và chạy tập lệnh khởi động dựa trên phiên bản Edge hiện tại của bạn:
  - Nếu bạn đang dùng Edge 4.53.00:
    
    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
```
    Cài đặt tiện ích và phần phụ thuộc Edge apigee-service:
```
bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  - Nếu bạn đang dùng Edge 4.53.01:
    
    Tải tệp Edge bootstrap_4.53.01.sh 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
```
    Cài đặt tiện ích và phần phụ thuộc Edge apigee-service:
```
bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
```
4. Sử 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 và xác minh rằng đó là nút dự phòng:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```

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

Bước sơ bộ

Trước khi thực hiện nâng cấp tại chỗ lên Postgres, hãy làm theo 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:

Nếu không có, hãy tạo tệp /opt/apigee/customer/application/postgresql.properties .

Thay đổi quyền sở hữu tệp này thành apigee :

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

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

conf/postgresql.conf+max_locks_per_transaction=30000

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

apigee-service apigee-postgresql configure

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

apigee-service apigee-postgresql restart

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

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

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 configFile

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

apigee-service apigee-postgresql setup -f configFile

Chạy lệnh định cấu hình trên máy chủ chính:
```
apigee-service apigee-postgresql configure
```

Khởi động lại máy chủ chính:

apigee-service apigee-postgresql restart

Định cấu hình làm vị trí chính:

apigee-service apigee-postgresql setup-replication-on-master -f configFile

Đảm bảo người tổ chức chính đã bắt đầu:
```
apigee-service apigee-postgresql wait_for_ready
```
Dừng chế độ chờ:
```
apigee-service apigee-postgresql stop
```
Nâng cấp chế độ chờ.

Lưu ý: Nếu bước này gặp lỗi/không thành công, bạn có thể bỏ qua. update.sh sẽ cố gắng khởi động máy chủ dự phòng bằng một 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 18, bạn có thể bỏ qua lỗi này.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Đảm bảo chế độ chờ đã dừng:
```
apigee-service apigee-postgresql stop
```

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

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

Thiết lập tính năng sao chép trên máy chủ dự phòng:

apigee-service apigee-postgresql setup-replication-on-standby -f configFile

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:

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

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

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

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

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 kết quả, có dạng:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
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
```
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
```

Khởi động lại apigee-postgresql trên Postgres chính:

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

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 nút chính. Bạn chỉ thấy dòng sau trong tệp đó:
```
host replication apigee existing_standby_ip/32 trust
```
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 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ể bị 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.

Nâng cấp lên ZooKeeper 3.8.5

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.5. Trong quá trình nâng cấp đó, tất cả dữ liệu ZooKeeper sẽ được di chuyển sang ZooKeeper 3.8.5.

Trước khi nâng cấp ZooKeeper, hãy đọc kỹ 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 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 người bỏ phiếu tham gia vào quy trình bầu chọn người lãnh đạo ZooKeeper, còn những nút còn lại được định cấu hình làm người quan sát. 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 lãnh đạo, sau đó các nút bỏ phiếu sẽ trở thành nút theo dõi.

Trong quá trình cập nhật, có thể xảy ra tình trạng chậm trễ tạm thời hoặc lỗi ghi trong ZooKeeper khi nút dẫn đầu bị tắt. Điều này có thể ảnh hưởng đến các hoạt động Quản lý ghi vào ZooKeeper, chẳng hạn như hoạt động triển khai proxy và các thay đổi về cơ sở hạ tầng của Apigee, chẳng hạn như việc thêm hoặc xoá bộ 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, quá trình nâng cấp bao gồm việc sao lưu từng nút. Sau đó, bạn cần nâng cấp tất cả các nút quan sát và nút theo dõi, rồi cuối cùng là nâng cấp nút chính.

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.

/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 nhanh hoặc sao lưu máy ảo để khôi phục hoặc khôi phục về trạng thái trước đó (nếu cần).

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

Nếu chưa cài đặt trên nút ZooKeeper, hãy cài đặt nc:
```
yum install nc
```
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.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
Clients:
 /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)

Latency min/avg/max: 3/4.3333/6
Received: 4
Sent: 3
Connections: 1
Outstanding: 0
Zxid: 0x500000005
Mode: follower
```
Trong dòng Mode của đầu ra cho các nút, bạn sẽ thấy observer (quan sát viên), leader (người dẫn đầu) hoặc follower (người theo dõi) (nghĩa là một người bỏ phiếu không phải là người dẫn đầu) tuỳ thuộc vào cấu hình nút.

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 quan sát 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:

Tải xuống và chạy tệp khởi động của Edge cho đám mây riêng tư 4.54.00, như mô tả trong phần Cập nhật lên phiên bản 4.54.00 trên một nút có kết nối Internet bên ngoài . Quy trình này có thể 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 cài đặt khi không có mạng.
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), thì bạn cũng có thể nâng cấp các thành phần đó ngay bây giờ (như với hồ sơ zk,cs) hoặc nâng cấp các thành phần khác sau. Apigee khuyên bạn chỉ nên 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.
Lặp lại các bước trên đối với 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ả 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 sau:

/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ễ hoặc lỗi ghi tạm thời trong ZooKeeper. Điều này có thể ảnh hưởng đến các hoạt động ghi vào ZooKeeper, chẳng hạn như hành động triển khai proxy hoặc thay đổi cơ sở hạ tầng của Apigee, chẳng hạn như thêm hoặc xoá bộ xử lý thông báo, v.v.

Xác minh rằng nút dẫn đầu mới đã được chọn

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

Người nâng cấp

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âng cấp nút chính cũ, hãy xác minh tình trạng của cụm và đảm bảo có một nút chính.

Nâng cấp lên Cassandra 5.0.8

Apigee Edge cho Private Cloud 4.54.00 bao gồm bản nâng cấp Cassandra lên phiên bản 5.0.8.

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

Việc nâng cấp từ Cassandra 4.0.X lên Cassandra 5.0.X là một quy trình cuốn chiếu.
Bạn không thể trực tiếp khôi phục tại chỗ từ Cassandra 5.0.X về 4.0.X. Việc khôi phục bằ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. Khắc phục sự cố và nâng cấp lên Cassandra 5.0.X sẽ tốt hơn so với việc 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 quy trình khôi phục phù hợp.

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

Việc nâng cấp Cassandra từ 4.0.X lên 5.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 lại phức tạp và có thể dẫn đến thời gian ngừng hoạt động và 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. Việc này sẽ cho phép khôi phục Cassandra mà không làm mất dữ liệu hoặc làm 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.

Nếu không thể thêm trung tâm dữ liệu mới nhưng vẫn muốn có khả năng khôi phục, bạn cần phải sao lưu để khôi phục Cassandra 4.0.X. Tuy nhiên, phương thức này có thể gây ra 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 Private Cloud 4.53.00 (hoặc) 4.53.01 mang lại sự linh hoạt hơn cho việc khôi phục trong quá trình nâng cấp lên Edge cho Private Cloud 4.54.00.

Việc khôi phục yêu cầu ít nhất một trung tâm dữ liệu chạy phiên bản Cassandra cũ (4.0.X).

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

Nâng cấp từng trung tâm dữ liệu Cassandra một: 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.
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 biệt là trung tâm dữ liệu đã nâng cấp, đang hoạt động đúng cách.
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ũ.
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 (bạn nên tạm dừng trong 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 cụm Cassandra không đồng nhất (có các nút trên các phiên bản khác nhau) có các giới hạn hoạt động.
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 nâng cấp tất cả trung tâm dữ liệu, bạn sẽ không thể quay lại phiên bản trước đó.

Quy trình khôi phục điểm kiểm tra

Điểm kiểm tra khôi phục duy nhất: Khi tất cả thành phần được nâng cấp lên phiên bản 4.54.00, bạn chỉ có thể khôi phục Cassandra nếu ít nhất một trung tâm dữ liệu Cassandra tiếp tục chạy phiên bản cũ. Sau khi trung tâm dữ liệu Cassandra cuối cùng được nâng cấp, quá trình nâng cấp lên Edge cho đám mây riêng tư 4.54.00 sẽ hoàn tất và bạn không thể khôi phục được nữa.

Ví dụ

Hãy xem xét một cụm hai trung tâm dữ liệu (DC):

Trạng thái ban đầu: Các nút Cassandra ở cả hai DC đều ở phiên bản 4.0.X. Tất cả các nút khác đều nằm trên Edge cho Đám mây riêng tư phiên bản 4.54.00. Giả sử có 3 nút Cassandra trên mỗi DC.
Nâng cấp DC-1: Nâng cấp từng nút Cassandra trong DC-1.
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ể khôi phục về 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ỉ nên tạm dừng trong thời gian ngắn do các hạn chế của cụm Cassandra có nhiều phiên bản.
Nâng cấp DC-2: Nâng cấp 3 nút Cassandra còn lại trong DC-2. Sau khi tất cả các nút Cassandra trong DC-2 được nâng cấp thành công, quá trình nâng cấp Edge cho đám mây riêng tư 4.54.00 sẽ hoàn tất.

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

Bạn nên chạy Cassandra 4.0.X với Edge cho Đám mây riêng tư 4.53.00 (hoặc) 4.53.01 và đảm bảo những điều sau:

Đặt Java 17 làm phiên bản Java mặc định trên máy chủ: Cassandra 5.0.X không còn hỗ trợ Java 8. Bạn không thể chạy Cassandra 5.0.X hoặc tiện ích nodetool của Cassandra bằng Java 8. Đảm bảo rằng bạn đã cài đặt Java 17 trên mỗi nút Cassandra và đặt Java 17 làm phiên bản Java mặc định trước khi chạy các bước nâng cấp Cassandra để các lệnh nodetool thực thi bằng Java 17:
```
alternatives --set java JAVA_17_PATH/bin/java
```
Xác minh rằng phiên bản Java mặc định đang hoạt động là Java 17:
```
java -version
```
Toàn bộ cụm đều hoạt động và có đầy đủ chức năng với Cassandra 4.0.X.
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.53.00 (hoặc) 4.53.01).
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 4.0.X trong Edge cho Đám mây riêng tư phiên bản 4.53.00 (hoặc) 4.53.01.
- Lệnh post_upgrade đã được thực thi trên mỗi nút Cassandra trong lần nâng cấp trước
- Lệnh drop_old_tables đã được thực thi trên toàn bộ cụm Cassandra trong lần 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 4.0.X trong khi sử dụng Edge cho Đám mây riêng tư 4.53.00 (hoặc) 4.53.01, thì 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.54.00.

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

Các bước dưới đây bổ sung cho các 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 tính năng nâng cấp thành phần.

Sao lưu Cassandra bằng Apigee.
Chụp nhanh VM của các nút Cassandra (nếu có thể).
Đảm bảo rằng tất cả các thành phần Edge for Private Cloud (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 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ỹ 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 còn nguyên vẹn. Đây là bước quan trọng để đảm bảo độ ổn định của trung tâm dữ liệu nơi Cassandra đã được nâng cấp lên phiên bản 5.0.X, trong khi các thành phần còn lại của Apigee được nâng cấp lên phiên bản 4.54.00.

Để 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
```
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
```

Đoạn mã trên sẽ xuất ra nội dung tương tự như sau:

Cassandra version is verified - [cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Metadata is verified

Chạy lệnh post_upgrade sau trên nút Cassandra:

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

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

Chạy các lệnh nodetool sau để 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 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 apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index 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 cache cache_entries cache_entries_cache_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

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

Cập nhật bằng Apigee mTLS

Để cập nhật Apigee mTLS , hãy làm theo các bước sau:

Huỷ bản cập nhật

Trong trường hợp không cập nhật được, bạn có thể thử khắc phục vấn đề rồi thực thi lại update.sh. Bạn có thể chạy bản cập nhật nhiều lần và bản cập nhật sẽ tiếp tục từ nơi bạn dừng lại lần gần 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.54.00 để biết hướng dẫn chi tiết.

Đang 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 này sẽ ghi nhật ký vào thư mục /tmp dưới dạng tệp có tên 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 không gián đoạn

Bản cập nhật không gây gián đoạn (hoặc bản cập nhật cuốn chiếu) 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 cần ngừng hoạt động khi có cấu hình 5 nút trở lên.

Chìa khoá để nâng cấp mà không cần ngừng hoạt động là xoá từng Bộ định tuyến, mỗi lần một bộ, khỏi trình 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.

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 .
Khi đến lúc cập nhật Bộ định tuyến, hãy chọn một Bộ định tuyến bất kỳ và đặt trạng thái không thể kết nối, như mô tả trong phần Bật/tắt khả năng kết nối của máy chủ (Bộ xử lý thông báo/Bộ định tuyến) .
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ấu hình Edge đều cho thấy Bộ định tuyến và Bộ xử lý thông báo trên cùng một nút.
Làm cho Bộ định tuyến có thể truy cập lại.
Lặp lại các bước từ 2 đến 4 cho các Bộ định tuyến còn lại.
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, hãy làm như sau:
  1. Khiến Bộ định tuyến không thể truy cập.
  2. Làm cho Bộ xử lý thông báo không thể truy cập được.
- Sau khi cập nhật – hãy làm như sau:
  1. Giúp Bộ xử lý thông báo 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 riêng lẻ:
- Trước khi cập nhật, hãy đặt Bộ định tuyến ở trạng thái không thể truy cập.
- Sau khi cập nhật, hãy đảm bảo có thể kết nối với Bộ định tuyến.
Trên các nút Message Processor riêng lẻ:
- Trước khi cập nhật, hãy đảm bảo không thể truy cập vào Bộ xử lý thông báo.
- 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 tự độ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. Mặc dù tệp cấu hình tự động hầu như tương tự với tệp bạn đã dùng để cài đặt Edge cho đám mây riêng tư phiên bản 4.53.00 hoặc 4.53.01, nhưng bạn có thể cần phải thay đổi các thành phần như giao diện người dùng và SSO, như mô tả trong phần Nâng cấp lên giao diện người dùng Edge mới và Apigee SSO (Nếu đã cài đặt).

Cập nhật lên phiên bản 4.54.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:

Nếu có, hãy tắt 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.
Đăng nhập vào nút của bạn với tư cách là người dùng gốc để cài đặt Edge RPM.

Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập gốc, nhưng bạn có thể thực hiện cấu hình Edge mà không cần quyền truy cập gốc.
Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge .

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
yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Nếu bạn hiện đang sử dụng Edge cho Private Cloud 4.53.00 (hoặc) 4.53.01:
1. Tải tệp Edge bootstrap_4.54.00.sh xuống /tmp/bootstrap_4.54.00.sh :
```
curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
2. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge 4.54.00 bằng cách thực thi lệnh sau:
```
bash /tmp/bootstrap_4.54.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 thông tin này.
  
  Theo mặc định, trình cài đặt sẽ kiểm tra xem bạn đã cài đặt Java 17 và 21 hay chưa.
3. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau:
```
/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à:
    - edge : Tất cả thành phần Edge ngoại trừ Giao diện người dùng Edge mới: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
    - ldap : OpenLDAP
    - ue : Giao diện người dùng mới của Edge
    - qpid : Apigee Qpid
    - ps : Apigee Postgresql
    - zk : ZooKeeper
    - cs : Cassandra
  - 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.53.00 (hoặc) 4.53.01.
  Lưu ý: Người dùng "apigee" phải đọc được tệp cấu hình. Để thay đổi chủ sở hữu, hãy dùng lệnh sau:
```
chown apigee:apigee configFile
```
  Bạn có thể chạy update.sh cho tất cả thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có 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 configFile
```
7. Khởi động lại các thành phần giao diện người dùng Edge mới trên tất cả các nút đang chạy chúng, nếu bạn chưa làm như vậy:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-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.54.00

Cập nhật lên phiên bản 4.54.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 cách nào đó, thì bạn có thể thực hiện quy trình 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 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, sau đó 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.54.00 cục bộ:

Tạo kho lưu trữ 4.54.00 cục bộ 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.

Lưu ý: Nếu đã có một kho lưu trữ hiện có, bạn có thể thêm kho lưu trữ 4.54.00 vào kho lưu trữ đó như mô tả trong phần "Cập nhật kho lưu trữ Apigee cục bộ" tại Cài đặt tiện ích apigee-setup của Edge.
Cài đặt apigee-service trên các nút đích bằng một trong các phương thức sau:
- Cách 1: Cài đặt apigee-service từ tệp .tar
  1. Trên nút có kho lưu trữ cục bộ, hãy sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ thành một tệp .tar có tên là /opt/apigee/data/apigee-mirror/apigee-4.54.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.54.00.tar.gz
```
    Lệnh này sẽ tạo một thư mục mới có tên là 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:
```
bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Xin lưu ý rằng bạn phải thêm đường dẫn đến thư mục repos trong lệnh này.
- Cách 2: 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 Edge bootstrap_4.54.00.sh xuống /tmp/bootstrap_4.54.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
    Trong đó uName:pWord là tên người dùng và mật khẩu 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-service và các phần phụ thuộc của Edge:
```
bash /tmp/bootstrap_4.54.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ữ.
Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
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
```
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
```
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. Các giá trị có thể là:
  - edge : Tất cả thành phần Edge ngoại trừ Giao diện người dùng Edge mới: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
  - ldap : OpenLDAP
  - ue : Giao diện người dùng mới của Edge
  - qpid : Apigee Qpid
  - ps : Apigee Postgresql
  - zk : ZooKeeper
  - cs : Cassandra
- configFile là cùng một 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 phiên bản 4.53.00 (hoặc) 4.53.01.
  
  Lưu ý: Người dùng "apigee" phải đọc được tệp cấu hình. Để thay đổi chủ sở hữu, hãy dùng lệnh sau:
```
chown apigee:apigee configFile
```
Bạn có thể chạy update.sh cho tất cả thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có 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 configFile
```
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 như vậy:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
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 phiên bản cập nhật trước, hãy sử dụng quy trình được mô tả trong phần Quay lại phiên bản 4.54.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. Nâng cấp các thành phần theo trình tự bên dưới.

Nâng cấp tất cả các nút Router và Message Processor trên tất cả các trung tâm dữ liệu bằng cách sử dụng lựa chọn -c edge.
Nâng cấp tất cả các nút Máy chủ quản lý trên tất cả các trung tâm dữ liệu bằng tuỳ chọn -c edge.
Nâng cấp tất cả các nút LDAP trên tất cả các trung tâm dữ liệu. Nếu đang nâng cấp từ Edge cho đám mây riêng tư phiên bản 4.53.00, bạn cần làm theo các bước bổ sung để thực hiện các bước đặc biệt của quy trình nâng cấp LDAP
Nâng cấp giao diện người dùng và Apigee SSO (nếu đã cài đặt) trên tất cả các trung tâm dữ liệu:
1. Nếu chưa cài đặt apigee-sso: Hãy làm theo Lựa chọn 1: Nâng cấp giao diện người dùng (không có Apigee SSO) để nâng cấp lên Giao diện người dùng Edge mới.
2. Nếu apigee-sso được cài đặt: Hãy làm theo Lựa chọn 2: Nâng cấp giao diện người dùng (bằng Apigee SSO) để nâng cấp lên Giao diện người dùng Edge mới và Apigee SSO.
Nâng cấp tất cả các thành phần Qpid và edge-qpid-server trên tất cả các trung tâm dữ liệu bằng cách làm theo các bước đặc biệt của Qpid.
Nâng cấp tất cả thành phần Postgresql và edge-postgres-server trên tất cả các trung tâm dữ liệu bằng cách làm theo các bước đặc biệt của Postgres
Nâng cấp tất cả các thành phần Zookeeper trên tất cả các trung tâm dữ liệu bằng cách làm theo các bước đặc biệt để nâng cấp Zookeeper.
Nâng cấp tất cả thành phần Cassandra trên tất cả các trung tâm dữ liệu bằng cách làm theo các bước đặc biệt để nâng cấp Cassandra.
Không có bước riêng để cập nhật tính năng Kiếm tiền. Giá trị này sẽ đượ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.54.00:

Khi nâng cấp từ Edge cho Đám mây riêng tư 4.53.00, trước tiên, bạn phải nâng cấp LDAP bằng cách làm theo Các bước nâng cấp từ 4.53.00 lên 4.54.00 trước khi bắt đầu nâng cấp tất cả các thành phần.

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

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

(Nếu bạn đã cài đặt apigee-adminapi) Hãy 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 riêng lẻ 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 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.

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

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

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

Cập nhật giao diện người dùng Edge mới trên máy 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Lưu ý: Nếu đã cài đặt apigee-sso, vui lòng tham khảo Lựa chọn 2: Giao diện người dùng nâng cấp (có Apigee SSO) để biết hướng dẫn về cách định cấu hình giao diện người dùng này cho Apigee SSO.

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

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

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

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

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

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

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

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

(Nếu bạn đã cài đặt apigee-adminapi) Hãy cập nhật tiện ích apigee-adminapi trên máy 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Nâng cấp 5 nút

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

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

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

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

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

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

Cập nhật giao diện người dùng mới của Edge trong máy 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Lưu ý: Nếu đã cài đặt apigee-sso, vui lòng tham khảo Lựa chọn 2: Giao diện người dùng nâng cấp (có Apigee SSO) để biết hướng dẫn về cách định cấu hình giao diện người dùng này cho Apigee SSO.

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

Cập nhật Qpid trên máy 4, 5:

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

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

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

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

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

(Nếu bạn đã cài đặt apigee-adminapi) Hãy cập nhật tiện ích apigee-adminapi trên máy 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

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:

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

Cập nhật các thành phần Edge trên máy 4, 5 và 1 (bộ định tuyến, bộ xử lý thông báo và máy chủ quản lý) theo thứ tự sau:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

Cập nhật giao diện người dùng New Edge trong máy 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Lưu ý: Nếu bạn đã cài đặt apigee-sso, vui lòng tham khảo Lựa chọn 2: Nâng cấp giao diện người dùng (có SSO Apigee) để biết hướng dẫn về cách định cấu hình giao diện người dùng này cho SSO Apigee.
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
```

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

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

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

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

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

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

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

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

(Nếu bạn đã cài đặt apigee-adminapi) Hãy cập nhật tiện ích apigee-adminapi trên máy 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

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 theo cụm 13 nút:

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

Cập nhật các thành phần Edge trên máy 10, 11, 6 và 7 theo thứ tự sau:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

Cập nhật giao diện người dùng mới của Edge trên máy 6, 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Lưu ý: Nếu đã cài đặt apigee-sso, vui lòng tham khảo Lựa chọn 2: Giao diện người dùng nâng cấp (có Apigee SSO) để biết hướng dẫn về cách định cấu hình giao diện người dùng này cho Apigee SSO.
Cập nhật các thành phần Edge trên máy 12, 13, 8 và 9 theo thứ tự sau:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

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

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

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

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

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

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

(Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên các máy 6 và 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

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 theo cụm 12 nút:

Xem phần Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

Cập nhật các thành phần Edge (Bộ định tuyến và Bộ xử lý thông báo):
- Trên máy 2, 3 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- Trên các máy 8, 9 trong Trung tâm dữ liệu 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Cập nhật các thành phần Edge (Máy chủ quản lý):
- Trên máy 1 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- Trên máy 7 trong Trung tâm dữ liệu 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Cập nhật LDAP:

Máy 1 trong Trung tâm dữ liệu 1:

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

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

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

Cập nhật các thành phần giao diện người dùng mới của Edge:
- Trên máy 1 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  Lưu ý: Nếu đã cài đặt apigee-sso, vui lòng tham khảo Lựa chọn 2: Giao diện người dùng nâng cấp (có Apigee SSO) để biết hướng dẫn về cách định cấu hình giao diện người dùng này cho Apigee SSO.
- Trên máy 7 trong Trung tâm dữ liệu 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  Lưu ý: Nếu bạn đã cài đặt apigee-sso, vui lòng tham khảo Lựa chọn 2: Nâng cấp giao diện người dùng (có SSO Apigee) để biết hướng dẫn về cách định cấu hình giao diện người dùng này cho SSO Apigee.
Cập nhật các thành phần của Edge:
- Máy 4, 5, 6 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- Máy 10, 11, 12 trong Trung tâm dữ liệu 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Cập nhật qpidd:

Máy 4, 5 trong Trung tâm dữ liệu 1:

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

Máy 10, 11 trong Trung tâm dữ liệu 2:

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

Cập nhật Postgres:

Máy 6 trong Trung tâm dữ liệu 1:

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

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

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

Cập nhật Cassandra và ZooKeeper:
- Máy 1, 2 và 3 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
- 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 zk,cs -f configFile
```
(Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:
- Máy 1 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
- Máy 7 trong Trung tâm dữ liệu 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Đố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:

Bộ định tuyến
Trình xử lý thông báo
Máy chủ quản lý
LDAP
Giao diện người dùng (cả giao diện người dùng cũ và giao diện người dùng mới)
SSO (nếu có)
Qpid và edge-qpid-server
Postgres và edge-postgres-server
ZooKeeper
Cassandra
apigee-adminapi

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

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

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

Tài liệu đọc trước

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

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

Nâng cấp Bộ định tuyến và Bộ xử lý thông báo

Nâng cấp máy chủ quản lý

Nâng cấp lên OpenLDAP 2.6.10

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

Các bước nâng cấp LDAP từ 4.53.00 lên 4.54.00

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

Các bước nâng cấp LDAP từ 4.53.01 lên 4.54.00

Nâng cấp lên giao diện người dùng Edge mới và SSO Apigee (nếu đã cài đặt)

Cách 1: Nâng cấp giao diện người dùng (không có SSO của Apigee)

Bước 1: Sao lưu các tệp cấu hình

Bước 2: Cập nhật tệp cấu hình im lặng cho Xác thực cơ bản

Bước 3: Nâng cấp thành phần giao diện người dùng

Bước 4: Xác minh việc nâng cấp giao diện người dùng Edge mới

Cách 2: Nâng cấp giao diện người dùng (bằng SSO của Apigee)

Bước 1: Sao lưu các tệp cấu hình

Bước 2: Xoá các biến UI/SSO không dùng nữa và cập nhật tệp cấu hình im lặng (configFile)

Bước 3: Nâng cấp thành phần giao diện người dùng Edge mới

Bước 4: Dừng apigee-sso

Bước 5: Tạo cơ sở dữ liệu apigee_dex cho Apigee SSO trong nút Postgres

Bước 6: Thiết lập dịch vụ đăng nhập một lần (SSO) của Apigee trên các nút OpenLDAP

Bước 7: Định cấu hình giao diện người dùng quản lý cho SSO của Apigee và khởi động lại giao diện người dùng

Bước 8: Xác minh việc nâng cấp Giao diện người dùng Edge mới và SSO Apigee

Bước 9: Gỡ cài đặt apigee-sso cũ

Nâng cấp lên Qpid 10.0.1

Nâng cấp lên Postgres 18.6

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

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

Bước sơ bộ

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

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

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

Nâng cấp lên ZooKeeper 3.8.5

Sao lưu

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

Nâng cấp ZooKeeper trên các nút quan sát và nút theo dõi

Tắt máy chủ chính

Xác minh rằng nút dẫn đầu mới đã được chọn

Người nâng cấp

Nâng cấp lên Cassandra 5.0.8

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

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

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

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

Quy trình khôi phục điểm kiểm tra

Ví dụ

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

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

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

Cập nhật bằng Apigee mTLS

Huỷ bản cập nhật

Đang ghi nhật ký thông tin cập nhật

Cập nhật không gián đoạn

Sử dụng tệp cấu hình tự động

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

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

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

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

Bản nâng cấp riêng lẻ 2 nút

Nâng cấp 5 nút

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

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

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

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

Bước 2: Xoá các biến UI/SSO không dùng nữa và cập nhật tệp cấu hình im lặng (`configFile`)

Bước 4: Dừng `apigee-sso`

Bước 5: Tạo cơ sở dữ liệu `apigee_dex` cho Apigee SSO trong nút Postgres

Bước 9: Gỡ cài đặt `apigee-sso` cũ