Di chuyển các thuộc tính trên giao diện người dùng Cổ điển sang giao diện người dùng Edge mới

Trong Apigee Edge cho đám mây riêng tư phiên bản 4.54.00, Giao diện người dùng cũ (thành phần edge-ui) sẽ bị xoá và không còn hoạt động nữa. Giao diện người dùng New Edge (thành phần edge-management-ui) là giao diện người dùng duy nhất cho Edge for Private Cloud.

Bạn không thể sử dụng edge-ui trong Edge cho đám mây riêng tư 4.54.00. Nếu bạn tuỳ chỉnh Giao diện người dùng cũ bằng cách đặt các thuộc tính trong /opt/apigee/customer/application/ui.properties, thì Giao diện người dùng Edge mới sẽ không đọc tệp đó. Sau khi cập nhật lên phiên bản 4.54.00, bạn phải đặt các thuộc tính tương đương trong /opt/apigee/customer/application/management-ui.properties.

Trang này liệt kê các thuộc tính của Giao diện người dùng cũ được ghi lại cho ui.properties, các thuộc tính tương đương cho Giao diện người dùng Edge mới và các thuộc tính của Giao diện người dùng cũ không được hỗ trợ trong Giao diện người dùng Edge mới.

Giao diện người dùng Edge mới sử dụng cùng một mã với cơ chế cấu hình (CwC) như các thành phần Edge khác. Để biết thêm thông tin, hãy xem bài viết Cách định cấu hình Edge.

So sánh cấu hình của Giao diện người dùng cũ và Giao diện người dùng mới của Edge

Giao diện người dùng Edge mới thay thế thành phần Giao diện người dùng cũ, tệp thuộc tính, tên dịch vụ, cổng mặc định và định dạng chứng chỉ TLS. Hãy xem bảng sau để cập nhật tập lệnh tự động hoá, quy tắc tường lửa và tệp TLS trước khi di chuyển tài sản:

Đặt thuộc tính cho giao diện người dùng Edge mới

Đặt các thuộc tính cấu hình Giao diện người dùng Edge mới trong /opt/apigee/customer/application/management-ui.properties và khởi động lại dịch vụ edge-management-ui để các thay đổi có hiệu lực.

Cách đặt thuộc tính cho Giao diện người dùng Edge mới:

1. Mở tệp management-ui.properties trong một trình chỉnh sửa. Nếu tệp không tồn tại, hãy tạo tệp:

   vi /opt/apigee/customer/application/management-ui.properties
   

2. Đặt thuộc tính. Ví dụ:

   conf_uebe_disableGeoMap=true

3. Lưu thay đổi.
4. Đảm bảo tệp thuộc quyền sở hữu của người dùng apigee:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
   

5. Khởi động lại giao diện người dùng New Edge:

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

Hãy tuân thủ các quy tắc định dạng sau đây khi bạn thiết lập các thuộc tính cho giao diện người dùng New Edge:

• Tên thuộc tính có phân biệt chữ hoa chữ thường. Ví dụ: conf_uebe_disableGeoMap là hợp lệ, nhưng conf_uebe_disablegeomap thì không.
• Đặt các giá trị chuỗi trong dấu ngoặc kép, ví dụ: conf_uebe_branding_companyNameShort="My Company".
• Đừng đặt các giá trị boolean (true hoặc false) hoặc giá trị số trong dấu ngoặc kép. Nếu giá trị boolean hoặc số được đặt trong dấu ngoặc kép, thì Giao diện người dùng Edge mới sẽ không khởi động.

Để kiểm tra giá trị hiện tại của một thuộc tính, hãy sử dụng lựa chọn -search. Ví dụ:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui \
  configure -search conf_uebe_disableGeoMap

Liên kết các thuộc tính của giao diện người dùng cũ với giao diện người dùng mới của Edge

Các bảng sau đây liên kết từng thuộc tính được hỗ trợ trong Giao diện người dùng cũ trong ui.properties với thuộc tính tương đương trong Giao diện người dùng mới trong management-ui.properties. Cột Mặc định cho biết giá trị mặc định trong Giao diện người dùng mới của Edge.

Định cấu hình các thuộc tính của đối tượng

Liên kết cờ tính năng của giao diện người dùng cũ với các thuộc tính conf_uebe_* tương ứng trong management-ui.properties:

Định cấu hình các thuộc tính phiên và TLS

Liên kết thời gian hết hạn phiên và các thuộc tính TLS trên Giao diện người dùng cổ điển với các thuộc tính tương đương trên Giao diện người dùng New Edge trong management-ui.properties:

Định cấu hình các thuộc tính và mẫu email

Liên kết người gửi email, tiêu đề, thương hiệu, URL máy chủ lưu trữ và thuộc tính hết hạn của đường liên kết trong Giao diện người dùng cũ với Giao diện người dùng mới:

Giao diện người dùng mới của Edge sử dụng các mẫu email tích hợp sẵn. Cách sử dụng các mẫu mà bạn đã tuỳ chỉnh cho Giao diện người dùng cổ điển:

1. Tạo thư mục /opt/apigee/edge-management-ui/email-templates.
2. Sao chép các tệp password-reset.html, user-added-existing.html và user-added-new.html tuỳ chỉnh của bạn từ thư mục sao lưu mà bạn đã tạo trước khi cập nhật (ví dụ: /opt/apigee/customer/backup/) sang /opt/apigee/edge-management-ui/email-templates. Tên tệp và phần giữ chỗ của mẫu giống như trong Giao diện người dùng cũ.
3. Đảm bảo thư mục và tệp thuộc sở hữu của người dùng apigee.
4. Khởi động lại giao diện người dùng Edge mới.

Để biết thêm thông tin, hãy xem bài viết Tuỳ chỉnh mẫu email Edge.

Định cấu hình các thuộc tính mật khẩu được tạo tự động

Liên kết các thuộc tính mật khẩu được tạo tự động trong Giao diện người dùng cũ với Giao diện người dùng Edge mới:

Định cấu hình kết nối Máy chủ quản lý và các thuộc tính khoá bí mật dùng chung

Liên kết mối kết nối, thông tin đăng nhập và các thuộc tính bí mật của ứng dụng trên Máy chủ quản lý giao diện người dùng cổ điển với Giao diện người dùng Edge mới:

Xoá các thuộc tính của Giao diện người dùng cũ không yêu cầu hành động

Các thuộc tính sau đây của Giao diện người dùng cổ điển không có thuộc tính tương đương trong Giao diện người dùng mới của Edge vì hành vi này luôn được bật. Đừng đưa các thuộc tính này vào management-ui.properties (và xoá các thuộc tính này khỏi mọi tập lệnh cấu hình tự động):

Xoá các thuộc tính Giao diện người dùng cũ không được hỗ trợ

Các thuộc tính sau đây của Giao diện người dùng cổ điển không được hỗ trợ và không có thuộc tính tương đương trong Giao diện người dùng Edge mới. Đừng đưa các thuộc tính này vào management-ui.properties (và xoá các thuộc tính này khỏi mọi tập lệnh cấu hình tự động):

Xem ví dụ về quá trình di chuyển

Ví dụ sau đây so sánh tệp ui.properties của Giao diện người dùng cổ điển với tệp management-ui.properties tương đương cho Giao diện người dùng Edge mới.

Giao diện người dùng cổ điển, /opt/apigee/customer/application/ui.properties:

conf_apigee_apigee.feature.disablegeomap=false
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
conf_application_session.maxage="1d"
conf_apigee-base_apigee.emails.passwordreset.subject="Reset your My Company password"
conf_apigee_apigee.branding.companynameshort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

Giao diện người dùng mới của Edge, /opt/apigee/customer/application/management-ui.properties:

conf_uebe_disableGeoMap=false
conf_uebe_trace_for_internal_addresses=true
conf_uebe_authsessiontimeout=24
conf_apigee_apigee.emails.passwordReset.subject="Reset your My Company password"
conf_uebe_branding_companyNameShort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

Lưu ý rằng giá trị boolean true không được đặt trong dấu ngoặc kép và thời gian chờ của phiên 1d được thay thế bằng 24.

Sau khi bạn lưu tệp, hãy khởi động lại giao diện người dùng Edge mới:

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

Danh sách kiểm tra tóm tắt

Hãy sử dụng danh sách kiểm tra sau đây để hoàn tất quá trình di chuyển sang Giao diện người dùng Edge mới trong Apigee Edge cho đám mây riêng tư 4.54.00:

1. Sao lưu /opt/apigee/customer/application/ui.properties và mọi mẫu email tuỳ chỉnh từ /opt/apigee/edge-ui/email-templates trước khi nâng cấp.
2. Thêm các thuộc tính được liên kết vào /opt/apigee/customer/application/management-ui.properties mà không cần trích dẫn các giá trị boolean hoặc giá trị số, đồng thời bỏ qua các thuộc tính Giao diện người dùng cổ điển không được hỗ trợ.
3. Sao chép mẫu email tuỳ chỉnh từ thư mục sao lưu vào /opt/apigee/edge-management-ui/email-templates.
4. Mã hoá lại thông tin đăng nhập của quản trị viên hệ thống bằng ./bin/management-ui --encrypt nếu bạn đặt conf_uebe_mgmtCredential.
5. Đặt quyền sở hữu tệp thành apigee:apigee và khởi động lại edge-management-ui.