ArcGIS Data StoreCommandes REST

Lorsque vous configurez ArcGIS Data Store, vous l’associez au site GIS Server qui joue le rôle de serveur d’hébergement de votre portail. Les actions qui permettent de modifier ou de vérifier l’état du répertoire de données sont exécutées à partir du répertoire administrateur d'ArcGIS Server. (Le format de l'URL est https://gisserver.domain.com:6443/arcgis/admin.) Vous pouvez également retirer une machine de secours d’un répertoire de données relationnelles et du site GIS Server dans le répertoire administrateur d’ArcGIS Server. Les sections suivantes récapitulent ces opérations et sont liées à la documentation sur l'API ArcGIS.

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

• Répertoire de données relationnelles : data > items > enterpriseDatabases > <nom du répertoire de données> > machines > <nom de la machine>
• Stockage de Big Data spatio-temporelles : données > éléments > nosqlDatabases > AGSDataStore_bigdata_<nom du stockage des données> > machines > <nom de la machine>
• Stockage des données du cache de tuiles : données > éléments > nosqlDatabases > AGSDataStore_nosql_<nom du stockage des données> > 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 une machine de secours de répertoire de données relationnelles comme machine principale.

L’arrêt de la machine du répertoire de données relationnelles principale n’entraîne pas le basculement du répertoire de données 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 répertoire de données 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 d'ArcGIS Server du serveur d’hébergement en tant qu'administrateur du site ArcGIS Server et accédez à une machine spécifique pour utiliser une des commandes suivantes afin de modifier le statut d'une machine du répertoire de données :

• stop
• démarrer
• makePrimary (machines de secours du répertoire de données relationnelles uniquement)

Valider le stockage des données

Vous pouvez vérifier l'état des machines du stockage des données à l'aide de la commande REST validateArcGIS Server d'ArcGIS Server.

Connectez-vous au répertoire administrateur d’ArcGIS Server en tant qu’administrateur du site ArcGIS Server, accédez à l’une des machines dans le type de répertoire de données à vérifier et cliquez sur validate pour afficher les informations relatives à ce répertoire de données. 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.

  Pour les stockages de Big Data spatio-temporelles, 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 stockage de Big Data spatio-temporelles sont inaccessibles. Si vous disposez d’un stockage de Big Data spatio-temporelles à plusieurs machines et qu’un statut jaune apparaît, confirmez que toutes les machines sont encore disponibles en validant chacune d’entre elles. Si elles sont disponibles, attendez plusieurs heures puis vérifiez à nouveau. Si le statut est toujours jaune, recherchez des erreurs dans les journaux d’ArcGIS Server.
  • rouge : certaines données ou toutes sont inaccessibles. Examinez les journaux et corrigez les erreurs.

• role (rôle) : s’applique uniquement aux machines d’un répertoire de données relationnelles 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 répertoire de données pour confirmer qu’une machine a été démarrée ou arrêtée ou que la machine de secours est désormais une machine principale après l’exécution de la commande makePrimary, pour identifier l’état de haute disponibilité du répertoire de données du cache de tuiles ou pour procéder à un dépannage initial s’il est impossible de publier des couches d’entités ou de scènes hébergées ou d’y accéder, ou si vous ne pouvez pas exécuter Outils GeoAnalytics.

Supprimer une machine de secours

Vous pouvez retirer une machine de secours d’un répertoire de données relationnelles à l’aide de la commande REST remove d'ArcGIS Server. Par exemple, si vous souhaitez utiliser un autre ordinateur comme machine de secours, vous pouvez supprimer l'ancienne machine de secours du stockage des données, installer ArcGIS Data Store sur la nouvelle machine et configurer la nouvelle machine comme machine de secours.

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