Обзор установки Edge

Типичная установка Edge состоит из компонентов Edge, распределенных по нескольким узлам. После установки Edge на узел вы устанавливаете и настраиваете один или несколько компонентов Edge на узле.

Процесс установки

Установка Edge на узел состоит из нескольких шагов:

1. Отключите SELinux на узле или переведите его в разрешительный режим. Подробнее о том, как установить утилиту apigee-setup для Edge…
2. Решите, хотите ли вы включить аутентификацию Cassandra.
3. Решите, хотите ли вы настроить репликацию master-standby для Postgres.
4. Выберите конфигурацию Edge из списка рекомендуемых топологий. Например, вы можете установить Edge на одном узле для тестирования или на 13 узлах для рабочей среды. Подробнее о топологиях установки…
5. На каждом узле в выбранной топологии установите утилиту Edge apigee-setup:
   • Скачайте файл bootstrap_4.54.00.sh для Edge в папку /tmp/bootstrap_4.54.00.sh.
   • Установите утилиту Edge apigee-service и зависимости.
   • Установите утилиту Edge apigee-setup и зависимости.

     Подробнее о том, как установить утилиту apigee-setup для Edge…

6. Утилита apigee-setup позволяет установить один или несколько компонентов Edge на каждом узле в соответствии с выбранной топологией.

   Подробнее о том, как установить компоненты Edge на узел…

7. На узле сервера управления используйте утилиту apigee-setup, чтобы установить apigee-provision – утилиты, которые используются для создания организаций Edge и управления ими.

   Подробнее о том, как зарегистрировать организацию…

8. После завершения установки перезапустите компонент New Edge UI на каждом узле, как показано в следующем примере:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. Настройте аутентификацию и необязательные параметры для нового интерфейса Edge (компоненты edge-management-ui и edge-management-ui-static).

   Подробнее о том, как настроить новый интерфейс Edge…

После завершения установки ознакомьтесь со списком распространенных действий, которые выполняются после установки.

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

Файлы дистрибутива Apigee Edge устанавливаются как набор RPM и зависимостей. Для установки, удаления и обновления RPM-пакетов Edge команды должны выполняться пользователем root или пользователем с полным доступом sudo. Полный доступ sudo означает, что пользователь может выполнять те же операции, что и пользователь root.

Чтобы запустить указанные ниже команды или скрипты, пользователь должен иметь права root или полный доступ к sudo:

• apigee-service:
  • Команды apigee-service: install, uninstall, update.
  • Команды apigee-all: install, uninstall, update.
• Скрипт setup.sh для установки компонентов Edge (если вы ещё не использовали apigee-service install для установки необходимых RPM). Затем корневой доступ или полный доступ с привилегиями администратора, если он не требуется.
• Скрипт update.sh для обновления компонентов Edge.

Кроме того, установщик Edge создает в вашей системе нового пользователя с именем apigee. Многие команды Edge вызывают sudo для запуска от имени пользователя apigee.

Чтобы выполнять все остальные команды, пользователь должен иметь полный доступ к sudo для пользователя apigee. К ним относятся:

• Команды утилиты apigee-service, в том числе:
  • Команды apigee-service, например start, stop, restart, configure.
  • Команды apigee-all, например start, stop, restart, configure.

Создание пользователя с полным доступом sudo к пользователю apigee

Чтобы предоставить пользователю полный доступ sudo к пользователю apigee, используйте команду visudo, чтобы изменить файл sudoers и добавить:

installUser        ALL=(apigee)      NOPASSWD: ALL

где installUser – имя пользователя, работающего с Edge.

Настройка разрешений для файлов конфигурации

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

При создании файла конфигурации вы можете изменить его владельца на apigee:apigee, чтобы обеспечить доступ к нему для команд Edge:

1. Создайте файл в редакторе, используя любой аккаунт.
2. chown владельца файла на apigee:apigee или, если вы изменили пользователя, запускающего сервис Edge, с apigee, измените владельца файла на пользователя, который запускает сервис Edge.

Разделение задач по установке Edge между пользователем root и другими пользователями

Проще всего выполнить весь процесс установки Edge от имени пользователя root или пользователя, у которого есть полный доступ sudo, но это не всегда возможно. Вместо этого вы можете разделить процесс на задачи, выполняемые пользователем root, и задачи, выполняемые пользователем с полным доступом sudo к пользователю apigee.

