Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Cập nhật Apigee Edge 4.51.00 hoặc 4.52.00 hoặc 4.52.01 lên 4.52.02

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

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

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

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

Sao lưu tất cả các nút
Trước khi cập nhật, bạn nên sao lưu đầy đủ tất cả các nút vì lý do an toàn. Hãy dùng quy trình sao lưu cho phiên bản Edge hiện tại của bạn.
Điều này giúp bạn có kế hoạch dự phòng trong trường hợp bản cập nhật lên phiên bản mới không hoạt động đúng cách. Để biết thêm thông tin về tính năng sao lưu, hãy xem bài viết Sao lưu và khôi phục.
Đảm bảo Edge đang chạy
Đảm bảo Edge đang chạy trong quá trình cập nhật bằng cách sử dụng lệnh:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Lưu ý: Đảm bảo rằng chế độ thiết lập edge-management-server trên phiên bản hiện tại của bạn đang chạy thành công mà không gặp lỗi. Khắc phục mọi lỗi trong quá trình thiết lập edge-management-server từ các phiên bản trước trước khi tiếp tục nâng cấp.
Đảm bảo rằng Chiến lược nén Cassandra là LeveledCompactionStrategy
Tuỳ thuộc vào phiên bản hiện tại, hãy thực hiện các thay đổi cần thiết đối với chiến lược nén Cassandra. Hãy làm theo các bước dưới đây rồi quay lại quy trình nâng cấp chính:
- Nếu bạn đang nâng cấp từ phiên bản 4.51.00, hãy tham khảo tài liệu về Chiến lược nén Cassandra cho phiên bản 4.51.00.
- Nếu bạn đang nâng cấp từ phiên bản 4.52.00, hãy tham khảo tài liệu về Chiến lược nén Cassandra cho phiên bản 4.52.00.
- Nếu bạn đang nâng cấp từ phiên bản 4.52.01, hãy tham khảo tài liệu về Chiến lược nén Cassandra cho phiên bản 4.52.01.

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.52.02, 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 sẽ 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.

Phiên bản hiện tại	Phần mềm yêu cầu các bước đặc biệt để nâng cấp lên phiên bản 4.52.02
4.52.01	Cassandra
4.52.00	Zookeeper, Cassandra, Qpid
4.51.00	Zookeeper, Postgres, Cassandra, Qpid

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 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ì những giá trị đó sẽ được giữ lại sau khi cập nhật.

Nâng cấp lên Zookeeper 3.8.3

Edge cho Đám mây riêng tư 4.52.02 không bao gồm bản nâng cấp Zookeeper. Tuy nhiên, nếu đang nâng cấp từ phiên bản cũ hơn 4.52.01, bạn phải làm theo các bước nâng cấp Zookeeper được nêu bên dưới.

Nếu bạn đang nâng cấp từ Edge cho Đám mây riêng tư phiên bản 4.51.00 hoặc 4.52.00, hãy tham khảo các bước trong phần Yêu cầu nâng cấp lên Zookeeper 3.8.3 để nâng cấp Zookeeper.
Nếu đang nâng cấp từ Edge cho Đám mây riêng tư phiên bản 4.52.01, thì bạn nên sử dụng Zookeeper phiên bản 3.8.3 và không cần thực hiện bất kỳ bước đặc biệt nào để nâng cấp Zookeeper.

Lưu ý:

Việc nâng cấp từ Edge cho Đám mây riêng tư 4.52.01 lên 4.52.02 được đơn giản hoá vì Zookeeper và Cassandra thường được đặt trên cùng một máy chủ lưu trữ hoặc máy ảo. Điều này giúp loại bỏ nhu cầu về các quy trình nâng cấp Zookeeper riêng biệt cùng với quy trình nâng cấp Cassandra quan trọng.

Nếu Zookeeper cần được cập nhật theo các bước cụ thể, hãy nâng cấp Zookeeper trên tất cả các trung tâm dữ liệu bằng cách cập nhật từng nút một. Sau khi tất cả các nút Zookeeper trên toàn cầu được cập nhật, hãy nâng cấp Cassandra từng trung tâm dữ liệu một lần, tuân thủ quy trình được nêu ở phần sau trong bài viết này.

Lệnh sau đây hỗ trợ việc nâng cấp Zookeeper riêng biệt:

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

Đối với quy trình khôi phục Zookeeper, hãy sử dụng quy trình khôi phục Zookeeper tiêu chuẩn. Nếu cần khôi phục Cassandra hoặc các thành phần khác về phiên bản trước, thì bạn nên khôi phục các thành phần đó; bạn không cần khôi phục Zookeeper về phiên bản trước.

Nâng cấp lên Postgres 14

Nếu đang nâng cấp từ Edge for Private Cloud 4.51.00 lên 4.52.02, bạn phải làm theo các bước để nâng cấp Postgres, ngay cả khi Edge for Private Cloud 4.52.02 không có bản nâng cấp Postgres. Để nâng cấp từ Edge cho Đám mây riêng tư 4.51.00 lên 4.52.02, bạn cần thực hiện thêm các bước nâng cấp Postgres. Vui lòng tham khảo phần Yêu cầu nâng cấp lên Postgres 14.
Nếu bạn đang nâng cấp từ Edge cho Đám mây riêng tư 4.52.00 hoặc 4.52.01 lên 4.52.02, thì bạn không cần thực hiện thêm các bước nâng cấp Postgres.

Lưu ý:

Nếu Postgres yêu cầu cập nhật bằng các bước đặc biệt, hãy thực hiện việc này một cách độc lập trước khi nâng cấp Cassandra. Bạn nên nâng cấp Cassandra cho từng trung tâm dữ liệu. Tuy nhiên, bạn nên cập nhật Postgres trên tất cả các trung tâm dữ liệu bằng cách cập nhật từng nút postgres một.Sau khi cập nhật Postgres, hãy xác minh rằng cụm đang hoạt động đầy đủ trước khi tiến hành nâng cấp Cassandra và các thành phần khác.

Đối với quy trình khôi phục Postgres, hãy làm theo quy trình khôi phục Postgres tiêu chuẩn. Nếu cần khôi phục Cassandra hoặc các thành phần khác, hãy khôi phục các thành phần đó; bạn không cần khôi phục Postgres.

Nâng cấp lên Cassandra 3.11.16

Apigee Edge cho Private Cloud 4.52.02 bao gồm bản nâng cấp Cassandra lên phiên bản 3.11.16. Cassandra là một thành phần quan trọng của Apigee và bản nâng cấp này cũng bao gồm các bản cập nhật cho phần mềm trình điều khiển trong nhiều thành phần thời gian chạy và quản lý được dùng để truy vấn và ghi vào Cassandra.

Vì đây là một bản nâng cấp lớn, nên chúng tôi cần thực hiện một số thay đổi đối với mô hình dữ liệu của Apigee trong Cassandra để đảm bảo hiệu suất tối ưu trong các phiên bản mới hơn. Mặc dù những thay đổi này là tối thiểu, nhưng quy trình nâng cấp sẽ làm gián đoạn một số API quản lý khi quá trình nâng cấp bắt đầu. Các API quản lý chính xác thường bị gián đoạn được liệt kê trong các phần có liên quan bên dưới.

Ngoài ra, quá trình nâng cấp sẽ làm gián đoạn một nhóm lớn hơn các luồng proxy thời gian chạy và API quản lý trong trung tâm dữ liệu đang được nâng cấp. Điều quan trọng là bạn phải tách lưu lượng truy cập thời gian chạy và lưu lượng truy cập quản lý khỏi trung tâm dữ liệu đang được nâng cấp để giảm thiểu tình trạng gián đoạn như vậy. Hãy đọc các phần về một trung tâm dữ liệu và nhiều trung tâm dữ liệu bên dưới để biết thêm thông tin.

Lưu ý: Công cụ cassandra-cli không còn được hỗ trợ trong Cassandra 3.X và bạn không thể sử dụng công cụ này.

Cổng thông tin dành cho nhà phát triển – Ghi lại API

Cổng thông tin cho nhà phát triển Drupal của Apigee cung cấp nhiều tính năng để ghi lại API của bạn. Mặc dù bạn nên chuyển sang sử dụng cổng dành cho nhà phát triển dựa trên Drupal 7, nhưng nếu vẫn đang sử dụng cổng này và tận dụng tính năng SmartDocs, thì tài liệu Sử dụng API SmartDocs sẽ áp dụng cho bạn. Nếu bạn đang dùng các phiên bản mới hơn của cổng thông tin dành cho nhà phát triển, thì tài liệu API của bạn sẽ không bị ảnh hưởng trong quá trình nâng cấp này.

Khi bạn nâng cấp Apigee lên phiên bản 4.52.02, mọi mô hình API được tạo bằng tính năng SmartDocs của cổng nhà phát triển Drupal 7 sẽ không tự động di chuyển sang phiên bản mới hơn. Bạn phải xuất từng mô hình theo cách thủ công bằng cách sử dụng cổng thông tin dành cho nhà phát triển và nhập lại mô hình đó sau khi hoàn tất quá trình nâng cấp.

Thuật ngữ được dùng bên dưới

Thời gian chạy: Thời gian chạy bao gồm việc xử lý lưu lượng truy cập của proxy thời gian chạy. Thao tác này bao gồm tất cả các hoạt động do Bộ định tuyến và Bộ xử lý thông báo thực hiện để xử lý hiệu quả yêu cầu API thời gian chạy cho các proxy hiện có. Tuy nhiên, chỉ số này không bao gồm việc triển khai các proxy mới hoặc các bản sửa đổi mới của proxy.

