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

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

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

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

Предварительное условие: отключить SELinux.

Вы должны отключить SELinux или перевести его в разрешительный режим, прежде чем сможете установить утилиту apigee-setup или любые компоненты Edge. При необходимости после установки 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.

Вам необходимо включить дополнительные пакеты для Enterprise Linux (или EPEL), чтобы установить или обновить Edge или создать локальный репозиторий. Используемая вами команда зависит от вашей версии 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
  • Для АВС-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

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

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

  1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть username:password для ftp-сайта Apigee, вы можете использовать эти учетные данные.
  2. Войдите на свой узел как root, чтобы установить Edge RPM.
  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 на узле без внешнего подключения к Интернету.

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

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

Создайте локальный репозиторий Apigee.

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

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

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

  1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть имя пользователя и пароль для ftp-сайта Apigee, вы можете использовать эти учетные данные.
  2. Войдите на свой узел как root, чтобы установить Edge RPM.
  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. Убедитесь, что вы установили версию утилиты apigee-mirror версии 4.52.02: 
    /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

    Обратите внимание, что у вас есть файл начальной загрузки для всех версий 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, просто обязательно запустите правильный файл начальной загрузки, используя одну из следующих команд. В этом примере устанавливается Edge 4.17.01:

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

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

  • При установке с использованием веб-сервера Nginx загрузите и затем запустите правильный загрузочный файл из репозитория: 
    /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» выше.