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 để cài đặt apigee-sso

Khi cài đặt apigee-sso và sử dụng tệp metadata.xml thay vì URL, nếu tệp metadata.xml không có dòng mới (CRLF) ở cuối tệp, thì tệp metadata.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 CRLF vào cuối tệp metadata.xml

  HOẶC

• 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:

Bản sao lưu của Trình xử lý thông báo không sao lưu đúng bộ tệp

Giải pháp:

Chạy quy trình sao lưu lần thứ hai và quy trình này sẽ sao lưu đúng bộ tệp.

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

Mã thông báo phiên 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 của Apigee Edge.

Giải pháp:

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

Giải pháp:

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

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

Giải pháp:

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

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

Sau khi bạn 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ỉ của chú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 cấu hình nhiều trung tâm dữ liệu, nếu một kho dữ liệu không hoạt động, thì bạn có thể thấy lỗi sau:

DataAccessException: Error while accessing datastore;
Please retry later

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

Xin lưu ý rằng trạng thái dự kiến là Máy chủ quản lý sẽ 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

Giải pháp tạm thời là huỷ đăng ký các loại nút Cassandra sau đây trong trung tâm dữ liệu không hoạt động, sau đó đăng ký lại chúng 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 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 của tài khoản Apigee.
   • MS_IP và MS_PORT là địa chỉ IP và số cổng của Máy chủ quản lý.
   • REGION là tên của trung tâm dữ liệu nơi Máy chủ quản lý được đặt.
   • GATEWAY_POD là tên nhóm, theo mặc định là "gateway". Tuy nhiên, có thể bạn đã đổi tên thành một 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 các giá trị 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"

   Phản hồ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"
   }

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

2. Lặp lại bước một cho từng loại nút Cassandra: kms-datastore, dc-datastore và keyvaluemap-datastore. Hãy nhớ ghi lại các 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 UUID mà bạn đã thu thập ở 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

Xin lưu ý rằng các thao tác này đăng ký và huỷ đăng ký các nút từ Zookeeper và không ảnh hưởng đến cụm Cassandra. Để biết thêm thông tin về các lệnh này, hãy xem phần Cập nhật thông tin đă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 báo được ghi nhật ký. Khi FormatMessage=false, thông báo được ghi nhật ký không được bao gồm bất kỳ thông tin nào 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 những 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 một tệp dữ liệu mà sau đó bạn sẽ truyền đến điểm cuối /users trong API Quản lý. Để biết thêm thông tin, hãy xem bài viết Đặt lại mật khẩu quản trị viên hệ thống.