Instala la utilidad de Apigee de Setup de Edge

Para instalar Edge en un nodo, primero debes instalar la utilidad apigee-setup de Edge. Si te encuentras en un entorno en el que tus nodos no tienen una conexión externa a Internet, también debes instalar una 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 este directorio. Sin embargo, si lo deseas, puedes crear un vínculo simbólico 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 configurarlo en modo permisivo antes de poder instalar la utilidad Edge apigee-setup o cualquier componente de Edge. Si es necesario, después de instalar Edge, puedes volver a habilitar SELinux.

  • Para inhabilitar SELinux de forma permanente o configurarlo en modo permisivo, haz lo siguiente:
    1. Abre /etc/sysconfig/selinux en un 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 establecer SELINUX=enabled.

    • Requisito previo: Habilita el repositorio de EPEL

    Debes habilitar Extra Packages for Enterprise Linux (o EPEL) para instalar o actualizar Edge, o para crear un repositorio local. Para Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x o Oracle Linux 9.x, ejecuta los siguientes comandos:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Requisito previo para RHEL 9/Rocky 9/Oracle 9

    Si instalas Edge en un servidor que ejecuta Red Hat Enterprise Linux (RHEL) 9, Rocky 9 o Oracle 9, completa los siguientes pasos antes de realizar la instalación:

    1. Habilita Extra Packages for Enterprise Linux (EPEL): 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Inhabilita Postgres y Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Para obtener información sobre los cambios previos a la instalación de PostgreSQL y LDAP, consulta Requisitos previos a la instalación de la base de datos de PostgreSQL y Cambios previos a la instalación de SymasLDAP 2.6.10, respectivamente.

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

    Para instalar Edge en un nodo con una conexión externa a Internet, 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 tienes un username:password existente para el sitio FTP de Apigee, puedes usar esas credenciales.
    2. Accede a tu nodo como administrador para instalar los RPM de Edge.
    3. Inhabilita SELinux.
    4. Habilita el repositorio de EPEL.
    5. Si realizas la instalación en RHEL 9/Rocky 9/Oracle 9, sigue los pasos que se indican en Requisitos previos para RHEL 9/Rocky 9/Oracle 9.
    6. Descarga el archivo bootstrap_4.54.00.sh de Edge en /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Instala la utilidad apigee-service de Edge y las dependencias: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

      Apigee Edge para nube privada 4.54.00 requiere compatibilidad con Java doble con Java 17 y Java 21 instalados en el nodo. Debes instalar Java 17 y Java 21 antes de ejecutar la secuencia de comandos de arranque. El instalador solo verifica que estén instaladas ambas versiones de JDK; no instala Java automáticamente.

      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:

      cat /etc/yum.repos.d/apigee.repo

      Para ver el contenido del repositorio, usa el siguiente comando:

      sudo yum -v repolist 'apigee*'
    8. Usa apigee-service para instalar la utilidad apigee-setup:
      /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.

    Solución de problemas

    Cuando intentas realizar la instalación en un nodo con una conexión externa a Internet, es posible que encuentres uno o más de los siguientes errores:

    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

    En la siguiente tabla, se indican algunas posibles soluciones para estos errores:

    Tipo de error Solución posible
    La contraseña contiene caracteres incorrectos No uses caracteres especiales en tu contraseña de Apigee.
    Problemas de conectividad

    Ejecuta el siguiente ncat comando para probar la conectividad de red:

    nc -v software.apigee.com 443

    Deberías recibir un mensaje similar al siguiente:

    Connection to software.apigee.com 443 port [tcp/https] succeeded!

    Si no tienes instalado nc, puedes ejecutar el siguiente telnet comando:

    telnet software.apigee.com 443

    Si los comandos se ejecutan correctamente, puedes usar CTRL+C para anular la conexión abierta.

    Si falla alguno de los comandos, tienes conectividad de red limitada o nula. Consulta con tu administrador de red.
    Credenciales incorrectas

    Asegúrate de que el nombre de usuario y la contraseña sean correctos.

    Por ejemplo, verifica si recibes un error cuando intentas usar el siguiente comando con tu nombre de usuario y contraseña de Apigee:

    curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
    Problemas del proxy Tu configuración local usa un proxy HTTP de salida y no extendiste la misma configuración al yum administrador de paquetes. Verifica las variables de entorno: 
    echo $http_proxy
