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

Edge for Private Cloud v. 4.16.09

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

Создание символической ссылки из /opt/apigee

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

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

Чтобы создать символическую ссылку, выполните следующие действия перед скачиванием файла bootstrap_4.16.09.sh. Все эти действия необходимо выполнять от имени пользователя root:

  1. Создайте пользователя и группу apigee:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. Создайте символическую ссылку из /opt/apigee на нужный корневой каталог установки:
    > ln -Ts /srv/myInstallDir /opt/apigee
    где /srv/myInstallDir – нужное расположение файлов Edge.
  3. Передайте право собственности на корневой каталог установки и символическую ссылку пользователю apigee:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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

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

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

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

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

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

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

  1. Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
  2. Войдите в узел как пользователь root, чтобы установить RPM-пакеты Edge.
    Примечание. Для установки RPM-пакетов требуется доступ с правами root, но настроить Edge можно и без него.
  3. Отключите SELinux, как описано выше.
  4. Скачайте файл Edge bootstrap_4.16.09.sh в каталог /tmp/bootstrap_4.16.09.sh:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  5. Установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.16.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*'
  6. Используйте apigee-service, чтобы установить утилиту apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

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

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

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

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

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

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

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

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

    Примечание. Если вы обновляете существующее хранилище до версии 4.16.09, вам нужно только обновить apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  8. Используйте утилиту 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 из локального репозитория.
  9. (Необязательно.) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен локальный репозиторий, сначала выполните следующие команды:
    1. Запустите bootstrap_4.16.09.sh из локального репозитория, чтобы установить утилиту apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.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.16.09.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Скопируйте TAR-файл на узел, где вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. На новом узле отключите SELinux, как описано выше.
  4. На новом узле распакуйте файл в каталог /tmp:
    > tar -xzf apigee-4.16.09.tar.gz

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

    Обратите внимание, что в этой команде вы указываете путь к каталогу repos.
  6. Используйте apigee-service, чтобы установить утилиту apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Используйте 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. На новом узле отключите SELinux, как описано выше.
  5. На удаленном узле скачайте файл начальной загрузки Edge bootstrap_4.16.09.sh в каталог /tmp/bootstrap_4.16.09.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh

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

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

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

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

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

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

Чтобы добавить 4.16.01/4.16.05 в репозиторий 4.16.09:

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

    Результат должен выглядеть так, как показано ниже, где xyz – это номер сборки:
    apigee-mirror-4.16.09-0.0.xyz
  2. Используйте утилиту apigee-mirror, чтобы скачать Edge 4.16.01 или 4.16.05 в свое хранилище. Обратите внимание, что в начале команды нужно указать apigeereleasever=4.16.01 или apigeereleasever=4.16.05:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Используйте эту же команду, чтобы позже обновить хранилище 4.16.01/4.16.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.16.09.sh thirdparty

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

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

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

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

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

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