Criar uma cópia de segurança do ArcGIS Enterprise—Portal for ArcGIS

Você pode exportar os componentes da sua implantação do ArcGIS Enterprise para um arquivo da cópia de segurança que pode posteriormente ser utilizado para restaurar sua implantação no caso de falha do hardware ou perda de dados. O arquivo inclui suas configurações e itens do portal, camadas da web hospedadas, configurações do servidor de hospedagem e federado, e, se utilizando o ArcGIS Data Store, seus dados da camada de feição hospedada e caches da camada de cena hospedada.

O tamanho do arquivo da cópia de segurança e o tempo que ele leva para criar, variam dependendo de quantos itens estão no seu portal, do número e do tipo de camadas da web hospedadas que você tem, de quantos servidores federados você tem, e quantas máquinas do ArcGIS Server estão em seus servidores de hospedagem e federados.

Use o utilitário webgisdr com a operação de exportação e um arquivo de propriedades para criar uma cópia de segurança do ArcGIS Enterprise. Você pode localizar o utilitário no diretório de ferramentas do Portal for ArcGIS. Certifique-se de atender estes critérios ao utilizar o utilitário:

O diretório compartilhado que você especifica deve ser grande o suficiente para conter o arquivo exportado. Para estimar sobre o quão grande será o arquivo, utilize o utilitário webgisdr com a operação de exportação para criar uma exportação de teste da sua implantação do ArcGIS Enterprise. Verifique o tamanho do arquivo, decida quantos arquivos você pretende manter no diretório compartilhado, leve em conta que seu desenvolvimento crescerá com o passar do tempo e o tamanho do diretório consequentemente. Devido ao aumento do tamanho do arquivo com o passar do tempo, você deve continuar a monitorar o tamanho destes arquivos de cópia de segurança e ajuste o tamanho de armazenamento, se necessário.
A conta que foi utilizada para instalar cada componente de software no ArcGIS Enterprise deve ter privilégios de escrita e leitura no diretório compartilhado.
A cópia de segurança de cada componente é colocada em um diretório temporário em cada máquina do componente antes de ser movida para o diretório compartilhado que você especifica. Portanto, os seguintes diretórios devem ser grandes o suficiente para conterem a cópia de segurança de cada componente:
- Portal for ArcGIS: <Portal_content_directory>/temp
- ArcGIS Server: <ArcGIS_Server_installation_directory>/temp
- ArcGIS Data Store: <ArcGIS_Data_Store_directory>/temp
O armazenamento de dados relacional do ArcGIS Data Store em sua implantação do ArcGIS Enterprise deve ter a recuperação de ponto no tempo ativada se você pretende criar cópias de segurança incrementais (BACKUP_RESTORE_MODE = incremental).

Anotação:

Se o conteúdo do seu portal estiver armazenado no sistema de arquivos, a verificação de antivírus em tempo real poderá afetar o desempenho da cópia de segurança. Considere excluir o diretório de conteúdo do portal e diretórios SHARED_LOCATION e BACKUP_LOCATION da cópia de segurança do seu antivírus.

Siga estas etapas para criar uma cópia de segurança da sua implantação do ArcGIS Enterprise:

Crie uma cópia do arquivo de propriedades do modelo. Você pode salvar a cópia no mesmo diretório do modelo ou em um novo diretório.
O arquivo de propriedades do modelo—webgisdr.properties—é instalado em /arcgis/portal/tools/webgisdr por padrão.
Neste exemplo, a cópia do arquivo é denominada mywebgis.properties e salva em /home/ags/arcgis/portal/propfiles.
Abra a cópia do arquivo de propriedades e edite para incluir informações específicas para seu site.
- PORTAL_ADMIN_URL = <URL do diretório de administração do portal>
  Especifique a URL do diretório de admin do Portal for ArcGIS. Utilize o formato https://portalhostname.domain.com:7443/arcgis, onde portalhostname.domain.com é o nome completamente qualificado da máquina onde o Portal for ArcGIS está instalado.
- PORTAL_ADMIN_USERNAME = <nome de usuário do administrador de portal>
  Especifique o nome de usuário de um membro do portal atribuído ao papel de Administrador.
- PORTAL_ADMIN_PASSWORD = <senha de administrador do portal>
  Especifique a senha da conta de administrador do portal.
- PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>
  Configure esta opção para false a primeira vez que você preencher o arquivo com a sua senha de administrador. Quando você salva o arquivo, sua senha é codificada e o valor para PORTAL_ADMIN_PASSWORD_ENCRYPTED é configurado para true para indicar que a senha foi codificada. Se você precisar da alteração de senha no futuro, configure PORTAL_ADMIN_PASSWORD_ENCRYPTED = false, forneça sua nova senha de administrador, e salve o arquivo.
- BACKUP_RESTORE_MODE = <backup | full | incremental>
  Especifique o tipo de cópia de segurança que deseja criar. Introduzido na versão 10.9, o modo backup pode ser usado quando o espaço em disco rígido limitado está disponível na máquina do portal ou quando as cópias de segurança não são agendadas regularmente. Ao usar este modo, o limite de tamanho padrão é aplicado aos logs de transações internas, evitando que eles ocupem seu disco rígido. Se você criar somente cópias de segurança completas, você poderá configurar esta propriedade para backup. Se você criar cópias de segurança completas e incrementais, poderá criar dois arquivos de propriedades diferentes—uma com BACKUP_RESTORE_MODE = full, que você utilizará ocasionalmente para criar cópias de segurança completas, e uma com BACKUP_RESTORE_MODE = incremental para gerar cópias de segurança incrementais entre cópias de segurança completas. Cada cópia de segurança incremental contém todas as alterações desde a última cópia de segurança completa.
- SHARED_LOCATION = <local para arquivos da cópia de segurança>
  Designe um local compartilhado no qual criar uma cópia temporária do arquivo da cópia de segurança para ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store. A conta que instalou o ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store e a conta executando o utilitário webgisdr devem ter os privilégios de leitura e gravação nesta localização. Certifique-se que o local é grande o suficiente para manter o arquivo da cópia de segurança para cada componente. Embora os arquivos estejam compactados, eles podem ser bastante grandes, dependendo da quantidade e tipo de dados que você possui. Se você tiver caches e camadas de cena hospedadas e configurou INCLUDE_SCENE_TILE_CACHES para true, o arquivo da cópia de segurança do ArcGIS Data Store poderá ser especialmente grande.
  Garanta que nenhuma barrainvertida no caminho seja esquecida. Por exemplo, C:\backups seria inserido como C:\\backups e \fileserver\backups seria inserido como \\\\fileserver\\backups.
- INCLUDE_SCENE_TILE_CACHES = <true | false>
  Se você publicar camadas de cena hospedadas no seu portal e deseja incluir os dados de cache da cena na cópia de segurança, configure INCLUDE_SCENE_TILE_CACHES para true. Esteja ciente que, se configurar para true, todos os dados de cache da cena serão incluídos na cópia de segurança, não apenas os novos dados de cache criados desde a sua última cópia de segurança. Se você souber que nenhum dos novos caches de cena foram criados desde a sua última cópia de segurança ou se você não publicar cenas no seu portal, você poderá configurar INCLUDE_SCENE_TILE_CACHES para false.
- BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | AzureBlob}
  Defina se deseja salvar o arquivo da cópia de segurança webgissite no sistema de arquivo ou no armazenamento de nuvem.
  Para armazenar sua cópia de segurança do ArcGIS Enterprise em um local de compartilhamento do arquivo, especifique FileSystem, e o utilitário webgisdr armazenará seus arquivos da cópia de segurança no compartilhamento de arquivo que você especificar para BACKUP_LOCATION.
  Para armazenar sua cópia de segurança do ArcGIS Enterprise em local de armazenamento de contêiner compatível do Amazon Simple Storage Service (S3) ou S3, crie um especificamente para armazenar arquivos da cópia de segurança gerado pelo utilitário webgisdr e atualize as propriedades do S3 com as informações necessárias para acessar seu contêiner.
  Para armazenar sua cópia de segurança do ArcGIS Enterprise no armazenamento Microsoft Azure Blob, crie um contêiner do armazenamento Azure Blob especificamente para armazenar arquivos da cópia de segurança gerados pelo utilitário webgisdr, e atualize as propriedades do Azure com as informações necessárias para acessar seu contêiner.
  Anotação:
  Se a sua implantação do ArcGIS Enterprise for local, mas suas cópias de segurança estiverem armazenadas na nuvem, a criação das cópias de segurança e a restauração levarão mais tempo do que se você armazenasse suas cópias de segurança em um compartilhamento de arquivo local.
- BACKUP_LOCATION = <local do arquivo da cópia de segurança>
  Designe a localização do arquivo de cópia de segurança webgissite.
  Garanta que nenhuma barrainvertida no caminho seja esquecida. Por exemplo, C:\backups seria inserido como C:\\backups e \\fileserver\backups seria inserido como \\\\fileserver\\backups.
  Os arquivos da cópia de segurança estão a princípio armazenados em SHARED_LOCATION mas são copiados para BACKUP_LOCATION. Certifique-se que o local é grande o suficiente para manter o arquivo da cópia de segurança. Embora o arquivo esteja compactado, ele pode ser bastante grande dependendo da sua quantidade e do seu tipo de dados. A conta que executa o utilitário webgisdr deve ter privilégios de leitura e gravação no BACKUP_LOCATION.
  Se você configurar BACKUP_LOCATION para uma pasta, a ferramenta de recuperação de desastre importará o arquivo da cópia de segurança mais recente desta pasta. Se você configurar BACKUP_LOCATION para um arquivo da cópia de segurança específica na pasta, este arquivo será importado pela ferramenta de recuperação de desastre.
  Anotação:
  Durante uma exportação, se estiver demorando muito paracrir o pacote da cópia de segurança, considere definir o BACKUP_LOCATION para um caminho local. Você pode então copiar o pacote finalizado para o local pretendido. Certifique-se que haja espaço suficiente na unidade local para armazenar a cópia de segurança temporariamente.
- COMPRESSION_METHOD= <copy | fastest | fast | normal | maximum | ultra>
  Determine o método de compressão para a cópia de segurança webgissite. O valor padrão, se não estiver preenchido ou comentado, é copy. Na maioria das situações, isso pode ser deixado como comentário. Um administrador pode optar por compactar ainda mais as cópias de segurança, às custas de mais tempo para concluí-las.
- Se você configurar BACKUP_STORE_PROVIDER para AmazonS3, forneça as informações das seguintes propriedades:
  - S3_ACCESSKEY= <A chave de acesso para sua conta do Amazon Web Services (AWS) >
    Você somente precisa definir isto se você configurar S3_CREDENTIAL_TYPE=accessKey. O usuário IAM representado por esta chave de acesso deve ter acesso de leitura e gravação para o contêiner S3 que você especifica com a propriedade S3_BUCKET.
  - S3_SECRETKEY= <A chave secreta para sua conta do AWS >
    Especifique a chave secreta associada com a chave de acesso da sua conta do AWS. Isto é utilizado somente se você configurar S3_CREDENTIAL_TYPE para accessKey.
  - S3_ENCRYPTED = false
    Mantenha isto definido para false. Se você tiver S3_CREDENTIAL_TYPE configurado para accessKey quando você executar o utilitário webgisdr, o utilitário codificará a chave de acesso e a chave secreta e definirá S3_ENCRYPTED para o valor da chave de acesso codificada.
  - S3_BUCKET= <nome de contêiner do S3 >
    Este é o nome de contêiner Amazon S3 no qual você deseja armazenar seu arquivo da cópia de segurança do ArcGIS Enterprise.
  - S3_CREDENTIAL_TYPE= <IAMRole | accessKey>
    Configure S3_CREDENTIAL_TYPE para IAMRole se você acessar o S3_BUCKET utilizando um papel IAM do AWS. Configure para accessKeyse você acessar o S3_BUCKET utilizando o usuário IAM do AWS via uma chave de acesso. O usuário ou papel IAM deve ter acesso de leitura e gravação no contêiner S3 que você especifica com a propriedade S3_BUCKET.
  - S3_REGION= <regiãoAWS na qual você criou o contêiner S3 >
  - S3_BACKUP_NAME = <nome do arquivo da cópia de segurança>
    Esta propriedade é somente utilizada quando você restaura uma implantação do ArcGIS Enterprise. Especifique o nome do arquivo da cópia de segurança que deseja restaurar. Se você não especificar um nome de arquivo da cópia de segurança, o arquivo da cópia de segurança mais recente será restaurado.
- Se a sua implantação do ArcGIS Enterprise estiver executando no AWS e o diretório de conteúdo do portal estiver armazenado no Amazon S3, você precisará de um contêiner da cópia de segurança do diretório de conteúdo. Este não deve ser o mesmo contêiner no qual o próprio portal está; caso contrário, uma duplicação de conteúdo ocorrerá sempre que você executar uma cópia de segurança. Crie um contêiner da cópia de segurança no S3, configure PORTAL_BACKUP_S3_BUCKET no arquivo de propriedades com o nome do contêiner e configure PORTAL_BACKUP_S3_REGION para a região AWS na qual você criou o contêiner S3. Consulte Configurar ArcGIS Enterprise altamente disponível com serviços do armazenamento AWS na ajuda do ArcGIS Enterprise on Amazon Web Services para mais informações sobre este tipo de implementação.
  Anotação:
  Se as máquinas da sua implantação acessarem oAmazon S3 usando um parâmetro VPC, a cópia entre regiões não será permitida. Ao implementar a redundância geográfica, crie um intervalo na mesma região que a implantação auxiliar e certifique-se que o intervalo da cópia de segurança de conteúdo do portal exportado seja sincronizado usando o AWS CLI (ou um processo automatizado) antes de executar a operação de importação do WebGISDR. Esse intervalo replicado precisaria ser especificado no arquivo de restauração webgisdr.properties cmo PORTAL_BACKUP_S3_BUCKETcom a região apropriada.
  Validado:
  Antes do ArcGIS Enterprise 10.5.1, a propriedade PORTAL_BACKUP_S3_BUCKET era BACKUP_BUCKET_NAME.
