Après l'installation

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

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 d'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 sous la forme suivante :

/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. Selon votre configuration, les valeurs de component_name peuvent inclure :

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (base de données PostgreSQL)
• apigee-qpidd (Qpidd)
• apigee-sso (authentification unique Edge)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (serveur de gestion)
• edge-management-ui (nouvelle interface utilisateur de périphérie)
• edge-message-processor (processeur de messages)
• edge-postgres-server (serveur Postgres)
• edge-qpid-server (serveur Qpid)
• edge-router (routeur périphérique)
• edge-ui (interface utilisateur classique)

En plus de ces composants, vous pouvez également appeler apigee-service sur les composants apigee-provision et apigee-validate 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 répertoire /opt/apigee. 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 devez utiliser une combinaison de fichiers .properties et d'utilitaires Edge. Par exemple, pour configurer TLS/SSL dans l'interface utilisateur Edge, vous devez modifier les fichiers .properties pour 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 répertoire /opt/apigee/customer/application. 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, 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 fichiers .properties du répertoire /opt/apigee/customer/application 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 que vous avez terminé d'installer des composants sur un nœud, vous pouvez éventuellement ajouter l'utilitaire apigee-monit. apigee-monit surveillera les composants du nœud et tentera de les redémarrer en cas d'échec. Pour en savoir plus, consultez Réparation automatique avec apigee-monit.

Configurer un serveur SymasLDAP en lecture seule

Si votre installation Edge contient un serveur SymasLDAP qui n'a pas besoin de voir son trafic redirigé, nous vous recommandons de configurer le serveur 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 à l'utilisation du serveur de secours comme serveur principal en procédant 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