Después de la instalación

Después de una instalación exitosa de Edge, hay algunas tareas comunes que te recomendamos realizar para validar la instalación, ajustar la configuración y personalizar la configuración. Estas tareas incluyen las siguientes:

Tarea Descripción
Invoca comandos en componentes de Edge Usa la utilidad apigee-service para iniciar, detener, reiniciar y obtener el estado de cada componente de Edge.
Configura componentes de Edge Usa archivos de propiedades para cambiar la configuración predeterminada del componente de Edge.
Ejecute Apigee-validate Invoca las secuencias de comandos de prueba para asegurarte de que la instalación de cada componente se haya realizado correctamente.
Ajusta la configuración de montón de JVM Optimiza tu configuración de memoria Java para cada nodo.
Administrar la política de contraseñas de LDAP Cambie la contraseña de LDAP predeterminada y establezca varios parámetros de autenticación.
Instale Apigee Monit en el nodo Instala y usa una herramienta que supervise los componentes del nodo y que intente reiniciar si fallan.
Configura trabajos de eliminación definitiva de PostgreSQL Reduce el exceso de datos que recopila el servicio de estadísticas.
Configura la reparación de la herramienta nodeandra El mantenimiento periódico que debes realizar en el anillo de Cassandra para garantizar la coherencia entre todos los nodos
Cómo habilitar el inicio automático Indica a Edge para que la nube privada se reinicie automáticamente durante el reinicio.
Instala la nueva IU de Edge Apigee recomienda que instales la nueva IU de Edge, que es una interfaz de usuario mejorada para los desarrolladores y administradores de Apigee Edge para la nube privada.

Ten en cuenta que estas son solo algunas de las tareas más comunes que realizas generalmente después de instalar Edge. Para obtener información sobre operaciones adicionales y tareas de administración, consulta Cómo configurar Edge y Operaciones.

Invoca comandos en componentes de Edge

Edge instala las utilidades de administración de /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_name action

Donde component_name identifica el componente. El componente debe estar en el nodo en el que ejecutas apigee-service. Según tu configuración, los valores de component_name pueden incluir lo siguiente:

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (base de datos de PostgreSQL)
  • apigee-qpidd (trinquete)
  • apigee-sso (SSO de Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (servidor de administración)
  • edge-management-ui (nueva IU de Edge)
  • edge-message-processor (Procesador de mensajes)
  • edge-postgres-server (servidor de Postgres)
  • edge-qpid-server (servidor Qpid)
  • edge-router (router perimetral)
  • edge-ui (IU clásica)

Además de estos componentes, también puedes invocar a apigee-service en los componentes apigee-provision y apigee-validate según tu configuración.

Por ejemplo, para reiniciar el router perimetral, ejecuta el siguiente comando:

/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 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: Es un componente de monetización. Por ejemplo, edge-mint-management-server.

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

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

Configura los componentes de Edge

Para configurar Edge después de la instalación, usa una combinación de archivos .properties y utilidades de Edge. Por ejemplo, a fin de configurar TLS/SSL en la IU de Edge, editas los archivos .properties para establecer las propiedades necesarias. Los cambios en los archivos .properties requieren que reinicies el componente perimetral 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 de 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. Eso 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.

Instale Apigee Monit en el nodo

Una vez que termines de instalar componentes en un nodo, tienes la opción de agregar la utilidad apigee-monit. apigee-monit supervisará los componentes en el nodo e intentará reiniciarlos si fallan. Para obtener más información, consulte Reparación automática con apigee-monit.

Configurar un servidor OpenLDAP para que sea de solo lectura

Si tu instalación de Edge contiene un servidor de OpenLDAP en el que no es necesario cambiar el tráfico, te recomendamos que configures el servidor para que sea de solo lectura. Para ello, siga estos pasos:

  1. Crea un archivo mark_readonly.ldif en el servidor con las siguientes líneas: 
    dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: TRUE
  2. Ejecuta el siguiente comando en el servidor para marcarlo como de solo lectura: 
    ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

En caso de que el servidor principal falle, puedes volver a usar el servidor en espera como principal de la siguiente manera:

  1. Crea un archivo mark_writable.ldif en el servidor en espera con la siguiente línea: 
    dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
  2. Ejecuta el siguiente comando en el servidor en espera: 
    ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif