Khôi phục Apigee Edge 4.52.02

Nếu gặp lỗi trong khi cập nhật lên Edge 4.52.02, 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.52.02 về các phiên bản phát hành chính sau đây:

  • Phiên bản 4.52.01
  • Phiên bản 4.52.00
  • Phiên bản 4.51.00

Khôi phục một phiên bản bao gồm việc khôi phục mọi thành phần mà bạn có thể đã nâng cấp. Ngoài ra, dựa trên phiên bản bạn bắt đầu, bạn có thể cần tính đến những cân nhắc đặc biệt trước khi khôi phục một số thành phần phần mềm nhất định. Bảng dưới đây liệt kê các phần mềm mà bạn có thể cần thực hiện các bước đặc biệt trong quá trình khôi phục:

Khôi phục về phiên bản Lưu ý đặc biệt đối với phần mềm
4.52.01 Cassandra
4.52.00 Cassandra, Người giữ vườn thú, Qpid
4.51.00 Cassandra, người giữ vườn thú, Qpid, Postgres

Có hai tình huống mà bạn có thể muốn khôi phục:

  1. Khôi phục về bản phát hành lớn hoặc nhỏ trước đó. Ví dụ: từ 4.52.02 đến 4.52.00.
  2. Khôi phục bản vá trước đó trong cùng một bản phát hành. Ví dụ: từ 4.52.00.02 đến 4.52.00.01.

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

Thứ tự khôi phục

Khôi phục các thành phần phải được thực hiện theo thứ tự ngược lại với các thành phần đã được nâng cấp, ngoại trừ việc máy chủ quản lý phải được khôi phục sau Cassandra.

Trình tự chung điển hình cho việc khôi phục dành cho Private Cloud 4.52.02 sẽ có dạng như sau:

  1. Khôi phục Postgres, Qpid và các thành phần khác có liên quan đến Analytics
  2. Bộ định tuyến khôi phục và bộ xử lý thư
  3. Khôi phục Cassandra, người giữ vườn thú
  4. Máy chủ quản lý khôi phục

Ví dụ: giả sử bạn đã nâng cấp toàn bộ cụm Cassandra, tất cả máy chủ quản lý và một vài RMP từ phiên bản 4.52.02 lên phiên bản 4.52.01 và muốn khôi phục. Trong trường hợp này, bạn sẽ:

  1. Khôi phục từng RMP
  2. Khôi phục toàn bộ cụm Cassandra bằng bản sao lưu
  3. Khôi phục từng nút máy chủ Quản lý cạnh

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 quyền 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ể đang chạy các thành phần Edge với tư cách 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ư các cổng dưới 1000, thì bạn phải chạy Bộ định tuyến ở chế độ gốc hoặc với tư cách 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à 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ỳ 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ả thành phần 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à Trình xử lý thông báo trên nút, để khôi phục bất kỳ máy chủ nào trong số đó, bạn phải khôi phục cả ba.

Khôi phục Cassandra

Khi thực hiện một quá trình nâng cấp lớn của Cassandra trên một nút Cassandra cụ thể, Cassandra sửa đổi giản đồ dữ liệu được lưu trữ trên nút này, khiến việc khôi phục trực tiếp không khả thi. Có hai phương pháp để khôi phục. Bạn sẽ sử dụng một trong những phương pháp này dựa trên trạng thái nâng cấp mà bạn đang khôi phục.

Phương pháp khôi phục

Xoá sạch và sử dụng các nút hiện có trong cụm để tạo lại nút

Có thể thực hiện quy trình này nếu bạn có ít nhất một trung tâm dữ liệu với đầy đủ chức năng trong cụm vẫn còn trên phiên bản cũ của Cassandra (Cassandra 2.1.22). Nếu đã nâng cấp toàn bộ cụm Cassandra và muốn khôi phục, bạn phải làm theo các bước trong bài viết Xoá sạch và khôi phục bản sao lưu hoặc bản tổng quan nhanh máy ảo.

Các bước khôi phục

  1. Bắt đầu bằng nút bạn muốn khôi phục:
    • Dừng Cassandra trên nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Gỡ cài đặt phần mềm Cassandra khỏi nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Xoá thư mục dữ liệu khỏi nút: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • Tải xuống và chạy quá trình tự động khởi động của phiên bản Edge cũ hơn cho Cloud riêng tư mà bạn muốn khôi phục.

    Ví dụ: Để khôi phục về 4.52.01,

    • Tải bản khởi động xuống của phiên bản 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • Thực thi quá trình tự khởi động của phiên bản 4.52.01: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Thiết lập Cassandra trên nút: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Thực thi bản dựng lại trên nút bằng cách cung cấp tên của trung tâm dữ liệu chức năng: 
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • Lặp lại từng bước ở trên cho từng nút bạn muốn khôi phục.
  2. Sau khi tất cả các nút được khôi phục và tạo lại:
    • Chạy quy trình thiết lập bất kỳ nút máy chủ quản lý nào. Đảm bảo máy chủ quản lý là của phiên bản khôi phục. Nếu không, hãy khôi phục cả máy chủ quản lý.
    • Dừng máy chủ quản lý: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
    • Nếu bạn sử dụng tính năng kiếm tiền, hãy gỡ cài đặt tính năng kiếm tiền: 
      /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
    • Gỡ cài đặt máy chủ quản lý: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    • Tải xuống và thực thi quy trình tự khởi động của phiên bản cũ. Ví dụ: thực hiện các bước sau để tải xuống và thực thi quá trình khởi động của phiên bản 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
    • Chạy quy trình thiết lập một nút máy chủ quản lý: 
      /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

Tối ưu hoá sau khi tạo lại

Trong các bước trên, tất cả dữ liệu trong nút được truyền trực tuyến từ trung tâm dữ liệu từ xa trong quá trình tạo lại. Bạn có thể tối ưu hoá quy trình này bằng cách sử dụng bản sửa chữa sau khi tất cả bản sao được truyền đến trung tâm dữ liệu cục bộ. Điều này giúp tránh truyền phát trên nhiều nguồn DC và sẽ nhanh hơn so với việc tạo lại tất cả các nút từ một nguồn điện một chiều từ xa.

Ví dụ: Giả sử bạn có 6 nút Cassandra trong trung tâm dữ liệu cục bộ. Theo mặc định, hệ số sao chép của Apigee là 3, vì vậy, mỗi nút sở hữu 50% dữ liệu. Trong trường hợp này, bạn có thể tạo lại các nút #1 và #4 bằng cách làm theo quy trình trên. Đối với các nút #2, #3, #5 và #6, hãy làm theo các bước bên dưới để khôi phục bản sao lưu và chạy sửa chữa.

  1. Thực hiện quy trình đến bước 6 như được ghi trong tài liệu để tạo lại các bản sao trong trung tâm dữ liệu cục bộ.
  2. Đối với các nút còn lại, hãy lần lượt làm theo các bước bên dưới cho từng nút còn lại.
    • Khôi phục bản sao lưu mà bạn đã ghi lại trên nút này (lưu ý: bản sao lưu này có thể có dữ liệu cũ vì bản sao lưu này được thực hiện trước khi bạn bắt đầu nâng cấp Cassandra): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Nếu có bản tổng quan nhanh máy ảo của nút, bạn có thể khôi phục bản tổng quan nhanh này thay vì khôi phục bản sao lưu Cassandra.
    • Sau khi khôi phục bản sao lưu, hãy khởi động dịch vụ Cassandra trên nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Thực thi sửa chữa trên nút để có thể truyền trực tuyến dữ liệu mới nhất từ một trung tâm dữ liệu hiện có: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • Lặp lại các bước từ 3 đến 6 trên mỗi nút mà bạn muốn sửa.

Xoá sạch và khôi phục bản sao lưu/ảnh chụp nhanh máy ảo

Bạn chỉ có thể thực hiện quy trình này nếu đã nâng cấp toàn bộ cụm Cassandra và muốn khôi phục.

