Sau khi cài đặt

Sau khi cài đặt Edge thành công, bạn có thể muốn thực hiện một số thao tác 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. Những nhiệm vụ này bao gồm:

Xin lưu ý rằng đây chỉ là một số thao tác 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 bài viết Cách định cấu hình Edge và 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ý một bản 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 từng thành phần. 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-sso (Edge SSO)
• 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 (Bộ xử lý thông báo)
• edge-postgres-server (Máy chủ Postgres)
• edge-qpid-server (Máy chủ Qid)
• edge-router (Bộ định tuyến Edge)
• edge-ui (Giao diện người dùng cổ điể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 biên, 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ó tiền tố là:

• apigee: Thành phần của bên thứ ba mà Edge sử dụng. Ví dụ: apigee-cassandra.
• edge: Thành phần Edge của Apigee. Ví dụ: edge-management-server.
• edge-mint: Thành phần Kiếm tiền. Ví dụ: edge-mint-management-server.

Danh sách đầy đủ các hành động cho một thành phần phụ thuộc vào chính thành phần đó, nhưng tất cả thành phần đều hỗ trợ các hành động sau:

• start, stop, restart
• status, version
• backup, restore
• install, 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ử 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, bạn chỉnh sửa các tệp .properties để đặt các thuộc tính cần thiết. Khi thay đổi các tệp .properties, 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 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 này 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 phần 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ể thêm tiện ích apigee-monit (không bắt buộc). 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 gặp lỗi. Để biết thêm thông tin, hãy xem phần Tự khắc phục bằng apigee-monit.

Định cấu hình máy chủ OpenLDAP ở chế độ chỉ có thể đọc

Nếu bản cài đặt Edge của bạn chứa một máy chủ OpenLDAP không cần chuyển lưu lượng truy cập, bạn nên định cấu hình máy chủ ở chế độ chỉ có thể đọc. Cách làm như sau:

1. Tạo tệp mark_readonly.ldif trên máy chủ bằng các dòng sau:

   dn: olcDatabase={2}bdb,cn=config
   changetype: modify
   replace: olcReadOnly
   olcReadOnly: TRUE

2. Thực thi lệnh sau trên máy chủ để đánh dấu máy chủ đó là chỉ có thể đọ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 gặp sự cố, bạn có thể chuyển về dùng máy chủ dự phòng làm máy chủ chính như sau:

1. Tạo tệp mark_writable.ldif trên máy chủ dự phòng bằng dòng sau:

   dn: olcDatabase={2}bdb,cn=config
   changetype: modify
   replace: olcReadOnly
   olcReadOnly: FALSE

2. 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