Skip To Content

Referencia de utilidades de ArcGIS Data Store

Las utilidades instaladas con ArcGIS Data Store proporcionan herramientas al administrador del data store para gestionar los data stores. Esta página describe las utilidades y proporciona sintaxis y ejemplos para cada una de ellas.

Todas las utilidades deben ejecutarse en el equipo de ArcGIS Data Store. Encontrará las utilidades en el directorio <ArcGIS Data Store installation directory>\datastore\tools.

Escriba el nombre de la utilidad seguido de --help para obtener ayuda con la sintaxis.

Nota:

Su inicio de sesión debe pertenecer al grupo de administradores de Windows y debe abrir la ventana de comando con la opción Ejecutar como administrador para utilizar las utilidades de ArcGIS Data Store.

allowconnection

Esta utilidad se utiliza con data stores relacionales.

Por motivos de seguridad, todas las conexiones al data store se hacen de manera predeterminada a través del sitio de GIS Server. Si desea abrir el data store relacional de conexiones desde un equipo adicional, puede utilizar la utilidad allowconnection.

La utilidad allowconnection solo se puede ejecutar en el equipo de data store relacional principal.

Sintaxis

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

Especifique el nombre del equipo cuya conexión al data store relacional (nombre de host) desea permitir y una de las cuentas de base de datos utilizadas por el data store (nombre de usuario): el administrador del data store, el propietario de réplica, el administrador de la geodatabase o bien el usuario administrado (el usuario que publica datos de capa de entidades), que puede obtener con la utilidad listadminusers o listmanageduser. También puede especificar el nombre de la base de datos del data store relacional principal, pero como solo hay una, este valor es opcional.

Ejemplo

En este ejemplo, se permite una conexión desde el equipo de trabajo al data store relacional cuando las conexiones se hacen como usuario administrado hqo.n_1E7.

allowconnection workcom hqo.n_1E7

backupdatastore

Esta utilidad se utiliza con todos los tipos de data store.

Utilice esta utilidad para crear una copia de seguridad completa de un data store entre los tiempos de copia de seguridad programados. Por ejemplo, cree una copia de seguridad de cada data store antes de actualizar ArcGIS Data Store o antes de realizar un gran número de cambios en un data store.

La utilidad backupdatastore puede ejecutarse solo para un tipo de data store a la vez.

La siguiente tabla indica dónde ejecutar la utilidad backupdatastore y qué hace la utilidad para cada tipo de data store:

Tipo de data storeEquipoComportamiento

Data store relacional

Ejecute la utilidad backupdatastore en el equipo principal del data store relacional.

La utilidad backupdatastore crea siempre una copia de seguridad completa del data store relacional.

Data store de caché de teselas

La utilidad backupdatastore puede ejecutarse en cualquier equipo del data store de caché de teselas.

La primera vez que ejecute la utilidad backupdatastore para un data store de caché de teselas después de configurar una ubicación de copia de seguridad, las copias de seguridad se realizan de todas las bases de datos de data store de caché de teselas existentes. El uso subsiguiente de la utilidad backupdatastore crea copias de seguridad de cualquier base de datos de data store de caché de teselas que se han creado desde la última vez que se ha ejecutado la utilidad.

Big data store espaciotemporal

La utilidad backupdatastore puede ejecutarse en cualquier equipo del clúster.

La primera vez que ejecute la utilidad backupdatastore para un big data store espaciotemporal después de configurar una ubicación de copia de seguridad, se crea una copia de seguridad completa. El uso posterior de la utilidad backupdatastore crea un archivo de copia de seguridad que contiene solo los cambios realizados desde la copia de seguridad completa inicial.

Almacén de objetos

La utilidad backupdatastore puede ejecutarse en cualquier equipo del clúster.

La utilidad backupdatastore crea siempre una copia de seguridad completa del almacén de objetos para los datos de servicio de vídeo. Las cachés de consulta de las capas de entidades no se incluyen en el archivo de copia de seguridad.

Graph store

La utilidad backupdatastore puede ejecutarse en cualquier equipo del graph store.

La utilidad backupdatastore crea siempre una copia de seguridad completa del graph store.

Antes de ejecutar la utilidad backupdatastore, asegúrese de que la ubicación de la copia de seguridad del data store es lo suficientemente grande como para albergar las copias de seguridad. Para cambiar las ubicaciones de copia de seguridad del data store, utilice la utilidad configurebackuplocation.

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

Sintaxis

backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <backup_arguments>] [--prompt {yes | no}]

Debe proporcionar un nombre para el archivo de copia de seguridad.

Si no especifica la opción --store, se asume el valor relational.

Si no especifica la opción --location, los archivos de copia de seguridad se escriben en la ubicación de copia de seguridad predeterminada del data store.

Para especificar una de las otras ubicaciones de copia de seguridad registradas en su lugar, utilice la opción --location. Puede proporcionar el nombre de la copia de seguridad o el tipo y ubicación de la misma. Cuando utilice los argumentos type= y location=, sepárelos con un punto y coma (;).

Los argumentos admitidos para la opción --location son los siguientes:

ArgumentoDescripción

name=

Puede utilizar el nombre de la ubicación de la copia de seguridad para indicar la ubicación de la copia de seguridad registrada.

Si especifica un nombre, no es necesario utilizar los argumentos type= y location=.

type=

Si no especifica un nombre para la ubicación de la copia de seguridad, deberá especificar el tipo de ubicación de la copia de seguridad y la ubicación física.

Los valores de tipo y sus descripciones son los siguientes:

  • fs: un recurso compartido de archivos
  • s3: un bucket de Amazon Simple Storage Service (S3)
  • azure: un contenedor de almacenamiento Blob de Microsoft Azure

location=

Utilice este argumento location= para indicar la ubicación física de ubicación de la copia de seguridad registrada. Este argumento debe utilizarse con el argumento type=.

Para archivos compartidos, indique la ruta del archivo.

Para buckets de S3, indique el nombre del bucket.

Para contenedores de almacenamiento de BLOB de Azure, indique el nombre del contenedor.

Ejemplos

En este ejemplo, la utilidad backupdatastore crea un archivo de copia de seguridad completo denominado project1bu en la ubicación de copia de seguridad predeterminada del data store relacional. Al incluir --prompt no, la utilidad no solicita una respuesta de confirmación.

backupdatastore project1bu --prompt no

En este ejemplo, se crea un archivo de copia de seguridad llamado localbu5 para el big data store espaciotemporal en una ubicación de archivo compartido, a la cual llamó gadbu cuando configuró la ubicación de copia de seguridad.

backupdatastore localbu5 --store spatiotemporal --location name=gadbu

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

En este ejemplo, se crea una copia de seguridad de un big data store espaciotemporal en un contenedor de almacenamiento de BLOB de Azure llamado blob4backups y el archivo de copia de seguridad creado se llama spds311016:

backupdatastore spds311016 --store spatiotemporal --location type=azure;location=blob4backups

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

changedatastoremode

Esta utilidad se utiliza con big data stores relacionales y espaciotemporales.

La utilidad changedatastoremode permite colocar un data store relacional en modo de solo lectura mientras realiza el mantenimiento del data store. Por ejemplo, si debe realizar una tarea de mantenimiento que implique el reinicio del data store, como pueda ser el cambio de una ubicación de copia de seguridad entre dos unidades o el cambio de las propiedades de la base de datos, puede poner el data store relacional en modo de solo lectura para que ningún usuario se encuentre en pleno proceso de publicación o edición de datos cuando el data store se reinicia.

La utilidad changedatastoremode también se utiliza para volver a poner el data store relacional en modo de lectura-escritura cuando termine las tareas de mantenimiento o después de agregar espacio de disco al equipo del data store principal para que el data store pueda funcionar correctamente en modo de lectura-escritura.

Debe ejecutar la utilidad changedatastoremode en el equipo de data store relacional principal, no en el equipo de respaldo.

Si el big data store espaciotemporal está a punto de quedarse sin espacio en disco, ArcGIS Data Store lo establece en modo de solo lectura para evitar daños en los datos. Puede utilizar la utilidad changedatastoremode para devolver un big data store espaciotemporal al modo de lectura-escritura tras agregar suficiente espacio en disco a los equipos de big data stores espaciotemporales.

Nota:

Si ArcGIS Data Store establece el data store en modo de solo lectura porque hay poco espacio en el disco, las copias de seguridad automáticas también se deshabilitan para evitar llenar el disco en exceso. Por lo tanto, debe restablecer la periodicidad de la copia de seguridad automática mediante la utilidad updatebackupschedule después de volver a poner el data store en modo de lectura-escritura.

Sintaxis

changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}

Ejemplos

En este ejemplo, el data store relacional se pone en modo de solo lectura, lo que significa que los clientes no pueden realizar actividades como publicar capas de entidades alojadas en ArcGIS Enterprise o editar datos a través de una capa de entidades alojada. Se ofrece la opción --prompt de quitar la pregunta de confirmación.

changedatastoremode readonly --store relational --prompt no

Para poner un big data store espaciotemporal en modo lectura-escritura después de agregar espacio en el disco en los equipos, especifique la opción readwrite y especifique spatiotemporal con la opción --store como se muestra en el siguiente ejemplo:

changedatastoremode readwrite --prompt no --store spatiotemporal

changedbproperties

Esta utilidad se utiliza con big data stores relacionales, de caché de teselas y espaciotemporales.

La utilidad changedbproperties permite cambiar varias propiedades según el tipo de data store en el que la ejecuta.

Sintaxis

changedbproperties --store {relational | tileCache | spatiotemporal} [configuration options]

Debe proporcionar la opción --store y al menos una opción de configuración. A continuación se indican las opciones de configuración admitidas, sus descripciones y el tipo de data store con el que se puede utilizar cada opción:

Opción ConfiguraciónDescripciónTipo de data store admitido

--disk-threshold-readonly

Esta opción controla cuándo un data store relacional se pondrá en modo de solo lectura para evitar la pérdida de datos debido a que hay poco espacio en el disco.

Especifique los tamaños en MB. El valor de espacio de disco predeterminado es 1024 MB.

Solo data store relacional

--max-connections

Utilice este parámetro para especificar la cantidad máxima de conexiones permitidas a un data store relacional.

Los data stores relacionales aceptan hasta 150 conexiones de manera predeterminada. Utilice la propiedad --max-connections para cambiar el número de conexiones permitidas.

Tenga en cuenta que los procesos internos de ArcGIS Data Store pueden ocupar hasta cinco conexiones. También debe tener en cuenta cuántas conexiones concurrentes puede aceptar el equipo de ArcGIS Data Store y que siga funcionando bien. Si el equipo que ejecuta ArcGIS Data Store no tiene mucha memoria, puede que tenga que disminuir el número de conexiones permitidas.

El número que especifique no puede ser inferior a 10.

Cuando se cambia el número máximo de conexiones permitidas, ese número se cambiará en los equipos del data store principal y de respaldo.

Solo data store relacional

--pitr

Esta opción indica si ArcGIS Data Store crea copias de seguridad incrementales del data store relacional, permitiéndole así recuperar el data store relacional en un punto en el tiempo.

Los argumentos posibles para esta opción son enable o disable.

Solo data store relacional

La configuración predeterminada es --pitr disable.

Nota:

Debe establecer la opción --pitr en enable si va a utilizar la utilidad webgisdr, que se instala con Portal for ArcGIS, para crear copias de seguridad incrementales de su implementación de ArcGIS Enterprise.

--enablessl

Esta opción controla el uso del protocolo Transport Layer Security (TLS) al alimentar el data store de caché de teselas y para la comunicación entre el data store relacional y servidor de alojamiento.

Los argumentos admitidos para el parámetro --enablessl son los siguientes:

  • true: esta es la configuración predeterminada. Se utilizará el protocolo Transport Layer Security al escribir los datos de capa de escena en el data store de caché de teselas si especifica --store tileCache, así como en la comunicación entre el data store relacional y el servidor de alojamiento si especifica --store relational.
  • false: especifique false y --store tileCache para usar la comunicación HTTP desde el servidor de alojamiento al escribir en el data store de caché de teselas. Especifique false y --store relational para usar la comunicación HTTP entre el servidor de alojamiento y el data stores relacional.

Data store relacionales y de caché de teselas

--heap-size

Utilice este parámetro para cambiar la cantidad de memoria de almacenamiento dinámico (en MB) utilizada por un big data store espaciotemporal.

De forma predeterminada, este tipo de data store usará la mitad de la RAM del equipo (hasta el 70 por ciento de la memoria RAM libre) cuando se inicie. Puede cambiar el tamaño de almacenamiento dinámico a una cantidad de entre 512 MB y 32.000 MB, pero asegúrese de que la cantidad especificada no supere la cantidad de RAM disponible en el equipo.

big data store espaciotemporal

--rebalance

De forma predeterminada, esta opción está establecida como true, lo que significa el big data store espaciotemporal distribuirá datos a otros equipos si cualquiera de los equipos no está disponible.

Si necesita realizar tareas de mantenimiento en un equipo de big data store espaciotemporal, como actualizarlo, puede desactivar el reequilibrado temporalmente especificando --rebalance false. La opción de reequilibrio se suspenderá durante la cantidad de minutos establecida para el parámetro --max-rebalance-off.

big data store espaciotemporal

--max-rebalance-off

Esta opción se utiliza en combinación con la opción --rebalance para indicar cuánto tiempo permanecerá suspendido el reequilibrado.

De manera predeterminada, --max-rebalance-off está establecido en 60 minutos. Eso quiere decir que si desactiva temporalmente el reequilibrio, se iniciará de nuevo una vez transcurridos 60 minutos. Si necesita más o menos tiempo para realizar la tarea de mantenimiento para la que ha suspendido el parámetro de reequilibrio, cambie la configuración de tiempo de --max-rebalance-off.

big data store espaciotemporal

--prompt

Cuando ejecute esta utilidad, se le pedirá que confirme la acción que ha especificado. Si automatiza el uso de esta utilidad, especifique --prompt no; de lo contrario, el script no procederá hasta que responda a la petición.

Data store relacionales, de caché de teselas y espaciotemporales

Ejemplos

Las siguientes secciones incluyen ejemplos del uso de las opciones disponibles con la utilidad changedbproperties.

Cambiar el umbral de solo lectura del data store relacional

De forma predeterminada, el data store relacional se pone en modo de solo lectura cuando el espacio en disco libre se reduce hasta 1.024 MB. En el siguiente ejemplo, existen otras aplicaciones que escriben en el equipo, de modo que el administrador configura el data store relacional para que se ponga en modo de solo lectura antes, cuando el espacio de disco disponible en el equipo descienda hasta 4.000 MB:

changedbproperties --store relational --disk-threshold-readonly 4000

You are changing the following database properties:
         ...disk space threshold to change relational data store into READONLY mode to 4000MB)

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

Cambiar el número de conexiones permitidas para el data store relacional

En este ejemplo, el número máximo de conexiones permitidas para un data store relacional está establecido en 100:

changedbproperties --store relational --max-connections 100

You are changing the following database properties:
         ...max number of connections to 100 (on all relational 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

Habilitar la recuperación de un punto en el tiempo para el data store relacional

La recuperación de un punto en el tiempo está deshabilitada de manera predeterminada. En este ejemplo, la recuperación de un punto en el tiempo está habilitada para el data store relacional:

changedbproperties --store relational --pitr enable

You are changing the following database properties:
         ...enable point-in-time recovery for relational store

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

Deshabilitar SSL

De forma predeterminada, el data store relacional se comunica con el servidor de alojamiento a través de HTTPS. En este ejemplo, se utiliza el parámetro --enablessl para configurar el data store relacional para que se comunique con el servidor de alojamiento a través de HTTP.

changedbproperties --store relational --enablessl false

You are changing the following database properties:
         ...disable ssl for relational store

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

Cambiar el tamaño de almacenamiento dinámico del big data store espaciotemporal

De forma predeterminada, el big data store espaciotemporal utiliza la mitad de la RAM del equipo (y el 70 por ciento de la memoria RAM libre) al iniciarse.

Precaución:

Reducir el tamaño de almacenamiento dinámico puede impedir el inicio del data store. Si aumenta el tamaño de almacenamiento dinámico, no especifique un número que supere la cantidad de memoria RAM disponible en el equipo.

En este ejemplo, el tamaño de almacenamiento dinámico se ha establecido en 1.600 MB.

changedbproperties --store spatiotemporal --heap-size 1600

You are changing the following database properties:
         ...heap size for spatiotemporal store to 1600MB (on current machine)

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

Poner en pausa el reequilibrio de los big data stores espaciotemporales

En este ejemplo, el administrador tiene que realizar un breve procedimiento de mantenimiento en un equipo en un big data store espaciotemporal y no desea que el data store se reequilibre. Para ello, las opciones --rebalance y --max-rebalance-off se utilizan para suspender el reequilibrio durante 30 minutos. Después de 30 minutos, el big data store espaciotemporal cambiará automáticamente a rebalance a true.

Dado que este proceso debe ocurrir periódicamente, el administrador mantiene la siguiente declaración en un script y establece la opción prompt en no.

changedbproperties --store spatiotemporal --rebalance false --prompt no

changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no

changeloglocation

Esta utilidad se utiliza con todos los tipos de data store.

La ubicación predeterminada del archivo de registro de errores para ArcGIS Data Store es <ArcGIS Data Store directory>\arcgisdatastore\logs. Para utilizar otro directorio de archivos, ejecute la utilidad changeloglocation y especifique la nueva ruta del directorio.

La cuenta de ArcGIS Data Store debe tener privilegios de escritura en el directorio que especifique.

Sintaxis

changeloglocation <directory path>

Ejemplo

En este ejemplo, los archivos de registro se crearán en el directorio local, d:\datastorefiles\logs.

changeloglocation 'd:\datastorefiles\logs'

changenosqldslocation

Esta utilidad se utiliza con data stores de caché de teselas.

Los data stores de caché de teselas pueden hacerse grandes si almacena muchas teselas de alta resolución en ellos. En esos casos, es posible que desee trasladar los datos a otra unidad del mismo servidor o a una ubicación compartida de otro servidor.

Si traslada los datos a un directorio compartido, debe otorgar permisos de lectura y escritura en el directorio a la cuenta de ArcGIS Data Store.

Sintaxis

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

Ejemplo

En este ejemplo, las bases de datos que almacenan cachés de capas de escena se crearán en un directorio compartido llamado dstorecache del equipo server2.

changenosqldslocation \\server2\dstorecache --prompt no

changepassword

Esta utilidad se utiliza con data stores relacionales.

ArcGIS Data Store genera aleatoriamente los nombres de usuario y las contraseñas de las cuentas de la base de datos utilizadas para los data store relacionales. Si el sitio requiere configurar sus propias contraseñas, obtenga las contraseñas de las cuentas del data store relacional y ejecute changepassword para restablecerlas.

Use la utilidad listadminusers para obtener los nombres de usuario y las contraseñas de los usuarios administradores y la utilidad listmanageduser para obtener el nombre de usuario y la contraseña del propietario de los datos de entidad.

La utilidad changepassword debe ejecutarse en el equipo de data store relacional principal. Para identificar cuál es el equipo principal, ejecute la utilidad describedatastore.

Sintaxis

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

Ejemplo

En este ejemplo, se cambia la contraseña del usuario gwi_n2Te0 to Phfl4mp!.

changepassword gwi_n2Te0 Phfl4mp

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

Si tiene que programar los cambios de las contraseñas en un script, incluya un marcador para desactivar el mensaje de confirmación, como en el ejemplo siguiente:

changepassword gwi_n2Te0 Phfl4mp --prompt no

changestaginglocation

Esta utilidad se utiliza con data store relacionales, de caché de teselas y graph store.

Al restaurar el data store relacional o de caché de teselas, ArcGIS Data Store extrae los archivos de copia de seguridad comprimidos en una ubicación provisional. Eso significa que debe disponer de una ubicación provisional que pueda albergar los datos descomprimidos. De forma predeterminada, esa ubicación se encuentra en el directorio de datos de ArcGIS Data Store. Si hay muchos datos en el data store relacional o de caché de teselas, establezca una ubicación provisional separada y especifíquela para la recuperación.

Del mismo modo, si define un bucket de S3 o un contenedor de almacenamiento Blob de Azure para los archivos de copia de seguridad del data store relacional, el data store de caché de teselas o el graph store, la ubicación provisional se utiliza para empaquetar los archivos de copia de seguridad antes de copiarlos en la ubicación de almacenamiento en la nube.

Sintaxis

changestaginglocation <directory path>

Ejemplo

En este ejemplo, la ubicación provisional designada es \\netserver\rbustage.

changestaginglocation \\netserver\rbustage

configurebackuplocation

Esta utilidad se utiliza con todos los tipos de 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 data stores 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 data stores de caché de teselas creados en el modo de respaldo principal tienen una ubicación de copia de seguridad predeterminada; los data stores de caché de teselas creados en modo de clúster no la tienen. En cualquier caso, use la utilidad configurebackuplocation con la opción register para especificar una ubicación de red compartida, un bucket de Amazon Simple Storage Service (S3) o un contenedor de almacenamiento de BLOB de Microsoft Azure para almacenar con seguridad estas copias de seguridad de data store de caché de teselas. No puede usar una unidad local para los archivos de copia de seguridad de caché de teselas si el data store se ejecuta en modo de clúster.

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 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 | tileCache | 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 | tileCache | 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ónDescripció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 data stores relacionales. La ubicación establecida con el argumento change es siempre la ubicación de copia de seguridad predeterminada para data stores relacionales.

    Debe proporcionar la opción --location cuando cambie la ubicación predeterminada de la copia de seguridad del data store 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 data store de caché de teselas que se ejecute en modo de clúster se establece como la ubicación de copia de seguridad predeterminada. Cuando se registra otra ubicación de copia de seguridad para un data store de caché de teselas (principal-en espera o modo clúster), big data store espaciotemporal o graph store, se registra una ubicación de copia de seguridad secundaria.

Para el data store 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, de caché de teselas o 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 un graph store, un data store de caché de teselas 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.

La 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 de la copia de seguridad para el data store 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 data store de caché de teselas, big data store espaciotemporales o para registrar una ubicación de copia de seguridad secundaria para un data store relacional, especifique los siguientes argumentos con la opción --location separada por un punto y coma (;) y encierre toda la cadena del argumento 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:

ArgumentoDescripció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 data store 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.

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

Para contenedores de almacenamiento de BLOB de Azure, indique el nombre de la cuenta de almacenamiento de Microsoft Azure que puede acceder al contenedor de almacenamiento de BLOB.

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ónDescripción

--force

Esta opción, que se utiliza solo con data store 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 data store 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. Si desea 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 data store relacional

En el primer ejemplo, la ubicación de copia de seguridad de un data store relacional se establece en un directorio denominado fsdata_bu, pero en un equipo denominado myshare.

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 data store relacional

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

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 --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 --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 --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 --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 --operation list --store spatiotemporal

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

configuredatastore

Esta utilidad se utiliza con todos los tipos de data store.

Después de instalar ArcGIS Data Store, puede ejecutar la utilidad configuredatastore en lugar de ejecutar el asistente de configuración de data store para crear un data store y registrarlo con un sitio de GIS Server. Mediante esta utilidad, puede crear los siguientes tipos de data store:

Otros usos de la utilidad configuredatastore son los siguientes:

  • Actualice un data store tras actualizar el software ArcGIS Data Store en todos los equipos del data store.
  • Designe el rol de un equipo en un big data store espaciotemporal.

Sintaxis

configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | graph | object}] [--mode {singleInstance | primaryStandby | cluster}] [--roles {coord | data}]

OpciónDescripción

<ArcGIS Server admin URL>

Este es el sitio de GIS Server que se utiliza o se utilizará como el servidor de alojamiento de ArcGIS Enterprise. La dirección URL de administración de ArcGIS Server tiene el formato https://gisserver.domain.com:6443.

Nota:

Aunque el sitio de GIS Server utilice un Web Adaptor o un equilibrador de carga, debe proporcionar la dirección URL en el formato indicado anteriormente.

<ArcGIS Server administrator>

Proporcione el nombre de usuario de un usuario integrado (uno no específico de la organización) que tenga privilegios de administrador en el sitio de GIS Server de alojamiento.

<ArcGIS Server administrator password>

Proporcione la contraseña de la cuenta empleada anteriormente.

<data directory>

El directorio de datos es la ubicación en el equipo local donde se crearán los archivos del data store.

--stores

Esta opción indica el tipo de ArcGIS Data Store a configurar.

Los valores válidos son los siguientes:

  • relational
  • tileCache
  • spatiotemporal
  • graph
  • object

Si no especifica la opción --stores, se asume el valor relational.

--mode

Esta elección opcional solo se aplica a los data store de caché de teselas y a almacenes de objetos.

Los valores válidos son singleInstance, primaryStandby o cluster.

Si no especifica un modo, los data store de caché de teselas se crean en modo primaryStandby y los almacenes de objetos se crean en modo singleInstance.

Los data stores de caché de teselas creados en modo primaryStandby pueden contener dos equipos. Si necesita que el data store de caché de teselas se amplíe para incluir tres o más equipos, cree un data store de caché de teselas en modo clúster. Puede utilizar la opción --mode para cambiar su data store de caché de teselas del modo primaryStandby al modo clúster.

Los almacenes de objetos creados en modo singleInstance solo pueden contener un equipo. Si necesita una alta disponibilidad, implemente el almacén de objetos en modo clúster. Cuando se utiliza en el modo de clúster, el almacén de objetos debe contener al menos tres equipos. El modo primaryStandby ya no se aplica a los almacenes de objetos. No puede cambiar los modos de un almacén de objetos. Consulte los detalles enAgregar equipos a un data store.

--roles

Esta elección opcional se aplica solo a los big data store espaciotemporales de varios equipos.

Los valores admitidos son coord, data o coord,data.

Los equipos de big data store espaciotemporales pueden crearse en cualquiera de los dos roles o en ambos. Para implementar un equipo en ambos roles, separe los dos roles con una coma; por ejemplo, especifique --role coord,data al ejecutar la utilidad configuredatastore para crear un big data store espaciotemporal en un equipo.

Para una descripción de cada rol, coordinador y datos, consulte Agregar equipos a un data store.

También puede ejecutar la utilidad configuredatastore con la opción --roles para cambiar el rol de un equipo de big data store espaciotemporal existente.

Configurar un tipo específico de data store

Especifique el tipo de data store que desea crear mediante la opción --stores, como se ha indicado anteriormente. Utilice los siguientes vínculos para obtener una descripción de cada tipo de data store:

Para configurar más de un tipo de data store en el mismo equipo, separe los tipos con comas (sin espacios). Por ejemplo, para configurar un data store relacional y de caché de teselas en el mismo equipo, especifique --stores relational,tileCache.

Nota:

Los data stores configurados en el mismo equipo compiten entre sí para conseguir memoria y otros recursos, lo que afectará negativamente al rendimiento y posiblemente causará que los data stores dejen de funcionar. Este es especialmente el caso de los big data stores espaciotemporales, los almacenes de gráficos y los almacenes de objetos; no configure un big data store espaciotemporal, un almacén de gráficos o un almacén de objetos en el mismo equipo que otro data store o componente de ArcGIS.

Si programa la creación de varios equipos de big data stores espaciotemporales, se debe configurar manualmente un equipo de big data store espaciotemporal con el sitio de GIS Server antes de poder escribir un script para la creación de equipos de big data stores espaciotemporales adicionales. Incluya tiempos de espera en su script para garantizar que los equipos de big data stores espaciotemporales adicionales no se agreguen al mismo tiempo.

Cada tipo de data store tiene un modo predeterminado en el que se ha creado. Puede especificar otro modo cuando cree un data store de caché de teselas o un almacén de objetos.

Consulte Crear un data store para obtener instrucciones.

Configurar data stores después de actualizar instalaciones de ArcGIS Data Store

Como parte de la actualización de ArcGIS Data Store, debe reconfigurar los equipos de data stores existentes. Después de instalar una nueva versión de ArcGIS Data Store sobre el ArcGIS Data Store existente en cada equipo de data store, inicie sesión en cualquier equipo de un data store y ejecute la utilidad configuredatastore para terminar de actualizar ese tipo de data store en particular. Por ejemplo, ejecute configuredatastore en el equipo de data store relacional principal y el equipo de respaldo también se actualizará.

Si un equipo contiene un data store relacional y de caché de teselas, especifique --stores relational,tileCache cuando ejecute la utilidad configuredatastore y actualizará todos los equipos de ambos data stores.

Para reconfigurar equipos del big data store espaciotemporal actualizado, inicie sesión en cualquiera de los equipos del big data store espaciotemporal y ejecute la utilidad configuredatastore. De este modo, se actualizan todos los equipos del big data store espaciotemporal.

La configuración no puede continuar hasta que instale la nueva versión de ArcGIS Data Store en todos los equipos de la implementación de ArcGIS Enterprise.

Consulte Actualizar ArcGIS Data Store para obtener más información.

Cambiar un modo de data store de caché de teselas

Para determinar el modo actual definido para el data store de caché de teselas, ejecute la utilidad describedatastore en el equipo del data store de caché de teselas.

Si necesita cambiar el modo de data store de caché de teselas de primaryStandby a clúster, ejecute la utilidad configuredatastore con la opción --mode establecida en cluster.

Nota:

Puede usar la opción --mode para especificar el data store de caché de teselas o el modo de almacén de objetos al crear el data store o para cambiar el modo del data store de caché de teselas de primaryStandby a modo clúster, pero no puede cambiar el modo al actualizar un data store de caché de teselas ni puede cambiar el modo de data store de caché de teselas de clúster a primaryStandby, y tampoco puede cambiar el modo de cualquier otro tipo de data store.

Cambiar el rol del equipo de big data store espaciotemporal

Cada clúster de big data store espaciotemporal debe tener un equipo con el rol de coordinador que actúe como coordinador actual de todos los demás equipos del clúster. El primer equipo que cree en un big data store espaciotemporal debe incluir el rol de coordinador, y este primer equipo es el coordinador actual y activo. Para garantizar que el clúster siga funcionando aunque falle el equipo coordinador actual, el clúster debe tener al menos otros dos equipos que tengan asignado el rol de coordinador.

Un clúster de big data store espaciotemporal también debe tener al menos un equipo en el rol de datos.

Los roles se asignan a los equipos cuando los agrega al clúster, como se describe en Agregar equipos a un data store. Los equipos que reúnen las condiciones para ser coordinadores pueden pasar a almacenar datos solo. A los equipos que actualmente solo tienen el rol de datos se les puede agregar el rol de coordinador.

Los cambios de rol admitidos son los siguientes:

  • Especifique --roles data para cambiar un equipo coordinador a un equipo de datos. Es posible si hay otros equipos elegibles como coordinadores en el clúster. Puede cambiar un equipo coordinador a un rol de datos si hay al menos otros tres equipos elegibles como coordinadores en el clúster.
  • Especifique --roles data para eliminar el rol de coordinador de un equipo que se implementó con ambos roles. Así, el equipo queda con el rol de datos. Puede eliminar el rol de coordinador del equipo si hay al menos otros tres equipos elegibles como coordinadores en el clúster.
  • Especifique --roles coord,data para agregar el rol de coordinador a un equipo que se implementó inicialmente para desempeñar solo el rol de datos. Como máximo cinco equipos pueden incluir el rol de coordinador. Si ya hay cinco equipos coordinadores en el clúster, no podrá agregar el rol de coordinador a un equipo de datos del clúster.

Sugerencia:

Antes de cambiar el rol de un equipo, ejecute la utilidad describedatastore en uno de los equipos para identificar qué rol tiene asignado cada equipo en el clúster de big data store espaciotemporal.

Ejemplos

En este ejemplo, se crea un data store para los datos de capas de entidades alojadas (data store relacional). La dirección URL del sitio de GIS Server que utilizará el data store es https://gisserver.domain.com:6443, el nombre de usuario y la contraseña del administrador del sitio son admin e Iph33l$ik respectivamente, y el directorio de datos del data store es C:\datastore\data\.

configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\data\ --stores relational --prompt no

En el siguiente ejemplo, un data store de caché de teselas existente (respaldo principal) se cambia a modo de clúster:

configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\scenedata\ --stores tileCache --mode cluster --prompt no

En el siguiente ejemplo, a uno de los equipos de solo datos de un clúster de big data store espaciotemporal se le agrega el rol de coordinador, lo que lo hace elegible para actuar como tal si falla el equipo coordinador actual.

configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\scenedata\ --stores spatiotemporal --roles coord,data --prompt no

configureserviceaccount

Esta utilidad se utiliza con todos los tipos de data store en servidores de Microsoft Windows.

La utilidad configureserviceaccount cambia el inicio de sesión utilizado para la cuenta ArcGIS Data Store en un solo equipo de Windows.

Si configura la cuenta mediante esta utilidad, puede exportar la información de la misma a un archivo. La contraseña está cifrada en el archivo. Puede utilizar este archivo para importar la información de la misma cuenta si, por ejemplo, configura otro ArcGIS Data Store y desea usar la misma cuenta. En ese caso, ejecute la utilidad configureserviceaccount en el nuevo equipo e importe el archivo con la información de la cuenta.

También puede usar esta utilidad para actualizar la contraseña de la cuenta de ArcGIS Data Store. Si cambia la contraseña de la cuenta de Windows, ejecute la utilidad y especifique una nueva contraseña para la cuenta.

Si definió la cuenta de ArcGIS Data Store como una cuenta de servicio administrada por un grupo, la cuenta que especifique con el parámetro de nombre de usuario puede incluir $ al final del nombre de la cuenta u omitirlo. No es necesario que especifique el parámetro de contraseña cuando utilice una cuenta de servicio administrada por un grupo.

Cuando actualice la cuenta, debe actualizarla para cada equipo del data store. Por ejemplo, si actualiza la cuenta de un big data store espaciotemporal de tres nodos, debe ejecutar la utilidad configureserviceaccount en los tres equipos.

Sintaxis

configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]

OpciónDescripción

--username

El inicio de sesión de red o la cuenta de servicio administrada por el grupo utilizado para la cuenta de ArcGIS Data Store.

Esta opción no es necesaria si la utiliza opción --readconfig.

--password

La contraseña para el inicio de sesión de red que especificó con la opción --username.

Para cambiar la contraseña de la cuenta de ArcGIS Data Store existente, ejecute la utilidad configureserviceaccount con la opción --username y especifique la nueva contraseña con la opción --password.

Esta opción no es necesaria si utiliza la opción --readconfig o si especifica una cuenta de servicio administrada por un grupo con la opción --username.

--writeconfig

Si se incluye al ejecutar la utilidad configureserviceaccount, esta opción crea un archivo de configuración que contiene las credenciales proporcionadas. La información de la contraseña está cifrada en el archivo.

--readconfig

Configura la cuenta de ArcGIS Data Store utilizando la información almacenada en un archivo de configuración que se creó utilizando la opción --writeconfig.

Si utiliza esta opción, no se requiere ninguna otra.

Ejemplo

En este ejemplo, configureserviceaccount establece la cuenta mynetwork\datastore para que ejecute el servicio ArcGIS Data Store y otorga a esta cuenta los privilegios que se requieren sobre las carpetas y archivos del sistema de ArcGIS Data Store.

configureserviceaccount --username mynetwork\datastore --password SewL0ng

En este ejemplo, se utiliza una cuenta de servicio administrada por un grupo para la cuenta de ArcGIS Data Store y la información se escribe en un archivo de configuración en el directorio de temp:

configureserviceaccount --username mydomain\datastore-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml

Nota:

Cambiar la cuenta bajo la que se ejecuta el servicio provoca que el servicio se reinicie.

En este ejemplo se cambia la cuenta de ArcGIS Data Store y la información de la cuenta se escribe en un archivo (adsainfo) en C:\adminfiles.

configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo.xml

En este ejemplo, ArcGIS Data Store está instalado en un equipo distinto y el administrador ejecuta la utilidad configureserviceaccount para establecer la misma cuenta mediante el archivo creado en el ejemplo anterior.

configureserviceaccount --readconfig C:\adminfiles\adsainfo

deletebackup

Esta utilidad se usa con los data stores relacionales y los almacenes de objetos.

La utilidad deletebackup le permite eliminar archivos de copia de seguridad que haya creado para data stores relacionales o almacenes de objetos. En primer lugar, ejecute la utilidad configurebackuplocation con la opción --operation establecida list en para obtener una lista de todas las ubicaciones de copia de seguridad configuradas para el data store. A continuación, ejecute la utilidad listbackups con una de las ubicaciones para ver los nombres y las horas de creación de las copias de seguridad en esa ubicación. Repita este paso para cada ubicación de copia de seguridad. Después, puede ejecutar la utilidad deletebackup para eliminar los archivos de copia de seguridad que ya no necesite. Debe ejecutar deletebackup por separado para cada ubicación de la que desee eliminar archivos de copia de seguridad.

Nota:

Solo podrá eliminar las copias de seguridad que no sean obligatorias para recuperar el almacén de datos. Por ejemplo, no se puede eliminar la copia de seguridad completa más reciente de un data store relacional.

Sintaxis

deletebackup <backup name> [--store {relational | object}] [--location "<backup-location>"] [--prompt {yes | no}]

Ejemplo

En el siguiente ejemplo, la copia de seguridad del data store relacional denominada featuresMarchbu se elimina de la ubicación de copia de seguridad predeterminada.

deletebackup featuresMarchbu --store relational

You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible.

Do you wish to continue (Yes or No)?yes

Operation completed successfully

En este ejemplo, el june-videobu del almacén de objetos se elimina de la ubicación de copia de seguridad denominada videobucket.

deletebackup june-videobu --store object -- location "videobucket"

You are attempting to delete backup 'june-videobu'. This operation is irreversible.

Do you wish to continue (Yes or No)?yes

Operation completed successfully

describedatastore

Esta utilidad se utiliza con todos los tipos de data store.

La utilidad describedatastore proporciona información sobre una instalación de ArcGIS Data Store. Informa sobre los tipos de data store instalados en el equipo donde se ejecuta la utilidad y proporciona información sobre cada tipo de data store en el equipo.

Nota:

Si un data store está instalado en el equipo, pero no está configurado, aparecerá como un ArcGIS Data Store disponible, pero no se devolverá información adicional para ese tipo de data store.

Alguna información es común a todos los tipos de data store y otra es específica de un tipo de data store. Las tablas siguientes enumeran y explican las propiedades devueltas por la utilidad describedatastore:

Propiedades generales

Los valores de estas propiedades son los mismos para todos los tipos de data store instalados en el equipo.

PropiedadDescripción

Versión de ArcGIS Data Store

El número de versión del software para la instalación de ArcGIS Data Store.

Ubicación provisional

Para los data store relacionales y de caché de teselas, la ubicación provisional es donde ArcGIS Data Store extrae los archivos de copia de seguridad comprimidos antes de restaurar el data store. Si un data store tiene una ubicación de almacenamiento en la nube configurada para las copias de seguridad, los archivos de copia de seguridad se colocan primero en la ubicación provisional antes de copiarse en la ubicación de almacenamiento en la nube.

Para cambiar la ubicación provisional, utilice la utilidad changestaginglocation.

Ubicación de registro

El directorio de archivos en el que ArcGIS Data Store escribe los archivos de registro.

