Справочник по файлу конфигурации Edge

Edge for Private Cloud версии 4.17.05

Ниже приведен пример полного файла конфигурации для установки Edge с девятью узлами. При необходимости измените этот файл в соответствии с вашей конфигурацией. Чтобы включить этот файл, используйте параметр -f для setup.sh. Ниже также приведены примеры файлов конфигурации для каждой топологии 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 (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.
SMTPMAILFROM="My Company <myco@company.com>"

В таблице ниже приведена дополнительная информация об этих свойствах.

Ресурс

Примечание

IP-адреса и имена DNS

При указании IP-адреса узла не используйте имя хоста, сопоставленное с адресом 127.0.0.1, или IP-адрес 127.0.0.1.

ADMIN_EMAIL
APIGEE_ADMINPW

Пароль системного администратора должен содержать не менее восьми символов, включая одну прописную букву, одну строчную букву, одну цифру или один специальный символ. Если вы не укажете пароль, вам будет предложено ввести его.

LICENSE_FILE

Расположение файла лицензии, который должен быть доступен пользователю apigee. Например, сохраните его в каталоге /tmp и выполните команду chmod 777. Файл будет скопирован в каталог установки Edge.

APIGEE_LDAPPW

Указывает пароль OpenLDAP.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Если USE_LDAP_REMOTE_HOST имеет значение n, Edge автоматически устанавливает OpenLDAP при установке сервера управления.

Если вы подключаетесь к удаленному серверу LDAP, задайте для параметра USE_LDAP_REMOTE_HOST значение y. OpenLDAP не устанавливается вместе с сервером управления.

Если вы подключаетесь к удаленному серверу OpenLDAP, используйте LDAP_HOST
и LDAP_PORT, чтобы указать IP-адрес или DNS-имя и номер порта хоста.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Установите значение LDAP_TYPE=1 для OpenLDAP без репликации. LDAP_TYPE=2 соответствует OpenLDAP с репликацией.

Если в топологии Edge используется один сервер OpenLDAP, укажите 1. Если в вашей установке Edge используется несколько узлов OpenLDAP, например в рабочей установке с 13 узлами, укажите 2.

Если вы включите репликацию, задайте следующие свойства:

  • LDAP_SID=1 – уникальный идентификатор этого сервера LDAP. У каждого узла LDAP свой идентификатор. Например, для однорангового узла LDAP задайте значение 2.
  • LDAP_PEER=10.0.0.1 – IP-адрес или DNS-имя узла LDAP.

BIND_ON_ALL_INTERFACES

Если задано значение "y", то маршрутизатор или Message Processor привязывается ко всем интерфейсам (IP-адресам). Если задано значение n, маршрутизатор или Message Processor привязывается к определенному интерфейсу (IP-адресу, возвращаемому командой hostname -i).

MP_POD

Укажите название пода Message Processor и Router. По умолчанию используется название gateway.

REGION

Название региона. По соглашению названия обычно имеют вид dc-#, где # соответствует целочисленному значению. Например, dc-1, dc-2 и т. д. Если вы не устанавливаете продукт в среде с несколькими центрами обработки данных, можно использовать dc-1.

В установке с несколькими центрами обработки данных значением будет dc-1, dc-2 и т. д. в зависимости от того, какой центр обработки данных вы устанавливаете. Однако вы можете использовать любое название региона, а не только dc-#.

ZK_HOSTS

IP-адреса или имена DNS узлов ZooKeeper. IP-адреса или имена DNS должны быть указаны в одном и том же порядке на всех узлах ZooKeeper.

В среде с несколькими центрами обработки данных перечислите все узлы ZooKeeper из обоих центров обработки данных.

Указывать модификатор :observer в узлах ZooKeeper нужно только при создании нескольких центров обработки данных, как описано в разделе об установке на 12 хостах. Если у вас один центр обработки данных, опустите этот модификатор. Дополнительную информацию можно найти в разделе "Кластерная установка на 12 хостах" статьи Как установить компоненты Edge на узел.

ZK_CLIENT_HOSTS

IP-адреса или DNS-имена узлов ZooKeeper, используемых этим центром обработки данных. IP-адреса или DNS-имена должны быть перечислены в одном и том же порядке на всех узлах ZooKeeper.

В установке с одним центром обработки данных это те же узлы, которые указаны в ZK_HOSTS.

В среде с несколькими центрами обработки данных перечислите только узлы ZooKeeper в этом центре обработки данных. Подробнее о кластерной установке на 12 хостах читайте в статье Как установить компоненты Edge на узел.

CASS_CLUSTERNAME При необходимости укажите название кластера Cassandra. По умолчанию используется название Apigee.

CASS_HOSTS

IP-адреса (не имена DNS) узлов Cassandra. Первые два узла будут использоваться в качестве исходных серверов. IP-адреса должны быть перечислены в одном и том же порядке на всех узлах Cassandra.

Узлы Cassandra могут иметь необязательный суффикс ":dc,ra", который указывает на центр обработки данных и стойку узла Cassandra. Указывайте этот модификатор только при создании нескольких центров обработки данных, как описано в разделе об установке с 12 хостами. Если у вас один центр обработки данных, этот модификатор не нужен.

Например, 192.168.124.201:1,1 – это центр обработки данных 1 и стойка/зона доступности 1, а 192.168.124.204:2,1 – это центр обработки данных 2 и стойка/зона доступности 1.

В среде с несколькими центрами обработки данных, чтобы преодолеть проблемы с брандмауэром, CASS_HOSTS должны быть упорядочены таким образом (как показано в примере выше), чтобы узлы текущего центра обработки данных были размещены в начале. Дополнительную информацию можно найти в разделе "Кластерная установка на 12 хостах" статьи Как установить компоненты Edge на узел.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Если вы включите аутентификацию Cassandra (CASS_AUTH=y), то сможете передавать имя пользователя и пароль Cassandra с помощью этих свойств.

PG_PWD

По умолчанию в базе данных PostgreSQL определены два пользователя: postgres и apigee. Для обоих пользователей по умолчанию задан пароль postgres. Чтобы задать другой пароль для обоих пользователей во время установки, используйте PG_PWD.

PG_MASTER

PG_STANDBY

Задайте значение, чтобы включить репликацию Postgres master-standby, в следующем формате:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

Настройте SMTP, чтобы Edge мог отправлять электронные письма для восстановления паролей и другие уведомления.

Если учетные данные пользователя SMTP не требуются, опустите SMTPUSER и SMTPPASSWORD.

Параметр SMTPMAILFROM является обязательным.