Après l'installation

Une fois l'installation d'Edge réussie, vous pouvez effectuer certaines tâches courantes pour valider l'installation, ajuster vos paramètres et personnaliser votre configuration. Ces tâches incluent les suivantes :

Notez qu'il ne s'agit que de quelques-unes des tâches les plus courantes que vous effectuez généralement après avoir installé Edge. Pour connaître les autres opérations et tâches d'administration, consultez Configurer Edge et Opérations.

Appeler des commandes sur les composants Edge

Edge installe des utilitaires de gestion sous /opt/apigee/apigee-service/bin que vous pouvez utiliser pour gérer une installation Edge. Par exemple, vous pouvez utiliser l'utilitaire apigee-all pour démarrer, arrêter, redémarrer ou déterminer l'état de tous les composants Edge sur le nœud :

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

Utilisez l'utilitaire apigee-service pour contrôler et configurer des composants individuels. L'utilitaire apigee-service se présente comme suit :

/opt/apigee/apigee-service/bin/apigee-service component_name action

Où component_name identifie le composant. Le composant doit se trouver sur le nœud sur lequel vous exécutez apigee-service. En fonction de votre configuration, les valeurs de component_name peuvent inclure les suivantes :

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (base de données PostgreSQL)
• apigee-qpidd (Qpidd)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (serveur de gestion)
• edge-management-ui (nouvelle UI Edge)
• edge-message-processor (processeur de messages)
• edge-postgres-server (serveur Postgres)
• edge-qpid-server (serveur Qpid)
• edge-router (routeur Edge)

En plus de ces composants, vous pouvez également appeler apigee-service sur les apigee-provision et apigee-validate composants en fonction de votre configuration.

Par exemple, pour redémarrer le routeur Edge, exécutez la commande suivante :

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

Vous pouvez déterminer la liste des composants installés sur le nœud en examinant le /opt/apigee répertoire. Ce répertoire contient un sous-répertoire pour chaque composant Edge installé sur le nœud. Chaque sous-répertoire est précédé de :

• apigee : composant tiers utilisé par Edge. Par exemple, apigee-cassandra.
• edge : composant Edge d'Apigee. Par exemple, edge-management-server.
• edge-mint : composant de monétisation. Par exemple edge-mint-management-server.

La liste complète des actions pour un composant dépend du composant lui-même, mais tous les composants sont compatibles avec les actions suivantes :

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

Configurer les composants Edge

Pour configurer Edge après l'installation, vous utilisez une combinaison de .properties fichiers et d'utilitaires Edge. Par exemple, pour configurer TLS/SSL dans la nouvelle interface utilisateur Edge, vous modifiez .properties fichiers afin de définir les propriétés nécessaires. Les modifications apportées aux fichiers .properties nécessitent le redémarrage du composant Edge concerné.

Les fichiers .properties se trouvent dans le /opt/apigee/customer/application répertoire. Chaque composant possède son propre fichier .properties dans ce répertoire. Par exemple, router.properties et management-server.properties.

Pour définir une propriété pour un composant, modifiez le fichier .properties correspondant, et puis redémarrez le composant :

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

Exemple :

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

Lorsque vous mettez à jour Edge, les .properties fichiers dans le /opt/apigee/customer/application répertoire sont lus. Cela signifie que la mise à jour conserve toutes les propriétés que vous avez définies sur le composant.

Pour en savoir plus sur la configuration d'Edge, consultez Configurer Edge.

Installer apigee-monit sur le nœud

Une fois l'installation des composants sur un nœud terminée, vous pouvez éventuellement ajouter l'utilitaire apigee-monit. apigee-monit surveille les composants du nœud et tente de les redémarrer en cas d'échec. Pour en savoir plus, consultez la section Auto-réparation avec apigee-monit.

Configurer un serveur SymasLDAP en lecture seule

Si votre installation Edge contient un serveur SymasLDAP qui n'a pas besoin de recevoir de trafic, nous vous recommandons de le configurer en lecture seule. Pour ce faire :

1. Créez un fichier mark_readonly.ldif sur le serveur avec les lignes suivantes :

   dn: olcDatabase={2}mdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: TRUE

2. Exécutez la commande suivante sur le serveur pour le marquer en lecture seule :

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

En cas de défaillance du serveur principal, vous pouvez revenir au serveur de secours en tant que serveur principal comme suit :

1. Créez un fichier mark_writable.ldif sur le serveur de secours avec la ligne suivante :

     dn: olcDatabase={2}mdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: FALSE

2. Exécutez la commande suivante sur le serveur de secours :

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif