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

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

Để biết thông tin tổng quan về các đường dẫn nâng cấp tương thích, hãy xem ma trận khả năng tương thích với 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 việc 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 dưới quyền quản trị.

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

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

Bạn phải cập nhật tất cả thành phần 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.

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

Hãy đả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 toàn bộ các nút vì lý do an toàn. Hãy sử dụng quy trình cho phiên bản Edge hiện tại để sao lưu.

  Điều này cho phép bạn có một 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 rằng Edge đang hoạt động 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ũ lên phiên bản 4.52.02 và hiện đang có kế hoạch nâng cấp lên phiên bản 4.53.00, hãy đảm bảo 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.52.02 trong phần Các bước sau khi nâng cấp. Nếu bạn không chắc liệu mình đã hoàn tất các bước này trong lần nâng cấp trước hay chưa, hãy hoàn tất lại các bước đó trước khi tiếp tục nâng cấp lên phiên bản 4.53.00.
• Yêu cầu về Python
  Đảm bảo rằng tất cả các nút, bao gồm cả nút Cassandra, đều đã cài đặt Python 3 trước khi thử nâng cấp.

Tự động truyền tải chế độ cài đặt cơ sở lưu trú

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ì các giá trị này sẽ được giữ lại trong bản cập nhật.

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

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

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

• Quy trình nâng cấp từ Cassandra 3.11.X lên Cassandra 4.0.X diễn ra suôn sẻ. Cassandra 4.0.X, được phát hành cùng với Edge for Private Cloud 4.53.00, tương thích với các thành phần thời gian chạy và quản lý của Private Cloud 4.52.02.
• Không thể khôi phục trực tiếp tại chỗ từ Cassandra 4.0.X về 3.11.X. Việc quay lại 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ể liên quan đến thời gian ngừng hoạt động và/hoặc mất dữ liệu. Bạn nên khắc phục sự cố và nâng cấp lên Cassandra 4.0.X thay vì quay lại phiên bản cũ.
• Bạn cần làm quen với các quy trình khôi phục trước khi thử nâng cấp. Bạn cần cân nhắc các sắc thái của việc khôi phục trong quá trình nâng cấp để đảm bảo có sẵn các đường dẫn khôi phục thích hợp.

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

Việc nâng cấp Cassandra từ phiên bản 3.11.X lên 4.0.X trong một trung tâm dữ liệu 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 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 có sẵn trong trung tâm dữ liệu mới trước khi bắt đầu nâng cấp. Điều này sẽ cho phép bạn khôi phục Cassandra mà không làm mất dữ liệu hoặc làm gián đoạn lưu lượng truy cập API. Bạn có thể ngừng sử dụng trung tâm dữ liệu bổ sung này sau khi quá trình nâng cấp hoàn tất hoặc khi đạt đến Điểm kiểm tra 2.

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 3.11.X. Tuy nhiên, phương pháp 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 for Private Cloud 4.52.02 giúp bạn linh hoạt hơn trong việc khôi phục trong quá trình nâng cấp lên Edge for Private Cloud 4.53.00.

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

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

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

Quy trình khôi phục dưới dạng quy trình hai điểm kiểm tra

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

Ví dụ:

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

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

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

• Toàn bộ cụm đang hoạt động và có đầy đủ chức năng với Cassandra 3.11.16.
• Chiến lược nén được đặt thành LeveledCompactionStrategy (đây là điều kiện tiên quyết để nâng cấp lên phiên bản 4.52.02).
• Tất cả các bước sau khi nâng cấp từ lần nâng cấp ban đầu lên Cassandra 3.11.16 trong quá trình nâng cấp lên phiên bản 4.52.02 đã hoàn tất. Nếu không, hãy chạy lại các bước này. Điều này chỉ áp dụng nếu bạn đã nâng cấp lên Private Cloud phiên bản 4.52.02 từ một phiên bản cũ.

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

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

