Как установить утилиту apigee-setup для Edge

Edge for Private Cloud v4.18.01

To install Edge on a node, you first install the Edge apigee-setup utility. Если у ваших узлов нет внешнего подключения к интернету, вам также необходимо установить локальную копию репозитория Apigee.

Каталог установки по умолчанию: /opt/apigee

Edge устанавливает все файлы в каталог /opt/apigee. Изменить этот каталог нельзя. Однако при желании вы можете создать символическую ссылку, чтобы сопоставить /opt/apigee с другим местоположением. Подробнее о требованиях к установке…

Предварительное требование: отключите SELinux

Прежде чем устанавливать утилиту apigee-setup или любые компоненты Edge, необходимо отключить SELinux или перевести его в разрешающий режим. При необходимости после установки Edge вы можете снова включить SELinux.

  • Чтобы временно перевести SELinux в разрешающий режим, выполните следующую команду:
    1. В операционной системе Linux 6.x:
      sudo echo 0 > /selinux/enforce

      Чтобы снова включить SELinux после установки Edge:
      sudo echo 1 > /selinux/enforce
    2. В операционной системе Linux 7.x:
      sudo setenforce 0

      Чтобы снова включить SELinux после установки Edge, выполните следующую команду:
      sudo setenforce 1
  • Чтобы навсегда отключить SELinux или перевести его в разрешающий режим:
    1. Откройте файл /etc/sysconfig/selinux в редакторе.
    2. Установите значение SELINUX=disabled или SELINUX=permissive.
    3. Сохраните изменения.
    4. Перезапустите узел.
    5. При необходимости после установки Edge снова включите SELinux, повторив эту процедуру и задав значение SELINUX=enabled.

Предварительное требование: включите репозиторий EPEL

Чтобы установить или обновить Edge или создать локальное хранилище, необходимо включить Extra Packages for Enterprise Linux (EPEL). Команда зависит от версии RedHat/CentOS:

  • Для RedHat/CentOS/Oracle 7.x:?
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • Для RedHat/CentOS/Oracle 6.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Предварительное требование: проверьте версию библиотеки libdb4 в RedHat 7.4 и CentOS 7.4

В RedHat 7.4 и CentOS 7.4 перед установкой проверьте версию RPM-пакетов libdb4. Для Edge требуется версия 4.8, а некоторые версии RedHat 7.4 и CentOS 7.4 поставляются с более поздней версией. Если у вас более поздняя версия, удалите ее, и установщик Edge установит версию 4.8.

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

> rpm -qa | grep libdb4

Если вы видите, что версия RPM libdb4 более поздняя, чем 4.8, удалите ее.

Установите утилиту Edge apigee-setup на узел с внешним подключением к Интернету.

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

  1. Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
  2. Войдите в узел как пользователь root, чтобы установить RPM-пакеты Edge.
    Примечание. Для установки RPM-пакетов требуется доступ с правами root, но настроить Edge можно и без него.
  3. Установите yum-utils и yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Отключите SELinux, как описано выше.
  5. Включите репозиторий EPEL, как описано выше.
  6. Проверьте версию libdb4, как описано выше.
  7. Если вы устанавливаете приложение на Oracle 7.x, выполните следующую команду:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. Если вы устанавливаете ПО на AWS, выполните следующие команды yum-configure-manager:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Скачайте файл Edge bootstrap_4.18.01.sh в каталог /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.

    По умолчанию установщик проверяет, установлена ли у вас Java 1.8. Если нет, то оно будет установлено. Используйте параметр JAVA_FIX, чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:

    I – установить OpenJDK 1.8 (по умолчанию);
    C – продолжить без установки Java;
    Q – выйти. В этом случае вам нужно будет установить Java самостоятельно.

    При установке утилиты apigee-service создается файл /etc/yum.repos.d/apigee.repo, который определяет хранилище Apigee. Чтобы посмотреть файл определения, используйте команду:
    > cat /etc/yum.repos.d/apigee.repo

    Чтобы посмотреть содержимое хранилища, используйте команду:
    > sudo yum -v repolist 'apigee*'
  11. Используйте apigee-service, чтобы установить утилиту apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

