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 đã gây ra lỗi, sau đó 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 về bản phát hành bản vá trước đó 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ản 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 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 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 xuống Tự thân khởi động của 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 Tự động khởi động của 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 theo các bước sau: 
      /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 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 bắt đầu 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 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 xuống Tự thân khởi động của 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 Tự động khởi động của 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 chuyển sang quay lại:

    • Để 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ả 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.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 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.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 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ề 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 thực hiện 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. Cho 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 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.

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