Trang này được dịch bởi Cloud Translation API.

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

Apigee hỗ trợ nâng cấp trực tiếp Edge for Private Cloud từ phiên bản 4.50.00 hoặc phiên bản 4.51.00 lên phiên bản 4.52.00. Trang này mô tả cách nâng cấp.

Người có thể thực hiện quá trình 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 bản cập nhật gốc.

Sau khi bạn cài đặt Edge RPM, bất cứ ai cũng có thể định cấu hì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 chứa 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

Hãy đảm bảo những điều kiện tiên quyết sau đây trước khi nâng cấp Apigee:

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 để đảm bảo an toàn. Sử dụng quy trình cho phiên bản Edge hiện tại của bạn để sao lưu.
Điều này giúp bạn có một kế hoạch dự phòng trong trường hợp việc 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ề quá trình 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 đã được thiết lập và đang chạy trong quá trình cập nhật bằng cách dùng lệnh:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Đảm bảo rằng Chiến lược tổng hợp Cassandra là LeveledCompactionStrategy
Đảm bảo rằng chiến lược tương thích Cassandra được đặt thành LeveledCompactionStrategy, như mô tả trong phần Thay đổi chiến lược nén Cassandra.

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

Nếu bạn đã đặt thuộc tính 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 bản cập nhật giữ lại.

Bắt buộc nâng cấp lên Zookeeper 3.8.0

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

Trước khi nâng cấp Zookeeper, hãy đọc qua 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ê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 những cử tri tham gia cuộc bầu cử thủ lĩnh Zookeeper và các nút còn lại được định cấu hình làm trình quan sát. Hãy xem phần Giới thiệu về nhà lãnh đạo, người theo dõi, cử tri và người quan sát để biết thêm chi tiết. Các nút cử tri sẽ chọn một người lãnh đạo, sau đó các nút cử tri sẽ trở thành người theo dõi.

Trong quá trình cập nhật, có thể xảy ra sự cố trì hoãn tạm thời hoặc lỗi ghi vào Zookeeper khi nút lãnh đạo 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à thay đổi cơ sở hạ tầng của Apigee, chẳng hạn như thêm hoặc xoá trình xử lý tin nhắn, v.v. Không ảnh hưởng đến các API thời gian chạy của Apigee (trừ phi các API quản lý lệnh gọi API thời gian chạy này) trong quá trình nâng cấp Zookeeper trong khi làm theo quy trình dưới đây.

Ở cấp độ cao, quá trình nâng cấp bao gồm việc sao lưu từng nút. Tiếp theo là nâng cấp tất cả các đối tượng tiếp nhận dữ liệu và người theo dõi, cuối cùng là nâng cấp nút người lãnh đạo.

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 quá trình khôi phục sẽ khôi phục Zookeeper về trạng thái khi quá trình sao lưu được thực hiện. Lưu ý: Mọi thay đổi về cơ sở hạ tầng hoặc hoạt động triển khai trong Apigee kể từ khi bạn sao lưu (có thông tin được lưu trữ trong Zookeeper) sẽ bị mất trong quá trình khôi phục.

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

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

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

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

Nếu nó chưa được cài đặt trên nút ZooKeeper, hãy cài đặt nc:
```
  sudo yum install nc
```
Chạy lệnh nc sau đây 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.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
Trong dòng Mode của dữ liệu đầu ra cho các nút, bạn sẽ thấy đối tượng tiếp nhận dữ liệu, người lãnh đạo hoặc người theo dõi (có nghĩa là cử tri không phải là người lãnh đạo) tuỳ thuộc vào cấu hình nút. Lưu ý: Trong bản cài đặt Edge độc lập chỉ có một nút ZooKeeper, Mode sẽ được đặt thành độc lập.
Lặp lại các bước 1 và 2 trên mỗi nút ZooKeeper.

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

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

