Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Instala la utilidad de Apigee de Setup de Edge

Edge para nube privada v4.18.01

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 a Internet externa, 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 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 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 SELinux en modo permisivo de forma temporal, ejecuta el siguiente comando:
1. En un sistema operativo Linux 6.x:
  sudo echo 0 > /selinux/enforce
  
  Para volver a habilitar SELinux después de instalar Edge:
  sudo echo 1 > /selinux/enforce
2. En un sistema operativo Linux 7.x:
  sudo setenforce 0
  
  Para volver a habilitar SELinux después de instalar Edge:
  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 repositorio de EPEL

Debes habilitar los paquetes adicionales para Enterprise Linux (o EPEL) para instalar o actualizar Edge, o para crear un repositorio local. El comando que uses dependerá de tu versión de RedHat/CentOS:

Para RedHat/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 RedHat/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 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 la instalación. 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 de RPM de libdb4 es posterior a la versión 4.8, desinstálala.

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:

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 de FTP de Apigee, puedes usar esas credenciales.
Accede a tu nodo como raíz para instalar los RPM de Edge
Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
Instala yum-utils y yum-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 realizas la instalación en 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 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.18.01.sh de Edge en /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Instala la utilidad apigee-service de Edge y las dependencias:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. Si no lo tienes, se 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 = Instalar OpenJDK 1.8 (predeterminado)
C = Continuar sin instalar Java
Q = 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 Instala componentes de Edge en un nodo para obtener más información.

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 acceder al repositorio de Apigee a través de Internet, debes crear un repositorio local o una duplicación del repositorio de Apigee. Luego, todos los nodos deben poder acceder a esa duplicación. Una vez creados, los nodos pueden acceder a esa duplicación local para instalar Edge.

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

Nota: Apigee no aloja todas las dependencias de terceros en nuestros repositorios públicos. Debes descargar e instalar estas dependencias desde repositorios de acceso público.

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

Crea un repositorio local de Apigee

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 una contraseña para el sitio de FTP de Apigee, puedes usar esas credenciales.
Accede a tu nodo como raíz para instalar los RPM de Edge.
Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
Inhabilita SELinux como se describió anteriormente.
Descarga el archivo bootstrap_4.18.01.sh de Edge en /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Instala la utilidad apigee-service de Edge y las dependencias:
> sudo bash /tmp/bootstrap_4.18.01.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 pedirá que la ingreses.
Instala la utilidad apigee-mirror en el nodo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

Nota: Si actualizas un repositorio existente a la versión 4.18.01, solo debes actualizar apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
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. Necesitas aproximadamente 1.6 GB de espacio en el 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 el 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:
1. Ejecuta bootstrap_4.18.01.sh desde el repositorio local para instalar la utilidad apigee-service:
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.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 proporciona el servidor web de Nginx para que lo uses, o puedes usar tu propio servidor web.

Instala desde el archivo .tar:

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.18.01.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, habilita el repositorio de EPEL como se describió anteriormente.
En el nodo nuevo, asegúrate de haber inhabilitado los repositorios de Internet externos. Cuando ejecutes el siguiente comando, todos los repositorios externos deberían aparecer como inhabilitados, pero el repositorio local de Apigee y cualquiera de tus repositorios internos deberían estar habilitados:
> sudo yum repolist
En el nodo nuevo, instala yum-utils y yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
En el nodo nuevo, verifica tu versión de libdb4 como se describió anteriormente.
Si estás instalando en 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 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.18.01.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 apigee-service de Edge y las dependencias de /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Ten en cuenta que debes incluir la ruta de acceso al directorio de repositorios en este comando.
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.

Instala desde el repositorio con el servidor web de Nginx:

Instala el servidor web de 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 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
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 y yum-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, habilita el repositorio de EPEL como se describió anteriormente.
En el nodo nuevo, verifica tu versión de libdb4 como se describió anteriormente.
En el nodo remoto, descarga el archivo bootstrap_4.18.01.sh de Edge en /tmp/bootstrap_4.18.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

En el ejemplo anterior, 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.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

en el que uName:pWord son el nombre de usuario y la contraseña del repositorio.
En el nodo remoto, 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 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.18.01.sh más reciente y, luego, realizar una sincronización nueva:

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

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

Limpia un repositorio local de Apigee

Cuando se limpia el repositorio local, se borran /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 repo 4.18.01

Si tienes que mantener instalaciones para Edge 4.16.0x o 4.17.0x en un repositorio 4.18.01, 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.18.01, haz lo siguiente:

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

Deberías ver un resultado en el siguiente formato, en el que xyz es el número de compilación:
apigee-mirror-4.18.01-0.0.xyz
Usa la utilidad apigee-mirror para descargar Edge 4.16.0x/4.17.0x en tu repositorio. Observa cómo se agrega el prefijo al comando con 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.
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.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty

Observa cómo tienes un archivo de arranque para todas las versiones de Edge. El directorio 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, 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 "Instala desde el archivo .tar" que se indican más arriba.
Si realizas la instalación con el servidor web de 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 “Instala desde el repositorio con el servidor web de Nginx” que se mencionan más arriba.