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

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

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

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

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

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

  • Чтобы навсегда отключить 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/CentOS/Oracle 8.x: 
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo -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» и «Изменения перед установкой OpenLDAP 2.4» соответственно.

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

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

      1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть username:password для ftp-сайта Apigee, вы можете использовать эти учетные данные.
      2. Войдите на свой узел как root, чтобы установить Edge RPM.
      3. Отключите SELinux .
      4. Включите репозиторий EPEL .
      5. Если вы выполняете установку на RHEL 9/Rocky 9/Oracle 9, выполните действия, описанные в разделе «Предварительные требования для RHEL 9/Rocky 9/Oracle 9» .
      6. Загрузите файл Edge bootstrap_4.53.00.sh в /tmp/bootstrap_4.53.00.sh : 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. Установите утилиту Edge apigee-service и зависимости: 
        sudo bash /tmp/bootstrap_4.53.00.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 на узле без внешнего подключения к Интернету.

      Если ваши пограничные узлы находятся за брандмауэром или каким-либо другим образом им запрещен доступ в Интернет, вам необходимо создать несколько репозиториев или зеркал, содержащих файлы, которые вам понадобятся во время установки. Эти зеркала должны быть доступны всем узлам. После создания узлы могут получить доступ к этим локальным зеркалам для установки 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.53.00.sh в /tmp/bootstrap_4.53.00.sh : 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. Установите утилиту Edge apigee-service и зависимости:
        sudo bash /tmp/bootstrap_4.53.00.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.00.sh из локального репозитория, чтобы установить утилиту apigee-service : 
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.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, скопируйте файл .tar на узел, а затем установите Edge из файла .tar.
      • Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет вам веб-сервер Nginx, или вы можете использовать свой собственный веб-сервер.

      Установить из файла .tar

      Для установки из файла .tar:

      1. На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.53.00.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.00.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.00.sh, а затем выполнить новую синхронизацию.

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

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