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 conexión externa a Internet, también debes instalar una copia local del repo 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 symlink para asignar /opt/apigee a otra ubicación. Consulta los Requisitos de instalación para obtener más información.

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 establecer temporalmente SELinux en modo permisivo, ejecuta el siguiente comando:
    • En un sistema operativo Linux 6.x, haz lo siguiente: 
      sudo echo 0 > /selinux/enforce

      Para volver a habilitar SELinux después de instalar Edge, haz lo siguiente:

      sudo echo 1 > /selinux/enforce
    • En un sistema operativo Linux 7.x, haz lo siguiente: 
      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 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 repitiendo este procedimiento para establecer SELINUX=enabled.

Requisito previo: Habilita el repo de EPEL

Debes habilitar Extra Packages for Enterprise Linux (o EPEL) para instalar o actualizar Edge, o bien para crear un repo local. El comando que uses dependerá de tu versión de Red Hat o CentOS:

  • Para Red Hat Enterprise Linux (RHEL) 8.0, consulta Prerequisites for RHEL 8.

  • Para Red Hat/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
  • Para Red Hat/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
  • Para AWS-2: 
    sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

Requisito previo: Verifica la versión de la biblioteca libdb4 en RedHat 7.4 y CentOS 7.4

En RedHat 7.4 y CentOS 7.4, verifica la versión de los RPM de libdb4 antes de instalar. Edge requiere la versión 4.8, y algunas versiones de RedHat 7.4 y CentOS 7.4 se envían con una versión posterior. Si tienes una versión posterior, desinstálala y el instalador de Edge instalará la versión 4.8.

Puedes usar el siguiente comando para verificar tu versión:

rpm -qa | grep libdb4

Si ves que la versión del RPM de libdb4 es posterior a la versión 4.8, desinstálala.

Requisitos previos para RHEL 8

Si instalas Edge en un servidor que ejecuta Red Hat Enterprise Linux (RHEL) 8, sigue estos 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-8.noarch.rpm
  2. Inhabilita Postgres y Nginx: 
    sudo dnf module disable postgresql
sudo dnf module disable nginx
  3. Instala Python 2: 
    sudo dnf install -y python2

Requisitos previos para Amazon Linux 2023(AL2023)

Si instalas Edge en un servidor que ejecuta Amazon-Linux-2023(AL2023), sigue estos pasos antes de realizar la instalación: 

USE_CQLUTIL=y

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 ya tienes un username:password para el sitio FTP de Apigee, puedes usar esas credenciales.
  2. Accede a tu nodo como administrador para instalar los RPM de Edge.
  3. Instala yum-utils y yum-plugin-priorities. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Inhabilita SELinux.
  5. Habilita el repo de EPEL.
  6. Verifica tu versión de libdb4.
  7. Si realizas la instalación en RHEL 8, sigue los pasos que se indican en Requisitos previos para RHEL 8.
  8. Si realizas la instalación en Oracle 7.x, ejecuta el siguiente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Si realizas la instalación en AWS, ejecuta los siguientes comandos de yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Descarga el archivo bootstrap_4.52.02.sh de Edge en /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  11. Instala la utilidad apigee-service de Edge y las dependencias: 
    sudo bash /tmp/bootstrap_4.52.02.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.

    De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. De lo contrario, lo instala por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX toma los siguientes valores:

    • I: Instala OpenJDK 1.8 (predeterminado)
    • C: Continuar sin instalar Java
    • P.: Salir. En 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:

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

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

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

Solución de problemas

Cuando intentes instalar 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:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

En la siguiente tabla, se enumeran algunas posibles resoluciones para estos errores:

Tipo de error Resolución posible
La contraseña contiene caracteres no válidos No uses caracteres especiales en tu contraseña de Apigee.
Problemas de conectividad

Ejecuta el siguiente comando ncat para probar la conectividad de tu 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 comando de telnet:

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, significa que tienes conectividad de red limitada o nula. Consulta con tu administrador de red.
Credenciales incorrectas

Asegúrate de que tu nombre de usuario y 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 de proxy Tu configuración local usa un proxy HTTP de salida y no extendiste la misma configuración al administrador de paquetes yum. Verifica tus 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 del proxy HTTP global en /etc/environment

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

Si tus nodos de borde están detrás de un firewall o tienen prohibido el acceso a Internet de alguna otra manera, debes crear varios repositorios o duplicados que contengan los archivos que necesitarás durante la instalación. Luego, esos duplicados deben ser accesibles para todos los nodos. Una vez creados, los nodos pueden acceder a estos espejos 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 repo interno, puedes moverlo a otro nodo o hacer que ese nodo sea accesible para los nodos perimetrales para la instalación.

