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

Edge для частного облака v. 4.16.05

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

Создание символической ссылки из /opt/apigee

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

Прежде чем создавать символическую ссылку, вы должны сначала создать пользователя и группу с именем «apigee». Это та же группа и пользователь, созданные установщиком Edge.

Чтобы создать символическую ссылку, выполните следующие действия перед загрузкой файла bootstrap_4.16.05.sh. Вы должны выполнить все эти шаги как пользователь root:

  1. Создайте пользователя и группу «apigee»:
    > groupadd -r апигее
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c «Пользователь платформы Apigee» apigee
  2. Создайте символическую ссылку из /opt/apigee на желаемый корень установки:
    > ln -Ts /srv/myInstallDir /opt/apigee
    где /srv/myInstallDir — желаемое расположение файлов Edge.
  3. Измените владельца корня установки и символическую ссылку на пользователя «apigee»:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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

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

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

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

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

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

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

  1. Получите имя пользователя и пароль от Apigee, которые вы используете для доступа к репозиторию Apigee. Если у вас есть имя пользователя и пароль для ftp-сайта Apigee, вы можете использовать эти учетные данные.
  2. Войдите на свой узел как root, чтобы установить Edge RPM.
    Примечание . Хотя для установки RPM требуется root-доступ, вы можете выполнить настройку Edge без root-доступа.
  3. Отключите SELinux, как описано выше.
  4. Загрузите файл Edge bootstrap_4.16.05.sh в /tmp/bootstrap_4.16.05.sh :
    > завиток https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  5. Установите утилиту Edge apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.16.05.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*'
  6. Используйте apigee-service для установки утилиты apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
  7. Используйте apigee-setup для установки и настройки компонентов Edge на узле. Дополнительные сведения см. в разделе Установка компонентов Edge на узле .

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

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

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

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

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

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

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

    где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.
  7. Установите на ноду утилиту apigee-mirror :
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-mirror
  8. Используйте утилиту 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 из локального репозитория.
  9. (Необязательно) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещено локальное репо, вам необходимо сначала выполнить следующие команды:
    1. Запустите bootstrap_4.16.05.sh из локального репозитория, чтобы установить утилиту apigee-service :
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.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.16.05.tar.gz :

    > /opt/apigee/apigee-service/bin/apigee-service пакет apigee-mirror
  2. Скопируйте файл .tar на узел, на который вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. На новом узле отключите SELinux, как описано выше.
  4. На новом узле распакуйте файл в каталог /tmp:
    > tar -xzf apigee-4.16.05.tar.gz

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

    Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
  6. Используйте apigee-service для установки утилиты apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
  7. Используйте 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. На новом узле отключите SELinux, как описано выше.
  5. На удаленном узле загрузите файл Edge bootstrap_4.16.05.sh в /tmp/bootstrap_4.16.05.sh :
    > /usr/bin/curl http:// uName:pWord @ RemoteRepo :3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

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

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

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

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

  1. Загрузите файл Edge bootstrap_4.16.05.sh в /tmp/bootstrap_4.16.05.sh :
    > завиток https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  2. Выполните синхронизацию:
    > /opt/apigee/apigee-service/bin/apigee-service синхронизация apigee-mirror --only-new-rpms
  3. Если вы хотите скачать весь репозиторий:
    > /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.01 в репозитории 4.16.05.

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

Чтобы добавить 4.16.01 в репозиторий 4.15.05:

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

    Вы должны увидеть результат в форме ниже, где xyz — номер сборки:
    апигее-зеркало- 4.16.05-0.0. xyz
  2. Используйте утилиту apigee-mirror для загрузки Edge 4.16.01 в свой репозиторий. Обратите внимание, как вы добавляете к команде префикс apigeereleeasever=4.16.01 :
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service синхронизация apigee-mirror --only-new-rpm

    Используйте эту же команду, чтобы позже обновить репозиторий 4.16.01.
  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 третья сторона

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

    Эта команда упаковывает репозитории 4.16.05 и 4.16.01 в один и тот же файл .tar. Вы не можете упаковать только часть репо.

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

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

    Чтобы завершить установку, выполните оставшиеся шаги из раздела «Установка из файла .tar» выше.
  • При установке с использованием веб-сервера Nginx загрузите и затем запустите правильный загрузочный файл из репозитория:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/ bootstrap_4.16.0X.sh -o /tmp/ bootstrap_4.16.0X.sh
    > sudo bash /tmp/ bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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