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 ese nodo.

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 Instala la utilidad apigee-setup de Edge para obtener más información.
2. Decide si quieres habilitar la autenticación de Cassandra.
3. Decide si quieres configurar la replicación principal en espera 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 para realizar pruebas o en 13 nodos para la 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 bootstrap_4.52.02.sh de Edge en /tmp/bootstrap_4.52.02.sh.
   • Instala la utilidad apigee-service de Edge y las dependencias.
   • Instala la utilidad apigee-setup de Edge y las dependencias.

     Consulta Instala 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 para instalar apigee-provision, las utilidades que usas para crear y administrar organizaciones de Edge.

   Consulta Cómo incorporar 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 Instala la nueva IU de Edge.

Una vez finalizada 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 RPMs y dependencias. Para instalar, desinstalar y actualizar los RPM de Edge, los comandos deben ejecutarse con el usuario raíz o con un usuario que tenga acceso completo a sudo. Para tener acceso completo a sudo, el usuario debe tener acceso a sudo para realizar las mismas operaciones que root.

Cualquier usuario que desee ejecutar los siguientes comandos o secuencias de comandos debe ser root o tener acceso completo a sudo:

• Utilidad apigee-service:
  • Comandos de apigee-service: install, uninstall, update
  • Comandos de apigee-all: install, uninstall, update
• Secuencia de comandos setup.sh para instalar los componentes de Edge (a menos que ya hayas usado "apigee-service install" para instalar los RPMs requeridos) Luego, acceso raíz o sudo completo (si no se requiere).
• 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 desee ejecutar otros comandos además de los que se muestran arriba debe tener acceso sudo completo al usuario "apigee". Estos comandos incluyen los siguientes:

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

Cómo crear un usuario con acceso sudo completo al usuario "apigee"

Para configurar un usuario de modo que tenga acceso sudo completo al usuario "apigee", usa el comando "visudo" para editar el archivo de sudoers y agregar lo siguiente:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

Cómo establecer permisos en archivos de configuración

El usuario "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 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. chown 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.

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

Si bien lo más sencillo es realizar todo el proceso de instalación de Edge como usuario raíz o como usuario con acceso completo por sudo, esto no siempre es posible. En su lugar, puedes separar el proceso en tareas realizadas por el usuario raíz y tareas realizadas por un usuario con acceso completo a sudo para el usuario "apigee".

1. Tareas realizadas por el administrador raíz:
   1. Descarga y ejecuta el archivo bootstrap_4.52.02.sh:

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.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 completo a sudo como usuario "apigee", según se describe en Cómo crear un usuario con acceso completo a sudo como usuario "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 de Edge que instalas en el nodo dependen 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 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 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

      Aquí, configFile es el archivo de configuración de Edge.

      O bien, 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 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 para las instalaciones silenciosas es que el archivo de configuración debe ser accesible o legible para el usuario "apigee". Por ejemplo, coloca el archivo en el directorio /usr/local/var o /usr/local/share del nodo y chownlo en "apigee:apigee".

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

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

Cómo controlar un error de instalación

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

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

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 RPMs y las dependencias de Edge.

• Nodos sin conexión externa a Internet

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

  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 repo interno, puedes moverlo a otro nodo o hacer que ese nodo sea accesible para los nodos de Edge para la instalación.

Cómo usar un repositorio de Edge local para mantener tu versión de Edge

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

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 se definen mediante componentes de terceros que están fuera del control de Apigee y pueden cambiar en cualquier momento. Por lo tanto, la documentación no incluye 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 los RPMs y las dependencias necesarios. Sin embargo, si realizas la instalación desde un nodo sin acceso a Internet, por lo 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 repo local es intentar una instalación, identificar las dependencias faltantes 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, 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 en el directorio /opt/apigee.

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

/opt/apigee

La instalación usa la siguiente estructura del sistema de archivos para implementar Apigee Edge para Private Cloud.

Archivos de registro

El archivo de registro de 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 del servidor de administración se encuentran en el directorio:

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

En la siguiente tabla, se indica la ubicación de los archivos de registro:

Datos

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

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

ENABLE_SYSTEM_CHECK=y

Si configuras esta propiedad como "y", el instalador verifica 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.