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.

Những người có thể thực hiện quá trình cập nhật

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

Sau khi bạn cài đặt RPM của cạnh, bất cứ ai cũng có thể định cấu hình chúng.

Bạn phải cập nhật những thành phần nào

Bạn phải cập nhật tất cả các thành phần của Edge. Edge không hỗ trợ chế độ thiết lập có chứa các thành phần từ nhiều phiên bản.

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

Nếu bạn đã đặt thuộc tính bất kỳ 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 quá trình cập nhật.

Nâng cấp bắt buộc lên Postgres 10.17

Bản phát hành Edge này bao gồm bản nâng cấp cho Postgres 10.17. Trong quá trình nâng cấp đó, tất cả Dữ liệu Postgres đượ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 2 nút Postgres được định cấu hình để sao chép chế độ chờ chính. Trong quá trình cập nhật, trong 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 sau đó sẽ được đẩy đến các nút Postgres.

Cách bạn thực hiện cập nhật Postgres phụ thuộc vào cách bạn định cấu hình bộ nhớ dữ liệu cho 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 nút dự phòng Postgres mới trong suốt thời gian nâng cấp. Sau hoàn tất quá trình nâng cấp, bạn có thể gỡ bỏ nút chế độ chờ Postgres mới.

    Cần có nút dự phòng Postgres bổ sung nếu bạn phải khôi phục bản cập nhật vì bất kỳ lý do gì. Nếu bạn phải khôi phục bản cập nhật, nút chế độ chờ Postgres mới sẽ trở thành nút Postgres chính sau khi khôi phục. Do đó, khi bạn cài đặt nút chế độ chờ Postgres mới, nút này phải nằm trên một nút đáp ứng tất cả phần cứng các yêu cầu của máy chủ Postgres, như được xác định trong Edge Yêu cầu về việc cài đặt.

    Trong cấu hình 1 nút và 2 nút của Edge, cấu trúc liên kết được 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 phải để tạo nút Postgres mới.

  • Nếu bạn sử dụng bộ nhớ mạng cho các nút Postgres, như do Apigee đề xuất, bạn không cần phải cài đặt nút Postgres mới. Trong dưới đây, bạn có thể bỏ qua các bước chỉ định để cài đặt và sau đó gỡ bỏ Nút chế độ chờ Postgres.

    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. 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ừ bản tổng quan nhanh đó.

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

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

Để cài đặt, hãy sử dụng chính tệp cấu hình mà bạn đã dùng để cài đặt phiên bản hiện tại của Edge.

Cách tạo nút chờ Postgres mới:

  1. Trên trang cái Postgres hiện tại, hãy chỉnh sửa /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 Postgres hiện tại máy chủ dự phòng và new_standby_ip là địa chỉ IP của nút chế độ chờ mới.

  2. Khởi động lại apigee-postgresql trên trang cái Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Xác minh rằng nút chế độ chờ mới đã được thêm bằng cách xem /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên trang cái. 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ư 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. Vô hiệu hoá SELinux như được mô tả trong Cài đặt tiện ích thiết lập apigee của Edge.
    3. Thực hiện một trong các thao tác sau, tuỳ thuộc vào phiên bản Edge bạn đang nâng cấp:
      • Nếu đang nâng cấp từ Edge 4.19.06, tải tệp Edge bootstrap_4.19.06.sh 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à các phần phụ thuộc apigee-service của Edge: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Nếu đang nâng cấp từ Edge 4.50.00, tải tệp Edge bootstrap_4.50.00.sh xuống /tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

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

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
    4. Dùng apigee-service để cài đặt tiện ích apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Cài đặt Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Trên nút chế độ chờ 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 đó là chế độ chờ.

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

Để 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 bưu điện trên máy chủ lưu trữ 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 tài khoản 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 bước này. update.sh sẽ cố gắng để khởi động máy chủ dự phòng với cấu hình không chính xác. Cung cấp cho Postgres nếu bản cài đặt được nâng cấp lên 10.17, thì lỗi có thể bỏ qua.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Đảm bảo bạn đã dừng chế độ chờ: 
    apigee-service apigee-postgresql stop
  10. Xoá cấu hình chế độ chờ 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, chế độ chờ sẽ bắt đầu thành công.

Gỡ bỏ nút Postgres