Después de crear un repositorio local de Apigee, es posible que debas actualizarlo más adelante 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 repo de Apigee local, 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 una contraseña para el sitio FTP de Apigee, puedes usar esas credenciales.
  2. Accede a tu nodo como raíz para instalar los RPM de Edge.
  3. Inhabilita SELinux como se describió anteriormente.
  4. Descarga el archivo bootstrap_4.52.02.sh de Edge en /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  5. Instala la utilidad y las dependencias de apigee-service de Edge: 
    sudo bash /tmp/bootstrap_4.52.02.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 repo de Apigee con el directorio /opt/apigee/data/apigee-mirror/repos/.

    Para minimizar el tamaño del repo, incluye --only-new-rpms para descargar solo los RPM más recientes.

  8. (Opcional) Si deseas instalar Edge desde el repo local en el mismo nodo que aloja el repo local, primero debes ejecutar los siguientes comandos:
    1. Ejecuta bootstrap_4.52.02.sh desde el repo local para instalar la utilidad apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.02.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 Cómo instalar componentes de Edge en un nodo para obtener más información.

Instala apigee-setup en un nodo remoto desde el repo local

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

  • Crea un archivo .tar del repo, cópialo en un nodo y, luego, instala Edge desde el archivo .tar.
  • Instala un servidor web en el nodo con el repo 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 repo local, usa el siguiente comando para empaquetar el repo local en un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.52.02.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, asegúrate de poder acceder al repo de la utilidad Yum local y al repo de EPEL.
  5. Verifica que todos los repositorios externos de Internet estén inhabilitados (este debería ser el caso, ya que estás instalando 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. En el nodo nuevo, instala yum-utils y yum-plugin-priorities desde tu repositorio local. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities

    Tu equipo de operaciones o algún otro grupo de tu organización debe configurar un repo local para que puedas instalar las herramientas de Yum.

  7. En el nodo nuevo, verifica tu versión de libdb4 como se describió anteriormente.
  8. Si realizas la instalación en Oracle 7.x, ejecuta el siguiente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Si realizas la instalación en AWS, ejecuta el siguiente comando yum-configure-manager: 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. En el nodo nuevo, descomprime el archivo en el directorio /tmp: 
    tar -xzf apigee-4.52.02.tar.gz

    Este comando crea un directorio nuevo llamado repos en el directorio que contiene el archivo .tar. Por ejemplo /tmp/repos.

  11. Instala la utilidad apigee-service de Edge y las dependencias desde /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Ten en cuenta que debes incluir la ruta de acceso al directorio de repositorios en este comando.

  12. Usa apigee-service para instalar la utilidad apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. 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 repo con el servidor web Nginx

Para instalar desde el repo 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, haz lo siguiente:
    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 repo requiere un nombre de usuario y una 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, instala yum-utils y yum-plugin-priorities. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
  6. En el nodo nuevo, asegúrate de que el repo de EPEL local esté habilitado.
  7. En el nodo nuevo, verifica tu versión de libdb4 como se describió anteriormente.
  8. En el nodo remoto, descarga el archivo Edge bootstrap_4.52.02.sh en /tmp/bootstrap_4.52.02.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

    Aquí, 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 nodo del repo.

  9. En el nodo remoto, instala la utilidad apigee-service de Edge y las dependencias: 
    sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Aquí, uName:pWord son el nombre de usuario y la contraseña del repo.

  10. En el nodo remoto, usa apigee-service para instalar la utilidad apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. 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 repo, debes descargar el archivo bootstrap_4.52.02.sh más reciente y, luego, realizar una nueva sincronización.

Para actualizar el repo, haz lo siguiente:

  1. Descarga el archivo bootstrap_4.52.02.sh de Edge en /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Ejecuta el archivo bootstrap_4.52.02.sh de Edge: 
    sudo bash/tmp/bootstrap_4.52.02.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 con este comando: 
    /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 clonar todo el repo, haz lo siguiente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Limpia un repo local de Apigee

La limpieza del repo local borra /opt/apigee/data/apigee-mirror y /var/tmp/yum-apigee-*.

Para limpiar el repo local, usa el siguiente comando:

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

Agrega o actualiza Edge 4.16.0x/4.17.0x en un repo 4.52.02

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

Para agregar 4.16.0x/4.17.0x a un repo 4.52.02, haz lo siguiente:

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

    Deberías ver un resultado con el siguiente formato, en el que xyz es el número de compilación:

    apigee-mirror-4.52.02-0.0.xyz
  2. Usa la utilidad apigee-mirror para descargar Edge 4.16.0x/4.17.0x en tu repo. Observa cómo antepones al comando la versión deseada: 
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Usa este mismo comando para actualizar más adelante los repositorios 4.16.0x/4.17.0x especificando los números de versión requeridos.

  3. Examina el directorio /opt/apigee/data/apigee-mirror/repos para ver la estructura de archivos: 
    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
bootstrap_4.17.09.sh
bootstrap_4.18.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.sh
thirdparty

    Observa que tienes un archivo de arranque para todas las versiones de Edge. El directorio apigee también contiene directorios separados para cada versión de Edge.

  4. Para empaquetar el repo en un archivo .tar, usa el siguiente comando:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    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 repo.

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

  • Si la instalación se realiza desde un archivo .tar, ejecuta el archivo de arranque correcto desde el repo:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Para completar la instalación, sigue los pasos restantes de "Instala desde el archivo .tar" que se indican más arriba.

  • Si la instalación se realiza con el servidor web Nginx, descarga y, luego, ejecuta el archivo de arranque correcto desde el repo: 
    /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://

    Para completar la instalación, sigue los pasos restantes de "Instala desde el repositorio con el servidor web Nginx" que se indican más arriba.