Os utilitários de comando, instalados com ArcGIS Data Store, fornecem as ferramentas de administrador do armazenamento de dados para gerenciar armazenamentos de dados. Este tópico descreve os utilitários e fornece sintaxe e exemplos.
Todos os utilitários devem ser executados na máquina do ArcGIS Data Store. Você pode localizar os utilitários no diretório <ArcGIS Data Store installation directory>/datastore/tools.
Você pode digitar o nome do utilitário seguido por --help para obter ajuda de sintaxe.
allowconnection
Utilizado com armazenamentos de dados relacionais.
Por razões de segurança, todas as conexões para o armazenamento de dados são feitas pelo site do GIS Server por padrão. Se você deseja abrir o armazenamento de dados relacional para conexões a partir de uma máquina adicional, você poderá utilizar o utilitário de comando allowconnection.
O utilitário allowconnection pode ser executado somente na máquina primária do armazenamento de dados relacional.
Sintaxe
allowconnection <host name> <user name> [<database>]
Especifique o nome do computador que você deseja conectar ao armazenamento de dados relacional (nome de host) e uma das contas do banco de dados utilizada pelo armazenamento de dados (nome de usuário): o administrador do armazenamento de dados, proprietário da réplica, administrador do geodatabase ou usuário gerenciado (o usuário que publica dados da camada de feição), que você pode obter utilizando o utilitário listadminusers ou listmanageduser. Você também pode especificar o nome do banco de dados primário do armazenamento de dados relacional mas, desde que haja somente um, este valor é opcional.
Exemplo
Neste exemplo, uma conexão é permitida a partir do computador workcom ao armazenamento de dados relacional quando conectando como o usuário gerenciado hqo.n_1E7.
./allowconnection.sh workcom hqo.n_1E7
backupdatastore
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Se for necessário criar uma cópia de segurança do armazenamento de dados relacional entre horários da cópia de segurança programados, utilize o utilitário backupdatastore. Utilize este utilitário para criar manualmente uma cópia de segurança completa antes de atualizar o armazenamento de dados ou antes de criar um grande número de alterações no armazenamento de dados.
A primeira vez que você executar o utilitário backupdatastore para um armazenamento de dados do cache de mosaico, cópias auxiliares serão criadas de todos os bancos de dados do armazenamento de dados do cache de mosaico existente. O uso subsequente do utilitário backupdatastore cria cópias auxiliares de quaisquer bancos de dados do armazenamento de dados do cache de mosaico criados desde a última vez que você executou o utilitário.
A primeira vez que você executa o utilitário backupdatastore para um armazenamento de grandes dados de espaço-tempo, uma cópia de segurança completa é criada. Já que os armazenamentos de grandes dados de espaço-tempo podem ser muito grandes, o uso subsequente do utilitário backupdatastore cria um arquivo da cópia de segurança contendo somente as alterações desde a cópia de segurança completa inicial.
O utilitário backupdatastore pode ser executado na máquina primária do armazenamento de dados do cache de mosaico ou relacional. Este utilitário pode ser executado de qualquer máquina que seja um membro do seu armazenamento de grandes dados de espaço-tempo.
Em todos os casos, tenha certeza que o local da cópia de segurança é grande o suficiente para acomodar suas cópias de segurança. Para alterar os locais da cópia de segurança do armazenamento de dados, utilize o utilitário configurebackuplocation.
Sintaxe
backupdatastore [<backup name>] [--store {relational|tileCache|spatiotemporal}] [--location <backup_arguments>] [--prompt <yes | no>]
O parâmetro --location é suportado pelos armazenamentos de grandes dados de espaço-tempo e armazenamentos de dados relacionais. O argumentos para este parâmetro são como seguem e devem ser separados com pontos-e-vírgulas (;):
- type=: Os tipos válidos são fs (compartilhamento de arquivo), s3 (contêiner Amazon Simple Storage Service (S3)) ou azure (contêiner de armazenamento Microsoft Azure Blob).
- name=: Se você atribuiu nomes para as localizações de cópia de segurança que você configurou para seu armazenamento de dados spatiotemporal big, você pode utilizar o nome da localização para especificar onde deseja que os arquivos de cópia de segurança sejam criados ao executar o utilitário backupdatastore.
- location=: Se você não especificar um nome do local da cópia de segurança, você deve especificar a cópia de segurança type e location. Para compartilhamentos de arquivo, forneça o caminho do arquivo. Para contêiners S3 , forneça o nome do contêiner. Para contêiners de armazenamento Azure Blob, forneça o nome do contêiner.
Exemplo
Neste exemplo, um arquivo da cópia de segurança completo denominado project1bu é criado no local da cópia de segurança que você especificou para o armazenamento de dados utilizando o utilitário configurebackuplocation. Por padrão, as cópias de segurança são criadas para armazenamentos de dados relacionais; então, no exemplo seguinte, uma cópia de segurança do armazenamento de dados relacional é criada.
./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
Neste exemplo, um arquivo de cópia de segurança nomeado localbu5 é criado para o armazenamento de dados spatiotemporal big em uma localização de compartilhamento de arquivo, que você nomeou gadbu quando você configurou a localização da cópia de segurança.
./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
Neste exemplo, uma cópia de segurança é criada de um armazenamento de grandes dados de espaço-tempo em um contêiner de armazenamento do Azure Blob denominado blob4backups e o arquivo da cópia de segurança criado é denominado 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
Utilizado com armazenamentos de dados relacionais.
Validado:
A Esri retirou o utilitário changebackuplocation. Ele ainda está presente para permitir que scripts existentes continuem a funcionar, mas você deve então começar a utilizar o utilitário configurebackuplocation .
Os arquivos da cópia de segurança do armzenamento de dados relacional são armazenados na mesma máquina do armazenamento de dados por padrão. Você deve mover seus arquivos da cópia de segurança para uma máquina separada para garantir que você possa acessá-los se a máquina onde o ArcGIS Data Store está instalado estiver inacessível.
Certifique-se que o login que executa o utilitário changebackuplocation tem permissões de leitura e escrita no diretório compartilhado.
O utilitário changebackuplocation aplica-se somente em cópias de segurança criadas para um armazenamento de dados relacional.
Sintaxe
changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]
Especifique --is-shared-folder true se o local da cópia de segurança estiver em uma máquina de rede compartilhada. Se você desejar que os arquivos da cópia de segurança existentes sejam movidos para o novo local, especifique --keep-old-backups true.
changedatastoremode
Utilizado com armazenamentos de dados relacionais.
O utilitário changedatastoremode permite a você adicionar um armazenamento de dados relacional em modo somente para leitura enquanto você executar a manutenção na armazenamento de dados. Por exemplo, caso seja necessário executar uma tarefa de manutenção que causará a reinicialização do armazenamento de dados, como alterar o local da cópia de segurança de um drive para outro ou alterar as propriedades do banco de dados, você poderá adicionar o armazenamento de dados relacional em modo somente para leitura, então nenhum usuário estará no processo de publicação ou editando dados quando o armazenamento de dados reiniciar.
O utilitário changedatastoremode também é utilizado para adicionar o armazenamento de dados relacional de volta em modo de leitura-escrita após você terminar a manutenção ou após você adicionar espaço em disco o suficiente na máquina primária do armazenamento de dados para permitir ao armazenamento de dados funcionar corretamente em modo de leitura-escrita.
O utilitário changedatastoremode pode ser executado somente na máquina primária do armazenamento de dados relacional.
Anotação:
Se o ArcGIS Data Store adicionou seu armazenamento de dados relacional em modo somente para leitura devido ao espaço em disco insuficiente, cópias de segurança automáticas também foram desabilitadas para evitar o preenchimento em disco adicional. Então, você também precisará redefinir seu horário da cópia de segurança automática através do utilitário updatebackupschedule após adicionar o armazenamento de dados relacional de volta em modo de leitura-escrita.
Sintaxe
changedatastoremode readonly|readwrite [--prompt <yes|no>]
Exemplo
Neste exemplo, o armazenamento de dados relacional é adicionado de volta em modo de leitura-escrita, significando que clientes podem retomar tais atividades como publicar camadas de feição hospedadas no portal, editar dados por uma camada de feição hospedada, ou adicionar arquivos CSV no Map Viewer.
./changedatastoremode.sh readwrite --prompt no
changedbproperties
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O utilitário changedbproperties permite a você alterar as diferentes propriedades dependendo do tipo de armzenamento de dados no qual você executa.
Sintaxe
changedbproperties --store <relational | tileCache | spatiotemporal> [configuration options]
Opções de configuração suportadas:
- disk-threshold-readonly: Esta configuração controla quando um armazenamento de dados relacional é adicionado em modo somente para leitura para evitar perda de dados devido ao espaço em disco insuficiente. O valor do espaço em disco padrão é 1024 MB. Especifique tamanhos em MB.
- max-connections: Utilize este parâmetro para especificar o número máximo de conexões permitidas para um armazenamento de dados relacional. O armazenamento de dados relacional aceita até 150 conexões por padrão. Você pode utilizar a propriedade --max-connections com o utilitário changedbproperties para alterar o número de conexões permitidas. Ao determinar a quantidade de conexões que seu armzenamento de dados exige, leve em consideração que os processos internos do ArcGIS Data Store podem ter até cinco conexões. Também considere quantas conexões de concorrentes sua máquina do ArcGIS Data Store pode aceitar e continuar a execução. Se a máquina executando o ArcGIS Data Store não tiver muita memória, talvez seja necessário diminuir o número de conexões permitidas.
O número especificado não pode ser menor que 10. Ao alterar o número máximo de conexões permitidas, o número é alterado nas máquinas principal e auxiliar do armazenamento de dados. Este parâmetro não é suportado para armazenamentos de grandes dados de espaço-tempo ou armazenamentos de dados para cache de mosaico.
- pitr: Esta configuração indica se o ArcGIS Data Store criará cópias de segurança incrementais do armazenamento de dados relacional, permitindo assim, que você recupere o armazenamento de dados relacional em um ponto no tempo. As entradas possíveis para esta opção são enable ou disable. A recuperação de ponto no tempo é desabilitada por padrão.
Anotação:
Você deve habilitar a recuperação de ponto no tempo se você utilizar o utilitário webgisdr para criar cópias de segurança incrementais da sua implantação do ArcGIS Enterprise.
- enablessl: Este parâmetro controla o uso do protocolo Transport Layer Security (TLS) ao preencher o armazenamento de dados de cache de mosaico.
Opções suportadas dos parâmetros enablessl são como seguem:
- admin: Esta é a opção padrão. Especifique admin para utilizar Transport Layer Security ao criar o contêiner do armazenamento de dados de cache de mosaico.
- data: Especifique data para utilizar Transport Layer Security ao gravar dados de camada de cena no armazenamento de dados de cache de mosaico.
- admin,data: Especifique admin,data para utilizar Transport Layer Security ao criar e gravar dados no armazenamento de dados de cache de mosaico.
- none: Especifique none para utilizar comunicação de HTTP a partir do servidor de hospedagem ao criar e gravar no armazenamento de dados de cache de mosaico.
- heap-size: Utilize este parâmetro para alterar a quantidade de memória acumulada (em MB) utilizada pelo armazenamento de grandes dados de espaço-tempo. Por padrão, este tipo de armazenamento de dados utilizará metade da RAM disponível ao iniciar. Este parâmetro não é suportado para armazenamento de dados para cache do mosaico e relacional.
- rebalance: Por padrão, este parâmetro é configurado para true, o que significa que dados em um armazenamento de grandes dados de espaço-tempo distribuirão dados para outras máquinas se qualquer uma das máquinas estiver indisponível. Caso seja necessário executar a manutenção em uma máquina do armazenamento de grandes dados de espaço-tempo, como atualizá-la, você poderá fechar temporariamente o rebalanceamento configurando este parâmetro parafalse. A operação do rebalanceamento será suspensa por um período de tempo configurado para o parâmetro max-rebalance-off . Este parâmetro aplica-se somente aos armazenamentos de grandes dados de espaço-tempo.
Validado:
No ArcGIS 10.4.x, esta opção era reallocation.
- max-rebalance-off: A configuração deste parâmetro é utilizada quando você configura o parâmetro rebalance para false. Por padrão, max-rebalance-off é configurado para 60 minutos. Isto significa que, se você desabilitar temporariamente o rebalanceamento, ele começará novamente após 60 minutos. Se você precisar de mais ou menos tempo que isto para executar a tarefa de manutenção para a qual você suspendeu o rebalanceamento, altere a configuração de tempo para max-rebalance-off. Este parâmetro aplica-se somente aos armazenamentos de grandes dados de espaço-tempo.
Validado:
No ArcGIS 10.4.x, esta opção era max-allocation-off.
- prompt: Quando você executa este utilitário, você é solicitado para confirmar a ação que você especificou. Se você automatizar o uso deste utilitário, configure o parâmetro prompt para falso; caso contrário, o script não prosseguirá até que você responda a solicitação.
Exemplo
Neste exemplo, o número máximo de conexões permitidas para um armazenamento de dados relacional está configurado para 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)?YesNeste exemplo, a opção max-rebalance-off é utilizada para definir 15 como o número de minutos que o armazenamento de grnades dados de espaço-tempo mudará automaticamente rebalance para verdadeiro.
./changedbproperties.sh --store spatiotemporal --max-rebalance-off 15
Neste exemplo, o parâmetro enablessl é utilizado para configurar o armazenamento de dados de cache de mosaico para utilizar Transport Layer Security quando o contêiner for criado e ao gravar os dados no armazenamento de dados de cache de mosaico.
./changedbproperties.sh --store tileCache --enablessl admin,data
changeloglocation
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Se você não desejar que o armazenamento de dados utilize o local do arquivo de log do erro padrão do <ArcGIS Data Store installation directory>\arcgisdatastore\logs, você poderá executar o utilitário changeloglocation para criar arquivos de log do erro em um diretório diferente.
Sintaxe
changeloglocation <directory path>
Exemplo
Neste exemplo, arquivos de log serão criados no diretório local, ../datastorefiles/logs.
./changeloglocation.sh '../datastorefiles/logs'
changenosqldslocation
Utilizado com armazenamentos de dados do cache de mosaico.
O armazenamento de dados para cache do mosaico pode ficar grande se você armazenar muitos mosaicos de alta resolução nele. Nestes casos, você pode desejar mover os dados para outra unidade no mesmo servidor ou para um local compartilhado em um servidor diferente.
Se você mover os dados para um diretório compartilhado, você deverá conceder as permissões de leitura e escrita no diretório para o usuário executando o processo ArcGIS Data Store (Linux) ou serviço (Microsoft Windows).
Sintaxe
changenosqldslocation <path> [--prompt {yes | no}]
Exemplo
Neste exemplo, os bancos de dados que armazenam caches da camada de cena agora serão criados em um diretório compartilhado denominado dstorecache na máquina server2.
changenosqldslocation /net/server2/dstorecache
changepassword
Utilizado com armazenamentos de dados relacionais.
O ArcGIS Data Store gera aleatoriamente nomes de usuários e senhas para contas do banco de dados utilizadas para armazenamentos de dados relacionais. Se o seu site exigir que você configure suas próprias senhas, obtenha as senhas para contas do armazenamento de dados, e execute changepassword para redefinir as senhas.
Utilize o utilitário listadminusers para obter nomes de usuários e senhas para usuários administradores e o utilitário listmanageduser para obter o nome de usuário e senha para o proprietário de dados da feição.
O utilitário changepassword pode ser executado somente na máquina primária do armazenamento de dados relacional.
Sintaxe
changepassword <user name> <new password> [--prompt {yes | no}]
Dica:
Se você precisar de script para alterar a senha, inclua uma bandeira para suprimir o lembrete de confirmação, como no seguinte exemplo:
changepassword gwi_n2Te0 Phfl4mp --prompt no
Exemplo
Neste exemplo, a senha é alterada para usuário gwi_n2Te0 para 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
Utilizado com armazenamentos de dados relacionais.
Quando você restaura seu armazenamento de dados relacional, o ArcGIS Data Store extrai os arquivos da cópia de segurança compactados no local de execução. Isto significa que você precisa ter um local de teste que pode acomodar estes dados descompactados. Se você tiver muitos dados no seu armazenamento de dados relacional, você poderá desejar a configuração de um local de execução separado e especificá-lo para recuperar.
Sintaxe
changestaginglocation <directory path>
Exemplo
Neste exemplo, o local de execução designado é /net/sanmarcos/stage.
./changestaginglocation.sh /net/sanmarcos/stage
configurebackuplocation
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O utilitário configurebackuplocation permite a você especificar o local onde o ArcGIS Data Store grava arquivos de cópia de segurança em ambas cópias de segurança agendadas e cópias de segurança criadas com o utilitário backupdatastore. Este comando também permite alterar as propriedades de um local da cópia de segurança e remover um local da cópia de segurança.
Os armazenamentos de dados do cache de mosaico ou relacional são criados com um local da cópia de segurança local padrão. Configure um local da cópia de segurança padrão mais seguro registrando um diretório compartilhado remoto utilizando a opção change .
Os armazenamentos de grandes dados de espaço-tempo não são criados com um local padrão. Antes de você poder iniciar a criação de cópias de segurança, você deve executar o utilitário configurebackuplocation com a opção register para especificar um local de rede compartilhada, um contêiner Amazon Simple Storage Service (S3) ou contêiner de armazenamento Microsoft Azure para estas cópias de segurança. Você não pode utilizar um drive local dos arquivos da cópia de segurança do armazenamento de grandes dados de espaço-tempo.
Para ambos armazenamentos de grandes dados de espaço-tempo e relacional, você pode registrar um segundo local de cópia de segurança para armazenar cópias de segurança completas que você cria utilizando o utilitário backupdatastore. Você pode utilizar um diretório de arquivo compartilhado, um contêiner S3 ou um contêiner de armazenamento Azure Blob para locais da cópia de segurança secundários.
Sintaxe
configurebackuplocation --location '<backup_location_arguments>' [options]
Utilize a opção --location para especificar onde você deseja ArcGIS Data Store armazenar os arquivos da cópia de segurança. Para armazenamentos de grandes dados de espaço-tempo ou para registrar um local da cópia de segurança secundário para um armazenamento de dados relacional, especifique os parâmetros seguintes separados por um ponto-e-vírgula (;) e inclua a string de parâmetro inteira etre aspas ('): --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>]'. Uma explicação de cada um destes parâmetros é fornecida na seguinte:
- type=: Especifique qual tipo de localização para utilizar para cópias de segurança. Você pode especificar s3 para armazenar cópias de segurança em um contêiner Amazon S3 , azure para armazenar cópias de segurança em um contêiner de armazenamento Azure ou fs para armazenar cópias de segurança em um compartilhamento de arquivo (isto é o padrão).
- location=: Para compartilhamentos de arquivo, especifique o caminho do arquivo. Para contêiners Amazon S3 , especifique o nome do contêiner. Para contêiners de armazenamento Blob, especifique o nome do contêiner.
- name=: Você pode atribuir um nome à localização das cópia de segurança. Por exemplo, se sua localização da cópia de segurança for um caminho de arquivo, como \\sharedserver_sharedfolders_datastorebackups, você pode designar um nome para esta localização, como dsbackups. Quando você executar o utilitário backupdatastore, listbackups ou restoredatastore , forneça este nome em vez do caminho completo.
Se você não fornecer um nome ao configurar a localização da cópia de segurança de armazenamento de dados, o ArcGIS Data Store atribui um nome padrão.
- username=: Exigido se a sua localização da cópia de segurança for um contêiner S3 ou contêiner de armazenamento Blob. Para contêiners S3 , forneça o ID da chave de acesso para sua conta Amazon Web Services (AWS) . Para contêiners de armazenamento Azure Blob, forneça o nome do usuário do login da conta de armazenamento do Microsoft Azure que pode acessar o contêiner de armazenamento Blob.
- password=: Exigido se a sua localização da cópia de segurança for um contêiner S3 ou contêiner de armazenamento Blob. Para contêiners S3 , forneça a chave secreta para sua conta AWS . Para contêiners de armazenamento do Azure Blob, forneça a chave de conta do Azure que você especificou com o parâmetro username .
Opções adicionais que você precisa fornecer com o utilitário configurebackuplocation são como segue:
- --store <relational|tileCache|spatiotemporal>: Especifique o tipo de ArcGIS Data Store para o qual você está configurando um local da cópia de segurança. O valor padrão é relational.
- --operation <change|register|unregister|list|setdefault>: O valor padrão é change. O seguinte é uma explicação de cada opção:
- change: Utilize esta opção para alterar qualquer um dos seguintes itens:
- Especifique um local de arquivo compartilhado diferente para cópias de segurança do armazenamento de dados de cache do mosaico ou relacional agendadas. O local definido com a opção change é sempre o local da cópia de segurança padrão destes tipos de armazenamentos de dados.
- Altere o nome que você atribuiu ao local da cópia de segurança.
- Atualize as informações de autenticação que você definiu para locais da cópia de segurança do armazenamento de grandes dados de espaço-tempo ou relacional no Azure ou S3. Para S3, você pode alterar as informações especificadas anteriormente com as opções username e password . Para Azure, você pode alterar o valor password .
- register: Utilize com armazenamentos de grandes dados de espaço-tempo ou relacional para registrar um local da cópia de segurança. O primeiro local da cópia de segurança que você define para um armazenamento de grandes dados de espaço-tempo é configurado como o local da cópia de segurança padrão. Quando você especifica a opção register com um armazenamento de dados relacional, ele registra um local da cópia de segurança secundário. O local da cópia de segurança secundário armazena cópias de segurança manuais geradas com o utilitário backupdatastore .
Anotação:
Quando você utiliza a opção register , você deve fornecer informações para a opção --location .
- unregister: Utilize para remover um local da cópia de segurança secundário a partir de um armazenamento de dados relacional ou um local da cópia de segurança do armazenamento de grandes dados de espaço-tempo. Se somente um local da cópia de segurança estiver registrado, você poderá utilizar a opção de cancelamento de registro para remover completamente o local da cópia de segurança do armazenamento de grandes dados de espaço-tempo.
- list: Lista todos as localizações da cópia de segurança registradas para um armazenamento de grandes dados de espaço-tempo ou relacional.
- setdefault: Se você tiver múltiplas localizações da cópia de segurança para um armazenamento de grandes dados de espaço-tempo, você poderá utilizar setdefault para designar uma das localizações da cópia de segurança como a localização padrão. Esta localização é onde as cópias de segurança agendadas são gravadas e é a localização padrão utilizada se você executar o utilitário backupdatastore, listbackups, ou restoredatastore sem especificar uma localização de cópia de segurança.
- change: Utilize esta opção para alterar qualquer um dos seguintes itens:
- --force <true | false>: Utilizado somente com armazenamentos de dados relacionais, esta opção permite alterar o local da cópia de segurança padrão mesmo se o local da cópia de segurança padrão existente não estiver disponível.
Quando você altera o local da cópia de segurança padrão para um armazenamento de dados relacional, o ArcGIS Data Store copia os arquivos da cópia de segurança existentes do local antigo para o novo local. Se ArcGIS Data Store não puder acessar o local antigo, ele não poderá copiar os arquivos. Nas versões anteriores, isto causaria uma falha na ferramenta configurebackuplocation. Se você deseja prosseguir com a alteração do local da cópia de segurança padrão sem copiar os arquivos da cópia de segurança existentes, especifique --force true.
O valor padrão para esta opção é false, o que significa que você não pode alterar o local da cópia de segurança padrão se o ArcGIS Data Store não puder acessar o local padrão existente.
- --prompt <yes | no>: O valor padrão é yes.
Exemplos
No primeiro exemplo, o local da cópia de segurança para um armazenaento de dados relacional é configurado para um diretório denominado fsdata_bu em uma máquina denominada 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
Neste exemplo, um segundo local da cópia de segurança no Azure é registrado para o mesmo armazenamento de dados 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
Neste exemplo, um local da cópia de segurança em um compartilhamento rede é registrado para um armazenamento de grandes dados de espaço-tempo. Um nome, fshare, é atribuído à localização da cópia de segurança.
./configurebackuplocation.sh --operation register --store spatiotemporal --location 'type=fs;location=/net/sharedmachine/ge_bu;name=fshare'
Neste exemplo, um segundo local da cópia de segurança no AWS é especificado para o mesmo armazenamento de grandes dados de espaço-tempo. Um nome, awsloc, é atribuído à localização da cópia de segurança.
configurebackuplocation --operation register --store spatiotemporal --location 'type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0'
Neste exemplo, um terceiro local da cópia de segurança no Azure é especificado para o armazenamento de grandes dados de espaço-tempo.
configurebackuplocation --operation register --store spatiotemporal --location 'type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount'
Neste exemplo, o contêiner S3 é configurado como o local da cópia de segurança padrão para o armazenamento de grandes dados de espaço-tempo.
configurebackuplocation --operation setdefault --store spatiotemporal --location 'name=awsloc'
Neste exemplo, todas as localizações da cópia de segurança para o armazenamento de grandes dados de espaço-tempo são listadas.
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
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Após instalar o ArcGIS Data Store, você poderá executar o utilitário configuredatastore para criar um armazenamento de dados e registrá-lo com um site do GIS Server. Você pode criar os seguintes tipos de armazenamentos de dados utilizando este comando:
- Armazenamento de dados relacional
- Armazenamento de dados do cache de mosaico
- Armazenamento de grandes dados de espaço-tempo
Você também pode executar o utilitário configuredatastore para atualizar um armazenamento de dados após atualizar o software ArcGIS Data Store em todas as máquinas no armazenamento de dados.
Sintaxe
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores <relational|tileCache|spatiotemporal>] [--nosql-only true|false]
A URL de admin do ArcGIS Server está no formato https://gisserver.domain.com:6443. Note que mesmo que seu site do GIS Server utilize um web adaptor, você deve fornecer a URL no formato acima mencionado.
Forneça o nome de usuário e senha para um usuário embutido (não enterprise) que tem privilégios de administrador no site do GIS Server.
O diretório de dados é o local na máquina local onde você deseja que os arquivos do armazenamento de dados sejam criados.
Entretanto não é recomendado, você pode configurar mais de um tipo de armazenamento de dados na mesma máquina especificando cada tipo de armazenamento separado por uma vírgula (sem espaço). Por exemplo, para configurar ambos armazenamentos de dados de cache de mosaico e relacional na mesma máquina com um diretório do armazenamento de dados compartilhados, especifique --stores relational,tileCache. A Esri recomenda fortemente que você execute os armazenamentos de grandes dados de espaço-tempo em máquinas separadas de outros armazenamentos de dados ou software.
Validado:
Em versões anteriores, você especificaria a opção --nosql-only configurada para verdadeiro para criar um armazenamento de dados somente para mosaicos com cache da camada de cena. Esta opção ainda está presente, então os scripts existentes podem continuar a funcionar. Todos os novos scripts devem configurar a opção --stores para tileCache ao invés.
Configurar um tipo específico de armazenamento de dados
Você especifica o tipo de armazenamento de dados para criar utilizando as seguintes configurações com a opção --stores :
- relational
- tileCache
- spatiotemporal
Para configurar mais de um tipo de armazenamento de dados na mesma máquina, separe os tipos com uma vírgula. Por exemplo, para configurar ambos o armazenamento de dados de cache do mosaico e relacional na mesma máquina, especifique --stores relational,tileCache.
Anotação:
Os armazenamentos de dados configurados na mesma máquina competirão por memória e outros recursos, afetando negativamente o desempenho e possivelmente fazendo com que os armazenamentos de dados parem de funcionar. Isto é especialmente verdadeiro para armazenamentos de grandes dados de espaço-tempo; não configure um armazenamento de grandes dados de espaço-tempo na mesma máquina que outro armazenamento de dados ou outro componente do ArcGIS.
Note que se você definir o script da criação de múltiplas máquinas do armazenamento de grandes dados de espaço-tempo, uma máquina do armazenamento de grandes dados de espaço-tempo deverá ser configurada manualmente com o GIS Server antes de você poder executar o script da criação de máquinas do armazenamento de grandes dados de espaço-tempo adicionais.
Configure os armazenamentos de dados após atualizar as instalações do ArcGIS Data Store
Como parte da atualização o ArcGIS Data Store, você deve configurar novamente as máquinas de armazenamento de dados existentes. Após você instalar uma nova versão do ArcGIS Data Store acima do ArcGIS Data Store existente em cada máquina de armazenamento de dados, você pode efetuar o login na máquina do armazenamento de dados de cache de mosaico e primária, e executar o utilitário configuredatastore para finalizar a atualização dos armazenamentos de dados. Quando você executar o utilitário a partir da máquina primária, a máquina de cache de mosaico ou auxiliar relacional também está atualizado.
Se sua máquina primária contém ambos armazenamentos de dados de cache e de mosaico, especifique --stores relational,tileCache quando você executar o utilitário configuredatastore e ele atualiza os armazenamentos de dados de cache de mosaico, primário e relacional auxiliar.
Para reconfigurar máquinas do armazenamento de grandes dados de espaço-tempo atualizadas, entre em qualquer uma das máquinas no armazenamento de grandes dados de espaço-tempo e execute o utilitário configuredatastore. Isto atualiza todas as máquinas no armazenamento de grandes dados de espaço-tempo.
Note que se você não instalou a nova versão do ArcGIS Data Store em todas as máquinas, a configuração não pode prosseguir.
Exemplo
Neste exemplo, um armazenamento de dados para dados da camada de feição hospedada (armazenamento de dados relacional) foi criado. A URL de site do GIS Server que utilizará o armazenamento de dados é https://gisserver.domain.com:6443, o nome de usuário e senha de administrador do site são admin e Iph33l$ik respectivamente, e o diretório de dados do armazenamento de dados é /dstore/data.
./configuredatastore.sh https://gisserver.domain.com:6443 admin Iph33l$ik /dstore/data --stores relational
deletebackup
Utilizado com armazenamentos de dados relacionais.
O utilitário deletebackup permite a você excluir arquivos da cópia de segurança que você criou para armazenamento de dados relacional. Primeiro, execute o utilitário listbackups para visualizar os nomes e os horários de criação das suas cópias de segurança manuais. Você pode então executar o utilitário deletebackup para excluir a cópia de segurança manual que não é mais necessária.
Note que você pode excluir somente as cópias de segurança que não são exigidas para recuperar seu armazenamento de dados. Por exemplo, você não pode excluir a cópia de segurança completa mais recente do armazenamento de dados relacional.
Sintaxe
deletebackup <backup name> [--prompt <yes | no>]
Exemplo
./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
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O utilitário describedatastore permite a você visualizar as seguintes informações sobre uma instalação do ArcGIS Data Store:
- O número de versão do software para instalação do ArcGIS Data Store
- O local de execução utilizado pelo armazenamento de dados para restaurar
- O local do arquivo de log para um armazenamento de dados
- A quantidade do espaço em disco disponível restante na máquina onde o ArcGIS Data Store está instalado
- O limite do espaço em disco gratuito no qual um armazenamento de dados relacional será colocado em modo de somente leitura e armazenamentos de grandes dados de espaço-tempo e de cache do mosaico serão parados
- Os locais da cópia de segurança utilizados por cada tipo de armazenamento de dados
- Se o local da cópia de segurança do armazenamento de dados do cache de mosaico ou relacional está em um compartilhamento de rede
- Com que frequência uma cópia de segurança é criada do armazenamento de dados (Horário da cópia de segurança)
- Por quantos dias os arquivos da cópia de segurança do armazenamento de dados relacional são retidos
- Se o armazenamento de dados está executando ou não (Status do DataStore)
- A data e hora que o armazenamento de dados do cache de mosaico ou relacional auxiliar se tornou o armazenamento de dados primário (Última ativação após falha); não exibido se nunca ocorreu a ativação após falha
- Os nomes das máquinas que participam no armazenamento de dados do cache de mosaico ou relacional (Máquinas do membro)
- Máximo de conexões permitidas para um armazenamento de dados relacional
- A URL de site do GIS Server com a qual o armazenamento de dados está registrado (URL de Propriedade do Sistema)
- A URL do portal que está utilizando o site do GIS Server como seu servidor de hospedagem (URL do Portal)
- O número de conexões da camada de feição atual no armazenamento de dados relacional
- Uma lista de todas as máquinas atualmente participando do armazenamento de grandes dados de espaço-tempo (Máquinas no grupo de espaço-tempo)
- A máquina dentro do armazenamento de grandes dados de espaço-tempo que está atualmente designada como a máquina mestre (Máquina mestre atual no grupo)
- Uma lista de todas as máquinas no grupo do armazenamento de grandes dados de espaço-tempo (máquinas de espaço-tempo registradas); mostra todas as máquinas no grupo não importando seus status
Sintaxe
describedatastore
Exemplo
O utilitário describedatastore retorna informações gerais que se aplicam em todos os armazenamentos de dados em uma máquina e retorna seções separadas específicas que contêm informações específicas para cada tipo de armazenamento de dados.
Embora você provavelmente terá diferentes armazenamentos de dados em máquinas diferentes, a seguinte saída mostra uma máquina com todos os três tipos na mesma máquina, assim você poderá visualizar as diferentes seções para 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
Validado:
A Esri desativou o utilitário exportmanageddb no 10.5.1. A funcionalidade foi incorporada ao utilitário backupdatastore. O utilitário exportmanageddb ainda está presente para permitir que os scripts existentes continuem a funcionar, mas ao contrário, você deve começar a utilizar o utilitário backupdatastore para criar um arquivo da cópia de segurança, então utilizar o utilitário restoredatastore para restaurar o armazenamento de dados do arquivo da cópia de segurança.
Utilizado com armazenamentos de dados de cache do mosaico ou relacional.
O utilitário exportmanageddb cria um arquivo de exclusão do armazenamento de dados relacional, metadados sobre um armazenamento de dados, e todos os bancos de dados que armazenam caches de mosaico da camada de cena hospedada. Exporte o armazenamento de dados caso precise criar uma cópia de segurança a ser restaurada para uma instalação do ArcGIS Data Store que está em uma máquina com um sistema operacional diferente ou é uma versão diferente do ArcGIS Data Store.
Certifique-se que ninguém esteja editando camadas de feição ou publicando no seu portal antes de importar o armazenamento de dados para a nova máquina. Também certifique-se que o local no qual você exporta o armazenamento de dados contém espaço de armazenamento o suficiente para o arquivo de exclusão do armazenamento de dados relacional e cópias de todos seus bancos de dados do cache de mosaico da camada de cena hospedada.
O utilitário exportmanageddb não exporta spatiotemporal big data stores.
Sintaxe
exportmanageddb <output location> <backup name> [options]
O local de saída é o local em disco onde a pasta (<backup name>) e arquivos exportados serão criados. Você deve ter acesso de escrita neste local.
As opções suportadas incluem as seguintes:
- [--stores {relational|tileCache}]: Indica qual tipo de armazenamento de dados você deseja exportar. Se os seus armazenamentos de dados de cache do mosaico ou relacional estiverem executando na mesma máquina e você deseja exportar ambos, especifique ambos separados por uma vírgula; por exemplo, digite --stores relational,tileCache. Se você não especificar a opção --stores , relacional é assumido.
- [--include-tilecache <true|false>]: Esta opção está presente para compatibilidade com versões anteriores. Se você não especificar a opção --stores ou você especificar --stores relational, você poderá controlar se o armazenamento de dados do cache de mosaico foi exportado ou não utilizando esta opção.
- [--prompt {yes|no}]: Determina se você deve responder um lembrete para executar o utilitário.
Exemplo
No seguinte exemplo, o arquivo de exclusão, cópias dos bancos de dados de cache da camada de cena hospedada, e arquivos do armazenamento de dados associados são saída para um diretório de rede compartilhado denominado movedsfirstexp em um servidor denominado 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
Utilizado com armazenamentos de dados de cache do mosaico ou relacional.
Se você exportou um ArcGIS Data Store contendo bancos de dados de cache da camada de cena hospedada ou camada de feição hospedada (ou ambos), você poderá utilizar o utilitário importmanageddb para restaurar o armazenamento de dados. Você pode restaurar para uma máquina do ArcGIS Data Store atualizada ou para uma instalação do ArcGIS Data Store em uma máquina com um sistema operacional diferente do ArcGIS Data Store de origem.
Se você desejar que o ArcGIS Data Store seja registrado com o mesmo site do GIS Server que foi antes, especifique --bound true e não especifique um --server-url. Note que --bound é configurado para verdadeiro, por padrão. Tenha certeza de reiniciar o site do GIS Server após a restauração.
Se você restaurar e deseja o registro do armazenamento de dados com um novo site do GIS Server, especifique o --server-url quando importar o armazenamento de dados.
Por padrão, o armazenamento de dados relacional e todos os bancos de dados de cache da camada de cena hospedada que compõem um armazenamento de dados de cache do mosaico no arquivo de exportação são importados. Se você não deseja incluir os bancos de dados de cache da camada de cena hospedada, especifique a opção --include-tilecache configurada para falso.
O utilitário importmanageddb não exporta armazenamentos de grandes dados de espaço-tempo.
Sintaxe
importmanageddb <source backup location> <backup name> [options]
As opções suportadas incluem as seguintes:
- [--server-url <ArcGIS Server URL registered with data store>] : Se você especificar--bound true e já tiver movido seus serviços para um novo site do GIS Server , utilize a opção --server-url para especificar a URL de novo site do GIS Server . Note, no entanto, a menos que você também tenha movido os serviços para este novo servidor, os dados no armazenamento de dados não estarão acessíveis.
- [--server-admin <user name of ArcGIS Server admin>]: Esta opção é exigida se você especificar --bound true ou não especificar a opção --bound . Forneça o nome de usuário do administrador no ArcGIS Server .
- [--server-password <password of ArcGIS Server admin>]: Esta opção é exigida se você especificar --bound true ou não especificar a opção --bound . Forneça a senha de administrador do ArcGIS Server.
- [--data-dir <data store data directory>]: O diretório do ArcGIS Data Store. Por padrão, este é o diretório do ArcGIS Data Store do armazenamento de dados atualmente registrados.
- [--stores {relational|tileCache}]: Indica qual tipo de armazenamento de dados você deseja importar. Se os seus armazenamentos de dados de cache do mosaico ou relacional estiverem executando na mesma máquina e você deseja exportar ambos, especifique ambos separados por uma vírgula; por exemplo, digite --stores relational,tileCache. Se você não especificar a opção --stores , relacional é assumido.
- [--include-tilecache <true|false>]: Esta opção está presente para compatibilidade com versões anteriores. Se você não especificar a opção --stores ou você especificar --stores relational, você poderá controlar se o armazenamento de dados do cache de mosaico foi exportado ou não utilizando esta opção.
- [--bound {true|false}]
- Se você especificar o --bound true ou não especificar a opção --bound você deverá especificar a URL de um site do GIS Server com a opção --server-url e especificar as credenciais de administrador do ArcGIS Server com as opções --server-admin e --server-password . Se você estiver importando para o mesmo site doGIS Server o ArcGIS Data Store estava registrado quando você exportou os armazenamento de dados, especifique a URL deste site do GIS Server e forneça o nome do usuário e senha do administrador do ArcGIS Server . Para vincular o armazenamento de dados a um novo site do GIS Server, forneça a URL e credenciais de administrador deste novo site.
Anotação:
Somente especifique informações para um novo site do GIS Server se você já moveu os seus serviços da web para este novo site do GIS Server.
- Se o seu armazenamento de dados não utilizar mais o site do GIS Server e você ainda não moveu todos os seus serviços para o novo site do GIS Server, especifique --bound false. Você deve então executar o utilitário registerdatastore para configurar o armazenamento de dados com o novo site do GIS Server após você mover os serviços para este novo site.
- Se você especificar o --bound true ou não especificar a opção --bound você deverá especificar a URL de um site do GIS Server com a opção --server-url e especificar as credenciais de administrador do ArcGIS Server com as opções --server-admin e --server-password . Se você estiver importando para o mesmo site doGIS Server o ArcGIS Data Store estava registrado quando você exportou os armazenamento de dados, especifique a URL deste site do GIS Server e forneça o nome do usuário e senha do administrador do ArcGIS Server . Para vincular o armazenamento de dados a um novo site do GIS Server, forneça a URL e credenciais de administrador deste novo site.
- [--prompt {yes|no}]: Determina se você deve responder um lembrete para executar o utilitário.
Exemplo
No seguinte exemplo, o armazenamento de dados é restaurado para uma instalação do ArcGIS Data Store de versão mais recente. O novo diretório de dados do ArcGIS Data Store é especificado. O armazenamento de dados ainda é limitado para um site do GIS Server existente, então o armazenamento de dados e camadas de cena e de feição hospedadas existentes continuam a funcionar. Reinicie seu site do GIS Server para permitir que camadas de cena e de feição hospedadas sejam publicadas na nova máquina.
./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
Neste exemplo, ambos o site do GIS Server e o armazenamento de dados relacional foram movidos para novas máquinas. Os serviços da web já foram movidos para o novo site do GIS Server, então a URL do novo site é especificada com a opção --server-url. O nome da cópia de segurança é movedbexp, e está armazenado em /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
Neste exemplo, serviços da web não foram movidos para o novo site do GIS Server. Os armazenamentos de dados do cache de mosaico e relacional não serão funcionais até que serviços sejam movidos e você subsequentemente registre um armazenamento de dados com o novo site do GIS Server . O nome da cópia de segurança é movedsfirstexp, e está armazenada em /net/backupserver/expdir/movingexp2.
./importmanageddb.sh /net/backupserver/dbdump/movingexp2 movedsfirstexp --data-dir /usr/arcgis/datastore --stores relational,tileCache --bound false
listadminusers
Utilizado com armazenamentos de dados relacionais.
O utilitário listadminusers retorna os nomes de usuários e senhas para o administrador, proprietário da réplica e administrador do geodatabase de um armazenamento de dados relacional.
Sintaxe
listadminusers
Exemplo
./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
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico. Quando executar para armazenamentos de dados do cache de mosaico ou relacional, o utilitário listbackups funcionará somente na máquina primária do armazenamento de dados.
O utilitário listbackups retorna os nomes de arquivos de cópia de segurança e a localização que eles são gravados. O utilitário listbackups também retorna o status da cópia de segurança (completa ou não), o horário inicial da cópia de segurança e se a cópia de segurança foi criada manualmente através do utilitário backupdatastore ou criada automaticamente pelo ArcGIS Data Store.
Quando você executar o utilitário listbackups para armazenamentos de dados spatiotemporal big, especifique a localização da cópia de segurança que deseja visualizar na lista de arquivos da cópia de segurança. Se você não especificar uma localização, o utilitário listbackups retorna cópias de segurança da localização da cópia de segurança padrão.
Você pode executar o utilitário listbackups para visualizar se uma cópia de segurança completou ou está ainda executando, determinar quantas cópias de segurança manuais você tem ou confirmar um nome de arquivo antes de executar o utilitário deletebackup.
Sintaxe
listbackups [--store <relational|tileCache|spatiotemporal>] [--location '<location_arguments>']
Se você não especificar um tipo de armazenamento de dados, o utilitário padronizará para relational e retornará as cópias de segurança para o armazenamento de dados relacional em execução nesta máquina.
O parâmetro location é utilizado com armazenamentos de grandes dados de espaço-tempo e armazenamentos de dados relacionais. Os parâmetros são como seguem:
- name=: O nome da localização da cópia de segurança. Você especificou este nome quando configurou a localização da cópia de segurança ou se você não especificou um nome, o ArcGIS Data Store atribuiu um nome padrão.
- location=: O caminho do diretório de arquivo compartilhado, nome do contêiner S3 ou nome do contêiner de armazenamento Blob.
Exemplo
Neste exemplo, cópias de segurança do armazenamento de grandes dados de espaço-tempo são listadas para a localização da cópia de segurança denominada 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
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O utilitário listmanageduser retorna o nome de usuário e senha da conta que tem os dados da camada de feição hospedada em armazenamentos de grandes dados de espaço-tempo ou relacional. Este utilitário também retorna o nome de usuário e senha do proprietário de dados para armazenamentos de dados do cache de mosaico.
Sintaxe
listmanageduser
Exemplo
No seguinte exemplo, o utilitário listmanageduser é executado em uma máquina primária que contém um armazenamento de dados do cache de mosaico e relacional.
./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
Neste exemplo, o utilitário listmanageduser é executado em uma máquina do armazenamento de grandes dados de espaço-tempo.
./listmanageduser.sh
Managed user for spatiotemporal big data store bds_6udbx4321 ============================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
registerdatastore
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O armazenamento de dados retém informações sobre os nomes da máquina de site do GIS Server. Se você mover seu site do GIS Server para novas máquinas (por exemplo, se você obteve um novo hardware ou se a máquina do GIS Server existente falhou), você deverá cancelar registro do armazenamento de dados no site do GIS Server para remover esta informações. Após você configurar o GIS Server em uma nova máquina (ou máquinas), você poderá registrar o armazenamento de dados com o site do GIS Server através do utilitário de comando registerdatastore.
Note que isto é utilizado para registrar o armazenamento de dados no mesmo site do GIS Server que foi registrado anteriormente. O armazenamento de dados contém os dados das camadas hospedadas no site do GIS Server existente. O registro em um site do GIS Server diferente, não recria as camadas de feição hospedadas, caches da camada de cena ou arquivos de dados do serviço de stream.
O utilitário registerdatastore pode ser executado na máquina primária do armazenamento de dados do cache de mosaico ou relacional. Ele pode ser executado em qualquer máquina do armazenamento de grandes dados de espaço-tempo.
Sintaxe
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password> --stores <relational|tileCache|spatiotemporal>
Entretanto não recomendado, se você tiver múltiplos diferentes tipos de armazenamentos de dados instalados na mesma máquina, você poderá registrá-los ao mesmo tempo especificando o tipo de armazenamento de dados separado por uma vírgula (sem espaço); por exemplo, digite --stores relational,tileCache.
Exemplo
Neste exemplo, um armazenamento de dados relacional está registrado em um site do GIS Server com a URL https://gisserver.domain.com:6443. O nome de usuário do principal administrador de site do ArcGIS Server é agsadmin com a senha Tan$p0n.
./registerdatastore.sh https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational
removemachine
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Utilize o utilitário removemachine para remover um dos seguintes da instalação do ArcGIS Data Store:
- Remover uma máquina auxiliar de um armazenamento de dados relacional. Pode ser executado na máquina auxiliar ou da máquina primária no caso onde a máquina auxiliar está indisponível.
- Remover uma máquina auxiliar de um armazenamento de dados para cache do mosaico. Pode ser executado na máquina auxiliar ou da máquina primária no caso onde a máquina auxiliar está indisponível.
- Remover uma máquina de um armazenamento de grandes dados de espaço-tempo. Note que você não pode executar removemachine em um armazenamento de grandes dados de espaço-tempo composto de somente uma máquina.
Sintaxe
removemachine <machine name> --store <relational|tileCache|spatiotemporal> [--force <true | false>] [--prompt <yes | no>]
--force: Por padrão, isto é configurado para falso. Especifique verdadeiro com esta opção somente se o site registrado do ArcGIS Server estiver indisponível.
--prompt: Por padrão, isto é configurado para sim. Se você não desejar confirmar a ação, especifique não, com esta opção.
Exemplo
Neste exemplo, a máquina do armazenamento de grandes dados de espaço-tempo, gefour, é removida do armazenamento de dados.
./removemachine.sh gefour --store spatiotemporal
Neste exemplo, o site de servidor de hospedagem está indisponível e a máquina de armazenamento de dados relacional, fsdata, é removido do armazenamento de dados.
./removemachine.sh fsdata --store relational --force true
removestandbymachine
Validado:
A Esri retirou o utilitário removestandbymachine. Ele ainda está presente para permitir que scripts existentes continuem a funcionar, mas você deve começar a utilizar o utilitário removemachine.
Você pode utilizar o comando de REST remove do ArcGIS Server no administrador de site do ArcGIS Server para remover uma máquina auxiliar de um armazenamento de dados do cache de mosaico ou relacional. Porém, se o site do GIS Server estiver indisponível, você não poderá entrar como administrador do site para fazer isto. Nestes casos, execute o utilitário removestandbymachine para remover uma máquina auxiliar do armazenamento de dados.
O utilitário removestandbymachine pode ser executado somente na máquina auxiliar de um armazenamento de dados para cache do mosaico e relacional.
Sintaxe
removestandbymachine <machine name> --store <relational|tileCache> [--prompt <yes | no>]
restoredatastore
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Se você perder o acesso aos dados utilizados por camadas de feição hospedadas do seu portal, camadas de cena hospedada ou dados arquivados em tempo real, utilize seus arquivos da cópia de segurança e o utilitário de comando restoredatastore para recuperar seu armazenamento de dados.
Se você não puder recuperar o armazenamento de dados, instale o ArcGIS Data Store em uma nova máquina, não configure o armazenamento de dados e restaure a cópia de segurança na nova máquina.
Se você utilizar um armazenamento de dados relacional e deseja rolar os dados da camada de feição hospedada de volta para um tempo específico no passado, restaure no topo do armazenamento de dados relacional existente. Note que você pode restaurar somente para um estado anterior no qual você tem arquivos da cópia de segurança disponíveis. Por exemplo, se você reter somente cópias de segurança por cinco dias, você poderá recuperar somente o armazenamento de dados para um ponto no tempo dentro destes cinco dias.
O utilitário restoredatastore pode ser executado na máquina primária do armazenamento de dados do cache de mosaico ou relacional. Ele pode ser executado em quaisquer máquinas do armazenamento de grandes dados de espaço-tempo.
Sintaxe
restoredatastore [options]
As opções suportadas são como seguem:
- [--store {relational|tileCache|spatiotemporal}]
- [--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}] Esta opção é suportada somente para armazenamentos de dados relacionais.
- [--source-loc <location of source backup files>]: Esse é o local dos arquivos da cópia de segurança que você deseja utilizar para restaurar o armazenamento de dados. Este será o caminho para um local de compartilhamento de arquivos ou, para armazenamentos de grandes dados de espaço-tempo e armazenamentos de dados relacionais, pode ser um nome de local da cópia de segurança ou um local da cópia de segurança do armazenamento do Amazon S3 ou Azure Blob.
- [--bound {true | false}]: A opção --bound é somente suportada para armazenamentos de dados do cache de mosaico e relacional.
- [--data-dir <new data store directory>]: Este é o diretório ArcGIS Data Store na máquina onde você está restaurando o banco de dados. Utilize somente o --data-dir se você estiver restaurando o armazenamento de dados para uma nova máquina. Ao restaurar para uma nova máquina, você também deve especificar a opção --source-loc .
- [--server-url <ArcGIS Server URL registered with data store>]: Se você especificar --bound true para manter o armazenamento de dados registrado com o mesmo site do GIS Server que foi registrado quando você criou a cópia de segurança, especifique a URL deste site do GIS Server. Se você especificar --bound true e tiver movido seus serviços para um novo site do GIS Server , utilize a opção --server-url para especificar a URL de novo site do GIS Server . Note que se você especificar uma URL do novo site e não moveu os serviços para este novo servidor, os dados no armazenamento de dados não estarão acessíveis.
- [--server-admin <user name of ArcGIS Server admin>]: Esta opção é exigida se você especificar --bound true ou não especificar a opção --bound . Forneça o nome de usuário do administrador no ArcGIS Server .
- [--server-password <password of ArcGIS Server admin>]: Esta opção é exigida se você especificar --bound true ou não especificar a opção --bound . Forneça a senha de administrador do ArcGIS Server.
- [--loaddata {true | false}]: Suportado somente com armazenamentos de grandes dados de espaço-tempo. Configure esta opção para false quando você precisar de restauração do armazenamento de dados spatiotemporal big para um novo conjunto de máquinas, mas os dados não couberem na primeira máquina. Isto permite restaurar o esquema do armazenamento de dados, adicionar mais máquinas ao armazenamento de grandes dados de espaço-tempo para acomodar todos os dados e, em seguida, executar o utilitário restoredatastore novamente com --loaddata configurada para true para restaurar os dados. Por padrão, esta opção é configurada para true.
- [--prompt {yes | no}]
Ao restaurar após ter encerrado com erro ou movido o armazenamento de dados relacional, especifique --target most-recent. Se restaurar um armazenamento de dados relacional para um ponto no tempo, especifique a data e hora (em UTC) na qual você deseja restaurar o armazenamento de dados. Se você tiver um arquivo da cópia de segurança específico que você deseja restaurar, especifique o nome do arquivo da cópia de segurança. Se você não especificar um destino, a cópia de segurança mais recente é restaurada.
Por padrão, o armazenamento de dados restaurado é associado (limitado) com seu site do GIS Server. Somente especifique --bound false se você desejar a restauração do armazenamento de dados sem manter a associação com o site do GIS Server do armazenamento de dados. Você fará isto somente como último recurso se o site do GIS Server anterior foi perdido e impossível de recuperar; você poderá restaurar o armazenamento de dados desconectado, e configurá-lo com um novo site do GIS Server federado. Porém, as camadas que utilizaram os dados no armazenamento de dados não existem mais. Você terá que conectar ao banco de dados do armazenamento de dados para extrair os dados para outro formato, e republicá-los no portal.
Exemplos
Neste exemplo, a cópia de segurança mais recente é do local da cópia de segurança do armazenamento de dados relacional padrão e será restaurada no armazenamento de dados existente. Já que o tipo de armazenamento padrão é relacional, e ele permanece limitado por padrão no site do GIS Server com o qual foi registrado, você não tem que especificar --store relational ou --bound true. No entanto, você precisa especificar a URL do GIS Server e credenciais do administrador.
./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
Neste exemplo, um armazenamento de dados relacional que tem a recuperação de ponto no tempo habilitada é restaurado a partir do local da cópia de segurança do armazenamento de dados relacional padrão para o estado que estava às 2:30 p.m. (UTC) em 17 de Julho 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
Neste exemplo, o armazenamento de dados relacional é restaurado para uma nova máquina utilizando um arquivo da cópia de segurança denominado movedatastore. Ao restaurar para uma nova máquina, você deve especificar o local do arquivo da cópia de segurança e o local do novo diretório de dados do ArcGIS Data Store . Já que os serviços da feição hospedados ainda estão em execução no mesmo site do GIS Server com o qual o armazenamento de dados relacional está registrado, --bound true não é exigido, mas a URL do GIS Server e as credenciais do administrador são exigidas.
./restoredatastore.sh --target movedatastore --source-loc /net/buserver/data/backups/relational --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
No seguinte exemplo, o armazenamento de dados do cache de mosaico é restaurado para uma nova máquina. Ao restaurar para uma nova máquina, você deve especificar o local do arquivo da cópia de segurança e o local do novo diretório de dados do ArcGIS Data Store . Já que os serviços da cena ainda estão em execução no mesmo site do GIS Server com o qual o armazenamento de dados do cache de mosaico está registrado, --bound true não é exigido, mas a URL do GIS Server e as credenciais do administrador são exigidas.
./restoredatastore.sh --source-loc /net/buserver/scenedata/backups/tilecache --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
No seguinte exemplo, um arquivo da cópia de segurança do armazenamento de grandes dados de espaço-tempo (bds1) é restaurado de uma localização da cópia de segurança denominada (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 um armazenamento de dados para etapas e um exemplo de restauração de um armazenamento de grandes dados de espaço-tempo após falha de hardware.
revokeconnection
Utilizado com armazenamentos de dados relacionais.
Se você utilizou o utilitário allowconnection para permitir temporariamente a outro cliente conectar-se diretamente ao armazenamento de dados relacional, você poderá revogar o recurso de conexão executando o utilitário revokeconnection.
O utilitário revokeconnection pode ser executado somente na máquina primária do armazenamento de dados relacional.
Sintaxe
revokeconnection <host name> <user name> [<database>]
Exemplo
Neste exemplo, o banco de dados do armazenamento de dados não aceitará mais conexões da máquina workcom ao entrar como o usuário hqo.n_1E7.
./revokeconnection.sh workcom bn0_3Wa.m hqo.n_1E7
unregisterdatastore
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Você pode utilizar o utilitário de comando unregisterdatastore para fazer o seguinte:
- Cancelar o registro da máquina primária do armazenamento de dados para cache do mosaico ou relacional do seu site do GIS Server. Faça isto somente se você tiver excluído as camadas de cena, mosaico e feição hospedadas que utilizam os dados no armazenamento de dados. Se você não fizer isto, você terá camadas inúteis no seu portal e serviços inúteis executando no seu servidor de hospedagem.
Note que se você tiver uma máquina auxiliar, você deverá primeiro removê-la do armazenamento de dados antes de poder cancelar o registro na máquina primária.
- Cancele o registro do armazenamento de grades dados de espaço-tempo de única máquina.
Você poderá cancelar o registro de um armazenamento de dados do seu site do GIS Server se você decidir que não deseja mais utilizar o armazenamento de dados ou os serviços que dependem dele. Ao cancelar o registro de uma máquina do armazenamento de dados, o site do GIS Server poderá não mais conectar esta máquina, e todos os serviços que continham dados do armazenamento de dados com registro cancelado não funcionarão mais. Este comando não exclui os dados, porém; se você decidir que ainda precisa do armazenamento de dados, você poderá utilizar o utilitário registerdatastore ou configuredatastore para adicioná-los de volta.
O utilitário unregisterdatastore pode ser executado somente na máquina primária do armazenamento de dados do cache de mosaico ou relacional após você ter executado removemachine para remover a máquina auxiliar. O utilitário unregisterdatastore pode ser executado somente no armazenamento de grandes dados de espaço-tempo uma vez que deixou uma máquina, após você ter executado removemachine para remover todas as outras máquinas no armazenamento de grandes dados de espaço-tempo.
Sintaxe
unregisterdatastore --stores <relational|tileCache|spatiotemporal> [--prompt {yes | no}]
Se você tiver mais de um tipo de armazenamento de dados instalado na mesma máquina e deseja cancelar o registro de mais de um por vez, especifique cada tipo de armazenamento de dados separado por uma vírgula (sem espaço). Por exemplo, para cancelar o registro de um armazenamento de dados do cache de mosaico e relacional, digite --stores relational,tileCache.
Exemplo
Aqui, o utilitário unregisterdatastore é executado para cancelar o registro dos armazenamentos de dados do cache de mosaico e relacional de site do GIS Server. Uma janela é retornada, que é o comportamento padrão. Para suprimir a janela, 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
Utilizado com armazenamentos de dados relacionais.
O ArcGIS Data Store retém arquivos da cópia de segurança do armazenamento de dados relacional durante sete dias, por padrão. Você pode alterar com que frequência os arquivos da cópia de segurança são limpos do diretório da cópia de segurança executando o utilitário updatebackupretaindays.
O utilitário updatebackupretaindays pode ser executado somente na máquina primária do armazenamento de dados relacional.
Sintaxe
updatebackupretaindays <number of days>
Exemplo
No seguinte exemplo, o tempo de retenção do arquivo da cópia de segurança está alterado para 10 dias:
./updatebackupretaindays.sh 10
updatebackupschedule
Utilizado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
Por padrão, o ArcGIS Data Store cria uma cópia de segurança completa do armazenamento de dados relacional a cada quatro dias. Você pode alterar com que frequência uma cópia de segurança completa é criada executando o utilitário updatebackupschedule.
Não há nenhuma cópia de segurança automática padrão para armazenamentos de grandes dados de espaço-tempo ou cache de mosaico. Para configurar um horário da cópia de segurança automática para um armazenamento de grandes dados de espaço-tempo, você deve primeiro configurar um local da cópia de segurança válido.
Especifique uma hora inicial utilizando anotação do relógio de 24 horas, por exemplo, 00:00:00 para meia-noite e 13:00:00 para 1 p.m Utilize a opção de frequência para especificar o número de dias entre cópias de segurança. Para desabilitar as cópias de segurança automáticas, configure a frequência para 0. Se você desabilitar as cópias de segurança automáticas, certifique-se de executar o utilitário backupdatastore para criar cópias de segurança manualmente.
Você pode executar o utilitário updatebackupschedule na máquina primária do armazenamento de dados do cache de mosaico ou relacional. A ferramenta pode ser executada em qualquer máquina do armazenamento de grandes dados de espaço-tempo.
Sintaxe
updatebackupschedule [--store relational|tileCache|spatiotemporal] [--starttime <local server time>] --frequency <number of days>
Se você não especificar um novo tempo inicial, a configuração de tempo inicial existente não será alterada. Se você não especificar um tipo de armazenamento de dados, o armazenamento de dados relacional será assumido.
Exemplo
Neste exemplo, cópias de segurança completas de um armazenamento de dados relacional acontecerão às 11:00 p.m (tempo do servidor local) a cada 10 dias:
./updatebackupschedule.sh --starttime 23:00:00 --frequency 10
Neste exemplo, um horário da cópia de segurança está configurado para um armazenamento de dados do cache de mosaico. Após a cópia de segurança inicial de todos os bancos de dados do armazenamento de dados do cache de mosaico, o ArcGIS Data Store copia os bancos de dados do armazenamento de dados recentemente criados para o local especificado com configurebackuplocation a cada 14 dias.
./updatebackupschedule.sh --store tileCache --frequency 14
updatelicense
Utilizado com armazenamentos de dados relacionais.
Se a sua licença do ArcGIS Server expirar, você deverá atualizar a licença no site do ArcGIS Server. As informações de licença também são mantidas no armazenamento de dados relacional do ArcGIS Data Store; então, após atualizar a licença de site do ArcGIS Server com a qual o armazenamento de dados está configurado, você deverá atualizar a licença na armazenamento de dados. Para fazer isto, execute o utilitário updatelicense da máquina onde seu principal ArcGIS Data Store está instalado. Se você tiver um ArcGIS Data Store auxiliar, a licença atualizada será replicada para ele.
Sintaxe
updatelicense
Exemplo
Após atualizar a licença do ArcGIS Server, execute o utilitário updatelicense para mover a nova licença do armazenamento de dados.
./updatelicense.sh
updatesslcertificate
Utilizado com todos os tipos de armazenamento de dados.
Você pode substituir o certificado auto-assinado utilizado para autenticar a comunicação entre o servidor de hospedagem e o armazenamento de dados, e entre as máquinas do armazenamento de dados com um certificado verificado e assinado por uma autoridade certificadora (CA) ou certificado de domínio.
Sintaxe
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
Exemplo
Após receber um arquivo de certificado assinado pela CA, execute updatesslcertificate para substituir o certificado auto-assinado do ArcGIS Data Store .
./updatesslcertificate.sh /usr/files/mysignedcert.pfx ps4mycert dsmachinename