Descripción general de la instalación de Edge

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 él.

Proceso de instalación

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

  1. Inhabilita SELinux en el nodo o configúralo en modo permisivo. Consulta Cómo instalar la utilidad de configuración de Apigee para obtener más información.
  2. Decide si quieres habilitar la autenticación de Cassandra.
  3. Decide si quieres configurar la replicación en espera principal para Postgres.
  4. Selecciona tu configuración de Edge en la lista de topologías recomendadas. Por ejemplo, puedes instalar Edge en un solo nodo a fin de realizar pruebas o en 13 nodos para producción. Consulta Topologías de instalación para obtener más información.
  5. En cada nodo de la topología seleccionada, instala la utilidad apigee-setup de Edge:
    • Descarga el archivo de Edge bootstrap_4.50.00.sh en /tmp/bootstrap_4.50.00.sh.
    • Instala la utilidad apigee-service y las dependencias de Edge.
    • Instala la utilidad apigee-setup y las dependencias de Edge.

      Consulta Cómo instalar la utilidad apigee-setup de Edge para obtener más información.

  6. Usa la utilidad apigee-setup para instalar uno o más componentes de Edge en cada nodo según la topología seleccionada.

    Consulta Cómo instalar componentes de Edge en un nodo.

  7. En el nodo del servidor de administración, usa la utilidad apigee-setup a fin de instalar apigee-provision, las utilidades que usas para crear y administrar organizaciones de Edge.

    Consulta Integra una organización para obtener más información.

  8. Reinicia el componente de IU clásica en cada nodo después de que se complete la instalación, como se muestra en el siguiente ejemplo:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (Recomendado) Después de completar la instalación inicial, Apigee recomienda que instales la nueva IU de Edge (cuyo nombre de componente es edge-management-ui), que es una interfaz de usuario mejorada para los desarrolladores y administradores de Apigee Edge para la nube privada.

    Para obtener más información, consulta Cómo instalar 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énes pueden 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, un usuario raíz o un usuario con acceso completo de sudo debe ejecutar los comandos. En el caso del acceso sudo completo, significa que el usuario tiene acceso sudo para realizar las mismas operaciones que el usuario raíz.

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

  • Utilidad de apigee-service:
    • Comandos de apigee-service: install, uninstall, update.
    • Comandos de apigee-all: install, uninstall, update.
  • setup.sh para instalar componentes de Edge (a menos que ya hayas usado "apigee-service install" a fin de instalar los RPM necesarios) Luego, puedes acceder con permisos de administrador o raíz 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 que se ejecute como el usuario “apigee”.

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

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

Creación de un usuario con acceso "sudo" total al usuario "apigee"

Si deseas configurar a un usuario para que tenga acceso total a sudoers, usa el comando "visudo" a fin de editar 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.

Establece permisos en los archivos de configuración

El usuario de Apigee debe poder acceder a todos los archivos o recursos que usen los comandos de Edge. Esto incluye el archivo de licencia de Edge y cualquier archivo de configuración.

Cuando crea un archivo de configuración, puede cambiar el propietario a “apigee:apigee” para asegurarse de que sea accesible para los comandos de Edge:

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

Separa las tareas de instalación perimetral de Edge entre el usuario raíz y el usuario no raíz

Si bien es más sencillo realizar todo el proceso de instalación de Edge como raíz o mediante un usuario que tiene acceso total a sudo, no siempre es posible. En su lugar, puedes separar el proceso en tareas que realizan la raíz y tareas que realizan un usuario con acceso completo al archivo Sudo.

  1. Tareas que realiza la raíz:
    1. Descarga y ejecuta el archivo bootstrap_4.50.00.sh:
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
      sudo bash /tmp/bootstrap_4.50.00.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 Cómo crear un usuario con acceso completo de sudo a un 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 RPM de Edge en el nodo:
      /opt/apigee/apigee-service/bin/apigee-service compName install

      Los RPM de Edge que instales en el nodo dependerán de tu topología. La lista de componentes disponibles 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.

  2. Después de que el usuario raíz instala los RPM de Edge en el nodo, el usuario con acceso completo de sudo 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 Cómo instalar 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.

      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 contiene 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 leerlo. Por ejemplo, coloca el archivo en el directorio /usr/local/var o /usr/local/share en el nodo y chown en “apigee:apigee”.

Toda la información en el 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 solicitará 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.

Cómo manejar 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 de manera repetida en casos en los que detecte un error 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 ejecute.

Instalación por Internet o no por Internet

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

  • Nodos con conexión a Internet externa

    Los nodos con conexión a Internet externa acceden al repositorio de Apigee para instalar las RPM y las dependencias de Edge.

  • Nodos sin conexión a Internet externa

    Los nodos sin conexión a Internet externa 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 tener todas las demás dependencias disponibles de los repositorios en la red interna.

    Para crear el repositorio de Apigee interno, necesitas un nodo con acceso a Internet externo a fin de 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 perimetrales 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 duplicado es la instalación de Edge en nodos sin conexión a Internet externa, como se describió en la sección anterior.

Resuelve 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 se definen mediante 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 una instalación en una máquina con acceso a Internet, el nodo puede descargar los RPM y las dependencias necesarios. Sin embargo, si realizas la instalación desde un nodo sin acceso a Internet, por lo general, se configura un repositorio interno que contiene todas las dependencias necesarias. La única forma de garantizar que todas las dependencias se incluyan en tu repositorio local es intentar una instalación, identificar las dependencias que faltan y copiarlas en el repositorio local hasta que la instalación se complete con éxito.

Comandos Yum comunes

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.

  • Borra todas las cachés de Yum:
    sudo yum clean all
  • Para actualizar un componente de Edge, sigue estos pasos:
    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 perimetrales, el directorio de instalación raíz se indica de la siguiente manera:

/opt/apigee

La instalación 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 escriben 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 para el servidor de administración están 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 los siguientes vínculos:

/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 Apigee Postgres /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 en "y", el instalador verifica que el sistema cumpla con los requisitos de CPU y memoria para el componente que se está instalando. El valor predeterminado es "n" para inhabilitar la verificación.