Référence des utilitaires de commande ArcGIS Data Store

Les utilitaires de commande sont installés avec ArcGIS Data Store pour permettre à l'administrateur du stockage des données de gérer ce dernier. Cette rubrique décrit les utilitaires et fournit des syntaxes et des exemples.

Tous les utilitaires doivent être exécutés sur la machine ArcGIS Data Store. Vous trouverez ces utilitaires dans le répertoire <ArcGIS Data Store installation directory>/datastore/tools.

Vous pouvez taper le nom d'un utilitaire, suivi de --help pour obtenir de l'aide sur la syntaxe.

allowconnection

Pour des raisons de sécurité, toutes les connexions au stockage des données se font via le site ArcGIS server par défaut. Si vous voulez que le stockage des données relationnelles soit accessible à partir d'une autre machine, vous pouvez utiliser l'utilitaire de commande allowconnection.

L'utilitaire allowconnection peut uniquement être exécuté sur la machine de stockage des données relationnelles principale.

Syntaxe

allowconnection <host name> <user name> [<database>]

Indiquez le nom de l'ordinateur que vous souhaitez autoriser à se connecter au stockage des données relationnelles (nom d'hôte) et l'un des comptes de base de données utilisés par le stockage des données (nom d'utilisateur) : administrateur du stockage des données, propriétaire du réplica, administrateur de géodatabase ou utilisateur géré (utilisateur qui publie les données des couches d'entités), que vous pouvez obtenir à l'aide de l'utilitaire listadminusers ou listmanageduser. Vous pouvez également indiquer le nom de la base de données du stockage des données, mais étant donné qu'une seule base de données stocke les données de la couche d'entités hébergée, cette valeur est facultative.

Exemple

Dans cet exemple, les connexions sont autorisées depuis l'ordinateur workcom vers le stockage des données relationnelles lorsqu'elles sont faites via l'utilisateur géré hqo.n_1E7.

./allowconnection.sh workcom hqo.n_1E7

backupdatastore

Si vous devez créer une sauvegarde du stockage des données relationnelles entre les heures de sauvegarde planifiées, exécutez l'utilitaire backupdatastore. Vous pouvez créer manuellement une sauvegarde complète avant de mettre le stockage des données à niveau ou avant de lui apporter de nombreuses modifications.

L'utilitaire backupdatastore peut uniquement être exécuté sur la machine de stockage des données principale. Backupdatastore génère une sauvegarde d'un stockage des données relationnelles uniquement.

Syntaxe

backupdatastore <backup name>

Exemple

Dans cet exemple, un fichier de sauvegarde complet appelé project1bu est créé dans l'emplacement de sauvegarde que vous avez spécifié pour le stockage des données à l'aide de l'utilitaire changebackuplocation.

./backupdatastore.sh project1bu
You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

changebackuplocation

Par défaut, les fichiers de sauvegarde du stockage des données sont stockés sur la même machine que le stockage des données. Vous devez déplacer vos fichiers de sauvegarde sur une autre machine afin de pouvoir y accéder si le stockage des données est inaccessible.

Assurez-vous que la connexion qui exécute l'utilitaire changebackuplocation dispose des autorisations de lecture/écriture sur le répertoire partagé.

L'utilitaire changebackuplocation s'applique uniquement aux sauvegardes créées pour un stockage des données relationnelles.

Syntaxe

changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]

Spécifiez --is-shared-folder true si l'emplacement de sauvegarde se trouve sur une machine réseau partagée. Si vous voulez que les fichiers de sauvegarde existants soient déplacés vers le nouvel emplacement, spécifiez --keep-old-backups true.

Exemple

Dans cet exemple, les sauvegardes sont créées dans le répertoire ds_backups partagé de la machine sysshare. Toute sauvegarde existant dans le répertoire de sauvegarde actuel est déplacée vers ce nouvel emplacement.

./changebackuplocation.sh /net/sysshare/ds_backups --is-shared-folder true --keep-old-backups true
You are going to change the data store backup directory.
Do you want to continue (Yes or No)?Yes

changedbproperties

L'utilitaire changedbproperties vous permet de modifier différentes propriétés, selon le type de stockage des données sur lequel vous l'exécutez. Par défaut, le stockage des données relationnelles accepte jusqu'à 150 connexions. Vous pouvez utiliser la propriété --max-connections avec l'utilitaire changedbproperties pour modifier le nombre maximum de connexions autorisées. Lorsque vous déterminez le nombre de connexions requises par votre stockage des données, sachez que les processus internes d'ArcGIS Data Store peuvent utiliser jusqu'à cinq connexions. Tenez également compte du nombre de connexions simultanées que votre machine ArcGIS Data Store peut accepter tout en restant performante. Si la machine exécutant ArcGIS Data Store ne dispose pas d'une mémoire importante, vous pouvez être amené à réduire le nombre de connexions autorisées.

