Se usó la API de Cloud Translation para traducir esta página.

Descripción general de la instalación de Edge

Una instalación de Edge típica consta de componentes de Edge distribuidos en varios nodos. Después de instalar Edge en un nodo, debes instalar y configurar uno o más componentes de Edge en el nodo.

Proceso de instalación

La instalación de Edge en un nodo es un proceso de varios pasos:

Inhabilita SELinux en el nodo o configúralo en modo permisivo. Consulta Instala la utilidad de apigee-setup de Edge para obtener más información.
Decide si quieres habilitar la autenticación de Cassandra.
Decide si quieres configurar la replicación de instancia principal en espera para Postgres.
Selecciona la configuración de Edge de la lista de topologías recomendadas. Por ejemplo, puedes instalar Edge en un solo nodo para realizar pruebas o en 13 nodos para producción. Consulta Topologías de instalación para obtener más información.
En cada nodo de la topología que seleccionaste, instala la utilidad apigee-setup de Edge:
- Descarga el archivo bootstrap_4.52.01.sh de Edge en /tmp/bootstrap_4.52.01.sh.
- Instala la utilidad apigee-service y las dependencias de Edge.
- Instala la utilidad apigee-setup y las dependencias de Edge.
  Consulta Instala la utilidad de apigee-setup de Edge para obtener más información.
Usa la utilidad apigee-setup para instalar uno o más componentes de Edge en cada nodo según la topología seleccionada.
Consulta Instala componentes de Edge en un nodo.
En el nodo del servidor de administración, usa la utilidad apigee-setup para instalar apigee-provision, las utilidades que usas para crear y administrar organizaciones perimetrales.
Consulta Cómo integrar una organización para obtener más información.
Una vez que se complete la instalación, reinicia el componente de IU clásica en cada nodo, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
.
(Recomendado) Después de completar la instalación inicial, Apigee recomienda instalar la nueva IU de Edge (cuyo nombre de componente es edge-management-ui), que es una interfaz de usuario mejorada para desarrolladores y administradores de Apigee Edge para nube privada.

Para obtener más información, consulta Instala la nueva IU de Edge.

Una vez que se complete la instalación, consulta esta lista de acciones comunes posteriores a la instalación.

Quién puede realizar la instalación

Los archivos de distribución de Apigee Edge se instalan como un conjunto de RPM y dependencias. Para instalar, desinstalar y actualizar los RPM de Edge, el usuario raíz o un usuario con acceso sudo completo deben ejecutar los comandos. Para el acceso sudo completo, eso significa que el usuario tiene acceso sudo para realizar las mismas operaciones que la raíz.

Cualquier usuario que desee ejecutar los siguientes comandos o secuencias de comandos debe tener permisos de administrador o ser un usuario con acceso sudo completo:

Utilidad apigee-service:
- Comandos de apigee-service: install, uninstall, update.
- Comandos de apigee-all: install, uninstall, update.
setup.sh para instalar los componentes de Edge (a menos que ya hayas usado “apigee-service install” para instalar los RPM necesarios. Luego, se otorga acceso raíz o completo al sudo si no es necesario).
Secuencia de comandos update.sh para actualizar componentes de Edge

Además, el instalador de Edge crea un usuario nuevo en tu sistema llamado “apigee”. Muchos comandos de Edge invocan el comando sudo para que se ejecute como el usuario de "apigee".

Cualquier usuario que desee ejecutar otros comandos distintos de los que se muestran arriba debe ser un usuario con acceso sudo completo al usuario de “apigee”. Entre estos comandos, se incluyen los siguientes:

Comandos de utilidad de apigee-service, incluidos los siguientes:
- Comandos de apigee-service, como start, stop, restart, configure.
- Comandos apigee-all, como start, stop, restart, configure.

Crea un usuario con acceso sudo completo al usuario de “apigee”

NOTA: No puedes realizar este paso hasta que hayas ejecutado el archivo bootstrap_4.52.01.sh para crear el usuario “apigee”.

Si quieres configurar un usuario para que tenga acceso sudo completo al usuario “apigee”, usa el comando “visudo” para editar el archivo sudoers y agregarlo:

installUser        ALL=(apigee)      NOPASSWD: ALL

En el ejemplo anterior, installUser es el nombre de usuario de la persona que trabaja con Edge.

Establece permisos en los archivos de configuración

El usuario de “apigee” debe poder acceder a los archivos o recursos que usan los comandos de Edge. Esto incluye el archivo de licencia de Edge y cualquier archivo de configuración.

Cuando creas un archivo de configuración, puedes cambiar su propietario a “apigee:apigee” para garantizar que sea accesible para los comandos de Edge:

Crea el archivo en un editor como cualquier usuario.
chown el propietario del archivo a “apigee:apigee” o, si cambiaste el usuario que ejecuta el servicio de Edge desde el usuario de “apigee”, cambia el nombre del archivo al usuario que ejecuta el servicio de Edge.