1. Sao lưu Cassandra bằng Apigee.
2. Chụp ảnh nhanh máy ảo của các nút Cassandra (nếu có thể).
3. Đảm bảo rằng bạn có thể truy cập vào cổng 9042 từ 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, đến 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 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 (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. Bước này rất quan trọng để đảm bảo tính ổn định của trung tâm dữ liệu, trong đó Cassandra đã được nâng cấp lên phiên bản 4.0.X, trong khi các thành phần Apigee còn lại vẫn ở phiên bản 4.52.02.

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

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

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

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

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

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

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

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

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

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

Từng bước nâng cấp tất cả các nút Trình xử lý thông báo và Bộ định tuyến ở tất cả các khu vực:

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

Bước 5: Nâng cấp tất cả các thành phần còn lại của Edge for Private Cloud 4.53.00

Hãy nâng cấp từng nút edge-qpid-server và edge-postgres-server còn lại ở tất cả các khu vực.

Bước 6: Các bước sau khi nâng cấp

Chạy lần lượt lệnh sau trên từng nút Cassandra sau khi nâng cấp xong:

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

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

Phần này liệt kê các đ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.

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

Sau khi hoàn tất quá trình cài đặt ban đầu, bạn nên cài đặt Giao diện người dùng Edge. Đây là 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 Private Cloud.

Xin lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt phương thức 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 bài viết Cài đặt giao diện người dùng mới của Edge.

Cập nhật bằng Apigee mTLS

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

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

Quay lại 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ừ lần cập nhật gần đây nhất.

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

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

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

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

Nếu người chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích 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 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 (còn gọi là bản cập nhật lăn) 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ó thời gian ngừng hoạt động với cấu hình 5 nút trở lên.

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

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

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

• Trên nút Bộ định tuyến và Bộ xử lý thông báo kết hợp:
  • Trước khi cập nhật – hãy 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. Không thể kết nối với Trình xử lý thông báo.
  • Sau khi cập nhật – hãy thực hiện những việc sau:
    1. Đảm bảo có thể truy cập vào Trình xử lý thông báo.
    2. Đảm bảo có thể truy cập vào Bộ định tuyến.
• Trên các nút Trình định tuyến đơn:
  • 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ể 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 đặt Trình xử lý thông báo ở trạng thái không thể truy cập.
  • Sau khi cập nhật, hãy đảm bảo có thể truy cập vào Trình xử lý thông báo.

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

Bạn phải truyền tệp cấu hình im lặng vào lệnh cập nhật. Tệp cấu hình cài đặt âm thầm phải là tệp mà bạn đã dùng để cài đặt Edge for Private Cloud 4.52.02.

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

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

1. Nếu có, hãy 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.
2. Đă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 RPM Edge.
3. Tắt SELinux như mô tả trong phần Cài đặt tiện ích thiết lập apigee-setup của Edge.
4. Nếu bạn đang cài đặt trên AWS, hãy thực thi các lệnh yum-configure-manager sau:

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

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

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

Nếu các nút Edge của bạn nằm sau tường lửa hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet theo cách nào đó, thì bạn có thể thực hiện cập nhật 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áy chủ web trên nút có kho lưu trữ cục bộ để các nút khác có thể truy cập vào máy chủ đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng hoặc bạn có thể sử dụng máy chủ web của riêng mình.

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

1. Tạo một kho lưu trữ 4.53.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 thiết lập apigee-setup của Edge.
2. Cách cài đặt apigee-service từ tệp .tar:
   1. Trên nút có kho lưu trữ cục bộ, hãy sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar duy nhất có tên là /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz:

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

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

      tar -xzf apigee-4.53.00.tar.gz

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

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

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

      Lưu ý rằng bạn phải thêm đường dẫn đến thư mục kho lưu trữ trong lệnh này.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   Trong trường hợp:

   • component là thành phần Edge cần cập nhật. Thông thường, bạn sẽ cập nhật các thành phần sau:
     • cs: Cassandra
     • edge: Tất 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, Trình đị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 đã sử dụng để xác định các thành phần Edge trong quá trình cài đặt phiên bản 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 "tất cả", 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 /tmp/sa_silent_config

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Cập nhật các thành phần sau đây cho một cài đặt độc lập 2 nút:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Nâng cấp 5 nút

Cập nhật các thành phần sau đây cho một lượt cài đặt 5 nút:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      /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 đây cho một cài đặt cụm 9 nút:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      /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 đây cho một cài đặt cụm 13 nút:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      /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 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 đây cho một cài đặt cụm 12 nút:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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