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

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

To install Edge on a node, you first install the Edge apigee-setup utility. Если у ваших узлов нет внешнего подключения к интернету, вам также необходимо установить локальную копию репозитория Apigee.

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

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

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

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

Чтобы временно перевести SELinux в разрешающий режим, выполните следующую команду:
- На устройстве с ОС Linux 8.x:
```
sudo setenforce 0
```
  Чтобы снова включить SELinux после установки Edge:
```
sudo setenforce 1
```
- В операционной системе Linux 7.x:
```
sudo setenforce 0
```
  Чтобы снова включить SELinux после установки Edge:
```
sudo setenforce 1
```
- В операционной системе Linux 6.x:
```
sudo echo 0 > /selinux/enforce
```
  Чтобы снова включить SELinux после установки Edge:
```
sudo echo 1 > /selinux/enforce
```
Чтобы навсегда отключить SELinux или перевести его в разрешающий режим:
1. Откройте файл /etc/sysconfig/selinux в редакторе.
2. Установите SELINUX=disabled или SELINUX=permissive
3. Сохраните изменения.
4. Перезапустите узел.
5. При необходимости повторно включите SELinux после установки Edge, повторив эту процедуру, чтобы установить SELINUX=enabled.

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

Чтобы установить или обновить Edge или создать локальное хранилище, необходимо включить Extra Packages for 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, перед установкой выполните следующие действия:

Включите EPEL (Extra Packages for Enterprise Linux):

sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

Отключите Postgres и NGINX:

sudo dnf module disable postgresql
sudo dnf module disable nginx

Установите Python 2 и создайте символическую ссылку:
```
sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python
```

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

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

Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть username:password для FTP-сайта Apigee, вы можете использовать эти учетные данные.
Войдите в узел как пользователь root, чтобы установить RPM-пакеты Edge.

NOTE Для установки RPM-пакетов требуется доступ с правами root, но настроить Edge можно и без него.

Установите yum-utils и yum-plugin-priorities:

sudo yum install yum-utils
sudo yum install yum-plugin-priorities

Отключение SELinux.
Включите репозиторий EPEL.
Проверьте версию libdb4.
Если вы устанавливаете приложение на RHEL 8, выполните действия, описанные в разделе Требования для RHEL 8.
Если вы устанавливаете на Oracle 7.x, выполните следующую команду:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Если вы устанавливаете на 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

Скачайте файл Edge bootstrap_4.51.00.sh в папку /tmp/bootstrap_4.51.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
Установите утилиту apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.51.00.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*'
```
Используйте apigee-service, чтобы установить утилиту apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
Используйте 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 Edge. Как описано в статье Как создать локальный репозиторий Apigee.
Репозиторий Yum (для утилит, таких как yum-utils и yum-plugin-priorities). Его настройку можно поручить операционной команде.
Extra Packages for Enterprise Linux (EPEL). Настроить этот репозиторий может ваша команда по эксплуатации.

Создание локального хранилища Apigee

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

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

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

Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
Войдите в узел как root, чтобы установить Edge RPM.

NOTE Для установки RPM требуется доступ с правами root, но вы можете настроить Edge без него.
Отключите SELinux, как описано выше.
Скачайте файл Edge bootstrap_4.51.00.sh в папку /tmp/bootstrap_4.51.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
Установите утилиту apigee-service для Edge и ее зависимости:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
Установите утилиту apigee-mirror на узел:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
```
Примечание. Если вы обновляете существующий репозиторий до версии 4.51.00, вам нужно обновить только apigee-mirror:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
```
Используйте утилиту apigee-mirror, чтобы синхронизировать репозиторий Apigee с каталогом /opt/apigee/data/apigee-mirror/repos/.
Чтобы уменьшить размер репозитория, добавьте --only-new-rpms, чтобы скачать только последние RPM. Для скачивания требуется около 1,6 ГБ свободного места на диске.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
```
Если вы хотите скачать весь репозиторий, включая старые RPM, опустите --only-new-rpms. Для скачивания всех файлов потребуется около 6 ГБ свободного места на диске.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
```
Теперь у вас есть локальная копия репозитория Apigee. В следующем разделе описывается, как установить утилиту Edge apigee-setup из локального репозитория.
(Необязательно.) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен локальный репозиторий, сначала выполните следующие команды:
1. Выполните команду bootstrap_4.51.00.sh из локального репозитория, чтобы установить утилиту apigee-service:
```
sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.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-файла:

На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
Скопируйте TAR-файл на узел, где вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
На новом узле отключите SELinux, как описано выше.
Убедитесь, что на новом узле у вас есть доступ к локальному хранилищу утилиты Yum и хранилищу EPEL.
Убедитесь, что все внешние интернет-репозитории отключены (так и должно быть, поскольку вы устанавливаете ПО на компьютер без доступа к интернету):
```
sudo yum repolist
```
Все внешние репозитории должны быть отключены, а локальный репозиторий Apigee и ваши внутренние репозитории должны быть включены.
На новом узле установите yum-utils и yum-plugin-priorities из локального хранилища:
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Чтобы вы могли установить инструменты Yum, ваша команда по операциям или другая группа в вашей организации должна настроить для вас локальный репозиторий.
На новом узле проверьте версию libdb4, как описано выше.
Если вы устанавливаете Oracle 7.x,выполните следующую команду:
```
sudo yum-config-manager --enable ol7_optional_latest
```
Если вы устанавливаете на AWS, выполните следующую команду yum-configure-manager:
```
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
```
На новом узле распакуйте файл в каталог /tmp:
```
tar -xzf apigee-4.51.00.tar.gz
```
Эта команда создает новый каталог с названием repos в каталоге, содержащем файл TAR. Пример: /tmp/repos..
Установите утилиту apigee-service для Edge и зависимости из /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
Обратите внимание, что в этой команде вы указываете путь к каталогу repos.
Используйте apigee-service, чтобы установить утилиту apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
Используйте apigee-setup, чтобы установить и настроить компоненты Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

Установка из репозитория с помощью веб-сервера NGINX

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

Установите веб-сервер NGINX на узле репозитория:
```
opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
```
По умолчанию 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
```
По умолчанию для репозитория требуется имя пользователя и пароль admin:admin. Чтобы изменить эти учетные данные, задайте следующие переменные среды:
```
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
```
На новом узле установите yum-utils и yum-plugin-priorities:
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
На новом узле отключите SELinux, как описано выше.
Убедитесь, что на новом узле включено локальное хранилище EPEL.
На новом узле проверьте версию libdb4, как описано выше.
На удаленном узле скачайте файл bootstrap_4.51.00.sh для Edge в каталог /tmp/bootstrap_4.51.00.sh:
```
curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
где uName:pWord – имя пользователя и пароль, заданные выше для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.
На удаленном узле установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
где uName:pWord – имя пользователя и пароль для доступа к репозиторию.
На удаленном узле используйте apigee-service, чтобы установить утилиту apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
Используйте apigee-setup, чтобы установить и настроить компоненты Edge на удаленном узле. Подробнее о том, как установить компоненты Edge на узел…

Как обновить локальное хранилище Apigee

Чтобы обновить репозиторий, скачайте последнюю версию файла bootstrap_4.51.00.sh и выполните синхронизацию.

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

Скачайте файл начальной загрузки Edge bootstrap_4.51.00.sh в каталог /tmp/bootstrap_4.51.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
Запустите файл Edge bootstrap_4.51.00.sh:
```
sudo bash/tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.

Обновите apigee-mirror:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

Выполните синхронизацию:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
```
Примечание. Команда apigee-service apigee-mirror sync --only-new-rpms не работает в Oracle Linux 8.X.
Если вы хотите клонировать весь репозиторий:
```
/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.51.00

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

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

Убедитесь, что у вас установлена утилита apigee-mirror версии 4.51.00.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
```
Вы должны увидеть результат в форме ниже, где xyz – это номер сборки:
```
apigee-mirror-4.51.00-0.0.xyz
```
Используйте утилиту 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, указав нужные номера версий.
Проверьте структуру файлов в каталоге /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.
Чтобы упаковать репозиторий в файл 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" выше.