Separación de las tareas de instalación de Edge entre usuarios raíz y no raíz

Si bien es más sencillo realizar todo el proceso de instalación de Edge como permisos de administrador o mediante un usuario con acceso sudo completo, no siempre es posible. En su lugar, puedes separar el proceso en tareas realizadas por raíz y tareas realizadas por un usuario con acceso sudo completo al usuario de “apigee”.

Tareas realizadas por raíz:
1. Descarga y ejecuta el archivo bootstrap_4.52.01.sh:
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
  .
  En este paso, se instala la utilidad apigee-service y se crea el usuario “apigee”.
2. Configura un usuario para que tenga acceso sudo completo al usuario de “apigee” como se describe en Crea un usuario con acceso sudo completo al usuario de “apigee”.
3. Instala la utilidad apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
4. Usa la utilidad apigee-setup para instalar los RPM de Edge en el nodo:
```
/opt/apigee/apigee-service/bin/apigee-service compName install
```
  Los RPM perimetrales que instalas en el nodo dependen de tu topología. En la lista de componentes disponibles, se incluye apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.
Después de que el usuario raíz instala los RPM perimetrales en el nodo, el usuario con acceso sudo completo al usuario “apigee” completa el proceso de configuración:
1. Usa la utilidad setup.sh para completar la configuración de los componentes de Edge en el nodo. La forma del comando depende de los componentes que instalaste en el nodo. Para obtener una lista completa, consulta Instala componentes de Edge en un nodo.
  Por ejemplo, para completar la instalación de ZooKeeper y Cassandra, usa el siguiente comando:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
```
  En el ejemplo anterior, configFile es el archivo de configuración de Edge.
  
  Como alternativa, para realizar una instalación todo en uno, usa el siguiente comando:
```
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
```

Ubicación de los archivos de configuración de instalación

Debes pasar un archivo de configuración a la utilidad apigee-setup que contenga la información sobre la instalación de Edge. El único requisito en las instalaciones silenciosas es que el usuario de “apigee” debe poder acceder al archivo de configuración o poder leerlo. Por ejemplo, coloca el archivo en el directorio /usr/local/var o /usr/local/share del nodo y chownlo a “apigee:apigee”.

Toda la información del archivo de configuración es obligatoria, excepto la contraseña del administrador del sistema perimetral. Si omites la contraseña, la utilidad apigee-setup te solicita que la ingreses en la línea de comandos.

Consulta Instala componentes de Edge en un nodo para obtener más información.

Maneja una falla de instalación

En el caso de una falla durante la instalación de un componente de Edge, puedes intentar corregir el problema y, luego, volver a ejecutar el instalador. El instalador está diseñado para ejecutarse reiteradamente en casos en los que se detecta una falla o si luego quieres cambiar o actualizar un componente después de la instalación.

Después de instalar o actualizar, asegúrate de reiniciar el componente de IU de Edge en cada nodo en el que se ejecuta.

Instalación con Internet o sin conexión a Internet

Para instalar Edge en un nodo, este debe poder acceder al repositorio de Apigee:

Nodos con una conexión a Internet externa
Los nodos con una conexión a Internet externa acceden al repositorio de Apigee para instalar las dependencias y RPM de Edge.
Nodos sin conexión a Internet externa
Los nodos sin una conexión externa a Internet pueden acceder a una versión duplicada del repositorio de Apigee que configuras de forma interna. Este repositorio contiene todos los RPM de Edge, pero debes asegurarte de tener todas las demás dependencias disponibles de los repositorios de la red interna.

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.

Si quieres crear el repositorio interno de Apigee, necesitas un nodo con acceso externo a Internet para poder descargar las dependencias y 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.

Usa un repositorio de Edge local para mantener tu versión de Edge

Uno de los motivos para usar un repositorio local o duplicado es la instalación de Edge en nodos sin conexión a Internet externa, como se describió en la sección anterior.

Nota: Sin embargo, usar un repositorio local tiene otra ventaja, incluso para los nodos con una conexión externa a Internet. Cuando instalas Edge desde el repositorio público de Apigee, siempre debes instalar los últimos RPM de Edge. Por lo tanto, si deseas descargar y almacenar los RPM de Edge de una versión específica, debes crear un repositorio local para esa versión. Luego, puedes usar ese repositorio local para realizar instalaciones de cualquier versión de Edge.

Por ejemplo, primero usas el repositorio local para instalar un entorno de desarrollo perimetral. Luego, cuando tengas todo listo para pasar a un entorno de producción, vuelve a instalar Edge desde el repositorio local. Mediante la instalación desde el repositorio local, garantizas que los entornos de desarrollo y producción coincidan.

Un repositorio duplicado es muy flexible. Por ejemplo, puedes crear un repositorio duplicado a partir de los últimos RPM de Edge o de una versión específica de Edge. Después de crear el repositorio, también puedes actualizarlo para agregar RPM de diferentes versiones de Edge. Consulta Instala la utilidad de apigee-setup de Edge para obtener más información.

Resuelve dependencias de instalación de RPM

Los archivos de distribución de Apigee Edge se instalan como un conjunto de archivos de RPM, cada uno de los cuales puede tener su propia cadena de dependencias de instalación. Muchas de estas dependencias las definen componentes de terceros que están fuera del control de Apigee y pueden cambiar en cualquier momento. Por lo tanto, en la documentación, no se indica el número de versión explícito de cada dependencia.

Si realizas la instalación en una máquina con acceso a Internet, el nodo puede descargar las dependencias y RPM necesarias. Sin embargo, si realizas la instalación desde un nodo sin acceso a Internet, en general, debes configurar un repositorio interno que contenga todas las dependencias necesarias. La única forma de garantizar que todas las dependencias se incluyan en tu repositorio local es intentar realizar una instalación, identificar las dependencias faltantes y copiarlas en el repositorio local hasta que la instalación tenga éxito.

Comandos comunes de Yum

Las herramientas de instalación de Edge para Linux dependen de Yum para instalar y actualizar componentes. Es posible que debas usar varios comandos de Yum para administrar una instalación en un nodo.

Limpia todas las cachés de Yum:
```
sudo yum clean all
```

Para actualizar un componente de Edge, haz lo siguiente:

sudo yum update componentName

Por ejemplo:

sudo yum update apigee-setup
sudo yum update edge-management-server

Estructura del sistema de archivos

Edge instala todos los archivos del directorio /opt/apigee.

En esta guía y en la Guía de operaciones perimetrales, el directorio de instalación raíz se indica de la siguiente manera:

/opt/apigee

En la instalación, se usa la siguiente estructura de sistema de archivos a fin de implementar Apigee Edge para la nube privada.

Archivos de registro

El archivo de registro de apigee-setup y la secuencia de comandos setup.sh se escribe en /tmp/setup-root.log.

Los archivos de registro para cada componente se encuentran en el directorio /opt/apigee/var/log. Cada componente tiene su propio subdirectorio. Por ejemplo, los registros del servidor de administración se encuentran en el directorio:

/opt/apigee/var/log/edge-management-server

En las siguientes tablas, se muestra la ubicación de los archivos de registro:

Componente	Ubicación
Servidor de administración	`/opt/apigee/var/log/edge-management-server`
Router	`/opt/apigee/var/log/edge-router` El router perimetral se implementa con NGINX. Para obtener registros adicionales, consulta lo siguiente: `/opt/apigee/var/log/edge-router/nginx` `/opt/nginx/logs`
Message Processor	`/opt/apigee/var/log/edge-message-processor`
Servidor Qpid de Apigee	`/opt/apigee/var/log/edge-qpid-server`
Servidor Postgres de Apigee	`/opt/apigee/var/log/edge-postgres-server`
IU clásica (no la nueva IU de Edge, cuyo nombre de componente es `edge-management-ui`)	`/opt/apigee/var/log/edge-ui`
ZooKeeper	`/opt/apigee/var/log/apigee-zookeeper`
OpenLDAP	`/opt/apigee/var/log/apigee-openldap`
Cassandra	`/opt/apigee/var/log/apigee-cassandra/system.log`
QPIdd	`/opt/apigee/var/log/apigee-qpidd`
Base de datos de PostgreSQL	`/opt/apigee/var/log/apigee-postgresql`
`apigee-monit`	`/opt/apigee/var/log/apigee-monit`

Datos

Componente	Ubicación
Servidor de administración	`/opt/apigee/data/edge-management-server`
Router	`/opt/apigee/data/edge-router`
Message Processor	`/opt/apigee/data/edge-message-processor`
Agente de Qpid de Apigee	`/opt/apigee/data/edge-qpid-server`
Agente de Apigee Postgres	`/opt/apigee/data/edge-postgres-server`
ZooKeeper	`/opt/apigee/data/apigee-zookeeper`
OpenLDAP	`/opt/apigee/data/apigee-openldap`
Cassandra	`/opt/apigee/data/apigee-cassandra/data`
QPIdd	`/opt/apigee/data/apigee-qpid/data`
Base de datos de PostgreSQL	`/opt/apigee/data/apigee-postgres/pgdata`
`apigee-monit`	`/opt/apigee/data/apigee-monit`

Habilitar la verificación del sistema durante la instalación

El archivo de configuración de instalación de Edge admite la siguiente propiedad:

ENABLE_SYSTEM_CHECK=y

Si configuras esta propiedad como "y", el instalador comprueba que el sistema cumpla con los requisitos de CPU y memoria del componente que se está instalando. El valor predeterminado es "n" para inhabilitar la verificación.