Установите утилиту Edge apigee-setup на узел без внешнего подключения к Интернету.

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

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

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

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

Создание локального хранилища Apigee

Чтобы создать локальное хранилище Apigee:

  1. Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
  2. Войдите в узел как root, чтобы установить Edge RPM.
    Примечание. Для установки RPM требуются права root, но для настройки Edge они не нужны.
  3. Отключите SELinux, как описано выше.
  4. Скачайте файл Edge bootstrap_4.18.01.sh в каталог /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  5. Установите утилиту apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
  6. Установите утилиту apigee-mirror на узел:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Примечание. Если вы обновляете существующее хранилище до версии 4.18.01, вам нужно только обновить apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  7. Используйте утилиту apigee-mirror, чтобы синхронизировать репозиторий Apigee с каталогом /opt/apigee/data/apigee-mirror/repos/.

    Чтобы минимизировать размер репозитория, добавьте --only-new-rpms, чтобы скачать только последние RPM. Для скачивания потребуется около 1,6 ГБ места на диске:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Если вы хотите скачать весь репозиторий, включая старые RPM, не указывайте --only-new-rpms. Для полного скачивания потребуется около 6 ГБ места на диске:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Теперь у вас есть локальная копия репозитория Apigee. В следующем разделе описывается, как установить утилиту Edge apigee-setup из локального репозитория.
  8. (Необязательно.) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен локальный репозиторий, сначала выполните следующие команды:
    1. Запустите bootstrap_4.18.01.sh из локального репозитория, чтобы установить утилиту apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Используйте apigee-service, чтобы установить утилиту apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Используйте apigee-setup, чтобы установить и настроить компоненты Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

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

У вас есть два варианта установки Edge из локального репозитория. Вы можете:

  • Создайте TAR-файл репозитория, скопируйте его на узел и установите Edge из этого файла.
  • Установите веб-сервер на узел с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет веб-сервер Nginx, но вы можете использовать и собственный.

Установите из файла TAR:

  1. На узле с локальным хранилищем используйте следующую команду, чтобы упаковать локальное хранилище в один TAR-файл с названием /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Скопируйте TAR-файл на узел, где вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. На новом узле отключите SELinux, как описано выше.
  4. На новом узле включите репозиторий EPEL, как описано выше.
  5. Убедитесь, что на новом узле отключены все внешние интернет-репозитории. При выполнении следующей команды все внешние репозитории должны быть отключены, а локальный репозиторий Apigee и все ваши внутренние репозитории – включены:
    > sudo yum repolist
  6. На новом узле установите yum-utils и yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  7. На новом узле проверьте версию libdb4, как описано выше.
  8. Если вы устанавливаете приложение на Oracle 7.x, выполните следующую команду:
    > sudo yum-config-manager --enable ol7_optional_latest
  9. Если вы устанавливаете приложение на AWS, выполните следующую команду yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. На новом узле распакуйте файл в каталог /tmp:
    > tar -xzf apigee-4.18.01.tar.gz

    Эта команда создает новый каталог с названием repos в каталоге, содержащем TAR-файл. Например, /tmp/repos.
  11. Установите утилиту apigee-service и зависимости из каталога /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Обратите внимание, что в этой команде вы указываете путь к каталогу repos.
  12. Используйте apigee-service, чтобы установить утилиту apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Используйте apigee-setup, чтобы установить и настроить компоненты Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

