Descripción general de la instalación de Edge

Edge para la nube privada v. 4.17.01

Una instalación típica de Edge 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 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 maestra-en espera para Postgres.
  • Selecciona tu configuración de Edge de la lista de topologías recomendadas. Por ejemplo, puedes instalar Edge en un solo nodo para pruebas o en 13 nodos para producción. Consulta Configura la replicación maestra-en espera para Postgres para obtener más información.
  • En cada nodo de la topología seleccionada, instala la utilidad apigee-setup de Edge:
    • Descarga el archivo bootstrap_4.17.01.sh de Edge a /tmp/bootstrap_4.17.01.sh.
    • Instala la utilidad apigee-service y las dependencias de Edge.
    • Instala la utilidad y las dependencias apigee-setup de Edge.

      Consulta Instala la utilidad 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 que hayas seleccionado.
    Consulta Cómo instalar 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 de Edge.
    Para obtener más información, consulta Cómo integrar una organizació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 Edge, el usuario raíz o un usuario que tenga acceso completo por sudo debe ejecutar los comandos de Edge. Para el acceso completo por sudo, significa que el usuario tiene acceso por sudo para realizar las mismas operaciones que root.

Cualquier usuario que desee ejecutar los siguientes comandos o secuencias de comandos debe ser raíz o un usuario con acceso completo por sudo:

  • Utilidad apigee-service:
    • Comandos apigee-service: install, uninstall, update.
    • Comandos apigee-all: install, uninstall, update.
  • setup.sh a fin de instalar componentes de Edge (A menos que ya hayas usado “apigee-service install” para instalar los RPM necesarios. Luego, accede con permisos de administrador o sudo completo si no es necesario).
  • secuencia de comandos update.sh para actualizar los componentes de Edge

Además, el instalador de Edge crea un usuario nuevo en tu sistema, llamado "apigee". Muchos comandos de Edge invocan sudo para ejecutarse como el usuario "apigee".

Cualquier usuario que quiera ejecutar todos los demás comandos que no se muestran anteriormente debe ser un usuario con acceso sudo completo al usuario "apigee". Entre estos comandos, se incluyen los siguientes:

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

Si deseas configurar un usuario para que tenga acceso completo de sudo al usuario de “apigee”, edita el archivo sudoers y agrega lo siguiente:

installUser        ALL=(apigee)      NOPASSWD: ALL

installUser es el nombre de usuario de la persona que trabaja con Edge.

El usuario de “apigee” debe poder acceder a todos 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 crees un archivo de configuración, puedes cambiar su propietario a "apigee:apigee" para asegurarte de que los comandos de Edge puedan acceder a él:

  1. Crea el archivo en un editor como cualquier usuario.
  2. Cambia el propietario del archivo a "apigee:apigee" o, si cambiaste el usuario que ejecuta el servicio de Edge del usuario "apigee", cambia el propietario del archivo al usuario que ejecuta el servicio de Edge.

Ubicación de los archivos de configuración de la 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 de las instalaciones silenciosas es que el usuario "apigee" pueda acceder al archivo de configuración o leerlo. Por ejemplo, coloca el archivo en el directorio /usr/local/var o /usr/local/share en el nodo y asígnale el chown a "apigee:apigee".

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

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

Manejo de una falla de instalación

En caso de que se produzca 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 de manera repetida en los casos en que se detecta una falla o si más adelante deseas cambiar o actualizar un componente después de la instalación.

Instalación con 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 externa a Internet acceden al repositorio de Apigee para instalar los RPM y las dependencias de Edge.
  • Nodos sin una 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 configuraste de forma interna. Este repositorio contiene todos los RPM de Edge, pero debes asegurarte de que tengas todas las demás dependencias disponibles desde 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.

    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, puedes moverlo a otro nodo o hacer que los nodos de Edge puedan acceder a él para su 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 reflejado es instalar Edge en nodos sin conexión externa a Internet, como se describe en la sección anterior.

Sin embargo, usar un repositorio local tiene otra ventaja, incluso para los nodos con una conexión a Internet externa. Cuando instalas Edge desde el repositorio público de Apigee, siempre instalas los RPM de Edge más recientes. Por lo tanto, si deseas descargar y almacenar RPM de Edge para una versión específica de Edge, 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 de Edge. Luego, cuando todo esté listo para pasar a un entorno de producción, vuelve a instalar Edge desde el repositorio local. Si lo instalas 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 reflejado a partir de los RPM de Edge más recientes 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 apigee-setup de Edge para obtener más información.

Cómo resolver dependencias de instalación de RPM

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

Si realizas una instalación en una máquina con acceso a Internet, el nodo puede descargar las RPM y las dependencias necesarias. Sin embargo, si realizas la instalación desde un nodo sin acceso a Internet, por lo general, configuras un repositorio interno que contiene todas las dependencias necesarias. La única manera de garantizar que todas las dependencias se incluyan en tu repo local es intentar una instalación, identificar las dependencias que faltan y copiarlas en el repo local hasta que la instalación se realice correctamente.

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, escribe el siguiente comando:
    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 en el directorio /opt/apigee.

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

<inst_root>/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 para apigee-setup y la secuencia de comandos setup.sh se escribe en /tmp/setup-root.log.

Los archivos de registro de 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 indica la ubicación de los archivos de registro:

Componentes

Ubicación

Servidor de administración

<inst_root>/apigee/var/log/edge-management-server

Router

<inst_root>/apigee/var/log/edge-router

Message Processor

<inst_root>/apigee/var/log/edge-message-processor

Servidor Qpid de Apigee

<inst_root>/apigee/var/log/edge-qpid-server

Servidor de Apigee Postgres

<inst_root>/apigee/var/log/edge-postgres-server

IU de Edge

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

&lt;inst_root&gt;/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

Base de datos de PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

Datos

Componentes

Ubicación

Servidor de administración

&lt;data_root&gt;/apigee/data/edge-management-server

Router

<data_root>/apigee/data/edge-router

Message Processor

<data_root>/apigee/data/edge-message-processor

Agente de Qpid de Apigee

<data_root>/apigee/data/edge-qpid-server

Agente de Postgres de Apigee

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

&lt;data_root&gt;/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

Base de datos de PostgreSQL

<data_root>/apigee/data/apigee-postgres/pgdata

Tareas posteriores de instalación

Una vez finalizada la instalación, puedes realizar acciones adicionales en los componentes de Edge.

Cómo configurar los componentes de Edge después de la instalación

Para configurar Edge después de la instalación, usa una combinación de archivos .properties y utilidades de Edge. Por ejemplo, para configurar TLS/SSL en la IU de Edge, debes editar los archivos .properties para establecer las propiedades necesarias. Los cambios en los archivos .properties requieren que reinicies el componente de Edge afectado.

Los archivos .properties se encuentran en el directorio /opt/apigee/customer/application. Cada componente tiene su propio archivo .properties en ese directorio. Por ejemplo, router.properties y management-server.properties.

Para establecer una propiedad para un componente, edita el archivo .properties correspondiente y, luego, reinicia el componente:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Por ejemplo:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Cuando actualizas Edge, se leen los archivos .properties del directorio /opt/apigee/customer/application. Esto significa que la actualización retiene todas las propiedades que configuraste en el componente.

Consulta Cómo configurar Edge para obtener más información al respecto.

Cómo invocar comandos en componentes de Edge

Edge instala utilidades de administración en /opt/apigee/apigee-service/bin que puedes usar para administrar una instalación de Edge. Por ejemplo, puedes usar la utilidad apigee-all para iniciar, detener, reiniciar o determinar el estado de todos los componentes de Edge en el nodo:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Usa la utilidad apigee-service para controlar y configurar componentes individuales. La utilidad apigee-service tiene el siguiente formato:

/opt/apigee/apigee-service/bin/apigee-service component action

Por ejemplo, para reiniciar el router perimetral, sigue estos pasos:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Para determinar la lista de componentes instalados en el nodo, examina el directorio /opt/apigee. Ese directorio contiene un subdirectorio para cada componente de Edge instalado en el nodo. Cada subdirectorio tiene el siguiente prefijo:

  • apigee: Es un componente de terceros que usa Edge. Por ejemplo, apigee-cassandra.
  • edge: Un componente de Edge de Apigee. Por ejemplo, edge-management-server.
  • edge-mint: Un componente de monetización Por ejemplo, edge-mint-management-server.
  • baas: Es un componente de BaaS de la API. Por ejemplo, baas-usergrid.

La lista completa de acciones de un componente depende del componente en sí, pero todos los componentes admiten las siguientes acciones:

  • iniciar, detener, reiniciar
  • estado, versión
  • copia de seguridad, restablecimiento
  • instalar, desinstalar