Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Cài đặt các thành phần Edge trên một nút

Edge cho đám mây riêng tư phiên bản 4.16.09

Sau khi bạn cài đặt tiện ích apigee-setup của Edge trên một nút, hãy sử dụng tiện ích apigee-setup để cài đặt một hoặc nhiều thành phần của Edge trên nút đó.

Tiện ích apigee-setup sử dụng một lệnh ở dạng:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

trong đó component là thành phần Edge cần cài đặt và configFile là tệp cấu hình tự động chứa thông tin cài đặt. Người dùng "apigee" phải có quyền truy cập hoặc đọc tệp cấu hình. Ví dụ: bạn có thể tạo một thư mục mới cho các tệp, đặt các tệp đó vào thư mục /usr/local hoặc /usr/local/share hoặc bất kỳ nơi nào khác trên nút mà người dùng "apigee" có thể truy cập.

Ví dụ: để cài đặt Edge Management Server, hãy làm như sau:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Những điều cần lưu ý khi cài đặt

Khi viết tệp cấu hình, hãy cân nhắc các lựa chọn sau.

Thiết lập tính năng sao chép chính-phụ của Postgres

Theo mặc định, Edge cài đặt tất cả các nút Postgres ở chế độ chính. Tuy nhiên, trong các hệ thống chính thức có nhiều nút Postgres, bạn phải định cấu hình các nút đó để sử dụng tính năng sao chép chính-phụ để nếu nút chính không hoạt động, nút phụ có thể tiếp tục phân phát lưu lượng truy cập.

Bạn có thể bật và định cấu hình tính năng sao chép chính-dự phòng tại thời điểm cài đặt bằng cách sử dụng các thuộc tính trong tệp cấu hình im lặng. Hoặc bạn có thể bật tính năng sao chép chính-dự phòng sau khi cài đặt. Để biết thêm thông tin, hãy xem phần Thiết lập tính năng sao chép chính-dự phòng cho Postgres.

Bật tính năng xác thực Cassandra

Theo mặc định, Cassandra sẽ cài đặt mà không bật tính năng xác thực. Điều đó có nghĩa là bất kỳ ai cũng có thể truy cập vào Cassandra. Bạn có thể bật tính năng xác thực sau khi cài đặt Edge hoặc trong quá trình cài đặt.

Bạn có thể bật tính năng xác thực Cassandra trong thời gian cài đặt bằng cách sử dụng các thuộc tính trong tệp cấu hình im lặng. Hoặc bạn có thể bật tính năng này sau khi cài đặt.

Để biết thêm thông tin, hãy xem bài viết Bật tính năng xác thực Cassandra.

Liên kết Bộ định tuyến với một cổng được bảo vệ

Nếu muốn liên kết Bộ định tuyến với một cổng được bảo vệ, chẳng hạn như số cổng nhỏ hơn 1024, thì bạn phải định cấu hình Bộ định tuyến để chạy dưới dạng người dùng có quyền truy cập vào các cổng đó. Theo mặc định, Bộ định tuyến chạy dưới dạng người dùng "apigee" không có quyền truy cập vào các cổng đặc quyền.

Cách chạy Bộ định tuyến dưới dạng một người dùng khác:

Là người dùng gốc, hãy tạo tệp /opt/apigee/etc/edge-router.d/RUN_USER.sh.
Thêm mục sau vào tệp:
RUN_USER=root
Nếu bạn không muốn chạy Bộ định tuyến dưới dạng gốc, hãy chỉ định một người dùng có quyền truy cập vào cổng.
Lưu tệp.
Nếu bạn chỉ định một người dùng không phải là người dùng gốc, hãy thay đổi chủ sở hữu của tệp thành người dùng đó:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Khởi động lại bộ định tuyến:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Chỉ định các thành phần cần cài đặt

Bảng sau đây liệt kê các tuỳ chọn mà bạn truyền đến tuỳ chọn -p của tiện ích apigee-service để chỉ định thành phần cần cài đặt trên nút:

Thành phần	Nội dung mô tả
c	Chỉ cài đặt Cassandra.
zk	chỉ cài đặt ZooKeeper.
ds	Cài đặt ZooKeeper và Cassandra.
ld	Chỉ cài đặt OpenLDAP.
ms	Cài đặt Edge Management Server, đồng thời cài đặt giao diện người dùng Edge và OpenLDAP. Nếu bạn đặt USE_LDAP_REMOTE_HOST=y trong tệp cấu hình, thì quá trình cài đặt OpenLDAP sẽ bị bỏ qua và Máy chủ quản lý sẽ sử dụng OpenLDAP được cài đặt trên một nút khác.
r	Chỉ cài đặt Bộ định tuyến biên.
mp	Chỉ cài đặt Bộ xử lý thông báo Edge.
rmp	Cài đặt Bộ định tuyến Edge và Bộ xử lý thông báo.
ui	Cài đặt giao diện người dùng Edge.
qs	Chỉ cài đặt Máy chủ Qpid.
ps	Chỉ cài đặt Máy chủ Postgres.
sax	Cài đặt các thành phần phân tích, tức là Qpid và Postgres. Chỉ sử dụng lựa chọn này cho mục đích phát triển và thử nghiệm, không dùng cho môi trường thực tế.
tháng	Cài đặt tính năng kiếm tiền.
sa	Cài đặt Edge độc lập, tức là Cassandra, ZooKeeper, Máy chủ quản lý, OpenLDAP, Giao diện người dùng Edge, Bộ định tuyến và Bộ xử lý thông báo. Lựa chọn này bỏ qua các thành phần phân tích Edge: Qpid và Postgres. Chỉ sử dụng lựa chọn này cho mục đích phát triển và thử nghiệm, không dùng cho môi trường thực tế.
aio	Cài đặt tất cả thành phần trên một nút duy nhất. Chỉ sử dụng lựa chọn này cho mục đích phát triển và thử nghiệm, không dùng cho môi trường thực tế.

Tạo tệp cấu hình

Tệp cấu hình chứa tất cả thông tin cần thiết để cài đặt Edge. Bạn thường có thể sử dụng cùng một tệp cấu hình để cài đặt tất cả thành phần trong một bản cài đặt Edge.

Tuy nhiên, bạn sẽ phải sử dụng các tệp cấu hình khác hoặc sửa đổi tệp cấu hình nếu:

Bạn đang cài đặt nhiều máy chủ OpenLDAP và cần định cấu hình tính năng sao chép trong quá trình cài đặt 13 nút. Mỗi tệp yêu cầu các giá trị khác nhau cho LDAP_SID và LDAP_PEER.
Bạn đang tạo nhiều trung tâm dữ liệu trong quá trình cài đặt 12 nút. Mỗi trung tâm dữ liệu yêu cầu các chế độ cài đặt khác nhau cho các thuộc tính như ZK_CLIENT_HOSTS và CASS_HOSTS.

Tệp cấu hình mẫu

Dưới đây là ví dụ về tệp cấu hình im lặng hoàn chỉnh cho một bản cài đặt Edge 9 nút. Chỉnh sửa tệp này nếu cần cho cấu hình của bạn. Sử dụng tuỳ chọn -f cho setup.sh để thêm tệp này. Dưới đây cũng là các tệp cấu hình mẫu cho từng cấu trúc liên kết Edge.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

Bảng sau đây trình bày thông tin bổ sung về các thuộc tính này:

Thuộc tính	Lưu ý
Tên IP/DNS	Không sử dụng tên máy chủ lưu trữ liên kết với 127.0.0.1 hoặc địa chỉ IP 127.0.0.1 khi chỉ định địa chỉ IP của một nút.
ADMIN_EMAIL APIGEE_ADMINPW	Mật khẩu của quản trị viên hệ thống phải dài ít nhất 8 ký tự và chứa một chữ cái viết hoa, một chữ cái viết thường, một chữ số hoặc một ký tự đặc biệt. Nếu bỏ qua mật khẩu, bạn sẽ được nhắc nhập mật khẩu.
LICENSE_FILE	Vị trí của tệp giấy phép mà người dùng "apigee" phải truy cập được. Ví dụ: lưu trữ tệp trong thư mục /tmp và chmod 777 trên tệp. Tệp được sao chép vào thư mục cài đặt Edge.
USE_LDAP_REMOTE_HOST LDAP_HOST LDAP_PORT	Nếu USE_LDAP_REMOTE_HOST là n, Edge sẽ tự động cài đặt OpenLDAP khi cài đặt Máy chủ quản lý. Đặt USE_LDAP_REMOTE_HOST thành y nếu bạn đang kết nối với máy chủ LDAP từ xa. OpenLDAP không được cài đặt cùng với Máy chủ quản lý. Nếu bạn đang kết nối với một máy chủ OpenLDAP từ xa, hãy sử dụng LDAP_HOST và LDAP_PORT để chỉ định địa chỉ IP hoặc tên DNS và số cổng của máy chủ lưu trữ.
LDAP_TYPE LDAP_SID LDAP_PEER	Đặt LDAP_TYPE=1 cho OpenLDAP không có bản sao. LDAP_TYPE=2 tương ứng với OpenLDAP có sao chép. Nếu cấu trúc liên kết Edge của bạn sử dụng một máy chủ OpenLDAP, hãy chỉ định 1. Nếu bản cài đặt Edge của bạn sử dụng nhiều nút OpenLDAP, chẳng hạn như trong bản cài đặt chính thức gồm 13 nút, hãy chỉ định 2. Nếu bạn bật tính năng sao chép, hãy đặt các thuộc tính sau: LDAP_SID=1 – Mã nhận dạng duy nhất cho máy chủ LDAP này. Mỗi nút LDAP sử dụng một mã nhận dạng khác nhau. Ví dụ: đặt thành 2 cho ứng dụng ngang hàng LDAP. LDAP_PEER=10.0.0.1 – IP hoặc tên DNS của máy ngang hàng LDAP.
BIND_ON_ALL_INTERFACES	Nếu bạn đặt thành "y", thì Bộ định tuyến/Bộ xử lý thông báo sẽ liên kết (nghe) trên tất cả các giao diện (IP). Nếu được đặt thành "n", thì Bộ định tuyến/Bộ xử lý thông báo sẽ liên kết (nghe) trên một giao diện cụ thể, IP do lệnh "hostname -i" trả về).
MP_POD	Chỉ định tên của Bộ xử lý thông báo và Nhóm bộ định tuyến. Theo mặc định, tên là gateway.
REGION	Tên khu vực. Theo quy ước, tên thường có dạng dc-#, trong đó # tương ứng với một giá trị số nguyên. Ví dụ: dc-1, dc-2, v.v. Bạn có thể sử dụng dc-1 trừ phi cài đặt trong môi trường nhiều trung tâm dữ liệu. Trong quá trình cài đặt nhiều trung tâm dữ liệu, giá trị là dc-1 hoặc dc-2, v.v. tuỳ thuộc vào trung tâm dữ liệu mà bạn đang cài đặt. Tuy nhiên, bạn không bị hạn chế chỉ sử dụng tên ở dạng dc-#. Bạn có thể sử dụng bất kỳ tên nào cho khu vực.
ZK_HOSTS	Địa chỉ IP hoặc tên DNS của các nút ZooKeeper. Địa chỉ IP hoặc tên DNS phải được liệt kê theo cùng thứ tự trên tất cả các nút ZooKeeper. Trong môi trường nhiều trung tâm dữ liệu, hãy liệt kê tất cả các nút ZooKeeper từ cả hai trung tâm dữ liệu. Chỉ chỉ định đối tượng sửa đổi ":observer" trên các nút ZooKeeper khi tạo nhiều trung tâm dữ liệu như mô tả trong quá trình cài đặt 12 máy chủ. Trong một bản cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó. Hãy xem phần Cài đặt theo cụm 12 máy chủ lưu trữ để biết thêm thông tin.
ZK_CLIENT_HOSTS	Địa chỉ IP hoặc tên DNS của các nút ZooKeeper mà trung tâm dữ liệu này sử dụng. Địa chỉ IP hoặc tên DNS phải được liệt kê theo cùng thứ tự trên tất cả các nút ZooKeeper. Trong một lượt cài đặt trung tâm dữ liệu, đây là các nút giống như được chỉ định bởi ZK_HOSTS. Trong môi trường nhiều trung tâm dữ liệu, chỉ liệt kê các nút ZooKeeper trong trung tâm dữ liệu này. Hãy xem phần Cài đặt theo cụm 12 máy chủ lưu trữ để biết thêm thông tin.
CASS_HOSTS	Địa chỉ IP (không phải tên DNS) của các nút Cassandra. Hai nút đầu tiên sẽ được dùng làm máy chủ gốc. Các địa chỉ IP phải được liệt kê theo cùng thứ tự trên tất cả các nút Cassandra. Các nút Cassandra có thể có hậu tố ":dc,ra" không bắt buộc để chỉ định trung tâm dữ liệu và giá đỡ của nút Cassandra. Chỉ chỉ định đối tượng sửa đổi này khi tạo nhiều trung tâm dữ liệu như mô tả trong quá trình cài đặt 12 máy chủ. Trong một bản cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó. Ví dụ: "192.168.124.201:1,1" = trung tâm dữ liệu 1 và giá đỡ/vùng có sẵn 1, và "192.168.124.204:2,1" = trung tâm dữ liệu 2 và giá đỡ/vùng có sẵn 1. Trong môi trường nhiều trung tâm dữ liệu, để khắc phục các vấn đề về tường lửa, CASS_HOSTS phải được sắp xếp theo cách (như trong ví dụ trên) sao cho các nút của trung tâm dữ liệu hiện tại được đặt ở đầu. Hãy xem phần Cài đặt theo cụm 12 máy chủ lưu trữ để biết thêm thông tin.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Nếu bật tính năng xác thực Cassandra, CASS_AUTH=y, bạn có thể truyền tên người dùng và mật khẩu Cassandra bằng các thuộc tính này.
PG_MASTER PG_STANDBY	Đặt để bật tính năng sao chép chính-dự phòng Postgres, ở dạng: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	Định cấu hình SMTP để Edge có thể gửi email về mật khẩu bị mất và các thông báo khác. Nếu không cần thông tin đăng nhập của người dùng SMTP, hãy bỏ qua SMTPUSER và SMTPPASSWORD.

Thứ tự cài đặt thành phần

Thứ tự cài đặt thành phần dựa trên cấu trúc liên kết mà bạn muốn.

Tất cả ví dụ về việc cài đặt dưới đây đều giả định rằng bạn đang cài đặt:

Khi tắt tính năng xác thực Cassandra (mặc định). Hãy xem phần Bật tính năng xác thực Cassandra để biết thêm thông tin.
Khi tắt tính năng sao chép chính-phụ của Postgres (mặc định). Xem bài viết Thiết lập tính năng sao chép chính-phụ cho Postgres để biết thêm thông tin.
Bộ xử lý thông báo và Bộ định tuyến trên cùng một nút. Nếu bạn cài đặt Bộ xử lý thông báo và Bộ định tuyến trên các nút khác nhau, hãy cài đặt tất cả Bộ xử lý thông báo trước, sau đó cài đặt tất cả Bộ định tuyến.

Tệp nhật ký cài đặt

Theo mặc định, tiện ích setup.sh sẽ ghi thông tin nhật ký về quá trình cài đặt vào:

/opt/apigee/var/log/apigee-setup/setup.log

Nếu người dùng chạy tiện ích setup.sh không có quyền truy cập vào thư mục đó, thì tiện ích này sẽ ghi nhật ký vào thư mục /tmp dưới dạng tệp có tên setup_username.log.

Nếu người dùng không có quyền truy cập vào /tmp, thì tiện ích setup.sh sẽ không hoạt động.