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

Khôi phục Apigee Edge 4.52.01

Nếu gặp lỗi trong khi cập nhật lên Edge 4.52.01, bạn có thể khôi phục đã gây ra lỗi, sau đó thử cập nhật lại.

Bạn có thể quay lại Edge 4.52.01 bằng các phiên bản phát hành chính sau:

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

Có hai tình huống mà bạn có thể muốn khôi phục:

Khôi phục về bản phát hành lớn hoặc nhỏ trước đó. Ví dụ: từ 4.52.01 đến 4.52.00.
Khôi phục về bản phát hành bản vá trước đó bản phát hành. Ví dụ: từ 4.52.00.02 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.

Những người có thể khôi phục

Người dùng khôi phục phải giống như người dùng đã cập nhật Edge ban đầu hoặc người dùng chạy dưới dạng thư mục gốc.

Theo mặc định, các thành phần Edge sẽ chạy với tư cách "api" ("API") của người dùng. Trong một số trường hợp, bạn có thể đ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 Bộ định tuyến phải truy cập các cổng đặc quyền, chẳng hạn như những bộ định tuyến dưới 1000, thì bạn phải chạy Bộ định tuyến dưới dạng thư mục gốc hoặc với tư cách người dùng có quyền truy cập vào các Bộ định tuyến đó cổng. Hoặc bạn có thể chạy một thành phần với tư cách là một người dùng và một thành phần khác với tư cách là người dùng khác.

Các thành phần có mã chung

Các thành phần Edge sau đây dùng chung mã. Do đó, để khôi phục bất kỳ một trong số các thành phần này trên một nút, bạn phải khôi phục tất cả các thành phần có trên nút đó.

edge-management-server (Máy chủ quản lý)
edge-message-processor (Đơn vị xử lý tin nhắn)
edge-router (Bộ định tuyến)
edge-postgres-server (Máy chủ Postgres)
edge-qpid-server (Máy chủ Qpid)

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

Quay lại một bản phát hành chính hoặc phụ trước đó

Để khôi phục về bản phát hành chính hoặc phụ trước đó, hãy làm như sau trên mỗi nút lưu trữ thành phần:

Tải tệp bootstrap.sh xuống cho phiên bản bạn muốn chuyển sang quay lại:
- Để khôi phục về phiên bản 4.51.00, hãy tải bootstrap_4.51.00.sh xuống:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
```

Dừng thành phần để khôi phục:

Để khôi phục bất kỳ thành phần nào có mã chung trên nút, bạn phải dừng tất cả chúng, như ví dụ sau cho thấy:

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

Để 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 quay lại tính năng Kiếm tiền, hãy gỡ cài đặt tính năng này khỏi tất cả 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 này:
1. Để khôi phục bất kỳ thành phần nào có mã chung trên nút, bạn phải gỡ cài đặt tất cả bằng cách gỡ cài đặt thành phần edge-gateway nhóm, như ví dụ sau cho thấy:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
2. Để khôi phục bất kỳ thành phần nào khác trên nút, chỉ gỡ cài đặt thành phần đó, vì ví dụ sau đây cho thấy:
```
/opt/apigee/apigee-service/bin/apigee-service component uninstall
```
  Trong đó component là tên thành phần.
3. Để khôi phục Bộ định tuyến cạnh, bạn phải xóa nội dung của /opt/nginx/conf.d ngoài việc gỡ cài đặt Nhóm thành phần edge-gateway:
```
cd /opt/nginx/conf.d
rm -rf *
```

Gỡ cài đặt phiên bản 4.52.01 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 cài đặt phiên bản 4.51.00 của apigee-service:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
Trong đó uName và pWord là tên người dùng và mật khẩu bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã đó.

Nếu gặp lỗi, hãy nhớ tải tệp bootstrap.sh xuống theo bước 1.

Cài đặt apigee-setup:

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

Cài đặt phiên bản cũ hơn của thành phần:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
Trong đó component là thành phần cần cài đặt và configFile là thành phần của bạn cho phiên bản cũ hơn.
Nếu bạn đang khôi phục Qpid, hãy xoá các iptables:
```
sudo iptables -F
```
Lặp lại quy trình này cho mỗi nút lưu trữ thành phần mà bạn đang khôi phục.

Khôi phục về bản vá đã phát hành trước đó

Để khôi phục một thành phần về một bản vá phát hành cụ thể, hãy thực hiện như sau trên từng nút lưu trữ thành phần đó:

Tải phiên bản thành phần cụ thể xuống:
```
/opt/apigee/apigee-service/bin/apigee-service component_version install
```
Trong đó component_version là thành phần và bản phát hành bản vá sẽ cài đặt. Ví dụ:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
```
Nếu đang sử dụng kho lưu trữ trực tuyến Apigee, bạn có thể xác định thành phần có sẵn bằng cách dùng lệnh sau:
```
yum --showduplicates list comp
```
Ví dụ:
```
yum --showduplicates list edge-ui
```
Sử dụng apigee-setup để cài đặt thành phần:
```
/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
Ví dụ:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
Lưu ý rằng bạn chỉ xác định tên thành phần khi cài đặt chứ không phải phiên bản.
Lặp lại quy trình này cho mỗi nút lưu trữ thành phần mà bạn đang khôi phục.

Khôi phục bản cập nhật Postgres 10.17

Nếu đã nâng cấp từ phiên bản 4.50.00 hoặc 4.51.00 lên 4.52.01, bạn phải khôi phục Postgres cập nhật ngoài các thành phần Edge.

Cách khôi phục bản cập nhật Postgres khi cập nhật Postgres trong cấu hình chế độ chờ chính:

Nâng cấp nút dự phòng mới để trở thành nút chính của Postgres. Trang cái mới của Postgres sẽ là cùng một phiên bản với phiên bản bạn đã cài đặt cho Edge trước đó.
Định cấu hình nút dự phòng cũ thành nút chờ của nút chính mới. Nút chế độ chờ cũ sẽ có cùng phiên bản với phiên bản bạn đã cài đặt cho 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 việc khôi phục, nút chính cũ sẽ không còn cần thiết nữa. Bạn có thể sau đó huỷ 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 Postgres:
```
/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 đó:

/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.
Chuyển nút dự phòng mới thành nút chính Postgres:
1. Chuyển nút chờ mới thành nút 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 "apigee" Người dùng, mặc định là "postgres".
2. Chỉnh sửa tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định như 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
```
Nếu đã nâng cấp nút chờ cũ lên phiên bản mới hơn, trước tiên, bạn phải hạ cấp phần mềm Apigee trên nút chờ cũ. Nếu bạn vẫn có phiên bản cũ trên phiên bản cũ nút chế độ chờ, bạn có thể bỏ qua bước này và tiếp tục với bước 6.
1. Dừng Postgres trên nút chờ cũ:
```
apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
```
2. Gỡ cài đặt Postgres khỏi nút dự phòng cũ:
```
apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
```
3. Xoá thư mục dữ liệu Postgres khỏi nút chế độ chờ cũ:
```
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
4. Tải xuống và chạy phiên bản Tự động khởi động phiên bản cũ (đối với phiên bản Apigee bạn đang triển khai quay lại) trên nút chế độ chờ cũ. Các bước chính xác có thể khác nhau tuỳ thuộc vào việc bạn có đang sử dụng cài đặt dựa trên Internet hoặc ngoại tuyến. Nếu chạy phiên bản cũ hơn, quy trình khởi động Apigee sẽ thiết lập kho lưu trữ yum bằng dữ liệu Apigee phiên bản cũ hơn.
5. Thiết lập các thành phần Postgres trên nút chế độ chờ cũ:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Kiểm tra và xác minh rằng các thành phần Postgres trên nút chế độ chờ cũ đã được hoàn nguyên về phiên bản cũ:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```
Tạo lại nút chế độ chờ cũ:
1. Chỉnh sửa tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định như 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ờ của nút chính 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 Postgres không chạy, hãy khởi động:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
Xác minh rằng nút chế độ chờ mới đã được thêm bằng cách xem /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 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 Analytics trong trường name và tên nhóm người tiêu dùng vào trường name trong consumer-groups. Điều này cũng trả về các UUID của nút chính và nút chờ Postgres cũ trong trường postgres-server và trong trường datastores. Bạn sẽ thấy kết quả ở 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 bản 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 mã nhận dạng duy nhất (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 hoạt động. 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 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 mới .
Xoá nút chính và nút dự phòng 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 nhóm phân tích và nhóm người dùng. masterUUID,standbyUUID đang có cùng thứ tự với chúng xuất hiện ở trên khi bạn xem thông tin phân tích và nhóm người tiêu dùng hiện tại ở trên. Bạn có thể phải chỉ định chúng là standbyUUID,masterUUID.

Thuộc tính datastores cho consumer-groups hiện sẽ trống.

Xóa nút chính và nút dự phòng cũ khỏi nhóm Analytics:

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

Hiện tại, thuộc tính postgres-server trong uuids sẽ trống.

Đăng ký nút chính và nút chờ PG mới với nhóm 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=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 phân tích:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
Bạn sẽ thấy UUID của các nút chính và nút dự phòng mới được liệt kê trong nhóm phân tích và nhóm người 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ả cá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 các tập lệnh sau trên cả hai máy chủ. Hệ thống sẽ hiển thị 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 chủ mới, hãy chạy:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Xác minh rằng đó là bản chính. Trên nút chế độ chờ cũ:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Xác minh 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 rằng các nút đang ở đồng bộ hoá.
Gỡ bỏ trình điều khiển Postgres cũ bằng cách sử dụng quy trình trong Gỡ bỏ Nút Postgres.
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 mã đang chạy. Nếu chưa, hãy bắt đầu:
```
/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 trang cái cũ và cài đặt Qpid trên nút chính mới. Sau khi gỡ cài đặt Qpid, bạn có thể gỡ cài đặt nút chính 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ữ:

Ngừ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