Lorsque vous changez le nombre maximum de connexions autorisées, ce nombre change à la fois sur la machine de stockage des données principale et sur celle de secours.

Syntaxe

changedbproperties --store <relational | tileCache | spatiotemporal> [configuration option]

Options de configuration possibles.

• max-connections : utilisez ce paramètre pour indiquer le nombre maximum de connexions autorisées vers un stockage des données relationnelles. Le nombre spécifié ne peut pas être inférieur à 10. Ce paramètre n'est pas pris en charge pour le stockage de Big Data spatio-temporelles ou le stockage du cache de tuiles.
• heap-size : utilisez ce paramètre pour modifier la quantité de mémoire du segment utilisée par un stockage de Big Data spatio-temporelles. Par défaut, ce type de stockage des données utilise au démarrage la moitié de la RAM disponible. Ce paramètre n'est pas pris en charge pour le stockage des données relationnelles ou du cache de tuiles.
• reallocation : par défaut, ce paramètre est défini sur True (vrai), ce qui signifie que les données dans un stockage de Big Data spatio-temporelles vont distribuer des données à d'autres partitions, si une partition est indisponible. Si vous devez effectuer une maintenance sur une partition, par exemple la mettre à niveau, vous pouvez temporairement désactiver la réallocation en définissant ce paramètre sur False (faux). La réallocation est interrompue pendant la durée définie pour le paramètre max-allocation-off. Ce paramètre s'applique uniquement au stockage de Big Data spatio-temporelles.
• max-allocation-off : la configuration de ce paramètre a lieu lorsque vous désactivez le paramètre reallocation. Par défaut, max-allocation-off est défini sur 60 minutes. En d'autres termes, si vous désactivez temporairement la réallocation, elle redémarre au bout de 60 minutes. Si vous avez besoin de plus ou moins de temps pour réaliser la tâche de maintenance pour laquelle vous avez interrompu la réallocation, modifiez le paramètre temporel de max-allocation-off. Ce paramètre s'applique uniquement au stockage de Big Data spatio-temporelles.
• prompt : lorsque vous exécutez cet utilitaire, vous êtes invité à confirmer l'action spécifiée. Si vous automatisez l'utilisation de cet utilitaire, définissez le paramètre d'invite sur False (faux). Sinon, le script ne continue que si vous répondez à l'invite.

Exemple

Dans cet exemple, le nombre maximum de connexions autorisées dans un stockage des données relationnelles est défini sur 100 :

