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

Edge для частного облака v. 4.17.09

Ниже показан пример полного файла автоматической конфигурации для установки Edge с 9 узлами. Отредактируйте этот файл в соответствии с вашей конфигурацией. Используйте параметр -f для setup.sh , чтобы включить этот файл. Ниже также показаны примеры файлов конфигурации для каждой пограничной топологии.

# 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)

# Specify "y" to check that the system meets the CPU and memory requirements 
# for the component being installed. See Installation Requirements for requirements for each component.
# Default value is "n" to disable check.   
ENABLE_SYSTEM_CHECK=n

# When "hostname -i" returns multiple IP addresses,  
# set to "y", to have the installer prompt you to select the IP address to use. 
ENABLE_DYNAMIC_HOSTIP=n

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

# 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=

# Postgres username and password as set when you installed Edge.
# Default is apigee:postgres.
PG_USER=apigee
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-имена

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

ENABLE_SYSTEM_CHECK

Если «y», убедитесь, что система соответствует требованиям к ЦП и памяти для устанавливаемого компонента. Требования к каждому компоненту см. в разделе «Требования к установке» .

Значение по умолчанию — «n», чтобы отключить проверку.

ENABLE_DYNAMIC_HOSTIP

Если сервер имеет несколько интерфейсных карт, команда "hostname -i" возвращает список IP-адресов, разделенных пробелами. По умолчанию установщик Edge использует первый возвращенный IP-адрес, который может быть неправильным во всех ситуациях. В качестве альтернативы вы можете установить следующее свойство в файле конфигурации установки.

Если установлено значение «y», программа установки предложит вам выбрать IP-адрес, который будет использоваться при установке. Значение по умолчанию — «n».

Предупреждение. Если вы установили ENABLE_DYNAMIC_HOSTIP=y , убедитесь, что ваш файл свойств не устанавливает HOSTIP .

ADMIN_EMAIL
APIGEE_ADMINPW

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

После завершения установки Apigee рекомендует удалить пароль из файла конфигурации.

LICENSE_FILE

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

APIGEE_LDAPPW

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

После завершения установки Apigee рекомендует удалить пароль из файла конфигурации.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_ПОРТ

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

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

Если вы подключаетесь к удаленному серверу 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 использует другой идентификатор. Например, установите значение 2 для равноправного узла LDAP.
  • LDAP_PEER=10.0.0.1 — IP- или DNS-имя узла LDAP.

MP_POD

Укажите имя модуля обработчика сообщений и маршрутизатора. По умолчанию имя — шлюз.

ОБЛАСТЬ

Название региона. По соглашению имена обычно имеют вид 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, используя эти свойства.

После завершения установки Apigee рекомендует удалить пароль из файла конфигурации.

PG_USER
PG_PWD

По умолчанию в базе данных PostgreSQL определены два пользователя: «postgres» и «apigee».

PG_USER позволяет вам изменить имя пользователя «apigee». Вы не можете изменить имя пользователя postgres.

Оба пользователя имеют пароль по умолчанию «postgres». Используйте PG_PWD, чтобы задать разные значения паролей для обоих пользователей во время установки.

После завершения установки Apigee рекомендует удалить пароль из файла конфигурации.

PG_MASTER

PG_STANDBY

Установите, чтобы включить репликацию Postgres master-standby, в форме:

PG_MASTER= IPorDNSofNewMaster

PG_STANDBY= IPorDNSofOldMaster

SKIP_SMTP
СМТФОСТ
SMTPUSER
ПАРОЛЬ SMTPP
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

Требуется SMTPMAILFROM .