Обзор пограничной установки

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

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

Установка Edge на узле — это многоэтапный процесс:

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

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

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

   См. раздел Установка компонентов Edge на узле .

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

   Дополнительную информацию см. в разделе «Введение в организацию» .

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 и зависимостей. Для установки, удаления и обновления Edge RPM команды должны выполняться пользователем root или пользователем с полным доступом sudo. Полный доступ к sudo означает, что у пользователя есть доступ к sudo для выполнения тех же операций, что и у пользователя root.

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

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

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

Любой пользователь, который хочет запускать все другие команды, кроме показанных выше, должен быть пользователем с полным доступом sudo к пользователю «apigee». Эти команды включают в себя:

• команды утилиты apigee-service , в том числе:
  • команды apigee-service, такие как start, stop, restart, configure .
  • apigee-все команды, такие как 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 и пользователем без полномочий root

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

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

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.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 для установки Edge RPM на узле:

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

      Edge RPM, которые вы устанавливаете на узле, зависят от вашей топологии. В список доступных компонентов входят: 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 устанавливает Edge RPM на узле, пользователь с полным доступом 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 на каждом узле, на котором он запущен.

Установка через Интернет или без Интернета

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

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

  Узлы с внешним подключением к Интернету получают доступ к репозиторию Apigee для установки Edge RPM и зависимостей.

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

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

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

Использование локального репозитория 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 Operations Guide корневой каталог установки указан как:

/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», чтобы отключить проверку.

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

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

Установка Edge на узле — это многоэтапный процесс:

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

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

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

   См. раздел Установка компонентов Edge на узле .

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

   Дополнительную информацию см. в разделе «Введение в организацию» .

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 и зависимостей. Для установки, удаления и обновления Edge RPM команды должны выполняться пользователем root или пользователем с полным доступом sudo. Полный доступ к sudo означает, что у пользователя есть доступ к sudo для выполнения тех же операций, что и у пользователя root.

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

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

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

Любой пользователь, который хочет запускать все другие команды, кроме показанных выше, должен быть пользователем с полным доступом sudo к пользователю «apigee». Эти команды включают в себя:

• команды утилиты apigee-service , в том числе:
  • команды apigee-service, такие как start, stop, restart, configure .
  • apigee-все команды, такие как 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 и пользователем без полномочий root

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

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

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.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 для установки Edge RPM на узле:

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

      Edge RPM, которые вы устанавливаете на узле, зависят от вашей топологии. В список доступных компонентов входят: 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 устанавливает Edge RPM на узле, пользователь с полным доступом 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 на каждом узле, на котором он запущен.

Установка через Интернет или без Интернета

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

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

  Узлы с внешним подключением к Интернету получают доступ к репозиторию Apigee для установки Edge RPM и зависимостей.

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

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

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

Использование локального репозитория 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 Operations Guide корневой каталог установки указан как:

/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», чтобы отключить проверку.

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

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

Установка Edge на узле — это многоэтапный процесс:

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

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

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

   См. раздел Установка компонентов Edge на узле .

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

   Дополнительную информацию см. в разделе «Введение в организацию» .

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 и зависимостей. Для установки, удаления и обновления Edge RPM команды должны выполняться пользователем root или пользователем с полным доступом sudo. Полный доступ к sudo означает, что у пользователя есть доступ к sudo для выполнения тех же операций, что и у пользователя root.

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

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

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

Любой пользователь, который хочет запускать все другие команды, кроме показанных выше, должен быть пользователем с полным доступом sudo к пользователю «apigee». Эти команды включают в себя:

• команды утилиты apigee-service , в том числе:
  • команды apigee-service, такие как start, stop, restart, configure .
  • apigee-все команды, такие как 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 и пользователем без полномочий root

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

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

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.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 для установки Edge RPM на узле:

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

      Edge RPM, которые вы устанавливаете на узле, зависят от вашей топологии. В список доступных компонентов входят: 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 устанавливает Edge RPM на узле, пользователь с полным доступом 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 на каждом узле, на котором он работает.

Интернет или не-внутренняя установка

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

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

  Узлы с внешним подключением к Интернету получают доступ к репозиторию Apigee для установки краевых оборотов и зависимостей.

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

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

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

Использование локального репозитория края для поддержания версии края

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

Решение зависимости установки RPM

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

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

Общие команды Yum

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

• Очистите все юмские кеши:

  sudo yum clean all

• Чтобы обновить краевой компонент:

  sudo yum update componentName

  Например:

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

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

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

В этом руководстве и в Руководстве по операциям с краями корневой каталог установлен как:

/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», чтобы отключить чек.

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

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

Установка края на узле является многоэтапным процессом:

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

     Смотрите утилиту Edge Apigee-Setup для получения дополнительной информации.

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

   См. Установленные компоненты Edge на узле .

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

   Смотрите на борту организации для большего.

8. Перезапустите классический компонент пользовательского интерфейса на каждом узле после завершения установки, как показано в следующем примере:

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

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

   Для получения дополнительной информации см. Установите новый интерфейс Edge .

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

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

Файлы распределения Apigee Edge устанавливаются в виде набора RPMS и зависимостей. Чтобы установить, удалить и обновлять обороты с краями, команды должны выполняться пользователем root или пользователем, который имеет полный доступ Sudo. Для полного доступа SUDO это означает, что пользователь имеет доступ SUDO для выполнения тех же операций, что и root.

Любой пользователь, который хочет запустить следующие команды или сценарии, должен быть корневым, либо пользователем с полным доступом SUDO:

• утилита Apigee-Service :
  • Команды Apigee-Service : install, uninstall, update .
  • Команды Apigee-All : install, uninstall, update .
• Сценарий setup.sh для установки краевых компонентов (если вы уже не использовали « apigee-service install » для установки требуемых оборотов. Тогда root или полный доступ Sudo, если этого не требуется.)
• сценарий обновления.

Кроме того, установщик 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 или пользователь, который имеет полный доступ Sudo, это не всегда возможно. Вместо этого вы можете разделить процесс на задачи, выполняемые Root, и задачи, выполняемые пользователем с полным доступом SUDO к пользователю "Apigee".

1. Задачи, выполняемые корнем:
   1. Загрузите и запустите файл bootstrap_4.53.00.sh :

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.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 , чтобы установить краевые обороты на узле:

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

      Крайные обороты, которые вы устанавливаете на узле, зависят от вашей топологии. Список доступных компонентов включает в себя: 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 устанавливает краевые обороты на узле, пользователь с полным доступом Sudo к пользователю "Apigee" завершает процесс конфигурации:
   1. Используйте утилиту setup.sh , чтобы завершить конфигурацию компонентов края на узле. Форма команды зависит от компонентов, которые вы установили на узле. Полный список см. Компоненты установки 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 на каждом узле, на котором он работает.

Интернет или не-внутренняя установка

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

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

  Узлы с внешним подключением к Интернету получают доступ к репозиторию Apigee для установки краевых оборотов и зависимостей.

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

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

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

Использование локального репозитория края для поддержания версии края

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

Решение зависимости установки RPM

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

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

Общие команды Yum

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

• Очистите все юмские кеши:

  sudo yum clean all

• Чтобы обновить краевой компонент:

  sudo yum update componentName

  Например:

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

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

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

В этом руководстве и в Руководстве по операциям с краями корневой каталог установлен как:

/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», чтобы отключить чек.