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

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

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

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

Необходимое условие: отключить SELinux

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

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

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

      sudo echo 1 > /selinux/enforce
    • В операционной системе Linux 7.x :
      sudo setenforce 0

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

      sudo setenforce 1
  • Чтобы окончательно отключить 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 Enterprise Linux (RHEL) 8.0 см. раздел Предварительные требования для RHEL 8 .

  • Для Red Hat/CentOS/Oracle 7.x: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • Для Red Hat/CentOS/Oracle 6.x: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
sudo rpm -ivh epel-release-latest-6.noarch.rpm
  • Для AWS-2: 
    sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

Необходимое условие: проверка версии библиотеки libdb4 в RedHat 7.4 и CentOS 7.4

В RedHat 7.4 и CentOS 7.4 проверьте версию RPM-пакетов libdb4 перед установкой. Для Edge требуется версия 4.8, а некоторые версии RedHat 7.4 и CentOS 7.4 поставляются с более поздней версией. Если у вас установлена более поздняя версия, удалите её, и установщик Edge установит версию 4.8.

Для проверки вашей версии вы можете использовать следующую команду:

rpm -qa | grep libdb4

Если вы видите, что версия RPM libdb4 более поздняя, чем 4.8, удалите ее.

Предварительные условия для RHEL 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
  3. Установить Python 2: 
    sudo dnf install -y python2

Предварительные условия для Amazon-Linux-2023(AL2023)

Если вы устанавливаете Edge на сервер под управлением Amazon-Linux-2023(AL2023), перед установкой выполните следующие действия: 

USE_CQLUTIL=y

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

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

  1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть существующая пара username:password для FTP-сайта Apigee, вы можете использовать эти данные.
  2. Войдите в свой узел как пользователь root, чтобы установить пакеты RPM Edge.
  3. Установите yum-utils и yum-plugin-priorities .
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Отключить SELinux .
  5. Включить репозиторий EPEL .
  6. Проверьте вашу версию libdb4 .
  7. Если вы выполняете установку на RHEL 8, следуйте инструкциям в разделе Предварительные требования для RHEL 8 .
  8. Если вы устанавливаете Oracle 7.x, выполните следующую команду: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Если вы выполняете установку на AWS, выполните следующие команды yum-configure-manager : 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Загрузите файл Edge bootstrap_4.52.02.sh в /tmp/bootstrap_4.52.02.sh : 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  11. Установите утилиту Edge apigee-service и зависимости:
    sudo bash /tmp/bootstrap_4.52.02.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*'
  12. Используйте apigee-service для установки утилиты apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Подробнее см. в разделе Установка компонентов Edge на узле .

Поиск неисправностей

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

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.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.52.02.sh в /tmp/bootstrap_4.52.02.sh : 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  5. Установите утилиту Edge apigee-service и зависимости: 
    sudo bash /tmp/bootstrap_4.52.02.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.52.02.sh из локального репозитория, чтобы установить утилиту apigee-service : 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.02.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.52.02.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. На новом узле установите yum-utils и yum-plugin-priorities из локального репозитория.
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities

    Ваша операционная группа или другая группа в вашей организации должна настроить локальный репозиторий, чтобы вы могли установить инструменты Yum.

  7. На новом узле проверьте версию libdb4 , как описано выше.
  8. Если вы устанавливаете Oracle 7.x, выполните следующую команду: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Если вы устанавливаете на AWS , выполните следующую команду yum-configure-manager : 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. На новом узле распакуйте файл в каталог /tmp:
    tar -xzf apigee-4.52.02.tar.gz

    Эта команда создаёт новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/repos.

  11. Установите утилиту Edge apigee-service и зависимости из /tmp/repos :
    sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  12. Используйте apigee-service для установки утилиты apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Используйте 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. На новом узле установите yum-utils и yum-plugin-priorities .
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. На новом узле отключите SELinux, как описано выше.
  6. На новом узле убедитесь, что локальный репозиторий EPEL включен.
  7. На новом узле проверьте версию libdb4 , как описано выше.
  8. На удаленном узле загрузите файл Edge bootstrap_4.52.02.sh в /tmp/bootstrap_4.52.02.sh :
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

    Где uName:pWord — имя пользователя и пароль, которые вы установили выше для репозитория, а remoteRepo — IP-адрес или DNS-имя узла репозитория.

  9. На удаленном узле установите утилиту Edge apigee-service и зависимости:
    sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Где uName:pWord — имя пользователя и пароль репозитория.

  10. На удаленном узле используйте apigee-service для установки утилиты apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Используйте apigee-setup для установки и настройки компонентов Edge на удалённом узле. Подробнее см. в разделе Установка компонентов Edge на узле .

Обновите локальный репозиторий Apigee

Чтобы обновить репозиторий, необходимо загрузить последний файл bootstrap_4.52.02.sh, а затем выполнить новую синхронизацию.

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

  1. Загрузите файл Edge bootstrap_4.52.02.sh в /tmp/bootstrap_4.52.02.sh : 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Запустите файл Edge bootstrap_4.52.02.sh :
    sudo bash/tmp/bootstrap_4.52.02.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.0x/4.17.0x в репозитории 4.52.02.

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

Чтобы добавить 4.16.0x/4.17.0x в репозиторий 4.52.02:

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

    Вы должны увидеть результат в форме ниже, где xyz — номер сборки: 

    apigee-mirror-4.52.02-0.0.xyz
  2. Используйте утилиту apigee-mirror для загрузки Edge 4.16.0x/4.17.0x в свой репозиторий. Обратите внимание, что перед командой вы добавляете нужную версию:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Используйте эту же команду для последующего обновления репозиториев 4.16.0x/4.17.0x, указав требуемые номера версий.

  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.17.01.sh
bootstrap_4.17.05.sh
bootstrap_4.17.09.sh
bootstrap_4.18.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.sh
thirdparty

    Обратите внимание, что у вас есть файл bootstrap для всех версий Edge. Каталог apigee также содержит отдельные каталоги для каждой версии Edge.

  4. Чтобы упаковать репозиторий в файл .tar, используйте следующую команду: 
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Эта команда упаковывает все репозитории 4.17.0x и 4.16.0x в один .tar-файл. Вы не можете упаковать только часть репозитория.

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

  • При установке из файла .tar запустите правильный файл bootstrap из репозитория: 
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Для завершения установки выполните оставшиеся шаги из раздела «Установка из .tar-файла» выше.

  • Если установка выполняется с использованием веб-сервера Nginx, загрузите и запустите правильный файл bootstrap из репозитория:
    /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Для завершения установки выполните оставшиеся шаги из раздела «Установка из репозитория с использованием веб-сервера Nginx» выше.