Ngoài ra, bản sao lưu Apigee chỉ dành riêng cho nút. Bạn không thể khôi phục bản sao lưu đã lấy từ nút này sang nút khác. Bản sao lưu Cassandra bao gồm thông tin siêu dữ liệu về nút (như địa chỉ IP, vị trí đổ chuông, v.v.).

  1. Bắt đầu bằng 1 nút Cassandra trong cụm:
    • Dừng dịch vụ Cassandra trên nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Gỡ cài đặt phần mềm Cassandra khỏi nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Xoá thư mục dữ liệu khỏi nút: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • Tải xuống và chạy quá trình tự động khởi động của phiên bản Edge cũ hơn cho Cloud riêng tư mà bạn muốn khôi phục.

    Ví dụ: Để khôi phục về 4.52.01

    • Tải bản khởi động xuống của phiên bản 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • Thực thi quá trình tự khởi động của phiên bản 4.52.01: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Thiết lập Cassandra trên nút: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Khôi phục bản sao lưu trên nút bằng quy trình trong phần Khôi phục từ bản sao lưu.
    • Dừng Cassandra trên nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Xoá thư mục dữ liệu: 
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • Khôi phục bản sao lưu: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Bắt đầu dịch vụ Cassandra trên nút: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Lặp lại lần lượt từng bước trên từng nút Cassandra.
    • Chạy lần lượt sửa chữa trên các nút: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

Khôi phục bản cập nhật Zookeeper 3.8.3

Nếu bạn đang khôi phục về các phiên bản 4.52.00 hoặc 4.51.00, bạn sẽ cần tham khảo một số bước đặc biệt trước khi khôi phục Zookeeper. Các bước này được liệt kê trong phần Khôi phục.

Nếu bạn khôi phục về phiên bản 4.52.01, hãy khôi phục Zookeeper vì bạn sẽ khôi phục mọi phần mềm như liệt kê trong phần Khôi phục về bản phát hành chính hoặc phụ trước đó dưới đây.

Khôi phục Qpid

Nếu đang khôi phục về các phiên bản 4.52.00 hoặc 4.51.00, bạn sẽ cần tham khảo một số bước đặc biệt trước khi khôi phục Qpid. Các bước này được liệt kê trong phần Khôi phục.

Nếu bạn khôi phục về phiên bản 4.52.01, hãy khôi phục Qpid theo cách giống như bạn khôi phục bất kỳ phần mềm nào nêu trong phần Khôi phục về bản phát hành chính hoặc nhỏ trước đó

Khôi phục bản cập nhật Postgres 10.17

Nếu bạn đang khôi phục về phiên bản 4.51.00, bạn sẽ cần tham khảo một số bước đặc biệt trước khi khôi phục Postgres. Các bước này được liệt kê trong phần Khôi phục.

Nếu bạn khôi phục về phiên bản 4.52.01 hoặc 4.52.00, hãy khôi phục Postgres vì bạn sẽ khôi phục mọi phần mềm như liệt kê trong phần Khôi phục về bản phát hành chính hoặc nhỏ trước đó dưới đây.

Khôi phục về bản phát hành lớn hoặc nhỏ trước đó

Để khôi phục về bản phát hành chính hoặc phụ 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 khôi phục:

    • Để khôi phục về phiên bản 4.51.00, hãy tải bootstrap_4.51.00.sh xuống: 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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ỉ 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ả các nút Máy chủ quản lý và Nút Xử lý thư: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Gỡ cài đặt thành phần này để 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 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, hãy chỉ 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 Trình định tuyến cạnh, 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.52.02 của apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Cài đặt phiên bản 4.51.00 của tiện ích apigee-service và các phần phụ thuộc của tiện ích đó. Ví dụ sau đây cài đặt phiên bản 4.51.00 của apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.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 mã đó.

    Nếu gặp lỗi, hãy đảm bảo bạn đã tải tệp bootstrap.sh xuống trong 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à 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á 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ề bản vá đã phát hành trước đó

Để khôi phục một thành phần về một bản vá 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à bản phát hành bản vá sẽ cài đặt. Ví dụ:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.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 dùng lệnh sau: 

    yum --showduplicates list comp

    Ví dụ:

    yum --showduplicates list edge-ui
  2. 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.

Khôi phục mTLS

Để khôi phục bản cập nhật mTLS, hãy làm theo các bước sau trên tất cả máy chủ:

  1. Ngừng Apigee: 
    apigee-all stop
  2. Dừng mTLS: 
    apigee-service apigee-mtls uninstall
  3. Cài đặt lại mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf