Установите утилиту Edge Apigee-Setup.

Чтобы установить Edge на узел, сначала установите утилиту Edge apigee-setup. Если ваши узлы находятся в среде, где нет внешнего подключения к Интернету, необходимо также установить локальную копию репозитория 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. При необходимости повторно включите SELinux после установки Edge, повторив эту процедуру для установки 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. Включить дополнительные пакеты для 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. Включить дополнительные пакеты для 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. Установите утилиту Edge apigee-service и зависимости:
        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
        • В: Выйти. Для этого вам придётся установить 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, чтобы установить 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. Установите утилиту Edge apigee-service и зависимости: 
        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-service для установки утилиты apigee-setup : 
          /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
        3. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Подробнее см. в разделе Установка компонентов Edge на узле .

      Установите apigee-setup на удаленном узле из локального репозитория.

      Установить Edge из локального репозитория можно двумя способами:

      • Создайте файл .tar репозитория, скопируйте файл .tar на узел, а затем установите Edge из файла .tar.
      • Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. 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-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.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