Instala la utilidad de Apigee de Setup de Edge

Edge para la nube privada v. 4.16.09

Para instalar Edge en un nodo, primero debes instalar la utilidad apigee-setup de Edge. Si te encuentras en un entorno en el que los nodos no tienen una conexión externa a Internet, también debes instalar una copia local del repositorio de Apigee.

Crea un symlink desde /opt/apigee

Edge instala todos los archivos en el directorio /opt/apigee. No puedes cambiar este directorio. Sin embargo, si lo deseas, puedes crear un symlink para asignar /opt/apigee a otra ubicación.

Antes de crear el symlink, primero debes crear un usuario y un grupo llamados “apigee”. Este es el mismo grupo y usuario que creó el instalador de Edge.

Para crear el symlink, realiza estos pasos antes de descargar el archivo Boot_4.16.09.sh. Debes realizar todos estos pasos como raíz:

  1. Crea el usuario y grupo de “Apigee”:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c “Apigee platform user” apigee
  2. Crea un symlink desde /opt/apigee a la raíz de instalación deseada:
    > ln -Ts /srv/myInstallDir /opt/apigee
    donde /srv/myInstallDir es la ubicación deseada de los archivos de Edge.
  3. Cambiar la propiedad de la raíz de instalación y el symlink al usuario de “apigee”:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Requisito previo: Inhabilita SELinux

Debes inhabilitar SELinux o configurarlo en modo permisivo antes de instalar la utilidad apigee-setup de Edge o cualquier componente de Edge. Si es necesario, después de instalar Edge, puedes volver a habilitar SELinux.

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

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

      Para volver a habilitar SELinux después de instalar Edge, sigue estos pasos:
      setenforce 1
  • Para inhabilitar SELinux de forma permanente o configurarlo en el modo permisivo, sigue estos pasos:
    1. Abre /etc/sysconfig/selinux en un editor.
    2. Configura SELINUX=inhabilitado 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 mediante la repetición de este procedimiento para configurar SELINUX=enabled.

Instala la utilidad apigee-setup de Edge en un nodo con una conexión a Internet externa.

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

  1. Obtenga el nombre de usuario y la contraseña de Apigee que usa para acceder al repositorio de Apigee. Si tienes un nombre de usuario y contraseña existente para el sitio de FTP de Apigee, puedes usar esas 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 la configuración de Edge sin acceso a la raíz.
  3. Inhabilita SELinux como se describió anteriormente.
  4. Descarga el archivo Edge bootstrap_4.16.09.sh a bootstrap_4.16.09.sh:
    bootstrap_4.16.09.sh
  5. Instala las dependencias y la utilidad apigee-service de Edge:
    > sudo bash /tmp/boot_4.16.09.sh apigeeuser=uName apigeepassword=pWord

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

    De forma predeterminada, el instalador verifica si tienes Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX acepta los siguientes valores:

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

    Con la instalación de la utilidad apigee-service, se 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:
    > cat /etc/yum.repos.d/apigee.repo

    Para ver el contenido del repositorio, usa el comando:
    > sudo yum -v repolist 'apigee*'
  6. Usa apigee-service para instalar la utilidad apigee-setup:
    >/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. 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 la utilidad apigee-setup de Edge en un nodo sin conexión a Internet externa.

Si los nodos perimetrales están detrás de un firewall o se les prohíbe de alguna otra manera acceder al repositorio de Apigee en Internet, debes crear un repositorio local, o una duplicación, del repositorio de Apigee. Entonces, todos los nodos deben poder acceder a la duplicación. Una vez creados, los nodos pueden acceder a esa duplicación local para instalar Edge.

Nota: Apigee no aloja todas las dependencias de terceros en nuestros repositorios públicos. Debes descargar e instalar estas dependencias desde repositorios de acceso público.

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

Crea un repositorio local de Apigee