Tải xuống và chạy quá trình khởi động của Edge dành cho đám mây riêng tư 4.52, như mô tả trong Cập nhật lên phiên bản 4.52.00 trên một nút có kết nối Internet bên ngoài. Quá trình này có thể sẽ thay đổi 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 ngoại tuyến.
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 (như với cs,zk hồ sơ) hoặc bạn có thể 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 và đảm bảo cụm của bạn hoạt động bình thường 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 trên mỗi nút người quan sát và người theo dõi Zookeeper.

Tắt biến thể dẫn đầu

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

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

Lưu ý rằng trong sự kiện này, trước khi người lãnh đạo mới được bầu, có thể có sự chậm trễ tạm thời hoặc lỗi ghi trong Zookeeper. Điều này có thể ảnh hưởng đến các thao tác ghi vào Zookeeper, chẳng hạn như 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á trình xử lý thông báo, v.v.

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

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

Phiên bản dẫn đầu trong bản 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à người theo dõi ở trên.

Sau khi nút dẫn đầu cũ được nâng cấp, hãy xác minh tình trạng cụm và đảm bảo có nút dẫn đầu.

Khôi phục

Trong trường hợp cần khôi phục:

Thực hiện các bước khôi phục đối với đối tượng tiếp nhận dữ liệu và người theo dõi trước tiên.
Tải xuống và thực thi tự động khởi động của phiên bản bạn đang khôi phục – 4.50 hoặc 4.51. Quá 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 không hoặc bạn đang thực hiện quá trình cài đặt ngoại tuyến.

Dừng Zookeeper nếu nó đang chạy trên nút:

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

Gỡ cài đặt người trông giữ vườn thú hiện tại:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Cài đặt Zookeeper như bình thường:

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

Sau khi tất cả người theo dõi và người quan sát đã được khôi phục, khôi phục nút người dẫn đầu bằng cách làm theo các bước từ 2 đến 5 trên nút người lãnh đạo.

Sau khi tất cả các nút được hoàn nguyên, hãy xác minh tình trạng của cụm và đảm bảo có một nút dẫn đầu trong cụm.

Khôi phục bản sao lưu

Hãy tham khảo phần Khôi phục từ bản sao lưu. Xin lưu ý rằng các bản sao lưu của Zookeeper được lấy từ các phiên bản cũ của Edge cho Đám mây riêng tư (chẳng hạn như 4.50 và 4.51) phải tương thích với phiên bản Zookeeper trong Edge dành cho đám mây riêng tư 4.52.

Cần nâng cấp lên Postgres 14

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

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

Cách bạn thực hiện 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 nút Postgres, bạn phải cài đặt nút chờ 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ể gỡ bỏ nút chờ Postgres mới.
Bạn bắt buộc phải có nút chờ Postgres bổ sung nếu phải khôi phục bản cập nhật vì bất kỳ lý do gì. Nếu bạn phải khôi phục bản cập nhật, nút chờ Postgres mới sẽ trở thành nút Postgres chính sau khi khôi phục. Do đó, khi bạn cài đặt nút chờ Postgres mới, nút đó 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ư định nghĩa trong phần Yêu cầu cài đặt của Edge.

Trong cấu hình 1 nút và 2 nút của Edge, các cấu trúc liên kết dùng để tạo nguyên mẫu và kiểm thử, bạn chỉ có một nút Postgres duy nhất. Bạn có thể cập nhật trực tiếp các nút Postgres này mà không cần tạo một 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 phải cài đặt nút Postgres mới. Trong các quy trình dưới đây, bạn có thể bỏ qua các bước chỉ định để cài đặt và sau đó gỡ bỏ một nút chờ Postgres mới.
Trước khi bạn bắt đầu quá trình cập nhật, hãy chụp ảnh nhanh mạng của kho dữ liệu mà Postgres sử dụng. Sau đó, nếu có lỗi xảy ra trong quá trình cập nhật và bạn buộc phải khôi phục, thì bạn có thể khôi phục nút Postgres từ ảnh chụp nhanh đó.

Cài đặt nút chờ Postgres mới

Quy trình này sẽ tạo một máy chủ chờ Postgres trên một nút mới. Hãy đảm bảo rằng bạn cài đặt một máy chủ chờ Postgres mới cho phiên bản Edge hiện tại (4.50.00 hoặc 4.51.00) chứ không phải cho phiên bản 4.52.00.

Để 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 một nút chờ Postgres mới:

Trên bản chính Postgres hiện tại, hãy chỉnh sửa tệp /opt/apigee/customer/application/postgresql.properties để thiết lập 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ủ chờ Postgres hiện tại và new_standby_ip là địa chỉ IP của nút chờ mới.

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

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

Xác minh rằng nút chờ mới đã được thêm bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên 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ủ chờ 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 hiện tại của Edge để chỉ định những thông tin sau:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập apigee Edge.
3. Nếu bạn hiện đang sử dụng Edge 4.51.00:
  1. Tải tệp Edge khởi động 4.51.00.sh xuống /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Cài đặt tiện ích và các phần phụ thuộc của Edge apigee-service:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Nếu bạn hiện đang sử dụng Edge 4.50.00:
  1. Tải tệp Edge khởi động 4.50.00.sh xuống /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Cài đặt tiện ích và các phần phụ thuộc của Edge apigee-service:
```
sudo bash /tmp/bootstrap_4.50.00.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 chờ mới, hãy chạy lệnh sau:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Xác minh rằng thiết bị đang ở chế độ chờ.

Nâng cấp Postgres tại chỗ

Lưu ý: Bạn phải thực hiện bước sơ bộ sau đây trước khi nâng cấp Postgres tại chỗ.

Lưu ý: Với Postgres 14, tham số cấu hình Postgres wal_keep_segments không còn được hỗ trợ. Nếu đã thêm hoặc sửa đổi tham số Postgres này, thì bạn phải xoá nó trước khi nâng cấp Postgres. Cách làm như sau:

Mở tệp $APIGEE_ROOT/customer/application/postgresql.properties.
Xoá cấu hình liên quan đến wal_keep_segments.
Khởi động lại Postgres.

Bước sơ bộ

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

Nếu chưa có, hãy tạo tệp /opt/apigee/customer/application/postgresql.properties.

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

sudo 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 14, hãy làm theo các bước sau:

Nâng cấp các postgres trên máy chủ chính

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

Chạy lệnh thiết lập trên máy chủ lưu trữ chính:
```
apigee-service apigee-postgresql setup -f /opt/silent.conf
```
Chạy lệnh định cấu hình trên máy chủ lưu trữ 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 tài khoản chính:

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

Đảm bảo máy chủ lưu trữ chính đã khởi động:
```
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, thì bạn có thể bỏ qua bước này. update.sh sẽ cố gắng khởi động máy chủ dự phòng với cấu hình không chính xác. Nếu chế độ cài đặt Postgres được nâng cấp lên 14, bạn có thể bỏ qua lỗi.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Đảm bảo đã dừng chế độ chờ:
```
apigee-service apigee-postgresql stop
```

Xoá cấu hình chế độ chờ 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 /opt/silent.conf

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ủ lưu trữ chính và chế độ chờ. Dòng này đã được thêm ở bước sơ bộ.

Sau khi bạn hoàn tất quy trình này, chế độ chờ sẽ khởi động thành công.

Kích hoạt nút Postgres

Sau khi cập nhật xong, hãy gỡ bỏ nút chế độ chờ mới:

Đảm bảo Postgres đang chạy:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Nếu Postgres hiện không chạy, hãy khởi động ứng dụng này:
```
/opt/apigee/apigee-service/bin/apigee-all start
```
Lấy mã nhận dạng duy nhất (UUID) của nút chế độ chờ mới bằng cách chạy lệnh curl sau trên nút chế độ chờ 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 dữ liệu đầu ra, có dạng:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Dừng nút chế độ chờ mới bằng cách chạy lệnh sau trên nút chế độ chờ 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 chế độ chờ 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 bản chính Postgres:

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

