Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как установить компоненты Edge на узле

Edge для частного облака версии 4.16.05

После установки утилиты Edge apigee-setup на узле используйте ее, чтобы установить на этом узле один или несколько компонентов Edge.

Утилита apigee-setup использует команду в следующем формате:

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

где component – это компонент Edge, который нужно установить, а configFile – это файл конфигурации, содержащий информацию об установке. Файл конфигурации должен быть доступен для чтения пользователю apigee. Например, поместите файл в каталог /tmp на узле.

Например, чтобы установить сервер управления Edge:

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

Что нужно учитывать при установке

При создании файла конфигурации учитывайте следующие варианты.

Настройка репликации master-standby в Postgres

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

Вы можете включить и настроить репликацию "основной – резервный" во время установки, используя свойства в файле конфигурации для автоматической установки. Вы также можете включить репликацию "основной-резервный" после установки. Подробнее о том, как настроить репликацию Master-Standby для Postgres…

Включение аутентификации Cassandra

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

Вы можете включить аутентификацию Cassandra во время установки, используя свойства в файле конфигурации silent. Вы также можете включить ее после установки.

Подробнее о том, как включить аутентификацию Cassandra…

Привязка маршрутизатора к защищенному порту

Если вы хотите привязать маршрутизатор к защищенному порту, например с номером меньше 1024, настройте маршрутизатор так, чтобы он запускался от имени пользователя с доступом к этим портам. По умолчанию маршрутизатор работает как пользователь apigee, у которого нет доступа к привилегированным портам.

Чтобы запустить маршрутизатор от имени другого пользователя:

Создайте файл /opt/apigee/etc/edge-router.d/RUN_USER.sh с правами root.
Добавьте в файл следующую запись:
RUN_USER=root
Если вы не хотите запускать маршрутизатор от имени пользователя root, укажите пользователя с доступом к порту.
Сохраните файл.
Если вы указали пользователя, отличного от root, измените владельца файла на этого пользователя:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Перезапустите маршрутизатор:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Как указать компоненты для установки

В таблице ниже перечислены варианты, которые можно передать параметру -p утилиты apigee-service, чтобы указать, какие компоненты нужно установить на узле.

Компонент	Описание
c	Установите только Cassandra.
zk	установить только ZooKeeper.
ds	Установите ZooKeeper и Cassandra.
ld	Установите только OpenLDAP.
мс	Установите сервер управления Edge, который также устанавливает интерфейс Edge и OpenLDAP. Если в файле конфигурации задано значение USE_LDAP_REMOTE_HOST=y, установка OpenLDAP пропускается и сервер управления использует OpenLDAP, установленный на другом узле.
r	Установите только пограничный маршрутизатор.
mp	Установите только Edge Message Processor.
rmp	Установите Edge Router и Message Processor.
ui	Установите интерфейс Edge.
qs	Установите только Qpid Server.
ps	Установите только сервер Postgres.
sax	Установите компоненты аналитики, то есть Qpid и Postgres. Используйте этот вариант только для разработки и тестирования, а не для рабочей среды.
mo	Установите монетизацию.
sa	Установите Edge в автономном режиме, то есть Cassandra, ZooKeeper, сервер управления, OpenLDAP, интерфейс Edge, маршрутизатор и процессор сообщений. Этот вариант не включает компоненты аналитики Edge: Qpid и Postgres. Используйте этот вариант только для разработки и тестирования, а не для рабочей среды.
aio	Установите все компоненты на одном узле. Используйте этот вариант только для разработки и тестирования, а не для рабочей среды.

Как создать файл конфигурации

Файл конфигурации содержит всю информацию, необходимую для установки Edge. Чаще всего для установки всех компонентов Edge можно использовать один и тот же файл конфигурации.

Однако вам придется использовать разные файлы конфигурации или изменить файл конфигурации, если:

Вы устанавливаете несколько серверов OpenLDAP и хотите настроить репликацию в рамках установки 13 узлов. Для каждого файла требуются разные значения параметров LDAP_SID и LDAP_PEER.
Вы создаете несколько центров обработки данных в рамках установки с 12 узлами. Для каждого центра обработки данных требуются разные настройки для таких свойств, как ZK_CLIENT_HOSTS и CASS_HOSTS.

Предупреждение. Если создать файл конфигурации на компьютере с Windows, а затем скопировать его на компьютер с Linux, в файл могут быть добавлены дополнительные символы конца строки, возврата каретки или новой строки, которые несовместимы со всеми утилитами Linux. Такая ситуация может возникнуть, если вы скопируете текст из редактора Windows и вставите его в окно Linux. В качестве альтернативы можно использовать утилиту Linux dos2unix, чтобы очистить файл конфигурации, созданный в Windows. Или убедитесь, что все изменения в файлах конфигурации вносятся в редакторе Linux.

Пример файла конфигурации

Ниже приведен пример полного файла конфигурации для установки 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 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.

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

Ресурс	Примечание
Имена IP/DNS	При указании IP-адреса узла не используйте сопоставление имени хоста с адресом 127.0.0.1 или IP-адрес 127.0.0.1.
ADMIN_EMAIL APIGEE_ADMINPW	Пароль администратора системы должен содержать не менее восьми символов, включая хотя бы одну прописную букву, одну строчную букву и одну цифру или специальный символ. Если вы не укажете пароль, вам будет предложено ввести его.
LICENSE_FILE	Расположение файла лицензии, который должен быть доступен пользователю apigee. Например, сохраните его в каталоге /tmp и задайте для него права доступа 777. Файл будет скопирован в каталог установки Edge.
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 хостов…
ZK_CLIENT_HOSTS	IP-адреса или имена DNS узлов ZooKeeper, используемых этим центром обработки данных. IP-адреса или имена DNS должны быть указаны в одном и том же порядке на всех узлах ZooKeeper. В установке с одним центром обработки данных это те же узлы, которые указаны в переменной ZK_HOSTS. В среде с несколькими центрами обработки данных укажите только узлы ZooKeeper в этом центре. Подробнее об установке кластера из 12 хостов…
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 хостов…
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Если вы включили аутентификацию Cassandra (CASS_AUTH=y), вы можете передать имя пользователя и пароль Cassandra, используя следующие свойства:
PG_MASTER PG_STANDBY	Установите значение, чтобы включить репликацию основного и резервного серверов Postgres в следующем формате: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	Настройте SMTP, чтобы Edge мог отправлять электронные письма для восстановления паролей и другие уведомления. Если учетные данные пользователя SMTP не требуются, опустите SMTPUSER и SMTPPASSWORD.

Порядок установки компонентов

Порядок установки компонентов зависит от желаемой топологии.

Во всех приведенных ниже примерах установки предполагается, что вы устанавливаете:

Если аутентификация Cassandra отключена (по умолчанию). Подробнее о том, как включить аутентификацию Cassandra…
Репликация Postgres master-standby отключена (по умолчанию). Подробнее о том, как настроить репликацию Master-Standby для Postgres…
Процессор сообщений и маршрутизатор на одном узле. Если вы устанавливаете процессоры сообщений и маршрутизаторы на разных узлах, сначала установите все процессоры сообщений, а затем все маршрутизаторы.

Файлы журналов установки

По умолчанию утилита setup.sh записывает информацию о журнале установки в следующие файлы:

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

Если у пользователя, запустившего утилиту setup.sh, нет доступа к этому каталогу, журнал будет записан в каталог /tmp в виде файла setup_имя_пользователя.log.

Если у пользователя нет доступа к /tmp, утилита setup.sh не будет работать.