Cập nhật Apigee Edge 4.17.0x lên 4.18.01

Edge cho đám mây riêng tư phiên bản 4.18.01

Bạn có thể cập nhật những phiên bản Edge nào lên 4.18.01

Bạn có thể cập nhật Apigee Edge phiên bản 4.17.0x bằng quy trình này.

Nếu có phiên bản Edge cũ hơn phiên bản 4.16.01, thì trước tiên, bạn phải di chuyển sang phiên bản 4.16.01.x rồi cập nhật lên phiên bản 4.18.01.

Người có thể thực hiện cập nhật

Người dùng chạy bản cập nhật phải là người dùng đã cài đặt Edge ban đầu hoặc người dùng chạy với tư cách là người dùng gốc.

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

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ả 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 của nhiều phiên bản.

Duy trì khả năng tương thích

Khi nâng cấp Apigee Edge cho đám mây riêng tư lên phiên bản 4.18.01, bạn phải đảm bảo rằng quá trình triển khai kết quả chỉ tham chiếu đến các thuộc tính được hỗ trợ trong tệp cấu hình.

Thuộc tính Thông tin vị trí Mô tả
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Xoá thuộc tính này khỏi tệp router.properties. Để đặt các tuỳ chọn thử lại trong phiên bản 4.18.01, hãy sử dụng các thuộc tính cấu hình máy chủ ảo.

Tự động áp dụng chế độ cài đặt tài sản

Nếu bạn đã đặt bất kỳ thuộc tính nào bằng cách chỉnh sửa tệp .properties trong /opt/apigee/customer/application, thì các giá trị này sẽ được giữ lại trong bản cập nhật.

Bắt buộc phải thêm tham số cấu hình SMTPMAILFROM

Edge 4.17.05 đã thêm một tham số bắt buộc mới vào tệp cấu hình được dùng khi bạn bật máy chủ SMTP. Nếu đang cập nhật từ phiên bản 4.17.01, thì bạn phải đặt SMTPMAILFROM trong tệp cấu hình khi bật máy chủ SMTP.

API BaaS phiên bản 4.17.09 cũng bổ sung tính năng hỗ trợ cho thuộc tính SMTPMAILFROM. Khi cập nhật API BaaS từ 4.17.01 hoặc 4.17.05, bạn phải đặt SMTPMAILFROM trong tệp cấu hình.

Tham số này có dạng:

SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

Cách bạn thực hiện bả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 các nút Postgres, bạn phải cài đặt một nút dự phòng Postgres mới trong suốt thời gian nâng cấp. Sau khi quá trình nâng cấp hoàn tất, bạn có thể ngừng hoạt động nút dự phòng Postgres mới.

    Bạn cần có thêm nút dự phòng Postgres 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, thì nút dự phòng 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 dự phòng Postgres mới, nút này phải nằm trên một nút đáp ứng tất cả các yêu cầu về phần cứng của máy chủ Postgres, như được xác định trong Yêu cầu cài đặt Edge.

    Trong quá trình cài đặt Edge trên 1 nút và 2 nút, các cấu trúc liên kết dùng để tạo nguyên mẫu và thử nghiệm, 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 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 cài đặt nút Postgres mới. Trong các quy trình bên dưới, bạn có thể bỏ qua các bước chỉ định cài đặt và sau đó ngừng hoạt động một nút dự phòng Postgres mới.

    Trước khi bắt đầu quá trình cập nhật, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Sau đó, nếu xảy ra lỗi trong quá trình cập nhật và bạn buộc phải khôi phục, bạn có thể khôi phục nút Postgres từ ảnh chụp nhanh đó.

Cài đặt một nút dự phòng Postgres mới

Quy trình này tạo một máy chủ dự phòng Postgres trên một nút mới. Đảm bảo rằng bạn cài đặt một máy chủ dự phòng Postgres mới cho phiên bản Edge hiện tại (4.17.0x), chứ không phải cho phiên bản 4.18.01.

Để cài đặt, hãy sử dụng cùng một 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 nút dự phòng Postgres mới:

  1. 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 để đặt mã thông báo sau: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust

    Trong đó, existing_slave_ip là địa chỉ IP của máy chủ dự phòng Postgres hiện tại và new_slave_ip là địa chỉ IP của nút dự phòng mới.

    Nếu tệp postgresql.properties không tồn tại, hãy tạo tệp đó và sử dụng chown để cấp cho người dùng apigee quyền truy cập vào tệp, như trong ví dụ sau:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. Khởi động lại apigee-postgresql trên bản chính Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Xác minh rằng nút dự phòng mới đã được thêm bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên nút chính. Bạn sẽ thấy các dòng sau trong tệp đó: 
    host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
  4. Cài đặt máy chủ dự phòng 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 Edge hiện tại để 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 như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
    3. Tải tệp bootstrap_4.17.0x.sh của Edge xuống (trong đó 4.17.0x là 4.17.01, 4.17.05, hoặc 4.17.09) vào /tmp/bootstrap_4.17.0x.sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Cài đặt tiện ích Edge apigee-service và các phần phụ thuộc: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
    5. Sử dụng apigee-service để cài đặt tiện ích apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Cài đặt Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Trên máy chủ dự phòng mới, hãy thực thi lệnh sau: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng trạng thái của cơ sở dữ liệu là dự phòng.

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 hoạt độ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. Lấy UUID của nút dự phòng mới bằng cách chạy lệnh cURL sau trên nút dự phòng 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 kết quả, dưới dạng:
    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  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 Postgres chính:
    > /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 nút 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 dự phòng 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_slave_uuid>

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

Hãy đảm bảo đá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ộ tất cả các nút vì lý do an toàn. Sử dụng quy trình cho phiên bản Edge hiện tại của bạn để thực hiệ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 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 phần 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ử lý bản cập nhật không thành công

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 chạy 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ừ nơi bạn dừng lại.

Nếu lỗi 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 4.18.01 Quy trình khôi phục để biết thêm thông tin.

Đang 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 dùng 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 dùng 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 gián đoạn

Bản cập nhật không gây gián đoạn hoặc bản cập nhật cuốn chiếu 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ần ngừng hoạt động khi có cấu hình 5 nút trở lên.

Chìa khoá để nâng cấp mà không cần ngừng hoạt động là xoá từng Bộ định tuyến, mỗi lần một bộ, khỏi bộ 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 trình cân bằng tải.

  1. Cập nhật các máy theo đúng thứ tự cho bản cài đặt của bạn như mô tả dưới đây 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 trạng thái không thể kết nối, như mô tả trong phần Bật/Tắt khả năng kết nối của máy chủ (Bộ 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ấu hình Edge đều cho thấy Bộ định tuyến và Bộ xử lý thông báo trên cùng một nút.
  4. Làm cho Bộ định tuyến có thể truy cập lại.
  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 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 làm như sau:
      1. Làm cho Bộ định tuyến không thể truy cập được.
      2. Làm cho Bộ xử lý thông báo không thể truy cập được.
    • Sau khi cập nhật, hãy làm như sau:
      1. Đảm bảo có thể kết nối với Bộ xử lý thông báo.
      2. Đặt Router ở nơi có thể truy cập được.
  • Trên một nút Bộ định tuyến:
    • Trước khi cập nhật, hãy đảm bảo không thể kết nối với Bộ định tuyến.
    • Sau khi cập nhật, hãy đảm bảo có thể kết nối với 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 đặt Bộ xử lý thông báo ở trạng thái không kết nối được.
    • Sau khi cập nhật, hãy đảm bảo có thể kết nối với Bộ xử lý thông báo.

Sử dụng tệp cấu hình tự động

Bạn phải truyền tệp cấu hình tự động đến lệnh cập nhật. Tệp cấu hình tự động phải giống với tệp bạn đã dùng để cài đặt Edge 4.17.0x.

Quy trình cập nhật lên phiên bản 4.18.01 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 bạn hiện đang sử dụng tính năng sao chép chính-dự phòng Postgres với bộ nhớ cục bộ, hãy cài đặt một nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt một nút dự phòng Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  2. Nếu có, hãy tắt mọi dịch vụ chạy ngầm theo thời gian định trước đượ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 Edge RPM.
    Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập thư mục gốc, nhưng bạn có thể định 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 như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
  6. Nếu bạn đang cài đặt trên Oracle 7.x, hãy chạy lệnh sau:
    > sudo yum-config-manager --enable ol7_optional_latest
  7. Nếu bạn đang cài đặt trên AWS, hãy chạy 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
  8. Tải tệp Edge 4.18.01 bootstrap_4.18.01.sh xuống /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  9. Cài đặt tiện ích apigee-service của Edge 4.18.01 và các phần phụ thuộc:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    trong đó uName:pWord là tên người dùng và mật khẩu bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mật khẩu.

    Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo bạn đã cài đặt Java 1.8. Nếu bạn chưa cài đặt, thì hệ thố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 sử dụng 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 lựa 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:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. 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
  12. Cập nhật tiện ích apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả dưới đây trong phần "Thứ tự cập nhật máy" bên dưới:
    > /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 truy cập hoặc đọ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ể có 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ỉ dùng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
    e = ElasticSearch
    b = Ngăn xếp API BaaS
    p = Cổng API BaaS
    ebp = ElasticSearch, Ngăn xếp API BaaS và Cổng API BaaS trên cùng một nút
  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ử bản 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 hoạt động nút đó như mô tả ở trên trong phần Ngừng hoạt động một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

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

Quy trình cập nhật lên phiên bản 4.18.01 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 một 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 kho lưu trữ đó. 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.18.01 cục bộ:

  1. Nếu bạn đang sử dụng tính năng sao chép chính-dự phòng của Postgres, hãy 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.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  2. Tạo kho lưu trữ 4.18.01 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 apigee-setup của Edge.
    Lưu ý: Nếu đã có kho lưu trữ 4.17.0x, bạn có thể thêm kho lưu trữ 4.18.01 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 Cài đặt tiện ích thiết lập apigee Edge.
  3. 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 có tên /opt/apigee/data/apigee-mirror/apigee-4.18.01.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 giải nén tệp vào thư mục /tmp:
      > tar -xzf apigee-4.18.01.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à phần phụ thuộc apigee-service của Edge từ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Lưu ý rằng bạn đưa đường dẫn đến thư mục repos vào 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 Cài đặt tiện ích apigee-setup của Edge.
    2. Trên nút từ xa, hãy tải tệp bootstrap_4.18.01.sh của Edge xuống /tmp/bootstrap_4.18.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

      trong đó uName:pWord là tên người dùng và mật khẩu bạn đặt ở trên cho kho lưu trữ, còn remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.
    3. Trên nút từ xa, hãy cài đặt tiện ích apigee-service của Edge và các phần phụ thuộc:
      > sudo bash /tmp/bootstrap_4.18.01.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:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. 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
  7. Cập nhật tiện ích apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả dưới đây trong phần "Thứ tự cập nhật máy" bên dưới:
    > /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 truy cập hoặc đọ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ể có 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ỉ dùng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
    e = ElasticSearch
    b = Ngăn xếp API BaaS
    p = Cổng API BaaS
    ebp = ElasticSearch, Ngăn xếp API BaaS và Cổng API BaaS trên cùng một nút
  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.
  10. Nếu bạn đã cài đặt một nút dự phòng Postgres mới, hãy ngừng hoạt động nút đó như mô tả ở trên trong phần Ngừng hoạt động nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

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

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

Thứ tự cập nhật các máy trong quá trình cài đặt Edge là 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 bất kỳ máy nào 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 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 tính năng Kiếm tiền. Tệp này sẽ được cập nhật khi bạn chỉ định tuỳ chọn "-c edge".

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

  1. Nếu bạn đang 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. Tham số này có dạng:
    SMTPMAILFROM="My Company <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:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Cập nhật LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Dừng Máy chủ Postgres, máy chủ Qpid và PostgreSQL:
    > /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
  6. Cập nhật postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Cập nhật cơ sở dữ liệu Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. 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 edge -f configFile
  9. 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 chế độ cài đặt độc lập 2 máy chủ

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 Edge và số nút.

  1. Nếu bạn đang 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. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -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. 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 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
    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:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Đối với bản cài đặt theo cụm 5 máy chủ

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 Edge và số nút.

  1. Nếu bạn đang 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. 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 một nút dự phòng Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. 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
  4. Cập nhật Qpid trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 1, 2, 3:
    > /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
  8. ??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. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút dự phòng mới mà bạn đã thêm để khôi phục:
      > /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ỉ Postgres chính):
      > /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 thông báo cho biết đây 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 nút này cho biết đây là nút dự phòng.
  9. 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
  10. Đả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 nêu trên trong phần Ngừng hoạt động một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với bản cài đặt theo cụm gồm 9 máy chủ lưu trữ

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 Edge và số nút.

  1. Nếu bạn đang 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. 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 một nút dự phòng Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. 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
  4. Cập nhật Qpid trên máy 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 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 trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. 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 edge-postgres-server stop
    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. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút dự phòng mới mà bạn đã thêm để khôi phục:
      > /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 nút này cho biết đây 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 nút này cho biết đây là nút dự phòng.
  9. 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
  10. Đả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 nêu trên trong phần Ngừng hoạt động một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với một bản cài đặt theo cụm gồm 13 máy chủ lưu trữ

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 Edge và số nút.

  1. Nếu bạn đang 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. 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 một nút dự phòng Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. 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
  4. Cập nhật Qpid trên máy 12 và 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 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 trên máy 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. 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 edge-postgres-server stop
    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 12 và 13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút dự phòng mới mà bạn đã thêm để khôi phục:
      > /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 12 và 13:
      > /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 nút này cho biết đây 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 nút này cho biết đây là nút dự phòng.
  9. 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??
  10. Đả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 nêu trên trong phần Ngừng hoạt động một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với bản cài đặt theo cụm gồm 12 máy chủ lưu trữ

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 Edge và số nút.

  1. Nếu bạn đang 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. 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 một nút dự phòng Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. 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
  4. 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.
  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 của Edge:
    1. Máy 4, 5, 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, 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
  8. ?Cập nhật máy 6 trong Trung tâm dữ liệu 1 và máy 12 trong Trung tâm dữ liệu 2:
    1. Dừng máy chủ Postgres trên máy 6:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Dừng máy chủ Postgres và postgresql trên máy 12:
      > /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 các máy 4, 5, 10 và 11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút dự phòng mới mà bạn đã thêm để khôi phục:
      > /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 6:
      > /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 6 (chỉ Postgres chính):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Cập nhật postgresql trên máy 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Khởi động máy chủ Postgres trên máy 6 và 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Khởi động máy chủ Qpid trên các máy 4, 5, 10 và 11:
      > /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 12:
      > 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 6 (nút chính), hãy chạy lệnh:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Xác thực rằng hệ thống cho biết đây là nút chính.

      Trên máy 12, nút dự phòng:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng nút này cho biết đây là nút dự phòng.
  9. Cập nhật các thành phần Edge trên máy 6 và 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Đả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 nêu trên trong phần Ngừng hoạt động một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không cần cài đặt nút mới. Xem phần Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với bản cài đặt API BaaS 7 máy chủ

  1. Đặt SMTPMAILFROM trong tệp cấu hình. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 Cổng API BaaS trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với một bản cài đặt API BaaS 10 máy chủ

  1. Đặt SMTPMAILFROM trong tệp cấu hình. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 API BaaS Stack trên máy 4, 5 và 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Cập nhật Cổng API BaaS 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 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 bạn đ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. Đặt SMTPMAILFROM trong tệp cấu hình. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 một trong hai trung tâm dữ liệu:

    Lưu ý: Tất cả các lệnh dưới đây đều đặt hệ số sao chép thành "3", cho biết ba nút Cassandra trong cụm. Sửa đổi giá trị này nếu cần cho quá trình cài đặt của bạn.
    1. Bắt đầu tiện ích cqlsh của Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Thực thi các lệnh CQL sau tại dấu nhắc "cqlsh>" để đặt mức sao chép cho không gian khoá Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Xem không gian khoá bằng cách sử dụng lệnh:
        cqlsh> select * from system.schema_keyspaces;
      7. Thoát cqlsh:
        cqlsh> exit
  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 API BaaS Stack 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 API BaaS Stack 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 Cổng 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 p -f configFile
  10. Cập nhật Cổng 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 p -f configFile
  11. Cập nhật giá trị không gian khoá BaaS. Các không gian khoá này phải được đặt để sao chép tại thời điểm cài đặt, nhưng không nhất thiết phải đặt tại thời điểm chạy. Việc xoá bản sao cũng giúp tiết kiệm bộ nhớ Cassandra.

    Bạn chỉ cần chạy bước này một lần trên bất kỳ máy chủ Cassandra nào trong một trong hai trung tâm dữ liệu:
    1. Bắt đầu tiện ích cqlsh của Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Thực thi các lệnh CQL sau để đặt mức sao chép cho không gian khoá Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Xem không gian khoá bằng lệnh:
        cqlsh> select * from system.schema_keyspaces;
      4. Thoát cqlsh:
        cqlsh> exit

Đối với quy trình cài đặt không theo tiêu chuẩn

Nếu bạn có một bản cài đặt không chuẩn, hãy cập nhật các thành phần của Edge theo thứ tự sau:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, 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, 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 hồ sơ "-c edge".
  6. Giao diện người dùng Edge
Cập nhật Apigee Edge 4.17.01/4.17.05 lên 4.17.09