configurebackuplocation

Cet utilitaire est utilisé pour tous les types ArcGIS Data Store.

L’utilitaire configurebackuplocation permet de spécifier l’emplacement dans lequel ArcGIS Data Store écrit les fichiers de sauvegarde des sauvegardes planifiées et des sauvegardes créées à l’aide de l’utilitaire backupdatastore. L’utilitaire configurebackuplocation permet également de modifier les propriétés d’un emplacement de sauvegarde et de supprimer un emplacement de sauvegarde.

Les relational data stores sont créés avec un emplacement de sauvegarde local par défaut. Pour éviter la perte de données, configurez un emplacement de sauvegarde par défaut en inscrivant un partage de fichiers sécurisé au moyen de l’option change.

Les spatiotemporal Big Data stores, les graph stores et les object stores ne sont pas créés avec un emplacement de sauvegarde par défaut. Avant de commencer à créer des sauvegardes, vous devez exécuter l’utilitaire configurebackuplocation avec l’option register pour spécifier un emplacement de partage de fichiers, un compartiment Amazon Simple Storage Service (S3) ou un conteneur Microsoft Azure Blob Storage pour ces sauvegardes.

Remarque :

Vous ne pouvez pas utiliser de disque local pour les fichiers de sauvegarde de stockage de spatiotemporal Big Data store.

Vous pouvez inscrire un second emplacement de sauvegarde pour le stockage des sauvegardes créées avec l’utilitaire backupdatastore. Vous pouvez utiliser un répertoire de fichiers partagé, un compartiment S3 ou un conteneur Azure Blob Storage pour les emplacements de sauvegarde secondaires.

Pour plus d’informations sur les sauvegardes ArcGIS Data Store, voir Gérer les sauvegardes ArcGIS Data Store.

Syntaxe

configurebackuplocation --store {relational | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]

Options requises

Vous devez indiquer les options suivantes lorsque vous exécutez l’utilitaire configurebackuplocation :

• --store {relational | spatiotemporal | graph | object}

  Spécifiez le type ArcGIS Data Store pour lequel vous configurez ou interrogez des emplacements de sauvegarde. La valeur par défaut est relational.

• --operation {change | register | unregister | list | setdefault}

  L’option --operation spécifie l’action que l’utilitaire configurebackuplocaton va effectuer. La valeur par défaut est change.

  Voici une explication de chaque argument pouvant être utilisé avec l’option --operation :

Option	Description
change	Cet argument permet d’apporter les modifications suivantes : Spécifiez un emplacement différent de fichiers partagés pour les sauvegardes planifiées d’un relational data store. L’emplacement défini à l’aide de l’argument change correspond toujours à l’emplacement de sauvegarde par défaut des relational data stores. Vous devez indiquer l’option --location si vous modifiez l’emplacement de sauvegarde par défaut d’un relational data store. Modifiez le nom d’un emplacement de sauvegarde. Vous devez indiquer l’option --location et son argument name si vous modifiez le nom d’un emplacement de sauvegarde. Mettez à jour les informations d’authentification que vous avez définies pour les emplacements de sauvegarde sur Azure ou S3. Pour S3, vous pouvez modifier les informations que vous avez précédemment spécifiées à l’aide des options username et password. Pour Azure, vous pouvez modifier la valeur password.
register	Cet argument permet d’inscrire un emplacement de sauvegarde. Si vous utilisez l’argument register, vous devez indiquer l’option --location. Le premier dossier de sauvegarde que vous définissez pour un spatiotemporal big data store, graph store ou object store est considéré comme le dossier de sauvegarde par défaut. Lorsque vous inscrivez un autre dossier de sauvegarde pour un spatiotemporal big data store, object store ou graph store, un dossier de sauvegarde secondaire est inscrit. Pour le relational data store, l’argument register inscrit toujours un emplacement de sauvegarde secondaire. L’emplacement de sauvegarde secondaire permet de stocker des sauvegardes manuelles générées avec l’utilitaire backupdatastore.
unregister	Cet argument permet de supprimer un emplacement de sauvegarde secondaire d’un data store. Si un seul emplacement de sauvegarde est inscrit, l’argument unregister supprime entièrement l’emplacement de sauvegarde d’un spatiotemporal Big Data store, object store ou graph store.
list	Répertorie tous les emplacements de sauvegarde inscrits pour le data store spécifié avec l’option --store. La liste indique l’emplacement de sauvegarde physique, le nom de l’emplacement de sauvegarde et celui qui est inscrit comme emplacement de sauvegarde par défaut.
setdefault	Si vous avez configuré plusieurs emplacements de sauvegarde pour le graph store, l’objet store ou le spatiotemporal Big Data store, utilisez l’argument setdefault pour en désigner un comme emplacement par défaut. Cet emplacement contient les sauvegardes planifiées. Il s’agit de l’emplacement par défaut utilisé si vous exécutez l’utilitaire backupdatastore, listbackups ou restoredatastore sans spécifier d’emplacement de sauvegarde.

