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ể quay lại thành phần gây ra lỗi rồi thử cập nhật lại.

Bạn có thể quay lại phiên bản phát hành nhỏ sau đây của Edge 4.53.00:

  • Phiên bản 4.52.02

Việc khôi phục phiên bản sẽ 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, bạn nên cân nhắc đặc biệt khi quay lại Cassandra phiên bản 4.52.02.

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

  1. Khôi phục về một bản phát hành lớn hoặc nhỏ trước đó. Ví dụ: từ phiên bản 4.53.00 xuống 4.52.02.
  2. Khôi phục về bản phát hành bản vá trước đó trong cùng một bản phát hành. Ví dụ: từ 4.53.00.01 thành 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ự của quá trình khôi phục

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

Thứ tự khôi phục chung điển hình cho Private Cloud 4.53.00 sẽ có dạng như sau:

  1. Quay lại Postgres, Qpid và các thành phần khác liên quan đến phân tích
  2. Bộ định tuyến và bộ xử lý thông báo của tính năng khôi phục
  3. Hủy bỏ Cassandra, Zookeeper
  4. Máy chủ quản lý tính năng 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 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. Lần lượt khôi phục tất cả RMP
  2. Quay lại toàn bộ cụm Cassandra bằng cách sử dụng bản sao lưu
  3. Lần lượt khôi phục các nút máy chủ Quản lý Edge

Những người có thể thực hiện việc 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 chạy dưới quyền root.

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 Trình đị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 Trình đị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 dưới vai trò là một người dùng và một thành phần khác dưới vai trò 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 trên một nút, bạn phải khôi phục tất cả các thành phần đó 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 đã cài đặt Máy chủ quản lý, Trình định tuyến và Trình 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 Cassandra

Khôi phục Cassandra

Khi một bản nâng cấp lớn của Cassandra được thực hiện 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ể thực hiện việc khôi phục trực tiếp tại chỗ.

Tình huống khôi phục

Cassandra 4.0.X, có trong Edge for Private Cloud 4.53.00, tương thích với các thành phần khác của Private Cloud 4.52.02.

Vui lòng tham khảo bảng bên dưới để biết 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 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.
Nhiều DC, một số nút trong một DC được nâng cấp Tạo lại từ DC hiện có
Nhiều DC, tất cả các nút Cassandra trong một số DC đã được nâng cấp Tạo lại từ DC hiện có
Nhiều DC, các nút Cassandra của DC gần đây nhất đ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ể, hãy quay lại 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:

  • Huỷ bỏ các thành phần thời gian chạy hoặc thành phần quản lý: Nếu muốn huỷ bỏ 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 về Private Cloud phiên bản 4.52.02, bạn KHÔNG nên huỷ bỏ 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 for Private Cloud 4.52.02. Bạn có thể quay lại các thành phần không phải Cassandra bằng phương pháp được liệt kê tại đây trong khi Cassandra vẫn ở phiên bản 4.0.13.
  • Huỷ bỏ sau khi nâng cấp toàn bộ cụm Cassandra lên phiên bản 4.0.X: Nếu toàn bộ cụm Cassandra đượ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 huỷ bỏ Cassandra. Các thành phần như edge-management-server, edge-message-processor, edge-router, v.v. của Private Cloud phiên bản 4.52.02 tương thích với Cassandra phiên bản 4.0.X.
  • Huỷ bỏ 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 nên cân nhắc việc huỷ bỏ. Bạn có thể làm theo các chiến lược khôi phục nêu 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.
  • Huỷ bằng bản sao lưu: Bản sao lưu lấy từ Cassandra 4.0.X không tương thích với bản sao lưu của Cassandra 3.11.X. Để khôi phục Cassandra bằng tính năng 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.

Quay lại Cassandra bằng cách 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ừ phiên bản 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 hoạt động đầy đủ trong cụm vẫn đang chạy phiên bản Cassandra cũ (Cassandra 3.11.X).

Quy trình này dựa vào dữ liệu truyền trực tuyến 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 trong thời gian chạy 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 trong thời gian chạy đến một trung tâm dữ liệu khác đang hoạt động.
  2. Xác định nút hạt giống trong trung tâm dữ liệu và bắt đầu bằng một trong các nút hạt giống.
  3. Dừng, gỡ cài đặt và dọn dẹp nút Cassandra.
  4. Cài đặt phiên bản Cassandra cũ hơn trên nút và định cấu hình nếu cần.
  5. Xoá các cấu hình bổ sung đã thêm trước đó.
  6. Lặp lại các bước trên cho tất cả các nút hạt giống trong trung tâm dữ liệu, lần lượt từng nú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, lần lượt từng nút.
  8. Tạo lại từng nút từ trung tâm dữ liệu đang hoạt động.
  9. Khởi động lại tất 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.

Các bước chi tiết

  1. Chọn một trung tâm dữ liệu mà 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ý từ 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 (Up/Normal) (Đ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 nhất định bị lỗi, hãy khắc phục sự cố và khôi phục các nút đó 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 để hiểu trạng thái hiện tại của toàn bộ cụm. Ví dụ: phần sau đây cho thấy một thực thể của cụm 2 trung tâm dữ liệu, trong đó tất cả các nút DC-1 đều chạy Cassandra phiên bản 4, còn tất cả các nút DC-2 đều chạy Cassandra phiên bản 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 hạt giống trong trung tâm dữ liệu: Tham khảo phần Cách xác định các nút hạt giống trong Phụ lục. Thực thi các bước dưới đây trên một trong các nút hạt giống:
  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 hạt giống đầu tiên trên Cassandra phiên bản 4 trong trung tâm dữ liệu này. Dừng lạ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 for 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

Đặt cấu hình Cassandra

  1. Tạo hoặc chỉnh sửa tệp /opt/apigee/customer/application/cassandra.properties.
  2. Thêm nội dung sau vào tệp. ipOfNode là địa chỉ IP của nút mà Cassandra sử 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
  3. Đả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
  4. Cài đặt và thiết lập Cassandra:
    • Cài đặt Cassandra phiên bản 3.11.X: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • Thiết lập Cassandra bằng cách truyền tệp cấu hình chuẩn: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • Đảm bảo rằng bạn đã cài đặt Cassandra 3.11.X và dịch vụ đang chạy: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. 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 sẽ báo cáo rằng nó đang ở trạng thái "UN" (Up/Normal – Mở/Bình thường): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. Xoá các cấu hình bổ sung đã thêm trước đó khỏi tệp /opt/apigee/customer/application/cassandra.properties.
  7. Lặp lại các bước từ 3 đến 6 trên tất cả các nút hạt giống Cassandra trong trung tâm dữ liệu, lần lượt từng nút.
  8. Lặp lại các bước từ 3 đến 6 trên tất cả các nút Cassandra còn lại trong trung tâm dữ liệu, lần lượt từng nút.
  9. 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 chạy phiên bản Cassandra cũ. Thực hiện bước này 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 chút thời gian. Bạn có thể điều chỉnh streamingthroughput nếu cần. Kiểm tra trạng thái bằng: 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. 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
  11. 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 định tuyến lại lưu lượng truy cập proxy và API quản lý trở lại trung tâm dữ liệu này.
  12. 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.

Huỷ bỏ Cassandra bằng tính năng 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ừ phiên bản 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ó các bản sao lưu cho nút mà bạn đang khôi phục. Bản sao lưu được thực hiện trước khi nâng cấp từ 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 hạt giống trước. Tham khảo phần "Cách xác định nút hạt giống" 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 quyền 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ề cách 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.

  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á tính năng sao lưu (tuỳ chọn nâng cao)

Bạn có thể giảm thiểu (hoặc loại bỏ) việc mất dữ liệu trong khi khôi phục bản sao lưu nếu 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 đã khôi phục.

Phụ lục

Cách xác định nút hạt giống

Trên bất kỳ nút Cassandra nào trong 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 kết quả. Các địa chỉ IP được liệt kê trong dòng cuối cùng là các nút hạt giống. Trong ví dụ bên dưới, DC-1-IP1, DC-1-IP2, DC-2-IP1 và DC-2-IP2 là địa chỉ IP của nút hạt giống:

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

Quay lại 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:
    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 bất kỳ thành phần khác nào trên nút, hãy chỉ dừng thành phần đó: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Nếu bạn đang huỷ 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 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, hãy 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.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 đó. 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 giá trị này.

    Nếu bạn gặp lỗi, hãy đảm bảo 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ũ 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 của bạn cho phiên bản cũ.

  9. Nếu bạn đang quay lại Qpid, hãy xoá sạch 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.

Quay lại 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 bản vá 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 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

    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 làm theo các bước sau trên tất cả máy chủ lưu trữ:

  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