Instala la utilidad de Apigee de Setup de Edge

Edge for Private Cloud v. 4.17.05

Para instalar Edge en un nodo, primero debes instalar la utilidad de configuración de Apigee de Edge. Si estás en un en el que tus nodos no tengan una conexión externa a Internet, también debes instalar copia local del repositorio de Apigee.

Directorio de instalación predeterminado: /opt/apigee

Edge instala todos los archivos en el directorio /opt/apigee. No puedes cambiar esto . Sin embargo, si lo deseas, puedes crear un symlink para asignar /opt/apigee a otra ubicación. Consulta Requisitos de instalación para obtener más información.

Requisito previo: Inhabilita SELinux

Debes inhabilitar SELinux o establecerlo en el modo permisivo para poder instalar Edge apigee-setup o cualquier instancia o los componentes de la solución. Si es necesario, luego de instalar Edge, puedes volver a habilitar SELinux.

  • Para configurar SELinux de forma temporal en el modo permisivo, ejecuta el siguiente comando: :
    1. En un sistema operativo Linux 6.x:
      sudo echo 0 > /selinux/enforce

      Para volver a habilitar SELinux después de instalar Edge, haz lo siguiente:
      sudo echo 1 > /selinux/enforce
    2. En un sistema operativo Linux 7.x:
      sudo setenforce 0

      Para volver a habilitar SELinux después de instalar Edge, haz lo siguiente:
      sudo setenforce 1
  • Para inhabilitar SELinux de forma permanente o configurarlo en modo permisivo, haz lo siguiente:
    1. Abre /etc/sysconfig/selinux en una Editor.
    2. Establece SELINUX=disabled o SELINUX=permissive
    3. Guarda los cambios.
    4. Reinicia el nodo.
    5. Si es necesario, vuelve a habilitar SELinux después de la instalación de Edge. Para ello, repite este procedimiento para configura SELINUX=enabled.

Requisito previo: Habilitar el repositorio EPEL

Debes habilitar los Paquetes adicionales para Enterprise Linux (o EPEL) para instalar o actualizar Edge. El comando que uses dependerá en tu versión de Red Hat/CentOS:

  • Para Red Hat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • Para Red Hat/CentOS 6.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Instalar Edge Utilidad apigee-setup en un nodo con conexión a Internet externa

Para instalar Edge en un nodo con una conexión externa a Internet, sigue estos pasos:

  1. Obtén el nombre de usuario y la contraseña de Apigee que usas para acceder al repositorio de Apigee. Si ya tienes un nombre de usuario y contraseña en el sitio de FTP de Apigee, puedes usarlo credenciales.
  2. Accede a tu nodo como raíz para instalar los RPM de Edge
    Nota: Si bien la instalación de RPM requiere acceso con permisos de administrador, puedes realizar una implementación de Edge sin acceso con permisos de administrador.
  3. Inhabilita SELinux como se describió anteriormente.
  4. Habilita el repositorio EPEL como se describió anteriormente.
  5. Descarga el archivo bootstrap_4.17.05.sh de Edge a /tmp/bootstrap_4.17.05.sh:
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  6. Instala la utilidad y las dependencias del servicio de Apigee de Edge:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    en el que uName:pWord son el nombre de usuario y la contraseña de los que recibiste Apigee Si omites pWord, se te pedirá que lo ingreses.

    De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo manejar el archivo. Instalación de Java. JAVA_FIX tiene los siguientes valores:

    I = Instala OpenJDK 1.8 (predeterminado)
    C = Continuar sin instalar Java
    Q = Salir. Para esta opción, debes instalar Java por tu cuenta.

    La instalación de la utilidad apigee-service crea el archivo /etc/yum.repos.d/apigee.repo que define el repositorio de Apigee. Para ver el archivo de definición, usa el siguiente comando:
    > gato /etc/yum.repos.d/apigee.repo

    Para ver el contenido del repositorio, usa el siguiente comando:
    > sudo yum -v repolist “Apigee*”
  7. (Solo CentOS-6.x y Red Hat-6.x) En todos los nodos Qpid, ejecuta el siguiente comando: para asegurarte de que descargues la versión correcta de Qpid:
    > yum install apigee-qpidd --disablerepo=epel
  8. Usa apigee-service para instalar la utilidad de configuración de Apigee:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. Usa apigee-setup para instalar y configurar componentes de Edge en el nodo. Consulta Instala componentes de Edge en un nodo para obtener más información.

Instalar Edge Utilidad apigee-setup en un nodo sin conexión a Internet externa

Si tus nodos perimetrales están detrás de un firewall o, de alguna otra manera, tienen prohibido acceder el repositorio de Apigee a través de Internet, debes crear un repositorio local, del repositorio de Apigee. Esa duplicación debe ser accesible para todos los nodos. Una vez creados, los nodos podrá acceder a esa duplicación local para instalar Edge.

