Cập nhật Apigee Edge 4.16.01/4.16.05 lên 4.17.09

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

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

1. Đảm bảo Postgres đang chạy:
   > /opt/apigee/apigee-service/bin/apigee-all status
   
   Nếu Postgres không chạy, hãy khởi động:
   > /opt/apigee/apigee-service/bin/apigee-all start
2. 1 – 1 1 . 1 – 1 1 1. – 1 – 1. cURL ( cURL - cURL - cURL ( cURL - cURL - cURL ( :
   :
   > curl -u
   
   
   
3. Dừng nút dự phòng mới bằng cách chạy lệnh sau trên nút dự phòng mới:
   > /opt/apigee/apigee-service/bin/apigee-all stop
4. Trên nút chính Postgres, hãy chỉnh sửa /opt/apigee/customer/application/postgresql.properties để xoá nút dự phòng mới khỏi conf_pg_hba_replication.connection:
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
5. Khởi động lại apigee-postgresql trên máy chủ Postgres:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
6. Xác minh rằng nút dự phòng mới đã bị xoá bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên máy chủ chính. Bạn chỉ nên thấy dòng sau trong tệp đó:
   host replication apigee existing_slave_ip/32 trust
7. Xoá 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 trên nút Máy chủ quản lý:
   > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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 thời gian ngừng hoạt động bằng 0 với cấu hình từ 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ả bên dưới 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 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 hiển thị Bộ định tuyến và Trình xử lý thư 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 bản cài đặt của bạn.

Hãy xử lý những vấn đề sau trước/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 một nút Bộ định tuyến:
  • Trước khi cập nhật, hãy không kết nối được với Bộ định tuyến.
  • Sau khi cập nhật, hãy đảm bảo bạn có thể truy cập vào Bộ định tuyến.
• Trên một nút Bộ xử lý thông báo:
  • Trước khi cập nhật, hãy khiến Trình xử lý thông báo không thể truy cập được.
  • Sau khi cập nhật, hãy kết nối với Trình xử lý tin nhắn.

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 bạn đã dùng để cài đặt Edge 4.16.01 hoặc 4.16.05.

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

Sử dụng quy trình sau để cập nhật các thành phần Edge trên một nút:

1. Nếu bạn hiện đang sử dụng tính năng sao chép chính-chờ của Postgres, hãy cài đặt một nút chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chờ Postgres mới.
2. 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.
3. Đă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.
   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.
4. Cài đặt yum-utils và yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
5. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập Edge apigee.
6. Bật kho lưu trữ EPEL như mô tả ở trên.
7. Nếu bạn đang cài đặt trên AWS, hãy chạy lệnh yum-configure-manager sau:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
8. Tải tệp bootstrap_4.17.09.sh của Edge 4.17.09 xuống /tmp/bootstrap_4.17.09.sh:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
9. Cài đặt tiện ích và các phần phụ thuộc apigee-service của Edge 4.17.09:
   > sudo bash /tmp/bootstrap_4.17.09.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 từ đó.
   
   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 không, ứng dụng 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.
10. Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
    1. Nếu đã cài đặt 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt utility apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
       
       Command này sẽ cài đặt utility update.sh trong /opt/apigee/apigee-setup/bin.
       
       Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật tiện ích đó:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Nếu đã cài đặt trực tiếp 4.16.01, tức là bạn không nâng cấp từ phiên bản 4.15.07.0x, thì bạn phải cập nhật tiện ích apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       Bản cập nhật này cho apigee-service sẽ cài đặt tiện ích update.sh trong /opt/apigee/apigee-setup/bin.
    3. Nếu đã cài đặt trực tiếp hoặc bằng bản cập nhật 4.16.05, bạn phải cập nhật tiện ích apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       Bản cập nhật này cho apigee-service sẽ cài đặt tiện ích update.sh trong /opt/apigee/apigee-setup/bin.
11. Tuỳ thuộc vào phiên bản Edge hiện tại, bạn phải cài đặt hoặc cập nhật tiện ích apigee-validate trên Máy chủ quản lý.
    1. Nếu bạn đang sử dụng Edge 4.16.05: hãy cập nhật tiện ích apigee-validate trên máy chủ quản lý:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Nếu bạn đang sử dụng Edge 4.16.01: hãy cài đặt tiện ích apigee-validate trên máy chủ quản lý:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
       
       Lưu ý: Nếu đã cài đặt tiện ích apigee-validate trên một nút Trình xử lý thông báo khi cài đặt 4.16.01, bạn có thể cập nhật tiện ích đó bằng cách sử dụng lệnh sau trên nút đó:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
       
       Tuy nhiên, kể từ phiên bản 4.16.05 trở lên, Apigee khuyên bạn nên cài đặt và chạy tiện ích apigee-validate trên máy chủ quản lý.
    3. Nếu bạn đang nâng cấp từ phiên bản 4.16.01: Hãy chỉnh sửa tệp cấu hình được chuyển vào tiện ích apigee-validate. Trong bản phát hành Edge 4.16.01, tệp cấu hình mà apigee-validate sử dụng yêu cầu các thuộc tính sau:
       APIGEE_ADMINPW=sysAdminPword
       MP_POD=gateway
       REGION=dc-1
       
       Trong bản phát hành này, tệp cấu hình chỉ yêu cầu thuộc tính APIGEE_ADMINPW. Bạn có thể xoá hai thuộc tính còn lại khỏi tệp.
12. Cập nhật phần mềm tiện ích apigee-PROV (cung cấp):
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mission cập nhật
13. Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả bên dưới trong phần "Thứ tự cập nhật máy":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    Yêu cầu duy nhất đối với tệp cấu hình là người dùng "apigee" phải có thể truy cập hoặc đọc tệp cấu hình.
    
    Hãy sử dụng tuỳ chọn "-c" để chỉ định thành phần cần cập nhật. Danh sách bao gồm:
    ldap = OpenLDAP
    
    
    
    
    
    
    
    
    
    
    
14. 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.
15. Nếu bạn đã cài đặt một nút dự phòng Postgres mới, hãy ngừng sử dụng nút đó như mô tả ở trên trong phần Ngừng sử dụng nút Postgres.

Để khôi phục bản cập nhật sau này, hãy làm theo quy trình được mô tả trong Quy trình khôi phục 4.17.09.

Quy trình cập nhật lên phiên bản 4.17.09 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ể 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 cách để 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 bằng repo cục bộ để các nút khác có thể truy cập vào đó. 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.17.09 cục bộ:

1. Nếu bạn hiện đang sử dụng tính năng sao chép chính-chờ của Postgres, hãy cài đặt một nút chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chờ Postgres mới.
2. Tạo một kho lưu trữ 4.17.09 cục bộ như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại phần Cài đặt tiện ích thiết lập apigee-setup của Edge.
   Lưu ý: Nếu đã có kho lưu trữ 4.16.01 hoặc 4.16.05, bạn có thể thêm kho lưu trữ 4.17.09 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 của Edge.
3. Cách cài đặt dịch vụ apigee 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 /opt/apigee/data/apigee-mirror/apigee-4.17.09.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.17.09.tar.gz
      
      Lệnh này sẽ tạo một thư mục mới có tên là repos trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.
   4. Cài đặt tiện ích dịch vụ apigee và các phần phụ thuộc của Edge từ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      Lưu ý rằng bạn phải thêm đường dẫn đến thư mục repos trong lệnh này.
4. 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.17.09.sh của Edge xuống /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      
      trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt ở trên 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 và phần phụ thuộc dịch vụ apigee của Edge:
      > sudo bash /tmp/bootstrap_4.17.09.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ữ.
5. Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
   1. Nếu đã cài đặt 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt utility apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      Lệnh này sẽ cài đặt utility update.sh trong /opt/apigee/apigee-setup/bin.
      
      Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật tiện ích đó:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. Nếu đã cài đặt trực tiếp phiên bản 4.16.01, nghĩa là bạn không nâng cấp từ phiên bản 4.15.07.0x, bạn phải cập nhật tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
      
      Bản cập nhật này sẽ cài đặt apigee-setup/apigee-service.
   3. Nếu đã cài đặt trực tiếp hoặc bằng bản cập nhật 4.16.05, bạn phải cập nhật tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
      
      Bản cập nhật này của apigee-service sẽ cài đặt tiện ích update.sh trong /opt/apigee-setup
6. Tuỳ thuộc vào phiên bản Edge hiện tại của bạn, bạn phải cài đặt hoặc cập nhật tiện ích apigee-validate trên Máy chủ quản lý.
   1. Nếu bạn đang sử dụng Edge 4.16.05: hãy cập nhật tiện ích apigee-validate trên máy chủ quản lý:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
   2. Nếu bạn đang sử dụng Edge 4.16.01: hãy cài đặt tiện ích apigee-validate trên Máy chủ quản lý:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      Lưu ý: Nếu đã cài đặt tiện ích apigee-validate trên nút Trình xử lý thông báo khi cài đặt 4.16.01, bạn có thể cập nhật tiện ích đó bằng cách sử dụng lệnh sau trên nút đó:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      
      Tuy nhiên, kể từ phiên bản 4.16.05 trở lên, Apigee khuyên bạn nên cài đặt và chạy tiện ích apigee-validate trên Máy chủ quản lý.
   3. Nếu bạn đang nâng cấp từ phiên bản 4.16.01: Chỉnh sửa tệp cấu hình được truyền đến tiện ích apigee-validate. Trong bản phát hành Edge 4.16.01, tệp cấu hình mà apigee-validate sử dụng yêu cầu các thuộc tính sau:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      Trong bản phát hành này, tệp cấu hình chỉ yêu cầu thuộc tính APIGEE_ADMINPW. Bạn có thể xoá hai thuộc tính còn lại khỏi tệp.
7. Cập nhật phần mềm tiện ích apigee-PROV (cung cấp):
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mission cập nhật
8. Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả bên dưới trong phần "Thứ tự cập nhật máy":
   > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   Yêu cầu duy nhất đối với tệp cấu hình là người dùng "apigee" phải có thể truy cập hoặc đọc tệp cấu hình.
   
   Sử dụng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các thành phần có thể bao gồm:
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   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, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
   ui = Giao diện người dùng Edge
   all = cập nhật tất cả thành phần trên máy (chỉ sử dụng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
   e = ElasticSearch
   b = API BaaS Stack
   p = API BaaS Portal
   ebp = ElasticSearch, API BaaS Stack và API BaaS Portal trên cùng một nút
9. Kiểm tra bản cập nhật bằng cách chạy tiện ích xác thực apigee trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.
10. Nếu bạn đã cài đặt một nút dự phòng Postgres mới, hãy ngừng sử dụng nút đó như mô tả ở trên trong phần Ngừng sử dụng nút Postgres.

Để khôi phục bản cập nhật sau này, hãy sử dụng quy trình được mô tả trong phần Quy trình khôi phục 4.17.09.

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. Những điểm quan trọng nhất cần cân nhắc khi cập nhật là:

• 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ý, Bộ xử lý thư, Bộ định tuyến, Máy chủ QPID chứ 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 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.
• Bạn cần thực hiện một bước riêng để cập nhật tính năng Kiếm tiền. Giá trị này được cập nhật khi bạn chỉ định tuỳ chọn "-c edge".

Đối với yêu cầu cài đặt độc lập gồm 1 máy chủ lưu trữ

1. Đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
   SMTPmailFROM="Công ty của tôi <myco@company.com>"
2. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper:
   > yum downgrade apigee-zookeeper
3. Cập nhật Cassandra và ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. Đặt quy tắc iptables sau:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
5. Kiểm tra hàng đợi thông báo Qpid:
   > qpid-stat -q
   
   Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi Qpid xử lý xong tất cả thông báo.
6. Cập nhật qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. Xoá các iptables:
   > sudo iptables -F
8. Cập nhật LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. Dừng máy chủ Postgres, máy chủ Qpid và PostgreSQL:
   > /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
   > /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng sql/apigee-ee
   
10. Cập nhật postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
11. Cập nhật cơ sở dữ liệu Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
12. Cập nhật các thành phần Edge còn lại:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. Cập nhật giao diện người dùng Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Đối với yêu cầu cài đặt độc lập gồm 2 máy chủ lưu trữ

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

1. Đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Tham số này có dạng:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên máy 1:
   > yum downgrade apigee-zookeeper
3. Cập nhật Cassandra và ZooKeeper trên máy 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. Đặt quy tắc iptables sau đây trên máy 2:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
5. Kiểm tra hàng đợi tin nhắn Qpid trên máy 2:
   > qpid-stat -q
   
   Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả thông báo.
6. Cập nhật qpidd trên máy 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. Xoá sạch iptables trên máy 2:
   > sudo iptables -F
8. Cập nhật Giao thức truy cập thư mục hạng nhẹ (LDAP) trên máy 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. Cập nhật các thành phần Edge trên máy 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. 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
11. Cập nhật postgresql trên máy 2:
    1. Dừng máy chủ Postgres, máy chủ Qpid và postgresql:
       > /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
       > /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng
       >post/opt/apiee-apigee/apigee/apigee dừng
    2. Cập nhật postgresql:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Cập nhật cơ sở dữ liệu Postgres:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Cập nhật các thành phần Edge trên máy 2 và máy 1:
       > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. Cập nhật các thành phần Edge trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Đối với một cài đặt cụm 5 máy chủ

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

1. Đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Tham số này có dạng:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Đảm bảo rằng bạn đã cài đặt một nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt nút dự phòng Postgres mới.
3. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3:
   > yum hạ cấp apigee-zookeeper
4. 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
5. Đặt quy tắc iptables sau đây trên máy 4:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `tên máy chủ` -i eth0 -j DROP
6. Kiểm tra hàng đợi tin nhắn Qpid trên máy 4:
   > qpid-stat -q
   
   Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi Qpid xử lý xong tất cả thông báo.
7. Cập nhật qpidd trên máy 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. Xoá sạch iptables trên máy 4:
   > sudo iptables -F
9. Lặp lại các bước từ 5 đến 8 trên máy 5.
10. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. Cập nhật các thành phần Edge trên máy 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. 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
13. Cập nhật máy 4 và 5:
    1. Dừng máy chủ Postgres và máy chủ Qpid trên máy 4:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Dừng máy chủ Postgres, máy chủ Qpid và postgresql trên máy 5:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Dừng máy chủ Postgres và postgresql trên nút dự phòng mới mà bạn đã thêm để rollback:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Cập nhật postgresql trên máy 4:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Cập nhật cơ sở dữ liệu Postgres trên máy 4 (chỉ dành cho máy chủ Postgres):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Cập nhật postgresql trên máy 5:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Khởi động máy chủ Postgres và máy chủ Qpid trên máy 4 và 5:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. Định cấu hình Postgres làm nút dự phòng bằng cách chạy các lệnh sau trên máy 5:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống sẽ hiển thị kết quả giống hệt nhau trên cả hai máy chủ để đảm bảo quá trình sao chép thành công:
       
       Trên máy 4, nút chính, hãy chạy:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       Xác thực rằng đó là nút chính.
       
       Trên máy 5, nút dự phòng:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       Xác thực rằng đó là nút dự phòng.
14. Cập nhật các thành phần Edge trên máy 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. Hãy đảm bảo rằng bạn ngừng hoạt động nút dự phòng mới bằng cách sử dụng quy trình ở trên trong phần Ngừng hoạt động nút Postgres.

Đối với quá trình cài đặt theo cụm 9 máy chủ lưu trữ

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

1. Đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Tham số này có dạng:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Đảm bảo rằng bạn đã cài đặt một nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt nút dự phòng Postgres mới.
3. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên máy 1, 2 và 3:
   > yum downgrade apigee-zookeeper
4. 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
5. Đặt quy tắc iptables sau trên máy 6:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. Kiểm tra hàng đợi thông báo Qpid trên máy 6:
   > qpid-stat -q
   
   Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả thông báo.
7. Cập nhật qpidd trên máy 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. Xoá sạch iptables trên máy 6:
   > sudo iptables -F
9. Lặp lại các bước từ 5 đến 8 trên máy 7.
10. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. Cập nhật các thành phần Edge trên máy 6, 7, 1, 4 và 5 theo thứ tự đó:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. 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
13. Cập nhật máy 8 và 9:
    1. Dừng máy chủ Postgres trên máy 8:
       > /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
    2. Dừng máy chủ Postgres và postgresql trên máy 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Dừng máy chủ Qpid trên máy 6 và 7:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Dừng máy chủ Postgres và postgresql trên nút dự phòng mới mà bạn đã thêm để rollback:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Cập nhật postgresql trên máy 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Cập nhật cơ sở dữ liệu Postgres trên máy 8 (chỉ dành cho máy chủ Postgres):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Cập nhật postgresql trên máy 9:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Khởi động máy chủ Postgres trên máy 8 và 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Khởi động máy chủ Qpid trên máy 6 và 7:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Định cấu hình Postgres làm nút dự phòng bằng cách chạy các lệnh sau trên máy 9:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống sẽ hiển thị kết quả giống hệt nhau trên cả hai máy chủ để đảm bảo quá trình sao chép thành công:
        Trên máy 8, nút chính, hãy chạy:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        Xác thực rằng đó là nút chính.
        
        Trên máy 9, nút dự phòng:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        Xác thực rằng đó là nút dự phòng.
14. Cập nhật các thành phần Edge trên máy 8 và 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. Hãy đảm bảo rằng bạn ngừng hoạt động nút dự phòng mới bằng cách sử dụng quy trình ở trên trong phần Ngừng hoạt động nút Postgres.

Đối với một cài đặt cụm 13 máy chủ

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