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.
Directorio de instalación predeterminado: /opt/apigee
Edge instala todos los archivos en el directorio /opt/apigee
. No puedes cambiar este
directorio. Sin embargo, 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 el modo permisivo para poder 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:
- En un sistema operativo Linux 6.x:
sudo echo 0 > /selinux/enforce
Para volver a habilitar SELinux después de instalar Edge, sigue estos pasos:
sudo echo 1 > /selinux/enforce
- En un sistema operativo Linux 7.x:
sudo setenforce 0
Para volver a habilitar SELinux después de instalar Edge, sigue estos pasos:
sudo setenforce 1
- En un sistema operativo Linux 6.x:
- Para inhabilitar SELinux de forma permanente o configurarlo en el modo permisivo, sigue estos pasos:
- Abre
/etc/sysconfig/selinux
en un editor. - Configura
SELINUX=disabled
oSELINUX=permissive
- Guarda los cambios.
- Reinicia el nodo.
- 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
.
- Abre
Requisito previo: Habilita el repositorio de EPEL
Debes habilitar Extra Packages for Enterprise Linux (o EPEL) para instalar o actualizar Edge, o bien para crear un repositorio local. El comando que uses depende de la versión de Red Hat/CentOS:
- 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
Requisito previo: Verifica la versión de la biblioteca libdb4 en Red Hat 7.4 y CentOS 7.4
En Red Hat 7.4 y CentOS 7.4, verifica la versión de los RPM de libdb4
antes de instalarlo. Edge requiere la versión 4.8, y algunas versiones de Red Hat 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 la versión:
rpm -qa | grep libdb4
Si ves que la versión de RPM libdb4
es posterior a la versión 4.8, desinstálala.
Instalar 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:
- Obtenga el nombre de usuario y la contraseña de Apigee que usa 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
- Instala
yum-utils
yyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Inhabilita SELinux como se describió anteriormente.
- Habilita el repositorio de EPEL como se describió anteriormente.
- Verifica tu versión de
libdb4
como se describió anteriormente. - Si instalas Oracle 7.x, ejecuta el siguiente comando:
sudo yum-config-manager --enable ol7_optional_latest
- 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
- Descarga el archivo
bootstrap_4.19.06.sh
de Edge en/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
- Instala la utilidad y las dependencias de apigee-service de Edge:
sudo bash /tmp/bootstrap_4.19.06.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 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 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 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:// : @ 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 soluciones para estos errores:
Tipo de error | Resolución posible |
---|---|
La contraseña contiene caracteres incorrectos | No uses caracteres especiales en la contraseña de Apigee. |
Problemas de conectividad | Ejecuta el siguiente comando nc -v software.apigee.com 443 Deberías ver un mensaje similar al siguiente: Connection to software.apigee.com 443 port [tcp/https] succeeded! Si no tienes telnet software.apigee.com 443 Si los comandos se ejecutan correctamente, puedes usar CTRL+C para anular la conexión abierta. Si alguno de los comandos falla, significa que tu conectividad de red es limitada o no tienes ninguna. Consulta al administrador de red. |
Credencial incorrecta | Asegúrate de que el nombre de usuario y la contraseña sean correctos. Por ejemplo, verifica si recibes un mensaje de 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 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 perimetrales están detrás de un firewall, o de alguna otra manera tiene prohibido acceder a Internet, debes crear varios repositorios o duplicados que contengan archivos que necesitarás durante la instalación. Luego, todos los nodos deben poder acceder a esas duplicaciones. Una vez creados, los nodos pueden acceder a estas duplicaciones 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:
- Repositorio de Apigee Edge: como se describe en Crea un repositorio local de Apigee.
- Repositorio de Yum (para utilidades como
yum-utils
yyum-plugin-priorities
): Tu equipo de operaciones debería poder configurar esto por ti. - Paquetes adicionales para Enterprise Linux (o EPEL): Tu equipo de operaciones debe poder configurar esto por ti.
Crea un repositorio local de Apigee
Si quieres crear el repositorio interno de Apigee, necesitas un nodo con acceso externo a Internet para descargar las dependencias y los RPM de Edge. Una vez que hayas creado el repositorio interno, puedes moverlo a otro nodo o hacer que los nodos perimetrales accedan a él 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 de Edge más reciente. En las siguientes secciones, se describe cómo crear un repositorio local de Apigee y cómo actualizarlo.
Sigue estos pasos para crear un repositorio de Apigee local:
- 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.
- Accede a tu nodo como raíz para instalar los RPM de Edge.
- Inhabilita SELinux como se describió anteriormente.
- Descarga el archivo
bootstrap_4.19.06.sh
de Edge en/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
- Instala la utilidad y las dependencias de apigee-service de Edge:
sudo bash /tmp/bootstrap_4.19.06.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.
- 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
a fin de 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. -
(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.19.06.sh
desde el repositorio local para instalar la utilidadapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.06.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 los componentes de Edge en el nodo. Consulta Instala componentes de Edge en un nodo para obtener más información.
- Ejecuta
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.
Instala desde el archivo .tar
Para instalar desde el archivo .tar, sigue estos pasos:
- 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.19.06.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 que puedes acceder al repositorio de utilidad local de Yum y al repositorio de EPEL.
- Vuelve a verificar que todos los repositorios externos de Internet estén inhabilitados (este debería ser el caso, ya que la instalación se realiza en una máquina sin acceso a Internet):
sudo yum repolist
Se deben inhabilitar todos los repositorios externos, pero se deben habilitar el repositorio local de Apigee y los repositorios internos.
- En el nodo nuevo, instala
yum-utils
yyum-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 dentro de tu organización debe configurar un repositorio local para que puedas instalar las herramientas de Yum.
- En el nodo nuevo, verifica tu versión de
libdb4
como se describió anteriormente. - Si instalas Oracle 7.x, ejecuta el siguiente comando:
sudo yum-config-manager --enable ol7_optional_latest
- Si realizas la instalación en AWS, ejecuta el siguiente comando de
yum-configure-manager
:sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- En el nodo nuevo, descomprime el archivo en el directorio /tmp:
tar -xzf apigee-4.19.06.tar.gz
Con este comando, se crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo
/tmp/repos.
- Instala la utilidad de apigee-service de Edge y las dependencias desde
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observa que incluyes la ruta de acceso al directorio de repositorios en este comando.
- 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 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
Para instalar desde el repositorio con el servidor web Nginx, sigue estos pasos:
- 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 utilizar localhost como el nombre del 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. - Configura los siguientes valores según sea necesario:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Reiniciar 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, instala
yum-utils
yyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
- En el nodo nuevo, asegúrate de que el repositorio de EPEL local esté habilitado.
- En el nodo nuevo, verifica tu versión de
libdb4
como se describió anteriormente. - En el nodo remoto, descarga el archivo Boot_4.19.06.sh de Edge a
/tmp/bootstrap_4.19.06.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
.Donde uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.
- En el nodo remoto, instala la utilidad
apigee-service
de Edge y las dependencias:sudo bash /tmp/bootstrap_4.19.06.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.
- 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 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 último archivo Boot_4.19.06.sh y, luego, realizar una nueva sincronización.
Sigue estos pasos para actualizar el repositorio:
- Descarga el archivo boot_4.19.06.sh de Edge a
/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
- Ejecuta el archivo
bootstrap_4.19.06.sh
de Edge:sudo bash/tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que recibió de Apigee. Si omites pWord, se te solicitará que lo ingreses.
- Actualización de
apigee-mirror
:/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 deseas ver todo el repositorio, usa este comando:
/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.0x/4.17.0x en un repositorio 4.19.06
Si tienes que mantener las instalaciones de Edge 4.16.0x o 4.17.0x en un repositorio 4.19.06, 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.0x a un repositorio de 4.19.06, haz lo siguiente:
- Asegúrate de haber instalado la versión 4.19.06 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.19.06-0.0.xyz
- Usa la utilidad
apigee-mirror
para descargar Edge 4.16.0x/4.17.0x al repositorio. Observa cómo puedes agregar al comando el prefijo de 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 posteriormente los repositorios 4.16.0x/4.17.0x mediante la especificación de los números de versión requeridos.
- 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 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. - Usa el siguiente comando para empaquetar el repositorio en un archivo .tar:
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 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. En este ejemplo, se instala Edge 4.17.01:
- Si realizas la instalación desde un archivo .tar, ejecuta el archivo de arranque correcto desde el repositorio:
sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Para completar la instalación, sigue los pasos restantes de la sección "Instala desde el archivo .tar" que aparece más arriba.
- Si realizas la instalación con el servidor web Nginx, descarga y, luego, ejecuta el archivo de arranque correcto desde el repositorio:
/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 la sección "Instala desde el repositorio con el servidor web Nginx" que se incluye más arriba.