Option location

L’option --location est requise dans les cas suivants :

• Spécifiez l’emplacement du stockage de sauvegarde lorsque vous inscrivez un emplacement de sauvegarde ou que vous modifiez l’emplacement de sauvegarde initial par défaut du relational data store.

• Pour modifier le nom d’un emplacement de sauvegarde existant, indiquez l’argument name et la valeur du nouveau nom.

Vous pouvez utiliser l’option --location lorsque vous définissez un emplacement de sauvegarde par défaut ou que vous supprimez un emplacement de sauvegarde. Vous pouvez également utiliser le nom de la sauvegarde.

Pour le spatiotemporal Big Data store ou pour inscrire un emplacement de sauvegarde secondaire pour le relational data store, indiquez les arguments suivants séparés par un point-virgule (;) avec l’option --location et placez la totalité de la chaîne d’arguments entre guillemets droits doubles (") :

--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]".

Chacun des arguments pris en charge avec l’option --location est décrit ci-dessous :

Argument	Description
type=	Cet argument est requis. Indiquez le type d’emplacement à utiliser pour les sauvegardes. Spécifiez fs pour stocker les sauvegardes dans un partage de fichiers. Dans le cas de relational data stores, l’emplacement de sauvegarde par défaut doit être un partage de fichiers. Spécifiez s3 pour stocker les sauvegardes dans un compartiment S3. Spécifiez azure pour stocker les sauvegardes dans un conteneur Azure Blob Storage.
location=	Cet argument est requis. Pour les partages de fichiers, spécifiez le chemin du fichier. Pour les compartiments Amazon S3, spécifiez le nom et le chemin d’accès du compartiment. Pour les conteneurs de stockage Blob, spécifiez le nom et le chemin d’accès du conteneur. Si vous utilisez cet argument pour modifier l’emplacement de sauvegarde par défaut initial du relational data store, l’emplacement que vous spécifiez ne doit pas correspondre à un emplacement de sauvegarde inscrit existant.
name=	Vous pouvez attribuer un nom à l’emplacement de sauvegarde. Par exemple, si l’emplacement de sauvegarde est un chemin d’accès à un fichier, tel que \\sharedserver_sharedfolders_datastorebackups, vous pouvez lui attribuer un nom, par exemple, dsbackupsfolder. Lorsque vous exécutez l’utilitaire backupdatastore, listbackups ou restoredatastore, indiquez ce nom plutôt que le chemin de l’emplacement. Si vous ne fournissez pas de nom lorsque vous configurez l’emplacement de sauvegarde du stockage de données, ArcGIS Data Store en attribue un par défaut.
username=	Cet argument est requis si vous définissez l’argument type= sur azure ou sur s3. Pour les compartiments S3, indiquez l’identifiant de clé d’accès pour votre compte Amazon Web Services (AWS). Pour les conteneurs Azure Blob Storage, fournissez le nom du compte Microsoft Azure pouvant accéder au conteneur Blob Storage.
password=	Cet argument est requis si vous définissez l’argument type= sur azure ou sur s3. Pour les compartiments S3, fournissez la clé secrète de votre compte AWS. Pour les conteneurs Azure Blob Storage, fournissez la clé du compte Azure que vous avez spécifié avec l’argument username.
endpointsuffix=	Si vous définissez l’argument type= sur azure, vous pouvez utiliser l’argument endpointsuffix pour indiquer l’emplacement du conteneur Azure Blob Storage. Par défaut, le paramètre endpointsuffix est censé être core.windows.net. Si votre conteneur se trouve dans l’environnement cloud Microsoft Azure Government, définissez endpointsuffix=core.usgovcloudapi.net. Si le conteneur se trouve dans un cloud privé, définissez endpointsuffix sur le suffixe du point de terminaison du cloud privé Azure.
region=	Cet argument est requis si vous définissez l’argument type= sur s3. Vous devez indiquer le code de région. Par exemple, définissez la région sur ap-southeast-2 si le compartiment est déployé dans la région Asie-Pacifique (Sydney). Consultez la documentation AWS pour en savoir plus sur les codes de région.

