Quay lại Apigee Edge 4.53.00

Nếu gặp lỗi trong quá trình cập nhật lên Edge 4.53.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.53.00 về phiên bản phát hành phụ sau đây:

  • Phiên bản 4.52.02

Việc khôi phục một phiên bản sẽ liên quan đến việc khôi phục mọi thành phần mà bạn có thể đã nâng cấp. Ngoài ra, bạn nên cân nhắc kỹ lưỡng khi khôi phục Cassandra về phiên bản 4.52.02.

Có 2 trường hợp bạn có thể muốn thực hiện thao tác quay lại:

  1. Khôi phục về một bản phát hành chính hoặc phụ trước đó. Ví dụ: từ 4.53.00 xuống 4.52.02.
  2. Khôi phục về một bản phát hành vá lỗi trước đó trong cùng một bản phát hành. Ví dụ: từ 4.53.00.01 đến 4.53.00.00.

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

Thứ tự khôi phục

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

Sau đây là thứ tự chung điển hình để khôi phục cho Đám mây riêng tư 4.53.00:

  1. Quay lại Postgres, Qpid và các thành phần khác liên quan đến hoạt động phân tích
  2. Khôi phục Bộ định tuyến và Bộ xử lý thông báo
  3. Rollback Cassandra, Zookeeper
  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ả các máy chủ quản lý và một số RMP lên phiên bản 4.53.00 từ phiên bản 4.52.02 và muốn quay lại phiên bản cũ. Trong trường hợp này, bạn sẽ:

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

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

Người dùng thực hiện thao tá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 dướ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 với tư cách là nhiều người dùng. 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 gốc hoặc dưới dạng 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 sau đây của Edge 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ả các thành phần này trên nút đó.

  • edge-management-server (Máy chủ quản lý)
  • edge-message-processor (Bộ 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 đã 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, thì để quay lại bất kỳ thành phần nào trong số đó, bạn phải quay lại cả 3 thành phần.

Khôi phục Cassandra

Khôi phục Cassandra

Khi bạn thực hiện một bản nâng cấp lớn cho Cassandra trên một nút cụ thể, Cassandra sẽ sửa đổi giản đồ của dữ liệu được lưu trữ trên nút đó. Do đó, bạn không thể khôi phục trực tiếp tại chỗ.

Các trường hợp khôi phục

Cassandra 4.0.X, có trong Edge cho Đám mây riêng tư 4.53.00, tương thích với các thành phần khác của Đám mây riêng tư 4.52.02.

Vui lòng tham khảo bảng dưới đây để xem thông tin tóm tắt về các chiến lược khôi phục mà bạn có thể sử dụng:

Trường hợp Chiến lược khôi phục
Một DC, một số nút Cassandra được nâng cấp Sử dụng bản sao lưu
Một DC, tất cả các nút Cassandra đều được nâng cấp Không khôi phục Cassandra. Bạn có thể khôi phục các thành phần khác.
Một trung tâm dữ liệu, tất cả các nút (Cassandra và các nút khác) đều được nâng cấp Không khôi phục Cassandra. Bạn có thể khôi phục các thành phần khác.
Nhiều DC, một số nút trong một DC được nâng cấp Xây dựng lại từ DC hiện có
Nhiều trung tâm dữ liệu, tất cả các nút Cassandra trong một số trung tâm dữ liệu đã được nâng cấp Xây dựng lại từ DC hiện có
Nhiều DC, nút Cassandra của DC cuối cùng đang được nâng cấp Hãy thử hoàn tất quá trình nâng cấp. Nếu không thực hiện được, hãy khôi phục 1 DC bằng bản sao lưu. Tạo lại các DC còn lại từ DC được khôi phục.
Nhiều DC, tất cả các nút Cassandra đều được nâng cấp Không khôi phục Cassandra. Bạn có thể khôi phục các thành phần khác.
Nhiều DC, tất cả các nút (Cassandra và các nút khác) được nâng cấp Không khôi phục Cassandra. Bạn có thể khôi phục các thành phần khác.

Lưu ý chung

Khi cân nhắc việc khôi phục, hãy lưu ý những điều sau:

  • Quay lại phiên bản trước của các thành phần thời gian chạy hoặc thành phần quản lý: Nếu muốn quay lại phiên bản 4.52.02 của Đám mây riêng đối với các thành phần như edge-management-server, edge-message-processor hoặc bất kỳ thành phần nào không phải Cassandra, bạn KHÔNG nên quay lại phiên bản trước của Cassandra. Cassandra đi kèm với Private Cloud 4.53.00 tương thích với tất cả các thành phần không phải Cassandra của Edge cho Private Cloud 4.52.02. Bạn có thể khôi phục các thành phần không phải Cassandra bằng phương pháp được liệt kê ở đây trong khi Cassandra vẫn ở phiên bản 4.0.13.
  • Quay lại sau khi toàn bộ cụm Cassandra được nâng cấp lên 4.0.X: Nếu toàn bộ cụm Cassandra của bạn được nâng cấp lên phiên bản 4.0.X trong quá trình nâng cấp lên Private Cloud phiên bản 4.53.00, bạn nên tiếp tục thiết lập cụm này và KHÔNG quay lại Cassandra. Các thành phần như edge-management-server, edge-message-processor, edge-router, v.v. của Đám mây riêng tư phiên bản 4.52.02 tương thích với Cassandra phiên bản 4.0.X.
  • Quá trình khôi phục Cassandra trong quá trình nâng cấp Cassandra: Nếu gặp vấn đề trong quá trình nâng cấp Cassandra, bạn có thể cân nhắc việc khôi phục. Bạn có thể làm theo các chiến lược khôi phục được liệt kê trong bài viết này dựa trên trạng thái của bạn trong quá trình nâng cấp.
  • Quay lại bằng bản sao lưu: Các bản sao lưu được lấy từ Cassandra 4.0.X không tương thích với các bản sao lưu của Cassandra 3.11.X. Để khôi phục Cassandra bằng cách khôi phục bản sao lưu, bạn phải sao lưu Cassandra 3.11.X trước khi thử nâng cấp.

Khôi phục Cassandra bằng cách sử dụng tính năng tạo lại

Điều kiện tiên quyết

  • Bạn đang vận hành một cụm Edge for Private Cloud 4.52.02 trên nhiều trung tâm dữ liệu.
  • Bạn đang trong quá trình nâng cấp Cassandra từ 3.11.X lên 4.0.X và gặp phải vấn đề trong quá trình nâng cấp.
  • Bạn có ít nhất một trung tâm dữ liệu đầy đủ chức năng trong cụm vẫn đang chạy phiên bản cũ hơn của Cassandra (Cassandra 3.11.X).

Quy trình này dựa vào việc truyền trực tuyến dữ liệu từ một trung tâm dữ liệu hiện có. Quá trình này có thể mất một khoảng thời gian đáng kể, tuỳ thuộc vào lượng dữ liệu được lưu trữ trong Cassandra. Bạn nên chuẩn bị để chuyển hướng lưu lượng truy cập thời gian chạy ra khỏi trung tâm dữ liệu này trong khi quá trình khôi phục đang diễn ra.

Các bước tổng quát

  1. Chọn một trung tâm dữ liệu (đã nâng cấp một phần hoặc toàn bộ) mà bạn muốn khôi phục. Chuyển hướng lưu lượng truy cập thời gian chạy đến một trung tâm dữ liệu đang hoạt động khác.
  2. Xác định nút ban đầu trong trung tâm dữ liệu và bắt đầu bằng một trong các nút ban đầu.
  3. Dừng, gỡ cài đặt và dọn dẹp nút Cassandra.
  4. Cài đặt phiên bản cũ của Cassandra trên nút và định cấu hình nếu cần.
  5. Xoá các cấu hình bổ sung đã được thêm trước đó.
  6. Lặp lại các bước trên cho tất cả các nút khởi động trong trung tâm dữ liệu, từng nút một.
  7. Lặp lại các bước trên cho tất cả các nút Cassandra còn lại trong trung tâm dữ liệu, từng nút một.
  8. Xây dựng lại từng nút một từ trung tâm dữ liệu chức năng hiện có.
  9. Khởi động lại tất cả các thành phần edge-* trong trung tâm dữ liệu được kết nối với Cassandra.
  10. Kiểm thử và chuyển hướng lưu lượng truy cập trở lại trung tâm dữ liệu này.
  11. Lặp lại các bước cho từng trung tâm dữ liệu, lần lượt.

Các bước chi tiết

  1. Chọn một trung tâm dữ liệu nơi tất cả hoặc một số nút Cassandra được nâng cấp. Chuyển hướng tất cả lưu lượng truy cập proxy thời gian chạy và lưu lượng truy cập quản lý khỏi trung tâm dữ liệu này trong khi các nút Cassandra trong trung tâm dữ liệu này đang được khôi phục. Đảm bảo tất cả các nút Cassandra đều ở trạng thái UN (Đang hoạt động/Bình thường) khi lệnh nodetool ring được thực thi trên các nút. Nếu một số nút bị ngừng hoạt động, hãy khắc phục sự cố và đưa các nút đó trở lại hoạt động trước khi tiếp tục.

    Hãy xem ví dụ dưới đây:

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    Bạn có thể chạy nodetool describecluster trên các nút để nắm được trạng thái hiện tại của toàn bộ cụm. Ví dụ: sau đây cho thấy một phiên bản của cụm gồm 2 trung tâm dữ liệu, trong đó tất cả các nút DC-1 đều ở phiên bản Cassandra 4, trong khi tất cả các nút DC-2 đều ở phiên bản Cassandra 3:

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. Xác định các nút khởi động trong trung tâm dữ liệu: Tham khảo phần Cách xác định các nút khởi động trong Phụ lục. Thực hiện các bước bên dưới trên một trong các nút ban đầu:
  3. Dừng, gỡ cài đặt và dọn dẹp dữ liệu khỏi nút của Cassandra. Chọn nút ban đầu đầu tiên trên Cassandra phiên bản 4 trong trung tâm dữ liệu này. Dừng lại đi. 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. Cài đặt phần mềm Cassandra cũ trên nút và thiết lập một số cấu hình. Thực thi tệp khởi động của Edge cho Private Cloud 4.52.02. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
  5. Tạo hoặc chỉnh sửa tệp /opt/apigee/customer/application/cassandra.properties.
  6. Thêm nội dung sau vào tệp. ipOfNode là địa chỉ IP của nút mà Cassandra dùng để giao tiếp với các nút Cassandra khác: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. Đảm bảo người dùng apigee sở hữu và có thể đọc tệp: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. Cài đặt và thiết lập Cassandra: 
    # Install cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. Xác minh rằng nút đã bắt đầu. Kiểm tra lệnh sau trên nút này và các nút khác trong cụm. Nút này sẽ báo cáo rằng nó đang ở trạng thái "UN" (Đang hoạt động/Bình thường): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. Xoá các cấu hình bổ sung đã thêm trước đó khỏi tệp /opt/apigee/customer/application/cassandra.properties.
  11. Lặp lại các bước từ 3 đến 10 trên tất cả các nút khởi động Cassandra trong trung tâm dữ liệu, lần lượt từng nút.
  12. Lặp lại các bước từ 3 đến 10 trên tất cả các nút Cassandra còn lại trong trung tâm dữ liệu, từng nút một.
  13. Tạo lại tất cả các nút trong trung tâm dữ liệu từ một trung tâm dữ liệu đang chạy phiên bản Cassandra cũ hơn. Thực hiện bước này cho từng nút một: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    Quy trình này có thể mất thời gian. Bạn có thể điều chỉnh streamingthroughput nếu cần. Kiểm tra nodetool netstats để biết trạng thái hoàn tất của thao tác.

  14. (Không bắt buộc) Thực thi lệnh sửa chữa trong nút Cassandra nếu dữ liệu không được tạo lại. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. Khởi động lại từng thành phần edge-* trong trung tâm dữ liệu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  16. Xác thực và chuyển hướng lưu lượng truy cập trở lại trung tâm dữ liệu này. Chạy một số quy trình xác thực cho lưu lượng truy cập thời gian chạy và API quản lý trong trung tâm dữ liệu này, đồng thời bắt đầu chuyển hướng lưu lượng truy cập API quản lý và proxy trở lại trung tâm dữ liệu đó.
  17. Lặp lại các bước trên cho từng trung tâm dữ liệu mà bạn muốn khôi phục.

Khôi phục Cassandra bằng cách sử dụng bản sao lưu

Điều kiện tiên quyết

  1. Bạn đang trong quá trình nâng cấp Cassandra từ 3.11.X lên 4.0.X và gặp phải vấn đề trong quá trình nâng cấp.
  2. Bạn có bản sao lưu cho nút mà bạn đang khôi phục. Bản sao lưu được tạo trước khi bạn thử nâng cấp từ phiên bản 3.11.X lên 4.0.X.

Các bước

  1. Chọn một nút mà bạn muốn khôi phục. Nếu bạn đang khôi phục tất cả các nút trong một trung tâm dữ liệu bằng bản sao lưu, hãy bắt đầu với các nút ban đầu trước. Hãy tham khảo phần "Cách xác định các nút ban đầu" trong Phụ lục.

  2. Dừng, gỡ cài đặt và dọn dẹp nút Cassandra:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. Cài đặt phần mềm Cassandra cũ trên nút và định cấu hình phần mềm đó:

    • Thực thi tệp khởi động cho Edge for Private Cloud 4.52.02:
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • Tạo hoặc chỉnh sửa tệp /opt/apigee/customer/application/cassandra.properties:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • Đảm bảo tệp thuộc sở hữu của người dùng apigee và có thể đọc được:
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • Cài đặt và thiết lập Cassandra:
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    Xác minh rằng nút đã bắt đầu. Kiểm tra lệnh sau trên nút này và các nút khác trong cụm. Các nút phải báo cáo rằng nút này đang ở trạng thái "UN":

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. Dừng dịch vụ Cassandra và khôi phục bản sao lưu. Hãy tham khảo tài liệu về sao lưu và khôi phục để biết thêm thông tin chi tiết:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. Sau khi khôi phục bản sao lưu, hãy xoá các cấu hình bổ sung:

    Xoá cấu hình đã thêm trước đó khỏi tệp /opt/apigee/customer/application/cassandra.properties.

  6. Khởi động dịch vụ Cassandra trên nút:

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

  7. Lặp lại các bước trên từng nút Cassandra mà bạn muốn khôi phục bằng bản sao lưu, mỗi lần một nút.

  8. Sau khi khôi phục tất cả các nút Cassandra, hãy khởi động lại từng thành phần edge-* một:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Tối ưu hoá hoạt động sao lưu (lựa chọn nâng cao)

Bạn có thể giảm thiểu (hoặc loại bỏ) tình trạng mất dữ liệu trong khi khôi phục bản sao lưu nếu có các bản sao chứa dữ liệu mới nhất. Nếu có bản sao, sau khi khôi phục bản sao lưu, hãy chạy quy trình sửa chữa trên nút đã được khôi phục.

Phụ lục

Cách xác định các nút ban đầu

Trên mọi nút Cassandra trong một trung tâm dữ liệu, hãy chạy lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Lệnh này sẽ xuất ra nhiều dòng. Tìm dòng cuối cùng của đầu ra. Các địa chỉ IP được liệt kê ở dòng cuối cùng là các nút ban đầu. Trong ví dụ bên dưới, DC-1-IP1, DC-1-IP2, DC-2-IP1 và DC-2-IP2 là các IP của nút ban đầu:

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

Khôi phục về một bản phát hành chính hoặc phụ trước đó

Để quay lại một 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 mà bạn muốn quay lại:

    • Để quay lại phiên bản 4.52.02, hãy tải bootstrap_4.52.02.sh xuống: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Dừng thành phần để quay lại phiên bản trướ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ư ví dụ sau đây minh hoạ: 
      /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 bất kỳ thành phần nào khác trên nút, hãy 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 trạng thái trước khi bật 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 Management Server và Message Processor: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Gỡ cài đặt thành phần để quay lại 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. Cách khôi phục Nginx như sau: 
      ###Find the apigee-nginx RPM 
rpm -qa | grep -i "apigee-nginx"

###Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.26.x
    3. Để 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.

    4. Để khôi phục Edge Router, 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.53.00 của apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Cài đặt phiên bản 4.52.02 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 sẽ cài đặt phiên bản 4.52.02 của apigee-service: 
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

    Trong đó, uName và pWord là tên người dùng và mật khẩu mà bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã này.

    Nếu bạn gặp lỗi, hãy nhớ rằng bạn đã 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ũ 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á 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ề một bản phát hành bản vá trước đó

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

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.53.00-0.0.20254 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 hiện có 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

    Xin lưu ý rằng bạn chỉ chỉ đị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 từng 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 thực hiện các bước sau trên tất cả các máy chủ:

  1. Dừ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