4.19.01 Ghi chú phát hành Edge dành cho đám mây riêng tư

Định dạng tệp siêu dữ liệu cho lượt cài đặt apigee-sso

Khi cài đặt apigee-sso và sử dụng tệp siêu dữ liệu.xml thay vì URL, nếu tệp siêu dữ liệu.xml không có một dòng mới (CRLF) ở cuối tệp, thì tệp siêu dữ liệu.xml sẽ không được đọc toàn bộ.

Giải pháp:

Để giải quyết vấn đề này, bạn có thể làm theo một trong những cách sau:

• Thêm một CRLF vào cuối tệp siêu dữ liệu.xml

  OR

• Sử dụng vị trí dựa trên URL cho siêu dữ liệu

apigee-monit không được hỗ trợ trên Amazon Linux 1

Giải pháp:

Tính năng sao lưu Trình xử lý thư không sao lưu đúng nhóm tệp

Giải pháp:

Hãy chạy tính năng sao lưu lần thứ hai và sao lưu đúng nhóm tệp.

Mã thông báo phiên không bị vô hiệu hoá

Mã thông báo phiên sẽ không bị vô hiệu hoá trên máy chủ khi người dùng nhấp vào nút Đăng xuất Apigee Edge.

Giải pháp:

Các thao tác Casandra không hoạt động khi tính năng xác thực JMX đang bật

Giải pháp:

HEAD yêu cầu đến mục tiêu Node.js bị treo

Các yêu cầu HEAD đến một mục tiêu Node.js có thể bị treo, khiến các kết nối đang chờ xử lý.

Giải pháp:

Để giải quyết vấn đề này, hãy định nghĩa một trình xử lý cho các yêu cầu HEAD để thể hiện rõ việc trả về một phản hồi trống.

Tên máy chủ không phân giải

Sau khi cài đặt hoặc nâng cấp Edge cho Đám mây riêng tư, tên máy chủ có thể không phân giải thành địa chỉ tương ứng.

Giải pháp:

Để giải quyết vấn đề này, hãy khởi động lại thành phần Giao diện người dùng Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

DataAccessException trong nhiều cấu hình trung tâm dữ liệu

Trong nhiều cấu hình trung tâm dữ liệu, nếu không thể sử dụng một kho dữ liệu, thì bạn có thể thấy lỗi sau đây:

DataAccessException: Error while accessing datastore;
Please retry later

Kết quả là Máy chủ quản lý có thể không khởi động vì máy chủ này đang cố gắng kết nối với Cassandra các nút trong cả dc-1 và dc-2. DataAccessExceptions xảy ra nếu một nút Cassandra là xuống. Điều này cũng có thể dẫn đến gián đoạn lưu lượng truy cập API, trong đó Trình xử lý thư báo cáo DataAccessExceptions trong khi cố gắng truy xuất KVM.

Lưu ý rằng trạng thái dự kiến là khi Máy chủ quản lý không kết nối với các thành phần kho dữ liệu trên các khu vực.

Giải pháp

Cách khắc phục là huỷ đăng ký các loại nút Cassandra sau đây trong những trung tâm dữ liệu không hoạt động rồi đăng ký lại sau khi các nút Cassandra hoạt động trở lại:

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

Cách huỷ đăng ký và đăng ký lại các loại nút Cassandra này:

1. Lấy mã nhận dạng duy nhất (UUID) của các nút Cassandra bằng cách sử dụng lệnh curl sau:

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   Trong trường hợp:

   • ADMIN_EMAIL và ADMIN_PW là thông tin đăng nhập Apigee của bạn tài khoản.
   • MS_IP và MS_PORT là địa chỉ IP và cổng của Máy chủ quản lý số.
   • REGION là tên của trung tâm dữ liệu trong đó Máy chủ quản lý vị trí.
   • GATEWAY_POD là tên của nhóm, theo mặc định là "cổng vào". Bạn có thể có đã đổi tên thành tên khác, vì vậy hãy kiểm tra quá trình triển khai của bạn.
   • CASSANDRA_NODE_TYPE là một trong số kms-datastore, dc-datastore, và keyvaluemap-datastore.

   Ví dụ:

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   Câu trả lời sử dụng định dạng sau:

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   Ví dụ:

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   Ghi lại các giá trị của trường uUID trong phản hồi. Bạn sẽ dùng những thông tin này để huỷ đăng ký các nút.

2. Lặp lại bước 1 cho từng loại nút Cassandra: kms-datastore, dc-datastore và keyvaluemap-datastore. Hãy nhớ lưu ý đến Mã nhận dạng duy nhất (UUID) được trả về.
3. Huỷ đăng ký các nút bằng lệnh sau:

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   Trong đó UUID là UUID được trả về trong phản hồi của lệnh trước.

4. Lặp lại bước 3 cho từng mã nhận dạng duy nhất (UUID) bạn đã thu thập được ở bước 1 và 2.
5. Đăng ký lại các nút bằng lệnh sau:

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

Lưu ý rằng các thao tác này sẽ đăng ký và huỷ đăng ký các nút cho Zookeeper và không có bất kỳ tác động đến cụm Cassandra. Để biết thêm thông tin về các lệnh này, hãy xem Cập nhật hoạt động đăng ký kho dữ liệu.

Chính sách MessageLogging bao gồm thông tin bổ sung trong thông điệp nhật ký

Phần tử FormatMessage của chính sách MessageLogging kiểm soát định dạng của thông điệp đã ghi nhật ký. Khi FormatMessage=false, tin nhắn đã ghi nhật ký không được chứa thông tin do Apigee tạo. Tuy nhiên, ngay cả khi bạn đặt FormatMessage=false, thông điệp nhật ký vẫn bao gồm các thông tin sau:

• Điểm ưu tiên
• Dấu thời gian

Giải pháp:

Không đặt lại được mật khẩu quản trị viên hệ thống

Việc đặt lại mật khẩu quản trị viên hệ thống cho Máy chủ quản lý có chứa ký tự đặc biệt sẽ không thành công.

Giải pháp:

Xác định mật khẩu trong tệp dữ liệu mà sau đó bạn truyền đến điểm cuối /users trong API Quản lý. Để biết thêm thông tin, hãy xem phần Đặt lại mật khẩu quản trị viên hệ thống.