Después de una instalación correcta de Edge, es posible que quieras realizar algunas tareas comunes para validar la instalación, ajustar la configuración y personalizarla. Estas tareas incluyen las siguientes:
| Tarea | Descripción |
|---|---|
| Invocar comandos en componentes de Edge | Usa la utilidad apigee-service para iniciar, detener, reiniciar y obtener el estado
de cada componente de Edge. |
| Configurar componentes de Edge | Usa archivos de propiedades para cambiar la configuración predeterminada de los componentes de Edge. |
| Ejecutar apigee-validate | Invoca las secuencias de comandos de prueba para asegurarte de que la instalación de cada componente se haya realizado correctamente. |
| Ajustar la configuración del montón de JVM | Optimiza la configuración de la memoria de Java para cada nodo. |
| Administrar la política de contraseñas de LDAP | Cambia la contraseña predeterminada de LDAP y configura varios parámetros de autenticación. |
| Instalar apigee-monit en el nodo | Instala y usa una herramienta que supervise los componentes del nodo y que intente reiniciarlos si fallan. |
| Cambiar la contraseña predeterminada de PostgreSQL | Apigee recomienda que cambies la contraseña predeterminada de PostgreSQL después de instalar Edge para nube privada para mantener la seguridad de tus datos. |
| Configurar trabajos de purga de PostgreSQL | Elimina los datos en exceso que recopila el servicio de estadísticas. |
| Configurar la reparación de nodetool de Cassandra | Es el mantenimiento periódico que debes realizar en tu anillo de Cassandra para garantizar la coherencia en todos los nodos. |
| Habilitar el inicio automático | Indica a Edge para nube privada que se reinicie automáticamente durante un reinicio. |
| Configurar la nueva IU de Edge | Configura la autenticación y los parámetros opcionales para la nueva IU de Edge, la interfaz de usuario de administración para 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 sueles realizar después de instalar Edge. Para obtener más información sobre las operaciones y las tareas de administración adicionales, consulta Cómo configurar Edge y Operaciones.
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_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(Qpidd)apigee-zookeeper(ZooKeeper)edge-management-server(servidor de administración)edge-management-ui(Nueva IU de Edge)edge-message-processor(Message Processor)edge-postgres-server(servidor de Postgres)edge-qpid-server(servidor de Qpid)edge-router(router perimetral)
Además de estos componentes, también puedes invocar apigee-service en los
apigee-provision y apigee-validate componentes según tu
configuración.
Por ejemplo, para reiniciar el router de Edge, ejecuta el siguiente comando:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Puedes determinar la lista de componentes instalados en el nodo examinando el
/opt/apigee directorio. Ese directorio contiene un subdirectorio para cada componente de Edge
instalado en el nodo. Cada subdirectorio tiene el siguiente prefijo:
apigee: 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 Monetization. Por ejemploedge-mint-management-server.
La lista completa de acciones para un componente depende del componente en sí, pero todos los componentes admiten las siguientes acciones:
start, stop, restartstatus, versionbackup, restoreinstall, uninstall
Configurar 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, para configurar TLS/SSL en la nueva IU de Edge, edita
.properties archivos 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 /opt/apigee/customer/application directorio.
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 en el
/opt/apigee/customer/application directorio. Eso significa que la actualización conserva
las propiedades que estableciste en el componente.
Consulta Cómo configurar Edge para obtener más información sobre la configuración de Edge.
Instalar apigee-monit en el nodo
Después de completar la instalación de los componentes en un nodo, puedes agregar la apigee-monit
de forma opcional. apigee-monit supervisará los componentes del nodo y tratará de reiniciarlos si fallan.
Para obtener más información, consulta Reparación automática con apigee-monit.
Configurar un servidor SymasLDAP como de solo lectura
Si tu instalación de Edge contiene un servidor SymasLDAP que no necesita que se cambie el tráfico a él, te recomendamos que configures el servidor como de solo lectura. Para ello, sigue estos pasos:
- Crea un archivo
mark_readonly.ldifen el servidor con las siguientes líneas:dn: olcDatabase={2}mdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: TRUE - 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 falle el servidor principal, puedes volver a usar el servidor de espera como principal de la siguiente manera:
- Crea un archivo
mark_writable.ldifen el servidor de espera con la siguiente línea:dn: olcDatabase={2}mdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: FALSE - Ejecuta el siguiente comando en el servidor de espera:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif