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

Phần này mô tả cách nâng cấp từ Apigee Edge 4.19.06 hoặc 4.50.00 lên 4.51.00.

Người có thể thực hiện 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 với tư cách là người dùng gốc.

Sau khi bạn cài đặt RPM của Edge, bất kỳ ai cũng 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.

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 sau khi cập nhật.

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

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

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 sử dụ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 Postgres dự phòng 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 đó 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 cấu hình 1 nút và 2 nút của Edge, 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 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.19.06 hoặc 4.50.00), chứ không phải cho phiên bản 4.51.00.

Để 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. 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ủ dự phòng Postgres hiện tại và new_standby_ip là địa chỉ IP của nút dự phòng mới.

  2. Khởi động lại apigee-postgresql trên Postgres chính: 
    /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_standby_ip/32 trust
host replication apigee new_standby_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. Làm một trong những việc sau, tuỳ thuộc vào phiên bản Edge mà bạn đang nâng cấp:
      • Nếu bạn đang nâng cấp từ Edge 4.19.06, hãy tải tệp bootstrap_4.19.06.sh của Edge xuống /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Tiếp theo, hãy cài đặt tiện ích và phần phụ thuộc apigee-service của Edge: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Nếu bạn đang nâng cấp từ Edge 4.50.00, hãy tải tệp bootstrap_4.50.00.sh của Edge 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

        Tiếp theo, hãy cài đặt tiện ích và phần phụ thuộc apigee-service của Edge: 

        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 dự phòng mới, hãy chạy 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.

Thực hiện nâng cấp tại chỗ cho Postgres

Để thực hiện nâng cấp tại chỗ lên Postgres 10.17, hãy làm theo các bước sau:

  1. Nâng cấp postgres trên máy chủ chính 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Chạy lệnh thiết lập trên máy chủ chính: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Chạy lệnh định cấu hình trên máy chủ chính: 
    apigee-service apigee-postgresql configure
  4. Khởi động lại máy chủ chính: 
    apigee-service apigee-postgresql restart
  5. Định cấu hình làm nhánh chính: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Đảm bảo máy chủ chính đã khởi động: 
    apigee-service apigee-postgresql wait_for_ready
  7. Dừng chế độ chờ: 
    apigee-service apigee-postgresql stop
  8. Nâng cấp chế độ chờ.

    Lưu ý: Nếu bước này gặp lỗi/không thành công, bạn có thể bỏ qua. update.sh sẽ cố gắng khởi động máy chủ dự phòng bằng một cấu hình không chính xác. Nếu bản cài đặt Postgres được nâng cấp lên phiên bản 10.17, thì bạn có thể bỏ qua lỗi này.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Đảm bảo chế độ chờ đã dừng: 
    apigee-service apigee-postgresql stop
  10. Xoá cấu hình dự phòng cũ: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. 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

Sau khi hoàn tất quy trình này, máy chủ dự phòng sẽ khởi động thành cô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ả, có 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_standby_ip/32 trust
  5. Khởi động lại apigee-postgresql trên bản chính Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Xác minh rằng nút dự phòng mới đã được 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
  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_standby_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

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

Phần này liệt kê những điều cần lưu ý về giao diện người dùng Edge. Để biết thêm thông tin, hãy xem phần Giao diện người dùng Edge mới cho Private Cloud.

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à giao diện người dùng nâng cao dành cho nhà phát triển và quản trị viên của Apigee Edge cho Đám mây riêng tư.

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à sử dụng một IDP như SAML hoặc LDAP.

Để biết thêm thông tin, hãy xem bài viết Cài đặt giao diện người dùng mới của Edge.

Cập nhật giao diện người dùng Edge

Để cập nhật thành phần giao diện người dùng Edge, hãy xem xét phiên bản Edge cho đám mây riêng tư mà bạn đang nâng cấp:

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 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 Khôi phục phiên bản 4.51.00 để biết hướng dẫn chi tiết.

Đ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 chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích này sẽ ghi nhật ký vào thư mục /tmp dưới dạng tệp có tên update_username.log.

Nếu người đó không có quyền truy cập vào /tmp, thì tiện ích update.sh sẽ không hoạt động.

Cập nhật không 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 quá trình cài đặt của bạn như mô tả trong phần Thứ tự cập nhật máy.
  2. Khi đến lúc cập nhật Bộ định tuyến, hãy chọn một Bộ định tuyến bất kỳ và đặt bộ định tuyến đó ở trạng thái không kết nối được, 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 đây trước và sau khi cập nhật:

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.19.06 hoặc 4.50.00.

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

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

  1. Nếu có, hãy tắt mọi công việc cron được định cấu hình để thực hiện thao tác sửa chữa trên Cassandra cho đến khi quá trình cập nhật hoàn tất.
  2. Đăng nhập vào nút của bạn với tư cách là người dùng gốc để cài đặt Edge RPM.
  3. Cài đặt yum-utils và yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
  5. 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
  6. 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
  7. Tải tệp Edge 4.51.00 bootstrap_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
  8. Cài đặt tiện ích và phần phụ thuộc Edge 4.51.00 apigee-service bằng cách thực thi lệnh sau: 
    sudo bash /tmp/bootstrap_4.51.00.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 thông tin này.

    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 bạn không cài đặt, 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ý quá trình 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 lựa chọn này, bạn phải tự cài đặt Java.
  9. 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
  10. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. 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

    Thực hiện việc này theo thứ tự được 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ị có thể là:
      • 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 SSO)
      • ue: Giao diện người dùng mới của Edge
      • ui: Giao diện người dùng Edge cổ điển
      • zk: Zookeeper
    • configFile là cùng một 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.19.06 hoặc 4.50.00.

    Bạn có thể chạy update.sh cho tất cả các thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có hồ sơ cài đặt Edge tất cả trong một (AIO). Ví dụ:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. 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ày, nếu bạn chưa làm như vậy: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  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.

Nếu sau này 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.51.00.

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

Nếu các nút Edge của bạn nằm sau tường lửa hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet theo 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.51.00 cục bộ:

  1. Tạo kho lưu trữ 4.51.00 cục bộ như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại Cài đặt tiện ích apigee-setup của Edge.
  2. Cách cài đặt apigee-service từ tệp .tar:
    1. Trên nút có kho lưu trữ cục bộ, hãy sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar có tên là /opt/apigee/data/apigee-mirror/apigee-4.51.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 giải nén tệp vào thư mục /tmp: 
      tar -xzf apigee-4.51.00.tar.gz

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

    4. Cài đặt tiện ích và phần phụ thuộc Edge apigee-service từ /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Lưu ý rằng bạn cần đưa đường dẫn đến thư mục repos vào lệnh này.

  3. Cách cài đặt apigee-service bằng máy chủ web NGINX:
    1. Định cấu hình máy chủ web NGINX như mô tả trong phần "Cài đặt từ kho lưu trữ bằng máy chủ web NGINX" tại phần Cài đặt tiện ích apigee-setup của Edge.
    2. Trên nút từ xa, hãy tải tệp Edge bootstrap_4.51.00.sh xuống /tmp/bootstrap_4.51.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

      Trong đó uName:pWord là tên người dùng và mật khẩu bạn đã đặt trước đó 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 Edge apigee-setup và các phần phụ thuộc: 
      sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  4. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Chạy tiện ích update trên các nút theo thứ tự được mô tả trong phần Thứ tự cập nhật máy: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Trong trường hợp:

    • component là thành phần Edge cần cập nhật. 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: Đăng nhập một lần (SSO) vào Apigee (nếu bạn đã cài đặt SSO)
      • ue Giao diện người dùng mới của Edge
      • ui: Giao diện người dùng Edge cổ điển
      • zk: Zookeeper
    • configFile là cùng một 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.19.06 hoặc 4.50.00.

    Bạn có thể chạy update.sh cho tất cả các thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có hồ sơ cài đặt Edge tất cả trong một (AIO). Ví dụ:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Khởi động lại các thành phần giao diện người dùng trên tất cả các nút đang chạy thành phần đó, nếu bạn chưa làm như vậy: 
    /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 này 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.51.00.

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:

  • 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 được cập nhật khi bạn chỉ định tuỳ chọn -c edge.

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

Cách nâng cấp cấu hình độc lập 1 nút lên phiên bản 4.51.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 riêng lẻ 2 nút

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

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. 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 Apigee SSO) Cập nhật Apigee SSO trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó, sso_config_file là tệp cấu hình 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

Nâng cấp 5 nút

Cập nhật các thành phần sau cho bản cài đặt 5 nút:

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. 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ư trong ví dụ sau: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy cập nhật thành phần ue trên máy thích hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (Nếu bạn đã cài đặt apigee-adminapi) Đã cập nhật tiện ích apigee-adminapi trên máy 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó, sso_config_file là tệp cấu hình 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ư trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Nâng cấp cụm 9 nút

Cập nhật các thành phần sau cho một bản cài đặt theo cụm 9 nút:

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. 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 Apigee SSO) Cập nhật Apigee SSO trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó, sso_config_file là tệp cấu hình 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ư trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Nâng cấp cụm 13 nút

Cập nhật các thành phần sau cho một bản cài đặt theo cụm 13 nút:

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. 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 Apigee SSO) Cập nhật Apigee SSO trên máy 6 và 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó, sso_config_file là tệp cấu hình 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ư trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy 6 và 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Nâng cấp cụm 12 nút

Cập nhật các thành phần sau cho một bản cài đặt theo cụm 12 nút:

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. Cập nhật Cassandra và ZooKeeper:
    1. Trên máy 1, 2 và 3 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Trên máy 7, 8 và 9 trong Trung tâm dữ liệu 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Cập nhật 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 Apigee SSO) Cập nhật Apigee SSO:
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. 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 Edge mới (edge-management-ui) hoặc giao diện người dùng Edge cũ (edge-ui) trên máy 1 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, tức 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ủ Edge Postgres, Máy chủ quản lý, Bộ xử lý thông báo và Bộ định tuyến.
  6. Giao diện người dùng Edge (cũ hoặc mới)
  7. apigee-adminapi
  8. Apigee SSO

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