Après l'installation

Après une installation réussie d'Edge, vous pouvez effectuer certaines tâches courantes effectuer pour valider l'installation, ajuster vos paramètres et personnaliser votre configuration. Ces tâches comprennent:

Tâche Description
Appeler des commandes sur les composants Edge Utiliser l'utilitaire apigee-service pour démarrer, arrêter, redémarrer et obtenir l'état de chaque composant Edge.
Configurer les composants Edge Utilisez les fichiers de propriétés pour modifier les paramètres par défaut du composant Edge.
Exécuter apigee-validate Appelez les scripts de test pour vérifier que votre installation de chaque composant s'est déroulé correctement.
Régler les paramètres du tas de mémoire JVM Optimisez vos paramètres de mémoire Java pour chaque nœud.
Gérer la règle de mot de passe LDAP Modifier le mot de passe LDAP par défaut et configurer les différents paramètres d'authentification
Installer apigee-monit sur le nœud Installer et utiliser un outil qui surveille les composants sur le nœud les redémarrer en cas d'échec.
Modifier le mot de passe PostgreSQL par défaut Apigee vous recommande de modifier le mot de passe PostgreSQL par défaut après l'installation Edge pour Private Cloud afin de maintenir la sécurité de vos données.
Configurer une ou plusieurs tâches de suppression définitive PostgreSQL Éliminez les données excédentaires collectées par le service d'analyse.
Configurer la réparation de l'outil de nœud Cassandra Effectuez des opérations de maintenance périodiques sur l'anneau Cassandra pour vous assurer la cohérence entre tous les nœuds.
Activer le démarrage automatique Demandez à Edge pour Private Cloud de redémarrer automatiquement lors d'un redémarrage.
Installer la nouvelle interface utilisateur Edge Apigee recommande d'installer la nouvelle interface utilisateur Edge, qui est une interface utilisateur améliorée destinée aux développeurs et aux administrateurs d'Apigee Edge pour Private Cloud.

Notez que ce ne sont là que quelques-unes des tâches les plus courantes que vous effectuez généralement après l'installation Périphérie. Pour d'autres opérations et tâches d'administration, consultez la page Comment configurer Edge et Opérations :

Appeler des commandes sur les composants Edge

Des utilitaires de gestion des installations Edge 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 du nœud:

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

Utiliser 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 que vous exécutez apigee-service. Selon votre configuration, les valeurs de component_name peut 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 le 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 Répertoire /opt/apigee. Ce répertoire contient un sous-répertoire pour chaque Edge installé sur le nœud. Le préfixe de chaque sous-répertoire est le suivant:

  • 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. Exemple : edge-mint-management-server

La liste complète des actions disponibles pour un composant dépend de celui-ci, mais 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 fichiers .properties et Edge. Par exemple, pour configurer TLS/SSL sur l'interface utilisateur Edge, vous devez modifier .properties pour définir les propriétés nécessaires. Modifications apportées à .properties nécessitent que vous redémarriez le composant Edge concerné.

Le fichier .properties se trouve 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 la propriété d'un composant, modifiez le fichier .properties correspondant, puis : Redémarrez ensuite 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 /opt/apigee/customer/application sont lus. Cela signifie que la mise à jour conserve les propriétés définies pour le composant.

Consultez Comment configurer Edge pour plus d'informations sur Configuration périphérique

Installer apigee-monit sur le nœud

Après avoir installé les composants sur un nœud, vous pouvez éventuellement ajouter le apigee-monit utilitaire. apigee-monit surveillera les composants du nœud et tentera de les redémarrer en cas d'échec. Pour en savoir plus, consultez la section Autoréparation avec apigee-monit.

Configurer un serveur OpenLDAP en lecture seule

Si votre installation Edge contient un serveur OpenLDAP qui n'a pas besoin d'avoir du trafic que vous y ayez basculé, nous vous recommandons de le configurer pour qu'il soit en lecture seule. Procédez comme suit :

  1. Créez un fichier mark_readonly.ldif sur le serveur avec les lignes suivantes: 
    dn: olcDatabase={2}bdb,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 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}bdb,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