Para cambiar la ubicación del archivo de registro, utilice la utilidad changeloglocation.

Espacio libre en disco

La cantidad de espacio en disco disponible que queda en el equipo donde ArcGIS Data Store está instalado

Propiedades comunes

Estas propiedades aparecen para cada tipo de data store, pero sus valores son específicos del data store para el que aparecen.

PropiedadDescripción

Ubicación de copia de seguridad

La ubicación predeterminada de la copia de seguridad utilizada por cada tipo de data store.

Programación de copias de seguridad

Para las copias de seguridad automatizadas, con qué frecuencia se crea una copia de seguridad de cada tipo de data store.

Estado de data store

Indica si el data store se está ejecutando.

URL del sistema propietario

El sitio de GIS Server de alojamiento en el que está registrado el data store.

Suele tratarse del mismo servidor de alojamiento para todos los data store del equipo; sin embargo, es posible tener data store en el mismo equipo que se utilicen con otras implementaciones de ArcGIS Enterprise.

URL de Portal for ArcGIS

Normalmente se trata de la misma URL de Portal for ArcGIS para todos los data store del equipo; sin embargo, es posible tener data stores en el mismo equipo que se utilicen con otras implementaciones de ArcGIS Enterprise.

Equipos registrados

Una lista de todos los equipos del tipo de data store específico. Esta propiedad enumera todos los equipos independientemente de su estado.

Propiedades de data store relacionales

Estas propiedades son específicas de la implementación de un data store relacional.

PropiedadDescripción

Días de conservación de la copia de seguridad

El número de días que se conservan los archivos de copia de seguridad del data store relacional antes de que ArcGIS Data Store los borre.

¿Está habilitada la recuperación de un punto en el tiempo?

Indica si el data store relacional está configurado para crear copias de seguridad incrementales, que le permiten restaurarlo a un punto específico en el tiempo.

Este ajuste se configura mediante la utilidad changedbproperties.

SSL habilitada

Indica si está habilitada la comunicación SSL.

Umbral para el modo READONLY

El umbral de espacio libre en disco a partir del cual el data store relacional se pondrá en modo de solo lectura.

Puede cambiar este valor para el data store relacional utilizando la utilidad changedbproperties.

Conexiones máximas

Indica el número máximo permitido de conexiones al data store relacional.

Número de conexiones

El número de conexiones de capa de entidades actuales al data store relacional

Modo de data store

Indica si el data store está en modo lectura-escritura o solo lectura.

Última conmutación por error

Esta propiedad informa de la fecha y hora más recientes en las que falló el equipo principal, lo que provocó que el equipo de respaldo ascendiera al rol de principal.

Esta propiedad no aparece si el data store nunca ha fallado.

Propiedades del data store de caché de teselas

Estas propiedades son específicas de la implementación de un data store de caché de teselas.

PropiedadDescripción

Equipos miembros

Si el data store de caché de teselas se implementa en modo clúster, esta propiedad proporciona una lista de los equipos activos y disponibles en el clúster.

Última conmutación por error

Para los data store de caché de teselas que se ejecutan en modo principal-de respaldo, esta propiedad informa de la fecha y hora más recientes en las que falló el equipo principal, lo que provocó que el equipo de respaldo se ascendiera al rol de principal.

Esta propiedad no aparece si el data store nunca ha fallado.

Modo de implementación

Indica si el data store de caché de teselas se está ejecutando en modo principal-de respaldo o en modo clúster.

SSL habilitada

Indica si está habilitada la comunicación SSL.

Propiedades del big data store espaciotemporal

Estas propiedades son específicas de la implementación del big data store espaciotemporal.

PropiedadDescripción

Se finaliza el clúster

Indica si el clúster contiene el número mínimo requerido de equipos coordinadores y de datos.

Reequilibrado automático

Si el valor de esta propiedad está establecido en on, el big data store espaciotemporal distribuye los datos a otros equipos si alguno de ellos no está disponible. Si el valor de esta propiedad está establecido en off, los datos no se redistribuirán si un equipo no está disponible.

Esta configuración se modifica mediante la utilidad changedbproperties.

Tiempo de max-rebalance-off

Al deshabilitar el reequilibrado (en cuyo caso, el valor de la propiedad Reequilibrado automático se establecerá en off), solo se deshabilitará durante el número de minutos indicado por esta propiedad. Al final de este periodo de tiempo, el valor de la propiedad Reequilibrado automático se establecerá en on.

Esta configuración se modifica mediante la utilidad changedbproperties.

Umbral para el modo READONLY

El umbral de espacio libre en disco a partir del cual el big data store espaciotemporal se pondrá en modo de solo lectura.

Equipos miembros

Una lista de los equipos activos y disponibles en el clúster de big data store espaciotemporal.

Modo de data store

Indica si el data store está en modo lectura-escritura o solo lectura.

Equipo coordinador actual en el clúster

El equipo del big data store espaciotemporal que actúa actualmente como coordinador de todos los equipos del clúster.

Equipos candidatos a coordinador en clúster espaciotemporal

Equipos en el big data store espaciotemporal que tienen asignado el rol de coordinador y, por tanto, pueden convertirse en el coordinador actual.

Equipos de datos en el clúster espaciotemporal

Equipos en el big data store espaciotemporal a los que se asigna el rol de datos.

Propiedades del graph store

Estas propiedades son específicas de la implementación de un graph store.

PropiedadDescripción

Modo de implementación

Indica si el data store se implementó en una instancia única o en modo clúster.

Última conmutación por error

Esta propiedad informa de la fecha y hora más recientes en las que falló el equipo principal, lo que provocó que el equipo de respaldo ascendiera al rol de principal.

Esta propiedad no aparece si el data store nunca ha fallado.

Propiedades del almacén de objetos

Estas propiedades son específicas de la implementación de un almacén de objetos.

PropiedadDescripción

Modo de implementación

Indica si el data store se implementó en una instancia única o en modo clúster. Los almacenes de objetos creados con una versión anterior a la 11.1 de ArcGIS Data Store informarán del modo principal-de respaldo, pero solo pueden contener un equipo.

Sintaxis

describedatastore

Ejemplo

La utilidad describedatastore devuelve información general que se aplica a todos los data stores de un equipo y devuelve secciones separadas que contienen información concreta de cada tipo de data store.

Debe tener distintos data stores en distintos equipos; no obstante, con el objeto de que pueda ver la información devuelta para cada tipo, la salida siguiente muestra un equipo que tiene todos los tipos de ArcGIS Data Store en el mismo equipo. Siempre se devuelven las dos primeras secciones (Data store de ArcGIS disponibles e Información general). Las secciones del data store devueltas por describedatastore varían en función del tipo de data store presente en el equipo en el que se ejecuta la utilidad.

describedatastore

Available ArcGIS Data Stores
==============================================================
Relational Data Store
Tile Cache Data Store
Spatiotemporal Big Data Store
Graph Store
Object Store

General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....11.3.0.1234
Staging location.............C:\arcgisdatastore\staging
Log location.................C:\arcgisdatastore\logs
Free disk space..............174.00GB

Information for relational data store ds_sthiu0_5T
==============================================================
Backup location..............\\nwshare\dsbackups
Backup schedule..............{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained.........31
Data store status............Started
SSL enabled..................true
Last failover................20150130190334005
Threshold for READONLY mode..2048MB
Registered machines..........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections..........150
Owning system URL............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL........https://portal_webadaptor.domain.com/portal
Number of connections........8 connection(s) to managed database
Data store mode..............READWRITE
Is point-in-time recovery enabled...No

Information for tile cache data store ds_wztxj7um
==============================================================
Data location..............C:\arcgisdatastore\nosqldata
Data store status..........Started
Backup location............\\mybackups\scenebackup
Backup schedule............{"schedule-starttime":"01:00:00","schedule-frequency":"Every 1 DAYS"}
Deployment mode............cluster
SSL enabled................true
Member machines............MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines........MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL..........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL......https://portal_webadaptor.domain.com/portal

Information for spatiotemporal data store ds_qpko99Cl
==============================================================
Is cluster finalized................Yes
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Threshold for READONLY mode.........1024MB
Backup location.....................\\nwshare2\sbds_bu
Backup schedule.....................{"schedule-starttime":"02:00:00","schedule-frequency":"Every 2 DAYS"}
Member machines.....................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Coordinator candidate machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator machine in cluster......MACHINE1.DOMAIN.COM
Data machines in spatiotemporal cluster.....MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines.................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data store mode.....................READWRITE

Information for graph store x2b7s0n
==============================================================
Deployment mode.............primaryStandby
Backup location.............\\nwshare3\graphbu
Backup schedule.............{"schedule-starttime":"03:00:00","schedule-frequency":"Every 3 DAYS"}
Registered machines.........MACHINE1.DOMAIN.COM
Owning system URL...........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL.......https://portal_webadaptor.domain.com/portal

Information for object store w1tiknx
==============================================================
Deployment mode.............singleInstance
Backup location.............\\nwshare4\myfiles\ods_bu
Backup schedule.............{"schedule-starttime":"04:00:00","schedule-frequency":"Every 2 DAYS"}
Registered machines.........MACHINE1.DOMAIN.COM
Owning system URL...........https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.......https://portal_webadaptor.domain.com/portal

diskcleanup

Esta utilidad se utiliza con big data stores relacionales, de caché de teselas y espaciotemporales.

La utilidad diskcleanup elimina archivos temporales que quedan de operaciones como restoredatastore y la actualización de ArcGIS Data Store. Determinados archivos se conservan después de la actualización, lo que le permitirá solucionar un error de la operación de actualización o restauración. Después de que haya confirmado que la operación de actualización o restauración es correcta y el sistema funciona de la forma esperada, puede ejecutar esta herramienta para eliminar esos archivos temporales y recuperar el espacio libre en el disco en los equipos de data store.

Esta utilidad limpia el espacio en disco de un equipo a la vez. Si necesita limpiar archivos en más de un equipo del mismo data store, debe ejecutar la herramienta en cada equipo.

Sintaxis

diskcleanup

Ejemplo

Para ejecutar la utilidad diskcleanup, debe confirmar que desea continuar.

diskcleanup

You are attempting to cleanup some archived data generated as part of ArcGIS Data Store upgrades or backup-restore operations. Once removed, this data can't be recovered. Do you want to continue (Yes or No)?

listadminusers

Esta utilidad se utiliza con todos los tipos de data store.

La utilidad listadminusers devuelve los nombres de usuario y las contraseñas del administrador, del propietario de la réplica y del administrador de la geodatabase de un data store relacional. Devuelve las credenciales de administrador para todos los demás tipos de data store.

Sintaxis

listadminusers

Ejemplos

En este ejemplo, listadminusers se ejecuta en un equipo en el que solo hay un data store relacional instalado.

listadminusers

Admin users for relational data store ds_abcd1234
=================================================
Database Admin User.... adm_32ret / tT30sbYk22jF
Database Repl User..... dsrepuser / uWn/MV0678h4
GDB Admin User......... sde / iO=Qst751epb

En este ejemplo, listadminusers se ejecuta en un equipo en el que solo hay un big data store espaciotemporal instalado.

listadminusers

Admin users for spatiotemporal big data store bds_abcd1234
=================================================
Store admin user.... els_321ret / B1as70fF1

En este ejemplo, listadminusers se ejecuta en un equipo en el que solo hay un graph store instalado.

listadminusers

Admin users for graph store s2t0ic1
=================================================
Store admin user....root / ypz5kx2c5tk4fequ

En este ejemplo, listadminusers se ejecuta en un equipo en el que solo hay un almacén de objetos instalado.

listadminusers

Admin users for object store w1tiknx
=================================================
Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4

listbackups

Esta utilidad se utiliza con todos los tipos de data store.

Cuando se ejecuta para data stores relacionales, la utilidad listbackups solo funciona en el equipo del data store principal.

Ejecute la utilidad listbackups para determinar lo siguiente:

  • La hora de inicio de una operación de copia de seguridad
  • Si una copia de seguridad ha finalizado o si se está ejecutando
  • Si la copia de seguridad se creó manualmente con la utilidad backupdatastore o bien si la creó automáticamente con ArcGIS Data Store
  • Qué archivos de copia de seguridad son viables. Si la utilidad listbackups no devuelve el archivo de copia de seguridad, no podrá utilizarse para restaurar el data store. Por ejemplo, es posible que los archivos de copia de seguridad creados con una versión anterior de ArcGIS Data Store no funcionen para restaurar el data store.
  • Cuántos archivos de copia de seguridad tiene para determinar si necesita eliminar alguno
  • Confirmar nombres de archivo de copia de seguridad antes de ejecutar la utilidad deletebackup

Cuando ejecute la utilidad listbackups, especifique la ubicación de copia de seguridad cuya lista de archivos de copia de seguridad desea ver. Si no especifica una ubicación, la utilidad listbackups devuelve copias de seguridad de la ubicación de copia de seguridad predeterminada.

Sintaxis

listbackups [--store {relational | tileCache | spatiotemporal | graph | object}] [--location "<location_arguments>"]

Si no especifica ningún tipo de data store (--store), el valor predeterminado de la utilidad es relational y devuelve las copias de seguridad del data store relacional en ejecución en ese equipo. Si el data store relacional no está presente en el equipo donde ejecuta la utilidad, esta devolverá un mensaje de error.

Utilice la opción --location para descubrir la información de las copias de seguridad en una ubicación de copia de seguridad específica registrada. Si no especifica una ubicación, se devuelve información sobre la ubicación predeterminada de la copia de seguridad. Proporcione uno de los siguientes argumentos con la opción --location:

ArgumentoDescripción

name=

Indique el nombre de la ubicación de la copia de seguridad. Especificó este nombre al configurar la ubicación de copia de seguridad o, si no especificó un nombre, ArcGIS Data Store asignó un nombre predeterminado.

location=

Especifique la ruta al directorio de archivos compartidos, al bucket de S3 o al contenedor de almacenamiento Blob que registró como ubicación de la copia de seguridad.

Ejemplos

En este ejemplo, se enumeran las copias de seguridad para la ubicación de copia de seguridad predeterminada de un data store relacional:

listbackups --store relational

Backup_Name              Status           Backup_Time         Mode
=======================================================================
phase1proj_bu            BackupComplete   2023-03-08 14:12    manual
phase2proj_bu            BackupComplete   2023-02-21 11:43    manual
ds_gdt1omh-2023020130    BackupComplete   2023-02-01 03:00    scheduled

Backups located at: '\\myserver.net.com\dsbackups'

En este ejemplo, se muestra una lista de copias de seguridad del big data store espaciotemporal para la ubicación de copia de seguridad llamada sbdsbu:

listbackups --store spatiotemporal --location "name=sbdsbu"

Backup_Name          Status           Backup_Time         Mode
==================================================================
backup1						        BackupComplete   2023-07-11 09:47    manual

Backups located at: '\\myserver.net.com\spatiotemporal'

listdatasources

Esta utilidad se utiliza con big data stores espaciotemporales.

Debido a un error en 10.8.1, los servicios de mapas de ArcGIS GeoEvent Server que utilizan agregación cuadrada o hexagonal no se renderizan después de actualizar a 10.9 o posterior. Para corregirlo, puede ejecutar la utilidad listdatasources para obtener los nombres de los servicios de mapas de GeoEvent Server y utilizar los nombres de servicio que devuelve con la utilidad upgradedatasource para actualizar los datos de cada servicio separado.

La utilidad listdatasources se puede ejecutar en cualquier equipo de big data store espaciotemporal.

Sintaxis

listdatasources

Ejemplo

Ejecute la utilidad listdatasources en una ventana de comando para que se devuelva una lista de servicios de mapas de GeoEvent Server.

listdatasources

listmanageduser

Esta utilidad se utiliza con todos los tipos de data store.

La utilidad listmanageduser devuelve el nombre de usuario y la contraseña de la cuenta propietaria de los datos de capa de entidades alojados en big data stores relacionales y espaciotemporales. Esta utilidad también devuelve el nombre de usuario y la contraseña del propietario de la caché de escenas para los data store de caché de teselas, el propietario de los gráficos en el graph store y el propietario de los vídeos en el almacén de objetos.

Sintaxis

listmanageduser

Ejemplos

En el siguiente ejemplo, listmanageduser se ejecuta en un equipo que contiene un data store relacional y de caché de teselas. El equipo es el data store relacional principal.

listmanageduser

Managed user for relational data store ds_abcd1234
===================================================
UserName     Password       Database
gwi_n2Te0    4cXddhZhve=Y   db_qv5e1

Managed user for tile cache data store tcs_e41f0rj2
===================================================
UserName     Password
usr_n8778    y47ccno913

En este ejemplo, listmanageduser se ejecuta en un equipo del big data store espaciotemporal.

listmanageduser

Managed user for spatiotemporal big data store bds_6udbx4321
=============================================================
UserName     Password
fmr_o1He3    5vZggkPbaw+T

En este ejemplo, listmanageduser se ejecuta en un equipo del graph store.

listmanageduser

Managed user for graph store s2t0ic1 
================================================ 
UserName   Password 
mu_vwmp8c6 m5c2so76y3b0qczf

En el siguiente ejemplo, listmanageduser se ejecuta en un equipo de almacén de objetos.

listmanageduser

Managed user for object store w1tiknx
=============================================================
Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4

registerdatastore

Esta utilidad se utiliza con todos los tipos de data store.

El data store conserva información sobre los nombres de los equipos del sitio de GIS Server de alojamiento. Si traslada el sitio de GIS Server de alojamiento a equipos nuevos (por ejemplo, si tiene hardware nuevo o si fallan los equipos de GIS Server existentes), debe dar de baja el data store del sitio de GIS Server para eliminar esta información. Después de configurar GIS Server en un nuevo equipo (o equipos), registre el data store con el sitio de GIS Server mediante la utilidad registerdatastore.

Nota:

La utilidad registerdatastore se utiliza para registrar el data store en el mismo sitio de GIS Server en el cual se registró previamente. El data store contiene los datos de las capas alojadas en el sitio de GIS Server existente. Registrarlo en otro sitio de GIS Server no hace que se vuelvan a crear las capas alojadas.

La utilidad registerdatastore puede ejecutarse en el equipo de data store relacional principal o en el equipo de graph store o en el equipo principal de un data store de caché de teselas que esté ejecutándose en modo principal-de respaldo. Se puede ejecutar en cualquier equipo en un data store de caché de teselas o un almacén de objetos que se ejecuten en modo de clúster o en cualquier equipo de big data store espaciotemporal.

Sintaxis

registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator username> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | graph | object}

Aunque no se recomienda, si tiene varios tipos distintos de data stores instalados en el mismo equipo, puede registrarlos al mismo tiempo especificando el tipo de data store separado por una coma (sin espacios); por ejemplo, escriba --stores relational,tileCache.

Ejemplo

En este ejemplo, un data store relacional se vuelve a registrar en un sitio de GIS Server con la URL https://gisserver.domain.com:6443. El nombre de usuario del administrador principal del sitio de ArcGIS Server es agsadmin con la contraseña Tan$p0n.

registerdatastore https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational

removemachine

Esta utilidad se utiliza con data stores relacionales, de caché de teselas, big data stores espaciotemporales y graph stores.

Use la utilidad removemachine para quitar un equipo de un data store que tiene más de un equipo. La utilidad removemachine se usa en estos casos:

  • Elimine un equipo de respaldo de un data store relacional o un graph store. Puede ejecutar esta utilidad en el equipo de respaldo o desde el equipo principal en el caso de que el equipo de respaldo no esté disponible.
  • Eliminar un equipo de un data store de caché de teselas. Puede ejecutar esta utilidad en cualquier equipo del data store de caché de teselas, pero no puede ejecutar removemachine en un data store de caché de teselas compuesto por un único equipo.
  • Eliminar un equipo de un big data store espaciotemporal. Puede ejecutar esta utilidad en cualquier equipo del big data store espaciotemporal, pero no puede ejecutar removemachine en un big data store espaciotemporal compuesto por un único equipo.

    Si ejecuta esta utilidad en el equipo coordinador actual, uno de los equipos elegibles para la administración que queden en el clúster deberá asumir la función de coordinador actual. Para que esto ocurra, debe haber al menos otros dos equipos en el clúster que tengan asignado el rol de administrador. Antes de eliminar un equipo, ejecute la utilidad describedatastore para identificar qué equipo es el coordinador actual y cuáles pueden serlo.

Sintaxis

removemachine <machine name> --store {relational | tileCache | spatiotemporal | graph} [--force {true | false}] [--prompt {yes | no}]

Debe proporcionar el nombre del equipo y el tipo de data store.

Especifique true con la opción --force solo si el sitio de ArcGIS Server registrado no está disponible.

De forma predeterminada, se le pedirá que confirme la ejecución de la utilidad. Si no desea confirmar la acción, especifique no con la opción --prompt.

Ejemplos

En este ejemplo, el equipo del big data store espaciotemporal, gefour, se elimina del data store.

removemachine gefour --store spatiotemporal --prompt no

En este ejemplo, el sitio del servidor de alojamiento no está disponible y el equipo del big data store relacional, fsdata, se elimina del data store.

removemachine fsdata --store relational --force true --prompt no

replacesslcertificate

Esta utilidad se utiliza con todos los tipos de data store.

Puede sustituir el certificado autofirmado de ArcGIS Data Store que utiliza el servidor web para autenticar la comunicación entre el servidor de alojamiento y el data store y entre los equipos del data store con un certificado verificado y firmado por una autoridad de certificación (CA) o un certificado de dominio. También puede sustituir el certificado autofirmado utilizado para la comunicación entre equipos a través de puertos para los siguientes tipos de data store:

  • Data store relacional
  • Data store de caché de teselas
  • Graph store
  • Almacén de objetos

Esta utilidad acabará sustituyendo a la utilidad updatesslcertificate.

Para obtener más información, consulte Reemplazar el certificado SSL de ArcGIS Data Store.

Sintaxis

replacesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate> --option <webserver | relational | graph | object | tileCache>

Ejemplos

En el siguiente ejemplo, el certificado autofirmado utilizado para la autenticación del servidor web se sustituye por un archivo de certificado firmado por una CA (mysignedcert.pfx).

replacesslcertificate C:\myfiles\mysignedcert.pfx "ps4mycert" "mycacert" --option webserver

En el siguiente ejemplo, el certificado autofirmado utilizado para la comunicación con el data store relacional a través de los puertos se sustituye por un certificado firmado por una CA (mysecondsignedcert.pfx).

replacesslcertificate C:\myfiles\mysecondsignedcert.pfx "ps4mycert" "relcacert" --option relational

restoredatastore

Esta utilidad se utiliza con todos los tipos de data store.

Si pierde el acceso a los datos utilizados por sus capas alojadas, utilice sus archivos de copia de seguridad y la utilidad restoreatastore para recuperar el data store

Si no puede recuperar el data store, instale ArcGIS Data Store en un equipo nuevo, no configure el data store y restaure la última copia completa de seguridad en el equipo nuevo.

Si utiliza un data store relacional y quiere recuperar los datos de la entidad de capas alojadas de una fecha pasada, restáurelos sobrescribiendo el data store relacional.

Nota:

El data store relacional debe estar configurado para admitir la recuperación de un punto en el tiempo y solo podrá restaurar a un estado anterior del data store relacional para el que disponga de archivos de copia de seguridad. Por ejemplo, si solo conserva copias de seguridad de los últimos cinco días, solo podrá recuperar el almacén de datos de una fecha incluida en esos cinco días.

Si necesita reemplazar uno de los equipos en un data store de caché de teselas de varios equipos, es muy probable que tenga que reequilibrar las cachés de capas de escenas en todo el data store de caché de teselas. Una parte del proceso requiere que restaure el data store de caché de teselas, con la opción replicatedata definida como true. Consulte Recuperar un data store para obtener instrucciones.

La utilidad restoredatastore se puede ejecutar en el equipo de data store relacional principal. La utilidad puede ejecutarse en cualquiera de los equipos de data store de caché de teselas, big data store espaciotemporal, graph store o almacén de objetos.

Nota:

Para descubrir qué archivos de copia de seguridad puede utilizar para restaurar, ejecute la utilidad listbackups.

Sintaxis

restoredatastore [options]

Las opciones compatibles se enumeran en la tabla siguiente:

OpciónDescripción

--store

Indica el tipo de data store a restaurar.

Los valores válidos son relational, tileCache, spatiotemporal, graph o object.

--target

Los valores válidos son most-recent, la marca de tiempo del archivo de copia de seguridad en el formato <yyy-mm-dd-hh:mm:ss> o el nombre del archivo de copia de seguridad.

Todos los tipos de data store admiten el nombre de archivo de copia de seguridad con la opción target. Una marca de tiempo y most-recent solo se admiten para data store relacionales.

Al restaurar después de un fallo o para mover el data store relacional, especifique --target most-recent. Si va a restaurar un data store relacional a un punto en el tiempo, lo que requiere que el data store relacional esté configurado para permitir la recuperación a un punto en el tiempo, especifique la fecha y hora (en UTC) a la que desea restaurar el data store. Si dispone de un archivo de copia de seguridad específico que desea restaurar, indique el nombre del archivo de seguridad en su lugar. Si no especifica un objetivo, se restaurará la última copia de seguridad.

--source-loc

Este es el directorio superior en el que se encuentran los archivos de copia de seguridad que desea utilizar para restaurar el data store. Esta será la ruta a la ubicación de un recurso compartido de archivos, un nombre de ubicación de copia de seguridad o una ubicación de copia de seguridad de almacenamiento de Amazon S3 o de Blob de Azure.

Sugerencia:

Para obtener las ubicaciones de origen de las copias de seguridad, puede ejecutar la utilidad configurebackuplocation con la opción --operation establecida en list. Si no puede ejecutar la utilidad configurebackuplocation utility -por ejemplo, si el equipo del data store falla y lleva a cabo la restauración en un nuevo equipo para recuperar el data store- puede identificar la ubicación de la fuente de copia de seguridad si existe un archivo llamado agsds_backup_sig.

--bound

Los valores válidos son true o false.

La opción --bound se admite solo con data store relacionales.

De forma predeterminada, se supone que está restaurando el data store relacional para que funcione con el mismo sitio de GIS Server con el que estaba registrado cuando creó la copia de seguridad. Solo se especifica --bound false para restaurar el data store sin mantener la asociación con el sitio de GIS Server del data store. Si trasladó los servicios alojados a otro GIS Server, puede establecer la opción --bound como false y especificar la URL del nuevo sitio de GIS Server con la opción --server-url al restaurar.

También podría restaurar el data store relacional desvinculado de su GIS Server como último recurso si el sitio de GIS Server se perdiera y no pudiera recuperarse; podría restaurar el data store desvinculado y configurarlo con un nuevo sitio de GIS Server federado. Sin embargo, las capas que han utilizado los datos del data store ya no existirían. Tendría que conectarse a la base de datos del data store para extraer los datos en otro formato y volver a publicarlos en ArcGIS Enterprise.

--data-dir

Este es el directorio de ArcGIS Data Store en el equipo en el que está restaurando la base de datos. Utilice solamente --data-dir si restaura el data store en un equipo nuevo. Si restaura en un equipo nuevo, también debe especificar la opción --source-loc.

--server-url

Si especifica --bound true (u omite la opción --bound) para mantener el data store registrado en el mismo sitio de GIS Server en el que estaba registrado cuando creó la copia de seguridad, especifique la URL de ese sitio de GIS Server. Si especifica --bound true y ha trasladado los servicios a un nuevo sitio de GIS Server, utilice la opción --server-url para especificar la dirección URL del nuevo sitio de GIS Server. Si especifica una nueva URL del sitio y no ha trasladado los servicios a este nuevo servidor, no se podrá acceder a los datos del data store.

--server-admin

Esta opción es obligatoria si especifica --bound true o si no especifica la opción --bound. Proporcione el nombre de usuario del administrador de ArcGIS Server.

--server-password

Esta opción es obligatoria si especifica --bound true o si no especifica la opción --bound. Proporcione la contraseña del administrador de ArcGIS Server.

--loaddata

Se admite con big data store espaciotemporales y de caché de teselas, así como con graph stores y almacenes de objetos.

Los valores válidos son true o false.

Establezca esta opción en false cuando necesite restaurar el data store en un nuevo conjunto de equipos, pero los datos no quepan en el primer equipo. Así puede restaurar el esquema del data store, agregar más equipos al data store para acomodar todos los datos y, a continuación, ejecutar la utilidad restoredatastore de nuevo con --loaddata establecido en true para restaurar los datos. De forma predeterminada, esta opción tiene el valor true.

--replicatedata

Se admite con data store de caché de teselas.

Los valores válidos son true o false.

Defina esta opción como true cuando tenga que reequilibrar los datos de la caché de escenas tras agregar un equipo al data store de caché de teselas.

--mode

Los valores válidos son primaryStandby o cluster.

Al restaurar un data store de caché de teselas en un nuevo equipo, especifique si desea un data store de caché de teselas de dos equipos para mayor disponibilidad (primaryStandby) o un data store de caché de teselas de varios equipos escalable (cluster).

--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 este ejemplo, la copia de seguridad más reciente se encuentra en la ubicación predeterminada de copia de seguridad llamada rdsbackups y se restaura en el data store existente. Como el tipo de data store predeterminado es relacional y sigue vinculado de manera predeterminada al sitio de GIS Server en el que se registró, no tiene que especificar --store relational ni --bound true. Sin embargo, no tiene que especificar la URL ni las credenciales de administrador de GIS Server.

restoredatastore --target most-recent --source-loc rdsbackups --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s

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

En este ejemplo, un data store relacional con la recuperación de punto en el tiempo habilitada se restaura desde la ubicación de copia de seguridad del data store relacional en un recurso compartido de red al estado en que se encontraba a las 2:30 p.m (UTC) del 17 de julio de 2014.

restoredatastore --target 2014-07-17-14:30:00 --source-loc \\sharedserver\entbackups\relds --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s

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

En este ejemplo, el data store relacional se restaura en un equipo nuevo mediante un archivo de copia de seguridad denominado movedatastore. Si restaura en un equipo nuevo, debe especificar la ubicación del archivo de copia de seguridad y la ubicación del nuevo directorio de datos ArcGIS Data Store. Como los servicios de entidades alojados todavía se están ejecutando en el mismo sitio de GIS Server en el que se registró el data store relacional, --bound true no se requiere, pero la URL y las credenciales de administrador de GIS Server sí.

restoredatastore --target movedatastore --source-loc \\buserver\data\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s

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

En el siguiente ejemplo, el data store de caché de teselas se restaura en un equipo nuevo. Si restaura en un equipo nuevo, debe especificar la ubicación del archivo de copia de seguridad y la ubicación del nuevo directorio de datos ArcGIS Data Store. Como los servicios de escenas todavía se están ejecutando en el mismo sitio de GIS Server en el que se registró el data store de caché de teselas, --bound true no se requiere, pero la URL y las credenciales de administrador de GIS Server sí.

restoredatastore --store tilecache --source-loc \\buserver\scenedata\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $SAup.4s

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

En este ejemplo, el data store de caché de teselas se restaura a partir de un archivo llamado mybackupfilename para reequilibrar los datos de la caché de escenas tras agregar un nuevo equipo al data store de caché de teselas.

restoredatastore --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true

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

En el siguiente ejemplo, se restaura un archivo de copia de seguridad de un big data store espaciotemporal (bds1) desde una ubicación de copia de seguridad llamada awsloc.

restoredatastore --target bds1 --store spatiotemporal --source-loc name=awsloc --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s

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

Consulte Recuperar un data store para ver los pasos que tiene que seguir y obtener un ejemplo de restauración de un big data store espaciotemporal después de un fallo de hardware.

revokeconnection

Esta utilidad se utiliza con data stores relacionales.

Si ha usado la utilidad allowconnection para permitir temporalmente que otro cliente se conecte directamente con el data store relacional, puede revocar la capacidad de conexión ejecutando la utilidad revokeconnection.

La utilidad revokeconnection solo se puede ejecutar en el equipo de data store relacional principal.

Sintaxis

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

Ejemplo

En este ejemplo, la base de datos del almacén de datos no aceptará más conexiones desde el equipo workcom cuando se inicie sesión como usuario hqo.n_1E7.

revokeconnection workcom hqo.n_1E7

unregisterdatastore

Esta utilidad se utiliza con todos los tipos de data store.

Puede usar la utilidad unregisterdatastore para realizar lo siguiente:

  • Dé de baja un data store de un solo equipo de cualquier tipo del sitio de GIS Server de alojamiento.

    Tras dar de baja un almacén de objetos, debe reiniciar el servidor de alojamiento.

  • En los data store que se ejecutan en modo principal-de respaldo, puede anular el registro del equipo principal después de eliminar el equipo de respaldo.
  • En el caso de los big data store espaciotemporales y de los data store de caché de teselas que se ejecutan en modo clúster, puede dar de baja el último equipo después de eliminar todos los demás equipos del clúster.

Nota:

Si anula el registro del data store para eliminarlo permanentemente de la implementación, elimine las capas alojadas que utilicen los datos antes de anular el registro de ese data store. Por ejemplo, si los miembros de la organización estaban probando las GeoAnalytics Tools y utilizaban el big data store espaciotemporal para las capas creadas por las herramientas, pero determinaron que las capas podrían almacenarse en su lugar en el data store relacional, elimine las capas de entidades espaciotemporales alojadas de prueba antes de anular el registro del big data store espaciotemporal. Si no lo ha hecho, quedarán elementos de capa inutilizables en el portal y servicios inutilizables ejecutándose en el servidor de alojamiento.

Al anular el registro de un equipo del data store, el sitio de GIS Server de alojamiento (o el sitio de ArcGIS Knowledge Server en el caso de los gráficos de conocimiento) ya no podrá conectarse a ese equipo y todos los servicios que contenían datos del data store sin registrar dejarán de funcionar. Sin embargo, esta utilidad no elimina los datos; si decide que necesita el data store, puede utilizar las utilidades registerdatastore o configuredatastore para volver a agregarlo.

Sintaxis

unregisterdatastore --stores {relational | tileCache | spatiotemporal | graph | object} [--prompt {yes | no}]

Si tiene más de un tipo de data store instalado en el mismo equipo y desea dar de baja más de uno a la vez, especifique cada tipo de data store separado por una coma (sin espacios). Por ejemplo, para dar de baja un data store relacional y de caché de teselas, escriba --stores relational,tileCache.

Ejemplo

Aquí, la utilidad unregisterdatastore se ejecuta para dar de baja los data stores relacionales y de caché de teselas del sitio de GIS Server. Se devuelve una solicitud, que es el comportamiento predeterminado. Para suprimir la solicitud, especifique --prompt No.

unregisterdatastore --stores relational,tileCache

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

updatebackupretaindays

Esta utilidad se utiliza con data stores relacionales.

ArcGIS Data Store mantiene los archivos de copia de seguridad del data store relacional durante siete días de manera predeterminada. Puede cambiar la frecuencia con que las copias de seguridad se eliminan del directorio de copia de seguridad ejecutando la utilidad updatebackupretaindays.

La utilidad updatebackupretaindays solo se puede ejecutar en el equipo de data store relacional.

Sintaxis

updatebackupretaindays <number of days>

Ejemplo

En el siguiente ejemplo, el tiempo de retención del archivo de copia de seguridad se ha cambiado a 10 días:

updatebackupretaindays 10

updatebackupschedule

Esta utilidad se utiliza con todos los tipos de data store.

De forma predeterminada, ArcGIS Data Store crea una copia de seguridad completa del data store relacional cada cuatro días. Puede cambiar la frecuencia con que se crea una copia de seguridad completa ejecutando la utilidad updatebackupschedule.

No hay ninguna copia de seguridad automática predeterminada para big data stores de caché de teselas o espaciotemporales ni para graph stores. Para establecer una periodicidad de la copia de seguridad automática para un big data store espaciotemporal, primero debe establecer una ubicación válida para la copia de seguridad.

Especifique una hora de inicio con el formato de 24 horas, por ejemplo, 00:00:00 para la medianoche y 13:00:00 para la 1 PM. Utilice la opción de la frequency para especificar el número de días entre copias de seguridad. Para deshabilitar las copias automáticas, establezca la frecuencia en 0. Si ha deshabilitado las copias automáticas, asegúrese de ejecutar la utilidad backupdatastore para crear copias de seguridad completas de forma manual.

Puede ejecutar la utilidad updatebackupschedule en el equipo de data store relacional principal. La herramienta se puede ejecutar en cualquier equipo de big data store espaciotemporal o de caché de teselas.

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

Sintaxis

updatebackupschedule [--store {relational | tileCache | spatiotemporal | graph | object}] [--starttime <local server time>] --frequency <number of days>

Si no especifica una nueva hora de inicio, la configuración de la hora de inicio existente no cambiará. Si no especifica un tipo de data store, se presupone que el data store es relacional.

Ejemplos

En este ejemplo, las copias de seguridad completas de un data store relacional tendrán lugar a las 11 PM (hora local del servidor) cada 10 días:

updatebackupschedule --starttime 23:00:00 --frequency 10

En este ejemplo, la periodicidad de la copia de seguridad está establecida para un data store de caché de teselas. Tras la copia de seguridad inicial de todas las bases de datos de data store de caché de teselas, ArcGIS Data Store copia las bases de datos de data store recién creadas a la ubicación especificada con configurebackuplocation cada 14 días.

updatebackupschedule --store tileCache --frequency 14

updatesslcertificate

Esta utilidad se utiliza con todos los tipos de data store.

Esta utilidad está obsoleta en esta versión. Le recomendamos que utilice en su lugar la utilidad replacesslcertificate.

Puede sustituir el certificado autofirmado que utiliza el servidor web para autenticar la comunicación entre el servidor de alojamiento y el data store y entre los equipos del data store con un certificado verificado y firmado por una autoridad de certificación (CA) o un certificado de dominio.

Esta utilidad no sustituye al certificado utilizado para autenticar la comunicación a través de los puertos.

Sintaxis

updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>

Ejemplo

Después de recibir un archivo de certificado firmado por una CA, ejecute updatesslcertificate para sustituir el certificado autofirmado de ArcGIS Data Store utilizado para la comunicación con el servidor web.

updatesslcertificate C:\myfiles\mysignedcert.pfx "ps4mycert" "mycacert"

upgradedatasource

Esta utilidad se utiliza con big data stores espaciotemporales.

Debido a un error en 10.8.1, los servicios de mapas de ArcGIS GeoEvent Server que utilizan agregación cuadrada o hexagonal no se renderizan después de actualizar a 10.9 o posterior. Para corregirlo, ejecute la utilidad upgradedatasource para actualizar los índices asociados a los datos de origen de estos servicios de mapas de GeoEvent Server.

Mientras se actualizan los índices, nadie puede acceder al servicio de mapas.

La utilidad upgradedatasource se puede ejecutar en cualquier equipo de big data store espaciotemporal.

Sintaxis

upgradedatasource [<service name>]

Ejemplos

En este ejemplo, se actualizan todas las fuentes del servicio de mapas de GeoEvent Server:

upgradedatasource

En este ejemplo, la utilidad upgradedatasource actualizará los índices usados por el recon de servicio de mapas de GeoEvent Server. El nombre del servicio se determinó con la utilidad listdatasources.

upgradedatasource recon