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

Edge для частного облака версии 4.16.05

Чтобы установить Edge на узле, сначала установите утилиту apigee-setup Edge. Если ваши узлы не подключены к внешнему интернету, вам также необходимо установить локальную копию репозитория Apigee.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
  7. Установите утилиту apigee-mirror на узле:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  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.05.sh из локального репозитория, чтобы установить утилиту apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.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.05.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.05.tar.gz

    Эта команда создает новый каталог repos в каталоге, содержащем файл .tar. Пример: /tmp/repos.
  5. Установите утилиту apigee-service Edge и зависимости из каталога /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/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.05.sh в каталог /tmp/bootstrap_4.16.05.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

    где uName:pWord – имя пользователя и пароль, заданные выше для репозитория, а remoteRepo – IP-адрес или DNS-имя узла репозитория.
  6. На удаленном узле установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.16.05.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.05.sh и выполните новую синхронизацию:

  1. Скачайте файл Edge bootstrap_4.16.05.sh в каталог /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  2. Выполните синхронизацию:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  3. Если вы хотите скачать весь репозиторий, выполните следующую команду:
    > /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

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

Чтобы добавить версию 4.16.01 в репозиторий 4.15.05:

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

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

    Эту же команду можно использовать для обновления репозитория 4.16.01.
  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 thirdparty

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

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

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

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

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