Sau khi cập nhật xong, hãy huỷ bỏ nút chế độ chờ 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 Postgres: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Lấy UUID của nút chế độ chờ mới bằng cách chạy lệnh curl sau trên nút chế độ chờ: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Bạn sẽ thấy mã nhận dạng duy nhất (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 chế độ chờ mới bằng cách chạy lệnh sau trên nút chế độ chờ mới: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  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 trang chính Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Xác minh rằng nút chế độ chờ mới đã bị xoá bằng cách xem /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên trang cái. Bạn sẽ thấy chỉ dòng sau trong tệp đó: 
    host replication apigee existing_standby_ip/32 trust
  7. Xoá UUID của nút chế độ chờ khỏi ZooKeeper bằng cách thực hiện quản lý Edge sau Lệnh gọi API 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

Cập nhật điều kiện tiên quyết

Hãy đáp ứng những đ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 để đảm bảo an toàn lý do. Sử dụng quy trình này dành cho phiên bản Edge hiện tại của bạn để sao lưu.

    Điều này cho phép bạn có một kế hoạch dự phòng trong trường hợp việc cập nhật lên phiên bản mới không hoạt động đúng cách. Để biết thêm thông tin về sao lưu, hãy xem bài viết Sao lưu và Khôi phục.

  • Đảm bảo Edge đang chạy
    Đảm bảo rằng Edge đang hoạt động trong quá trình cập nhật bằng cách dùng lệnh: 
    /opt/apigee/apigee-service/bin/apigee-all status

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

Phần này liệt kê những điều cần cân nhắc liên quan đến giao diện người dùng Edge. Để biết thêm thông tin, hãy xem Giao diện người dùng Edge mới dành cho Đám mây riêng tư.

Cài đặt giao diện người dùng Edge

Sau khi hoàn tất bước 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 các nhà phát triển và quản trị viên của Apigee Edge cho Private Cloud.

Lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt phương thức Xác thực cơ bản và sử dụng IDP như SAML hoặc Giao thức truy cập thư mục hạng nhẹ (LDAP).

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

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 dành cho Đám mây riêng tư mà bạn đang nâng cấp từ:

Cập nhật bằng mTLS của Apigee

Để cập nhật Apigee mTLS , hãy làm như sau các bước:

Đang khôi phục bản cập nhật

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

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

Thông tin cập nhật ghi nhật ký

Theo mặc định, tiện ích update.sh ghi thông tin nhật ký vào:

/opt/apigee/var/log/apigee-setup/update.log

Nếu người đang chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, nó 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 không thành công.

Cập nhật khi không có thời gian ngừng hoạt động

Cập nhật ngay tức thì hoặc cập nhật định kỳ cho phép bạn cập nhật bản cài đặt Edge mà không cần đưa Edge xuống.

Bạn chỉ có thể cập nhật thời gian ngừng hoạt động bằng 0 với cấu hình từ 5 nút trở lên.

Chìa khóa để nâng cấp mà không lo gián đoạn hoạt động là xóa từng Bộ định tuyến khỏi tải trình cân bằng. Sau đó, bạn cập nhật Bộ định tuyến và bất kỳ thành phần nào khác trên cùng một máy với Bộ định tuyến, sau đó thêm lại Bộ định tuyến vào trình cân bằng tải.

  1. Cập nhật các máy theo đúng thứ tự cài đặt của bạn như được mô tả 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à không kết nối được Bộ định tuyến đó, như là được mô tả trong Bật/Tắt máy chủ Phạm vi kết nối (Bộ xử lý tin nhắn/Bộ định tuyến).
  3. Cập nhật Bộ định tuyến đã chọn và tất cả các thành phần Edge khác trên cùng một máy với Bộ định tuyến. Tất cả các cấu hình Edge đều hiển thị Bộ định tuyến và Trình xử lý thư trên cùng một nút.
  4. 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 đối với các Bộ định tuyến còn lại.
  6. Tiếp tục cập nhật cho các máy còn lại trong bản cài đặt của bạn.

Hãy lưu ý những điều sau trước và sau khi cập nhật:

Sử dụng tệp cấu hình im lặng

Bạn phải chuyển tệp cấu hình im lặng vào lệnh cập nhật. Tệp cấu hình im lặng sẽ giống với trình duyệt mà bạn đã sử dụng để cài đặt Edge 4.19.06 hoặc 4.50.00.

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

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

  1. Nếu 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 làm thư mục gốc để cài đặt RPM cạnh.
  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 Cài đặt tiện ích thiết lập apigee 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 lệnh sau Lệnh yum-configure-manager: 
    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à các phần phụ thuộc apigee-service của Edge 4.51.00 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ạn bỏ qua pWord, bạn sẽ được nhắc nhập mã đó.

    Theo mặc định, trình cài đặt sẽ kiểm tra xem bạn đã cài đặt Java 1.8 hay chưa. Nếu không, trình cài đặt sẽ cài đặt tiện ích đó cho bạn.

    Sử dụng lựa chọn JAVA_FIX để chỉ định cách xử lý Cài đặt Java. JAVA_FIX nhận các giá trị sau:

    • I: Cài đặt OpenJDK 1.8 (mặc định).
    • C: Tiếp tục mà không cài đặt Java.
    • Q: Thoát. Đối với tuỳ chọn này, bạn phải tự cài đặt Java.
  9. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, dưới dạng ví dụ sau đây cho thấy: 
    /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ư sau ví dụ cho thấy: 
    /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ư sau ví dụ cho thấy: 
    /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 thao tác này theo thứ tự mô tả trong phần Thứ tự máy cập nhật.

    Trong trường hợp:

    • component là thành phần Edge cần cập nhật. Có thể là các giá trị sau:
      • cs: Cassandra
      • edge: Tất cả các thành phần Edge, ngoại trừ Giao diện người dùng Edge: Máy chủ quản lý, Tin nhắn Bộ xử lý, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO của Apigee (nếu bạn đã cài đặt SSO)
      • ue: Giao diện người dùng Edge mới
      • ui: Giao diện người dùng cổ điển Edge
      • zk: Người giữ vườn thú
    • configFile cũng chính là tệp cấu hình mà bạn đã dùng xác định Edge của bạn các thành phần 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 dựa trên tất cả thành phần bằng cách thiết lập component thành "all" (tất cả), nhưng chỉ khi bạn có hồ sơ cài đặt tích hợp (AIO) của Edge. 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 thực hiện việc này: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. Kiểm tra bản cập nhật bằng cách chạy tiện ích apigee-validate trên phần Quản lý Máy chủ, như mô tả trong phần Kiểm tra bản cài đặt.

Nếu sau đó bạn quyết định khôi phục bản cập nhật, hãy sử dụng quy trình được mô tả trong Khôi phục 4.51.00.

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

Nếu các nút Edge của bạn bị tường lửa chặn hoặc bị cấm truy cập theo một cách khác kho lưu trữ Apigee qua Internet, thì bạn có thể cập nhật từ kho lưu trữ cục bộ, hoặc bản sao của kho lưu trữ Apigee.

Sau khi tạo kho lưu trữ Edge cục bộ, bạn có hai tùy 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ừ .tar.
  • Cài đặt máy chủ web trên nút bằng repo cục bộ để các nút khác có thể truy cập vào đó. Apigee cung cấp máy chủ web NGINX để bạn sử dụng, hoặc bạn có thể dùng máy chủ của riêng mình máy chủ web.

Cách cập nhật từ kho lưu trữ 4.51.00 cục bộ:

  1. Tạo một kho lưu trữ cục bộ 4.51.00 như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" vào lúc Cài đặt tiện ích thiết lập apigee 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 /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 địa chỉ đó vào thư mục /tmp trên nút mới.
    3. Trên nút mới, hãy huỷ đánh dấu 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 là repos trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.

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

      Lưu ý rằng bạn bao gồm đường dẫn đến thư mục repos trong lệnh này.

  3. Cách cài đặt dịch vụ apigee bằng máy chủ web NGINX:
    1. Định cấu hình máy chủ web NGINX như mô tả trong phần "Cài đặt qua kho lưu trữ bằng NGINX webserver" lúc Cài đặt Edge tiện ích thiết lập apigee.
    2. Trên nút điều khiển 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 đây repo và remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.

    3. Trên nút từ xa, hãy cài đặt tiện ích và các phần phụ thuộc apigee-setup của Edge: 
      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 kho lưu trữ.

  4. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, dưới dạng ví dụ sau đây cho thấy: 
    /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ư sau ví dụ cho thấy: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý như sau ví dụ cho thấy: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Chạy tiện ích update trên các nút của bạn theo thứ tự mô tả trong 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 thành phần sau:
      • cs: Cassandra
      • edge: Tất cả các thành phần Edge, ngoại trừ Giao diện người dùng Edge: Máy chủ quản lý, Bộ xử lý thư, Bộ định tuyến, Máy chủ QPID, máy chủ Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO của Apigee (nếu bạn đã cài đặt SSO)
      • Giao diện người dùng Edge mới của ue
      • ui: Giao diện người dùng cổ điển Edge
      • zk: Người giữ vườn thú
    • configFile cũng chính là tệp cấu hình mà bạn đã dùng xác định các thành phần Edge trong khi cài đặt 4.19.06 hoặc 4.50.00.

    Bạn có thể chạy update.sh dựa trên tất cả thành phần bằng cách thiết lập component thành "all" (tất cả), nhưng chỉ khi bạn có hồ sơ cài đặt tích hợp (AIO) của Edge. Ví dụ:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Khởi động lại các thành phần giao diện người dùng trên tất cả các nút đang chạy nó, nếu bạn chưa thực hiện việc này: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Kiểm tra bản cập nhật bằng cách chạy tiện ích apigee-validate trên phần Quản lý Máy chủ, như mô tả trong phần Kiểm tra bản cài đặt.

Nếu sau đó bạn quyết định khôi phục bản cập nhật, hãy sử dụng quy trình được mô tả trong Khôi phục 4.51.00.

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

Thứ tự cập nhật máy trong quá trình cài đặt Edge là rất quan trọng:

  • Bạn phải cập nhật tất cả các nút Cassandra và ZooKeeper trước khi cập nhật bất kỳ các nút 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ư, 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ả chúng cùng một lúc.
  • Nếu một bước chỉ định rằng cần được thực hiện trên nhiều máy, hãy thực hiện bước đó trong đơn đặt hàng máy được chỉ định.
  • Bạn cần thực hiện một bước riêng để cập nhật tính năng Kiếm tiền. Trường này được cập nhật khi bạn chỉ định Tuỳ chọn -c edge.

Nâng cấp riêng lẻ với 1 nút

Cách nâng cấp cấu hình độc lập 1 nút lê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

Nâng cấp riêng lẻ 2 nút

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

Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của 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 dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà 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 để cài đặt 5 nút:

Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của 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ổ điển: Nếu bạn đang sử dụng giao diện người dùng cổ điển, thì 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
    • New Edge UI: 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 dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà 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ổ điển: Nếu bạn đang sử dụng giao diện người dùng cổ điển, 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
    • New Edge UI: 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 phù hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Bản nâng cấp theo cụm 9 nút

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

Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của 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ự đó: 
    /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ổ điển (ui) trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà 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ổ điển: Nếu bạn đang sử dụng giao diện người dùng cổ điển, 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
    • New Edge UI: 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 phù hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Bản nâng cấp theo cụm 13 nút

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

Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của 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 của Edge trên các máy 12, 13, 8, 9, 6, 7, 10 và 11 theo thứ tự đó: 
    /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ổ điển (ui) trên máy 6 và 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 6 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 6 và 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà 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ổ điển: Nếu bạn đang sử dụng giao diện người dùng cổ điển, 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
    • New Edge UI: 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

Bản nâng cấp theo cụm 12 nút

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

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

  1. Cập nhật Cassandra và ZooKeeper:
    1. Trên các máy 1, 2 và 3 của Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Trên các máy 7, 8 và 9 trong 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ổ điển (ui):
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee:
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Trong đó sso_config_file là tệp cấu hình mà bạn đã tạo khi đã cài đặt SSO.

  9. Khởi động lại giao diện người dùng Edge mới (edge-management-ui) hoặc giao diện người dùng Edge cổ điển (edge-ui) trên máy 1 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, có nghĩa là "cạnh -c" hồ sơ trên tất cả các nút theo thứ tự: các nút có máy chủ Qpid, Máy chủ Edge Postgres, Máy chủ quản lý, Bộ xử lý thư và Bộ định tuyến.
  6. Giao diện người dùng Edge (cổ điển hoặc mới)
  7. apigee-adminapi
  8. Đăng nhập một lần (SSO) của Apigee

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