Khôi phục phiên bản Apigee Edge 4.50.00

Nếu gặp lỗi trong quá trình cập nhật lên Edge 4.50.00, bạn có thể khôi phục thành phần gây ra lỗi rồi thử cập nhật lại.

Bạn có thể khôi phục Edge 4.50.00 về các phiên bản phát hành tính năng sau:

  • Phiên bản 4.19.06
  • Phiên bản 4.19.01
  • Phiên bản 4.18.05

Có hai trường hợp mà bạn có thể muốn thực hiện khôi phục:

  1. Khôi phục về Bản phát hành tính năng trước đó. Ví dụ: từ 4.50.00 đến 4.18.05.
  2. Khôi phục về phiên bản cập nhật trước đó trong cùng một bản phát hành. Ví dụ: từ 4.19.01.02 xuống 4.19.01.01.

Để biết thêm thông tin, hãy xem Quy trình phát hành Apigee Edge.

Những người có thể thực hiện khôi phục

Người dùng thực hiện việc khôi phục phải là người dùng đã cập nhật Edge ban đầu hoặc người dùng đang chạy với tư cách là người dùng gốc.

Theo mặc định, các thành phần Edge chạy dưới dạng người dùng "apigee". Trong một số trường hợp, bạn có thể đang chạy các thành phần Edge dưới dạng người dùng khác. Ví dụ: nếu Bộ định tuyến phải truy cập vào các cổng đặc quyền, chẳng hạn như các cổng dưới 1000, thì bạn phải chạy Bộ định tuyến dưới dạng người dùng gốc hoặc người dùng có quyền truy cập vào các cổng đó. Hoặc bạn có thể chạy một thành phần với tư cách là một người dùng và một thành phần khác với tư cách là một người dùng khác.

Các thành phần có mã chung

Các thành phần Edge sau đây có chung mã. Do đó, để khôi phục bất kỳ thành phần nào trong số này trên một nút, bạn phải khôi phục tất cả các thành phần này trên nút đó.

  • edge-management-server (Máy chủ quản lý)
  • edge-message-processor (Trình xử lý thông báo)
  • edge-router (Bộ định tuyến)
  • edge-postgres-server (Máy chủ Postgres)
  • edge-qpid-server (Máy chủ Qpid)

Ví dụ: nếu bạn đã cài đặt Máy chủ quản lý, Bộ định tuyến và Bộ xử lý thông báo trên nút, thì để khôi phục bất kỳ thành phần nào trong số đó, bạn phải khôi phục cả ba thành phần.

Khôi phục về một Bản phát hành tính năng trước đó

Để khôi phục về Bản phát hành tính năng trước đó, hãy làm như sau trên mỗi nút lưu trữ thành phần:

  1. Tải tệp bootstrap.sh xuống cho phiên bản mà bạn muốn khôi phục:

    • Để quay lại phiên bản 4.19.06, hãy tải bootstrap_4.19.06.sh xuống: 
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    • Để khôi phục về phiên bản 4.19.01, hãy tải bootstrap_4.19.01.sh xuống: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • Để quay lại phiên bản 4.18.05, hãy tải bootstrap_4.18.05.sh xuống: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. Dừng thành phần để khôi phục:
    1. Để khôi phục bất kỳ thành phần nào có mã chung trên nút, bạn phải dừng tất cả các thành phần đó, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Để khôi phục mọi thành phần khác trên nút, chỉ cần dừng thành phần đó: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Nếu bạn đang khôi phục tính năng Kiếm tiền, hãy gỡ cài đặt tính năng này khỏi tất cả các nút Máy chủ quản lý và Bộ xử lý thông báo: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Gỡ cài đặt thành phần để khôi phục trên nút:
    1. Để khôi phục bất kỳ thành phần nào có mã chung trên nút, bạn phải gỡ cài đặt tất cả các thành phần đó bằng cách gỡ cài đặt nhóm thành phần edge-gateway, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Để khôi phục bất kỳ thành phần nào khác trên nút, chỉ cần gỡ cài đặt thành phần đó, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Trong đó component là tên thành phần.

    3. Để khôi phục Bộ định tuyến biên, bạn phải xoá nội dung của tệp /opt/nginx/conf.d ngoài việc gỡ cài đặt nhóm thành phần edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. Gỡ cài đặt phiên bản 4.50.00 của apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Cài đặt phiên bản 4.19.01 hoặc 4.18.05 của tiện ích apigee-service và các phần phụ thuộc của tiện ích này. Ví dụ sau đây cài đặt phiên bản 4.18.05 của apigee-service: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Trong đó, uName và 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.

    Nếu bạn gặp lỗi, hãy nhớ tải tệp bootstrap.sh xuống ở bước 1.

  7. Cài đặt apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Cài đặt phiên bản cũ của thành phần: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Trong đó, component là thành phần cần cài đặt và configFile là tệp cấu hình cho phiên bản cũ.

  9. Nếu bạn đang khôi phục Qpid, hãy xoá iptables: 
    sudo iptables -F
  10. Lặp lại quy trình này cho từng nút lưu trữ thành phần mà bạn đang khôi phục.

Khôi phục về phiên bản cập nhật trước đó

Để khôi phục một thành phần về một phiên bản cụ thể của một bản phát hành, hãy làm như sau trên mỗi nút lưu trữ thành phần đó:

  1. Tải phiên bản thành phần cụ thể xuống: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Trong đó, component_version là thành phần và phiên bản cập nhật cần cài đặt. Ví dụ:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install

    Nếu đang sử dụng kho lưu trữ trực tuyến Apigee, bạn có thể xác định các phiên bản thành phần có sẵn bằng cách sử dụng lệnh sau: 

    yum --showduplicates list comp

    Ví dụ:

    yum --showduplicates list edge-ui
  2. Sử dụng apigee-setup để cài đặt thành phần: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Ví dụ:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Lưu ý rằng bạn chỉ chỉ định tên thành phần khi cài đặt, chứ không chỉ định phiên bản.

  3. Lặp lại quy trình này cho từng nút lưu trữ thành phần mà bạn đang khôi phục.