Options supplémentaires

Voici les options supplémentaires que vous pouvez fournir avec l’utilitaire configurebackuplocation :

Option	Description
--force	Utilisée uniquement avec les relational data stores, cette option permet de modifier l’emplacement de sauvegarde par défaut, même si ce dernier n’est pas disponible. Les valeurs valides sont true et false. Lorsque vous modifiez l’emplacement de sauvegarde par défaut d’un relational data store, ArcGIS Data Store copie les fichiers de sauvegarde existants de l’ancien emplacement vers le nouveau. Si ArcGIS Data Store ne parvient pas à accéder à l’ancien emplacement, il ne peut pas copier les fichiers. Dans les versions antérieures, cela entraînait l’échec de l’utilitaire configurebackuplocation. Pour modifier l’emplacement de sauvegarde par défaut sans copier les fichiers de sauvegarde existants, spécifiez --force true. La valeur par défaut de cette option est false, ce qui signifie que vous ne pouvez pas modifier l’emplacement de sauvegarde si ArcGIS Data Store ne parvient pas à accéder à l’emplacement par défaut existant.
--prompt	Les valeurs valides sont yes et no. vous exécutez cet utilitaire, vous êtes invité à confirmer l’action spécifiée. Si vous automatisez l’utilisation de cet utilitaire, définissez l’option --prompt sur no. Sinon, le script ne continue que si vous répondez à l’invite.

Exemples

Les sections suivantes présentent des exemples de changement, de définition ou de création de listes d’emplacements de sauvegarde pour les data stores.

Changer l’emplacement de sauvegarde par défaut du relational data store

Dans le premier exemple, l’emplacement de sauvegarde d’un relational data store est défini sur un répertoire nommé fsdata_bu sur une machine nommée myshare.

./configurebackuplocation.sh --operation change --store relational --location "type=fs;location=/net/myshare/fsdata_bu"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

configurebackuplocation --operation change --store relational --location "type=fs;location=\\myshare\fsdata_bu"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

Ajouter un emplacement de sauvegarde par défaut pour le relational data store

Dans cet exemple, un deuxième emplacement de sauvegarde sur Azure est inscrit pour le même relational data store.

./configurebackuplocation.sh --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

configurebackuplocation --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

Définir un emplacement de sauvegarde pour un graph store

Dans cet exemple, un emplacement de sauvegarde sur un partage réseau est inscrit pour un graph store. Un nom, fshare, est attribué à l’emplacement de sauvegarde.

./configurebackuplocation.sh --operation register --store graph --location "type=fs;location=/net/sharedmachine/g_bu;name=fshare" --prompt no

configurebackuplocation --operation register --store graph --location "type=fs;location=\\sharedmachine\g_bu;name=fshare" --prompt no

Ajouter des emplacements de sauvegarde et définir un emplacement par défaut

Dans cet exemple, un deuxième emplacement de sauvegarde est spécifié pour le spatiotemporal Big Data store. L’emplacement de sauvegarde supplémentaire se trouve dans le stockage Azure.

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

Dans cet exemple, un deuxième emplacement de sauvegarde dans la région Europe (Espagne) sur AWS est spécifié pour le même spatiotemporal Big Data store. Un nom, awsloc, est attribué à l’emplacement de sauvegarde.

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

Dans cet exemple, le compartiment S3 est défini comme emplacement de sauvegarde par défaut pour le spatiotemporal Big Data store à l’aide du nom de l’emplacement de sauvegarde (awsloc).

./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

Obtenir une liste de tous les emplacements de sauvegarde pour un data store

Dans cet exemple, tous les emplacements de sauvegarde pour le stockage de Big Data spatio-temporelles sont répertoriés..

./configurebackuplocation.sh --operation list --store spatiotemporal

configurebackuplocation --operation list --store spatiotemporal

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       /net/sharedmachine/ge_bu     false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       \\sharedmachine\ge_bu        false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false