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

Edge for Private Cloud версии 4.17.09

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

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

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

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

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

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

> rpm -qa | grep libdb

Если вы видите, что версия RPM libdb4 более поздняя, чем 4.8, используйте следующую команду, чтобы заменить RPM:

> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm

Если вам нужно скачать эти RPM-пакеты, вы можете получить их по следующим ссылкам:

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

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

  1. Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
  2. Войдите в узел как пользователь root, чтобы установить RPM-пакеты Edge.
  3. Установите yum-utils и yum-plugin-priorities: 
    > sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
  4. Отключите SELinux, как описано выше.
  5. Включите репозиторий EPEL, как описано выше.
  6. Если вы устанавливаете приложение на AWS, выполните следующую команду yum-configure-manager: 
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Скачайте файл Edge bootstrap_4.17.09.sh в папку /tmp/bootstrap_4.17.09.sh: 
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Установите утилиту apigee-service и зависимости: 
    > sudo bash /tmp/bootstrap_4.17.09.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*'
  9. Используйте apigee-service, чтобы установить утилиту apigee-setup: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Используйте apigee-setup, чтобы установить и настроить компоненты Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

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

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

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

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

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

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

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

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

  9. Установите утилиту apigee-mirror на узел: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  10. Используйте утилиту 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 из локального репозитория.

  11. (Необязательно.) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен локальный репозиторий, сначала выполните следующие команды:
    1. Выполните команду bootstrap_4.17.09.sh из локального репозитория, чтобы установить утилиту apigee-service: 
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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.17.09.tar.gz: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Скопируйте TAR-файл на узел, где вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. Установите yum-utils и yum-plugin-priorities: 
    > sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
  4. На новом узле отключите SELinux, как описано выше.
  5. Включите репозиторий EPEL, как описано выше.
  6. На новом узле распакуйте файл в каталог /tmp:
    > tar -xzf apigee-4.17.09.tar.gz

    Эта команда создает новый каталог с названием repos в каталоге, содержащем файл TAR. Пример: /tmp/repos..

  7. Установите утилиту apigee-service для Edge и зависимости из /tmp/repos: 
    > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Обратите внимание, что в этой команде вы указываете путь к каталогу repos.

  8. Установите утилиту apigee-setup с помощью apigee-service: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. Используйте 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. На удаленном узле скачайте файл Edge bootstrap_4.17.09.sh в каталог /tmp/bootstrap_4.17.09.sh: 
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

    где uName:pWord – имя пользователя и пароль, которые вы задали выше для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.

  8. На удаленном узле установите утилиту Edge apigee-service и зависимости: 
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName
  apigeepassword=pWord apigeeprotocol=http://

    где uName:pWord – имя пользователя и пароль для репозитория.

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

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

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

  1. Скачайте файл bootstrap_4.17.09.sh для Edge в каталог /tmp/bootstrap_4.17.09.sh: 
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  2. Запустите файл Edge bootstrap_4.17.09.sh: 
    > sudo bash /tmp/bootstrap_4.17.09.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.17.09

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

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

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

    Вы должны увидеть результат в указанном ниже формате, где xyz – это номер сборки:

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

    Используйте эту же команду, чтобы обновить репозитории 4.16.0x/4.17.05, указав нужные номера версий.

  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.sh
bootstrap_4.17.01.sh
bootstrap_4.17.05.sh 
bootstrap_4.17.09.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:

  • Если вы устанавливаете из 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" выше.