Xác minh rằng nút chế độ chờ 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 sẽ chỉ thấy dòng sau trong tệp đó:
```
host replication apigee existing_standby_ip/32 trust
```
Xoá mã nhận dạng duy nhất (UUID) của nút chế độ chờ 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
```

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 mới của Edge dành cho đám mây riêng tư.

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, Apigee khuyên bạn nê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 for Private Cloud.

Xin lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt tính năng Xác thực cơ bản và dùng một IDP 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 mới của Edge.

Cập nhật giao diện người dùng của 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 tư mà bạn đang nâng cấp từ:

Từ 4.51.00 đến 4.52.00 (khi đã cài đặt giao diện người dùng Edge mới): Hãy 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 làm theo các bước sau:

Khôi phục bản cập nhật

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

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.

Thông tin cập nhật về việc ghi nhật ký

Theo mặc định, tiện ích update.sh 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 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 khi không ngừng hoạt động

Bản cập nhật không ngừng hoạt động hoặc bản cập nhật luân phiên cho phép bạn cập nhật cài đặt Edge mà không cần gỡ bỏ Edge.

Bạn chỉ có thể cập nhật chế độ không ngừng hoạt động khi có cấu hình 5 nút trở lên.

Điều quan trọng để nâng cấp thời gian ngừng hoạt động là xoá từng Bộ định tuyến 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 bộ cân bằng tải.

Cập nhật máy theo đúng thứ tự cài đặt như mô tả 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à thiết lập không cho bộ định tuyến đó truy cập, như mô tả trong phần Bật/tắt máy chủ (Bộ xử lý/Bộ định tuyến) của máy chủ.
Cập nhật Bộ định tuyến đã chọn và tất cả các thành phần khác của Edge 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 hiển thị Bộ định tuyến và Bộ xử lý tin nhắn trên cùng một nút.
Đặt Bộ định tuyến trở lại khả năng truy cập.
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 chú ý những vấn đề sau đây trước và sau khi cập nhật:

Trên bộ định tuyến kết hợp và nút Bộ xử lý tin nhắn:
- Trước khi cập nhật – hãy thực hiện các bước sau:
  1. Làm cho Bộ định tuyến không thể truy cập được.
  2. Làm cho Trình xử lý tin nhắn không thể truy cập được.
- Sau khi cập nhật – hãy thực hiện các thao tác sau:
  1. Đặt Trình xử lý thư có thể truy cập được.
  2. Đặt Bộ định tuyến ở chế độ có thể truy cập được.
Trên các nút Bộ định tuyến đơn:
- Trước khi cập nhật, hãy làm cho Bộ định tuyến không thể kết nối được.
- Sau khi cập nhật, hãy làm cho Bộ định tuyến có thể truy cập được.
Trên các nút Bộ xử lý thông báo đơn lẻ:
- Trước khi cập nhật, hãy làm cho Bộ xử lý tin nhắn không truy cập được.
- Sau khi cập nhật, hãy làm cho Bộ xử lý tin nhắn có thể truy cập được.

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 im lặng phải giống với tệp bạn đã sử 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.00 tại một nút có kết nối Internet bên ngoài

Hãy sử dụng 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 lệnh 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 dưới dạng thư mục gốc để cài đặt RPM của Edge.
LƯU Ý: Mặc dù việc cài đặt RPM yêu cầu quyền truy cập thư mục 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 thư mục 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 theo mô tả trong phần Cài đặt tiện ích thiết lập API 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 hiện đang sử dụng Edge 4.51.00:
1. Tải tệp Edge bootstrap_4.52.00.sh xuống /tmp/bootstrap_4.52.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Cài đặt tiện ích và các phần phụ thuộc apigee-service của Edge 4.52.00 bằng cách thực thi lệnh sau:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã đó.
  
  Theo mặc định, trình cài đặt sẽ kiểm tra xem bạn đã cài đặt Java 1.8 hay chưa. Nếu không, trình cài đặt sẽ cài đặt cho bạn.
  
  Sử dụng tuỳ chọn JAVA_FIX để chỉ định cách xử lý việc 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ài đặt Java.
  - Q: Thoát. Đối với tuỳ 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ư 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ư trong ví dụ sau đây:
```
/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ư trong ví dụ sau đây:
```
/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 việc này theo thứ tự 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ị sau đây có thể xuất hiện:
    - 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ý, Bộ xử lý thư, 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 dịch vụ SSO)
    - ue: Giao diện người dùng mới của Edge
    - ui: Giao diện người dùng Classic Edge
    - zk: Người giữ thú
  - configFile là tệp cấu hình mà bạn dùng để xác định các thành phần của 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ả thành phần bằng cách đặt component thành "all" (tất cả), nhưng chỉ khi bạn có hồ sơ cài đặt tất cả trong một (AIO) của Edge. Ví dụ:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Khởi động lại thành phần giao diện người dùng Edge 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-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ử bản cài đặt.
Nếu sau đó 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.52.00.

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

Nếu các nút Edge của bạn bị 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ể cập nhật qua kho lưu trữ cục bộ hoặc bản sao của kho lưu trữ Apigee.

Sau khi tạo một kho lưu trữ Edge cục bộ, bạn có hai lựa chọn để cập nhật Edge qua kho lưu trữ cục bộ:
- Tạo một 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 bằng 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 nút đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng hoặc bạn có thể dùng máy chủ web của riêng mình.
Để cập nhật từ một repo 4.52.00 cục bộ:
1. Tạo một kho lưu trữ 4.52.00 cục bộ như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" trong phần Cài đặt tiện ích thiết lập apigee Edge.
  LƯU Ý: Nếu đã có sẵn một kho lưu trữ, bạn có thể thêm kho lưu trữ 4.52.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 phần Cài đặt tiện ích thiết lập apigee Edge.
2. Cách cài đặt dịch vụ apigee qua 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ộ thành một tệp .tar duy nhất có tên là /opt/apigee/data/apigee-mirror/apigee-4.52.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 huỷ tải tệp vào thư mục /tmp:
```
tar -xzf apigee-4.52.00.tar.gz
```
    Lệnh này 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 và các phần phụ thuộc của Edge apigee-service qua /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Lưu ý rằng bạn đã thêm đường dẫn đến thư mục kho lưu trữ vào lệnh này.
3. Cách cài đặt dịch vụ apigee 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 apigee của Edge.
  2. Trên nút từ xa, hãy tải tệp Edge bootstrap_4.52.00.sh xuống /tmp/bootstrap_4.52.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.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, cài đặt tiện ích Edge apigee-setup và các phần phụ thuộc:
```
sudo bash /tmp/bootstrap_4.52.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 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 đây:
```
/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 đây:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Chạy tiện ích update trên các nút theo thứ tự được mô tả trong phần Thứ tự cập nhật máy:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Trong trường hợp:
  - component là thành phần Edge cần cập nhật. Bạn thường cập nhật các thành phần sau:
    - cs: Cassandra
    - edge: Tất cả thành phần Edge ngoại trừ giao diện người dùng Edge: 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
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (nếu bạn đã cài đặt dịch vụ SSO)
    - ue Giao diện người dùng mới của Edge
    - ui: Giao diện người dùng Classic Edge
    - zk: Người giữ thú
  - configFile cũng 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 phiên bản 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ả thành phần bằng cách đặt component thành "all" (tất cả), nhưng chỉ khi bạn có hồ sơ cài đặt tất cả trong một (AIO) của Edge. 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ử bản cài đặt.
Nếu sau đó 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.52.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 là rất quan trọng:
- Bạn phải cập nhật tất cả các nút Cassandra và ZooKeeper trước khi cập nhật bất kỳ nút nào khác.
- Đối với bất kỳ máy nào có nhiều thành phần Edge (Máy chủ quản lý, Trình xử lý thông báo, Bộ định tuyến, Máy chủ QPID nhưng không phải Máy chủ Postgres), hãy sử dụng 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 đã chỉ định.
- Chúng tôi không có bước riêng nào cho việc cập nhật tính năng Kiếm tiền. Thuộc tính này sẽ được cập nhật khi bạn chỉ định tuỳ 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 gồm 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.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 gồm 2 nút

Cập nhật các thành phần sau đây để 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ấu trúc liên kết và số nút của Edge.
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 Qpid và Postgres trên máy 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,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 giao diện người dùng trên máy 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (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
```
7. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee 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 bạn đã tạo khi cài đặt SSO.
8. 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
```
Bản nâng cấp 5 nút

Cập nhật các thành phần sau đây để 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ấu trúc liên kết và số nút của Edge.
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 Qpid và Postgres trên máy 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Cập nhật Qpid và Postgres trên máy 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, 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 giao diện người dùng Edge:
  - Giao diện người dùng cũ: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy cập nhật thành phần ui trên máy 1, như ví dụ sau cho thấy:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Giao diện người dùng mới của Edge: Nếu bạn đã cài đặt giao diện người dùng mới của Edge, 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
```
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 dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee 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 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:
  - 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 cho thấy:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Giao diện người dùng mới của Edge: Nếu bạn đã cài đặt giao diện người dùng mới của Edge, 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 theo nhóm gồm 9 nút

Cập nhật các thành phần sau đây để cài đặt theo cụ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ấu trúc liên kết và số nút của Edge.
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 Qpid trên máy 6 và 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Cập nhật Postgres trên máy 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Cập nhật Postgres trên máy 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Cập nhật LDAP trên máy 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. 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ự sau:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -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ũ (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 dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee 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 bạn đã tạo khi cài đặt SSO.
10. Khởi động lại thành phần giao diện người dùng:
  - Giao diện người dùng cũ: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như ví dụ sau cho thấy:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Giao diện người dùng mới của Edge: Nếu bạn đã cài đặt giao diện người dùng mới của Edge, 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 theo cụm 13 nút

Cập nhật các thành phần sau đây để cài đặt theo cụ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ấu trúc liên kết và số nút của Edge.
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 Qpid trên máy 12 và 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Cập nhật Postgres trên máy 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Cập nhật Postgres trên máy 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Cập nhật LDAP trên máy 4 và 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. 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ự sau:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -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ũ (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 dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee 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 bạn đã tạo khi cài đặt SSO.
10. Khởi động lại thành phần giao diện người dùng:
  - Giao diện người dùng cũ: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 6 và 7, như ví dụ sau cho thấy:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Giao diện người dùng mới của Edge: Nếu bạn đã cài đặt giao diện người dùng mới của Edge, 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 theo cụm 12 nút

Cập nhật các thành phần sau đây để cài đặt theo cụ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ấu trúc liên kết và số nút của Edge.
1. Cập nhật Cassandra và ZooKeeper:
  1. Trên các máy 1, 2 và 3 trong Trung tâm dữ liệu 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  2. Trên các máy 7, 8 và 9 trong Data Center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. 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
```
3. 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
```
4. 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
```
5. Cập nhật các thành phần của 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
```
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ũ (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 dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee:
  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
```
9. Khởi động lại giao diện người dùng Edge mới (edge-management-ui) hoặc thành phần giao diện người dùng Edge cổ điển (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. qpidd, ps
4. LDAP
5. Edge, nghĩa là cấu hình "-c Edge" trên tất cả các nút theo thứ tự: các nút có máy chủ Qpid, Edge Postgres Server, Management Server, Message Processor và Bộ định tuyến.
  LƯU Ý: Nếu một nút đã cài đặt cả máy chủ Qpid và Máy chủ Edge Postgres, hãy chạy bước hồ sơ "-c Edge".
6. Giao diện người dùng Edge (cũ hoặc mới)
7. apigee-adminapi
8. Dịch vụ Đăng nhập một lần (SSO) của Apigee
Sau khi bạn 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 đó.