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

Edge for Private Cloud 4.19.01

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 поставляются с более поздней версией. Если у вас более поздняя версия, удалите ее, и установщик Edge установит версию 4.8.

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

rpm -qa | grep libdb4

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

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

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

  1. Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть username:password для 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. Проверьте версию 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.19.01.sh в папку /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  10. Установите утилиту apigee-service и зависимости: 
    sudo bash /tmp/bootstrap_4.19.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 находятся за брандмауэром или каким-либо другим способом запрещен доступ к Интернету, вы должны создать несколько репозиториев или зеркал, которые содержат файлы, которые вам понадобятся во время установки. Эти зеркала должны быть доступны для всех узлов. После создания узлы могут обращаться к этим локальным зеркалам для установки Edge.

Для установки Apigee Edge на узлах без подключения к интернету требуется доступ к следующим локальным хранилищам:

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

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

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

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

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

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

  6. Установите утилиту apigee-mirror на узел: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  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.19.01.sh из локального репозитория, чтобы установить утилиту apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.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-файла

Чтобы установить из TAR-файла:

  1. На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Скопируйте TAR-файл на узел, где вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. На новом узле отключите SELinux, как описано выше.
  4. Убедитесь, что на новом узле у вас есть доступ к локальному хранилищу утилиты Yum и хранилищу EPEL.
  5. Убедитесь, что все внешние интернет-репозитории отключены (так и должно быть, поскольку вы устанавливаете ПО на компьютер без доступа к интернету): 
    sudo yum repolist

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

  6. На новом узле установите yum-utils и yum-plugin-priorities из локального хранилища: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities

    Чтобы вы могли установить инструменты Yum, ваша команда по операциям или другая группа в вашей организации должна настроить для вас локальный репозиторий.

  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.19.01.tar.gz

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

  11. Установите утилиту apigee-service для Edge и зависимости из /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.19.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

Чтобы установить модуль из репозитория с помощью веб-сервера 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.19.01.sh в каталог /tmp/bootstrap_4.19.01.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

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

  9. На удаленном узле установите утилиту Edge apigee-service и зависимости: 
    sudo bash /tmp/bootstrap_4.19.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.19.01.sh и выполните синхронизацию.

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

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

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

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

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

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

    apigee-mirror-4.19.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.sh
bootstrap_4.17.01.sh
bootstrap_4.17.05.sh
bootstrap_4.17.09.sh
bootstrap_4.18.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.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:

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