Quản lý: Quản lý bao gồm việc quản trị hệ thống Apigee Edge. Điều này bao gồm nhưng không giới hạn ở việc triển khai, sửa đổi ứng dụng, sản phẩm, máy chủ mục tiêu, kho khoá, v.v. Tất cả các API quản lý (và các ứng dụng như giao diện người dùng Apigee và cổng thông tin dành cho nhà phát triển) đều nằm trong phạm vi này.

Trong quá trình nâng cấp này, lưu lượng truy cập Thời gian chạy và Quản lý sẽ bị ảnh hưởng ở khu vực hoặc trung tâm dữ liệu (DC) nơi quá trình cập nhật đang được thực hiện. Bất kể trung tâm dữ liệu nào được cập nhật, một số API quản lý nhất định trong tất cả các trung tâm dữ liệu đều bị ảnh hưởng. Tác động này được ghi nhận sau mỗi bước.

Trong từng bước dưới đây, trạng thái của thời gian chạy và hoạt động quản lý sẽ được mô tả khi bạn thực hiện các giai đoạn khác nhau của quy trình nâng cấp.

Chiến lược nâng cấp

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

Bạn phải thực hiện quy trình nâng cấp từng trung tâm dữ liệu một để đảm bảo lưu lượng truy cập liên tục và tránh thời gian ngừng hoạt động. Trước khi nâng cấp một DC, lưu lượng truy cập phải được chuyển hướng đến các DC chức năng khác.

Lưu ý:

Để tránh ảnh hưởng đến lưu lượng truy cập trong quá trình nâng cấp, hãy làm theo phương pháp từng trung tâm dữ liệu (DC-by-DC) bằng cách tạm thời chuyển hướng lưu lượng truy cập ra khỏi trung tâm dữ liệu đang được nâng cấp. Điều này đảm bảo quy trình nâng cấp được kiểm soát cho Cassandra, Máy chủ quản lý và các nút Thời gian chạy trong khi vẫn duy trì tính sẵn có của dịch vụ.

Đối với thiết lập hai trung tâm dữ liệu, hãy làm theo các bước chung sau:

Chuyển hướng lưu lượng truy cập từ DC-1 đến DC-2 và chặn lưu lượng truy cập đến DC-1.
Nâng cấp DC-1, bao gồm Cassandra, Máy chủ quản lý và Các thành phần thời gian chạy.
Chuyển hướng lưu lượng truy cập trở lại DC-1 và chặn lưu lượng truy cập đến DC-2.
Nâng cấp DC-2, bao gồm Cassandra, Máy chủ quản lý và Các thành phần thời gian chạy.

Quy trình này đảm bảo việc quản lý lưu lượng truy cập diễn ra liền mạch trong quá trình nâng cấp. Bạn nên làm theo một mẫu tương tự cho các chế độ thiết lập có nhiều hơn 2 trung tâm dữ liệu, trong đó lưu lượng truy cập tạm thời được chuyển hướng đến các trung tâm dữ liệu đã được nâng cấp hoàn toàn hoặc chưa được nâng cấp.

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

Đối với chế độ thiết lập một trung tâm dữ liệu, quy trình nâng cấp sẽ ảnh hưởng đáng kể đến lưu lượng truy cập trong thời gian chạy và một số API quản lý nhất định. Bạn có thể chọn trong các phương án sau đây cho chế độ thiết lập một trung tâm dữ liệu.

Mở rộng cụm Đám mây riêng tư Edge sang một trung tâm dữ liệu tạm thời bằng cách thêm một trung tâm dữ liệu cùng với trung tâm dữ liệu hiện có để xử lý lưu lượng truy cập trong quá trình nâng cấp, sau đó huỷ bỏ một trong các trung tâm dữ liệu sau khi hoàn tất quy trình nâng cấp.
Nếu bạn không thể mở rộng sang một trung tâm dữ liệu khác, hãy chuẩn bị cho thời gian ngừng hoạt động và lên lịch nâng cấp trong thời gian lưu lượng truy cập thấp để giảm thiểu tác động đến các API quản lý và lưu lượng truy cập thời gian chạy.

Bạn nên mở rộng sang một trung tâm dữ liệu khác để tránh ảnh hưởng đến lưu lượng truy cập thời gian chạy và API quản lý. Trong quá trình nâng cấp, những tác động đến trung tâm dữ liệu đang được nâng cấp bao gồm nhưng không giới hạn ở các khía cạnh sau:

Runtime API làm mới mã thông báo OAuth
Runtime API sử dụng Chính sách về thực thể truy cập
API quản lý liệt kê các ứng dụng của nhà phát triển
API quản lý liệt kê sản phẩm

Ngoài ra, tác động được mô tả ở trên còn ảnh hưởng đến các API quản lý cụ thể. Các API này sẽ không hoạt động trên tất cả các trung tâm dữ liệu cho đến khi tất cả các trung tâm dữ liệu được nâng cấp. Các API quản lý như vậy được liệt kê trong các bước ở những phần tiếp theo.

Khôi phục – cấp cao

Tác động trong quá trình khôi phục
Việc quay lại từ Cassandra 3.11.x xuống 2.1.x sẽ ảnh hưởng đến cả thời gian chạy và lưu lượng truy cập quản lý trong trung tâm dữ liệu (DC) nơi đang thực hiện quy trình quay lại. Ngoài ra, một số API quản lý nhất định có thể gặp phải tình trạng gián đoạn trên tất cả các trung tâm dữ liệu, bất kể DC nào hiện đang được khôi phục.
Tuân theo phương pháp khôi phục DC theo DC
Bạn phải thực hiện quy trình khôi phục từng trung tâm dữ liệu một để duy trì tính liên tục của dịch vụ và tránh thời gian ngừng hoạt động. Trước khi bắt đầu khôi phục ở một DC cụ thể, hãy đảm bảo rằng lưu lượng truy cập ứng dụng được chuyển hướng đến một trung tâm dữ liệu khác hoạt động đầy đủ.
Quay lại Cụm đã nâng cấp một phần
Nếu ít nhất một trung tâm dữ liệu vẫn hoạt động đầy đủ trên phiên bản Cassandra cũ (2.1.22), thì các trung tâm dữ liệu khác đã nâng cấp có thể được khôi phục bằng cách thực hiện quy trình tạo lại từ trung tâm dữ liệu Cassandra 2.1.X hoạt động đầy đủ.
Quay lại trên toàn bộ cụm
Nếu toàn bộ cụm Cassandra đã được nâng cấp và cần khôi phục, thì bạn phải thực hiện việc này bằng cách sử dụng bản sao lưu hoặc ảnh chụp nhanh máy ảo. Phương pháp này phức tạp và có thể dẫn đến thời gian ngừng hoạt động tạm thời hoặc mất dữ liệu.
Những điều cần cân nhắc trước khi nâng cấp
Bạn cần nắm rõ các quy trình khôi phục trước khi thử nâng cấp. Điều quan trọng là bạn phải cân nhắc các sắc thái của việc khôi phục trong khi nâng cấp để đảm bảo có sẵn các đường dẫn khôi phục phù hợp.

Khôi phục các cụm có một trung tâm dữ liệu

Việc nâng cấp Cassandra từ phiên bản 2.1.x lên 3.11.x có thể ảnh hưởng đáng kể đến lưu lượng truy cập thời gian chạy và một số API quản lý nhất định. Những tác động này cũng áp dụng trong quá trình khôi phục và có thể dẫn đến thời gian ngừng hoạt động hoặc 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 cung cấp một trung tâm dữ liệu mới trước khi nâng cấp. Nhờ đó, bạn có thể khôi phục về phiên bản trước một cách an toàn 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 sau khi nâng cấp thành công.

Nếu không thể thêm một trung tâm dữ liệu mới nhưng vẫn cần có khả năng khôi phục, hãy đảm bảo rằng bạn đã sao lưu dữ liệu một cách đáng tin cậy trước khi nâng cấp. Bạn có thể khôi phục Cassandra 2.1.x từ các bản sao lưu, nhưng phương pháp này có thể khiến dịch vụ ngừng hoạt động và có nguy cơ mất dữ liệu.

Khôi phục các cụm có nhiều trung tâm dữ liệu

Việc khôi phục nhiều trung tâm dữ liệu tuân theo phương pháp khôi phục từng trung tâm dữ liệu (DC-by-DC). Theo phương pháp này, lưu lượng truy cập từ trung tâm dữ liệu đang được khôi phục sẽ được chuyển hướng đến các trung tâm dữ liệu chức năng khác, đảm bảo quy trình khôi phục có kiểm soát và riêng biệt cho Cassandra, Máy chủ quản lý và các nút Thời gian chạy để tránh gián đoạn lưu lượng truy cập.

Hãy tham khảo phần Quay lại bản cập nhật Cassandra 3.11.16 để biết thông tin chi tiết.

Bước 0: Trạng thái bắt đầu

Các thành phần Zookeeper, Postgres và LDAP đã được nâng cấp lên phiên bản 4.52.02. Edge cho một cụm đám mây riêng tư hoạt động ổn định. Nếu cần khôi phục, cụm sẽ được khôi phục về trạng thái này.
Cassandra trong Apigee chạy với phiên bản 2.1.22.
Thành phần biên:

Máy chủ quản lý giao tiếp với Cassandra thông qua giao thức thrift cũ.
Các máy chủ thời gian chạy (Bộ xử lý thông báo và Bộ định tuyến) giao tiếp với Cassandra thông qua giao thức thrift cũ.