1. Задачи, выполняемые пользователем root:
   1. Скачайте и запустите файл bootstrap_4.54.00.sh:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      На этом шаге устанавливается утилита apigee-service и создается пользователь apigee.

   2. Настройте для пользователя полный доступ sudo к пользователю apigee, как описано в разделе Создание пользователя с полным доступом sudo к пользователю apigee.
   3. Установите утилиту apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Используйте утилиту apigee-setup, чтобы установить RPM-пакеты Edge на узел:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM-пакеты Edge, которые вы устанавливаете на узле, зависят от вашей топологии. Доступны следующие компоненты: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. После того как пользователь root установит RPM-пакеты Edge на узле, пользователь с полным доступом sudo к пользователю apigee завершит процесс настройки:
   1. Используйте утилиту setup.sh, чтобы завершить настройку компонентов Edge на узле. Форма команды зависит от компонентов, установленных на узле. Полный список приведен в статье Как установить компоненты Edge на узле.

      Например, чтобы завершить установку ZooKeeper и Cassandra, используйте следующую команду:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      где configFile – файл конфигурации Edge.

      Чтобы выполнить полную установку, используйте следующую команду:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Местоположение файлов конфигурации установки

Утилите apigee-setup необходимо передать файл конфигурации, содержащий информацию об установке Edge. Единственное требование к автоматической установке – файл конфигурации должен быть доступен или доступен для чтения пользователю apigee. Например, поместите файл в каталог /usr/local/var или /usr/local/share на узле и chown его в apigee:apigee.

В файле конфигурации необходимо указать все данные, кроме пароля системного администратора Edge. Если вы не укажете пароль, утилита apigee-setup предложит ввести его в командной строке.

Подробнее о том, как установить компоненты Edge на узел…

Что делать, если не удается установить приложение

Если при установке компонента Edge произошел сбой, попробуйте устранить проблему и запустить установщик снова. Установщик можно запускать несколько раз, если он обнаружит ошибку или если вы захотите изменить или обновить компонент после установки.

После установки или обновления обязательно перезапустите компонент New Edge UI на каждом узле, на котором он запущен.

Установка с подключением к интернету или без него

Чтобы установить Edge на узел, узел должен иметь доступ к репозиторию Apigee:

• Узлы с внешним подключением к интернету

  Узлы с внешним подключением к интернету получают доступ к репозиторию Apigee, чтобы установить RPM-пакеты Edge и зависимости.

• Узлы без внешнего подключения к интернету

  Узлы без внешнего подключения к интернету могут получить доступ к зеркальной версии репозитория Apigee, которую вы настроили внутри сети. Это хранилище содержит все RPM-пакеты Edge, но вам необходимо убедиться, что все остальные зависимости доступны из хранилищ во внутренней сети.

  Чтобы создать внутренний репозиторий Apigee, вам потребуется узел с внешним доступом к интернету, чтобы иметь возможность загружать RPM-пакеты Edge и зависимости. После создания внутреннего репозитория его можно перенести на другой узел или сделать этот узел доступным для узлов Edge для установки.

Как использовать локальный репозиторий Edge для поддержки версии Edge

Одна из причин использования локального или зеркального репозитория – установка Edge на узлах без внешнего подключения к интернету, как описано в предыдущем разделе.

Как устранить зависимости при установке RPM

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

Если вы выполняете установку на компьютере с доступом к интернету, узел может скачать необходимые RPM-пакеты и зависимости. Однако если вы выполняете установку с узла без доступа к интернету, обычно вы настраиваете внутреннее хранилище, содержащее все необходимые зависимости. Единственный способ гарантировать, что все зависимости включены в локальное хранилище, – попытаться выполнить установку, определить отсутствующие зависимости и скопировать их в локальное хранилище, пока установка не будет выполнена успешно.

Основные команды Yum

Инструменты установки Edge для Linux используют Yum для установки и обновления компонентов. Для управления установкой на узле может потребоваться несколько команд Yum.

• Очистите все кеши Yum:

  sudo yum clean all

• Чтобы обновить компонент Edge:

  sudo yum update componentName

  Пример:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Структура файловой системы

Edge устанавливает все файлы в каталоге /opt/apigee.

В этом руководстве и в руководстве по операциям Edge корневой каталог установки обозначается следующим образом:

/opt/apigee

При установке Apigee Edge для частного облака используется следующая структура файловой системы.

Файлы журналов

Файл журнала для скрипта apigee-setup и setup.sh записывается в /tmp/setup-root.log.

Файлы журналов для каждого компонента находятся в каталоге /opt/apigee/var/log. У каждого компонента есть свой подкаталог. Например, журналы сервера управления находятся в каталоге:

/opt/apigee/var/log/edge-management-server

В таблицах ниже указано расположение файлов журналов.

Данные

Включить проверку системы при установке

Файл конфигурации установки Edge поддерживает следующее свойство:

ENABLE_SYSTEM_CHECK=y

Если вы зададите для этого свойства значение "y", установщик проверит, соответствует ли система требованиям к ЦП и памяти для устанавливаемого компонента. Значение по умолчанию – n (проверка отключена).