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

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

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

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

Требование: отключите SELinux

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

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

    • Предварительное требование: включите репозиторий EPEL

    Чтобы установить или обновить Edge или создать локальный репозиторий, необходимо включить Extra Packages for Enterprise Linux (EPEL). Для Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x или Oracle Linux 9.x выполните следующие команды:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Предварительные требования для RHEL 9/Rocky 9/Oracle 9

    Если вы устанавливаете Edge на сервере под управлением Red Hat Enterprise Linux (RHEL) 9, Rocky 9 или Oracle 9, перед установкой выполните следующие действия:

    1. Включите Extra Packages for Enterprise Linux (EPEL): 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Отключите Postgres и Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Информацию об изменениях, которые необходимо внести перед установкой PostgreSQL и LDAP, можно найти в разделах Требования к предварительной установке базы данных PostgreSQL и Изменения, которые необходимо внести перед установкой SymasLDAP 2.6.10.

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

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

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

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

      Для Apigee Edge for Private Cloud 4.54.00 требуется двойная поддержка Java с установленными на узле Java 17 и Java 21. Перед запуском скрипта начальной загрузки необходимо установить Java 17 и Java 21. Программа установки только проверяет, установлены ли обе версии JDK, но не устанавливает Java автоматически.

      При установке утилиты apigee-service создается файл /etc/yum.repos.d/apigee.repo, который определяет репозиторий Apigee. Чтобы посмотреть файл определения, используйте команду:

      cat /etc/yum.repos.d/apigee.repo

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

      sudo yum -v repolist 'apigee*'
    8. Используйте apigee-service, чтобы установить утилиту apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

    Устранение неполадок

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

    Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

    В таблице ниже приведены возможные решения для этих ошибок.

    Тип ошибки Возможные решения
    Пароль содержит недопустимые символы. Не используйте специальные символы в пароле Apigee.
    Проблемы с подключением

    Проверьте подключение к сети, выполнив следующую команду ncat:

    nc -v software.apigee.com 443

    Вы увидите сообщение, похожее на следующее:

    Connection to software.apigee.com 443 port [tcp/https] succeeded!

    Если у вас не установлен инструмент nc, выполните следующую команду telnet:

    telnet software.apigee.com 443

    Если команды выполнены успешно, вы можете использовать сочетание клавиш CTRL+C, чтобы прервать открытое подключение.

    Если одна из команд не выполняется, значит у вас ограниченное подключение к сети или оно отсутствует. Обратитесь к администратору сети.
    Неправильные учетные данные

    Убедитесь, что вы правильно указали имя пользователя и пароль.

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

    curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
    Проблемы с прокси-сервером В вашей локальной конфигурации используется исходящий HTTP-прокси, и вы не расширили эту конфигурацию на менеджер пакетов yum. Проверьте переменные среды: 
    echo $http_proxy
echo $https_proxy

    Для исходящего HTTP-прокси используйте один из следующих вариантов:

    • Добавьте конфигурацию HTTP-прокси в /etc/yum.conf.
    • Добавьте глобальную конфигурацию HTTP-прокси в /etc/environment.

    Установите утилиту 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.54.00.sh в папку /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Установите утилиту apigee-service Edge и зависимости: 
      sudo bash /tmp/bootstrap_4.54.00.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.

    8. Необязательно. Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен этот репозиторий, сначала выполните следующие команды:
      1. Выполните команду bootstrap_4.54.00.sh из локального репозитория, чтобы установить утилиту apigee-service: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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.54.00.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. Используйте apigee-service, чтобы установить утилиту apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. Используйте 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. Убедитесь, что на новом узле локально включено хранилище EPEL.
    5. На новом узле проверьте версию libdb4, как описано выше.
    6. На удаленном узле установите утилиту Edge apigee-service и зависимости: 
      sudo bash /tmp/bootstrap_4.54.00.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.54.00.sh и выполните синхронизацию.

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

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