Trạng thái thời gian chạy ở giai đoạn này	Trạng thái quản lý ở giai đoạn này
Thời gian chạy hoạt động đầy đủ	Chức năng quản lý hoạt động đầy đủ

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.

Thay đổi Cassandra để sử dụng LeveledCompactionStrategy.
Sao lưu Cassandra bằng Apigee.
Chụp nhanh máy ảo của các nút Cassandra (nếu có thể).
Tạo tệp cấu hình nâng cấp Cassandra trên mỗi nút Cassandra tại /opt/apigee/apigee-cassandra/cass_upgrade.conf với nội dung sau:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
Nếu không thể tạo tệp tại /opt/apigee/apigee-cassandra/cass_upgrade.conf, hãy tạo tệp /opt/silent.conf có cùng nội dung trên mỗi nút Cassandra.
Thận trọng: Trình cài đặt nâng cấp của Apigee sẽ tìm kiếm tệp ở các vị trí được liệt kê ở trên. Nếu tệp không có ở một trong hai vị trí nêu trên, quá trình nâng cấp sẽ không thành công và xuất hiện thông báo như sau:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
Nếu điều này xảy ra, quá trình nâng cấp sẽ không thành công nhưng dịch vụ Cassandra trên nút có thể sẽ ở trạng thái dừng. Bạn có thể khởi động dịch vụ Cassandra như bình thường và thử nâng cấp lại bằng cách đặt tệp cấu hình ở một trong các vị trí dự kiến. Ngoài ra, nếu tìm thấy tệp nhưng cấu hình được cung cấp không chính xác (ví dụ: thông tin đăng nhập Cassandra không chính xác), thì quá trình nâng cấp sẽ không thành công và gặp lỗi như sau:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
Trong trường hợp này, tương tự, hãy khởi động dịch vụ Cassandra nếu dịch vụ này dừng khi quá trình nâng cấp không thành công và thử lại quá trình nâng cấp sau khi khắc phục cấu hình trong tệp.
Nếu bạn sử dụng tính năng SmartDocs của cổng nhà phát triển Apigee Drupal 7, hãy xuất từng mô hình bằng cách tải mô hình xuống ở định dạng JSON từ giao diện người dùng của cổng nhà phát triển. Bạn sẽ cần nhập lại các mô hình này vào Apigee sau khi cập nhật máy chủ quản lý.
Đảm bảo rằng tất cả các thành phần Edge đều có thể truy cập vào các cổng 9160 và 9042 đến các nút Cassandra nếu chưa có. Hãy tham khảo Yêu cầu về cổng để biết thêm thông tin.

Bước 2: Chuyển hướng lưu lượng truy cập ra khỏi trung tâm dữ liệu đầu tiên

Chặn lưu lượng truy cập thời gian chạy và lưu lượng truy cập quản lý đến từ trung tâm dữ liệu đầu tiên.
Chuyển hướng tất cả lưu lượng truy cập thời gian chạy và API quản lý đến các trung tâm dữ liệu chức năng khác.
Xác thực rằng(các) DC khác xử lý thành công lưu lượng truy cập thời gian chạy và lưu lượng truy cập quản lý.

Bước 3: Nâng cấp tất cả các nút Cassandra trong trung tâm dữ liệu đầu tiên

Nâng cấp từng nút Cassandra trong trung tâm dữ liệu 1. Chạy lần lượt các lệnh sau trên từng nút:
```
/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 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Chạy lệnh post_upgrade sau đây trên từng nút Cassandra lần lượt sau khi quá trình nâng cấp hoàn tất:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
```

Trạng thái thời gian chạy ở giai đoạn này	Trạng thái quản lý ở giai đoạn này
Lưu lượng truy cập trong thời gian chạy bị chặn trên các trung tâm dữ liệu đang được nâng cấp Thời gian chạy hoạt động đầy đủ trên các trung tâm dữ liệu khác	Lưu lượng truy cập quản lý bị chặn trên các trung tâm dữ liệu đang được nâng cấp. Chức năng quản lý sau đây sẽ bị giảm hiệu suất sau khi Cassandra được nâng cấp ở các trung tâm dữ liệu khác: Management API để tạo sản phẩm API có môi trường Management API để cập nhật một sản phẩm API bằng môi trường Management API để xoá một tổ chức

Trạng thái thời gian chạy ở giai đoạn này

Trạng thái quản lý ở giai đoạn này

Lưu lượng truy cập trong thời gian chạy bị chặn trên các trung tâm dữ liệu đang được nâng cấp
Thời gian chạy hoạt động đầy đủ trên các trung tâm dữ liệu khác

Lưu lượng truy cập quản lý bị chặn trên các trung tâm dữ liệu đang được nâng cấp.
Chức năng quản lý sau đây sẽ bị giảm hiệu suất sau khi Cassandra được nâng cấp ở các trung tâm dữ liệu khác:

Bước 4: Nâng cấp tất cả các nút quản lý trong trung tâm dữ liệu đầu tiên

Nâng cấp tất cả các nút quản lý trong trung tâm dữ liệu:

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

Trạng thái thời gian chạy ở giai đoạn này	Trạng thái quản lý ở giai đoạn này
Lưu lượng truy cập trong thời gian chạy bị chặn trên các trung tâm dữ liệu đang được nâng cấp Thời gian chạy hoạt động đầy đủ	Lưu lượng truy cập quản lý bị chặn trên các trung tâm dữ liệu đang được nâng cấp. Chức năng quản lý sau đây sẽ bị suy giảm sau khi Cassandra được nâng cấp: Management API để tạo sản phẩm API có môi trường Management API để cập nhật một sản phẩm API bằng môi trường Management API để xoá một tổ chức

Bước 5: Nâng cấp tất cả các nút thời gian chạy trong trung tâm dữ liệu đầu tiên

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

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

Trạng thái thời gian chạy ở giai đoạn này	Trạng thái quản lý ở giai đoạn này
Lưu lượng truy cập trong thời gian chạy bị chặn trên các trung tâm dữ liệu đang được nâng cấp Thời gian chạy hoạt động đầy đủ trên các trung tâm dữ liệu khác	Lưu lượng truy cập quản lý bị chặn trên các trung tâm dữ liệu đang được nâng cấp. Chức năng quản lý sau đây sẽ bị giảm hiệu suất sau khi Cassandra được nâng cấp ở các trung tâm dữ liệu khác: API Quản lý để tạo sản phẩm API có môi trường Management API để cập nhật một sản phẩm API bằng môi trường Management API để xoá một tổ chức

Trạng thái thời gian chạy ở giai đoạn này

Trạng thái quản lý ở giai đoạn này

Lưu lượng truy cập trong thời gian chạy bị chặn trên các trung tâm dữ liệu đang được nâng cấp
Thời gian chạy hoạt động đầy đủ trên các trung tâm dữ liệu khác

Lưu lượng truy cập quản lý bị chặn trên các trung tâm dữ liệu đang được nâng cấp.
Chức năng quản lý sau đây sẽ bị giảm hiệu suất sau khi Cassandra được nâng cấp ở các trung tâm dữ liệu khác:

Bước 6: Chuyển hướng lưu lượng truy cập trở lại trung tâm dữ liệu đầu tiên

Sau khi nâng cấp Trung tâm dữ liệu First bằng Cassandra, các thành phần thời gian chạy và máy chủ quản lý, hãy bật lại lưu lượng truy cập thời gian chạy và lưu lượng truy cập quản lý cho Trung tâm dữ liệu First.
Đảm bảo lưu lượng truy cập thời gian chạy và lưu lượng truy cập quản lý thành công trên các DC.

Bước 7: Nâng cấp các trung tâm dữ liệu khác

Lặp lại Bước 1 đến Bước 6 trên các trung tâm dữ liệu còn lại, mỗi lần một trung tâm bằng cách chuyển hướng lưu lượng truy cập khỏi các trung tâm dữ liệu đó, cập nhật phần mềm Apigee và bật lại lưu lượng truy cập trên các trung tâm dữ liệu đó.

Bước 8: Chạy lại bước nâng cấp trong tất cả các nút Quản lý

Chạy lại lệnh nâng cấp sau đây trong tất cả các nút quản lý trên các trung tâm dữ liệu:

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

Bước 9 – [Không bắt buộc] Nhập các tài liệu thông minh đã xuất trước đó

Sau khi nâng cấp tất cả các máy chủ quản lý, bạn có thể nhập các mô hình tài liệu thông minh mà bạn đã xuất ở Bước 1. Bạn có thể quyết định làm việc này vào lúc khác.

Bạn chỉ cần thực hiện thao tác này nếu sử dụng cổng nhà phát triển dựa trên Drupal 7 và đang sử dụng tính năng smartdocs.

Trạng thái thời gian chạy ở giai đoạn này	Trạng thái quản lý ở giai đoạn này
Thời gian chạy hoạt động đầy đủ	Chức năng quản lý hoạt động đầy đủ

Bước 10 – Xoá các bảng không dùng đến

Chạy lệnh sau để xoá các bảng cũ không dùng đến khỏi cụm Cassandra. Cho đến khi chạy lệnh này, bạn không thể sử dụng một số tính năng của Cassandra (chẳng hạn như thiết lập phương thức xác thực mới – các cơ chế xác thực cũ sẽ tiếp tục hoạt động). Bạn chỉ có thể thực thi lệnh này trên một nút duy nhất trong cụm

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

Bước 11 – Nâng cấp tất cả các thành phần còn lại của Edge và các thành phần khác cho Đám mây riêng tư 4.52.02

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.

Ở giai đoạn này, nếu bạn đang nâng cấp từ các phiên bản cũ hơn Edge for Private Cloud 4.52.01 như bên dưới, hãy thực hiện các bước bổ sung để nâng cấp Qpid, Postgres tương ứng và nâng cấp các thành phần còn lại theo các bước này.

Nâng cấp lên Qpid J-Broker

Mặc dù Edge cho Đám mây riêng tư 4.52.02 không bao gồm bản nâng cấp lên Qpid, nhưng nếu đang nâng cấp từ phiên bản cũ hơn 4.52.01, bạn cần làm theo các bước để nâng cấp QPID.

Nếu đang nâng cấp từ Edge cho Đám mây riêng tư 4.51.00 hoặc 4.52.00 lên 4.52.02, bạn cần thực hiện thêm các bước nâng cấp Qpid. Vui lòng tham khảo phần Nâng cấp Qpid nếu bạn đang nâng cấp từ phiên bản 4.51.00 hoặc 4.52.00 lên 4.52.02.
Nếu đang nâng cấp từ Edge cho Đám mây riêng tư 4.52.01 lên 4.52.02, thì bạn nên sử dụng phiên bản mới nhất của Qpid Broker và không cần thực hiện thêm các bước Qpidupgrade.

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 giao diện người dùng Edge

Để cập nhật thành phần giao diện người dùng Edge, hãy cân nhắc phiên bản Edge cho Đám mây riêng mà bạn đang nâng cấp:

Từ 4.51.00 đến 4.52.00 (đã cài đặt giao diện người dùng Edge mới): Sử dụng hướng dẫn nâng cấp trong phần này cho thành phần edge-management-ui.

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:

Quay lại bản cập nhật trước

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

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

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

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

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

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

Nếu bạn 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.

Để nâng cấp mà không bị gián đoạn, bạn cần xoá từng Bộ định tuyến khỏi bộ cân bằng tải, mỗi lần xoá một Bộ định tuyến. Sau đó, hãy 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 bộ 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 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).
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.
Đảm bảo Bộ định tuyến có thể truy cập được.
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 – thực hiện những việc sau:
  1. Làm cho Bộ định tuyến không thể truy cập được.
  2. Khiến Trình xử lý thông báo không thể truy cập được.
- Sau khi cập nhật – thực hiện các bước sau:
  1. Đảm bảo Message Processor 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 Router đơn:
- Trước khi cập nhật, hãy khiến Bộ định tuyến không thể truy cập.
- 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 bạn đã dùng để cài đặt Edge 4.50.00 hoặc 4.51.00.

Cập nhật lên phiên bản 4.52.02 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 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.
Đă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.
LƯU Ý: Mặc dù việc 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.
Cài đặt yum-utils và yum-plugin-priorities:
Lưu ý: Nếu hệ điều hành của bạn là RHEL 8.0 – 8.6, hãy bỏ qua bước này.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup Edge.
Nếu bạn đang cài đặt trên Oracle 7.x, hãy thực thi lệnh sau:
```
sudo yum-config-manager --enable ol7_optional_latest
```

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

Nếu bạn đang dùng Edge 4.51.00:
1. Tải tệp bootstrap_4.52.02.sh Edge xuống /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge 4.52.02 bằng cách thực thi lệnh sau:
```
sudo bash /tmp/bootstrap_4.52.02.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.50.00 hoặc 4.51.00.
  Bạn có thể chạy update.sh trên tất cả các thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có một hồ sơ cài đặt Edge tất cả trong một (AIO). Ví dụ:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Khởi động lại các thành phần giao diện người dùng Edge trên tất cả các nút đang chạy các thành phần đó (nếu bạn chưa làm):
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Kiểm thử bản cập nhật bằng cách chạy tiện ích apigee-validate trên Máy chủ quản lý, như mô tả trong phần Kiểm thử quá trình cài đặt.

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

Cập nhật lên 4.52.02 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, 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.#heading

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.52.02 cục bộ:

Tạo một kho lưu trữ 4.52.02 cục bộ như mô tả trong phần "Tạo một 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ữ, bạn có thể thêm kho lưu trữ 4.52.02 vào đó 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á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.52.02.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 này 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.52.02.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.52.02.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.
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.52.02.sh Edge xuống /tmp/bootstrap_4.52.02.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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.52.02.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ư ví dụ sau đây minh hoạ:
```
/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. 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 Edge mới
  - ui: Giao diện người dùng Edge cổ điển
  - zk: Zookeeper
- configFile là tệp cấu hình mà bạn đã dùng để xác định các thành phần Edge trong quá trình cài đặt 4.50.00 hoặc 4.51.00.
  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 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
```
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
```
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.52.02.