Установите из репозитория с помощью веб-сервера Nginx:

  1. Установите веб-сервер Nginx на узел репозитория:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. По умолчанию Nginx настроен на использование localhost в качестве имени сервера и порта 3939. Чтобы изменить эти значения:
    1. Откройте файл /opt/apigee/customer/application/mirror.properties в редакторе. Если файла нет, создайте его.
    2. При необходимости задайте следующие значения:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Перезапустите Nginx:
      ?> /opt/nginx/scripts/apigee-nginx restart
  3. По умолчанию для репозитория требуется имя пользователя и пароль admin:admin. Чтобы изменить эти учетные данные, задайте следующие переменные среды:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. На новом узле установите yum-utils и yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. На новом узле отключите SELinux, как описано выше.
  6. На новом узле включите репозиторий EPEL, как описано выше.
  7. На новом узле проверьте версию libdb4, как описано выше.
  8. На удаленном узле скачайте файл Edge bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

    где uName:pWord – имя пользователя и пароль, заданные выше для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.
  9. На удаленном узле установите утилиту apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    где uName:pWord – имя пользователя и пароль для доступа к хранилищу.
  10. На удаленном узле используйте apigee-service, чтобы установить утилиту apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Используйте apigee-setup, чтобы установить и настроить компоненты Edge на удаленном узле. Подробнее о том, как установить компоненты Edge на узел…

Как обновить локальное хранилище Apigee

Чтобы обновить репозиторий, скачайте последнюю версию файла bootstrap_4.18.01.sh и выполните синхронизацию:

  1. Скачайте файл Edge bootstrap_4.18.01.sh в каталог /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Запустите файл Edge bootstrap_4.18.01.sh:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
  3. Обновите apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Выполните синхронизацию:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Если вы хотите синхронизировать все хранилище:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Очистка локального репозитория Apigee

При очистке локального репозитория удаляются /opt/apigee/data/apigee-mirror и /var/tmp/yum-apigee-*.

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

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Добавление или обновление Edge 4.16.0x/4.17.0x в репозитории 4.18.01

Если вам нужно поддерживать установки для Edge 4.16.0x или 4.17.0x в репозитории 4.18.01, вы можете поддерживать репозиторий, содержащий все версии. Из этого репозитория можно установить любую версию Edge.

Чтобы добавить 4.16.0x/4.17.0x в репозиторий 4.18.01:

  1. Убедитесь, что у вас установлена утилита apigee-mirror версии 4.18.01:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Вы должны увидеть результат в указанном ниже формате, где xyz – это номер сборки:
    apigee-mirror-4.18.01-0.0.xyz
  2. Используйте утилиту apigee-mirror, чтобы скачать Edge 4.16.0x/4.17.0x в свое хранилище. Обратите внимание, что в начале команды нужно указать нужную версию:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Используйте эту же команду, чтобы позже обновить репозитории 4.16.0x/4.17.0x, указав нужные номера версий.
  3. Проверьте структуру файлов в каталоге /opt/apigee/data/apigee-mirror/repos:
    > ls /opt/apigee/data/apigee-mirror/repos

    Вы должны увидеть следующие файлы и каталоги:
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty

    Обратите внимание, что у вас есть файл начальной загрузки для всех версий Edge. Каталог apigee также содержит отдельные каталоги для каждой версии Edge.
  4. Чтобы упаковать репозиторий в файл TAR, используйте следующую команду:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Эта команда упаковывает все репозитории 4.17.0x и 4.16.0x в один файл TAR. Нельзя упаковать только часть репозитория.

Чтобы установить Edge из локального репозитория или файла TAR, запустите нужный файл начальной загрузки с помощью одной из следующих команд. В этом примере устанавливается Edge 4.17.01:

  • Если вы устанавливаете Edge из TAR-файла, запустите нужный файл начальной загрузки из хранилища:
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Чтобы завершить установку, выполните оставшиеся шаги из раздела "Установка из TAR-файла" выше.
  • Если вы используете веб-сервер Nginx, скачайте и запустите нужный файл начальной загрузки из хранилища:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Чтобы завершить установку, выполните оставшиеся шаги из раздела "Установка из хранилища с помощью веб-сервера Nginx" выше.