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

Edge for Private Cloud v4.18.01

Чтобы установить Edge на узле, сначала установите утилиту apigee-setup Edge. Если ваши узлы не подключены к внешнему интернету, вам также необходимо установить локальную копию репозитория 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. При необходимости включите SELinux после установки Edge, повторив эту процедуру и задав значение SELINUX=enabled.

Требования: включите репозиторий EPEL

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

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

Чтобы установить 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. Установите утилиту apigee-service Edge и зависимости:
    > 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 на узле…

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

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

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

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

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

Как создать локальное хранилище Apigee

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

  1. Получите у Apigee имя пользователя и пароль, которые вы используете для доступа к репозиторию Apigee. Если у вас есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
  2. Войдите в узел как root, чтобы установить пакеты RPM Edge.
    Примечание. Для установки RPM-пакета требуется доступ с правами root, но для настройки Edge доступ с правами root не нужен.
  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 Edge и зависимости:
    > 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 Edge и зависимости из каталога /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/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 Edge и зависимости:
    > 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. Чтобы скачать Edge 4.16.0x/4.17.0x в репозиторий, используйте утилиту apigee-mirror. Обратите внимание, что перед командой указывается нужная версия:
    > 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

    Обратите внимание, что у вас есть файл bootstrap для всех версий 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-файла, запустите правильный файл bootstrap, используя одну из следующих команд. В этом примере устанавливается Edge 4.17.01:

  • Если вы устанавливаете ПО из файла TAR, запустите правильный файл bootstrap из репозитория:
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Чтобы завершить установку, выполните оставшиеся шаги из раздела "Установка из файла TAR" выше.
  • Если вы устанавливаете ПО с помощью веб-сервера Nginx, скачайте и запустите подходящий файл bootstrap из репозитория:
    > /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" выше.