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

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

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

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

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

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

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

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

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

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

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

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

9. Рекомендуется. После первоначальной установки Apigee рекомендует установить новый интерфейс Edge (название компонента – edge-management-ui), который представляет собой улучшенный пользовательский интерфейс для разработчиков и администраторов Apigee Edge для частного облака.

   Подробнее об установке нового интерфейса 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 от имени пользователя с полным доступом sudo или от имени пользователя root, но это не всегда возможно. Вместо этого можно разделить процесс на задачи, выполняемые пользователем root, и задачи, выполняемые пользователем с полным доступом sudo к пользователю apigee.

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

      curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      sudo bash /tmp/bootstrap_4.53.01.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. Чтобы установить RPM-пакеты Edge на узел, используйте утилиту apigee-setup:

      /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-ui, 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 произошла ошибка, вы можете попытаться устранить ее и снова запустить установщик. Установщик можно запускать несколько раз, если он обнаружит ошибку или если вы захотите изменить или обновить компонент после установки.

После установки или обновления обязательно перезапустите компонент 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").