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

Nếu gặp lỗi trong khi cập nhật lên Edge 4.50.00, bạn có thể khôi phục đã gây ra lỗi, sau đó 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 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 tình huống mà bạn có thể muốn khôi phục:

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

Để biết thêm thông tin, hãy xem Bản phát hành Apigee Edge .

Những người có thể khôi phục

Người dùng khôi phục phải giống như người dùng đã cập nhật Edge ban đầu hoặc người dùng chạy dưới dạng thư mục gốc.

Theo mặc định, các thành phần Edge sẽ chạy với tư cách "api" ("API") của người dùng. Trong một số trường hợp, bạn có thể dùng ứng dụng Edge dưới dạng người dùng khác nhau. Ví dụ: nếu Bộ định tuyến phải truy cập các cổng đặc quyền, chẳng hạn như những bộ định tuyến dưới 1000, thì bạn phải chạy Bộ định tuyến dưới dạng thư mục gốc hoặc với tư cách người dùng có quyền truy cập vào các Bộ định tuyến đó 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à người dùng khác.

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

Các thành phần Edge sau đây dùng chung mã. Do đó, để khôi phục bất kỳ một trong số các thành phần 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 có trên nút đó.

  • edge-management-server (Máy chủ quản lý)
  • edge-message-processor (Đơn vị xử lý tin nhắn)
  • 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ư trên nút, để khôi phục bất kỳ nút nào trong số đó, bạn phải khôi phục cả ba nút.

Khôi phục về 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 bạn muốn chuyển sang quay lại:

    • Để khôi phục về 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 
    • Để khôi phục về 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ả chúng, như ví dụ sau cho thấy:
      /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ỉ dừng thành phần đó:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Nếu bạn muốn bật lại 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ả Máy chủ quản lý và Thông báo Nút đơn vị xử lý:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Gỡ cài đặt thành phần để khôi phục nút này:
    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ả bằng cách gỡ cài đặt thành phần edge-gateway nhóm, như ví dụ sau cho thấy:
      /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ỉ gỡ cài đặt thành phần đó, vì ví dụ sau đây cho thấy:
      /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 cạnh, bạn phải xóa nội dung của /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 apigee-service tiện ích và các phần phụ thuộc của nó. Ví dụ sau 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 đó uNamepWord là tên người dùng và mật khẩu bạn nhận được của Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã đó.

    Nếu gặp lỗi, hãy nhớ tải tệp bootstrap.sh xuống theo 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ũ hơn 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à thành phần của bạn cho phiên bản cũ hơn.

  9. Nếu bạn đang khôi phục Qpid, hãy xoá các iptables:
    sudo iptables -F
  10. Lặp lại quy trình này cho mỗi 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 phát hành cụ thể, hãy làm như sau trên từng 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 sẽ 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 thành phần có sẵn bằng cách 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ỉ xác định tên thành phần khi cài đặt chứ không phải phiên bản.

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