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

4.18.01 Quy trình khôi phục

Edge cho đám mây riêng tư phiên bản 4.18.01

Nếu xảy ra lỗi trong quá trình cập nhật lên Edge 4.18.01, 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. Ví dụ: nếu quá trình cập nhật lên Postgres 9.6 không thành công, bạn có thể chỉ khôi phục các nút Postgres rồi thử cập nhật lại.

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

Khôi phục về bản phát hành cũ. Ví dụ: từ 4.18.01 đến 4.17.01.
Khôi phục về phiên bản cũ trong cùng một bản phát hành.

Hãy sử dụng quy trình dưới đây để khôi phục trong cả hai trường hợp.

Ai có thể khôi phục

Người dùng thực hiện quá trình 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 với tư cách 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ể chạy các thành phần Edge dưới dạng 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 ở cấp độ gốc hoặc với tư cách là 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 một người dùng và một thành phần khác với tư cách người dùng khác.

Những thành phần nào có thể khôi phục về trạng thái ban đầu

Bạn nên lưu ý các điều kiện sau khi khôi phục:

5 thành phần Edge được liệt kê dưới đây có chung một đoạn mã. Do đó, để khôi phục bất kỳ thành phần nào trong số 5 thành phần trên nút, bạn phải khôi phục bất kỳ thành phần nào trong số 5 thành phần đã cài đặt trên nút đó. Ví dụ: nếu bạn đã cài đặt Máy chủ quản lý, Bộ định tuyến và Bộ xử lý thông báo trên nút, thì để khôi phục bất kỳ một trong số nào trong số đó, bạn phải khôi phục cả ba.

Năm thành phần dùng chung mã là:
- Máy chủ quản lý
- Bộ định tuyến
- Bộ xử lý thư
- Máy chủ Qpid
- Máy chủ Postgres
Nếu bạn đang cập nhật từ Edge 4.16.01, đừng khôi phục Cassandra. Bản phát hành Edge này chứa một phiên bản cập nhật của Cassandra. Nếu bạn khôi phục bất kỳ thành phần nào, hãy để Cassandra ở phiên bản 4.18.01.

Khôi phục 4.18.01

Phần này chứa quy trình khôi phục Edge 4.18.01 về phiên bản trước đó. Phần này được chia thành 2 phần:

Khôi phục bản cập nhật Postgres
Phần cuối cùng của mọi quy trình cập nhật là cập nhật các nút Postgres lên phiên bản 9.6. Nếu quá trình cập nhật đó không thành công, bạn có thể dùng quy trình này để khôi phục bản cập nhật.
Khôi phục tất cả thành phần khác trong Edge
Sử dụng quy trình này để khôi phục mọi thành phần khác trong Edge.

Cách khôi phục bản cập nhật Postgres 9.6

Để khôi phục bản cập nhật Postgres khi cập nhật Postgres trong cấu hình chờ chính, bạn cần:

Quảng bá nút chế độ chờ mới để trở thành nút chính Postgres. Phiên bản chính Postgres mới sẽ giống với phiên bản bản cài đặt Edge trước đó.
Định cấu hình nút chế độ chờ cũ thành nút chế độ chờ của nút chính mới. Nút chế độ chờ cũ sẽ giống phiên bản như lần cài đặt Edge trước đó.
Đăng ký nút chính và nút chờ mới với nhóm phân tích và nhóm người tiêu dùng.

Khi bạn hoàn tất quá trình khôi phục, nút chính cũ sẽ không còn cần thiết nữa. Sau đó, bạn có thể gỡ bỏ nút chính cũ.

Đảm bảo nút Postgres ở chế độ chờ mới đang chạy:
```
> /opt/apigee/apigee-service/bin/apigee-all status
```
Nếu Postgres không chạy, hãy khởi động:
```
> /opt/apigee/apigee-service/bin/apigee-all start
```

Đảm bảo Postgres đã dừng trên nút chính cũ và nút chế độ chờ cũ:

> /opt/apigee/apigee-service/bin/apigee-all status

Nếu Postgres đang chạy, hãy dừng ứng dụng này:

> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

Nếu đã cài đặt, hãy khởi động Qpid trên nút chế độ chờ cũ:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Lưu ý: Trong nhiều cấu hình, nút chế độ chờ cũ sẽ chỉ lưu trữ Postgres chứ không lưu trữ Qpid.
Quảng bá nút chế độ chờ mới làm nút chính Postgres:
1. Chuyển nút chế độ chờ mới thành trang chính mới:
```
> apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
  Nếu được nhắc, hãy nhập mật khẩu Postgres cho người dùng "apigee", theo mặc định là "postgres".
2. Chỉnh sửa tệp cấu hình bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định các thông tin sau:
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
3. Định cấu hình trang cái mới:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
Tạo lại nút chế độ chờ cũ:
1. Chỉnh sửa tệp cấu hình bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định các thông tin sau:
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
2. Xoá thư mục dữ liệu trên nút chế độ chờ cũ:
```
> cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
3. Định cấu hình lại nút chế độ chờ cũ thành nút chế độ chờ của trang cái mới:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
4. Đảm bảo Postgres đang chạy trên nút chế độ chờ cũ:
```
> /opt/apigee/apigee-service/bin/apigee-all status
```
  Nếu chương trình này không chạy, hãy khởi động:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
Xác minh nút chế độ chờ mới đã được thêm bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên trang cái mới.

Xem số liệu phân tích hiện tại và thông tin về nhóm người tiêu dùng bằng cách chạy lệnh sau trên Máy chủ quản lý:

> curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

Lệnh này trả về tên nhóm phân tích trong trường name và tên nhóm người tiêu dùng trong trường name trong consumer-groups. Thao tác này cũng trả về các mã nhận dạng duy nhất (UUID) của các nút chính và nút chờ của Postgres cũ trong trường postgres-server và trong trường datastores. Bạn sẽ thấy kết quả dưới dạng:

{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}

Lấy địa chỉ UUID của nút chính cũ bằng cách chạy lệnh cURL sau trên nút chính cũ:
```
> curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Bạn sẽ thấy UUID của nút ở cuối kết quả, có dạng:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Lưu ý: Dịch vụ edge-postgres-server phải đang chạy. Nếu máy chủ Postgres không chạy, bạn có thể chạy lệnh sau trên Máy chủ quản lý để xác định mã nhận dạng duy nhất (UUID):
```
> curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
Kết quả của lệnh này liệt kê UUID cho địa chỉ IP của mỗi nút Postres.
Lặp lại bước trước đó để lấy địa chỉ IP của nút chế độ chờ cũ và nút chính mới.
Xoá nút chính và nút chờ cũ khỏi nhóm người dùng:
```
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
```
trong đó axgroup-001 và consumer-group-001 là tên mặc định của số liệu phân tích và nhóm người tiêu dùng. masterUUID,standbyUUID tuân theo thứ tự như chúng xuất hiện ở trên khi bạn xem số liệu phân tích hiện tại và thông tin về nhóm người tiêu dùng ở trên. Bạn có thể phải chỉ định các giá trị này là standbyUUID,masterUUID.

Hiện tại, thuộc tính datastores cho consumer-groups phải trống.

Xoá các nút chính và nút chờ cũ khỏi nhóm phân tích:

> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

Thuộc tính postgres-server trong uuids hiện phải trống.

Đăng ký nút chính và nút chờ PG mới với các nhóm phân tích và người tiêu dùng:

> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
> curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

Xác thực nhóm số liệu phân tích:
```
> curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
Bạn sẽ thấy mã nhận dạng duy nhất (UUID) của nút chính và nút chế độ chờ mới được liệt kê trong nhóm số liệu phân tích và nhóm người tiêu dùng.

Khởi động lại máy chủ quản lý Edge:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Khởi động lại tất cả máy chủ Qpid:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

Khởi động lại tất cả máy chủ Postgres:

> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống phải cho thấy các kết quả giống nhau trên cả hai máy chủ để đảm bảo sao chép thành công:

Trên trang cái mới, hãy chạy:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Xác thực rằng đó là chính. Trên nút chế độ chờ cũ:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Xác thực rằng đó là chế độ chờ.
Lặp lại bước trước đó sau khi thực hiện một số yêu cầu API để đảm bảo các nút đang được đồng bộ hoá.
Hãy gỡ bỏ ứng dụng chính Postgres cũ bằng quy trình trong Cập nhật Apigee Edge 4.16.01/4.16.05 lên 4.17.09.
Lưu ý: Nếu nút chính cũ đang chạy Qpid, bạn có thể để máy chủ đó chạy Qpid. Đảm bảo rằng tiện ích đang chạy. Nếu chưa, hãy bắt đầu tạo:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
Ngoài ra, bạn có thể gỡ cài đặt Qpid khỏi bản chính cũ rồi cài đặt Qpid trên nút chính mới, như mô tả dưới đây. Sau khi gỡ cài đặt Qpid, bạn có thể gỡ bỏ nút chính cũ.

Uninstal Qpid từ trang chủ cũ và cài đặt Qpid trên trang chủ mới

Sử dụng quy trình sau để gỡ cài đặt Qpid khỏi bản chính cũ và cài đặt trên bản chính mới:

Chặn quyền truy cập vào cổng Qpid 5672 trên trang chủ cũ để Bộ xử lý thông báo không truy cập được bằng cách chạy lệnh sau trên tất cả Bộ xử lý thông báo:
```
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
```
Đảm bảo hàng đợi thông báo Qpid trống bằng cách chạy lệnh sau. Bạn không thể gỡ cài đặt Qpid cho đến khi ứng dụng này xử lý tất cả thông báo đang chờ xử lý:
```
> qpid-stat -q
```
Lệnh này hiển thị một bảng chứa số lượng của msg, msgIn, and msgOut. Tất cả thư sẽ được xử lý khi msg=0 và msgIn=msgOut.
Xác định UUID của máy chủ Qpid trên bản chính cũ bằng cách chạy lệnh sau trên bản chính cũ. Lưu thông tin này để xem sau trong quy trình:
```
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
```

Dừng Qpid trên trang chủ cũ:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

Gỡ cài đặt máy chủ Qpid:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Xoá máy chủ Qpid cũ khỏi các nhóm số liệu phân tích và nhóm người tiêu dùng:

> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v

Xoá máy chủ Qpid cũ khỏi Zookeeper:

> curl -u sysAdminEmail:password -X DELETE
  http://ms_IP:8080/v1/servers/qpid_UUID

Cài đặt Qpid trên trang cái mới:

> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

Xác định UUID của máy chủ Qpid trên trang cái mới bằng cách chạy lệnh sau trên trang cái mới. Lưu thông tin này để xem sau trong quy trình:
```
> curl -u sysAdminEmail:password
  http://node_IP::8083/v1/servers/self
```

Đăng ký máy chủ Qpid mới với các nhóm số liệu phân tích và nhóm người tiêu dùng:

> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
> curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers?uuid=qpid_UUID" -v

Khởi động lại tất cả Bộ xử lý thư:

> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Chạy lệnh sau trên máy chủ Qpid mới để kiểm tra xem các hàng đợi đã được tạo hay chưa:
```
> qpid-stat -q
```
Đảm bảo rằng bạn thấy msg, msgIn và msgOut được cập nhật khi máy chủ Qpid xử lý tin nhắn.

Cách khôi phục từng thành phần từ phiên bản 4.18.01

Trong quá trình khôi phục, bạn phải tải tệp bootstrap.sh cho phiên bản Edge hiện tại xuống:

Để khôi phục về phiên bản 4.17.09, hãy tải bootstrap_4.17.09.sh xuống
Để khôi phục về phiên bản 4.17.05, hãy tải bootstrap_4.17.05.sh xuống
Để khôi phục về phiên bản 4.17.01, hãy tải bootstrap_4.17.01.sh xuống
Để khôi phục về phiên bản 4.16.09, hãy tải bootstrap_4.16.09.sh xuống
Để khôi phục về phiên bản 4.16.05, hãy tải bootstrap_4.16.05.sh xuống
Để khôi phục về phiên bản 4.16.01, hãy tải bootstrap.sh xuống

Đối với mỗi nút lưu trữ một thành phần để khôi phục:

Dừng thành phần để khôi phục:
1. Nếu đang khôi phục bất kỳ thành phần nào sau đây trên nút, bạn phải dừng tất cả các thành phần đó: Máy chủ quản lý, Bộ định tuyến, Bộ xử lý thư, Máy chủ Qpid hoặc Máy chủ Postgres:
  - ```
  > apigee-service edge-management-server stop
```
- ```
> apigee-service edge-router stop
```
  - ```
  > apigee-service edge-message-processor stop
```
- ```
> apigee-service edge-qpid-server stop
```
  - ```
  > apigee-service edge-postgres-server stop
```
2. Nếu bạn đang khôi phục bất kỳ thành phần nào khác trên nút, chỉ dừng lại thành phần đó:
  - ```
  > apigee-service comp stop
```
Nếu bạn 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ư:
```
> apigee-service edge-mint-gateway uninstall
```
Gỡ cài đặt thành phần để khôi phục trên nút:
1. Nếu bạn đang khôi phục bất kỳ thành phần nào sau đây trên nút, thì hãy gỡ cài đặt tất cả các thành phần đó: Máy chủ quản lý, Bộ định tuyến, Bộ xử lý thư, Máy chủ Qpid hoặc Máy chủ Postgres:
```
> apigee-service edge-gateway uninstall
```
2. Nếu bạn đang 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 đó:
```
> apigee-service comp uninstall
```
3. Nếu đang khôi phục Bộ định tuyến, thì bạn phải xoá nội dung của /opt/nginx/conf.d:
```
> cd /opt/nginx/conf.d
> rm -rf *
```
Cách khôi phục thành phần này:
1. Gỡ cài đặt phiên bản 4.18.01 của apigee-setup:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
```
2. Tải bootstrap.sh xuống cho bản phát hành mong muốn: Ví dụ: đối với 4.16.09:
```
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh 
```
3. Cài đặt tiện ích và các phần phụ thuộc apigee-service 4.16.01, 4.16.05 hoặc 4.16.09. Ví dụ: đối với 4.16.09:
```
> sudo bash /tmp/bootstrap_4.16.09.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.
4. Cài đặt apigee-setup:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Cài đặt phiên bản thành phần mà bạn muốn:
```
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
  trong đó comp là thành phần cần cài đặt và configFile là tệp cấu hình cho phiên bản mong muốn.
6. Nếu bạn đang khôi phục Qpid, hãy xoá iptables:
```
> sudo iptables -F
```
Cách khôi phục thành phần này về một phiên bản cụ thể của bản phát hành 4.18.01:
1. Tải phiên bản thành phần cụ thể xuống:
```
> /opt/apigee/apigee-service/bin/apigee-service comp-version install
```
  trong đó comp-version là thành phần và phiên bản cần cài đặt. Ví dụ:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-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 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. 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.

Hãy liên hệ với Bộ phận hỗ trợ Apigee nếu bạn gặp vấn đề khi khôi phục.