Cập nhật Apigee Edge 4.17.01/4.17.05 lên 4.17.09

Để 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 Quy trình khôi phục 4.17.09.

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

Thứ tự cập nhật các máy trong một lần cài đặt Edge rất quan trọng. Những điểm quan trọng nhất cần cân nhắc đối với một bản cập nhật là:

• 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 những máy có nhiều thành phần Edge (Máy chủ quản lý, Bộ 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 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.
• Không có bước riêng biệt nào để cập nhật tính năng Kiếm tiền. Giá trị này sẽ được cập nhật khi bạn chỉ định tuỳ chọn "-c Edge".

Đối với việc cài đặt độc lập với 1 máy chủ

1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặ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. Cập nhật Cassandra và ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Cập nhật Qpid và Postgres:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Khởi động postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Cập nhật LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. Cập nhật các thành phần còn lại của Edge:
   > /opt/apigee/apigee-setup/bin/update.sh -c cạnh -f configFile
7. 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 quá trình cài đặt độc lập với 2 máy chủ

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

1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặ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. Cập nhật Cassandra và ZooKeeper trên máy 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Cập nhật Qpid và Postgres trên máy 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Khởi động postgresql trên máy 2:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
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 2 và 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
7. 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

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

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

1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặ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. 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
3. Cập nhật Qpid và Postgres trên máy 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Khởi động postgresql trên máy 4:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
5. Lặp lại các bước 3 và 4 trên máy 5.
6. Cập nhật LDAP trên máy 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 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
8. 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

Đối với việc cài đặt theo cụm 9 máy chủ

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

1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặ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. 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
3. Cập nhật Qpid và Postgres trên máy 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Khởi động postgresql trên máy 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
5. Lặp lại các bước 3 và 4 trên máy 7.
6. Cập nhật LDAP trên máy 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 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
8. 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

Đối với việc cài đặt theo nhóm gồm 13 máy chủ

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

1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặ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. 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
3. Cập nhật Qpid và Postgres trên máy 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Khởi động postgresql trên máy 12:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Lặp lại các bước 3 và 4 trên máy 13.
6. Cập nhật LDAP trên máy 4 và 5:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 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 cạnh -f configFile
8. Cập nhật giao diện người dùng trên máy 6 và 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Đối với việc cài đặt theo nhóm gồm 12 máy chủ

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

1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặ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. 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
3. 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. Lặp lại bước 1 trên máy 5.
   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. Lặp lại bước 1 trên máy 11.
4. Cập nhật postgresql:
   1. Máy 6 trong Trung tâm dữ liệu 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
   2. Máy 12 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
5. 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
6. 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
7. Cập nhật giao diện người dùng:
   1. Máy 1 trong Trung tâm dữ liệu 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. Máy 7 trong Trung tâm dữ liệu 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Đối với việc cài đặt API BaaS với 7 máy chủ

1. Thiết lập SMTPMAILFROM trong tệp cấu hình. Thông số này có dạng:
   SMTPMAILFROM="Công ty của tôi <myco@company.com>"
2. Cập nhật Cassandra trên máy 5, 6 và 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

3. Cập nhật ElasticSearch và API BaaS Stack trên máy 1, 2 và 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

4. Cập nhật API BaaS Cổng trên máy 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với lượt cài đặt API BaaS gồm 10 máy chủ

1. Thiết lập SMTPMAILFROM trong tệp cấu hình. Thông số này có dạng:
   SMTPMAILFROM="Công ty của tôi <myco@company.com>"
2. Cập nhật Cassandra trên máy 8, 9 và 10:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. Cập nhật ElasticSearch trên máy 1, 2 và 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
4. Cập nhật ngăn xếp API BaaS trên máy 4, 5 và 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. Cập nhật API BaaS Cổng trên máy 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với việc cài đặt API Baas cho hai trung tâm dữ liệu

Quy trình này yêu cầu bạn cập nhật các nút Cassandra trong cả hai trung tâm dữ liệu. Nếu đang chia sẻ các nút Cassandra đó với Edge, thì bạn thường cập nhật các nút đó trong quá trình cập nhật Edge.

1. Thiết lập SMTPMAILFROM trong tệp cấu hình. Thông số này có dạng:
   SMTPMAILFROM="Công ty của tôi <myco@company.com>"
2. Cập nhật không gian khoá Cassandra bằng hệ số sao chép chính xác cho hai trung tâm dữ liệu. Bạn chỉ phải chạy bước này một lần trên bất kỳ máy chủ Cassandra nào trong trung tâm dữ liệu:
   
   Lưu ý: Tất cả các lệnh bên dưới đều đặt hệ số nhân bản thành "3", cho biết có 3 nút Cassandra trong cụm. Hãy sửa đổi giá trị này nếu cần cho chế độ cài đặt của bạn.
   1. Khởi động tiện ích Cassandra cassah:
      > /opt/apigee/apigee-cassandra/bin/làm việc cassandraIP
   2. Thực thi các lệnh CQL sau đây tại lời nhắc "cpclsh>" để đặt mức sao chép cho không gian phím Cassandra:
      1. cqualsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cClsh> ALTER KEYSPACE "Apigee_Baas" WITH sao chép = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cClsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cpclsh> ALTER KEYSPACE "system_traces" WITH sao chép = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqualsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Xem các không gian phím bằng cách dùng lệnh:
         cpclsh> select * from system.schema_keyspaces;
      7. Thoát cquash:
         cqualsh> thoát
3. (Chỉ khi bạn không cập nhật Cassandra trong quá trình cập nhật Edge) Cập nhật các nút Cassandra trong trung tâm dữ liệu 1, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. (Chỉ khi bạn không cập nhật Cassandra trong quá trình cập nhật Edge) Cập nhật các nút Cassandra trong trung tâm dữ liệu 2, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
5. Cập nhật ElasticSearch trên các máy trong trung tâm dữ liệu 1, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. Cập nhật ElasticSearch trên các máy trong trung tâm dữ liệu 2, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
7. Cập nhật ngăn xếp API BaaS trên các máy trong trung tâm dữ liệu 1, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. Cập nhật ngăn xếp API BaaS trên các máy trong trung tâm dữ liệu 2, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. Cập nhật API BaaS Cổng trên các máy trong trung tâm dữ liệu 1, mỗi lần một máy:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. Cập nhật API BaaS Cổng trên các máy trong trung tâm dữ liệu 2, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
11. Cập nhật giá trị không gian khoá BaaS. Bạn phải thiết lập những không gian khoá này để nhân bản tại thời điểm cài đặt, nhưng không nhất thiết phải vào thời gian chạy. Việc xoá bản sao cũng giúp tiết kiệm bộ nhớ Cassandra.
    
    Bạn chỉ phải chạy bước này một lần trên mọi máy chủ Cassandra trong trung tâm dữ liệu:
    1. Khởi động phần mềm tiện ích Cassandra cpclsh:
       > /opt/apigee/apigee-cassandra/bin/cpclsh cassandraIP
    2. Thực thi các lệnh CQL sau đây để đặt cấp sao chép cho không gian phím Cassandra:
       1. cClsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
       2. cquash> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
       3. Xem các không gian phím bằng cách dùng lệnh:
          dư cuộc gọi để chọn * từ hệ thống.schema_keyspaces;
       4. Thoát cqualsh:
          pClsh> exit

Đối với trường hợp lắp đặt không theo tiêu chuẩn

Nếu bạn cài đặt không theo tiêu 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, có nghĩa là cấu hình "-c cạnh" trên tất cả các nút theo thứ tự: nút có máy chủ Qpid, máy chủ Postgres, Máy chủ quản lý, Bộ xử lý thông báo và Bộ định tuyến.
   Lưu ý: Nếu nút đã cài đặt cả máy chủ Qpid và máy chủ Postgres, hãy chạy bước cấu hình "-c Edge".
6. Giao diện người dùng Edge