Trang này được dịch bởi Cloud Translation API.

Khôi phục Apigee Edge 4.52.02

Nếu gặp lỗi trong quá trình cập nhật lên Edge 4.52.02, 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 Edge 4.52.02 bằng bất kỳ phiên bản phát hành chính nào sau đây:

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

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, dựa trên phiên bản bạn bắt đầu, bạn có thể cần phải cân nhắc các bước đặc biệt trước khi quay lại một số thành phần phần mềm nhất định. Bảng sau đây liệt kê các thành phần phần mềm khác nhau 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	Các điểm cần cân nhắc đặc biệt đối với phần mềm
4.52.01	Cassandra
4.52.00	Zookeeper, Cassandra, Qpid
4.51.00	Zookeeper, Postgres, Cassandra, Qpid

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

Khôi phục về một bản phát hành lớn hoặc nhỏ trước đó. Ví dụ: từ 4.52.02 thành 4.52.00.
Hãy quay lại 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.52.00.02 thành 4.52.00.01.

Để 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

Quá trình khôi phục các thành phần phải tuân theo thứ tự đảo ngược của quá trình nâng cấp, ngoại trừ việc Máy chủ quản lý phải được khôi phục sau Cassandra. Bạn nên khôi phục Cassandra, các thành phần Thời gian chạy và Máy chủ quản lý bằng cách sử dụng phương pháp trung tâm dữ liệu theo trung tâm dữ liệu (DC-by-DC), tạm thời chuyển hướng lưu lượng truy cập đến các trung tâm dữ liệu đang hoạt động.

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

Một trung tâm dữ liệu

Đối với chế độ thiết lập một trung tâm dữ liệu, quy trình khôi phục sẽ ảnh hưởng đáng kể đến lưu lượng truy cập trong thời gian chạy và một số API quản lý nhất định.

Huỷ bỏ Qpid và các thành phần khác liên quan đến phân tích
Bộ định tuyến và bộ xử lý thông báo của tính năng khôi phục
Khôi phục Cassandra
Máy chủ quản lý tính năng khôi phục
Quay lại Postgres và Zookeeper

Nhiều trung tâm dữ liệu

Trong chế độ thiết lập nhiều trung tâm dữ liệu, việc khôi phục phải tuân theo phương pháp trung tâm dữ liệu theo trung tâm dữ liệu (DC-by-DC) bằng cách tạm thời chuyển hướng lưu lượng truy cập đến các trung tâm dữ liệu đang hoạt động. Điều này đảm bảo tính liên tục của lưu lượng truy cập, tránh thời gian ngừng hoạt động và cho phép kiểm soát quy trình khôi phục cho Cassandra, Máy chủ quản lý và Các nút thời gian chạy.

Quay lại Qpid và các thành phần khác liên quan đến phân tích trên tất cả các DC.
Chặn lưu lượng truy cập trong trung tâm dữ liệu đầu tiên và định tuyến lại lưu lượng truy cập đến các trung tâm dữ liệu khác.
Chuyển về trạng thái trước đó cho Trình định tuyến và Trình xử lý thông báo trong trung tâm dữ liệu đầu tiên.
Quay lại Cassandra trong trung tâm dữ liệu đầu tiên.
Máy chủ Quản lý rollback trong trung tâm dữ liệu đầu tiên.
Huỷ chặn lưu lượng truy cập trong trung tâm dữ liệu đầu tiên và làm theo bước 2 đến bước 6 cho đến khi trung tâm dữ liệu cuối cùng được khôi phục các nút Thời gian chạy, Cassandra và máy chủ Quản lý.
Huỷ bỏ Postgres, Zookeeper và LDAP trên tất cả các DC.

Để hiểu rõ hơn, 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ố Trình xử lý thông báo thời gian chạy (RMP) từ phiên bản 4.52.01 lên 4.52.02 và cần thực hiện việc khôi phục. Trong trường hợp này, bạn nên thực hiện việc khôi phục như sau:

Chặn lưu lượng truy cập đến trung tâm dữ liệu đầu tiên (data center) và điều hướng lại lưu lượng truy cập đến các trung tâm dữ liệu đang hoạt động khác để đảm bảo tính liên tục của dịch vụ.
Rollback Routers và Message Processors (Trình định tuyến và trình xử lý thông báo) trong trung tâm dữ liệu đầu tiên.
Hủy bỏ Cassandra trong trung tâm dữ liệu đầu tiên bằng cách khôi phục từ bản sao lưu hoặc ảnh chụp nhanh máy ảo.
Huỷ bỏ Máy chủ quản lý trong trung tâm dữ liệu đầu tiên.
Bỏ chặn lưu lượng truy cập đến trung tâm dữ liệu đầu tiên.
Lặp lại các bước từ 1 đến 5 cho từng trung tâm dữ liệu còn lại cho đến khi tất cả các nút Thời gian chạy, Cassandra và Máy chủ quản lý đều được khôi phục.

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 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 dưới vai trò 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

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 Cassandra cụ thể, Cassandra sẽ sửa đổi giản đồ của dữ liệu được lưu trữ trên nút đó, 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 các phương pháp này dựa trên trạng thái của bản nâng cấp mà bạn đang quay lại.

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

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

Edge for Private Cloud 4.52.02 bao gồm bản nâng cấp trong Cassandra và trình điều khiển mà trình xử lý thông báo và máy chủ quản lý sử dụng để kết nối với Cassandra. Do đó, việc nâng cấp và khôi phục 3 thành phần này có liên quan chặt chẽ với nhau. Bảng dưới đây liệt kê các ví dụ chung về các trường hợp khôi phục cho 3 thành phần cụ thể này. Bạn nên khôi phục các thành phần khác theo phần thứ tự của quá trình khôi phục.

Phần này trình bày các tình huống khôi phục khác nhau cùng với phương pháp được đề xuất cần tuân theo, dựa trên các phương pháp được mô tả ở trên.

Trường hợp	Chiến lược khôi phục
Một trung tâm dữ liệu, một số nút Cassandra được nâng cấp	Khôi phục bản sao lưu
Một trung tâm dữ liệu, tất cả các nút Cassandra đều được nâng cấp	Khôi phục bản sao lưu
Một trung tâm dữ liệu, tất cả các nút (Cassandra, máy chủ quản lý và nút Thời gian chạy) được nâng cấp	Hoạt động khôi phục nút thời gian chạy Khôi phục bản sao lưu Cassandra Huỷ bỏ quản lý
Nhiều trung tâm dữ liệu, một số/tất cả các nút Cassandra trong trung tâm dữ liệu đầu tiên đã được nâng cấp	Tạo lại từ trung tâm dữ liệu hiện có
Nhiều trung tâm dữ liệu, tất cả các nút Cassandra, máy chủ Quản lý và nút Thời gian chạy trong trung tâm dữ liệu đầu tiên đã được nâng cấp	Hoạt động khôi phục nút thời gian chạy Khôi phục bản dựng lại Cassandra Huỷ bỏ quản lý Bạn chỉ nên thực hiện việc này trên một trung tâm dữ liệu tại một thời điểm.
Nhiều trung tâm dữ liệu, một số/tất cả các nút Cassandra của trung tâm dữ liệu gần đây được nâng cấp	Quay lại trung tâm dữ liệu gần đây nhất bằng cách sử dụng tính năng sao lưu Hãy khôi phục các trung tâm dữ liệu còn lại bằng cách sao lưu hoặc tạo lại, mỗi lần một trung tâm dữ liệu.
Nhiều trung tâm dữ liệu, tất cả các nút Cassandra, máy chủ Quản lý và nút Thời gian chạy được nâng cấp trong tất cả các trung tâm dữ liệu	Hoạt động khôi phục nút thời gian chạy Khôi phục bản sao lưu Cassandra Huỷ bỏ quản lý Bạn nên thực hiện việc này từng trung tâm dữ liệu một.

Nhìn chung, bạn nên cân nhắc những điều sau đây khi khôi phục Cassandra:

Huỷ bỏ thời gian chạy hoặc các thành phần quản lý
Nếu bạn cần khôi phục các thành phần như Máy chủ quản lý Edge hoặc Trình xử lý thông báo Edge về phiên bản Edge Private Cloud trước đó trong bất kỳ trung tâm dữ liệu (DC) nào, hãy đảm bảo rằng Cassandra cũng được khôi phục trong trung tâm dữ liệu cụ thể đó cùng một lúc. Điều này là cần thiết để ngăn chặn các lỗi quản lý và lưu lượng truy cập trong thời gian chạy.
Huỷ bỏ bằng bản sao lưu
Các bản sao lưu được lấy từ Cassandra 3.11.x không tương thích với các bản sao lưu từ Cassandra 2.1.x. Để bật tính năng khôi phục bản sao lưu nhằm thực hiện việc khôi phục, hãy đảm bảo rằng bạn đã sao lưu Cassandra 2.1.x trước khi nâng cấp.
Phân tách Trung tâm dữ liệu để khôi phục
Để tránh thời gian ngừng hoạt động, hãy đảm bảo rằng lưu lượng truy cập được chuyển hướng đến các trung tâm dữ liệu hoạt động đầy đủ và bị chặn khỏi trung tâm dữ liệu đang thực hiện quá trình khôi phục.

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.51.00 / 4.52.00 / 4.52.01 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 2.1.X lên 3.11.X và gặp vấn đề trong quá trình nâng cấp
Bạn có ít nhất 1 trung tâm dữ liệu hoạt động đầy đủ trong cụm vẫn đang sử dụng phiên bản Cassandra cũ (Cassandra 2.1.X)

Các bước cấp cao

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 tất cả lưu lượng truy cập ứng dụng từ trung tâm dữ liệu này sang một trung tâm dữ liệu khác hoạt động đầy đủ.
Nếu bạn đã nâng cấp Trình xử lý thông báo và Bộ định tuyến, hãy lần lượt khôi phục tất cả các nút Bộ định tuyến và trình xử lý thông báo trong trung tâm dữ liệu.
Dừng Cassandra trên một nút, gỡ cài đặt nút đó và dọn dẹp tất cả dữ liệu liên kết.
Cài đặt trình tự khởi động phiên bản trước và thiết lập Cassandra phiên bản 2.1.x trên nút đã dọn dẹp.
Tạo lại nút từ trung tâm dữ liệu chức năng hiện có vẫn đang chạy Cassandra 2.1.x.
Thực hiện các bước 3 đến 5 trên từng nút Cassandra còn lại trong trung tâm dữ liệu, mỗi lần một nút.
Chạy lại quy trình thiết lập Máy chủ quản lý trong trung tâm dữ liệu.
Kiểm thử để xác thực quá trình khôi phục. Sau khi xác minh, hãy chuyển hướng lưu lượng truy cập của ứng dụng trở lại trung tâm dữ liệu đã khôi phục.
Lặp lại các bước trên cho các trung tâm dữ liệu khác cần khôi phục, lần lượt từng trung tâm một.

Các bước chi tiết để xoá sạch và sử dụng các nút hiện có trong cụm để tạo lại nút:

Bắt đầu với nút bạn muốn khôi phục

Đảm bảo rằng lưu lượng truy cập được chuyển hướng đến các trung tâm dữ liệu hoạt động đầy đủ trước khi tiếp tục các bước tiếp theo.
Nếu Trình xử lý thông báo và Trình định tuyến đã được nâng cấp, hãy lần lượt khôi phục tất cả nút Trình định tuyến và trình xử lý thông báo về phiên bản trước trong trung tâm dữ liệu.

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 và chạy trình tự khởi động của phiên bản Edge for Private Cloud cũ mà bạn muốn quay lại:

Ví dụ: Cách quay lại phiên bản 4.52.01

Tải bootstrap phiên bản 4.52.01 xuống:

curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

Thực thi bootstrap của phiên bản 4.52.01:

sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

Cài đặt Phần mềm Cassandra trên nút:
```
apigee-service apigee-cassandra install
```

Thêm thuộc tính dưới đây vào tệp /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.

JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

Ví dụ:

JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

Thiết lập Cassandra trên nút:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
```
Lưu ý: Trong trường hợp thiết lập Cassandra không thành công, hãy chỉnh sửa tệp /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh và xoá dòng chứa: JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>" Sau khi thực hiện thay đổi này, hãy chạy lại tập lệnh setup.sh ở trên để thử lại quá trình thiết lập.
Sau khi Cassandra UP và RUNNING, hãy xoá CWC ở trên khỏi tệp bên dưới:tệp /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.
Khởi động lại nút Cassandra
```
apigee-service apigee-cassandra restart
```

Thực thi việc tạo 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>

Ví dụ:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

Lặp lại các bước trên trên từng nút mà bạn muốn khôi phục trong trung tâm dữ liệu.

Sau khi tất cả các nút Cassandra trong trung tâm dữ liệu đượ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 trong trung tâm dữ liệu đang được khôi phục. Đảm bảo máy chủ quản lý là của phiên bản đã được khôi phục. Nếu không, hãy khôi phục máy chủ quản lý.

Khôi phục máy chủ quản lý về phiên bản cũ

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 edge-gateway và apigee-cassandra-client:

/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall

Tải xuống và thực thi tính năng khởi động của phiên bản cũ. Ví dụ: hãy thực hiện các bước sau để tải xuống và thực thi bootstrap 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
```

Thiết lập máy chủ quản lý

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
```
Sau khi hoàn tất các bước trên, hãy chuyển hướng lưu lượng truy cập trở lại trung tâm dữ liệu đã được khôi phục.

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 tính năng sửa chữa sau khi tất cả bản sao đã được truyền trực tuyến đến trung tâm dữ liệu cục bộ. Điều này giúp tránh truyền trực tuyến giữa các trung tâm dữ liệu và sẽ nhanh hơn so với việc tạo lại tất cả các nút từ một trung tâm dữ liệ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 dưới đây để khôi phục bản sao lưu và chạy quy trình sửa chữa.

Làm theo quy trình cho đến các bước nêu trên như đã ghi nhận để tạo lại bản sao trong trung tâm dữ liệu cục bộ.
Đối với các nút còn lại, hãy làm theo các bước bên dưới trên từng nút còn lại.

Khôi phục bản sao lưu mà bạn đã chụp 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ó ảnh chụp nhanh máy ảo của nút, bạn có thể khôi phục ảnh chụp nhanh 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 hiện 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>

Ví dụ:

/opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

Lặp lại tất cả các bước nêu trên trong Bước 2 trên từng nút mà bạn muốn sửa

Hủy bỏ Cassandra bằng bản sao lưu / ảnh chụp nhanh máy ảo

Đây là quy trình duy nhất có thể áp dụng nếu bạn đã 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 là dành riêng cho nút. Bạn không thể khôi phục bản sao lưu được lấy từ một nút vào một nút khác. Bản sao lưu Cassandra bao gồm thông tin siêu dữ liệu nút (chẳng hạn như địa chỉ IP, vị trí vòng, v.v.).

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

Bạn đang trong quá trình nâng cấp Cassandra từ phiên bản 2.1.X lên 3.11.X trong trung tâm dữ liệu gần đây nhất và gặp phải vấn đề trong quá trình nâng cấp.
Bạn có bản sao lưu cho nút trước khi nâng cấp mà bạn đang quay lại. Bản sao lưu được thực hiện trước khi nâng cấp từ 2.1.X lên 3.11.X.

Các bước cấp cao

Chọn một trung tâm dữ liệu (đã nâng cấp một phần hoặc toàn bộ) để khôi phục. Chuyển hướng tất cả lưu lượng truy cập trong thời gian chạy từ trung tâm dữ liệu này sang một trung tâm dữ liệu khác hoạt động đầy đủ.
Nếu bộ định tuyến và trình xử lý thông báo đã được nâng cấp, hãy lần lượt khôi phục tất cả các nút bộ định tuyến và trình xử lý thông báo trong trung tâm dữ liệu
Dừng Cassandra trên một nút, gỡ cài đặt nút đó và dọn dẹp tất cả dữ liệu liên kết.
Cài đặt trình tự khởi động phiên bản trước và thiết lập Cassandra phiên bản 2.1.x trên nút đã dọn dẹp.
Dừng nút Cassandra và dọn dẹp tất cả dữ liệu liên quan.
Khôi phục nút Cassandra từ bản sao lưu được thực hiện trước khi nâng cấp.
Lặp lại các bước từ 3 đến 6 cho từng nút Cassandra còn lại trong trung tâm dữ liệu, mỗi lần một nút.
Chạy lại quy trình thiết lập Máy chủ quản lý trong trung tâm dữ liệu.
Kiểm thử để xác thực quá trình khôi phục. Sau khi xác minh, hãy chuyển hướng lưu lượng truy cập trong thời gian chạy trở lại trung tâm dữ liệu đã khôi phục.
Lặp lại các bước trên cho các trung tâm dữ liệu khác cần khôi phục, lần lượt từng trung tâm một.
(Không bắt buộc) Thực thi lệnh sửa chữa trên tất cả các nút Cassandra trong tất cả các trung tâm dữ liệu nếu có sự không nhất quán về dữ liệu giữa các nút đó.

Các bước chi tiết để khôi phục Cassandra bằng bản sao lưu/ảnh chụp nhanh máy ảo

Bắt đầu với 1 nút cassandra trong cụm

Đảm bảo rằng lưu lượng truy cập được chuyển hướng đến các trung tâm dữ liệu hoạt động đầy đủ trước khi tiếp tục các bước tiếp theo.
Nếu bộ định tuyến và trình xử lý thông báo đã được nâng cấp, hãy lần lượt khôi phục tất cả nút bộ định tuyến và trình xử lý thông báo về phiên bản trước trong trung tâm dữ liệu.

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 và chạy trình tự khởi động của phiên bản Edge for Private Cloud cũ mà bạn muốn quay lại:

Ví dụ: Cách quay lại phiên bản 4.52.01

Tải bootstrap phiên bản 4.52.01 xuống:

curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

Thực thi bootstrap 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

Dừng Cassandra trên nút:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

Xoá thư mục dữ liệu trên nút:

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 các bước trên từng nút Cassandra.
Chạy quy trình thiết lập bất kỳ nút máy chủ quản lý nào trong trung tâm dữ liệu đang được khôi phục. Đảm bảo máy chủ quản lý là của phiên bản đã được khôi phục. Nếu không, hãy khôi phục máy chủ quản lý.
Sau khi hoàn tất các bước trên, hãy chuyển hướng lưu lượng truy cập trở lại trung tâm dữ liệu đã được khôi phục.
(Không bắt buộc) Thực thi lệnh sửa chữa trên tất cả các nút Cassandra trong tất cả các trung tâm dữ liệu nếu có sự không nhất quán về dữ liệu giữa các nút đó.
```
/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
```

Huỷ bỏ bản cập nhật Zookeeper 3.8.3

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

Nếu bạn đang quay lại phiên bản 4.52.01, hãy quay lại Zookeeper như cách bạn quay lại bất kỳ phần mềm nào, như được liệt kê trong phần Quay lại bản phát hành chính hoặc phụ trước đó bên dưới.

Khôi phục Qpid

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

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

Huỷ bỏ bản cập nhật Postgres 10.17

Nếu đang quay lại phiên bản 4.51.00, bạn cần tham khảo một số bước đặc biệt trước khi quay lại Postgres. Các bước này được liệt kê trong phần Huỷ bỏ.

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

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:

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.51.00, hãy tải bootstrap_4.51.00.sh xuống

Dừng thành phần để quay lại:

Để 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

Để 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
```

Nếu bạn đang khôi phục 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
```
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 và apigee-cassandra-client, như trong ví dụ sau:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client 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 *
```

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

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 sẽ 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 mà bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập.

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.

Cài đặt apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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ũ.
Nếu bạn đang khôi phục Qpid, hãy xoá sạch iptables:
```
sudo iptables -F
```
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:

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.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 sử dụng lệnh sau:
```
yum --showduplicates list component
```
Ví dụ:
```
yum --showduplicates list edge-ui
```
Sử dụng apigee-setup để cài đặt thành phần:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -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.
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ữ:

Dừng Apigee:
```
apigee-all stop
```
Dừng mTLS:
```
apigee-service apigee-mtls uninstall
```

Cài đặt lại mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf