Skip To Content

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

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 com 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:

  1. 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 no C:\Program Files\ArcGIS\Portal\tools\webgisdr por padrão.

    Neste exemplo, a cópia do arquivo é denominada mywebgis.properties e salva no C:\propfiles.

  2. Abra a cópia do arquivo de propriedades e edite para incluir informações específicas para seu site.

    • 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. Embora o arquivo esteja compactado, ele pode ser bastante grande dependendo da sua quantidade e do seu tipo de dados. 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 10.4, esta propriedade era SHARED_FOLDER.

    • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | Azure}

      Se você deseja 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.

      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 de arquivo da cópia de segurança>

      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 no BACKUP_LOCATION.

      Se você configurar BACKUP_LOCATION para uma pasta, a ferramenta de recuperação de desastre importa o arquivo de cópia de segurança mais recente desta pasta. Se você configurar BACKUP_LOCATION para um arquivo de cópia de segurança específica na pasta, este arquivo será importado pela ferramenta de recuperação de desastre.

    • PORTAL_ADMIN_URL = <URL do diretório de admin 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 do máquina onde o Portal for ArcGIS está instalado.

    • PORTAL_ADMIN_USERNAME = <nome de usuário de administrador do 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.

    • 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_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.

    • 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 o ArcGIS Enterprise altamente disponível com serviços de armazenamento do 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.

    • Você pode armazenar seu diretório de conteúdo do portal em um contêiner de armazenamento do Azure Blob. Para utilizar o utilitário webgisdr para criar uma cópia de segurança desta implantação, você deve definir as seguintes propriedades:
      • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <conta de armazenamento do Azure>

        Configure PORTAL_BACKUP_BLOB_ACCOUNT_NAME para 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 armaenamento de conteúdo no painel Opções da Implantação do Cloud Builder.

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <chave da conta>

        Configure PORTAL_BACKUP_BLOB_ACCOUNT_KEY para a chave de conta associada à sua conta de armazenamento do Azure Blob.

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false

        Configure PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED para false na primeira vez que adicionar o valor PORTAL_BACKUP_BLOB_ACCOUNT_KEY. Quando você salvar o arquivo webgisdr.properties, a chave será codificada e a ferramenta configurará PORTAL_BACKUP_BLOB_ACCOUNT_KEYpara true.

      • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <Parâmetro da conta de armazenamento do Blob>

        Especifique o parâmetro da conta de armazenamento do serviço de Blob.

      • PORTAL_BACKUP_BLOB_ENDPOINT_URL = <URL de serviço do Blob>

        Especifique a URL do parâmetro de serviço do Blob. A URL está no formato https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name>.

    • 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 AWS>

        Você somente precisa definir isto se você configurar S3_CREDENTIAL_TYPE=accessKeys. 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 da sua conta 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 accessKeys.

      • S3_ENCRYPTED = false

        Mantenha isto definido para false. Se você tiver S3_CREDENTIAL_TYPE configurado para accessKeys 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 de 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 | accessKeys

        Configure S3_CREDENTIAL_TYPE para IAMRole se você for acessar o S3_BUCKET utilizando um papel de AWS IAM. Configure para accessKeys 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 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ê restaurar 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.

    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.

    BACKUP_STORE_PROVIDER = FileSystem
    SHARED_LOCATION = \\\\myserver\\tempbackups
    BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup
    PORTAL_ADMIN_URL = https://portalhostname.domain.com:7443/arcgis
    PORTAL_ADMIN_USERNAME = admin
    PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
    PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
    INCLUDE_SCENE_TILE_CACHES = false
    BACKUP_RESTORE_MODE = full

    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.

    BACKUP_STORE_PROVIDER = AmazonS3 PORTAL_ADMIN_URL = https://portalonaws.mydomain.com:7443/gis PORTAL_ADMIN_USERNAME = entadmin PORTAL_ADMIN_PASSWORD = p0rtl.a.p PORTAL_ADMIN_PASSWORD_ENCRYPTED = false INCLUDE_SCENE_TILE_CACHES = true BACKUP_RESTORE_MODE = full PORTAL_BACKUP_S3_BUCKET = portalcontent S3_BUCKET = entbackups S3_CREDENTIAL_TYPE = IAMRole S3_REGION = eu-west-1
    S3_BACKUP_NAME = fullbackup06June

  3. 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.

  4. 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 criada pelo usuário C:\propfiles.

    webgisdr --export --file C:\propfiles\mywebgis.properties
  5. 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 inteiro arcgiscache 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 de esquema do mosaico conf.xml. 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.