Para crear el repositorio interno de Apigee, necesitas un nodo con una conexión de Internet externa para poder descargar los RPM y las dependencias de Edge. Una vez que hayas creado a otro nodo, puede moverlo a otro nodo o hacer que sea accesible para los nodos de Edge instalación.

Después de crear un repositorio local de Edge, es posible que más adelante debas actualizarlo con la versión más reciente Archivos de lanzamiento de Edge. En las siguientes secciones, se describe cómo crear un repositorio local y cómo actualízala.

Crea un repositorio local de Apigee

Para crear un repositorio local de Apigee, haz lo siguiente:

  1. Obtén el nombre de usuario y la contraseña de Apigee que usas para acceder al repositorio de Apigee. Si ya tienes un nombre de usuario y contraseña en el sitio de FTP de Apigee, puedes usarlo credenciales.
  2. Accede a tu nodo de Red Hat o CentOS como raíz para instalar los RPM de Edge.
    Nota: Si bien la instalación de RPM requiere acceso con permisos de administrador, puedes realizar una implementación de Edge sin acceso con permisos de administrador.
  3. Asegúrate de tener la versión más reciente de yum-utils:
    > actualización de sudo yum yum-utils
  4. Inhabilita SELinux como se describió anteriormente.
  5. Habilita el repositorio EPEL como se describió anteriormente.
  6. Descarga el archivo bootstrap_4.17.05.sh de Edge a /tmp/bootstrap_4.17.05.sh:
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  7. (Solo CentOS-6.x y Red Hat-6.x) Ejecuta el siguiente comando para asegurarte de que Si descargas la versión correcta de Qpid:
    > yum install apigee-qpidd --disablerepo=epel
  8. Instala la utilidad y las dependencias del servicio de Apigee de Edge:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    en el que uName:pWord son el nombre de usuario y la contraseña de los que recibiste Apigee Si omites pWord, se te pedirá que lo ingreses.
  9. Instala apigee-mirror en el nodo:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Nota: Si quieres actualizar un repositorio existente a la versión 4.17.05, solo debes actualizar apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  10. Usa apigee-mirror para sincronizar el repositorio de Apigee con /opt/apigee/data/apigee-mirror/repos/ .

    Para minimizar el tamaño del repositorio, incluye --only-new-rpms para descargar solo la última versión. de los ingresos por cada mil impresiones (RPM). Necesitas aproximadamente 1.6 GB de espacio en disco para la descarga:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Si quieres descargar todo el repo, incluidos los RPM más antiguos, omite --only-new-rpms. Necesitas aproximadamente 6 GB de espacio en disco para la descarga completa:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Ahora tienes una copia local del repositorio de Apigee. En la siguiente sección, se describe cómo instalar el apigee-setup de Edge desde en el repo local.
  11. (Opcional) Si quieres instalar Edge desde el repositorio local en el mismo que aloja el repositorio local, primero debes ejecutar los siguientes comandos:
    1. Ejecuta bootstrap_4.17.05.sh desde la ubicación local el repositorio para instalar la utilidad apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Usa apigee-service para instala apigee-setup utilidad:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Usa apigee-setup para instalar y configurar componentes de Edge en el nodo Consulta Instala componentes de Edge en un nodo para obtener más información.

Instala apigee-setup en un nodo remoto desde el repositorio local.

Tienes dos opciones para instalar Edge desde el repositorio local. Tienes varias opciones:

  • Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, instala Edge desde el archivo .tar.
  • Instalar un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él Apigee te proporciona el servidor web Nginx, o puedes usar tu propio servidor web web.

Instala desde el archivo .tar:

  1. En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local en un Un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:

    > Paquete /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
  2. Copia el archivo .tar en el nodo en el que quieres instalar Edge. Por ejemplo, cópialos en la /tmp en el directorio nuevo el nodo de inicio de sesión.
  3. En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
  4. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
    > tar -xzf apigee-4.17.05.tar.gz

    Este comando crea un directorio nuevo, con el nombre repos, en el directorio que contiene el archivo .tar. Por ejemplo: /tmp/repos.
  5. Instala la utilidad y las dependencias de Edge apigee-service desde /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Ten en cuenta que incluyes la ruta de acceso al directorio de repositorios en este comando.
  6. Usa apigee-service para instala apigee-setup utilidad:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Usa apigee-setup para instalar y configurar los componentes de Edge en el nodo. Consulta Instala componentes de Edge en un nodo para obtener más información.