Thứ tự cập nhật máy – nâng cấp từ 4.51.00 (hoặc) 4.52.00 (hoặc) 4.52.01

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 ZooKeeper trên các trung tâm dữ liệu trước khi nâng cấp tất cả các thành phần khác. Nếu đang nâng cấp từ Edge Private Cloud 4.51.00 (hoặc) 4.52.00, bạn cũng cần làm theo các bước bổ sung để nâng cấp zookeeper.
Bạn phải cập nhật Postgresql trên tất cả các trung tâm dữ liệu. Nếu đang nâng cấp từ Edge Private Cloud 4.51.00, bạn cũng cần làm theo các bước bổ sung để nâng cấp postgres.
Bạn phải cập nhật các nút LDAP trên tất cả các trung tâm dữ liệu.
Bạn phải cập nhật tất cả các nút Cassandra, Máy chủ quản lý, Trình xử lý thông báo và Bộ định tuyến, mỗi lần một trung tâm dữ liệu, cho đến khi tất cả các trung tâm dữ liệu được nâng cấp.
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 các nút Qpid trên tất cả các trung tâm dữ liệu. Nếu đang nâng cấp từ Edge Private Cloud 4.51.00 (hoặc) 4.52.00, bạn cũng cần làm theo các bước bổ sung để nâng cấp Qpid.
Cập nhật giao diện người dùng Edge và giao diện người dùng Edge mới, các nút SSO trên tất cả trung tâm dữ liệu.
Bạn không cần thực hiện một 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.
Lưu ý: Sau khi cập nhật thành phần giao diện người dùng Edge, bạn phải khởi động lại dịch vụ giao diện người dùng Edge như mô tả trong hướng dẫn cài đặt bản cập nhật.

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

Cập nhật tất cả cá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) 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.

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

/opt/apigee/apigee-setup/bin/update.sh -c zk -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 LDAP trên máy 1:

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

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

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

Cập nhật các thành phần Edge trên máy 1 và 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 giao diện người dùng trên máy 1:

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

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

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

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

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

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

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

/opt/apigee/apigee-setup/bin/update.sh -c ps -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 Cassandra trên các máy 1, 2 và 3:

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

Cập nhật các thành phần Edge trên máy 1, 2, 3, 4, 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

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

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

Cập nhật giao diện người dùng của 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
```
(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
```
(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.
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.

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

/opt/apigee/apigee-setup/bin/update.sh -c zk -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 LDAP trên máy 1:

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

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

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

Cập nhật các thành phần Edge trên máy 1, 4, 5, 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 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
```
(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
```
(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.
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.

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

/opt/apigee/apigee-setup/bin/update.sh -c zk -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 LDAP trên máy 4 và 5:

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

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

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

Cập nhật các thành phần Edge trên máy 6, 7, 10, 11, 12, 13, 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 12 và 13:

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

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

Cập nhật ZooKeeper trên các máy 1,2,3,7,8,9 ở cả hai DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
```
Cập nhật Postgres trên các máy 6,12 ở cả hai DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```

Cập nhật LDAP trên máy 1,7 ở cả hai DC:

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

Chặn lưu lượng truy cập trong DC-1 và đảm bảo tất cả lưu lượng truy cập được chuyển hướng đến DC-2 khác

Cập nhật Cassandra trên máy 1,2,3 trong DC-1:

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

Cập nhật Máy chủ quản lý trên máy 1 trong DC-1:

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

Cập nhật Bộ định tuyến, Trình xử lý thông báo trên máy 2,3 trong DC-1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Huỷ chặn lưu lượng truy cập trong DC-1 và xác thực DC-1, sau đó tiếp tục với DC-2 bằng cách chặn lưu lượng truy cập trong DC-2 và định tuyến lại lưu lượng truy cập đến DC-1

Cập nhật Cassandra trên máy 7,8,9 trong DC-2:

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

Cập nhật Máy chủ quản lý trên máy 7 trong DC-2:

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

Cập nhật Bộ định tuyến, Bộ xử lý tin nhắn trên máy 8,9 trong DC-2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Bỏ chặn lưu lượng truy cập trong DC-2 và giờ đây, cả hai DC sẽ xử lý lưu lượng truy cập
Chạy lại lệnh cập nhật trong tất cả máy chủ quản lý trên các trung tâm dữ liệu trên máy 1 và 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Cập nhật edge-qpid-server và edge-postgres-server trên máy 4,5,6,10,11,12 ở cả hai DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Cập nhật Qpid trên máy 4,5,10,11 ở cả hai DC:

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

Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cũ (ui) trong cả hai DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
```
(Nếu bạn đã cài đặt apigee-adminapi) Cập nhật apigee-adminapi ở cả hai DC:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Nếu bạn đã cài đặt Apigee SSO) Cập nhật các nút Apigee SSO ở cả hai DC:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
```
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) ở cả hai DC:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```