Os utilitários instalados com ArcGIS Data Store, fornecem as ferramentas de administrador do armazenamento de dados para gerenciar armazenamentos de dados. Esta página descreve os utilitários e fornece sintaxe e exemplos para cada um.
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.
Digite o nome do utilitário seguido por --help para obter assistência de sintaxe.
allowconnection
Este utilitário é usado com armazenamentos de dados relacionais.
Por razões de segurança, todas as conexões para o armazenamento de dados são realizdas 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 allowconnection.
Você pode executar o utilitário allowconnection apenas na máquina primária do armazenamento de dados relacionais.
Sintaxe
allowconnection <host name> <username> [<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
Este utilitário é usado com todos os tipos de armazenamento de dados.
Use este utilitário para criar uma cópia de segurança completa de um armazenamento de dados entre horários de cópia de segurança planejadas. Por exemplo, crie uma cópia de segurança de cada armazenamento de dados antes de atualizar ArcGIS Data Store ou antes de fazer um grande número de alterações em um armazenamento de dados.
O utilitário backupdatastore pode ser executado somente para um tipo de armazenamento de dados por vez.
A tabela a seguir indica onde executar o utilitário backupdatastore e o que o utilitário faz para cada tipo de armazenamento de dados:
| Tipo de armazenamento de dados | Máquina | Comportamento |
|---|---|---|
Armazenamento de dados relacional | Execute o utilitário backupdatastore na máquina de armazenamento de dados relacional primária. | O utilitário backupdatastore sempre cria uma cópia de segurança completa do armazenamento de dados relacional. |
Armazenamento de dados de cache de mosaico | O utilitário backupdatastore pode ser executado em qualquer máquina no armazenamento de dados do cache de mosaico. | A primeira vez que você executar o utilitário backupdatastore para um armazenamento de dados do cache de mosaico, apos definir um local da cópia de segurança, cópias auxiliares serão criadas de todos os bancos de dados do armazenamento de dados do cache de mosaico existentes. 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. |
Armazenamento de grandes dados de espaço-tempo | O utilitário backupdatastore pode ser executado em qualquer máquina do agrupamento. | A primeira vez que você executa o utilitário backupdatastore para um armazenamento de grandes dados de espaço-tempo, após definir um local da cópia de segurança, uma cópia de segurança completa é criada. O uso subsequente do utilitário backupdatastore cria um arquivo de cópia de segurança contendo apenas as alterações desde a cópia de segurança completa inicial. |
Armazenamento de objeto | O utilitário backupdatastore pode ser executado em qualquer máquina do agrupamento. | O utilitário backupdatastore sempre cria uma cópia de segurança completa do armazenamento de objetos para dados de serviço de vídeo. Os caches de consulta da camada de feição não estão incluídos no arquivo de cópia de segurança. |
Armazamento de gráfico | O utilitário backupdatastore pode ser executado em qualquer máquina no armazenamento de gráficos. | O utilitário backupdatastore sempre cria uma cópia de segurança completa do armazenamento de gráficos. |
Antes de executar o utilitário backupdatastore, certifique-se de que o local de cópia de segurança do armazenamento de dados seja grande o suficiente para acomodar cópias de segurança. Para alterar os locais da cópia de segurança do armazenamento de dados, utilize o utilitário configurebackuplocation.
Para obter mais informações sobre cópias de segurança do ArcGIS Data Store, consulte Gerenciar cópias de segurança do ArcGIS Data Store .
Sintaxe
backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <backup_arguments>] [--prompt {yes | no}]
Você deve fornecer um nome para o arquivo de cópia de segurança.
Se você não especificar a opção --store, o valor relational é assumido.
Se você não especificar a opção --location, os arquivos de cópia de segurança são gravados no local de cópia de segurança padrão do armazenamento de dados.
Para especificar um dos outros locais de cópia de segurança registrados, use a opção --location. Você pode fornecer o nome da cópia de segurança ou o tipo e local da cópia de segurança. Quando você usa os argumentos type= e location=, separe-os por ponto e vírgula (;).
Os argumentos suportados para a opção --location são os seguintes:
| Argumento | Descrição |
|---|---|
name= | Você pode usar o nome do local de cópia de segurança para indicar o local de cópia de segurança registrado. Se você especificar um nome, não precisará usar os argumentos type= e location=. |
type= | Se você não especificar um nome de local de cópia de segurança, deverá especificar o tipo de local de cópia de segurança e o local físico. Os valores de tipo e suas descrições são os seguintes:
|
location= | Use o argumento location= para indicar o local físico do local de cópia de segurança registrado. Este argumento deve ser usado com o argumento type=. 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 do Azure Blob, forneça o nome do contêiner. |
Exemplos
Neste exemplo, o utilitário backupdatastore cria um arquivo de cópia de segurança completo denominado project1bu no local de cópia de segurança padrão do armazenamento de dados relacional. Ao incluir --prompt no, o utilitário não solicita uma resposta de confirmação.
./backupdatastore.sh project1bu --prompt no
Neste exemplo, um arquivo da cópia de segurança nomeado localbu5 é criado para o armazenamento de grandes dados de espaço-tempo em um local de compartilhamento do arquivo, que você nomeou gadbu quando você configurou o local da cópia de segurança.
./backupdatastore.sh localbu5 --store spatiotemporal --location 'name=gadbu' You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
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
changedatastoremode
Este utilitário é usado com armazenamentos de grandes dados de espaço-tempo e relacional.
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, é possível 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.
Você deve executar o utilitário changedatastoremode na máquina primária do armazenamento de dados relacional, não na máquina auxiliar.
Quando o armazenamento de grandes dados de espaço-tempo fica quase sem espaço em disco, o ArcGIS Data Store coloca-o no modo de somente leitura para evitar corrupção de dados. Você pode utilizar o utilitário changedatastoremode para retornar um armazenamento de grandes dados de espaço-tempo ao modo de leitura-gravação após adicionar espaço em disco suficiente a máquinas do armazenamento de grandes dados de espaço-tempo.
Anotação:
Se ArcGIS Data Store coloca o armazenamento de dados no modo somente leitura devido ao espaço insuficiente em disco, as cópias de segurança automáticas também são desativadas para evitar encher ainda mais o disco. Portanto, você deve redefinir seu agendamento de cópia de segurança automático usando o utilitário updatebackupschedule depois de colocar o armazenamento de dados novamente no modo de leitura e gravação.
Sintaxe
changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}
Exemplos
Neste exemplo, o armazenamento de dados relacional é colocado em modo somente leitura, o que significa que os clientes não podem realizar atividades como publicar camadas de feição hospedadas para ArcGIS Enterprise ou editar dados através de uma camada de feição hospedada. A opção --prompt é fornecida para suprimir o prompt de confirmação.
./changedatastoremode.sh readonly --store relational --prompt no
Para colocar um armazenamento de grandes dados espaço-temporal no modo de leitura/gravação após adicionar espaço em disco às máquinas, especifique a opção readwrite e especifique spatiotemporal com a opção --store mostrada no exemplo a seguir:
./changedatastoremode.sh readwrite --prompt no --store spatiotemporal
changedbproperties
Este utilitário é usado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O utilitário changebproperties permite alterar várias propriedades dependendo do tipo de armazenamento de dados no qual você o executa.
Sintaxe
changedbproperties --store {relational | tileCache | spatiotemporal} [configuration options]
Você deve fornecer a opção --store e pelo menos uma opção de configuração. A seguir estão as opções de configuração suportadas, suas descrições e o tipo de armazenamento de dados com o qual cada opção pode ser usada:
| Opções de configuração | Descrição | Tipo de armazenamento de dados compatível |
|---|---|---|
--disk-threshold-readonly | Esta opção controla quando um armazenamento de dados relacional será colocado no modo somente leitura para evitar perda de dados devido a espaço em disco insuficiente. Especifique tamanhos em MB. O valor do espaço em disco padrão é 1024 MB. | Apenas armazenamento de dados relacional |
--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. Use a propriedade --max-connections para alterar o número de conexões permitidas. Leve em consideração que os processos internos ArcGIS Data Store podem levar até cinco conexões. Considere também quantas conexões simultâneas a máquina ArcGIS Data Store pode aceitar e continuar funcionando bem. 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 inferior a 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. | Apenas armazenamento de dados relacional |
--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. Os possíveis argumentos para esta opção são enable ou disable. | Apenas armazenamento de dados relacional A configuração padrão é --pitr disable. Anotação:Você deve definir a opção --pitr para enable se você usar o utilitário webgisdr—que está instalado com Portal for ArcGIS—para criar cópias de segurança incrementais de sua implantação ArcGIS Enterprise. |
--enablessl | Esta opção controla o uso do protocolo Transport Layer Security (TLS) ao preencher o armazenamento de dados do cache de mosaico e para comunicação entre o armazenamento de dados relacional e o servidor de hospedagem. Os argumentos suportados para o parâmetro --enablessl são os seguintes:
| Armazenamentos de dados de cache relacional e de mosaico |
--heap-size | Utilize este parâmetro para alterar a quantidade de memória acumulada (em MB) utilizada pelo armazenamento de dados spatiotemporal big. Por padrão, esse tipo de armazenamento de dados usará metade da RAM na máquina (até 70% da RAM livre) quando for iniciado. Você pode alterar o tamanho do heap para um valor entre 512 MB e 32.000 MB, mas certifique-se de que o valor especificado não exceda a quantidade de RAM disponível na máquina. | armazenamento de grandes dados de espaço-tempo |
--rebalance | Por padrão, esta opção está definida como true, o que significa que o armazenamento de grandes dados espaço-temporal distribui dados para outras máquinas se alguma máquina estiver indisponível. Se precisar realizar manutenção em uma máquina de armazenamento de grandes dados espaço-temporal, como atualizá-la, você poderá desligar temporariamente o rebalanceamento especificando --rebalance false. A opção de rebalanceamento ficará suspensa pelo número de minutos definido no parâmetro --max-rebalance-off. | armazenamento de grandes dados de espaço-tempo |
--max-rebalance-off | Esta opção é utilizada em combinação com a opção --rebalance de indicar por quanto tempo o rebalanceamento permanecerá suspenso. 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. | armazenamento de grandes dados de espaço-tempo |
--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, especifique --prompt no; caso contrário, o script não continuará até que você responda ao prompt. | armazenamentos de grandes dados relacionais, de cache de mosaico e de espaço-tempo |
Exemplos
As seções a seguir incluem exemplos de uso das opções disponíveis com o utilitário changebproperties.
Alterar o limite somente leitura para o armazenamento de dados relacional
Por padrão, o armazenamento de dados relacional é colocado no modo somente leitura quando o espaço livre em disco cai para 1.024 MB. No exemplo a seguir, há outros aplicativos gravando na máquina, portanto, o administrador configura o armazenamento de dados relacional para ser colocado em modo somente leitura mais cedo: quando o espaço livre em disco na máquina cair para 4.000 MB:
./changedbproperties.sh --store relational --disk-threshold-readonly 4000
You are changing the following database properties:
...disk space threshold to change relational data store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesAltere o número de conexões permitidas ao armazenamento de dados relacional
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)?YesHabilite a recuperação pontual para o armazenamento de dados relacional
Por padrão, a recuperação pontual está desabilitada. Neste exemplo, a recuperação pontual está habilitada para o armazenamento de dados relacional:
./changedbproperties.sh --store relational --pitr enable
You are changing the following database properties:
...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesDesabilitar SSL
Por padrão, o armazenamento de dados relacional se comunica com o servidor de hospedagem por HTTPS. Neste exemplo, o parâmetro --enablessl é usado para configurar o armazenamento de dados relacional para se comunicar com o servidor de hospedagem por HTTP.
./changedbproperties.sh --store relational --enablessl false
You are changing the following database properties:
...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesAltere o tamanho do heap para o armazenamento de grandes dados espaço-temporal
Por padrão, o armazenamento de grandes dados espaço-temporal usa metade da RAM na máquina (e 70% da RAM livre) quando é iniciado.
Aviso:
Diminuir o tamanho do heap pode impedir que o armazenamento de dados seja iniciado. Se você aumentar o tamanho do heap, não especifique um número que exceda a quantidade de RAM disponível na máquina.
Neste exemplo, o tamanho do heap é definido como 1.600 MB.
./changedbproperties.sh --store spatiotemporal --heap-size 1600
You are changing the following database properties:
...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesPausar o rebalanceamento para o armazenamento de grandes dados espaço-temporal
Neste exemplo, o administrador precisa executar um breve procedimento de manutenção em uma máquina em um armazenamento de grandes dados espaço-temporal e não deseja que o armazenamento de dados seja reequilibrado. Para fazer isso, as opções --rebalance e --max-rebalance-off são usadas para suspender o rebalanceamento por 30 minutos. Após 30 minutos, o armazenamento de grandes dados espaço-temporal mudará automaticamente rebalance para verdadeiro.
Como isso deve acontecer periodicamente, o administrador mantém a instrução a seguir em um script e define a opção de prompt como não.
./changedbproperties.sh --store spatiotemporal --rebalance false --prompt no
./changedbproperties.sh --store spatiotemporal --max-rebalance-off 30 --prompt no
changeloglocation
Este utilitário é usado com todos os tipos de armazenamento de dados.
O local padrão do arquivo de log de erros para ArcGIS Data Store é <ArcGIS Data Store directory>\arcgisdatastore\logs. Para usar um diretório de arquivos diferente, execute o utilitário changeloglocation e especifique o novo caminho do diretório.
A ArcGIS Data Store conta deve ter privilégios de gravação no diretório especificado.
Sintaxe
changeloglocation <directory path>
Exemplo
Neste exemplo, arquivos de log serão criados no diretório local, ../datastorefiles/logs.
./changeloglocation.sh '../datastorefiles/logs'
changenosqldslocation
Este utilitário é usado 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, deverá conceder permissões de leitura e gravação no diretório para a ArcGIS Data Store conta.
Sintaxe
changenosqldslocation <path> [--prompt {yes | no}]
Exemplo
Neste exemplo, os bancos de dados que armazenam caches da camada de cena serão criados em um diretório compartilhado denominado dstorecache na máquina server2.
./changenosqldslocation.sh /net/server2/dstorecache --prompt no
changepassword
Este utilitário é usado 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 de armazenamento de dados relacionais e execute changepassword para redefini-las.
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 deve ser executado na máquina de armazenamento de dados relacional primária. Para identificar qual é a máquina principal, execute o utilitário describedatastore.
Sintaxe
changepassword <username> <new password> [--prompt {yes | 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
Se você precisar de script para alterar a senha, inclua uma bandeira para suprimir o lembrete de confirmação, como no seguinte exemplo:
./changepassword.sh gwi_n2Te0 Phfl4mp --prompt no
changestaginglocation
Este utilitário é usado com armazenamento de dados relacional, armazenamento de dados de cache de mosaico e armazenamento gráfico.
Quando você restaura seu armazenamento de dados relacional ou de cache do mosaico, o ArcGIS Data Store extrai os arquivos da cópia de segurança compactados no local de execução. Isto significa que você deve ter um local de teste que possa acomodar estes dados descompactados. Por padrão, esse local está no diretório de dados ArcGIS Data Store. Se houver muitos dados no armazenamento de dados do cache de mosaico ou relacional, configure um local de preparação separado e especifique-o para recuperação.
Da mesma forma, se você definir um contêiner S3 ou um contêiner de armazenamento Blob Azure para armazenamento de dados relacionais, armazenamento de dados de cache de mosaico ou arquivos de cópia de segurança de armazenamento gráfico, o local de preparo é usado para empacotar os arquivos de cópia de segurança antes de copiá-los para o local de armazenamento em nuvem.
Sintaxe
changestaginglocation <directory path>
Exemplo
Neste exemplo, o local de execução designado é /net/sanmarcos/rbustage.
./changestaginglocation.sh /net/sanmarcos/rbustage
configurebackuplocation
Este utilitário é usado com todos os tipos de armazenamento de dados.
O utilitário configurebackuplocation permite a você especificar o local onde o ArcGIS Data Store grava arquivos da cópia de segurança em ambas as cópias de segurança agendadas e cópias de segurança criadas com o utilitário backupdatastore. O utilitário configurebackuplocation também permite alterar propriedades de um local da cópia de segurança e remover um local da cópia de segurança.
Os armazenamentos de dados relacionais são criados com um local da cópia de segurança local padrão. Para evitar perda de dados, configure um local da cópia de segurança padrão registrando um compartilhamento de arquivo remoto utilizando a opção change.
Os armazenamentos de dados do cache de mosaico criados no modo primário-auxiliar têm um local da cópia de segurança padrão; os armazenamentos de dados do cache do mosaico criados no modo de agrupamento não. Nos dois casos, utilize o utilitário configurebackuplocation com a opção register para especificar um local de rede compartilhado, um contêiner do Amazon Simple Storage Service (S3) ou um contêiner de armazenamento do Microsoft Azure Blob para armazenar com segurança as cópias do armazenamento de dados do cache de mosaico. Você não pode utilizar uma unidade local para arquivos da cópia de segurança do cache de mosaico se o armazenamento de dados estiver em execução no modo de agrupamento.
Armazenamentos de grandes dados espaço-temporais, armazenamentos de gráficos e armazenamentos de objetos não são criados com um local da cópia de segurança padrão. Antes que possa iniciar a criação das cópias de segurança, você deve executar o utilitário configurebackuplocation com a opção register para especificar um local de compartilhamento de arquivo, um contêiner do Amazon Simple Storage Service (S3) ou um contêiner de armazenamento do Microsoft Azure Blob para estas cópias de segurança.
Anotação:
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.
Você pode registrar um segundo local da cópia de segurança para armazenar as cópias de segurança criadas utilizando o utilitário backupdatastore. Você pode utilizar um diretório de arquivo compartilhado, um contêiner S3 ou um contêiner de armazenamento do Azure Blob para locais da cópia de segurança secundários.
Para obter mais informações sobre cópias de segurança do ArcGIS Data Store, consulte Gerenciar cópias de segurança do ArcGIS Data Store .
Sintaxe
configurebackuplocation --store {relational | tileCache | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]
Opções exigidas
Você deve fornecer as opções a seguir ao executar o utilitário configurebackuplocation:
- --store {relational | tileCache | spatiotemporal | graph | object}
Especifique o tipo de ArcGIS Data Store para o qual você está configurando ou consultando locais de cópia de segurança. O valor padrão é relational.
- --operation {change | register | unregister | list | setdefault}
A opção --operation especifica a ação que o utilitário configurebackuplocaton executará. O valor padrão é change.
A seguir está uma explicação de cada argumento que você pode usar com a opção --operation:
| Opção | Descrição |
|---|---|
change | Use este argumento para alterar qualquer um dos seguintes:
|
register | Use este argumento para registrar um local de cópia de segurança. Quando você usa o argumento register, você deve fornecer a opção --location . O primeiro local da cópia de segurança definido para um armazenamento de grandes dados de espaço-tempo, armazenamento de gráfico ou armazenamento de dados do cache de mosaico em execução no modo de agrupamento é configurado como o local da cópia de segurança padrão. Ao registrar outro local da cópia de segurança para um armazenamento de dados de cache de mosaico (modo principal-auxiliar ou agrupamento), armazenamento de grandes dados espaço-temporal ou armazenamento de gráfico, um local de cópia de segurança secundário é registrado. Para o armazenamento de dados relacional, o argumento register sempre registra um local de cópia de segurança secundário. O local da cópia de segurança secundário pode ser usado para armazenar cópias de segurança manuais geradas com o utilitário backupdatastore. |
unregister | Utilize este argumento para remover um local de cópia de segurança secundário de um armazenamento de dados. Se apenas um local de cópia de segurança for registrado, o argumento unregister removerá completamente o local de cópia de segurança para um cache de mosaico ou armazenamento de grandes dados espaço-temporal ou um armazenamento gráfico. |
list | Lista todos os locais de cópia de segurança registrados para o armazenamento de dados especificado com a opção --store. A lista indica o local de cópia de segurança físico, o nome do local de cópia de segurança e qual está registrado como local de cópia de segurança padrão. |
setdefault | Se você configurou vários locais de cópia de segurança para um armazenamento de gráfico, armazenamento de dados de cache de mosaico ou armazenamento de grandes dados espaço-temporal, use o argumento setdefault para designar um dos locais de cópia de segurança como local 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 um local da cópia de segurança. |
A opção de localização
A opção --location é necessária nos seguintes cenários:
- Especifique o local de armazenamento de cópia de segurança ao registrar um local de cópia de segurança ou alterar o local de cópia de segurança padrão para o armazenamento de dados relacional.
- Para alterar o nome de um local de cópia de segurança existente, forneça o argumento name e o novo valor do nome.
Você pode usar a opção --location ao definir um local de cópia de segurança padrão ou remover um local de cópia de segurança, ou pode usar o nome do cópia de segurança.
Para armazenamentos de dados de cache de mosaico ou armazenamentos de grandes dados espaço-temporais, ou para registrar um local de cópia de segurança secundário para um armazenamento de dados relacional, especifique os argumentos a seguir com a opção --location separados por ponto e vírgula (;) e coloque toda a sequência de argumentos entre aspas duplas ("):
--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]".
Uma explicação de cada um dos argumentos suportados pela opção --location é fornecida abaixo:
| Argumento | Descrição |
|---|---|
type= | Este argumento é exigido. Defina que tipo de local usar para cópias de segurança. Especifique fs para armazenar cópias de segurança em um compartilhamento de arquivos. Para armazenamentos de dados relacionais, o local de cópia de segurança padrão deve ser um compartilhamento de arquivos. Especifique s3 para armazenar cópias de segurança em um contêiner Amazon S3. Especifique azure para armazenar cópias de segurança em um contêiner de armazenamento do Blob Azure. |
location= | Este argumento é exigido. Para compartilhamentos de arquivo, especifique o caminho do arquivo. Para contêiners Amazon S3, especifique o nome e o caminho do contêiner. Para contêiners de armazenamento de blobs, especifique o nome do contêiner e o caminho para o contêiner. |
name= | Você pode atribuir um nome ao local das cópia de segurança. Por exemplo, se o local da cópia de segurança for um caminho de arquivo, como \\sharedserver_sharedfolders_datastorebackups, você pode designar um nome para este local, como dsbackupsfolder. Quando você executa o utilitário backupdatastore, listbackups, ou restoredatastore, forneça esse nome em vez do caminho do local. Se você não fornecer um nome ao configurar o local da cópia de segurança do armazenamento de dados, o ArcGIS Data Store atribuirá um nome padrão. |
username= | Este argumento é necessário se você definir o argumento type= como azure ou s3. Para contêiners do S3 , forneça o ID da chave de acesso para sua conta do Amazon Web Services (AWS) . Para contêiners de armazenamento do Azure Blob, forneça o nome da conta de armazenamento do Microsoft Azure que pode acessar o contêiner de armazenamento Blob. |
password= | Este argumento é necessário se você definir o argumento type= como azure ou s3. Para contêiners S3 , forneça a chave secreta para sua conta do 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 . |
endpointsuffix= | Se você definir o argumento type= como azure, você pode usar o argumento endpointsuffix para indicar onde o contêiner de armazenamento Blob Azure está localizado. Por padrão, o endpointsuffix é assumido para ser core.windows.net. Se o seu contêiner estiver no ambiente de nuvem Goverrno do Microsoft Azure , defina endpointsuffix=core.usgovcloudapi.net. Se o seu contêiner estiver em uma nuvem privada, defina endpointsuffix ao sufixo do parâmetro da sua nuvem privada Azure. |
region= | Este argumento é necessário quando você define o argumento type= como s3. Você deve fornecer o código da região. Por exemplo, defina a região como ap-southeast-2 se o contêiner for implantado na região Ásia-Pacífico (Sydney). Consulte a documentação de AWS para códigos de região. |
Opções adicionais
As opções adicionais que você pode fornecer com o utilitário configurebackuplocation são as seguintes:
| Opção | Descrição |
|---|---|
--force | 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. Os valores válidos são true ou false. 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 | Os valores válidos são yes ou no. Quando você executa este utilitário, você é solicitado para confirmar a ação que você especificou. Se você automatizar o uso deste utilitário, defina a opção --prompt como no; caso contrário, o script não continuará até que você responda ao prompt. |
Exemplos
As seções a seguir fornecem exemplos de alteração, configuração ou listagem de locais de cópia de segurança para armazenamentos de dados.
Alterar o local de cópia de segurança padrão para o armazenamento de dados relacional
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 "type=fs;location=/net/myshare/fsdata_bu" You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
Adicionar um local de cópia de segurança para o armazenamento de dados relacional
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
Definir um local de cópia de segurança para um armazenamento de gráficos
Neste exemplo, um local de cópia de segurança em um compartilhamento de rede é registrado para um armazenamento de gráfico. Um nome, fshare, é atribuído à localização da cópia de segurança.
./configurebackuplocation.sh --operation register --store graph --location "type=fs;location=/net/sharedmachine/g_bu;name=fshare" --prompt no
Adicione locais de cópia de segurança e defina um local padrão
Neste exemplo, um segundo local de cópia de segurança é especificado para o armazenamento de grandes dados espaço-temporal. O local de cópia de segurança adicional está no armazenamento Azure.
./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no
Neste exemplo, um segundo local de cópia de segurança na região Europa (Espanha) em AWS é especificado para o mesmo armazenamento de grandes dados espaço-temporal. Um nome, awsloc, é atribuído à localização da cópia de segurança.
./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no
Neste exemplo, o contêiner S3 é definido como o local de cópia de segurança padrão para o armazenamento de grandes dados espaço-temporal usando o nome do local de cópia de segurança (awsloc).
./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no
Obter uma lista de todos os locais de cópia de segurança para um armazenamento de dados
Neste exemplo, todos os locais da cópia de segurança para o armazenamento de grandes dados de espaço-tempo são listadas.
./configurebackuplocation.sh --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
Este utilitário é usado com todos os tipos de armazenamento de dados.
Depois de instalar ArcGIS Data Store, você pode executar o utilitário configuradoatastore em vez de executar o assistente de configuração do Data Store para criar um armazenamento de dados e registrá-lo em um site GIS Server. Você pode criar os seguintes tipos de armazenamentos de dados utilizando este utilitário:
- Armazenamento de dados relacional
- Armazenamento de dados de cache de mosaico
- Armazenamento de grandes dados de espaço-tempo
- Armazamento de gráfico
- Armazenamento de objeto
Os usos adicionais do utilitário configuradoatastore são os seguintes:
- Atualize um armazenamento de dados depois de atualizar o software ArcGIS Data Store em todas as máquinas no armazenamento de dados.
- Designe o papel de uma máquina em um armazenamento de grandes dados espaço-temporal.
Sintaxe
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | graph | object}] [--mode {singleInstance | primaryStandby | cluster}] [--roles {coord | data}]
| Opção | Descrição |
|---|---|
<ArcGIS Server admin URL> | Este é o site do GIS Server que é utilizado ou será utilizado como servidor de hospedagem do ArcGIS Enterprise. A URL de admin do ArcGIS Server está no formato https://gisserver.domain.com:6443. Anotação:Mesmo que o site GIS Server use um adaptador da web ou balanceador de carga, você deverá fornecer a URL no formato mencionado acima. |
<ArcGIS Server administrator> | Forneça o nome de usuário de um usuário integrado (não específico da organização) que tenha privilégios de administrador no site de hospedagem GIS Server. |
<ArcGIS Server administrator password> | Forneça a senha para a conta usada acima. |
<data directory> | O diretório de dados é o local na máquina local onde os arquivos de armazenamento de dados serão criados. |
--stores | Esta opção indica o tipo de configuração ArcGIS Data Store a ser configurada. Os valores válidos são como seguem:
Se você não especificar a opção --stores, o valor relational é assumido. |
--mode | Esta parte opcional se aplica somente aos armazenamentos de dados do cache de mosaico e armazenamentos de objeto. Os valores válidos são singleInstance, primaryStandby ou cluster. Se você não especificar um modo, os armazenamentos de dados do cache de mosaico serão criados no modo primaryStandby e os armazenamentos de objetos são criados no modo singleInstance. Os armazenamentos de dados do cache de mosaico criados no modo primaryStandby podem conter duas máquinas. Se você precisar que o armazenamento de dados do cache de mosaicos seja dimensionado para incluir três ou mais máquinas, crie um armazenamento de dados de cache de mosaicos no modo de agrupamento. Você pode usar a opção --mode para alterar o armazenamento de dados do cache de mosaico do modo PrimaryStandby para o modo de agrupamento. Os armazenamentos de objetos criados no modo singleInstance podem conter apenas uma máquina. Se precisar de alta disponibilidade, implemente o armazenamento de objetos no modo de agrupamento. Quando usado no modo de agrupamento, o armazenamento de objetos deve conter pelo menos três máquinas. O modo PrimaryStandby não se aplica mais a armazenamentos de objetos. Não é possível alterar os modos de um armazenamento de objeto. Consulte Adicionar máquinas a um armazenamento de dados para obter detalhes. |
--roles | Esta opção opcional se aplica somente a armazenamentos de grandes dados espaço-temporal de múltiplas máquinas. Os valores suportados são coord, data, ou coord,data. Máquinas de armazenamento de grandes dados espaço-temporal podem ser criadas em qualquer papel ou em ambos os papéis. Para implementar uma máquina em ambos os papéis, separe as dois papéis com uma vírgula; por exemplo, especifique --role coord,data quando você executa o utilitário configuradoatastore para criar um armazenamento de grandes dados espaço-temporal em uma máquina. Para obter uma descrição de cada papel–coordenador e dados–consulte Adicionar máquinas a um armazenamento de dados. Também é possível executar o utilitário configuradoatastore com a opção --roles para alterar o papel de uma máquina existente de armazenamento de grandes dados espaço-temporal. |
Configurar um tipo específico de armazenamento de dados
Você especifica o tipo de armazenamento de dados a ser criado usando a opção--stores, conforme indicado acima. Use os links a seguir para obter uma descrição de cada tipo de armazenamento de dados:
- Armazenamento de dados relacional
- Armazenamento de dados de cache do mosaico
- Armazenamento de grandes dados de espaço-tempo
- Armazamento de gráfico
- Armazenamento de objeto
Para configurar mais de um tipo de armazenamento de dados na mesma máquina, separe os tipos com uma vírgula (sem espaços). 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 competem por memória e outros recursos, afetando negativamente o desempenho e possivelmente fazendo com que os armazenamentos de dados parem de funcionar. Isso é especialmente verdadeiro para armazenamentos de grandes dados espaço-temporais, armazenamentos de gráficos e armazenamentos de objetos; não configure um armazenamento de grandes dados espaço-temporal, armazenamento de gráfico ou armazenamento de objeto na mesma máquina que outro armazenamento de dados ou outro componente do ArcGIS.
Se você criar 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 site GIS Server antes que você possa executar o script da criação de máquinas do armazenamento de grandes dados de espaço-tempo adicionais. Inclua tempos de espera em seu script para garantir que as máquinas do armazenamento de grandes dados de espaço-tempo adicionais não sejam adicionadas ao mesmo tempo.
Cada tipo de armazenamento de dados possui um modo padrão no qual é criado. É possível especificar um modo diferente ao criar um armazenamento de dados ou armazenamento de objetos de cache de mosaico.
Consulte Criar um armazenamento de dados para obter instruções.
Configurar armazenamentos de dados após atualizar as instalações do ArcGIS Data Store
Como parte da atualização do ArcGIS Data Store, você deve configurar novamente as máquinas do armazenamento de dados existentes. Depois de instalar uma nova versão do ArcGIS Data Store sobre o ArcGIS Data Store existente em cada máquina de armazenamento de dados, efetue o login em qualquer máquina em um armazenamento de dados e execute o utilitário configuradoatastore para concluir a atualização desse tipo específico de armazenamento de dados. Por exemplo, execute o configuradoatastore na máquina de armazenamento de dados relacional primária e a máquina em espera também será atualizada.
Se a sua máquina primária tiver ambos o armazenamento de dados de cache do mosaico e relacional, especifique --stores relational,tileCache quando você executar o utilitário configuredatastore e ela atualizará todas as máquinas em ambos os armazenamentos de dados.
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.
A configuração não pode prosseguir até que você instale a nova versão do ArcGIS Data Store em todas as máquinas na implantação ArcGIS Enterprise.
Consulte Atualizar o ArcGIS Data Store para mais informações.
Alterando o modo de armazenamento de dados do cache de mosaico
Para determinar o modo atual definido para o armazenamento de dados do cache de mosaico, execute o utilitário describeatastore na máquina do armazenamento de dados do cache de mosaico.
Caso seja necessário alterar o modo de armazenamento de dados do cache de mosaico de primaryStandby para o modo de agrupamento, execute o utilitário configureatastore com a opção --mode definida para cluster.
Anotação:
Você pode usar a opção --mode para especificar o modo de armazenamento de dados de cache de mosaico ou de armazenamento de objeto ao criar o armazenamento de dados ou para alterar o modo do armazenamento de dados de cache de mosaico de primárioStandby para modo de agrupamento, mas não é possível alterar o modo ao atualizar um armazenamento de dados de cache de mosaico, não é possível alterar o modo de armazenamento de dados do cache de mosaico de agrupamento para PrimaryStandby e não é possível alterar o modo de qualquer outro tipo de armazenamento de dados.
Alterando o papel da máquina de armazenamento de grandes dados espaço-temporal
Cada agrupamento de armazenamento de grandes dados espaço-temporal deve ter uma máquina no papel de coordenador que atue como o coordenador atual de todas as outras máquinas no agrupamento. A primeira máquina criada em um armazenamento de grandes dados espaço-temporal deve incluir a função de coordenador, e essa primeira máquina é o coordenador ativo atual. Para garantir que o agrupamento continue a funcionar mesmo quando a máquina coordenadora atual falhar, o agrupamento deve ter pelo menos duas outras máquinas que tenham o papel de coordenador atribuído a elas.
Um agrupamento de armazenamento de grandes dados espaço-temporal também deve ter pelo menos uma máquina no papel de dados.
Os papéis são atribuídos às máquinas quando você as adiciona ao agrupamento, conforme descrito em Adicionar máquinas a um armazenamento de dados. As máquinas qualificadas para serem coordenadoras podem ser alteradas para armazenar apenas dados. Máquinas que estão atualmente apenas no papel de dados podem ter o papel de coordenador adicionado a elas.
As alterações de função suportadas são as seguintes:
- Especifique --roles data para alterar um coordenador para uma máquina de dados. Isto é possível se houver outras máquinas elegíveis para coordenadora no agrupamento. Você poderá alterar uma máquina coordenadora para uma função de dados se houver pelo menos três outras máquinas elegíveis para coordenadora no agrupamento.
- Especifique --roles data para remover a função de coordenadora de uma máquina que foi implementada com ambas as funções. Isso deixa a máquina na função de dados. Você poderá remover a função de coordenadora da máquina se houver pelo menos três outras máquinas elegíveis para coordenadora no agrupamento.
- Especifique --roles coord,data para adicionar a função de coordenadora a uma máquina que foi inicialmente implementada para preencher apenas a função de dados. Um máximo de cinco máquinas podem incluir a função de coordenadora. Se já existirem cinco máquinas coordenadoras no agrupamento, não será possível adicionar a função de coordenadora a uma máquina de dados no agrupamento.
Dica:
Antes de alterar o papel de uma máquina, execute o utilitário describedatastore em uma das máquinas para identificar qual papel é atribuído a cada máquina no agrupamento de armazenamento de grandes dados espaço-temporal.
Exemplos
Neste exemplo, um armazenamento de dados para dados da camada de feição hospedada (armazenamento de dados relacional) foi criado. A URL do 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 --prompt no
No exemplo a seguir, um armazenamento de dados de cache de mosaico existente (primário-auxiliar) é alterado para o modo de agrupamento:
./configuredatastore.sh https://gisserver.mydomain.com:6443 admin Iph33l$ik dsstore/scenedata --stores tileCache --mode cluster --prompt no
No próximo exemplo, uma das máquinas somente de dados em um agrupamento de armazenamento de grandes dados espaço-temporal tem o papel de coordenador adicionado a ela, tornando-a elegível para atuar como coordenador se a máquina coordenadora atual falhar.
./configuredatastore.sh https://gisserver.mydomain.com:6443 admin Iph33l$ik dsstore/scenedata --stores spatiotemporal --roles coord,data --prompt no
deletebackup
Este utilitário é usado com armazenamentos de dados relacionais e armazenamentos de objetos.
O utilitário deletebackup permite excluir arquivos de cópia de segurança criados para armazenamentos de dados relacionais ou armazenamentos de objetos. Primeiro, execute o utilitário configurebackuplocation com a opção --operation definida para list para obter uma lista de todos os locais de cópia de segurança configurados para o armazenamento de dados. Em seguida, execute o utilitário listbackups com um dos locais para ver os nomes e horários de criação das cópias de segurança naquele local. Repita essa etapa para cada local de cópia de segurança. Você pode então executar o utilitário deletebackup para excluir os arquivos da cópia de segurança que não são mais necessários. Você deve executar deletebackup separadamente para cada local do qual deseja excluir os arquivos de cópia de segurança.
Anotação:
Você só pode excluir cópias de segurança que não sejam necessárias 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> [--store {relational | object}] [--location "<backup-location>"] [--prompt {yes | no}]
Exemplo
No exemplo a seguir, a cópia de segurança do armazenamento de dados relacional denominado featuresMarchbu é excluída do local de cópia de segurança padrão.
./deletebackup.sh featuresMarchbu --store relational
You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
Neste exemplo, o June-videobu do armazenamento de objetos é excluído do local da cópia de segurança denominado videobucket.
./deletebackup.sh june-videobu --store object --location "videobucket"
You are attempting to delete backup 'june-videobu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
Este utilitário é usado com todos os tipos de armazenamento de dados.
O utilitário descriptionatastore fornece informações sobre uma instalação do ArcGIS Data Store. Ele relata quais tipos de armazenamento de dados estão instalados na máquina onde você executa o utilitário e fornece informações sobre cada tipo de armazenamento de dados na máquina.
Anotação:
Se um armazenamento de dados estiver instalado na máquina, mas não configurado, ele aparecerá como um armazenamento ArcGIS Data Store disponível, mas nenhuma informação adicional será retornada para esse tipo de armazenamento de dados.
Algumas informações são comuns a todos os tipos de armazenamento de dados e outras são específicas de um tipo de armazenamento de dados. As tabelas a seguir listam e explicam as propriedades retornadas pelo utilitário descriptionatastore:
Propriedades gerais
Os valores dessas propriedades são os mesmos para todos os tipos de armazenamento de dados instalados na máquina.
| Propriedade | Descrição |
|---|---|
Lançamento do ArcGIS Data Store | O número de versão do software para instalação do ArcGIS Data Store. |
Local de teste | Para armazenamentos de dados de cache de mosaico e relacionais, o local de preparação é onde ArcGIS Data Store extrai os arquivos de cópia de segurança compactados antes de restaurar o armazenamento de dados. Se um armazenamento de dados tiver um local de armazenamento em nuvem configurado para cópias de segurança , os arquivos de cópia de segurança serão colocados primeiro no local de preparação antes de serem copiados para o local de armazenamento em nuvem. Para alterar o local de execução, use o utilitário changestaginglocation. |
Localização do registro | O diretório de arquivos no qual ArcGIS Data Store grava os arquivos de log. Para alterar a localização do arquivo de log, use o utilitário changeloglocation. |
Espaço livre em disco | A quantidade do espaço em disco disponível restante na máquina onde o ArcGIS Data Store está instalado. |
Propriedades comuns
Essas propriedades aparecem para cada tipo de armazenamento de dados, mas seus valores são específicos do armazenamento de dados para o qual estão listadas.
| Propriedade | Descrição |
|---|---|
Local de cópia de segurança | O local da cópia de segurança padrão usado por cada tipo de armazenamento de dados. |
Programação de cópia de segurança | Para cópias de segurança automatizados, a frequência com que uma cópia de segurança é criada de cada tipo de armazenamento de dados. |
Status do data store | Indica se o armazenamento de dados está em execução. |
URL do sistema proprietário | O site de hospedagem GIS Server no qual o armazenamento de dados está registrado. Geralmente é o mesmo servidor de hospedagem para todos os armazenamentos de dados na máquina; entretanto, é possível ter armazenamentos de dados na mesma máquina que são usados com implantações diferentes ArcGIS Enterprise. |
URL do Portal for ArcGIS | Geralmente é a mesma URLPortal for ArcGIS para todos os armazenamentos de dados na máquina; entretanto, é possível ter armazenamentos de dados na mesma máquina que são usados com implantações diferentes ArcGIS Enterprise. |
Máquinas registradas | Uma lista de todas as máquinas no tipo de armazenamento de dados específico. Esta propriedade lista todas as máquinas, independentemente do seu status. |
Propriedades do armazenamento de dados relacionais
Estas propriedades são específicas para uma implementação de armazenamento de dados relacional.
| Propriedade | Descrição |
|---|---|
Cópia de segurança de dias retido | O número de dias que os arquivos de cópia de segurança do armazenamento de dados relacionais são retidos antes ArcGIS Data Store de excluí-los. |
A recuperação pontual está habilitada | Indica se o armazenamento de dados relacional está configurado para criar cópias de segurança incrementais, que permitem restaurá-lo para um momento específico. Esta configuração é definida usando o utilitário changedbproperties. |
SSL habilitado | Indica se a comunicação SSL está habilitada. |
Limite para o modo READONLY | O limite de espaço livre em disco no qual o armazenamento de dados relacional será colocado no modo somente leitura. Você pode alterar esse valor para o armazenamento de dados relacional usando o utilitário changedbproperties. |
Máximo de conexões | Indica o número máximo permitido de conexões com o armazenamento de dados relacional. |
Número de conexões | O número de conexões da camada de feição atual no armazenamento de dados relacional. |
Modo de armazenamento de dados | Indica se o armazenamento de dados está no modo leitura-gravação ou somente leitura. |
Última transferência | Essa propriedade informa a data e a hora mais recentes em que a máquina primária falhou, resultando na promoção da máquina em espera para o papel primário. Esta propriedade não será listada se o armazenamento de dados nunca tiver feito transferência. |
Propriedades do armazenamento de dados do cache de mosaico
Essas propriedades são específicas para uma implementação de armazenamento de dados de cache de mosaico.
| Propriedade | Descrição |
|---|---|
Máquinas de membros | Se o armazenamento de dados do cache de mosaico for implementado no modo de agrupamento, esta propriedade fornecerá uma lista das máquinas ativas e disponíveis no agrupamento. |
Última transferência | Para armazenamentos de dados de cache de mosaico em execução no modo de espera principal, essa propriedade informa a data e a hora mais recentes em que a máquina primária falhou, resultando na promoção da máquina em espera para a função primária. Esta propriedade não será listada se o armazenamento de dados nunca tiver feito transferência. |
Modo de implantação | Indica se o armazenamento de dados do cache de mosaico está em execução no modo de espera primário ou no modo de agrupamento. |
SSL habilitado | Indica se a comunicação SSL está habilitada. |
Propriedades de armazenamento de grandes dados espaçotemporal
Essas propriedades são específicas para uma implementação de armazenamento de grandes dados espaço-temporal.
| Propriedade | Descrição |
|---|---|
O agrupamento está finalizado | Indica se o agrupamento contém o número mínimo necessário de coordenadores e máquinas de dados. |
Reequilíbrio automático | Se o valor desta propriedade estiver definido como ativado, o armazenamento de grandes dados espaço-temporal distribui dados para outras máquinas se alguma máquina estiver indisponível. Se o valor desta propriedade estiver definido como desativado, os dados não serão redistribuídos se uma máquina estiver indisponível. Esta configuração é alterada usando o utilitário changedbproperties . |
Tempo máximo de reequilíbrio desativado | Quando você desabilita o rebalanceamento (nesse caso, o valor da propriedade Reequilíbrio automático será definido para desativado), ele só fica desabilitado pelo número de minutos indicado por esta propriedade. No final deste período de tempo, o valor da propriedade Reequilíbrio automático será definido paraativado. Esta configuração é alterada usando o utilitário changedbproperties . |
Limite para o modo READONLY | O limite de espaço livre em disco no qual o armazenamento de grandes dados espaço-temporal será colocado no modo somente leitura. |
Máquinas de membros | Uma lista das máquinas ativas e disponíveis no agrupamento de armazenamento de grandes dados espaço-temporais. |
Modo de armazenamento de dados | Indica se o armazenamento de dados está no modo leitura-gravação ou somente leitura. |
Máquina coordenadora atual no agrupamento | A máquina no armazenamento de grandes dados espaço-temporal que atualmente atua como coordenadora de todas as máquinas no agrupamento. |
Máquinas candidatas a coordenador em agrupamento espaço-temporal | Máquinas no armazenamento de grandes dados espaço-temporal que têm o papel de coordenador atribuída e, portanto, podem se tornar o coordenador atual. |
Máquinas de dados em agrupamento espaço temporal | Máquinas no armazenamento de grandes dados espaço-temporal às quais é atribuída ao papel de dados. |
Propriedades do armazenamento gráfico
Essas propriedades são específicas para uma implantação de armazenamento de gráficos.
| Propriedade | Descrição |
|---|---|
Modo de implantação | Indica se o armazenamento de dados foi implementado em instância única ou modo de agrupamento. |
Última transferência | Essa propriedade informa a data e a hora mais recentes em que a máquina primária falhou, resultando na promoção da máquina em espera para o papel primário. Esta propriedade não será listada se o armazenamento de dados nunca tiver feito transferência. |
Propriedades de armazenamento de objetos
Essas propriedades são específicas para uma implementação de armazenamento de objetos.
| Propriedade | Descrição |
|---|---|
Modo de implantação | Indica se o armazenamento de dados foi implementado em instância única ou modo de agrupamento. Os armazenamentos de objetos criados antes da versão ArcGIS Data Store 11.1 reportarão o modo de espera principal, mas poderão conter apenas uma máquina. |
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.
Você deve ter diferentes armazenamentos de dados em máquinas diferentes, mas para permitir que você veja as informações retornadas para cada tipo, a seguinte saída mostra uma máquina que tem todos tipos de ArcGIS Data Store na mesma máquina. As duas primeiras seções (Armazenamentos de Dados do ArcGIS disponíveis e Informações Gerais) são sempre retornadas. As seções do armazenamento de dados retornadas porscribetastore variam dependendo do tipo de armazenamento de dados presente na máquina onde você executa o utilitário.
./describedatastore.sh
Available ArcGIS Data Stores
==============================================================
Relational Data Store
Tile Cache Data Store
Spatiotemporal Big Data Store
Graph Store
Object Store
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....11.3.0.1234
Staging location............./arcgis/datastore/staging
Log location................./arcgis/datastore/logs
Free disk space..............174.00GB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location................/net/nwshare/dsbackups
Backup schedule................{"schedule-starttime":"00:00:00","schedule-frequency":"Every 1 DAYS"}
Days backup retained...........31
Data store status..............Started
SSL enabled....................true
Threshold for READONLY mode....2048MB
Last failover..................20150130190334005
Registered machines............MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections............150
Owning system URL..............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL..........https://portal_webadaptor.domain.com/portal
Number of connections..........8 connection(s) to managed database
Data store mode................READWRITE
Is point-in-time recovery enabled...No
Information for tile cache data store ds_wztxj7um
==============================================================
Data location............/home/ags/arcgis/datastore/usr/arcgisdatastore/nosqldata
Data store status........Started
Last failover............20200130190334005
Backup location........../net/sharedir/datastore/backup
Backup schedule..........{"schedule-starttime":"01:00:00","schedule-frequency":"Every 2 DAYS"}
Deployment mode..........cluster
SSL enabled..............true
Member machines..........MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines......MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL....https://portal_webadaptor.domain.com/portal
Information for spatiotemporal big data store ds_qpko99Cl
==============================================================
Is cluster finalized................Yes
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Threshold for READONLY mode.........1024MB
Backup location...................../net/dirshare2/sbds_bu
Backup schedule.....................{"schedule-starttime":"02:00:00","schedule-frequency":"Every 2 DAYS"}
Member machines.....................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Coordinator candidate machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator machine in cluster......MACHINE1.DOMAIN.COM
Data machines in spatiotemporal cluster.....MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines.................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data store mode.....................READWRITE
Information for graph store x2b7s0n
==============================================================
Deployment mode..............primaryStandby
Backup location............../net/dirshare3/graphbu
Backup schedule..............{"schedule-starttime":"03:00:00","schedule-frequency":"Every 3 DAYS"}
Registered machines..........MACHINE1.DOMAIN.COM
Owning system URL............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL........https://portal_webadaptor.domain.com/portal
Information for object store w1tiknx
==============================================================
Deployment mode...........singleInstance
Backup location.........../net/dirshare4/myfiles/ods_bu
Backup schedule...........{"schedule-starttime":"04:00:00","schedule-frequency":"Every 1 DAYS"}
Registered machines.......MACHINE1.DOMAIN.COM
Owning system URL.........https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portaldiskcleanup
Este utilitário é usado com armazenamentos de grandes dados de espaço-tempo, relacional e de cache do mosaico.
O utilitário diskcleanup remove arquivos temporários que sobraram de operações, como restoredatastore e atualização doArcGIS Data Store. Determinados arquivos são retidos após a atualização, o que permitiria a você solucionar problemas de falha de uma operação de restauração ou atualização. Após confirmar que sua operação de atualização ou restauração foi bem-sucedida e que o sistema está funcionando conforme esperado, você poderá executar essa ferramenta para remover esses arquivos temporários e recuperar espaço livre em disco nas máquinas de armazenamento de dados.
Este utilitário limpa o espaço do disco em uma máquina por vez. Caso seja necessário limpar arquivos em mais de uma máquina no mesmo armazenamento de dados, você deverá executar a ferramenta em cada máquina.
Sintaxe
diskcleanup
Exemplo
Para executar o utilitário diskcleanup, você deve confirmar que deseja continuar.
./diskcleanup
You are attempting to cleanup some archived data generated as part of ArcGIS Data Store upgrades or backup-restore operations. Once removed, this data can't be recovered. Do you want to continue (Yes or No)?
listadminusers
Este utilitário é usado com todos os tipos de armazenamento de dados.
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. Ele retorna as credenciais do administrador para todos os outros tipos de armazenamento de dados.
Sintaxe
listadminusers
Exemplos
Neste exemplo, listadminusers é executado em uma máquina em que apenas um armazenamento de dados relacional está instalado.
./listadminusers.sh
Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
Neste exemplo, listadminusers é executado em uma máquina em que apenas um armazenamento de grandes dados de espaço-tempo está instalado.
./listadminusers.sh
Admin users for spatiotemporal big data store bds_abcd1234 ================================================= Store admin user.... els_321ret / B1as70fF1
Neste exemplo, listadminusers é executado em uma máquina onde apenas um armazenamento de gráficos está instalado.
./listadminusers.sh
Admin users for graph store s2t0ic1 ================================================= Store admin user....root / ypz5kx2c5tk4fequ
Neste exemplo, listadminusers é executado em uma máquina onde apenas um armazenamento de objeto está instalado.
./listadminusers.sh
Admin users for object store w1tiknx ================================================= Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4
listbackups
Este utilitário é usado com todos os tipos de armazenamento de dados.
Quando executar para armazenamentos de dados relacionais, o utilitário listbackups funcionará somente na máquina primária do armazenamento de dados.
Execute o utilitário listbackups para determinar o seguinte:
- A hora em que uma operação de cópia de segurança foi iniciada
- Se uma cópia de segurança foi concluída ou ainda está em execução
- Se a cópia de segurança foi criada usando o utilitário backupdatastore ou criada automaticamente pelo ArcGIS Data Store
- Quais arquivos de cópia de segurança são viáveis. Se o arquivo de cópia de segurança não for retornado pelo utilitário listbackups, ele não poderá ser usado para restaurar o armazenamento de dados. Por exemplo, os arquivos de cópia de segurança criados com uma versão anterior ArcGIS Data Store podem não funcionar para restaurar o armazenamento de dados.
- Quantos arquivos de cópia de segurança você tem, para determinar se você precisa excluir algum
- Confirme os nomes dos arquivos de cópia de segurança antes de executar o utilitário deletebackup
Quando você executar o utilitário listbackups, especifique o local da cópia de segurança que deseja visualizar na lista de arquivos da cópia de segurança. Se você não especificar um local, o utilitário listbackups retornará cópias de segurança do local da cópia de segurança padrão.
Sintaxe
listbackups [--store {relational | tileCache | spatiotemporal | graph | object}] [--location "<location_arguments>"]
Se você não especificar um tipo de armazenamento de dados (--store), 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. Se o armazenamento de dados relacional não estiver presente na máquina onde você executa o utilitário, o utilitário retornará uma mensagem de erro.
Use a opção --location para descobrir informações de backups em um local de cópias de segurança registrado específico. Se você não especificar um local, serão retornadas informações sobre o local de cópia de segurança padrão. Forneça um dos seguintes argumentos com a opção --location:
| Argumento | Descrição |
|---|---|
name= | Forneça o nome do local de cópia de segurança. Você especificou este nome quando configurou o local da cópia de segurança ou se você não especificou um nome, o ArcGIS Data Store atribuiu um nome padrão. |
location= | Especifique o caminho para o diretório de arquivos compartilhados, contêiner S3 ou contêiner de armazenamento Blob que você registrou como local de cópia de segurança. |
Exemplos
Neste exemplo, as cópia de segurança são listadas para o local da cópia de segurança padrão de um armazenamento de dados relacional:
./listbackups.sh --store relational
Backup_Name Status Backup_Time Mode ======================================================================= phase1proj_bu BackupComplete 2023-03-08 14:12 manual phase2proj_bu BackupComplete 2023-02-21 11:43 manual ds_gdt1omh-2023020130 BackupComplete 2023-02-01 03:00 scheduled Backups located at: '/net/myserver.net.com/dsbackups'
Neste exemplo, cópias de segurança do armazenamento de grandes dados de espaço-tempo são listadas para o local da cópia de segurança denominado sbdsbu:
./listbackups.sh --store spatiotemporal --location "name=sbdsbu"
Backup_Name Status Backup_Time Mode ================================================================== backup1 BackupComplete 2023-07-11 09:47 manual Backups located at: '/net/myserver.ntw.com/spatiotemporal'
listdatasources
Este utilitário é usado com armazenamentos de grandes dados espaço-temporais.
Devido a um erro no 10.8.1, serviços de mapas do ArcGIS GeoEvent Server que usam agregação quadrada ou hexagonal não são renderizados após a atualização para 10.9 ou posterior. Para corrigir isso, você pode executar o utilitário listdatasources para obter os nomes dos serviços de mapas do GeoEvent Server e use os nomes de serviço que ele retorna com o utilitário upgradedatasource para atualizar os dados de serviços individuais.
O utilitário listdatasources pode ser executado em qualquer máquina no armazenamento de grandes dados espaço-temporal.
Sintaxe
listdatasources
Exemplo
Execute o utilitário listdatasources em uma janela de comando para retornar uma lista de serviços de mapa do GeoEvent Server.
./listdatasources
listmanageduser
Este utilitário é usado com todos os tipos de armazenamento de dados.
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 a senha do proprietário do cache de cena para armazenamentos de dados do cache de mosaicos, do proprietário dos gráficos no armazenamento de gráficos e do proprietário dos vídeos no armazenamento de objetos.
Sintaxe
listmanageduser
Exemplos
No seguinte exemplo, listmanageduser é executado em uma máquina que contém um armazenamento de dados do cache de mosaico e relacional. A máquina é o principal armazenamento de dados 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
No seguinte exemplo, o listmanageduser é executado em uma máquina do armazenamento de gráficos.
./listmanageduser.sh
Managed user for graph store s2t0ic1 ================================================ UserName Password mu_vwmp8c6 m5c2so76y3b0qczf
No seguinte exemplo, o listmanageduser é executado em uma máquina do armazenamento de objeto.
./listmanageduser.sh
Managed user for object store w1tiknx ============================================================= Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4
registerdatastore
Este utilitário é usado com todos os tipos de armazenamento de dados.
O armazenamento de dados retém informações sobre os nomes das máquinas do site de hospedagem GIS Server. Se você mover o site de hospedagem GIS Server para novas máquinas (por exemplo, se você adquiriu um novo hardware ou se as máquinas existentes GIS Server falharam), você deve cancelar o registro do armazenamento de dados do site GIS Server para remover esta informação. Após você configurar o GIS Server em uma nova máquina (ou máquinas), registre o armazenamento de dados com o site do GIS Server através do utilitário registerdatastore.
Anotação:
O utilitário registerdatastore é usado para registrar o armazenamento de dados no mesmo site em que GIS Server foi registrado anteriormente. O armazenamento de dados contém os dados das camadas hospedadas no site do GIS Server existente. Registrar em um site diferente do GIS Server não recria as camadas hospedadas.
O utilitário registerdatastore pode ser executado na máquina de armazenamento de dados relacional primária ou na máquina de armazenamento gráfico ou na máquina primária de um armazenamento de dados de cache de mosaico que está em execução no modo de espera principal. Ele pode ser executado em qualquer máquina em um armazenamento de dados de cache de mosaico ou armazenamento de objetos em execução no modo de agrupamento ou em qualquer máquina de armazenamento de grandes dados espaço-temporal.
Sintaxe
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator username> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | graph | object}
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
Este utilitário é usado com armazenamentos de grandes dados de espaço-tempo, relacional, de cache do mosaico e de gráfico.
Utilize o utilitário removemachine para remover uma máquina de um armazenamento de dados que contenha mais de uma máquina. O utilitário removemachine é utilizado nos seguintes cenários:
- Remova uma máquina auxiliar de um armazenamento de dados relacional ou armazenamento gráfico. Você pode executar este utilitário 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 dados do cache de mosaico. Você pode executar este utilitário em qualquer máquina no armazenamento de dados do cache de mosaico, mas não pode executar removemachine em um armazenamento de dados do cache de mosaico composto por somente uma máquina.
- Remover uma máquina de um armazenamento de grandes dados de espaço-tempo. Você pode executar este utilitário em qualquer máquina no armazenamento de grandes dados de espaço-tempo, mas não pode executar removemachine em um armazenamento de grandes dados de espaço-tempo composto por somente uma máquina.
Se você executar esse utilitário na máquina coordenadora atual , uma das máquinas restantes elegíveis para gerente no agrupamento deverá assumir o papel de coordenador atual. Deve haver pelo menos duas outras máquinas no agrupamento às quais foi atribuída ao papel de gerente para que isso aconteça. Antes de remover uma máquina, execute o utilitário describedatastore para identificar qual máquina é a coordenadora atual e quais são elegíveis para se tornarem o coordenador.
Sintaxe
removemachine <machine name> --store {relational | tileCache | spatiotemporal | graph} [--force {true | false}] [--prompt {yes | no}]
Você deve fornecer o nome da máquina e o tipo de armazenamento de dados.
Especifique true com a opção --force somente se o site registrado ArcGIS Server não estiver disponíve.
Por padrão, você será solicitado a confirmar a execução do utilitário. Se você não deseja confirmar a ação, especifique no com a opção --prompt.
Exemplos
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 --prompt no
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 --prompt no
replacesslcertificate
Este utilitário é usado com todos os tipos de armazenamento de dados.
Você pode substituir o certificado autoassinado ArcGIS Data Store usado pelo servidor web para autenticar a comunicação entre o servidor de hospedagem e o armazenamento de dados e entre máquinas de armazenamento de dados por um certificado verificado e assinado por uma autoridade certificadora (CA) ou certificado de domínio. Você também pode substituir o certificado autoassinado usado para comunicação entre máquinas por meio de portas para os seguintes tipos de armazenamento de dados:
- Armazenamento de dados relacional
- Armazenamento de dados de cache de mosaico
- Armazamento de gráfico
- Armazenamento de objeto
Este utilitário eventualmente substituirá o utilitário updatesslcertificate.
Consulte Substitua o ArcGIS Data Store certificado SSL para mais informações.
Sintaxe
replacesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate> --option <webserver | relational | graph | object | tileCache>
Exemplos
No exemplo a seguir, o certificado autoassinado usado para autenticação de servidor web é substituído por um arquivo de certificado assinado por CA (mysignedcert.pfx).
./replacesslcertificate.sh /usr/files/mysignedcert.pfx "ps4mycert" "mycacert" --option webserver
No próximo exemplo, o certificado autoassinado usado para comunicação com o armazenamento de dados relacional pelas portas é substituído por um certificado assinado por uma CA (mysecondsignedcert.pfx).
./replacesslcertificate.sh /usr/files/mysecondsignedcert.pfx "ps4mycert" "relcacert" --option relational
restoredatastore
Este utilitário é usado com todos os tipos de armazenamento de dados.
Se você perder o acesso aos dados usados pelas camadas hospedadas, use seus arquivos de cópia de segurança e o utilitário restauradoatastore para recuperar o armazenamento de dados.
Se você não conseguir 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 última cópia de segurança completa para a 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.
Anotação:
O armazenamento de dados relacional deve ser configurado para suportar recuperação pontual e você só poderá restaurar para um estado anterior do armazenamento de dados relacional para o qual tenha arquivos de 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.
Se você precisar substituir uma das máquinas em um armazenamento de dados do cache de mosaico de máquinas múltiplas, você precisará reequilibrar os caches da camada de cena através do armazenamento de dados do cache de mosaico. Parte deste processo exige que você restaure o armazenamento de dados do cache de mosaico, configurando a opção replicatedata para true. Consulte Recuperar um armazenamento de dados para instruções.
O utilitário restauradoatastore deve ser executado na máquina de armazenamento de dados relacional primária. O utilitário pode ser executado em qualquer armazenamento de dados de cache de mosaico, armazenamento de grandes dados espaço-temporal, armazenamento de gráficos ou máquinas de armazenamento de objetos.
Anotação:
Para descobrir quais arquivos da cópia de segurança você pode usar para restaurar, execute o utilitário listbackups.
Sintaxe
restoredatastore [options]
As opções suportadas estão listadas na tabela abaixo:
| Opção | Descrição |
|---|---|
--store | Indica o tipo de armazenamento de dados a ser restaurado. Os valores válidos são relational, tileCache, spatiotemporal, graph ou object. |
--target | Os valores válidos são most-recent, o carimbo de data/hora do arquivo de cópia de segurança no formato <yyy-mm-dd-hh:mm:ss>, ou o nome do arquivo de cópia de segurança. Todos os tipos de armazenamentos de dados suportam o nome de arquivo da cópia de segurança com a opção target. Um carimbo de data/hora e most-recent são suportados apenas para armazenamentos de dados relacionais. Ao restaurar após ter encerrado com erro ou movido o armazenamento de dados relacional, especifique --target most-recent. Se estiver restaurando um armazenamento de dados relacional para um momento específico—o que exige que o armazenamento de dados relacional seja configurado para permitir a recuperação pontual—especifique a data e a hora (em UTC) para as quais 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. |
--source-loc | Este é o diretório de nível superior onde os arquivos da cópia de segurança que você deseja usar para restaurar o armazenamento de dados estão localizados. Este será o caminho para um local de compartilhamento de arquivos, um nome de local da cópia de segurança ou um local da cópia de segurança de armazenamento do Amazon S3 ou Azure Blob. Dica:Para obter locais de origem de backup, você pode executar o utilitário configurebackuplocation com a opção --operation definida como list. Se você não puder executar o utilitário configurebackuplocation—por exemplo, se a máquina do armazenamento de dados travar e você estiver restaurando para uma nova máquina para recuperar o armazenamento de dados—você poderá identificar o local de origem da cópia de segurança pela presença de um arquivo chamado agsds_backup_sig. |
--bound | Os valores válidos são true ou false. A opção --bound é suportada somente com armazenamentos de dados relacionais. Por padrão, supõe-se que você esteja restaurando o armazenamento de dados relacional para funcionar com o mesmo site GIS Server no qual foi registrado quando criou a cópia de segurança. Especifique apenas --bound false para restaurar o armazenamento de dados sem manter a associação com o site do armazenamento de dados GIS Server. Se você moveu os serviços hospedados para um local diferente GIS Server,você pode definir a opção --bound para false e especifique a URL do novo site GIS Server com a opção --server-url quando você restaura. Você também pode restaurar o armazenamento de dados relacional desvinculado de seu GIS Server como último recurso se o site GIS Server foi perdido e não pôde ser recuperado; você poderia restaurar o armazenamento de dados desvinculado e configurá-lo com um novo site federado GIS Server. 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 ArcGIS Enterprise. |
--data-dir | Este é o diretório do 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 | Se você especificar --bound true (ou omitir a opção --bound) para manter o armazenamento de dados registrado no mesmo site GIS Server em que foi registrado quando você criou o cópia de segurança, especifique a URL desse siteGIS Server. 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 . 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 | 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 do ArcGIS Server. |
--server-password | 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 | Compatível com cache de mosaico e armazenamentos de grandes dados espaço-temporal e armazenamentos de gráficos e objetos. Os valores válidos são true ou false. Configure esta opção para false quando você precisar de restauração do armazenamento de dados para um novo conjunto de máquinas, mas os dados não ajustarão na primeira máquina. Isto permite a você restaurar o esquema do armazenamento de dados, adicionar mais máquinas ao armazenamento de dados 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. |
--replicatedata | Suportado com armazenamentos de dados do cache de mosaico. Os valores válidos são true ou false. Configure esta opção para true quando você precisar reequilibrar os dados de cache da cena após adicionar uma máquina ao armazenamento de dados de cache do mosaico. |
--mode | Os valores válidos são primaryStandby ou cluster. Ao restaurar um armazenamento de dados do cache de mosaico para uma nova máquina, especifique se deseja um armazenamento de dados do cache de mosaico de duas máquinas para alta disponibilidade (primaryStandby) ou um armazenamento de dados do cache de mosaico de múltiplas máquinas escalável (cluster). |
--prompt | Os valores válidos são yes ou no. Quando você executa este utilitário, você é solicitado para confirmar a ação que você especificou. Se você automatizar o uso deste utilitário, defina a opção --prompt como no; caso contrário, o script não continuará até que você responda ao prompt. |
Exemplos
Neste exemplo, a cópia de segurança mais recente está em um local de cópia de segurança denominado rdsbackups e será restaurado no armazenamento de dados existente. Como o tipo de armazenamento padrão é relacional e permanece vinculado por padrão ao site do GIS Server com o qual foi registrado, não é necessário 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 --source-loc rdsbackups --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 com recuperação pontual habilitada é restaurado do local de cópia de segurança do armazenamento de dados relacional em um compartilhamento de rede para o estado em que estava às 14h30. (UTC) em 17 de julho de 2014.
./restoredatastore.sh --target 2014-07-17-14:30:00 --source-loc /net/sharedserver/entbackups/relds --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 . Devido ao dos serviços da feição hospedados ainda estarem 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 --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 . Devido ao fato dos serviços da cena ainda estarem 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 --store tilecache --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
Neste exemplo, o armazenamento de dados de cache do mosaico é restaurado a partir de um arquivo nomeado mybackupfilename para reequilibrar os dados do cache da cena após uma nova máquina ser adicionada ao armazenamento de dados de cache do mosaico.
./restoredatastore.sh --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
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
Este utilitário é usado 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> <username> [<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
Este utilitário é usado com todos os tipos de armazenamento de dados.
Você pode utilizar o utilitário unregisterdatastore para fazer o seguinte:
- Cancelar o registro de um armazenamento de dados de máquina única de qualquer tipo no site de hospedagem GIS Server.
Você deve reiniciar o servidor de hospedagem após cancelar o registro de um armazenamento de objeto.
- Em armazenamentos de dados em execução no modo auxiliar principal, você pode cancelar o registro da máquina primária depois de remover a máquina auxiliar.
- Para armazenamentos de grandes dados espaço-temporais e armazenamentos de dados de cache de mosaicos em execução no modo de agrupamento, você pode cancelar o registro da última máquina após remover todas as outras máquinas do agrupamento.
Anotação:
Se você cancelar o registro do armazenamento de dados para removê-lo permanentemente da implantação, exclua as camadas hospedadas que usam os dados antes de cancelar o registro desse armazenamento de dados. Por exemplo, se os membros da organização estivessem testando as GeoAnalytics Tools e usou o armazenamento de grandes dados espaço-temporal para as camadas criadas pelas ferramentas, mas determinou que as camadas poderiam ser armazenadas no armazenamento de dados relacional, em vez disso, exclua as camadas de feições espaço temporais hospedadas de teste antes de cancelar o registro do armazenamento de grandes dados espaço-temporal. Se você não fizer isto, você terá camadas inúteis no portal e serviços inúteis executando no servidor de hospedagem.
Quando você cancela o registro de uma máquina no armazenamento de dados, o site de hospedagem GIS Server (ou site ArcGIS Knowledge Server no caso de gráficos de conhecimento) não poderá mais se conectar a essa máquina e todos os serviços que continham dados do armazenamento de dados não registrado não funcionarão mais. Contudo, este utilitário não exclui os dados; se você decidir que ainda precisa do armazenamento de dados, poderá usar o utilitário registerdatastore ou configuredatastore para adicioná-lo de volta.
Sintaxe
unregisterdatastore --stores {relational | tileCache | spatiotemporal | graph | object} [--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
Este utilitário é usado 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
Este utilitário é usado com todos os tipos de armazenamento de dados.
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 ou armazenamentos de gráficos. 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 um horário de início usando a notação de relógio de 24 horas, por exemplo, 00:00:00 para meia-noite e 13:00:00 para 13h. Use a opção frequency 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 relacional. A ferramenta pode ser executada em qualquer máquina do armazenamento de grandes dados de espaço-tempo ou de cache do mosaico.
Para obter mais informações sobre cópias de segurança do ArcGIS Data Store, consulte Gerenciar cópias de segurança do ArcGIS Data Store .
Sintaxe
updatebackupschedule [--store {relational | tileCache | spatiotemporal | graph | object}] [--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.
Exemplos
Neste exemplo, cópias de segurança completas de um armazenamento de dados relacional acontecerão às 11:00 p.m. (hora 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
updatesslcertificate
Este utilitário é usado com todos os tipos de armazenamento de dados.
Este utilitário está obsoleto nesta versão. Recomendamos que você use o utilitário replacesslcertificate.
Você pode substituir o certificado autoassinado usado pelo servidor web para autenticar a comunicação entre o servidor de hospedagem e o armazenamento de dados e entre máquinas de armazenamento de dados por um certificado verificado e assinado por uma autoridade certificadora (CA) ou certificado de domínio.
Este utilitário não substitui o certificado usado para autenticar a comunicação pelas portas.
Sintaxe
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
Exemplo
Depois de receber um arquivo de certificado assinado pela CA, execute updatesslcertificate para substituir o ArcGIS Data Store certificado autoassinado usado para comunicação com servidor web.
./updatesslcertificate.sh /usr/files/mysignedcert.pfx "ps4mycert" "mycacert"
upgradedatasource
Este utilitário é usado com armazenamentos de grandes dados espaço-temporais.
Devido a um erro no 10.8.1, serviços de mapas do ArcGIS GeoEvent Server que usam agregação quadrada ou hexagonal não são renderizados após a atualização para 10.9 ou posterior. Para corrigir isso, execute o utilitário upgradedatasource para atualizar os índices associados aos dados de origem para esses serviços de mapa do GeoEvent Server.
Enquanto os índices estão sendo atualizados, ninguém pode acessar o serviço de mapas.
O utilitário upgradedatasource pode ser executado em qualquer máquina no armazenamento de grandes dados espaço-temporal.
Sintaxe
upgradedatasource [<service name>]
Exemplos
Neste exemplo, todas as origens de serviço de mapa do GeoEvent Server são atualizadas:
./upgradedatasource
Neste exemplo, o utilitário upgradedatasource atualizará os índices usados pelo reconhecimento do serviço de mapa do GeoEvent Server. O nome do serviço foi determinado usando o utilitário listdatasources.
./upgradedatasource recon