Para instalar Edge en un nodo, primero debes instalar la utilidad de configuración de Apigee 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 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 para poder instalar la utilidad apigee-setup
de Edge o cualquier componente de Edge. Si es necesario, luego de instalar Edge, puedes volver a habilitar SELinux.
- Abre
/etc/sysconfig/selinux
en un editor. - Establece
SELINUX=disabled
oSELINUX=permissive
- Guarda los cambios.
- Reinicia el nodo.
- Si es necesario, repite este procedimiento para configurar
SELINUX=enabled
y volver a habilitar SELinux después de la instalación de Edge.
Requisito previo: Habilita el repositorio EPEL
Debes habilitar Extra Packages for Enterprise Linux (o EPEL) para instalar o actualizar Edge, o crear un repositorio local. El comando que uses depende de la versión de Red Hat o CentOS que tengas:
- Para Red Hat/CentOS/Oracle 8.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
- Para Red Hat/CentOS/Oracle 9.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
- Habilita Paquetes adicionales para Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Inhabilita Postgres y Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Habilita Paquetes adicionales para Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- Inhabilita Postgres y Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- 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 de FTP de Apigee, puedes usar esas credenciales.
- Accede a tu nodo como raíz para instalar los RPM de Edge
- Inhabilita SELinux.
- Habilita el repositorio EPEL.
- Si instalas RHEL 9, Rocky 9 o Oracle 9, sigue los pasos que se indican en Requisitos previos para RHEL 9/Rocky 9/Oracle 9.
- Descarga el archivo
bootstrap_4.53.00.sh
de Edge en/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instala la utilidad apigee-service y las dependencias de Edge:
sudo bash /tmp/bootstrap_4.53.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 solicitará que lo ingreses.
De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. De lo contrario, la instalará 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 (predeterminada)
- C: Continuar sin instalar Java
- P.: 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:
cat /etc/yum.repos.d/apigee.repo
Para ver el contenido del repositorio, usa el siguiente comando:
sudo yum -v repolist 'apigee*'
- Usa apigee-service para instalar la utilidad apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.
- Agrega una configuración de proxy HTTP en
/etc/yum.conf
- Se agregó la configuración de proxy HTTP global en
/etc/environment
- Repositorio de Apigee Edge: Como se describe en Crea un repositorio de Apigee local.
- Paquetes adicionales para Enterprise Linux (o EPEL): El equipo de operaciones debería poder configurar esto por ti.
- 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 usar esas credenciales.
- Accede a tu nodo como raíz para instalar los RPM de Edge.
- Inhabilita SELinux como se describió anteriormente.
- Descarga el archivo
bootstrap_4.53.00.sh
de Edge a/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instala la utilidad apigee-service y las dependencias de Edge:
sudo bash /tmp/bootstrap_4.53.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.
- Instala la utilidad
apigee-mirror
en el nodo:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- 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 las RPM más recientes. -
(Opcional) Si deseas instalar Edge desde el repositorio local en el mismo nodo que aloja el repositorio local, primero debes ejecutar los siguientes comandos:
- Ejecuta
bootstrap_4.53.00.sh
desde el repositorio local para instalar la utilidadapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Usa
apigee-service
para instalar la utilidadapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.
- Ejecuta
- 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 proporciona el servidor web Nginx para que lo uses, o bien puedes usar tu propio servidor web.
- 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.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copia el archivo .tar en el nodo en el que deseas instalar Edge. Por ejemplo, cópialo en el directorio
/tmp
del nodo nuevo. - En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
- En el nodo nuevo, asegúrate de poder acceder al repositorio local de la utilidad Yum y al repositorio de EPEL.
- 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 deberían estar habilitados.
- Usa
apigee-service
para instalar la utilidadapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Usa
apigee-setup
para instalar y configurar los componentes de Edge en el nodo. Consulta Cómo instalar componentes de Edge en un nodo para obtener más información. - Instala el servidor web Nginx en el nodo del repositorio:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- De forma predeterminada, Nginx está configurado para usar localhost como nombre de servidor y el puerto 3939. Para
cambiar estos valores, haz lo siguiente:
- Abre
/opt/apigee/customer/application/mirror.properties
en un editor. Crea el archivo si no existe. - Establece los siguientes valores según sea necesario:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Reinicia Nginx:
/opt/nginx/scripts/apigee-nginx restart
- Abre
- 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
- En el nodo nuevo, asegúrate de que el repositorio EPEL esté habilitado de forma local.
- En el nodo nuevo, verifica tu versión de
libdb4
como se describió anteriormente. - En el nodo remoto, instala la utilidad
apigee-service
y las dependencias de Edge:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Donde uName:pWord son el nombre de usuario y la contraseña del repositorio.
- En el nodo remoto, usa
apigee-service
para instalar la utilidadapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Usa
apigee-setup
para instalar y configurar los componentes de Edge en el nodo remoto. Consulta Cómo instalar componentes de Edge en un nodo para obtener más información. - Descarga el archivo bootstrap_4.53.00.sh de Edge a
/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Ejecuta el archivo
bootstrap_4.53.00.sh
de Edge:sudo bash/tmp/bootstrap_4.53.00.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.
- Actualiza
apigee-mirror
con este comando:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Realiza la sincronización:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Si quieres todo el repo, sigue estos pasos:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Requisitos previos para RHEL 8, Rocky 8 y Oracle 8
Si instalas Edge en un servidor que ejecuta Red Hat Enterprise Linux (RHEL) 8, sigue estos pasos antes de realizar la instalación:
Requisito previo para RHEL 9, Rocky 9 y 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:
Para conocer los cambios previos a la instalación de PostgreSQL y LDAP, consulta los requisitos previos a la instalación de la base de datos de PostgreSQL y los cambios previos a la instalación de OpenLDAP 2.4, respectivamente.
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, haz lo siguiente:
Solución de problemas
Cuando intentes instalarlo en un nodo con una conexión a Internet externa, 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 enumeran algunas soluciones posibles para estos errores:
Tipo de error | Solució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 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 telnet software.apigee.com 443 Si los comandos se realizan correctamente, puedes usar CTRL + C para abortar la conexión abierta. Si alguno de los comandos falla, significa que tienes conectividad de red limitada o no tienes ninguna. 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 con el proxy | Tu configuración local usa un proxy HTTP de salida y no extendiste la misma configuración al administrador de paquetes yum . Verifica las variables de entorno:
echo $http_proxy
Para un proxy HTTP de salida, debes usar una de las siguientes opciones: |
Instala la utilidad apigee-setup de Edge en un nodo sin conexión a Internet externa.
Si los nodos de Edge están detrás de un firewall o, de alguna otra manera, tienen prohibido acceder a Internet, debes crear varios repositorios, o duplicaciones, que contengan los archivos que necesitarás durante la instalación. Todos los nodos deben poder acceder a esos espejos. 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 conexiones 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 de Apigee local, es posible que más adelante debas actualizarlo con los archivos de versión más recientes de Edge. En las siguientes secciones, se describe cómo crear un repositorio de Apigee local y cómo actualizarlo.
Para crear un repositorio local de Apigee, sigue estos pasos:
Instala apigee-setup en un nodo remoto desde el repositorio local.
Tienes dos opciones para instalar Edge desde el repositorio local. Tienes varias opciones:
Instala desde el archivo .tar
Para instalar desde el archivo .tar, haz lo siguiente:
Instala desde el repositorio con el servidor web Nginx
Para instalar desde el repositorio con el servidor web Nginx, haz lo siguiente:
Actualiza un repositorio local de Apigee
Para actualizar el repositorio, debes descargar el archivo bootstrap_4.53.00.sh más reciente y, luego, realizar una nueva sincronización.
Para actualizar el repositorio, haz lo siguiente:
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