Commandes REST de ArcGIS Data Store

Lorsque vous configurez ArcGIS Data Store, vous l’associez au site GIS Server qui fait office de serveur d’hébergement pour votre portail. Les actions qui permettent de modifier ou de vérifier le statut du data store sont effectuées à partir du répertoire administrateur de ArcGIS Server du serveur d’hébergement en tant qu’administrateur ArcGIS Server. (Le format d’URL est https://gisserver.domain.com:6443/arcgis/admin.) Vous pouvez également supprimer une machine de secours d’un data store relationnel ou d’un data store de cache tuilé exécuté en mode principal-secours et supprimer la machine de secours du site GIS Server dans le répertoire administrateur ArcGIS Server. Les sections suivantes récapitulent ces opérations et sont liées à la documentation sur l'API ArcGIS.

Si vous n’êtes pas l’administrateur de ArcGIS Server pour le serveur d’hébergement, vous devrez collaborer avec la personne concernée pour réaliser les tâches décrites dans cette rubrique.

Voici les chemins d’accès que vous devez suivre dans le répertoire administrateur de ArcGIS Server afin d’accéder aux opérations pour chaque type de data store :

• Data store relationnel - Cliquez sur data (données) > items (éléments) > enterpriseDatabases > <nom du data store> > machines > <nom de la machine>.
• Spatiotemporal Big Data Store - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_bigdata_<nom du data store> > machines > <nom de la machine>.
• Data store de cache tuilé - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_nosql_<nom du stockage des données> > machines > <nom de la machine>.
• Base de graphiques - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_graph_<nom du data store> > machines > <nom de la machine>.

Modifier l'état d'une machine de stockage des données

Vous pouvez arrêter et redémarrer des machines individuelles d'un stockage des données. Vous pouvez également promouvoir, en mode principal-secours, une machine de secours de data store relationnel ou de cache tuilé en tant que machine principale.

L’arrêt de la machine principale de data store n’entraîne pas le basculement du data store sur un déploiement sur site, car vous ne souhaitez pas nécessairement effectuer un basculement si vous réalisez une tâche de maintenance, par exemple si vous placez temporairement le data store hors connexion.

Par exemple, vous modifiez l'état de la machine du stockage des données dans le cadre du scénario de mise à niveau suivant :

• Arrêtez la machine de secours.
• Mettez à niveau la machine de secours.
• Démarrez la machine de secours.
• Utilisez la commande makePrimary pour promouvoir la machine de secours au niveau de machine principale.
• Arrêtez l'ancienne machine principale.
• Mettez à niveau l'ancienne machine principale.
• Démarrez l'ancienne machine principale.
• Rajoutez l'ancienne machine principale au stockage des données en tant que machine de secours.

Connectez-vous au répertoire administrateur de ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server et accédez à une machine spécifique pour utiliser l’une des commandes suivantes afin de modifier le statut d’une machine de data store :

• stop
• start
• makePrimary (machines de data stores relationnels de secours ou data stores de cache tuilé en mode principal-secours uniquement)

Valider le stockage des données

Vous pouvez vérifier le statut des machines d’un data store à l’aide de la commande REST validate de ArcGIS Server.

Connectez-vous au répertoire administrateur de ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server, accédez à l’une des machines pour le type de data store spécifique que vous voulez vérifier et cliquez sur validate pour voir les informations sur ce data store : Les informations importantes relatives au statut d’un répertoire de données sont les suivantes :

• Overallhealth (intégrité globale) : les valeurs possibles sont Healthy (intègre) ou Unhealthy (Non intègre). Un répertoire de données est considéré comme non intègre si plus de la moitié des machines qui le composent sont inaccessibles ("datastore.overallhealth": "Unhealthy"). Une machine est considérée comme non intègre si elle est inaccessible ("machine.overallhealth": "Unhealthy").
• status (statut) : pour les répertoires de données relationnelles ou du cache de tuiles, les valeurs possibles sont Started (Démarré) ou Stopped (Arrêté). En cas d’arrêt, vous ne pouvez pas publier les couches d’entités hébergées ou les couches de scènes hébergées.
• clusterStatus - Pour les Spatiotemporal Big Data Stores, les statuts sont les suivants :
  • vert : toutes les données sont disponibles.
  • jaune : les données sont disponibles, mais certaines copies de réplica des données ou toutes sont indisponibles et votre stockage de Big Data spatio-temporelles n’est actuellement pas hautement disponible. Ce statut apparaîtra toujours si vous avez configuré un stockage de Big Data spatio-temporelles à une seule machine. Ce statut peut également apparaître si les machines sont en train de rééquilibrer les données ou qu’une ou plusieurs machines de votre Spatiotemporal Big Data Store sont inaccessibles. Si vous disposez d’un Spatiotemporal Big Data Store sur plusieurs machines et qu’un statut jaune apparaît, confirmez que toutes les machines sont encore disponibles en les validant les unes après les autres. Si elles sont disponibles, attendez plusieurs heures puis vérifiez à nouveau. Si le statut est toujours jaune, recherchez la présence d’erreurs dans les journaux ArcGIS Server.
  • rouge : certaines données ou toutes sont inaccessibles. Examinez les journaux et corrigez les erreurs.
• role (rôle) : ceci s’applique aux machines d’un data store relationnel ou d’un data store de cache tuilé en mode principal-secours et indique si la machine est la machine primary (principale) ou standby (de secours).
• Messages : messages d’avertissement et d’erreur liés au statut du répertoire de données. Par exemple, si vous validez un répertoire de données du cache de tuiles à plusieurs machines, vous recevez un message si les données du cache de scène ne sont pas hautement disponibles (en d’autres termes, s’il n’existe qu’une seule copie d’un ou de plusieurs caches de scène).

Vous pouvez valider le data store pour confirmer qu’une machine a été démarrée ou arrêtée, confirmer que la machine de secours a bien la fonction de machine principale après l’exécution de la commande makePrimary. Cela permet aussi d’identifier si le data store de cache tuilé est hautement disponible ou en phase initiale de dépannage s’il est impossible de publier ou d’accéder à des couches d’entités ou de scènes hébergées ou si vous ne pouvez pas exécuter GeoAnalytics Tools.

Supprimer une machine de secours

Vous pouvez supprimer une machine de secours d’un data store relationnel ou d’un data store de cache tuilé en mode principal-secours à l’aide de la commande REST remove de ArcGIS Server. Par exemple, si vous souhaitez utiliser un autre ordinateur comme machine de secours, vous pouvez supprimer l’ancienne machine de secours du data store, installer ArcGIS Data Store sur la nouvelle machine et configurer la nouvelle machine comme machine de secours.

Connectez-vous au répertoire administrateur de ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server pour utiliser la commande remove.