Para instalar Edge en un nodo, primero debes instalar la utilidad de configuración de Apigee de Edge. Si estás en un en el que tus nodos no tengan una conexión externa a Internet, también debes instalar copia local del repositorio de Apigee.
Directorio de instalación predeterminado: /opt/apigee
Edge instala todos los archivos del directorio /opt/apigee
. No puedes cambiar esto
. Sin embargo, si lo deseas, puedes crear un symlink 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 establecerlo en el modo permisivo para poder instalar Edge
apigee-setup
o cualquier herramienta Edge
o los componentes de la solución. Si es necesario, luego de instalar Edge, puedes volver a habilitar SELinux.
- Para configurar SELinux de forma temporal en el 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, haz lo siguiente:
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, haz lo siguiente:
sudo setenforce 1
- En un sistema operativo Linux 6.x:
- Para inhabilitar SELinux de forma permanente o configurarlo en modo permisivo, haz lo siguiente:
- 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. Para ello, repite este procedimiento para
establecer
SELINUX=enabled
- Abre
Requisito previo: Habilitar el repositorio EPEL
Debes habilitar los Paquetes adicionales para Enterprise Linux (o EPEL) para instalar o actualizar Edge, o bien para crear un repositorio local El que uses dependerá de la versión de Red Hat/CentOS:
Para Red Hat Enterprise Linux (RHEL) 8.0, consulta Requisitos previos para 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 libdb4 versión de la biblioteca 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 libdb4
antes de la instalación. Perimetrales
requiere la versión 4.8, y algunas versiones de Red Hat 7.4 y CentOS 7.4 se envían con un
una versión posterior. Si tienes una versión posterior, desinstálala, y el instalador de Edge hará lo siguiente:
luego, instala 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 de RPM libdb4
es posterior a la 4.8, desinstala la app.
que la modifica.
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:
- Habilitar 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
- Instala Python 2 y crea un symlink:
sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python
Instala la utilidad apigee-setup de Edge en un nodo con una conexión de Internet externa conexión
Para instalar Edge en un nodo con una conexión a Internet externa, sigue estos pasos:
- 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 usarlo 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.
- Habilita el repositorio de EPEL.
- Comprueba tu versión
de
libdb4
. - Si instalas en RHEL 8, sigue los pasos que se indican en Requisitos para RHEL 8.
- Si instalas Oracle 7.x, ejecuta el siguiente comando:
sudo yum-config-manager --enable ol7_optional_latest
- Si estás realizando la instalación en AWS, ejecuta el siguiente comando:
Comandos
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.52.00.sh
de Edge en/tmp/bootstrap_4.52.00.sh
:curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Instala la utilidad y las dependencias del servicio de Apigee de Edge:
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
Donde uName:pWord son el nombre de usuario y la contraseña que recibiste Apigee Si omites pWord, se te solicitará que lo ingreses.
De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción
JAVA_FIX
para especificar cómo manejarla Instalación de Java.JAVA_FIX
toma 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.
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 de configuración de Apigee:
/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.
Soluciona problemas
Cuando intentes realizar la instalación en un nodo con conexión a Internet externa, 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 soluciones posibles 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 | Para probar tu conectividad de red, 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 telnet software.apigee.com 443 Si los comandos se ejecutan de forma correcta, puedes usar Ctrl + C para anular la conexión abierta. Si alguno de los comandos falla, entonces tu conectividad de red es limitada o nula. Verifica con tu administrador de red. |
Credenciales incorrectas | Asegúrate de que tu nombre de usuario y contraseña sean correctos. Por ejemplo, comprueba si se produce un error cuando intentas usar el siguiente comando con nombre de usuario y contraseña de Apigee: curl -i -u username:password https://software.apigee.com/apigee-repo.rpm |
Problemas relacionados con el proxy | Tu configuración local usa un proxy HTTP de salida y no extendiste la misma
en el 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:
|
Instalar Edge Utilidad apigee-setup en un nodo sin conexión a Internet externa
Si los nodos perimetrales están detrás de un firewall o tienen prohibido acceder, en Internet, deberás crear varios repositorios, o duplicados, que contengan archivos necesitas durante la instalación. Esas duplicaciones deben ser accesibles para todos los nodos. Una vez creados, los nodos podrá acceder a estas duplicaciones 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:
- Repositorio de Apigee Edge: Como se describe en Crea un repositorio local de Apigee.
- Repo 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 debería poder configurar esto para ti.
Crea un repositorio local de Apigee
Para crear el repositorio interno de Apigee, necesitas un nodo con una conexión de Internet externa para poder descargar los RPM y las dependencias de Edge. Una vez que hayas creado a otro nodo, puede moverlo a otro nodo o hacer que sea accesible para los nodos de Edge instalación.
Después de crear un repositorio local de Apigee, es posible que más adelante debas actualizarlo con la versión Archivos de lanzamiento de Edge. En las siguientes secciones, se describe cómo crear un repositorio local de Apigee. cómo actualizarlo.
Para crear un repositorio local de Apigee, haz lo siguiente:
- 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 usarlo 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.52.00.sh
de Edge en/tmp/bootstrap_4.52.00.sh
:curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Instala la utilidad y las dependencias del servicio de Apigee de Edge:
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
Donde uName:pWord son el nombre de usuario y la contraseña que recibiste 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/opt/apigee/data/apigee-mirror/repos/
.Para minimizar el tamaño del repositorio, incluye
--only-new-rpms
para descargar solo el los RPM más recientes. -
(Opcional) Si quieres instalar Edge desde el repositorio local en el mismo
que aloja el repositorio local, primero debes ejecutar los siguientes comandos:
- Ejecuta
bootstrap_4.52.00.sh
desde el repositorio local para instalar el Utilidadapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.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 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, cópialo en un nodo y, luego, instala Edge desde el archivo .tar.
- Instalar 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, o puedes usar tu propio servidor web web.
Instalar 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
único archivo .tar llamado
/opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copia el archivo .tar en el nodo en el que quieres instalar Edge. Por ejemplo, cópialos en la
Directorio
/tmp
en el 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 la utilidad local Yum y al EPEL. repo.
- Verifica que todos los repositorios externos de Internet estén inhabilitados (este debería ser el caso, ya que
que estás realizando en una máquina sin acceso a Internet):
sudo yum repolist
Se deben inhabilitar todos los repositorios externos, pero el repositorio local de Apigee y tus repositorios internos se debe habilitar.
- En el nodo nuevo, instala
yum-utils
yyum-plugin-priorities
desde tu repo 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 deben configurar un repo local para que puedas realizar las siguientes acciones: 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 instalas la app en AWS, ejecuta el siguiente comando:
Comando
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.52.00.tar.gz
Este comando crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. . Por ejemplo
/tmp/repos.
- Instala la utilidad y las dependencias del servicio de Apigee de Edge desde
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Ten en cuenta 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 realizar la instalación 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 usar localhost como el nombre del servidor y el puerto 3939. Para
cambia estos valores:
- 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
- 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, establece 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 arranque de Edge_4.52.00.sh en
/tmp/bootstrap_4.52.00.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio. 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.52.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.
- En el nodo remoto, usa
apigee-service
para instalarapigee-setup
. utilidad:/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 archivo bootstrap_4.52.00.sh más reciente y, luego, realizar una nueva sincronización.
Para actualizar el repositorio, haz lo siguiente:
- Descarga el archivo bootstrap_4.52.00.sh de Edge a
/tmp/bootstrap_4.52.00.sh
:curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Ejecuta el archivo
bootstrap_4.52.00.sh
de Edge:sudo bash/tmp/bootstrap_4.52.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 omite 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
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
Agrega o actualiza Edge 4.16.0x/4.17.0x en un repositorio 4.52.00.
Si debes mantener instalaciones para Edge 4.16.0x o 4.17.0x en un repositorio 4.52.00, 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 4.52.00, haz lo siguiente:
- Asegúrate de haber instalado la versión 4.52.00 de
apigee-mirror
. utilidad:/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.52.00-0.0.xyz
- Usa el
apigee-mirror
para descargar Edge 4.16.0x/4.17.0x a tu repositorio. Observa cómo antepones el comando con la versión deseada:apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Usa el mismo comando para actualizar los repositorios 4.16.0x/4.17.0x más adelante mediante la especificación de los repositorios números de versión.
- Examina el directorio
/opt/apigee/data/apigee-mirror/repos
para ver el archivo. estructura: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
apigee
también contiene directorios independientes para cada versión de Edge. - Para empaquetar el repositorio 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 repositorio.
Para instalar Edge desde el repositorio local o el archivo .tar, solo asegúrate de ejecutar el arranque correcto con uno de los siguientes comandos. En este ejemplo, se instala Edge 4.17.01:
- Si lo instalas 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 "Cómo instalar desde el archivo .tar" arriba.
- Si realizas la instalación mediante 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 la sección "Instala desde el repositorio con servidor web NGINX" arriba.