Las utilidades de comandos, instaladas con ArcGIS Data Store, proporcionan herramientas al administrador del data store para gestionar los data stores. En este tema se describen las utilidades y se proporcionan ejemplos y sintaxis.
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 --ayuda para obtener asistencia de sintaxis.
allowconnection
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 de comando allowconnection.
La utilidad allowconnection solo se puede ejecutar en el equipo de data store relacional principal.
Sintaxis
allowconnection <host name> <user name> [<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.sh workcom hqo.n_1E7
backupdatastore
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
Si necesita crear una copia de seguridad del data store relacional entre las horas programadas para la copia de seguridad, utilice la utilidad backupdatastore. Utilice esta utilidad para crear manualmente una copia de seguridad completa antes de actualizar el data store o antes de introducir un gran número de cambios en el data store.
La primera vez que ejecute la utilidad backupdatastore para un data store de caché de teselas, 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.
La primera vez que ejecute la utilidad backupdatastore para un big data store espaciotemporal, se crea una copia de seguridad completa. Puesto que los big data stores espaciotemporales pueden ser muy grandes, el uso subsiguiente de la utilidad backupdatastore crea un archivo de copia de seguridad que solo contiene los cambios realizados desde la copia de seguridad completa inicial.
La utilidad backupdatastore se puede ejecutar en el equipo de data store relacional principal o de caché de teselas. Esta utilidad se puede ejecutar desde cualquier equipo que pertenezca al big data store espaciotemporal.
En todos los casos, asegúrese de que la ubicación de copia de seguridad sea lo suficientemente grande como para acomodar todas las copias de seguridad. Para cambiar las ubicaciones de copia de seguridad del data store, utilice la utilidad configurebackuplocation.
Sintaxis
backupdatastore [<backup name>] [--store {relational|tileCache|spatiotemporal}] [--location <backup_arguments>] [--prompt <yes | no>]
El parámetro --location se admite para los big data stores espaciotemporales y los data stores relacionales. Los argumentos de este parámetro son los siguientes y se deben separar con punto y coma (;):
- type=: los tipos válidos son fs (archivo compartido), s3 (depósito de S3 de AWS) o azure (contenedor de almacenamiento de BLOB de Azure).
- name=: si asignó nombres a las ubicaciones de copia de seguridad que configuró para su big data store espaciotemporal, puede utilizar el nombre de la ubicación para especificar dónde desea que se creen los archivos de copia de seguridad cuando ejecute la utilidad backupdatastore.
- location=: si no especifica un nombre de ubicación de copia de seguridad, debe especificar el type y location de la copia de seguridad. Para archivos compartidos, indique la ruta del archivo. Para depósitos de S3, indique el nombre del depósito. Para contenedores de almacenamiento de BLOB de Azure, indique el nombre del contenedor.
Ejemplo
En este ejemplo se crea un archivo completo de copia de seguridad llamado project1bu en la ubicación de copia de seguridad que especifique para el data store utilizando la utilidad configurebackuplocation. De forma predeterminada, se crean copias de seguridad de los data stores relacionales; por lo tanto, en el siguiente ejemplo, se crea una copia de seguridad de un data store relacional.
./backupdatastore.sh project1bu You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
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.sh tcbu5 --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.sh 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
changebackuplocation
Se utiliza con data stores relacionales.
Legado:
Esri ha dejado obsoleta la utilidad changebackuplocation. Todavía está presente para que los scripts existentes sigan funcionando, pero debe empezar a usar la utilidad configurebackuplocation en su lugar.
De manera predeterminada, los archivos de copia de seguridad de data store relacional se almacenan en el mismo equipo que el data store. Debe mover los archivos de copia de seguridad a otro equipo para garantizar el acceso a los mismos si el equipo en el que ArcGIS Data Store está instalado no está accesible.
Asegúrese de que el inicio de sesión que ejecute la utilidad changebackuplocation tenga permisos de lectura y escritura en el directorio compartido.
La utilidad changebackuplocation solo se aplica a las copias de seguridad creadas para un data store relacional.
Sintaxis
changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]
Especifique --is-shared-folder true si la ubicación de copia de seguridad está en un equipo de red compartido. Si desea mover los archivos de copia de seguridad existentes a la ubicación nueva, especifique --keep-old-backups true.
changedatastoremode
Se utiliza con data stores relacionales.
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.
La utilidad changedatastoremode solo se puede ejecutar en el equipo de data store relacional principal.
Nota:
Si ArcGIS Data Store pone el data store relacional en modo de solo lectura porque hay poco espacio de disco, las copias de seguridad automáticas también se deshabilitan para evitar llenar el disco en exceso. Por lo tanto, también deberá restablecer la periodicidad de la copia de seguridad automática mediante la utilidad updatebackupschedule después de volver a poner el data store relacional en modo de lectura-escritura.
Sintaxis
changedatastoremode readonly|readwrite [--prompt <yes|no>]
Ejemplo
En este ejemplo, el data store relacional se vuelve a poner en modo de lectura-escritura, lo que significa que los clientes pueden reanudar ciertas actividades, como la publicación de capas de entidades alojadas en el portal, editar datos a través de una capa de entidades alojadas o agregar archivos CSV al Map Viewer.
./changedatastoremode.sh readwrite --prompt no
changedbproperties
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
La utilidad changedbproperties le permite cambiar distintas propiedades según el tipo de data store en el que la ejecuta.
Sintaxis
changedbproperties --store <relational | tileCache | spatiotemporal> [configuration options]
Opciones de configuración admitidas:
- disk-threshold-readonly: este ajuste controla cuándo un data store relacional se pondrá en modo de solo lectura para evitar la pérdida de datos porque hay poco espacio de disco. El valor de espacio de disco predeterminado es 1024 MB. Especifique los tamaños en MB.
- max-connections: utilice este parámetro para especificar el máximo número de conexiones permitidas para un data store relacional. Los data stores relacionales aceptan hasta 150 conexiones de manera predeterminada. Puede utilizar la propiedad --max-connections con la utilidad changedbproperties para cambiar el número de conexiones permitidas. Al determinar cuántas conexiones necesita el data store, tenga en cuenta que los procesos internos de ArcGIS Data Store pueden admitir hasta cinco conexiones. También debe tener en cuenta cuántas conexiones concurrentes puede aceptar el equipo de ArcGIS Data Store y seguir 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 especificado no puede ser menor que 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. Este parámetro no es compatible con big data stores espaciotemporales ni con data stores de caché de teselas.
- pitr: este ajuste indica si ArcGIS Data Store va a crear copias de seguridad incrementales del data store relacional, permitiéndole así recuperar el data store relacional en un punto en el tiempo. Las entradas posibles para esta opción son enable o disable. La recuperación de un punto en el tiempo está deshabilitada de manera predeterminada.
Nota:
Debe habilitar la recuperación de un punto en el tiempo si va a usar la utilidad webgisdr para crear copias de seguridad incrementales de su implementación de ArcGIS Enterprise.
- enablessl: este parámetro controla el protocolo de seguridad empleado al alimentar el data store de caché de teselas. El protocolo de seguridad cambió con ArcGIS Data Store 10.6.1.
ArcGIS Data Store: 10.6.1 utiliza Transport Layer Security (TLS) al alimentar el data store de caché de teselas.
Las opciones admitidas para el parámetro enablessl en 10.6.1 son las siguientes:
- admin: esta es la opción predeterminada. Especifique admin para usar Transport Layer Security al crear el contenedor para el data store de caché de teselas.
- data: especifique data para usar Transport Layer Security al escribir datos de la capa de escena en el data store de caché de teselas.
- admin,data: especifique admin,data para usar Transport Layer Security al crear y escribir datos en el data store de caché de teselas.
- none: especifique none para usar la comunicación HTTP desde el servidor de alojamiento al crear y escribir en el data store de caché de teselas.
ArcGIS Data Store: 10.6 utiliza el protocolo de seguridad SSLv3 al alimentar el data store de caché de teselas. Para usar la encriptación SSLv3, los equipos de su servidor de alojamiento deben tener habilitado SSLv3. La mayoría de los equipos no lo tienen habilitado, de modo que puede configurar el data store de caché de teselas para usar la comunicación HTTP con el servidor de alojamiento y, por tanto, no requiere que SSLv3 esté habilitado en las máquinas del servidor de alojamiento.
Las opciones admitidas para el parámetro enablessl en 10.6 son las siguientes:
- admin: especifique admin para usar la seguridad SSLv3 al crear el contenedor para el data store de caché de teselas. Para ello, se requiere que los equipos del servidor de alojamiento tengan habilitado SSLv3. Contacte con el administrador de ArcGIS Server o un administrador de TI para determinar si este protocolo está habilitado en las máquinas. Si el administrador desea habilitar SSLv3 en los equipos del servidor de alojamiento, diríjale a las instrucciones de Problemas y soluciones comunes en la Ayuda de ArcGIS Server.
- data: especifique data para usar la seguridad SSLv3 al escribir datos de la capa de escena en el data store de caché de teselas. Para ello, se requiere que los equipos del servidor de alojamiento tengan habilitado SSLv3.
- admin,data: especifique admin,data para usar la seguridad SSLv3 al crear y escribir datos en el data store de caché de teselas. Para ello, se requiere que los equipos del servidor de alojamiento tengan habilitado SSLv3.
- none: especifique none para usar la comunicación HTTP desde el servidor de alojamiento al crear y escribir en el data store de caché de teselas. Use este ajuste si ve el mensaje La herramienta de publicación no puede conectarse al data store de caché de teselas. Puede deberse a una configuración de seguridad que afecta a la forma en que el servidor de alojamiento se comunica con el data store de caché de teselas en los registros de los servidores de alojamiento, o bien usted sabe que los protocolos de seguridad de su sitio no permiten el uso de la seguridad SSLv3.
- 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 manera predeterminada este tipo de data store utilizada la mitad de la memoria RAM disponible cuando se inicia. Este parámetro no es compatible con data stores relacionales ni con data stores de caché de teselas.
- rebalance: de manera predeterminada, este parámetro está establecido como true, lo que significa que los datos de un big data store espaciotemporal distribuirán datos a otros equipos si un equipo no está disponible. Si necesita realizar tareas de mantenimiento en un equipo de big data store espaciotemporal, como actualizarla, puede desactivar el reequilibrio temporalmente estableciendo este parámetro como false. La operación de reequilibrio se suspenderá durante el tiempo establecido para el parámetro max-rebalance-off. Este parámetro solo se aplica a big data stores espaciotemporales.
Legado:
En ArcGIS 10.4.x, esta opción era reallocation.
- max-rebalance-off: la configuración de este parámetro se utiliza cuando el parámetro rebalance se establece como false. 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. Este parámetro solo se aplica a big data stores espaciotemporales.
Legado:
En ArcGIS 10.4.x, esta opción era max-allocation-off.
- prompt: cuando ejecute esta utilidad, se le pedirá que confirme la acción que ha especificado. Si automatiza el uso de esta utilidad, establezca el parámetro prompt como false, pues de lo contrario, la secuencia de comandos no proseguirá hasta que responda.
Ejemplo
En este ejemplo, el número máximo de conexiones permitidas para un data store relacional está establecido en 100:
./changedbproperties.sh --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)?YesEn este ejemplo, la opción max-rebalance-off se utiliza para establecer en 15 el número de minutos tras los cuales el big data store espaciotemporal cambiará automáticamente rebalance a true.
./changedbproperties.sh --store spatiotemporal --max-rebalance-off 15
En este ejemplo, se usa el parámetro enablessl para configurar el data store de caché de teselas de modo que use Transport Layer Security al crear el contenedor y al escribir datos en el data store de caché de teselas de 10.6.1.
./changedbproperties.sh --store tileCache --enablessl admin,data
En este ejemplo, se usa el parámetro enablessl para habilitar la comunicación HTTP con el servidor de alojamiento al alimentar un data store de caché de teselas de 10.6, lo que permite a los usuarios publicar capas de escena sin que el administrador de ArcGIS Server tenga que habilitar SSLv3 en los equipos del servidor de alojamiento.
./changedbproperties.sh --store tileCache --enablessl none
changeloglocation
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
Si no desea que el almacén de datos utilice la ubicación predeterminada del archivo de registro de errores de <ArcGIS Data Store installation directory>\arcgisdatastore\logs, ejecute la utilidad changeloglocation para que los archivos de registro de errores se creen en otro directorio.
Sintaxis
changeloglocation <directory path>
Ejemplo
En este ejemplo, los archivos de registro se crearán en el directorio local, ../datastorefiles/logs.
./changeloglocation.sh '../datastorefiles/logs'
changenosqldslocation
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 al usuario que ejecuta el proceso (Linux) o servicio (Windows) 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 ahora en un directorio compartido llamado dstorecache del equipo server2.
changenosqldslocation /net/server2/dstorecache
changepassword
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 le exige configurar sus propias contraseñas, obtenga las contraseñas de las cuentas del data store y ejecute changepassword para restablecer las contraseñas.
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 solo se puede ejecutar en el equipo de data store relacional principal.
Sintaxis
changepassword <user name> <new password> [--prompt {yes | no}]
Sugerencia:
Si tiene que programar los cambios de las contraseñas en una secuencia de comandos, incluya un marcador para desactivar el mensaje de confirmación, como en el ejemplo siguiente:
changepassword gwi_n2Te0 Phfl4mp --prompt no
Ejemplo
En este ejemplo, se cambia la contraseña del usuario gwi_n2Te0 to Phfl4mp!.
./changepassword.sh gwi_n2Te0 Phfl4mp You are going to change the password for user gwi_n2Te0. Do you want to continue (Yes or No)?Yes
changestaginglocation
Se utiliza con data stores relacionales.
Al restaurar el data store relacional, 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. Si hay una gran cantidad de datos en el data store relacional, puede configurar una ubicación provisional independiente y especificarla para la recuperación.
Sintaxis
changestaginglocation <directory path>
Ejemplo
En este ejemplo, la ubicación provisional designada es /net/sanmarcos/stage.
./changestaginglocation.sh /net/sanmarcos/stage
configurebackuplocation
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
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. Este comando permite quitar la ubicación de la copia de seguridad si ya no necesita las copias de seguridad de ArcGIS Data Store.
Los data stores de caché de teselas y relacionales se crean con una ubicación de copia de seguridad local predeterminada. Use la opción change para especificar una ubicación de copia de seguridad predeterminada más segura para estos data stores en un directorio compartido remoto.
Los big data stores espaciotemporales no se crean con una ubicación predeterminada. Antes de crear copias de seguridad, debe ejecutar la utilidad configurebackuplocation con la opción register para especificar una ubicación de red compartida, un depósito de Amazon Simple Storage Service (S3) o un contenedor de almacenamiento de BLOB de Microsoft Azure para estas copias de seguridad. No puede usar una unidad local para los archivos de copia de seguridad de un big data store espaciotemporal.
Tanto para los big data stores espaciotemporales como para los data stores relacionales, es posible registrar una segunda ubicación de copias de seguridad para almacenar copias de seguridad completas creadas con la utilidad backupdatastore. Puede usar un directorio de archivos compartido, depósito de S3 o un contenedor de almacenamiento de BLOB de Azure como ubicaciones de copia de seguridad secundarias.
Sintaxis
configurebackuplocation --location '<backup_location_arguments>' [options]
Las opciones admitidas son las siguientes:
- --location 'type=fs|s3|azure location=<backup_location> [name=<backup_location_name>] [username=<AWS_or_Azure_login>] [password=<AWS_or_Azure_account_password>]': especifique la ubicación en la que desea que ArcGIS Data Store almacene los archivos de copia de seguridad. Para big data stores espaciotemporales o para registrar una ubicación de copias de seguridad secundaria para un data store relacional, especifique los siguientes argumentos, separados por un punto y coma (;) y encierre toda la cadena de argumentos entre comillas simples ('):
- type=: especifique el tipo de ubicación que se usará para las copias de seguridad. Puede especificar s3 para almacenar las copias de seguridad en un depósito de Amazon S3, azure para almacenar las copias de seguridad en un contenedor de almacenamiento de BLOB de Azure o fs para almacenar las copias de seguridad en un archivo compartido (este es el valor predeterminado).
- location=: para archivos compartidos, especifique la ruta del archivo. Para depósitos de S3, especifique el nombre del depósito. Para contenedores de almacenamiento de BLOB, especifique el nombre del contenedor.
- 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, como por ejemplo \\sharedserver_sharedfolders_datastorebackups, puede designar un nombre para esta ubicación, como dsbackups. Al ejecutar las utilidades backupdatastore, listbackups o restoredatastore, puede proporcionar este nombre en lugar de la ruta completa.
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=: obligatorio si su ubicación de copia de seguridad es un depósito de S3 o un contenedor de almacenamiento de BLOB. Para depósitos de S3, indique el Id. de clave de acceso de su cuenta de AWS. Para contenedores de almacenamiento de BLOB de Azure, indique el nombre de usuario de inicio de sesión de la cuenta de Microsoft Azure que puede acceder al contenedor de almacenamiento de BLOB.
- password=: obligatorio si su ubicación de copia de seguridad es un depósito de S3 o un contenedor de almacenamiento de BLOB. Para depósitos de S3, indique la clave secreta de su cuenta de AWS. Para contenedores de almacenamiento de BLOB de Azure, indique la contraseña de la cuenta de Azure que especificó en el argumento username.
- --store relational|tileCache|spatiotemporal: el valor predeterminado es relational.
- --operation change|register|unregister|list|setdefault: el valor predeterminado es change. A continuación se explica cada una de las opciones:
- change: utilice esta opción con data stores relacionales o de caché de teselas para especificar una ubicación de archivo compartido diferente para los archivos de copia de seguridad. La ubicación establecida con la opción change es siempre la ubicación de copia de seguridad predeterminada.
- register: utilice esta opción con big data stores espaciotemporales para registrar una ubicación de archivos de copia de seguridad. La primera ubicación de copia de seguridad que defina se establece como la ubicación de copia de seguridad predeterminada. A partir de 10.6.1, úsela con el data store relacional para registrar una ubicación de copia de seguridad secundaria para las copias de seguridad manuales.
- unregister: utilice esta opción para dar de baja una ubicación de copia de seguridad de un big data store espaciotemporal. A partir de 10.6.1, utilícela para eliminar una ubicación de copia de seguridad secundaria de un data store relacional.
- list: muestra en una lista todas las ubicaciones de copia de seguridad registradas para un big data store espaciotemporal. A partir de 10.6.1, también enumera todas las ubicaciones de copia de seguridad de un data store relacional.
- setdefault: si tiene varias ubicaciones de copia de seguridad para un big data store espaciotemporal, puede usar setdefault para designar una de las ubicaciones de copia de seguridad como 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.
- --prompt yes | no: el valor predeterminado es yes.
En 10.6, es posible usar las opciones register, unregister, list y setdefault únicamente con big data stores espaciotemporales. En 10.6.1, es posible usar register, unregister y list con los data stores relacionales.
Si no especifica la opción --store, se presupone que es relacional.
Nota:
La opción location es obligatoria si especifica las opciones register o change.
Ejemplos
En el primer ejemplo, la ubicación de copia de seguridad de un data store relacional se establece en un directorio denominado fsdata, pero en un equipo denominado myshare.
./configurebackuplocation.sh --operation change --store relational --location /net/myshare/fsdata_bu You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
En este ejemplo, se registra una segunda ubicación de copia de seguridad en Azure para el mismo data store relacional.
./configurebackuplocation.sh --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
En este ejemplo, una ubicación de copia de seguridad en un recurso compartido de red se registra para un big data store espaciotemporal. Se asigna un nombre, fshare, a la ubicación de copia de seguridad.
./configurebackuplocation.sh --operation register --store spatiotemporal --location 'type=fs;location=/net/sharedmachine/ge_bu;name=fshare'
En este ejemplo, se especifica una segunda ubicación de copia de seguridad 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'
En este ejemplo, se especifica una tercera ubicación de copia de seguridad en Azure para el big data store espaciotemporal.
configurebackuplocation --operation register --store spatiotemporal --location 'type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount'
En este ejemplo, se establece el depósito de S3 como la ubicación de copia de seguridad predeterminada para el big data store espaciotemporal.
configurebackuplocation --operation setdefault --store spatiotemporal --location 'name=awsloc'
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 /net/sharedmachine/ge_bu false awsloc s3 mybucket true mazloc azure myblobs false
configuredatastore
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
Después de instalar ArcGIS Data Store, puede ejecutar la utilidad configuredatastore para crear un data store y registrarlo en un sitio de GIS Server. Mediante este comando, puede crear los siguientes tipos de data store:
- Un data store para los datos de las capas de entidades alojadas (data store relacional).
- Un data store para las cachés de teselas de capas de escena alojadas (data store de caché de teselas)
- Un data store para los datos creados al ejecutar GeoAnalytics Tools o un data store para archivar datos observacionales de un ArcGIS GeoEvent Server (big data store espaciotemporal)
También puede ejecutar la utilidad configuredatastore para reconfigurar un data store después de actualizarlo.
Sintaxis
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores <relational|tileCache|spatiotemporal>] [--nosql-only true|false]
La dirección URL de administración de ArcGIS Server tiene el formato https://gisserver.domain.com:6443. Aunque el sitio de GIS Server utilice un Web Adaptor, debe proporcionar la dirección URL en el formato indicado anteriormente.
Proporcione el nombre de usuario y la contraseña de un usuario integrado (no uno corporativo) que tenga privilegios de administrador en el sitio de GIS Server.
El directorio de datos está en la ubicación del equipo local donde desea crear los archivos del almacén de datos.
Aunque no se recomienda, puede configurar más de un tipo de data store en el mismo equipo especificando cada tipo de almacén separado por una coma (sin espacios). Por ejemplo, para configurar tanto data stores relacional como data stores de caché de teselas en el mismo equipo con un directorio de data store compartido, especifique --stores relational,tileCache. Esri le recomienda encarecidamente que ejecute los big data stores espaciotemporales en equipos independientes de otros data stores o software.
Legado:
En las versiones anteriores, se especificaba la opción --nosql-only como true para crear un data store solo para las teselas en caché de las capas de escena. Esta opción todavía está presente, de modo que los scripts existentes siguen funcionando. En lugar de ello, todos los scripts nuevos deben tener la opción --stores configurada como tileCache.
Configurar un tipo específico de data store
Puede configurar ArcGIS Data Store para los datos de capas de entidades alojadas especificando relational con la opción --stores.
Para publicar una capa de escena alojada, necesita un data store para las cachés de escena y un data store para datos de capa de entidades alojadas porque ArcGIS crea una capa de entidades alojadas, una capa de escenas alojadas y una caché de escena cuando publica una capa de escena alojada. Puede especificar relational,tileCache con la opción --stores para configurar ambos tipos de data store, o especificar solo tileCache con la opción --stores y utilizar su propia base de datos administrada como data store para los datos de las capas de entidades alojadas.
Si utiliza ArcGIS GeoEvent Server y desea almacenar datos observacionales de gran volumen y alta velocidad, cree un big data store espaciotemporal especificando spatiotemporal con la opción --stores.
Consulte la ayuda de ArcGIS GeoEvent Server para obtener más información sobre cómo trabajar con big data stores espaciotemporales.
Si quiere utilizar GeoAnalytics Tools en el Map Viewer o desde ArcGIS Pro, cree un big data store espaciotemporal especificando spatiotemporal con la opción --stores.
Tenga en cuenta que si programa la creación de varios equipos de big data store espaciotemporal, se debe configurar manualmente un equipo de big data store espaciotemporal con el GIS Server antes de poder escribir un script para la creación de equipos adicionales del big data store espaciotemporal.
Puede crear más de un tipo de data store en el mismo equipo o incluso crear los tres tipos de data store en el mismo equipo; sin embargo, Esri no lo recomienda, porque los data stores competirán entre sí para conseguir memoria y otros recursos, lo que afectará negativamente al rendimiento y posiblemente causará que los data stores dejen de funcionar.
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 un ArcGIS Data Store existente en cada equipo de data store, puede iniciar sesión en el equipo principal de data store relacional o de caché de teselas y ejecutar la utilidad configuredatastore para completar la actualización de los data stores. Cuando ejecuta la utilidad desde el equipo principal, el equipo relacional o de caché de teselas de respaldo también se actualiza.
Si su equipo principal contiene un data store relacional y un data store de caché de teselas, especifique --stores relational,tileCache cuando ejecute la utilidad configuredatastore para actualizar los data stores relacionales y de caché de teselas del equipo principal y del equipo de respaldo.
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.
Tenga en cuenta que, si no ha instalado la nueva versión de ArcGIS Data Store en todos los equipos, no se puede proceder con la configuración.
Ejemplo
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 /dstore/data.
./configuredatastore.sh https://gisserver.domain.com:6443 admin Iph33l$ik /dstore/data --stores relational
deletebackup
Se utiliza con data stores relacionales.
La utilidad deletebackup le permite eliminar archivos de copia de seguridad que haya creado para data stores relacionales. Primero debe ejecutar la utilidad listbackups para ver los nombres y las horas de creación de las copias de seguridad manuales. Después podrá ejecutar la utilidad deletebackup para eliminar la copia de seguridad manual que ya no necesite.
Tenga en cuenta que 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> [--prompt <yes | no>]
Ejemplo
./deletebackup.sh featuresMarchbu You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
La utilidad describedatastore le permite ver la siguiente información sobre una instalación de ArcGIS Data Store:
- El número de versión de software de la instalación de ArcGIS Data Store
- La ubicación temporal utilizada por el data store para la restauración
- La ubicación del archivo de registro para el data store
- La cantidad de espacio de disco disponible que queda en el equipo donde ArcGIS Data Store está instalado
- el umbral de espacio de disco libre en el que se colocará un data store relacional en modo de solo lectura y se detendrán los big data stores de caché de teselas y espaciotemporales.
- Ubicaciones de copia de seguridad usadas por cada tipo de data store
- Si la ubicación de la copia de seguridad del data store relacional o de caché de teselas está en un recurso compartido de red
- Con qué frecuencia se crea una copia de seguridad del data store (periodicidad de la copia de seguridad)
- Cuántos días se mantienen los archivos de copia de seguridad de un data store relacional
- Si el data store se está ejecutando o no (estado del data store)
- La fecha y hora en que el data store relacional o de caché de teselas de respaldo pasó a ser el data store principal (última conmutación por error); no se muestra si no se ha producido nunca la conmutación por error
- Los nombres de los equipos que participan en el data store relacional o de caché de teselas (equipos miembros)
- Número de conexiones máximas que se permiten para un data store relacional
- La URL del sitio de GIS Server en el cual está registrado el data store (URL del sistema propietario)
- La URL del portal que está utilizando el sitio de GIS Server como servidor de alojamiento (URL del portal)
- El número de conexiones de capa de entidades actuales al data store relacional
- Una lista de todos los equipos que actualmente participan en el big data store espaciotemporal (equipos del clúster espaciotemporal)
- El equipo dentro del big data store espaciotemporal que actualmente está diseñado como equipo maestro (equipo maestro actual del clúster)
- Una lista de todos los equipos que actualmente participan en el clúster del big data store espaciotemporal (equipos espaciotemporales registrados); muestra todos los equipos del clúster independientemente de su estado
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 específicas que contienen información concreta de cada tipo de data store.
Aunque seguramente tendrá diferentes data stores en distintos equipos, la siguiente salida muestra un equipo con los tres tipos en el mismo equipo para que pueda ver las diferentes secciones de cada tipo:
./describedatastore.sh
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....10.5.0.7777 Staging location............./arcgis/datastore/staging Log location................./arcgis/datastore/logs Free disk space..............174.00GB Threshold for READONLY mode..1024MB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location.........../net/nwshare/dsbackups Is backup folder shared...true Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31 Data store status.........Started Last failover.............20150130190334005 Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM Maximum connections.......150 Owning system URL.........https://gisserver.domain.com:6443/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal Number of connections.....8 connection(s) to managed database
Information for tile cache data store ds_wztxj7um
==============================================================
Tile cache location......./arcgis/datastore/nosqldata Data location............./arcgis/datastore/nosqldata Data store status.........Started Last failover.............20150130190334005 Backup location.........../arcgis/datastore/backup Is backup folder shared...false Member machines...........MACHINE1.DOMAIN.COM Owning system URL.........https://gisserver.domain.com:6443/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal
Information for spatiotemporal big data store ds_qpko99Cl
==============================================================
Max rebalance off time..............60 minutes Automatic rebalance ................On Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM Current master machine in cluster...MACHINE1.DOMAIN.COM Registered spatiotemporal machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver.domain.com:6443/arcgis/adminexportmanageddb
Legado:
Esri ha dejado obsoleta la utilidad exportmanageddb en la versión 10.5.1. Su funcionalidad se ha incorporado a la utilidad backupdatastore. La utilidad exportmanageddb todavía está presente para permitir que las secuencias de comandos existentes sigan funcionando, pero en su lugar debe empezar a usar la utilidad backupdatastore para crear un archivo de copia de seguridad y, después debe usar la utilidad restoredatastore para recuperar el data store del archivo de copia de seguridad.
Se usa con big data stores relacionales y de caché de teselas.
La utilidad exportmanageddb crea un archivo de volcado del data store relacional, de los metadatos sobre el data store y de todas las bases de datos que almacenan las cachés de teselas de capas de escena alojadas. Exporte el data store si tiene que hacer una copia de seguridad que se va a restaurar en una instalación de ArcGIS Data Store que está en un equipo con otro sistema operativo o es otra versión de ArcGIS Data Store.
Asegúrese de que nadie edite capas de entidades ni publique en su portal antes de haber importado el data store en el nuevo equipo. Asegúrese también de que la ubicación a la que exporta el data store contiene suficiente espacio de almacenamiento para el archivo de volcado del data store relacional y copias de todas las bases de datos de cachés de teselas de capas de escena alojadas.
La utilidad exportmanageddb no exporta big data stores espaciotemporales.
Sintaxis
exportmanageddb <output location> <backup name> [options]
La ubicación de salida es la ubicación en el disco donde se creará la carpeta (<backup name>) y los archivos exportados. Debe tener acceso de escritura a esta ubicación.
Entre las opciones admitidas se encuentran las siguientes:
- [--stores {relational|tileCache}]: indica qué tipo de data store desea exportar. Si los data stores relacionales y de caché de teselas se están ejecutando en el mismo equipo y desea exportarlos, especifique ambos separados por una coma; por ejemplo, escriba --stores relational,tileCache. Si no especifica la opción --stores, se presupone que es relacional.
- [--include-tilecache <true|false>]: esta opción está presente para garantizar la compatibilidad con las versiones anteriores. Si no especifica la opción --stores o bien especifica --stores relational, podría controlar si el data store de caché de teselas se ha exportado o no está usando esta opción.
- [--prompt {yes|no}]: determina si debe responder a una solicitud para ejecutar la utilidad.
Ejemplo
En el ejemplo siguiente, el archivo de volcado, las copias de las bases de datos de las cachés de capas de escena alojadas y los archivos del data store asociados generan una salida a un directorio de red compartido llamado movedsfirstexp en un servidor llamado backupserver.
./exportmanageddb.sh preupgradeexp /net/backupserver movedsfirstexp --stores relational,tileCache You are attempting to back up database 'db_e3hsm'. This could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
importmanageddb
Se usa con big data stores relacionales y de caché de teselas.
Si ha exportado un ArcGIS Data Store que contiene bases de datos de capas de entidades alojadas o de cachés de capas de escena alojadas (o ambas), puede usar la utilidad importmanageddb para restaurar el data store. Puede restaurar a un equipo de ArcGIS Data Store actualizado o a una instalación de ArcGIS Data Store en un equipo con un sistema operativo distinto al ArcGIS Data Store de origen.
Si desea que ArcGIS Data Store se registre en el mismo sitio de GIS Server que antes, especifique --bound true y no especifique ningún --server-url. Tenga en cuenta que --bound está establecido como true de manera predeterminada. Asegúrese de reiniciar el sitio de GIS Server después de la restauración.
Si realiza la restauración y desea registrar el data store en un nuevo sitio de GIS Server, especifique --server-url cuando importe el data store.
De manera predeterminada, se importa el data store relacional y todas las bases de datos de las cachés de capas de escena alojadas que forman el data store de caché de teselas en el archivo de exportación. Si no desea incluir las bases de datos de las cachés de capas de escena alojadas, especifique la opción --include-tilecache establecida como false.
La utilidad importmanageddb no importa big data stores espaciotemporales.
Sintaxis
importmanageddb <source backup location> <backup name> [options]
Entre las opciones admitidas se encuentran las siguientes:
- [--server-url <ArcGIS Server URL registered with data store>] : si especifica --bound true y ya 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. Tenga en cuenta que, a menos que también haya trasladado los servicios a este nuevo servidor, los datos del data store no estarán accesibles.
- [--server-admin <user name of ArcGIS Server admin>]: esta opción es obligatoria si especifica la opción --bound true o si no especifica la opción --bound. Proporcione el nombre de usuario del administrador de ArcGIS Server.
- [--server-password <password of ArcGIS Server admin>]: esta opción es obligatoria si especifica la opción --bound true o si no especifica la opción --bound. Proporcione la contraseña del administrador de ArcGIS Server.
- [--data-dir <data store data directory>]: el directorio de ArcGIS Data Store. De manera predeterminada, este es el directorio de ArcGIS Data Store de los data stores registrados actualmente.
- [--stores {relational|tileCache}]: indica qué tipo de data store desea importar. Si los data stores relacionales y de caché de teselas se están ejecutando en el mismo equipo y desea importarlos, especifique ambos separados por una coma; por ejemplo, escriba --stores relational,tileCache. Si no especifica la opción --stores, se presupone que es relacional.
- [--include-tilecache <true|false>]: esta opción está presente para garantizar la compatibilidad con las versiones anteriores. Si no especifica la opción --stores o bien especifica --stores relational, podría controlar si el data store de caché de teselas se ha restaurado o no está usando esta opción.
- [--bound {true|false}]
- Si especifica --bound true o no especifica la opción --bound, debe especificar la URL de un sitio de GIS Server con la opción --server-url y especificar las credenciales del administrador de ArcGIS Server con las opciones --server-admin y --server-password. Si realiza la importación en el mismo sitio de GIS Server en el que estaba registrado ArcGIS Data Store cuando se exportó el data store, especifique la dirección URL de ese sitio de GIS Server y proporcione el nombre de usuario y la contraseña del administrador de ArcGIS Server. Para vincular el data store a un nuevo sitio de GIS Server, proporcione la dirección URL y las credenciales del administrador de este sitio nuevo.
Nota:
Especifique información para un nuevo sitio de GIS Server solo si ya ha trasladado los servicios web a este nuevo sitio de GIS Server.
- Si el data store ya no va a usar el sitio anterior de GIS Server y aún no ha trasladado todos los servicios al nuevo sitio de GIS Server, especifique --bound false. A continuación debe ejecutar la utilidad registerdatastore para configurar el data store con el nuevo sitio de GIS Server después de trasladar los servicios a este nuevo sitio.
- Si especifica --bound true o no especifica la opción --bound, debe especificar la URL de un sitio de GIS Server con la opción --server-url y especificar las credenciales del administrador de ArcGIS Server con las opciones --server-admin y --server-password. Si realiza la importación en el mismo sitio de GIS Server en el que estaba registrado ArcGIS Data Store cuando se exportó el data store, especifique la dirección URL de ese sitio de GIS Server y proporcione el nombre de usuario y la contraseña del administrador de ArcGIS Server. Para vincular el data store a un nuevo sitio de GIS Server, proporcione la dirección URL y las credenciales del administrador de este sitio nuevo.
- [--prompt {yes|no}]: determina si debe responder a una solicitud para ejecutar la utilidad.
Ejemplo
En el siguiente ejemplo, el data store se restaura en la instalación de una versión más reciente de ArcGIS Data Store. Se especifica el nuevo directorio de datos de ArcGIS Data Store. El data store sigue estando vinculado al sitio de GIS Server existente, de modo que el data store y las capas de entidades y de escenas alojadas existentes continúan funcionando. Reinicie su sitio de GIS Server para que las capas de entidades y de escenas alojadas se publiquen en el nuevo equipo.
./importmanageddb.sh /net/backupserver/expdir preupgradeexp --source-loc --data-dir /usr/arcgis/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s --bound true
En este ejemplo, tanto el sitio de GIS Server como el data store relacional se han trasladado a nuevos equipos. Los servicios web ya se han trasladado al nuevo sitio de GIS Server, por lo que la nueva dirección URL del sitio se especifica con la opción --server-url. El nombre de la copia de seguridad es movedbexp y se almacena en /net/backupserver/expdir.
./importmanageddb.sh /net/backupserver/expdir movedbexp --data-dir /usr/arcgis/datastore --server-admin siteadmin --server-password SAup.4s --stores relational --bound true --server-url https:\\newgisserver.domain.com:6443
En este ejemplo, los servicios web no se han trasladado al nuevo sitio de GIS Server. Los data stores relacionales y de caché de teselas no serán funcionales hasta que los servicios se trasladen y posteriormente registre el data store con el nuevo sitio de GIS Server. El nombre de la copia de seguridad es movedsfirstexp y se almacena en /net/backupserver/expdir/movingexp2.
./importmanageddb.sh /net/backupserver/dbdump/movingexp2 movedsfirstexp --data-dir /usr/arcgis/datastore --stores relational,tileCache --bound false
listadminusers
Se utiliza con data stores relacionales.
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.
Sintaxis
listadminusers
Ejemplo
./listadminusers.sh Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_11zyx / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
listbackups
Usado con big data stores relacionales, de caché de teselas y espaciotemporales. Cuando se ejecuta para data stores relacionales o de caché de teselas, la utilidad listbackups solo funciona en el equipo del data store principal.
La utilidad listbackups devuelve los nombres de los archivos de copia de seguridad y la ubicación en la que están escritos. La utilidad listbackups también devuelve el estado de la copia de seguridad (completa o no), la hora de inicio de la copia de seguridad y si se creó manualmente con la utilidad backupdatastore o bien si ArcGIS Data Store la creó automáticamente.
Cuando ejecute la utilidad listbackups para big data stores espaciotemporales, 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.
Puede ejecutar listbackups para comprobar si una copia de seguridad ha finalizado o si se está ejecutando, para determinar cuántas copias de seguridad manuales tiene o para confirmar un nombre de archivo antes de ejecutar la utilidad deletebackup.
Sintaxis
listbackups [--store <relational|tileCache|spatiotemporal>] [--location '<location_arguments>']
Si no especifica ningún tipo de data store, la utilidad devuelve una lista de copias de seguridad de todos los data stores que se ejecutan en el equipo en el que se ejecuta la utilidad.
El parámetro location se usa con los big data stores espaciotemporales y los data stores relacionales. Los argumentos son los siguientes:
- name=: el nombre de la ubicación de 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=: la ruta al directorio de archivos compartidos, el nombre del depósito de S3 o el nombre del contenedor de almacenamiento de BLOB.
Ejemplo
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.sh --store spatiotemporal --location 'name=sbdsbu' Backup_Name Status Backup_Time Mode ==================================================================================== backup1 BackupComplete 2016-07-11 09:47 manual Backups located at: '/net/myserver.ntw.com/spatiotemporal'
listmanageduser
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
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 los datos de los data stores de caché de teselas.
Sintaxis
listmanageduser
Ejemplo
En el siguiente ejemplo, listmanageduser se ejecuta en un equipo principal que contiene un data store relacional y de caché de teselas.
./listmanageduser.sh
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.sh
Managed user for spatiotemporal big data store bds_6udbx4321 ================================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
registerdatastore
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
El data store conserva la información de los nombres de equipos del sitio de GIS Server. Si traslada su sitio de GIS Server a otros equipos nuevos (por ejemplo, si tiene hardware nuevo o si fallan los equipos GIS Server existentes), debe dar de baja el data store de GIS Server para eliminar esta información. Cuando configure GIS Server en un nuevo equipo (o equipos), podrá registrar el data store en el sitio de GIS Server con la utilidad de comando registerdatastore.
Tenga en cuenta que esto 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. Al registrarlo en un sitio de GIS Server distinto no se vuelven a crear las capas de entidades alojadas, las cachés de capas de escena ni los archivos de datos de servicios de transmisión.
La utilidad registerdatastore se puede ejecutar en el equipo de data store principal relacional o de caché de teselas. Se puede ejecutar en cualquier equipo de big data store espaciotemporal.
Sintaxis
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password> --stores <relational|tileCache|spatiotemporal>
Aunque no se recomienda, si tiene diferentes tipos de data stores instalados en el mismo equipo, puede registrarlos al mismo tiempo especificando el tipo de data store separado con una coma (sin espacios); por ejemplo, puede escribir --stores relational,tileCache.
Ejemplo
En este ejemplo, un data store relacional se vuelve a registrar en un sitio de GIS Server con la dirección URL https://gisserver.domain.com:6443. El nombre de usuario del administrador del sitio principal de ArcGIS Server es agsadmin con la contraseña Tan$p0n.
./registerdatastore.sh https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational
removemachine
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
Use la utilidad removemachine para eliminar una de las opciones siguientes de una instalación de ArcGIS Data Store:
- Eliminar un equipo de respaldo de un data store relacional. Se puede ejecutar en un equipo de respaldo o desde el equipo principal en el caso de que el equipo de respaldo no esté disponible.
- Eliminar un equipo de respaldo de un data store de caché de teselas. Se puede ejecutar en un 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 big data store espaciotemporal. Tenga en cuenta que no se puede ejecutar removemachine en un big data store espaciotemporal compuesto por un solo equipo.
Sintaxis
removemachine <machine name> --store <relational|tileCache|spatiotemporal> [--force <true | false>] [--prompt <yes | no>]
--force: de forma predeterminada, tiene el valor false. Especifique true con esta opción solamente si el sitio de ArcGIS Server registrado no está disponible.
--prompt: de forma predeterminada, tiene el valor yes. Si no desea confirmar la acción, especifique no con esta opción.
Ejemplo
En este ejemplo, el equipo del big data store espaciotemporal, gefour, se elimina del data store.
./removemachine.sh gefour --store spatiotemporal
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.sh fsdata --store relational --force true
removestandbymachine
Legado:
Esri ha dejado obsoleta la utilidad removestandbymachine. Todavía está presente para que las secuencias de comandos existentes sigan funcionando, pero debe empezar a usar la utilidad removemachine en su lugar.
Utilice el comando remove de REST de ArcGIS Server desde el administrador del sitio de ArcGIS Server para eliminar un equipo de respaldo de un data store relacional o de caché de teselas. No obstante, si el sitio de GIS Server no está disponible, no podrá iniciar sesión en el administrador del sitio para ello. En esos casos, ejecute la utilidad removestandbymachine para eliminar un equipo de respaldo del almacén de datos.
La utilidad removestandbymachine solo puede ejecutarse en un equipo de respaldo de un data store relacional y de un data store de caché de teselas.
Sintaxis
removestandbymachine <machine name> --store <relational|tileCache> [--prompt <yes | no>]
restoredatastore
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
Si pierde el acceso a los datos que se utilizan en las capas de entidades alojadas del portal, las capas de escenas alojadas o los datos de tiempo real archivados, utilice los archivos de copia de seguridad y la utilidad de comando restoredatastore 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 copia 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. Tenga en cuenta que solo podrá restaurar un estado del data store relacional cuyos archivos de copia de seguridad estén disponibles. 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.
La utilidad restoredatastore se puede ejecutar en el equipo de data store principal relacional o de caché de teselas. Se puede ejecutar en cualquiera de los equipos de big data store espaciotemporales.
Sintaxis
restoredatastore [options]
Las opciones admitidas son las siguientes:
- [--store {relational|tileCache|spatiotemporal}]
- [--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}]: esta opción solo se admite para data stores relacionales.
- [--source-loc <location of source backup files>]: en el caso de los big data stores espaciotemporales, esta opción permite especificar un nombre de ubicación de copia de seguridad o especificar una ubicación de copia de seguridad en S3 o Azure. A partir de 10.6.1, también puede usar esta opción con los data stores relacionales para especificar una ubicación de copia de seguridad de un archivo compartido, S3 o Azure. Si especifica una ubicación secundaria de copia de seguridad para el data store relacional, en lugar de la ubicación predeterminada, la opción --target se debe definir en el nombre del archivo de copia de seguridad. Para data stores de caché de teselas, solo puede especificar la ruta a un archivo compartido y esta opción solo se requiere para data stores de caché de teselas si restaura en un equipo nuevo.
- [--bound {true | false}]: la opción --bound se admite solo con los data stores relacionales y los data stores de caché de teselas.
- [--data-dir <new data store directory>]: utilice --data-dir si restaura el data store en un nuevo equipo. Si restaura en un equipo nuevo, debe especificar la opción --source-loc.
- [--server-url <ArcGIS Server URL registered with data store>]: si especifica --bound true para mantener el data store registrado con el mismo GIS Server que fue registrado cuando creó la copia de seguridad, especifique la dirección URL de ese sitio 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. Tenga en cuenta que si especifica una nueva URL de sitio y no ha trasladado los servicios a este nuevo servidor, los datos del data store no estarán accesibles.
- [--server-admin <user name of ArcGIS Server admin>]: esta opción es obligatoria si especifica la opción --bound true o si no especifica la opción --bound. Proporcione el nombre de usuario del administrador de ArcGIS Server.
- [--server-password <password of ArcGIS Server admin>]: esta opción es obligatoria si especifica la opción --bound true o si no especifica la opción --bound. Proporcione la contraseña del administrador de ArcGIS Server.
- [--loaddata {true | false}]: solo se admite con los big data stores espaciotemporales. Establezca esta opción en false cuando necesite restaurar el big data store espaciotemporal en un nuevo conjunto de equipos, pero los datos no quepan en el primer equipo. Esto le permite restaurar el esquema del data store, agregar más equipos al big data store espaciotemporal 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.
- [--prompt {yes | no}]
Cuando restaure tras un fallo del equipo o para trasladar el data store relacional, especifique --target most-recent. Si restaura un data store relacional en una fecha determinada, especifique la fecha y hora (en UTC) que desea utilizar para 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.
De manera predeterminada, el data store restaurado se asocia (vincula) a su sitio de GIS Server. Especifique solo --bound false si desea restaurar el data store sin mantener la asociación al sitio de GIS Server del data store. Solo debe hacerlo como último recurso si el sitio anterior de GIS Server se ha perdido y no se puede recuperar; podría restaurar el data store sin vincular y configurarlo con un nuevo sitio federado de GIS Server. 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 el portal.
Ejemplos
En este ejemplo, la copia de seguridad más reciente es de la ubicación predeterminada de copia de seguridad del data store relacional y se restaurará en el data store existente. Dado que 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.sh --target most-recent --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, un data store relacional con la recuperación de punto en el tiempo habilitada se restaura desde la ubicación predeterminada de copia de seguridad del data store relacional al estado en que se encontraba a las 2:30 p.m. (UTC) del 17 de julio de 2014.
./restoredatastore.sh --target 2014-07-17-14:30:00 --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 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. Dado que 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.sh --target movedatastore --source-loc /net/buserver/data/backups --data-dir /usr/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 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. Dado que 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.sh --source-loc /net/buserver/scenedata/backups --data-dir /usr/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 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.sh --target bds1 --store spatiotemporal --source-loc 'name=awsloc' --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
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
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> <user name> [<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.sh workcom bn0_3Wa.m hqo.n_1E7
unregisterdatastore
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
Puede usar la utilidad de comando unregisterdatastore para realizar lo siguiente:
- Dar de baja un equipo principal de data store relacional o de caché de teselas de su sitio de GIS Server. Solo debe hacerlo si ha eliminado las capas de entidades, de teselas y de escenas alojadas que utilizan los datos del data store. Si no lo ha hecho, quedarán capas inutilizables en su portal y servicios inutilizables ejecutándose en su servidor de alojamiento.
Tenga en cuenta que si tiene un equipo de respaldo, debe eliminarlo primero del data store antes de eliminar el equipo principal.
- Dar de baja un big data store espaciotemporal de un solo equipo.
Podría dar de baja un data store de su sitio de GIS Server si decide que ya no desea utilizar el data store ni los servicios que dependen de él. Al dar de baja un equipo del data store, el sitio de GIS Server ya no puede conectarse a ese equipo y todos los servicios que contenían datos del data store que se ha dado de baja dejarán de funcionar. Este comando no elimina los datos; no obstante, si decide que necesita el data store, puede utilizar las utilidades registerdatastore o configuredatastore para volver a agregarlo.
La utilidad unregisterdatastore solo se puede ejecutar en el equipo de data store principal relacional o de caché de teselas después de ejecutar removemachine para quitar el equipo de respaldo. Unregisterdatastore solo se puede ejecutar para un big data store espaciotemporal cuando queda un equipo tras ejecutar removemachine para quitar todos los demás equipos en el big data store espaciotemporal.
Sintaxis
unregisterdatastore --stores <relational|tileCache|spatiotemporal> [--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 registerdatastore 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.sh --stores relational,tileCache You are going to unregister the data store. Do you want to continue (Yes or No)?Yes
updatebackupretaindays
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.sh 10
updatebackupschedule
Usado con big data stores relacionales, de caché de teselas y espaciotemporales.
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 copias de seguridad automáticas predeterminadas para big data stores de caché de teselas o espaciotemporales. 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 p.m. Utilice la opción de la frecuencia 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 o de caché de teselas. La herramienta se puede ejecutar en cualquier equipo de big data store espaciotemporal.
Sintaxis
updatebackupschedule [--store relational|tileCache|spatiotemporal] [--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.
Ejemplo
En este ejemplo, las copias de seguridad completas de un data store relacional tendrán lugar a las 11 p.m. (hora local del servidor) cada 10 días:
./updatebackupschedule.sh --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.sh --store tileCache --frequency 14
updatelicense
Se utiliza con data stores relacionales.
Si su licencia de ArcGIS Server caduca, debe actualizarla en el sitio de ArcGIS Server. La información de licencia también se almacena en el data store relacional de ArcGIS Data Store; por tanto, una vez actualizada la licencia del sitio de ArcGIS Server con el que se configura el data store, debe actualizar la licencia en el data store. Para hacer eso, ejecute la utilidad updatelicense desde el equipo donde está instalado su ArcGIS Data Store principal. Si tiene ArcGIS Data Store de respaldo, la licencia actualizada se replicará en él.
Sintaxis
updatelicense
Ejemplo
Una vez actualizada la licencia de ArcGIS Serverejecute la utilidad updatelicense para trasladar la nueva licencia al data store.
./updatelicense.sh
updatesslcertificate
Se usa con todos los tipos de data store.
Puede sustituir el certificado autofirmado utilizado 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 entidad emisora de certificados (CA) o un certificado de dominio.
Sintaxis
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
Ejemplo
Una vez que haya recibido un archivo de certificado firmado por una entidad emisora (CA), ejecute updatesslcertificate para sustituir el certificado autofirmado de ArcGIS Data Store.
./updatesslcertificate.sh /usr/files/mysignedcert.pfx ps4mycert dsmachinename