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

Edge для частного облака v4.18.01

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

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

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

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

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

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

      Чтобы повторно включить SELinux после установки Edge:
      sudo echo 1 > /selinux/enforce
    2. В операционной системе Linux 7.x :
      судо setenforce 0

      Чтобы повторно включить SELinux после установки Edge:
      судо setenforce 1
  • Чтобы навсегда отключить SELinux или перевести его в разрешительный режим:
    1. Откройте /etc/sysconfig/selinux в редакторе.
    2. Установите SELINUX=отключено или SELINUX=разрешительно.
    3. Сохраните изменения.
    4. Перезапустите узел.
    5. При необходимости повторно включите SELinux после установки Edge, повторив эту процедуру, чтобы установить SELINUX=enabled .

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

Вам необходимо включить дополнительные пакеты для Enterprise Linux (или EPEL), чтобы установить или обновить Edge или создать локальный репозиторий. Используемая вами команда зависит от вашей версии RedHat/CentOS:

  • Для RedHat/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
  • Для RedHat/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

Предварительное условие: проверьте версию библиотеки 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, удалите ее.

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

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

  1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть имя пользователя и пароль для ftp-сайта Apigee, вы можете использовать эти учетные данные.
  2. Войдите на свой узел как root, чтобы установить Edge RPM.
    Примечание . Хотя для установки RPM требуется root-доступ, вы можете выполнить настройку Edge без root-доступа.
  3. Установите yum-utils и yum-plugin-priorities :
    > sudo yum установить yum-utils
    > sudo yum install yum-plugin-priorities
  4. Отключите SELinux, как описано выше.
  5. Включите репозиторий EPEL, как описано выше.
  6. Проверьте свою версию libdb4 , как описано выше.
  7. Если вы устанавливаете Oracle 7.x, выполните следующую команду:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. Если вы выполняете установку на AWS , выполните следующие команды yum-configure-manager :
    > ням обновить rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Загрузите файл Edge bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh :
    > завиток https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.18.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. Чтобы просмотреть файл определений, используйте команду:
    > кот /etc/yum.repos.d/apigee.repo

    Чтобы просмотреть содержимое репо, используйте команду:
    > sudo yum -v repolist 'apigee*'
  11. Используйте apigee-service для установки утилиты apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
  12. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Дополнительные сведения см. в разделе Установка компонентов Edge на узле .

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

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

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