- Se você configurar BACKUP_STORE_PROVIDER para AzureBlob, forneça as informações das seguintes propriedades:
  - AZURE_BLOB_ACCOUNT_NAME = <conta do armazenamento Azure>
    Especifique o nome da conta do armazenamento Azure Blob.
    Dica:
    Você especificou este nome de conta do armazenamento quando escolheu a opção Utilizar Armazenamento de Nuvem do Azure para a configuração e armazenamento de conteúdo no painel Opções da Implantação do Cloud Builder.
  - AZURE_BLOB_ACCOUNT_KEY = <chave da conta>
    Especifique a chave da conta associada à sua conta de armazenamento do Azure Blob.
  - AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED = false
    Especifique false quando você adicionar primeiramente os valores ACCOUNT_KEY ao arquivo. Quando você salvar o arquivo webgisdr.properties, a chave será codificada e a ferramenta configurará estas propriedades para true.
  - AZURE_BLOB_CONTAINER_NAME = <Nome de contêiner do armazenamentoAzure Blob>
    Especifique o nome do contêiner Blob.
  - AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <parâmetro de conta do armazenamento Blob>
    Especifique o parâmetro da conta de armazenamento do serviço de Blob.
  - (Opcional) AZURE_BLOB_ENDPOINT_URL = <URL de serviço do Blob>
    Especifique a URL de parâmetro do serviço Blob se você estiver utilizando um parâmetro de armazenamento Blob personalizado. Se você não estiver utilizando um ponto final personalizado, não cancele o comentário desta linha. A URL padrão está no formato https://<BLOB_ACCOUNT_NAME>.blob.core.windows.net.
- Você pode armazenar seu diretório de conteúdo do portal em um contêiner de armazenamento do Azure Blob. Se você estiver fazendo isto, você precisará de uma contêiner da cópia de segurança do diretório de conteúdo no Azure. Este não deve ser o mesmo contêiner no qual o próprio portal está; caso contrário, uma duplicação de conteúdo ocorrerá sempre que você executar uma cópia de segurança. O conjunto de propriedades iniciando com PORTAL_BACKUP_BLOB define a conta ysada para diretório de conteúdo do portal. Os valores destas propriedades devem corresponder aos definidos na seçãoAZURE_BLOB acima; as definições desta seção se aplicam aqui também.
  - PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <conta do armazenamento Azure>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <chave da conta>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
  - PORTAL_BACKUP_BLOB_CONTAINER_NAME = <Nome de contêiner do armazenamentoAzure Blob>
  - PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <parâmetro da conta de armazenamento do Blob>
  - (Opcional) PORTAL_BACKUP_BLOB_ENDPOINT_URL = <URL de serviço do Blob personalizada>
- IS_PORTAL_PKI_AUTHENTICATED = <verdadeiro | falso>
  Se você configurou uma infraestrutura de chave pública (PKI) para acesso seguro ao seu portal, defina este valor para true.
  Obtenha mais informações sobre as opções de autenticação do portal
  Se configurar para verdadeiro, forneça os valores das propriedades adicionais seguintes:
  - PORTAL_CLIENT_CERTIFICATE_FILE_PATH = <caminho do arquivo de certificado completo>
    Especifique o caminho de arquivo completo do certificado de PKI do portal no formato PKCS12.
  - PORTAL_CLIENT_CERTIFICATE_PASSWORD = <senha para certificado>
    Especifique a senha correspondente para o certificado PKI.
  - PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED = falso
    Quando você inserir o valor de senha do certificado pela primeira vez, deixe este valor como false. Quando você executar a ferramenta após salvar este valor pela primeira vez, a ferramenta irá codificar a senha e alterar esta propriedade para true.
Neste exemplo, uma cópia de segurança completa do portal na URL https://portalhostname.domain.com:7443/arcgis, mais os serviços e configurações dos seus servidores de hospedagem e federados, e os dados da camada de feição hospedada armazenados no armazenamento de dados relacional do ArcGIS Data Store serão a princípio uma saída para arquivos em \\\\myserver\\tempbackups. Os arquivos separados serão compactados em um único arquivo da cópia de segurança (entbackup) e copiados para \\mybuserver\\wgbackups. Os caches da camada de cena do armazenamento de dados do cache de mosaico do ArcGIS Data Store não serão incluídos, pois INCLUDE_SCENE_TILE_CACHES está configurado para false.
```
PORTAL_ADMIN_URL = https://portalhostname.domain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = admin
PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false

BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = \\\\myserver\\tempbackups
INCLUDE_SCENE_TILE_CACHES = false

BACKUP_STORE_PROVIDER = FileSystem
BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup
```
Neste exemplo, uma cópia de segurança do portal na URL https://portalonaws.mydomain.com:7443/gis , seu diretório de conteúdo (armazenado no contêiner S3 portalcontent), os serviços e configurações dos servidores federados e de hospedagem do portal, e os dados armazenados nos armazenamentos de dados do cache de mosaico e relacional serão enviados para o contêiner S3 entbackups na região eu-west-1 doAWS. O nome do arquivo da cópia de segurança é fullbackup06June. Um papel de IAM é utilizado para acessar a conta AWS.
```
PORTAL_ADMIN_URL = https://portalonaws.mydomain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = entadmin
PORTAL_ADMIN_PASSWORD = p0rtl.a.p
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false

BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = \\fileserver\backups
INCLUDE_SCENE_TILE_CACHES = true
BACKUP_STORE_PROVIDER = AmazonS3

S3_BUCKET = entbackups
S3_CREDENTIAL_TYPE = IAMRole
S3_REGION = eu-west-1
S3_BACKUP_NAME = fullbackup06June

PORTAL_BACKUP_S3_BUCKET = contentbackups
PORTAL_BACKUP_S3_REGION =eu-west-1
```
Este exemplo é para o armazenamento do Microsoft Azure Blob. Uma cópia de segurança do portal na URL https://portalonazure.domain.com:7443/arcgis, seu diretório de conteúdo, os serviços e configurações do portal dos servidores de hospedagem e federados, e os dados armazenados em armazenamento de dados de cache do mosaico e relacional serão a saída do Azure Blob drbackups.
```
PORTAL_ADMIN_URL = https://portalonazure.domain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = entadmin
PORTAL_ADMIN_PASSWORD = p0rtl.a.p

BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = \\fileserver\backups
BACKUP_STORE_PROVIDER = AzureBlob

AZURE_BLOB_ACCOUNT_NAME = entbackups
AZURE_BLOB_ACCOUNT_KEY = <key>
AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED =false
AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = core.windows.net
AZURE_BLOB_CONTAINER_NAME = drbackups

PORTAL_BACKUP_BLOB_ACCOUNT_NAME = entbackups
PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <key>
PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = core.windows.net
PORTAL_BACKUP_BLOB_CONTAINER_NAME = contentbackups
```
Salve o arquivo de propriedades.
O valor PORTAL_ADMIN_PASSWORD será codificado no arquivo e PORTAL_ADMIN_PASSWORD_ENCRYPTED será configurado para true após você executar o utilitário webgisdr com este arquivo.
Abra uma shell de comando na máquina do Portal for ArcGIS, altere o diretório para o local do utilitário webgisdr, e execute o utilitário com a opção de exportação.
O utilitário webgisdr é instalado no <Portal for ArcGIS installation directory>/tools/webgisdr.
A sintaxe do utilitário webgisdr é como segue:
```
webgisdr --{export | import} --file <location and name of properties file>
```
Como mencionado anteriormente, o arquivo de propriedades (mywebgis.properties) foi salvo no diretório /home/ags/arcgis/portal/propfiles criado pelo usuário.
```
webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties
```
Um arquivo da cópia de segurança é criado no local que você especificou para SHARED_LOCATION no arquivo de propriedades. O nome do arquivo é <timestamp>.webgissite.
Se a sua implantação do ArcGIS Enterprise incluir caches da camada de mosaico hospedada ou do serviço de mapa, crie manualmente uma cópia de segurança de todos os diretórios onde seus mosaicos de cache estão armazenados (por exemplo, no diretório arcgiscache inteiro em C:\arcgisserver\directories\ ou <ArcGIS Server installation directory>/arcgis/server/usr/directories).
Estes diretórios contêm os mosaicos de cache do mapa e o arquivo conf.xml de esquema do mosaico . Os diretórios de cache também podem conter um arquivo geodatabase, status.gdb, que contém informações sobre quais mosaicos foram construídos.

Você pode utilizar este arquivo para restaurar o ArcGIS Enterprise.

Comentário neste tópico?

Anotação:

Anotação:

Anotação:

Anotação:

Validado:

Dica: