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. Quando você cria uma cópia de segurança de uma implantação que não contém quaisquer dados ou serviços, o arquivo que é gerado tem aproximadamente 400 MB de tamanho. Seu arquivo sempre será maior que isto.

Utilize 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. Os seguintes critérios devem ser atendidos para utilizar este utilitário:

O diretório compartilhado que você especifica deve ser grande o suficiente para conter o arquivo exportado. Faça uma exportação de teste da sua implantação do ArcGIS Enterprise pra ter uma idéia do tamanho que será o arquivo, decidir quantos arquivos você pretende manter no diretório compartilhado e dimensionar o diretório consequentemente.
A conta de domínio ou contas que você utiliza para executar seus serviços do ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store devem ter acesso de escrita no diretório compartilhado que você especifica para os arquivos da cópia de segurança.
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 diretórios seguintes 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: C:\Users\<user>\AppData\Local\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).

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 C:\Program Files\ArcGIS\Portal\tools\webgisdr por padrão.
Neste exemplo, a cópia do arquivo é denominada mywebgis.properties e salva em C:\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 para o papel de Administrador definido pela Esri.
- 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 = <full | incremental>
  Se você criar somente cópias de segurança completas, você poderá configurar esta propriedade para full. Para diminuir o tamanho das cópias de segurança, entretanto, você pode criar dois arquivos de propriedades diferentes—um com BACKUP_RESTORE_MODE = full, que você utilizará ocasionalmente para criar cópias de segurança completas, e um 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 de domínio que executa o serviço do ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store, e a conta executando o utilitário webgisdr devem ter acesso de gravação neste local. 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.
  Validado:
  No Portal for ArcGIS ArcGIS 10.4, esta propriedade era SHARED_FOLDER.
- 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.
  Se você deseja armazenar sua cópia de segurança do ArcGIS Enterprise em uma localização de compartilhamento do arquivo local, 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.
  Se você deseja armazenar suas cópias de segurança do ArcGIS Enterprise em um contêiner Amazon Simple Storage Service (S3), crie um contêiner S3 especificamente para armazenar arquivos da cópia de segurança gerados pelo utilitário webgisdr e atualize as propriedades de S3 com as informações necessárias para acessar seu contêiner.
  Se você deseja armazenar sua cópia de segurança do ArcGIS Enterprise no armazenamento do Azure Blob, crie um contêiner de armazenamento do Azure Blob especificamente para armazenar arquivos da cópia de segurança gerados pelo utilitário webgisdr e atualizar as propriedades do Azure com as informações necessárias para acessar seu contêiner.
- BACKUP_LOCATION = <local do arquivo da cópia de segurança>
  Designe a localização do arquivo de cópia de segurança webgissite.
  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 acesso de gravação ao 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.
- 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 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 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 chave secreta e configurará S3_ENCRYPTED para o valor da chave de acesso codificado.
  - S3_BUCKET= <nome do contêiner S3>
    Este é o nome de contêiner do 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ê for acessar o S3_BUCKET utilizando um papel de AWS IAM. Configure para accessKey se você for acessar o S3_BUCKET utilizando um usuário AWS IAM via uma chave de acesso. O papel IAM ou usuário deve ter acesso de leitura e gravação no contêiner S3 que você especifica com a propriedade S3_BUCKET.
  - S3_REGION= <Região do AWS 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 seu 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. Crie um contêiner da cópia de segurança no S3 e configure PORTAL_BACKUP_S3_BUCKET no arquivo de propriedades para o nome do contêiner e configure PORTAL_BACKUP_S3_REGION para a região de 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.
  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 de armazenamento do Azure>
    Especifique o nome Conta de armazenamento do Azure Blob .
    Dica:
    Você especificou este nome de conta do armazenamento quando escolheu para 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 para a chave de 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 do seu contêiner de armazenamento do Azure 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 ponto final de serviço Blob se você estiver utilizando um ponto final 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 também armazenar seu diretório de conteúdo do portal em um contêiner de armazenamento do Azure Blob. Se você estiver fazendo isso, você precisa de uma contêiner de cópia de segurança do diretório de conteúdo no Azure. 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 de armazenamento do Azure>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <chave da conta>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
  - PORTAL_BACKUP_BLOB_CONTAINER_NAME = <Nome do seu contêiner de armazenamento do Azure 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 = full
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 completa 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 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 contêiner S3 entbackups na região AWS eu-west-1. 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 = full
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 = portalcontent
PORTAL_BACKUP_S3_REGION =eu-west-1
```
Este exemplo é para o armazenamento do Microsoft Azure Blob. Uma cópia de segurança completa 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

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 = portalcontent
```
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 janela 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 local padrão do utilitário webgisdr é C:\Program Files\ArcGIS\Portal\tools\webgisdr.
A sintaxe do webgisdr é como segue:
```
webgisdr --{export | import} --file <location and name of properties file>
```
Como mencionado anteriormente, o arquivo de propriedades (mywebgis.properties) foi salvo na pasta C:\propfiles criada pelo usuário .
```
webgisdr --export --file C:\propfiles\mywebgis.properties
```
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 seu ArcGIS Enterprise.

Comentário neste tópico?

Validado:

Validado:

Dica: