Tham chiếu tệp cấu hình Edge

Edge for Private Cloud v. 4.17.01

Dưới đây là ví dụ về tệp cấu hình im lặng hoàn chỉnh cho một lượt cài đặt Edge gồm 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 để setup.sh để đưa tệp này vào. Dưới đây là các tệp cấu hình mẫu cho từng cấu trúc liên kết của 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 (not DNS names) 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=

# Set Postgres password. Default is postgres.
PG_PWD=postgres

# 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 chứa 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 mối liên kết tên máy chủ 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 có độ dài tối thiểu 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ữ nó trong thư mục /tmp và chmod 777 trên tệp. Tệp này sẽ được sao chép vào thư mục cài đặt Edge.

APIGEE_LDAPPW

Chỉ định mật khẩu OpenLDAP.

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 bằng 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ó tính năng sao chép. LDAP_TYPE=2 tương ứng với OpenLDAP có bản sao.

Nếu cấu hình 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 quá trình cài đặt Edge sử dụng nhiều nút OpenLDAP, chẳng hạn như trong quá trình cài đặt sản xuất 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 - ID 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 ứng dụng ngang hàng LDAP.

BIND_ON_ALL_INTERFACES

Nếu được đặt thành "y", thì Bộ định tuyến/Trình xử lý thông báo sẽ liên kết (nghe) trên tất cả giao diện (IP). Nếu bạn đặt thành “n”, thì Bộ định tuyến/Trình xử lý thông báo sẽ liên kết (nghe) trên một giao diện cụ thể, IP được trả về bằng lệnh "tên máy chủ -i").

MP_POD

Chỉ định tên của vùng chứa Bộ xử lý thông báo và 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ị sẽ là dc-1 hoặc dc-2, v.v. tuỳ thuộc vào bạn đang cài đặt trung tâm dữ liệu nào. Tuy nhiên, bạn không bị giới hạn 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 một 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ủ lưu trữ. Trong một lượt cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó.

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 một thứ tự trên tất cả các nút trong 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.

CASS_CLUSTERNAME Không bắt buộc phải chỉ định tên của cụm Cassandra. Tên mặc định là "Apigee".

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ủ hạt giống. Các địa chỉ IP phải được liệt kê theo cùng một 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 hệ số 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ủ lưu trữ. Trong một lượt 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á đỡ/khu vực có sẵn 1, và "192.168.124.204:2,1 = trung tâm dữ liệu 2 và giá đỡ/khu vực 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, bạn phải sắp xếp CASS_HOSTS theo cách (như trong ví dụ trên) để các nút của trung tâm dữ liệu hiện tại được đặt ở đầu.

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ách sử dụng các thuộc tính này.

PG_PWD

Theo mặc định, cơ sở dữ liệu PostgreSQL có hai người dùng được xác định: "postgres" và "apigee". Cả hai người dùng đều có mật khẩu mặc định là "postgres". Sử dụng PG_PWD để đặt mật khẩu thành một giá trị khác nhau cho cả hai người dùng tại thời điểm cài đặt.

PG_MASTER

PG_STANDBY

Đặt để bật tính năng sao chép chính-chờ của 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 SMTPUSERSMTPPASSWORD.