configurebackuplocation

Esta utilidad se utiliza con todos los tipos de ArcGIS Data Store.

La utilidad configurebackuplocation le permite especificar la ubicación en la que ArcGIS Data Store escribe los archivos de copia de seguridad, tanto de las copias de seguridad programadas como de las creadas con la utilidad backupdatastore. La utilidad configurebackuplocation también permite modificar las propiedades de una ubicación de copia de seguridad y eliminar una ubicación de copia de seguridad.

Los almacenes relacionales se crean con una ubicación de copia de seguridad local predeterminada. Para evitar la pérdida de datos, configure una ubicación de copia de seguridad predeterminada registrando un recurso compartido de archivos remoto con la opción change.

Los big data stores espaciotemporales, graph stores y almacenes de objetos no se crean con una ubicación de copia de seguridad predeterminada. Antes de crear copias de seguridad, debe ejecutar la utilidad configurebackuplocation con la opción register para especificar una ubicación de recurso compartido de archivos, un bucket de Amazon Simple Storage Service (S3) o un contenedor de almacenamiento de BLOB de Microsoft Azure para estas copias de seguridad.

Nota:

No puede usar una unidad local para los archivos de copia de seguridad de un big data store espaciotemporal.

Es posible registrar una segunda ubicación de copia de seguridad para almacenar las copias de seguridad creadas con la utilidad backupdatastore. Puede usar un directorio de archivos compartido, bucket de S3 o un contenedor de almacenamiento de BLOB de Azure como ubicaciones de copia de seguridad secundarias.

Para obtener más información sobre las copias de seguridad de ArcGIS Data Store, consulte Administrar copias de seguridad de ArcGIS Data Store.

Sintaxis

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

Opciones obligatorias

Debe proporcionar las siguientes opciones cuando ejecute la utilidad configurebackuplocation:

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

Especifique el tipo de ArcGIS Data Store para el que configura o consulta ubicaciones de copia de seguridad. El valor predeterminado es relational.
--operation {change | register | unregister | list | setdefault}

La opción --operation especifica la acción que realizará la utilidad configurebackuplocaton. El valor predeterminado es change.

A continuación se explica cada argumento que puede utilizar con la opción --operation:


Opción	Descripción
`change`	Use este argumento para cambiar cualquiera de las siguientes opciones: Especifique otra ubicación de archivo compartido para las copias de seguridad programadas para almacenes relacionales. La ubicación establecida con el argumento `change` es siempre la ubicación de copia de seguridad predeterminada para almacenes relacionales. Debe proporcionar la opción `--location` cuando cambie la ubicación predeterminada de la copia de seguridad del almacén relacional. Modifique el nombre de una ubicación de copia de seguridad. Debe proporcionar la opción `--location` y su argumento `name` cuando cambie el nombre de una ubicación de copia de seguridad. Actualice la información de autenticación establecida para ubicaciones de copia de seguridad en Azure o S3. En S3, puede cambiar la información que indicó anteriormente con las opciones `username` y `password`. En Azure, puede cambiar el valor de `password`.
`register`	Utilice este argumento para registrar una ubicación de copia de seguridad. Al utilizar el argumento `register`, debe proporcionar la opción `--location`. La primera ubicación de copia de seguridad que defina para un big data store espaciotemporal, graph store o almacén de objetos se establece como la ubicación de copia de seguridad predeterminada. Cuando se registra otra ubicación de copia de seguridad para un big data store espaciotemporal, almacén de objetos o graph store, se registra una ubicación de copia de seguridad secundaria. Para el almacén relacional, el argumento `register` siempre registra una ubicación de copia de seguridad secundaria. La ubicación de copia de seguridad secundaria se puede usar para almacenar las copias de seguridad manuales generadas con la utilidad backupdatastore.
`unregister`	Utilice este argumento para eliminar una ubicación de copia de seguridad secundaria de un data store. Si solo hay registrada una ubicación de copia de seguridad, el argumento para dar de baja y eliminar por completo la ubicación de copia de seguridad del big data store espaciotemporal, del almacén de objetos o del graph store.
`list`	Muestra en una lista todas las ubicaciones de copia de seguridad registradas para un data store especificado con la opción `--store`. La lista indica la ubicación física de la copia de seguridad, el nombre de la ubicación de la copia de seguridad y cuál está registrada como ubicación de copia de seguridad predeterminada.
`setdefault`	Si ha configurado varias ubicaciones de copia de seguridad para el graph store o un big data store espaciotemporal, utilice el argumento `setdefault` para designar una de las ubicaciones de copia de seguridad como la ubicación predeterminada. En esta ubicación se escriben las copias de seguridad programadas y es la ubicación predeterminada que se utiliza al ejecutar las utilidades backupdatastore, listbackups o restoredatastore sin especificar una ubicación de copia de seguridad.

Opción de ubicación

La opción --location es necesaria en los siguientes escenarios:

Especifique la ubicación de almacenamiento de la copia de seguridad cuando registre una ubicación de copia de seguridad o cambie la ubicación predeterminada inicial de la copia de seguridad para el almacén relacional.
Para cambiar el nombre de una ubicación de copia de seguridad existente, proporcione el argumento name y el nuevo valor del nombre.

Puede utilizar la opción --location cuando establezca una ubicación predeterminada para la copia de seguridad o cuando elimine una ubicación de copia de seguridad, o bien puede utilizar el nombre de la copia de seguridad.

Para el big data store espaciotemporal o para registrar una ubicación de copia de seguridad secundaria para el almacén relacional, especifique los siguientes argumentos con la opción --location separada por punto y coma (;) y encierre toda la cadena de caracteres entre comillas dobles ("):

--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>]".

A continuación, se proporciona una explicación de cada uno de los argumentos admitidos con la opción --location:


Argumento	Descripción
`type=`	Este argumento es obligatorio. Defina qué tipo de ubicación se usará para las copias de seguridad. Especifique `fs` para almacenar las copias de seguridad en un recurso compartido de archivos. Para los almacenes relacionales, la ubicación predeterminada de la copia de seguridad debe ser un recurso compartido de archivos. Especifique `s3` para almacenar copias de seguridad en un bucket de Amazon S3. Especifique `azure` para almacenar copias de seguridad en un contenedor de almacenamiento BLOB de Azure.
`location=`	Este argumento es obligatorio. Para recursos compartidos de archivos, especifique la ruta del archivo. Para buckets de Amazon S3, especifique el nombre del bucket y su ruta. Para contenedores de almacenamiento de Blob, especifique el nombre del contenedor y su ruta. Cuando utilice este argumento para cambiar la ubicación de la copia de seguridad del almacén relacional predeterminado inicial, la ubicación que especifique no podrá ser una ubicación de copia de seguridad registrada existente.
`name=`	Puede asignar un nombre a la ubicación de copia de seguridad. Por ejemplo, si su ubicación de copia de seguridad es una ruta de archivo, por ejemplo `\\sharedserver_sharedfolders_datastorebackups`, puede designar un nombre para esta ubicación, como dsbackupsfolder. Al ejecutar las utilidades backupdatastore, listbackups o restoredatastore, proporcione este nombre en lugar de la ruta de la ubicación. Si no proporciona un nombre al configurar la ubicación de copia de seguridad del data store, ArcGIS Data Store asigna un nombre predeterminado.
`username=`	Este argumento es obligatorio si establece el argumento `type=` en `azure` o `s3`. Para buckets de S3, indique el Id. de clave de acceso de su cuenta de Amazon Web Services (AWS). En el caso de los contenedores de Azure Blob Storage, indique el nombre de la cuenta de almacenamiento de Microsoft Azure que pueda acceder al contenedor de Blob Storage.
`password=`	Este argumento es obligatorio si establece el argumento `type=` en `azure` o `s3`. Para buckets de S3, indique la clave secreta de su cuenta de AWS. Para contenedores de almacenamiento de BLOB de Azure, indique la clave de la cuenta de Azure que especificó en el argumento `username`.
`endpointsuffix=`	Si establece el argumento `type=` en `azure`, puede utilizar el argumento `endpointsuffix` para indicar dónde se encuentra el contenedor de almacenamiento BLOB de Azure. De manera predeterminada, se supone que `endpointsuffix` es `core.windows.net`. Si su contenedor se encuentra en el entorno de la nube gubernamental de Microsoft Azure, establezca `endpointsuffix=core.usgovcloudapi.net`. Si su contenedor está en una nube privada, establezca `endpointsuffix` al sufijo del extremo de su nube privada de Azure.
`region=`	Este argumento es obligatorio cuando se establece el argumento `type=` en `s3`. Debe indicar el código de la región. Por ejemplo, defina la región en ap-southeast-2 si el bucket está desplegado en la región Asia-Pacífico (Sídney). Consulte la documentación de AWS para los códigos de región.

Opciones adicionales

Estas son otras opciones que puede proporcionar con la utilidad configurebackuplocation:


Opción	Descripción
`--force`	Esta opción, que solo se utiliza con almacenes relacionales, le permite cambiar la ubicación de copia de seguridad predeterminada incluso si la ubicación de copia de seguridad predeterminada existente no está disponible. Los valores válidos son `true` o `false`. Al cambiar la ubicación de copia de seguridad predeterminada para un almacén relacional, ArcGIS Data Store copia los archivos de copia de seguridad existentes de la ubicación antigua a la nueva. Si ArcGIS Data Store no puede acceder a la ubicación antigua, no puede copiar los archivos. En versiones anteriores, esto haría que la herramienta configurebackuplocation fallase. Para seguir cambiando la ubicación de copia de seguridad predeterminada sin copiar los archivos de copia de seguridad existentes, especifique `--force true`. El valor predeterminado de esta opción es `false`, lo que significa que no puede modificar la ubicación de copia de seguridad predeterminada si ArcGIS Data Store no puede acceder a la ubicación predeterminada existente.
`--prompt`	Los valores válidos son `yes` o `no`. Cuando ejecute esta utilidad, se le pedirá que confirme la acción que ha especificado. Si automatiza el uso de esta utilidad, establezca la opción `--prompt` en `no`; de lo contrario, el script no procederá hasta que responda a la petición.

Ejemplos

En las secciones siguientes se proporcionan ejemplos de cambios, configuración o lista de ubicaciones de copia de seguridad para data stores.

Cambiar la ubicación de copia de seguridad predeterminada para el almacén relacional

En el primer ejemplo, la ubicación de copia de seguridad de un almacén relacional se establece en un directorio denominado fsdata_bu, pero en un equipo denominado 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

Agregar una ubicación de copia de seguridad para el almacén relacional

En este ejemplo, se registra una segunda ubicación de copia de seguridad en Azure para el mismo almacén relacional.

./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

Definir una ubicación de copia de seguridad para un almacén de gráficos

En este ejemplo, se registra una ubicación de copia de seguridad para un almacén de gráficos en un recurso compartido de red. Se asigna un nombre, fshare, a la ubicación de copia de seguridad.

./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

Agregar ubicaciones de copia de seguridad y establecer una ubicación predeterminada

En este ejemplo, se especifica una segunda ubicación de copia de seguridad para el big data store espaciotemporal. La ubicación de copia de seguridad adicional se encuentra en el almacenamiento de 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

En este ejemplo, se especifica una segunda ubicación en la región de Europa (España) en AWS para el mismo big data store espaciotemporal. Se asigna un nombre, awsloc, a la ubicación de copia de seguridad.

./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

En este ejemplo, se establece el bucket de S3 como la ubicación de copia de seguridad predeterminada para el big data store espaciotemporal y se utiliza el nombre de la ubicación de copia de seguridad (awsloc).

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

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

Obtener una lista de todas las ubicaciones de copia de seguridad de un data store

En este ejemplo, se muestra una lista de todas las ubicaciones de copia de seguridad del big data store espaciotemporal.

./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