echo $https_proxy

    Para un proxy HTTP de salida, debes usar una de las siguientes opciones:

    • Agrega una configuración de proxy HTTP en /etc/yum.conf.
    • Agrega la configuración global de proxy HTTP en /etc/environment.

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

    Si tus nodos de Edge están detrás de un firewall o, de alguna otra manera, tienen prohibido el acceso a Internet, debes crear varios repositorios o mirrors que contengan los archivos que necesitarás durante la instalación. Luego, se debe poder acceder a esos mirrors desde todos los nodos. Una vez creados, los nodos pueden acceder a estos mirrors locales para instalar Edge.

    El proceso de instalación de Apigee Edge para nodos sin conexión a Internet requiere acceso a los siguientes repositorios locales:

    Crea un repositorio local de Apigee

    Para crear el repositorio interno de Apigee, necesitas un nodo con acceso externo a Internet para poder descargar los RPM y las dependencias de Edge. Una vez que hayas creado el repositorio interno, podrás moverlo a otro nodo o hacer que ese nodo sea accesible para los nodos de Edge para la instalación.

    Después de crear un repositorio local de Apigee, 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 de Apigee y cómo actualizarlo.

    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 tienes un nombre de usuario:contraseña existente para el sitio FTP de Apigee, puedes usar esas credenciales.
    2. Accede a tu nodo como administrador para instalar los RPM de Edge.
    3. Inhabilita SELinux como se describió anteriormente.
    4. Descarga el archivo bootstrap_4.54.00.sh de Edge en /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Instala la utilidad apigee-service de Edge y las dependencias: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

    6. Instala la utilidad apigee-mirror en el nodo: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
    7. 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 RPM más recientes.

    8. (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.54.00.sh desde el repositorio local para instalar la apigee-service utilidad: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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, cópialo 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 te proporciona el servidor web Nginx para que lo uses, o bien puedes usar tu propio servidor web.

    Instala desde el archivo .tar

    Para instalar desde el archivo .tar, haz lo siguiente:

    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.54.00.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 /tmp directorio del nodo nuevo.
    3. En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
    4. En el nodo nuevo, asegúrate de poder acceder al repositorio local de la utilidad Yum y al repositorio de EPEL repo.
    5. Verifica que todos los repositorios externos de Internet estén inhabilitados (este debería ser el caso porque estás realizando la instalación en una máquina sin acceso a Internet): 
      sudo yum repolist

      Todos los repositorios externos deben estar inhabilitados, pero el repositorio local de Apigee y tus repositorios internos deben estar habilitados.

    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 desde el repositorio con el servidor web Nginx

    Para instalar desde el repositorio con el servidor web Nginx, haz lo siguiente:

    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 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. Establece 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, establece las siguientes variables de entorno: 
      MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
    4. En el nodo nuevo, asegúrate de que el repositorio de EPEL esté habilitado de forma local.
    5. En el nodo nuevo, verifica tu versión de libdb4 como se describió anteriormente.
    6. En el nodo remoto, instala la utilidad apigee-service de Edge y las dependencias: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña del repositorio.

    7. En el nodo remoto, usa apigee-service para instalar la apigee-setup utilidad: 
      /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.54.00.sh más reciente y, luego, realizar una nueva sincronización.

    Para actualizar el repositorio, haz lo siguiente:

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

      En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá 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 todo el repositorio: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Limpia un repositorio local de Apigee

    La limpieza del repositorio local borra /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