Как установить утилиту 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 или создать локальный репозиторий, необходимо включить дополнительные пакеты для Enterprise Linux (EPEL). Команда зависит от версии RedHat/CentOS:

    • Для Red Hat/CentOS/Oracle 8.x: 
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • Для Red Hat/CentOS/Oracle 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 8, Rocky 8 и Oracle 8

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

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

      Требования для 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.7.

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

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

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

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

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

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

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

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

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

      8. Необязательно. Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен этот репозиторий, сначала выполните следующие команды:
        1. Выполните команду bootstrap_4.53.01.sh из локального репозитория, чтобы установить утилиту apigee-service: 
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
        2. Чтобы установить утилиту apigee-setup, используйте apigee-service: 
          /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.53.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. Чтобы установить утилиту apigee-setup, используйте apigee-service: 
        /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.53.01.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.53.01.sh и выполните новую синхронизацию.

      Чтобы обновить репозиторий:

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