Sau khi cài đặt Edge thành công, bạn có thể muốn thực hiện một số tác vụ phổ biến để xác thực quá trình cài đặt, điều chỉnh chế độ cài đặt và tuỳ chỉnh cấu hình. Các tác vụ này bao gồm:
| Nhiệm vụ | Mô tả |
|---|---|
| Gọi lệnh trên các thành phần Edge | Sử dụng tiện ích apigee-service để bắt đầu, dừng, khởi động lại và nhận trạng thái
của từng thành phần Edge. |
| Định cấu hình các thành phần Edge | Sử dụng tệp thuộc tính để thay đổi chế độ cài đặt thành phần Edge mặc định. |
| Chạy apigee-validate | Gọi tập lệnh kiểm thử để đảm bảo rằng bạn đã cài đặt thành công từng thành phần. |
| Điều chỉnh chế độ cài đặt vùng nhớ khối xếp (heap) JVM | Tối ưu hoá chế độ cài đặt bộ nhớ Java cho từng nút. |
| Quản lý chính sách mật khẩu LDAP | Thay đổi mật khẩu LDAP mặc định và định cấu hình nhiều chế độ cài đặt xác thực. |
| Cài đặt apigee-monit trên nút | Cài đặt và sử dụng một công cụ giám sát các thành phần trên nút và cố gắng khởi động lại các thành phần đó nếu chúng không hoạt động. |
| Thay đổi mật khẩu PostgreSQL mặc định | Apigee khuyên bạn nên thay đổi mật khẩu PostgreSQL mặc định sau khi cài đặt Edge cho Private Cloud để duy trì tính bảo mật cho dữ liệu của bạn. |
| Thiết lập(các) công việc xoá PostgreSQL | Cắt bớt dữ liệu dư thừa do dịch vụ phân tích thu thập. |
| Thiết lập công cụ sửa chữa Cassandra nodetool | Bảo trì định kỳ mà bạn nên thực hiện trên vòng Cassandra để đảm bảo tính nhất quán trên tất cả các nút. |
| Bật tính năng tự động khởi động | Hướng dẫn Edge cho Private Cloud tự động khởi động lại trong quá trình khởi động lại. |
| Định cấu hình Giao diện người dùng Edge mới | Định cấu hình chế độ xác thực và các chế độ cài đặt không bắt buộc cho Giao diện người dùng Edge mới, giao diện người dùng quản lý dành cho nhà phát triển và quản trị viên của Apigee Edge cho Private Cloud. |
Xin lưu ý rằng đây chỉ là một số tác vụ phổ biến mà bạn thường thực hiện sau khi cài đặt Edge. Để biết thêm các thao tác và tác vụ quản trị, hãy xem Cách định cấu hình Edge và Các thao tác.
Gọi lệnh trên các thành phần Edge
Edge cài đặt các tiện ích quản lý trong /opt/apigee/apigee-service/bin mà bạn có thể
dùng để quản lý quá trình cài đặt Edge. Ví dụ: bạn có thể sử dụng tiện ích apigee-all
để bắt đầu, dừng, khởi động lại hoặc xác định trạng thái của tất cả các thành phần Edge trên nút:
/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version
Sử dụng tiện ích apigee-service
để kiểm soát và định cấu hình các thành phần riêng lẻ. Tiện ích apigee-service có dạng:
/opt/apigee/apigee-service/bin/apigee-service component_name action
Trong đó component_name xác định thành phần. Thành phần này phải nằm trên nút mà bạn thực thi apigee-service. Tuỳ thuộc vào cấu hình của bạn, các giá trị của
component_name có thể bao gồm:
apigee-cassandra(Cassandra)apigee-openldap(OpenLDAP)apigee-postgresql(Cơ sở dữ liệu PostgreSQL)apigee-qpidd(Qpidd)apigee-zookeeper(ZooKeeper)edge-management-server(Máy chủ quản lý)edge-management-ui(Giao diện người dùng Edge mới)edge-message-processor(Trình xử lý tin nhắn)edge-postgres-server(Máy chủ Postgres)edge-qpid-server(Máy chủ Qpid)edge-router(Bộ định tuyến biên)
Ngoài các thành phần này, bạn cũng có thể gọi apigee-service trên các thành phần apigee-provision và apigee-validate tuỳ thuộc vào cấu hình của bạn.
Ví dụ: để khởi động lại Bộ định tuyến Edge, hãy thực thi lệnh sau:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Bạn có thể xác định danh sách các thành phần được cài đặt trên nút bằng cách kiểm tra thư mục
/opt/apigee. Thư mục đó chứa một thư mục con cho mọi thành phần Edge
được cài đặt trên nút. Mỗi thư mục con được bắt đầu bằng:
apigee: Một thành phần của bên thứ ba mà Edge sử dụng. Ví dụ:apigee-cassandra.edge: Một thành phần Edge của Apigee. Ví dụ:edge-management-server.edge-mint: Một thành phần kiếm tiền. Ví dụ:edge-mint-management-server.
Danh sách đầy đủ các thao tác cho một thành phần phụ thuộc vào chính thành phần đó, nhưng tất cả các thành phần đều hỗ trợ các thao tác sau:
start, stop, restartstatus, versionbackup, restoreinstall, uninstall
Định cấu hình các thành phần Edge
Để định cấu hình Edge sau khi cài đặt, bạn sẽ sử dụng kết hợp các tệp .properties
và tiện ích Edge. Ví dụ: để định cấu hình TLS/SSL trên Giao diện người dùng Edge mới, bạn sẽ chỉnh sửa
.properties để đặt các thuộc tính cần thiết. Để các thay đổi đối với tệp .properties
có hiệu lực, bạn cần khởi động lại thành phần Edge bị ảnh hưởng.
Các tệp .properties nằm trong
thư mục /opt/apigee/customer/application.
Mỗi thành phần có tệp .properties riêng trong thư mục đó.
Ví dụ: router.properties và management-server.properties.
Để đặt một thuộc tính cho một thành phần, hãy chỉnh sửa tệp .properties tương ứng, sau đó
khởi động lại thành phần đó:
/opt/apigee/apigee-service/bin/apigee-service component restart
Ví dụ:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Khi bạn cập nhật Edge, các tệp .properties trong thư mục
/opt/apigee/customer/application sẽ được đọc. Điều đó có nghĩa là bản cập nhật sẽ giữ lại
mọi thuộc tính mà bạn đặt trên thành phần đó.
Hãy xem bài viết Cách định cấu hình Edge để biết thêm thông tin về cấu hình Edge.
Cài đặt apigee-monit trên nút
Sau khi hoàn tất việc cài đặt các thành phần trên một nút, bạn có thể tuỳ ý thêm tiện ích apigee-monit. apigee-monit sẽ giám sát các thành phần trên nút và cố gắng khởi động lại các thành phần đó nếu chúng không hoạt động.
Để biết thêm thông tin, hãy xem bài viết Tự khắc phục sự cố bằng apigee-monit.
Định cấu hình máy chủ SymasLDAP ở chế độ chỉ đọc
Nếu quá trình cài đặt Edge của bạn có chứa một máy chủ SymasLDAP không cần chuyển đổi lưu lượng truy cập, thì bạn nên định cấu hình máy chủ đó ở chế độ chỉ đọc. Cách làm như sau:
- Tạo tệp
mark_readonly.ldiftrên máy chủ có các dòng sau:dn: olcDatabase={2}mdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: TRUE - Thực thi lệnh sau trên máy chủ để đánh dấu máy chủ đó là chỉ đọc:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif
Trong trường hợp máy chủ chính không hoạt động, bạn có thể chuyển về sử dụng máy chủ dự phòng làm máy chủ chính như sau:
- Tạo tệp
mark_writable.ldiftrên máy chủ dự phòng có dòng sau:dn: olcDatabase={2}mdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: FALSE - Thực thi lệnh sau trên máy chủ dự phòng:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif