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 bao gồm dòng mới (CRLF) ở cuối tệp, thì tệp metadata.xml không được đọc toàn bộ.

Giải pháp tạm thời:

Để 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 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 tạm thời:

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

Giải pháp tạm thời:

Chạy quá trình sao lưu lần thứ hai và quá trình này sẽ sao lưu đúng nhóm tệp.

Mã thông báo phiên không hợp lệ

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 Apigee Edge.

Giải pháp tạm thời:

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

Giải pháp tạm thời:

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

Các yêu cầu HEAD đến 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 tạm thời:

Để 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ề phản hồi trống một cách rõ rà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 theo địa chỉ.

Giải pháp tạm thời:

Để 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 một kho dữ liệu không còn 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à Máy chủ quản lý có thể không khởi động vì máy chủ này đang cố kết nối với các nút Cassandra trong cả dc-1 và dc-2. DataAccessExceptions xảy ra nếu nút Cassandra bị hỏ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ông báo sẽ 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à để Máy chủ quản lý không kết nối với các thành phần của kho dữ liệu trên các khu vực.

Giải pháp

Cách giải quyết là huỷ đăng ký các loại nút Cassandra sau đây trong trung tâm dữ liệu không sử dụng được, rồi đăng ký lại các loại nút đó 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 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 đặt Máy chủ quản lý.
   • GATEWAY_POD là tên nhóm, theo mặc định là "cổng vào". Tuy nhiên, bạn có thể đã đổi tên thành tên khác, vì vậy hãy kiểm tra cách triển khai.
   • 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 có đị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ẽ sử dụng các nút 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 lưu ý đến những 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 mỗi mã nhận dạng duy nhất (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

Lưu ý rằng các thao tác này sẽ đăng ký và huỷ đăng ký các nút khỏi Zookeeper và không tác độ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 yêu cầu đăng ký kho dữ liệu.

Chính sách về Ghi nhật ký thư bao gồm cả 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 lại. Khi FormatMessage=false, tin nhắn được ghi lại không được chứa bất kỳ thông tin nào do Apigee tạo ra. 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 tạm thời:

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

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

Giải pháp tạm thời:

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 bài viết Đặt lại mật khẩu của quản trị viên hệ thống.