./changedbproperties.sh --store relational --max-connections 100
You are changing the following database properties:
         max number of connections to 100 (on all data store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

changeloglocation

Si vous ne voulez pas que le stockage des données utilise l'emplacement du fichier journal d'erreur par défaut <ArcGIS Data Store installation directory>\arcgisdatastore\logs, vous pouvez exécuter l'utilitaire changeloglocation pour créer les fichiers journaux d'erreurs dans un autre répertoire.

Syntaxe

changeloglocation <directory path>

Exemple

Dans cet exemple, les fichiers journaux sont créés dans le répertoire local, ../datastorefiles/logs.

./changeloglocation.sh '../datastorefiles/logs'

changenosqldslocation

Le stockage des données du cache de tuiles peut devenir volumineux si vous stockez de nombreuses tuiles haute résolution à l'intérieur. Dans ce cas, vous pouvez décider de déplacer les données vers un autre lecteur sur le même serveur ou vers un emplacement partagé sur un autre serveur.

Si vous déplacez les données vers un répertoire partagé, vous devez accorder des autorisations de lecture et d'écriture sur ce répertoire à l'utilisateur qui exécute le processus ArcGIS Data Store (Linux) ou le service (Windows).

changenosqldslocation <path> [--prompt {yes | no}]

Dans cet exemple, les bases de données qui stockent des caches de couches de scènes sont déplacées vers un répertoire partagé intitulé dstorecache sur la machine server2.

changenosqldslocation /net/server2/dstorecache

changepassword

ArcGIS Data Store génère au hasard des noms d'utilisateur et des mots de passe pour les comptes de base de données utilisés pour le stockage des données relationnelles. Si vous devez définir vos propres mots de passe sur votre site, obtenez les mots de passe des comptes de stockage des données et exécutez changepassword pour réinitialiser les mots de passe.

Faites appel à l'utilitaire listadminusers pour obtenir les noms d'utilisateur et les mots de passe des administrateurs et à l'utilitaire listmanageduser pour obtenir le nom d'utilisateur et le mot de passe du propriétaire des données d'entité.

L'utilitaire changepassword peut uniquement être exécuté sur la machine principale de stockage des données relationnelles.

Syntaxe

changepassword <user name> <new password> [--prompt {yes | no}]

Astuce:

Pour rédiger un script de modification de mot de passe, incluez un drapeau pour supprimer l'invite de confirmation, comme l'indique l'exemple suivant :

changepassword gwi_n2Te0 Phfl4mp! --prompt no

Exemple

Dans cet exemple, le mot de passe est changé pour l'utilisateur gwi_n2Te0 et devient Phfl4mp!.

./changepassword.sh gwi_n2Te0 Phfl4mp!
You are going to change the password for user gwi_n2Te0.
Do you want to continue (Yes or No)?Yes

changestaginglocation

Lorsque vous restaurez les données de vos couches d'entités, ArcGIS Data Store extrait les fichiers de sauvegarde compressés dans un dossier intermédiaire. Cela signifie que vous devez disposer d'un dossier intermédiaire pouvant accueillir ces données décompressées. Si votre stockage des données contient beaucoup de données, vous pouvez configurer un dossier intermédiaire distinct destiné à la récupération du stockage des données relationnelles.

Syntaxe

changestaginglocation <directory path>

Exemple

Dans cet exemple, le dossier intermédiaire désigné est /net/sanmarcos/stage.

./changestaginglocation.sh /net/sanmarcos/stage

configuredatastore

Après avoir installé ArcGIS Data Store, vous pouvez exécuter l'utilitaire configuredatastore pour créer un stockage des données et l'inscrire auprès d'un site ArcGIS Server. Vous pouvez créer les types suivants de stockage des données à l'aide de cette commande :

• Un stockage des données pour les données de couches d'entités hébergées (relationnelles).
• Un stockage des données pour les caches de tuiles de couches de scènes hébergées (cache de tuiles)
• Un stockage des données pour les données d'observation archivées (spatio-temporelles)

Lorsque vous publiez une couche d'entités hébergée, ArcGIS crée une couche d'entités hébergée, une couche de scènes hébergée et un cache de scènes. A cet effet, ArcGIS Data Store crée à la fois un stockage des données relationnelles et un stockage des données pour les caches de tuiles de scène. Si vous préférez utiliser votre base de données gérée de serveur SIG pour stocker les données de la couche d'entités hébergée, l'utilitaire configuredatastore vous permet de créer uniquement un stockage des données des caches de tuiles de scène.

Remarque :

N'oubliez pas que si vous utilisez votre propre base de données gérée pour les données de la couche d'entités hébergée, vous ne pouvez pas utiliser les outils ArcGIS Data Store pour administrer la base de données. En d'autres termes, vous gérez les utilisateurs et les sauvegardes à l'aide des outils disponibles avec votre SGBD. Vous ne pouvez pas bénéficier de la fonctionnalité haute disponibilité accessible via ArcGIS Data Store.

Syntaxe

configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> 
<data directory> [--stores <relational | tileCache | spatiotemporal>] [--nosql-only true|false]

L'URL d'administration ArcGIS server est au format https://gisserver.domain.com:6443/arcgis. Même si votre site ArcGIS Server utilise un adaptateur Web, indiquez l'URL au format indiqué ci-dessus.

Indiquez le nom d'utilisateur et le mot de passe d'un utilisateur intégré (et non entreprise) disposant des privilèges d'administrateur dans ArcGIS server.

Le répertoire de données est l'emplacement sur la machine locale où vous souhaitez que les fichiers du stockage des données soient créés.

Configurer un type spécifique de stockage des données

Vous pouvez configurer une instance ArcGIS Data Store pour les données de la couche d'entités hébergée en spécifiant relational avec l'opération --stores. Cette configuration prépare également le stockage des données pour les caches de tuiles de couches de scènes hébergées.

Si vous voulez utiliser votre propre base de données gérée en tant que stockage des données pour les données de la couche d'entités hébergée, mais que vous voulez publier des couches de scène hébergées, spécifiez tileCache avec l'opération --stores. Cela permet d'inscrire uniquement le stockage des données utilisé pour les tuiles mises en cache de la couche de scènes et ne génère pas de stockage des données pour les données de la couche d'entités.

Héritage :

Dans les versions précédentes, vous définissiez l'opération --nosql-only sur true pour créer un stockage des données uniquement pour les tuiles mises en cache de la couche de scènes. Cette opération demeure présente afin que les scripts existants continuent à fonctionner. A l'avenir, définissez plutôt l'opération --stores sur tileCache.

Si vous utilisez l'ArcGIS GeoEvent Extension for Server et souhaitez stocker un volume important de données d'observation de vitesse élevée, spécifiez spatiotemporal avec l'opération --stores. N'utilisez pas l'assistant de configuration ArcGIS Data Store pour configurer un stockage de Big Data spatio-temporelles. Fermez l'assistant dès qu'il s'ouvre après l'installation d'ArcGIS Data Store. Vous pouvez créer à la fois un stockage des données relationnelles et un stockage de Big Data spatio-temporelles sur la même machine en spécifiant relational,spatiotemporal avec l'opération --stores. Toutefois, il n'est pas recommandé d'exécuter les deux sur la même machine, car ils entrent en concurrence en ce qui concerne l'utilisation de la mémoire et d'autres ressources.

Reportez-vous à l'aide ArcGIS GeoEvent Extension for Server pour plus d'informations sur l'utilisation du stockage de Big Data spatio-temporelles.

Exemple

Dans cet exemple, un stockage des données pour les données de couches d'entités hébergées (stockage des données relationnelles) est créé. L'URL de l'instance ArcGIS Server qui va utiliser le stockage des données est https://dataserver.mydomain.com:6443/arcgis, le nom d'utilisateur et le mot de passe de l'administrateur du site sont respectivement admin et Iph33l$ik, et le répertoire des données pour le stockage des données est /dstore/data.

./configuredatastore.sh https://dataserver.mydomain.com:6443/ admin admin Iph33l$ik /dstore/data --stores relational

deletebackup

L'utilitaire deletebackup vous permet de supprimer les fichiers de sauvegarde que vous avez créés pour le stockage des données relationnelles. Commencez par exécuter l'utilitaire listbackups pour voir les noms et les heures de création de vos sauvegardes manuelles. Vous pouvez ensuite exécuter l'utilitaire deletebackup pour supprimer la sauvegarde manuelle dont vous n'avez plus besoin.

Notez que vous pouvez uniquement supprimer les sauvegardes non requises pour récupérer votre stockage des données. Ainsi, vous ne pouvez pas supprimer la sauvegarde complète la plus récente du stockage des données relationnelles.

Syntaxe

deletebackup <backup name>

Exemple

./deletebackup.sh featuresMarchbu You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible.
Do you wish to continue (Yes or No)?yes
Operation completed successfully

describedatastore

L'utilitaire describedatastore vous permet d'afficher les informations suivantes sur une installation ArcGIS Data Store :

• Les emplacements des sauvegardes, des fichiers journaux, des dossiers intermédiaires et des données des caches de tuiles de scène
• Si l'emplacement de sauvegarde se trouve sur un partage réseau
• La fréquence de création d'une sauvegarde complète du stockage des données relationnelles (planning de sauvegarde)
• Le nombre de jours où les fichiers de sauvegarde sont conservés
• Si le stockage des données est exécuté ou non (statut du stockage des données)
• La date et l'heure auxquelles le stockage des données de secours est devenu le stockage de données principal (dernier basculement) ; ne s'affiche pas si aucun basculement n'a eu lieu
• Les noms des machines principale et de secours (le cas échéant) qui participent au stockage des données (machines membres)
• Le nombre maximum de connexions autorisées au stockage des données relationnelles
• L'URL du site ArcGIS server auprès duquel le stockage des données est enregistré (URL système propriétaire)
• L'URL du portail qui utilise le site ArcGIS server comme serveur d'hébergement (URL du portail)
• Le nombre de connexions actuelles de couches d'entités au stockage des données
• L'espace disque restant sur la machine du stockage des données

Syntaxe

describedatastore

Exemple

./describedatastore.sh
Information of ArcGIS DataStore sthiu0_5T
================================================
Backup location.........../net/nwshare/dsbackups Is backup folder shared...true Staging location........../arcgis/datastore/staging Tile cache location......./arcgis/datastore/nosqldata Log location............../arcgis/datastore/logs Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31 Data store status.........Started Last failover.............20150130190334005 Member machines...........DSPPRIMARY.DOMAIN.COM Maximum connections.......150 Owning system URL.........https://gisserver_webadaptor.esri.com/arcgis Portal for ArcGIS URL.....https://portal_webadaptor.esri.com/arcgis Number of connections.....8
Free disk space...........174.00GB

exportmanageddb

L'utilitaire exportmanageddb crée un fichier de vidage de la base de données qui stocke les données des couches d'entités hébergées, les métadonnées concernant le stockage des données et toutes les bases de données qui stockent les caches des couches de scènes hébergées. Exportez le stockage des données si vous avez besoin d'effectuer une sauvegarde du stockage des données à restaurer sur une installation ArcGIS Data Store se trouvant sur une machine possédant un système d'exploitation différent ou d'une version différente d'ArcGIS Data Store.

Veillez à ce que personne ne modifie des couches d'entités, ni ne publie des éléments sur votre portail avant que vous n'importiez le stockage des données sur la nouvelle machine. Vérifiez également que l'emplacement dans lequel vous exportez le stockage des données comporte un espace de stockage suffisant pour le fichier de vidage de la base de données des couches d'entités hébergées et les copies de toutes vos bases de données des caches des couches de scènes hébergées.

L'utilitaire exportmanageddb n'exporte pas de stockage de Big Data spatio-temporelles.

Syntaxe

exportmanageddb <backup name> --destination <output location> [--include-tilecache <true|false>] [--prompt {yes|no}]

Si vous ne spécifiez pas l'option --destination et l'emplacement en sortie, un répertoire intitulé dbdump est créé (s'il n'existe pas déjà) dans l'emplacement de sauvegarde par défaut du stockage des données, et les fichiers d'exportation sont placés dans un nouveau répertoire de cet emplacement. Par exemple, si le répertoire de sauvegarde par défaut du stockage des données est /net/sysshare/ds_backups et que vous spécifiez dsexp1 en tant que nom pour la sauvegarde mais que vous ne spécifiez pas d'emplacement en sortie, le stockage des données relationnelles exporté, le stockage des données du cache de tuiles et les fichiers associés sont placés dans l'emplacement suivant : /net/sysshare/ds_backups/dbdump/dsexp1.

Faites appel à l'opération include-tilecache pour indiquer si toutes les bases de données des caches de tuiles des couches de scènes hébergées doivent être intégrées ou non dans l'exportation. Par défaut, ces bases de données sont incluses. Vous pouvez exclure ces bases de données de l'exportation (--include-tilecache false) si vous les avez intégrées lors de la dernière exportation que vous avez réalisée et que vous savez qu'aucune couche de scènes hébergée supplémentaire n'a été publiée sur votre portail depuis.

Exemple

Dans l'exemple suivant, le fichier de vidage, les copies des bases de données des caches des couches de scènes hébergées et les fichiers du stockage des données associés sont générés dans un répertoire réseau partagé intitulé preupgradeexp sur un serveur intitulé backupserver. Comme l'opération include-tilecache n'est pas indiquée dans cet exemple, toutes les bases de données des caches de tuiles des couches de scènes hébergées sont intégrées dans l'exportation.

./exportmanageddb.sh preupgradeexp --destination /net/backupserver
You are attempting to back up database 'db_e3hsm'. This could take a long time, depending on the size of your data. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

importmanageddb

Si vous avez exporté un ArcGIS Data Store contenant une couche d'entités hébergée ou des bases de données des caches des couches de scènes hébergées (ou les deux), vous pouvez utiliser l'utilitaire importmanageddb pour restaurer le stockage des données. Vous pouvez le restaurer sur une machine ArcGIS Data Store mise à niveau ou sur une installation ArcGIS Data Store sur une machine possédant un système d'exploitation différent de celui de l'instance ArcGIS Data Store source.

Si vous souhaitez inscrire ArcGIS Data Store auprès du même site ArcGIS Server qu'auparavant, indiquez --bound true et ne spécifiez pas --server-url. Notez que l'option --bound est définie sur True (vrai) par défaut. N'oubliez pas de redémarrer le site ArcGIS Server avant de procéder à la restauration.

Si vous effectuez la restauration et souhaitez inscrire le stockage des données auprès d'un nouveau site ArcGIS Server, spécifiez --server-url lorsque vous importez le stockage des données.

Par défaut, le stockage des données relationnelles et toutes les bases de données des caches des couches de scènes hébergées qui constituent le stockage des données du cache de tuiles dans le fichier d'exportation sont importés. Si vous ne souhaitez pas inclure les bases de données des caches de tuiles des couches de scènes hébergées, définissez l'opération --include-tilecache sur False (faux).

L'utilitaire importmanageddb n'importe pas de stockage de Big Data spatio-temporelles.

Syntaxe

importmanageddb <backup name> --source-loc <source backup location> --data-dir <data store data directory> 
--server-admin <user name of ArcGIS Server admin> --server-password <password of ArcGIS Server admin>
[--include-tilecache <true|false>] [--bound {true|false}] [--server-url <ArcGIS Server URL registered with data store>] 
[--prompt {yes|no}]

Exemple

Dans l'exemple suivant, le stockage des données est restauré sur une installation ArcGIS Data Store d'une version plus récente. Le nouveau répertoire de données ArcGIS Data Store est spécifié. Le stockage des données est toujours lié au site ArcGIS Server existant, de sorte que le stockage des données et les couches de scènes et d'entités hébergées existantes continuent de fonctionner. Redémarrez votre site ArcGIS Server pour autoriser les couches de scènes et d'entités hébergées à être publiées sur la nouvelle machine.

./importmanageddb.sh preupgradeexp --source-loc /net/backupserver/dbdump/preupgradeexp --data-dir /usr/arcgis/datastore 
--server-admin siteadmin --server-password SAup.4s --bound true

listadminusers

L'utilitaire listadminusers retourne les noms d'utilisateur et les mots de passe de l'administrateur, du propriétaire du réplica et de l'administrateur de géodatabase d'un stockage des données relationnelles.

Syntaxe

listadminusers

Exemple

./listadminusers.sh
Admin users for ArcGIS Data store ds_abcd1234
=================================================
Database Admin User.... adm_11zyx / tT30!bYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751*pb

listbackups

L'utilitaire listbackups retourne les noms des sauvegardes complètes du stockage des données relationnelles et l'emplacement dans lequel ils sont écrits. Il retourne également le statut des sauvegardes (complètes ou non), leur heure de démarrage et si elles ont été créées manuellement à l'aide de l'utilitaire backupdatastore ou automatiquement par ArcGIS Data Store.

Vous pouvez exécuter listbackups pour voir si une sauvegarde est terminée ou encore en cours, déterminer le nombre de sauvegardes manuelles que vous possédez ou vérifier un nom de fichier avant d'exécuter l'utilitaire deletebackup.

Syntaxe

listbackups

Exemple

./listbackups.sh
Backup_Name                      Status           Backup_Time         Mode
====================================================================================
phase1proj_bu                    BackupComplete   2014-03-08 14:12    manual phase2proj_bu                    BackupComplete   2014-06-21 11:43    manual ds_gdt1oomh-20141103160748082    BackupComplete   2014-11-01 03:00    scheduled
Backups located at: '/net/myserver.ntw.com/dsbackups'

listmanageduser

L'utilitaire listmanageduser retourne le nom d'utilisateur et le mot de passe de l'utilisateur géré du stockage des données relationnelles. L'utilisateur géré est le compte de base de données qui possède les données de la couche d'entités hébergée dans le stockage des données.

Syntaxe

listmanageduser

Exemple

./listmanageduser.sh
Managed users for ArcGIS Data store ds_abcd1234
================================================
UserName     Password             Database
gwi_n2Te0    4cXddhZhve=Y         db_qv5e1

registerdatastore

Le stockage des données conserve les informations relatives aux noms des machines du site ArcGIS server. Si vous déplacez votre site ArcGIS Server sur de nouvelles machines (par exemple, si vous avez acheté du nouveau matériel ou si les machines ArcGIS Server existantes sont défaillantes), vous devez désinscrire le stockage des données d'ArcGIS Server pour supprimer ces informations. Une fois qu'ArcGIS server est installé sur une nouvelle machine, vous pouvez enregistrer le stockage des données auprès du site ArcGIS server à l'aide de l'utilitaire de commande registerdatastore.

Notez que cet utilitaire permet d'enregistrer le stockage des données sur le même site ArcGIS server qu'auparavant. Le stockage des données contient les données des couches hébergées du site ArcGIS Server. Le fait de l'inscrire sur un autre site ArcGIS Server n'entraîne pas une nouvelle création des couches d'entités hébergées, des caches des couches de scènes ou des archives de données des services en mode continu.

L'utilitaire registerdatastore peut uniquement être exécuté sur la machine de stockage des données principale.

Syntaxe

registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password>

Exemple

Dans cet exemple, le stockage des données est réenregistré sur un site ArcGIS server avec l'URL https://gisserver.domain.com:6443/arcgis. Le nom d'utilisateur de l'administrateur du site principal ArcGIS server est agsadmin et le mot de passe Tan$p0n.

./registerdatastore.sh https://gisserver.domain.com:6443/arcgis agsadmin Tan$p0n

removemachine

Faites appel à l'utilitaire removemachine pour supprimer un des éléments suivants dans une installation ArcGIS Data Store :

• Supprimez une machine de secours d'un stockage des données relationnelles. Peut s'exécuter sur une machine de secours ou depuis la machine principale si la machine de secours n'est pas disponible.
• Supprimez une machine de secours d'un stockage des données du cache de tuiles. Peut s'exécuter sur une machine de secours ou depuis la machine principale si la machine de secours n'est pas disponible.
• Supprimez une machine d'un stockage de Big Data spatio-temporelles. Notez que vous ne pouvez pas exécuter removemachine sur un stockage de Big Data spatio-temporelles composé d'une seule machine.

Syntaxe

removemachine <machine name> [--prompt <yes | no>]

Exemple

Dans cet exemple, la machine du stockage de Big Data spatio-temporelles, gefour, est supprimée du stockage des données.

./removemachine.sh gefour

removestandbymachine

Héritage :

Esri déconseille l'utilisation de l'utilitaire removestandbymachine. Il demeure présent pour permettre aux scripts existants de continuer à fonctionner, mais vous devez commencer à utiliser l'utilitaire removemachine à la place.

Vous pouvez utiliser la commande remove de l'API ArcGIS Server REST à partir de l'administrateur du site ArcGIS Server pour supprimer une machine de secours d'un stockage des données relationnelles ou du cache de tuiles. Cependant, si le site ArcGIS Server est indisponible, vous ne pourrez pas vous connecter à l'administrateur du site pour cela. Dans ce cas, exécutez l'utilitaire removestandbymachine pour supprimer une machine de secours du stockage des données.

L'utilitaire removestandbymachine peut uniquement être exécuté sur la machine de secours d'un stockage des données relationnelles et du cache de tuiles.

Syntaxe

removestandbymachine <machine name> [--prompt <yes | no>]

Exemple

Dans cet exemple, la machine de secours s'appelle dsserver2.

./removestandbymachine.sh dsserver2

restoredatastore

Si vous n'avez plus accès aux données utilisées par les couches d'entités hébergées de votre portail, utilisez vos fichiers de sauvegarde et l'utilitaire de commande restoredatastore pour récupérer votre stockage des données.

Si vous ne parvenez pas à récupérer le stockage des données, installez ArcGIS Data Store sur une nouvelle machine et restaurez la sauvegarde la plus récente sur la nouvelle machine.

Si vous voulez récupérer les données à un moment précis du passé, faites la restauration sur le stockage des données existant. Notez que vous ne pouvez restaurer un état précédent que si les fichiers de sauvegarde sont disponibles. Par exemple, si vous conservez les sauvegardes des cinq derniers jours uniquement, vous ne pouvez récupérer le stockage des données qu'à un moment donné de ces cinq jours.

L'utilitaire restoredatastore peut uniquement être exécuté sur la machine ArcGIS Data Store principale. L'utilitaire restoredatastore ne restaure pas les données archivées des services en mode continu (données utilisées dans le stockage de Big Data spatio-temporelles).

Syntaxe

restoredatastore [--target {most-recent | yyyy-mm-dd-hh:mm:ss | <backup file>}] [--source-loc <location of backup files>] 
[--bound <true|false>] [--data-dir <new data store directory>] [--prompt {yes | no}]

Lors de la restauration après un blocage ou pour déplacer le stockage des données, spécifiez --target most-recent. Si vous restaurez les fichiers à un moment précis, indiquez la date et l'heure (UTC) auxquelles vous voulez restaurer le stockage des données. Si vous voulez restaurer un fichier de sauvegarde spécifique, indiquez plutôt son nom. Si vous ne spécifiez pas de cible, la sauvegarde la plus récente est restaurée.

Par défaut, le stockage des données restauré est associé (lié) à son site ArcGIS server. Indiquez seulement --bound false si vous voulez restaurer le stockage des données sans conserver l'association avec le site ArcGIS server du stockage. Vous ne faites ceci qu'en dernier recours si le site ArcGIS Server précédent est perdu et ne peut pas être récupéré. Vous pouvez restaurer le stockage des données non lié et le configurer avec un nouveau site ArcGIS Server fédéré. Cependant, les couches d'entités qui utilisent les données dans le stockage des données n'existent plus. Vous devez alors vous connecter à la base de données du stockage des données pour extraire les données à un autre format, puis les republier sur le portail.

Exemple

Cet exemple permet de restaurer la sauvegarde la plus récente de /net/buserver/data/backups sur /usr/arcgisdatastore. Puisque, par défaut, le stockage des données reste lié au site ArcGIS Server auprès duquel il est inscrit, vous n'êtes pas obligé de spécifier --lié - condition vraie.

./restoredatastore.sh --target most-recent --source-loc /net/buserver/data/backups --data-dir /usr/arcgisdatastore
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Dans cet exemple, le stockage des données est restauré à partir de /net/buserver/data/backups à l'état qui était le sien à 14 h 30 (UTC) le 17 juillet 2014.

./restoredatastore.sh --target 2014-07-17-14:30:00 --source-loc /net/buserver/data/backups
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

revokeconnection

Si vous avez utilisé l'utilitaire allowconnection pour autoriser temporairement un autre client à se connecter directement au stockage des données relationnelles, vous pouvez annuler la connexion autorisée au moyen de l'utilitaire revokeconnection.

L'utilitaire revokeconnection peut uniquement être exécuté sur la machine de stockage des données principale.

Syntaxe

revokeconnection <host name> <user name> [<database>]

Exemple

Dans cet exemple, la base de données du stockage des données n'accepte plus les connexions de la machine workcom lorsqu'elles sont faites via l'utilisateur hqo.n_1E7.

./revokeconnection.sh workcom bn0_3Wa.m hqo.n_1E7

unregisterdatastore

Vous pouvez utiliser l'utilitaire de commande unregisterdatastore pour effectuer les opérations suivantes :

• Annulez l'inscription d'une machine de stockage des données relationnelles ou du cache de tuiles principale auprès de votre site ArcGIS Server. N'effectuez cette opération que si vous avez supprimé la couche hébergée et les couches de tuiles qui utilisent les données du stockage des données. Dans le cas contraire, vous disposerez de couches inutilisables conservées dans votre portail et de services inutilisables s'exécutant sur votre serveur d'hébergement.

  Notez que si vous possédez une machine de secours, vous devez tout d'abord la supprimer du stockage des données, pour pouvoir désinscrire la machine principale.

• Désinscrivez un stockage de Big Data spatio-temporelles à une seule machine.

Vous pouvez désinscrire un stockage des données de votre site ArcGIS Server si vous ne voulez plus utiliser le stockage des données ou les services qui en dépendent. Lorsque vous désinscrivez une machine d'un stockage des données, ArcGIS Server ne peut plus se connecter à cette machine et tous les services qui contenaient les données du stockage des données désinscrit ne fonctionnent plus. Cette commande ne supprime pas les données. Toutefois, si vous décidez que vous avez encore besoin du stockage des données, vous pouvez utiliser l'utilitaire registerdatastore ou configuredatastore pour le rajouter.

L'utilitaire unregisterdatastore peut uniquement être exécuté sur la machine de stockage des données principale.

Syntaxe

unregisterdatastore [--prompt {yes | no}]

Exemple

Ici, l'utilitaire unregisterdatastore est exécuté avec une invite retournée. Il s'agit du comportement par défaut. Pour supprimer l'invite, indiquez --prompt No.

./unregisterdatastore.sh
You are going to unregister the data store.
Do you want to continue (Yes or No)?Yes

updatebackupretaindays

Par défaut, ArcGIS Data Store conserve les fichiers de sauvegarde du stockage des données relationnelles pendant sept jours. Vous pouvez changer la fréquence à laquelle les fichiers de sauvegarde sont purgés du répertoire de sauvegarde, à l'aide de l'utilitaire updatebackupretaindays.

L'utilitaire updatebackupretaindays peut uniquement être exécuté sur la machine de stockage des données principale.

Syntaxe

updatebackupretaindays <number of days>

Exemple

Dans l'exemple suivant, la durée de rétention des fichiers de sauvegarde est définie sur 10 jours :

./updatebackupretaindays.sh 10

updatebackupschedule

Par défaut, ArcGIS Data Store crée une sauvegarde complète tous les quatre jours. Vous pouvez changer la fréquence à laquelle une sauvegarde complète est créée, à l'aide de l'utilitaire updatebackupschedule.

Indiquez une heure de début au format 24 heures, 00:00:00 représentant minuit et 13:00:00 une heure de l'après-midi. Utilisez l'option de fréquence pour indiquer le nombre de jours devant s'écouler entre chaque sauvegarde. Pour désactiver les sauvegardes automatiques, définissez la fréquence sur 0. Si vous désactivez les sauvegardes automatiques, veillez à exécuter l'utilitaire backupdatastore pour créer manuellement des sauvegardes complètes.

Vous pouvez uniquement exécuter l'utilitaire updatebackupschedule sur la machine de stockage des données principale.

Syntaxe

updatebackupschedule [--starttime <local server time>] --frequency <number of days>

Si vous n'indiquez pas une nouvelle heure de début, le paramètre d'heure de début existant ne change pas.

Exemple

Dans cet exemple, les sauvegardes complètes ont lieu à 23 h. (heure sur le serveur local) tous les 10 jours :

./updatebackupschedule.sh --starttime 23:00:00 --frequency 10

updatelicense

Si votre licence ArcGIS for Server arrive à expiration, vous devez la mettre à jour sur le site ArcGIS for Server. Les informations de licence sont également stockées dans le stockage des données relationnelles ArcGIS Data Store. Par conséquent, après avoir mis à jour la licence du site ArcGIS for Server avec lequel le stockage des données est configuré, vous devez mettre à jour la licence dans le stockage des données. Pour ce faire, exécutez l'utilitaire updatelicense à partir de la machine sur laquelle votre ArcGIS Data Store principal est installé. Si vous possédez un ArcGIS Data Store de secours, la licence mise à jour y est répliquée.

Syntaxe

updatelicense

Exemple

Une fois que vous avez mis à jour la licence ArcGIS for Server, exécutez l'utilitaire updatelicense pour déplacer la nouvelle licence sur le stockage des données.

./updatelicense.sh