Instala desde el repositorio con el servidor web Nginx:

  1. Instala el servidor web Nginx en el nodo del repositorio:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. De forma predeterminada, Nginx está configurado para usar localhost como el nombre del servidor y el puerto 3939. Para cambiar estos valores
    1. Abre /opt/apigee/customer/application/mirror.properties. en un editor. Crea el archivo si no existe.
    2. Configura los siguientes valores según sea necesario:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Reinicia Nginx:
      > /opt/nginx/scripts/apigee-nginx restart
  3. De forma predeterminada, el repositorio requiere un nombre de usuario:contraseña de admin:admin. Para cambiar estas credenciales, Configura las siguientes variables de entorno:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
  5. En el nodo remoto, descarga el archivo bootstrap_4.17.05.sh de Edge a /tmp/bootstrap_4.17.05.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

    donde uName:pWord son el nombre de usuario y la contraseña que configuraste anteriormente para el repo, y remoteRepo es la dirección IP o el nombre de DNS del repositorio el nodo de inicio de sesión.
  6. En el nodo remoto, instala la utilidad y las dependencias del servicio de Apigee de Edge:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    donde uName:pWord son el nombre de usuario del repositorio y contraseña.
  7. En el nodo remoto, usa apigee-service para instalar la utilidad apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Usa apigee-setup para instalar y configurar los componentes de Edge en el nodo remoto. Consulta Instala componentes de Edge en un nodo para obtener más información.

Actualiza un repositorio local de Apigee

Para actualizar el repositorio, debes descargar el archivo bootstrap_4.17.05.sh más reciente y, luego, realizar un nuevo sincronización:

  1. Descarga el archivo bootstrap_4.17.05.sh de Edge a /tmp/bootstrap_4.17.05.sh:
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  2. Ejecuta el archivo bootstrap_4.17.05.sh de Edge:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    donde uName:pWord son el nombre de usuario y la contraseña que recibidos de Apigee. Si omites pWord, se te pedirá que hagas lo siguiente: ingresarlo.
  3. Actualiza apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Realiza la sincronización:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Si quieres descargar el repositorio completo, haz lo siguiente:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Limpia un repositorio local de Apigee

Si limpias el repositorio local, se borrarán /opt/apigee/data/apigee-mirror y /var/tmp/yum-apigee-*.

Para limpiar el repositorio local, usa lo siguiente:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Agrega o actualiza Edge 4.16.01/4.16.05/4.16.09/4.17.01 en un repositorio 4.17.05.

Si debes mantener instalaciones para Edge 4.16.0x o 4.17.01 en un repositorio 4.17.05, puedes mantener un repositorio que contenga todas las versiones. Desde ese repositorio, puedes instalar cualquier versión de Edge.

Para agregar 4.16.0x/4.17.01 a un repositorio 4.17.05:

  1. Asegúrate de haber instalado la versión 4.17.05 de la utilidad apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror versión

    Deberías ver un resultado en el siguiente formulario, donde xyz es la compilación número:
    apigee-mirror-4.17.05-0.0.xyz
  2. Usa apigee-mirror para descargar Edge 4.16.01/4.16.05/4.16.09/4.17.01 a tu repositorio. Observa cómo prefijas el comando con la versión deseada:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Usa el mismo comando para actualizar los repositorios 4.16.05/4.16.09/4.17.01 más adelante especificando el los números de versión requeridos.
  3. Examina los recursos /opt/apigee/data/apigee-mirror/repos para ver la estructura del archivo:
    > ls /opt/apigee/data/apigee-mirror/repos

    Deberías ver los siguientes archivos y directorios:
    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 tercero

    Observa que tienes un archivo de arranque para todas las versiones de Edge. El directorio apigee también contiene elementos directorios para cada versión de Edge.
  4. Para empaquetar el repositorio en un archivo .tar, usa el siguiente comando:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service Paquete apigee-mirror

    Este comando empaqueta todos los repositorios 4.17.0x y 4.16.0x en el mismo archivo .tar. No puedes empaquetar solo una parte del repositorio.

Para instalar Edge desde el repositorio local o el archivo .tar, solo asegúrate de ejecutar el arranque correcto con uno de los siguientes comandos. En este ejemplo, se instala Edge 4.16.01:

  • Si lo instalas desde un archivo .tar, ejecuta el archivo de arranque correcto desde el repositorio:
    > sudo bash /tmp/repos/bootstrap_4.16.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Para completar la instalación, sigue los pasos restantes de "Cómo instalar desde el archivo .tar" arriba.
  • Si realizas la instalación mediante el servidor web Nginx, descarga y, luego, ejecuta el archivo de arranque correcto. del repo:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.01.sh -o /tmp/bootstrap_4.16.01.sh
    > sudo bash /tmp/bootstrap_4.16.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://


    Para completar la instalación, sigue los pasos restantes de "Instala desde el repositorio con Servidor web NGINX" arriba.