Sigue estos pasos para crear un repositorio de Apigee local:

  1. Obtenga el nombre de usuario y la contraseña de Apigee que usa para acceder al repositorio de Apigee. Si tienes un nombre de usuario y contraseña existente para el sitio de FTP de Apigee, puedes usar esas 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 la configuración de Edge sin acceso con permisos de administrador.
  3. Asegúrate de tener la versión más reciente de yum-utils:
    > sudo yum update yum-utils
  4. Inhabilita SELinux como se describió anteriormente.
  5. Descarga el archivo Edge bootstrap_4.16.09.sh a bootstrap_4.16.09.sh:
    bootstrap_4.16.09.sh
  6. Instala la utilidad apigee-service y las dependencias de Edge:
    > sudo bash /tmp/boot_4.16.09.sh apigeeuser=uName apigeepassword=pWord

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

    Nota: Si actualizas un repositorio existente a la versión 4.16.09, solo debes actualizar apigee-mirror:
    > /opt/apigee-apigee-service/bin/apigee-service
  8. Usa la utilidad apigee-mirror para sincronizar el repositorio de Apigee con el directorio /opt/apigee/data/apigee-mirror/repos/.

    Para minimizar el tamaño del repositorio, incluye --only-new-rpms para descargar solo los últimos 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 deseas descargar todo el repositorio, 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 la utilidad apigee-setup de Edge desde el repositorio local.
  9. (Opcional) Si deseas instalar Edge desde el repositorio local en el mismo nodo que aloja el repositorio local, primero debes ejecutar los siguientes comandos:
    1. Ejecuta bootstrap_4.16.09.sh desde el repositorio local para instalar la utilidad bootstrap_4.16.09.sh:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/boot_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Usa apigee-service para instalar la utilidad apigee-setup:
      > /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, copia el archivo .tar en un nodo y, luego, instala Edge desde el archivo .tar.
  • Instala un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él. Apigee proporciona el servidor web Nginx para que lo uses, o bien puedes usar el tuyo propio.

Realiza la instalación desde el archivo .tar:

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

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Copia el archivo .tar en el nodo en el que deseas instalar Edge. Por ejemplo, cópialo en el directorio /tmp del nodo nuevo.
  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.16.09.tar.gz

    Con este comando, se crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.
  5. Instala la utilidad apigee-service de Edge y las dependencias de /tmp/repos:
    > sudo bash /tmp/repos/boot_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Observa que incluyes la ruta de acceso al directorio de repositorios en este comando.
  6. Usa apigee-service para instalar la utilidad apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. 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.

Realiza la instalación desde el repositorio con el servidor web Nginx:

  1. Instala el servidor web Nginx en el nodo de repositorio:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. De forma predeterminada, Nginx está configurado para utilizar 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 Edge Boot_4.16.09.sh a /tmp/bootstrap_4.16.09.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/remoteRepo_4.16.09.sh -repositorio del gcloud.16.09.sh

  6. En el nodo remoto, instala la utilidad y las dependencias de apigee-service de Edge:
    > sudo bash /tmp/Boot_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocolName=http://

    en el que uremoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocolName=http://

    en el que uremoteRepo.
  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 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.16.09.sh más reciente y, luego, realizar una nueva sincronización:

  1. Descarga el archivo Boot_4.16.09.sh de Edge a /tmp/bootstrap_4.16.09.sh:
    /tmp/bootstrap_4.16.09.sh
  2. Ejecuta el archivo de Edge bootstrap_4.16.09.sh:
    > sudo bash /tmp/Boot_4.16.09.sh apigeeuser=uName apigeepassword=uName

    En el ejemplo anterior, uName son el nombre de usuario y la contraseña que recibió de Apigee. Si omites pWord, se te solicitará que lo ingreses.
  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 deseas descargar el repositorio completo, haz lo siguiente:
    >/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Limpia un repositorio local de Apigee

Limpiar el repositorio local borra /opt/apigee/data/apigee-mirror y /var/tmp/yum-apigee-*.

Para limpiar el repositorio local, usa el siguiente comando:

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

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

Si tienes que conservar las instalaciones de Edge 4.16.01 y 4.16.05 en un repositorio 4.16.09, puedes mantener un repositorio que contenga todas las versiones. Desde ese repositorio, puedes instalar cualquier versión de Edge.

Para agregar 4.16.01/4.16.05 a un repositorio 4.16.09, haz lo siguiente:

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


    Deberías ver un resultado en el siguiente formulario, en el que xyz es el número de compilación:
    apigee-mirror-4.16.09-0.0.
  2. Usa la utilidad apigee-mirror para descargar Edge 4.16.01 o 4.16.05 en tu repositorio. Observa cómo debes agregar el prefijo al comando apigeereleasever=4.16.01 o apigeereleasever=4.16.05:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms.

    Usa este mismo comando para actualizar el repositorio.
  3. Examina el directorio /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

    El directorio apigee también contiene directorios separados 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 los repositorios 4.16.09 y 4.16.01 en el mismo archivo .tar. No puedes empaquetar solo una parte del repositorio.

Para instalar Edge desde el repositorio local o el archivo .tar, asegúrate de ejecutar el archivo de arranque correcto con uno de los siguientes comandos:

  • Si realizas la instalación desde un archivo .tar, ejecuta el archivo de arranque correcto desde el repositorio:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Para completar la instalación, sigue los pasos restantes de “Instala desde el archivo .tar” de arriba.
  • Si instalas el



    bootstrap_4.16.0X.sh