Примечание . Apigee не размещает все сторонние зависимости в наших общедоступных репозиториях. Вы должны загрузить и установить эти зависимости из общедоступных репозиториев.

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

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

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

  1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть имя пользователя и пароль для ftp-сайта Apigee, вы можете использовать эти учетные данные.
  2. Войдите на свой узел как root, чтобы установить Edge RPM.
    Примечание . Хотя для установки RPM требуется root-доступ, вы можете выполнить настройку Edge без root-доступа.
  3. Отключите SELinux, как описано выше.
  4. Загрузите файл Edge bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh :
    > завиток https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  5. Установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord

    где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.
  6. Установите на ноду утилиту apigee-mirror :
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-mirror

    Примечание . Если вы обновляете существующий репозиторий до версии 4.18.01, вам нужно обновить только apigee-mirror :
    > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-mirror
  7. Используйте утилиту apigee-mirror для синхронизации репозитория Apigee с каталогом /opt/apigee/data/apigee-mirror/repos/ .

    Чтобы минимизировать размер репозитория, включите --only-new-rpm, чтобы загружать только самые последние RPM. Для загрузки вам потребуется примерно 1,6 ГБ дискового пространства:
    > /opt/apigee/apigee-service/bin/apigee-service синхронизация apigee-mirror --only-new-rpms

    Если вы хотите загрузить весь репозиторий, включая старые RPM, опустите --only-new-rpm . Для полной загрузки вам потребуется около 6 ГБ дискового пространства:
    > /opt/apigee/apigee-service/bin/apigee-service синхронизация apigee-mirror

    Теперь у вас есть локальная копия репозитория Apigee. В следующем разделе описывается, как установить утилиту Edge apigee-setup из локального репозитория.
  8. (Необязательно) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещено локальное репо, вам необходимо сначала выполнить следующие команды:
    1. Запустите bootstrap_4.18.01.sh из локального репозитория, чтобы установить утилиту apigee-service :
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Используйте apigee-service для установки утилиты apigee-setup :
      > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
    3. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Дополнительные сведения см. в разделе Установка компонентов Edge на узле .

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

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

  • Создайте файл репозитория .tar, скопируйте файл .tar на узел, а затем установите Edge из файла .tar.
  • Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет вам веб-сервер Nginx, или вы можете использовать свой собственный веб-сервер.

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

  1. На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz :
    > /opt/apigee/apigee-service/bin/apigee-service пакет apigee-mirror
  2. Скопируйте файл .tar на узел, на который вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. На новом узле отключите SELinux, как описано выше.
  4. На новом узле включите репозиторий EPEL, как описано выше.
  5. На новом узле убедитесь, что вы отключили все внешние интернет-репозитории. Когда вы запускаете следующую команду, все внешние репозитории должны отображаться как отключенные, но локальный репозиторий Apigee и любые ваши внутренние репозитории должны быть включены:
    > судо ням переполировать
  6. На новом узле установите yum-utils и yum-plugin-priorities :
    > sudo yum установить yum-utils
    > sudo yum install yum-plugin-priorities
  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.18.01.tar.gz

    Эта команда создает новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/репозитории.
  11. Установите утилиту Edge apigee-service и зависимости из /tmp/repos :
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
  12. Используйте apigee-service для установки утилиты apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
  13. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Дополнительные сведения см. в разделе Установка компонентов Edge на узле .

Установите из репозитория с помощью веб-сервера 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 перезапустить
  3. По умолчанию для репозитория требуется имя пользователя:пароль admin:admin . Чтобы изменить эти учетные данные, установите следующие переменные среды:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. На новом узле установите yum-utils и yum-plugin-priorities :
    > sudo yum установить yum-utils
    > sudo yum install yum-plugin-priorities
  5. На новом узле отключите SELinux, как описано выше.
  6. На новом узле включите репозиторий EPEL, как описано выше.
  7. На новом узле проверьте свою версию libdb4 , как описано выше.
  8. На удаленном узле загрузите файл Edge bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh :
    > /usr/bin/curl http:// uName: pWord @ RemoteRepo :3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

    где uName:pWord — это имя пользователя и пароль, которые вы установили выше для репозитория, а RemoteRepo — это IP-адрес или DNS-имя узла репо.
  9. На удаленном узле установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost= RemoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://

    где u Name :pWord — имя пользователя и пароль репозитория.
  10. На удаленном узле используйте apigee-service для установки утилиты apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
  11. Используйте apigee-setup для установки и настройки компонентов Edge на удаленном узле. Дополнительные сведения см. в разделе Установка компонентов Edge на узле .

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

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

  1. Загрузите файл Edge bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh :
    > завиток https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Запустите файл Edge bootstrap_4.18.01.sh :
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord

    где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.
  3. Обновите apigee-mirror :
    > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-mirror
  4. Выполните синхронизацию:
    > /opt/apigee/apigee-service/bin/apigee-service синхронизация apigee-mirror --only-new-rpms
  5. Если вы хотите получить весь репо:
    > /opt/apigee/apigee-service/bin/apigee-service синхронизация apigee-mirror

Очистите локальный репозиторий 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.18.01.

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

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

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

    Вы должны увидеть результат в форме ниже, где xyz — номер сборки:
    апигее-зеркало- 4.18.01-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 --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 третья сторона

    Обратите внимание, что у вас есть файл начальной загрузки для всех версий Edge. Каталог apigee также содержит отдельные каталоги для каждой версии Edge.
  4. Чтобы упаковать репозиторий в файл .tar, используйте следующую команду:
    > apigeereleeasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service пакет apigee-mirror

    Эта команда упаковывает все репозитории 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» выше.