Crear una copia de seguridad de ArcGIS Enterprise—Portal for ArcGIS

Puede exportar los componentes de su organización de ArcGIS Enterprise a un archivo de copia de seguridad que después se podrá utilizar para restaurar su organización en el caso de un fallo de hardware o pérdida de datos. El archivo incluye los elementos y configuraciones de su portal, capas web alojadas, configuraciones del servidor federado y de alojamiento; y, si utiliza ArcGIS Data Store, datos de la capa de entidades alojada y cachés de capa de escena alojada.

El tamaño del archivo de copia de seguridad y el tiempo que se tarda en crearlo varía dependiendo de la cantidad de elementos que haya en el portal, del número y tipo de capas web alojadas que tenga, de cuántos servidores federados tenga y de cuántos equipos de ArcGIS Server haya en sus servidores de alojamiento y federados.

Use la utilidad webgisdr con la operación de exportación y un archivo de propiedades para crear una copia de seguridad de ArcGIS Enterprise. Encontrará la utilidad en el directorio de las herramientas de Portal for ArcGIS. Asegúrese de cumplir con estos criterios cuando use la utilidad:

El directorio compartido que especifique debe ser lo suficientemente grande para incluir el archivo exportado. Para obtener una estimación del tamaño del archivo, utilice la utilidad webgisdr con la operación de exportar para crear una exportación de prueba de la organización de ArcGIS Enterprise. Compruebe el tamaño de archivo, decida cuántos archivos pretende mantener en el directorio compartido, tenga en cuenta que su organización crecerá con el tiempo, y dimensione el tamaño de forma correspondiente. Ya que el tamaño de archivo probablemente se incrementará con el tiempo, debe continuar monitorizando el tamaño de estos archivos de copia de seguridad y ajustar el tamaño de almacenamiento como sea necesario.
La cuenta que se utilizó para instalar cada componente de software en ArcGIS Enterprise debe tener privilegios de lectura y escritura en el directorio compartido.
La copia de seguridad de cada componente se coloca en un directorio temporal en el equipo de cada componente antes de moverse al directorio compartido que especifique. Por lo tanto, los siguientes directorios deben tener la capacidad suficiente para dar cabida a la copia de seguridad 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
El data store relacional ArcGIS Data Store de su implementación de ArcGIS Enterprise debe tener habilitada la recuperación de un punto en el tiempo si pretende crear copias de seguridad incrementales (BACKUP_RESTORE_MODE = incremental).

Nota:

Si el contenido de su portal está almacenado en el sistema de archivos, el análisis antivirus en tiempo real puede afectar al rendimiento de la copia de seguridad. Considere excluir el directorio de contenido del portal y sus directorios SHARED_LOCATION y BACKUP_LOCATION de copia de seguridad de su análisis antivirus.

Siga estos pasos para crear una copia de seguridad de su organización de ArcGIS Enterprise:

Realice una copia del archivo de propiedades de la plantilla. Puede guardar la copia en el mismo directorio que la plantilla o en un directorio nuevo.
El archivo de propiedades de la plantilla, webgisdr.properties, está instalado en /arcgis/portal/tools/webgisdr de forma predeterminada.
En este ejemplo, la copia del archivo se llama mywebgis.properties y está guardada en /home/ags/arcgis/portal/propfiles.
Abra la copia del archivo de propiedades y edítela para incluir información específica de su sitio.
- PORTAL_ADMIN_URL = <URL de directorio admin de portal>
  Especifique la dirección URL del directorio de administración de Portal for ArcGIS. Utilice el formato https://portalhostname.domain.com:7443/arcgis, donde portalhostname.domain.com es el nombre completo del equipo en el que Portal for ArcGIS está instalado.
- PORTAL_ADMIN_USERNAME = <nombre de usuario de administrador de portal>
  Especifique el nombre de usuario de un miembro del portal que tenga asignado el rol de administrador.
- PORTAL_ADMIN_PASSWORD = <contraseña de administrador de portal>
  Especifique la contraseña de la cuenta del administrador del portal.
- PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>
  Establezca esta opción en false la primera vez que rellene el archivo con su contraseña de administrador. Al guardar el archivo, la contraseña se cifrará y el valor de PORTAL_ADMIN_PASSWORD_ENCRYPTED se establecerá en true para indicar que se ha cifrado la contraseña. Si necesita cambiar la contraseña en un futuro, establezca PORTAL_ADMIN_PASSWORD_ENCRYPTED = false, indique su nueva contraseña de administrador y guarde el archivo.
- BACKUP_RESTORE_MODE = <backup | full | incremental>
  Especifique el tipo de copia de seguridad que desea crear. El modo predeterminado es backup. Consulte Modos de copia de seguridad para obtener información sobre los tipos de modos de copia de seguridad. Para programar las copias de seguridad completas e incrementales, deberá crear archivos de propiedades independientes para cada modo de copia de seguridad.
- SHARED_LOCATION = <ubicación de archivos de copia de seguridad>
  Designe una ubicación compartida para crear una copia temporal del archivo de copia de seguridad para ArcGIS Server, Portal for ArcGIS y ArcGIS Data Store. La cuenta que instaló ArcGIS Server, Portal for ArcGIS y ArcGIS Data Store, y la cuenta que ejecuta la utilidad webgisdr deben tener privilegios de lectura y escritura en esta ubicación. Asegúrese de que la ubicación sea lo suficientemente grande para albergar los archivos de copia de seguridad de cada componente. Aunque los archivos están comprimidos, pueden ser bastante grandes, en función de la cantidad y el tipo de datos que tenga. Si ha alojado capas de escena y cachés y ha definido INCLUDE_SCENE_TILE_CACHES como true, el archivo de copia de seguridad ArcGIS Data Store puede ser especialmente grande.
  Asegúrese de que se utilice el carácter de escape en las barras invertidas. Por ejemplo, C:\backups se introduciría como C:\\backups y \\fileserver\backups se introduciría como \\\\fileserver\\backups.
- INCLUDE_SCENE_TILE_CACHES = <true | false>
  Si publica capas de escena alojadas en su portal y desea incluir los datos de la caché de escenas en la copia de seguridad, establezca INCLUDE_SCENE_TILE_CACHES en true. Debe tener en cuenta que, si lo establece como true, en la copia de seguridad se incluirán todos los datos de la caché de escenas, no solamente los datos de la caché nueva que creó desde la última copia de seguridad. Si sabe que no se han creado cachés de escena nuevas desde la última copia de seguridad o si no desea publicar escenas en su portal, puede establecer INCLUDE_SCENE_TILE_CACHES en false.
- BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | AzureBlob}
  Defina si desea guardar el archivo de copia de seguridad webgissite en el sistema de archivos o en el almacenamiento en la nube.
  Si desea almacenar la copia de seguridad de ArcGIS Enterprise en una ubicación de recurso compartido de archivos local, especifique FileSystem para que la utilidad webgisdr almacene sus archivos de copia de seguridad en el recurso compartido de archivos que especifique para BACKUP_LOCATION.
  Si desea almacenar las copias de seguridad de ArcGIS Enterprise en Amazon Simple Storage Service (S3) o en una ubicación de almacenamiento de un bucket compatible con S3, cree uno específico para almacenar los archivos de copia de seguridad generados por la utilidad webgisdr y actualice las propiedades de S3 con la información necesaria para acceder al bucket.
  Si desea almacenar las copias de seguridad de ArcGIS Enterprise en un almacenamiento de BLOB de Microsoft Azure, deberá crear un contenedor de almacenamiento de BLOB de Azure específico para almacenar los archivos de copia de seguridad generados por la utilidad webgisdr y actualizar las propiedades de Azure con la información necesaria para acceder al contenedor.
  Nota:
  Si su organización de ArcGIS Enterprise es local pero sus copias de seguridad se almacenan en la nube, la creación de copias de seguridad y la restauración tardarán más que si almacena sus copias de seguridad en un recurso compartido de archivos local.
- BACKUP_LOCATION = <ubicación de archivo de copia de seguridad local>
  Designe la ubicación del archivo de copia de seguridad webgissite.
  Asegúrese de que se utilice el carácter de escape en las barras invertidas. Por ejemplo, C:\backups se introduciría como C:\\backups y \\fileserver\backups se introduciría como \\\\fileserver\\backups.
  Los archivos de copia de seguridad se almacenan inicialmente en la SHARED_LOCATION, pero se copian en la BACKUP_LOCATION. Asegúrese de que la ubicación sea lo suficientemente grande para albergar el archivo de copia de seguridad. Aunque el archivo está comprimido, puede ser bastante grande, en función de la cantidad y el tipo de datos que tenga. La cuenta que ejecuta la utilidad webgisdr debe tener privilegios de lectura y escritura en BACKUP_LOCATION.
  Si establece BACKUP_LOCATION en una carpeta, la herramienta de recuperación en caso de desastre importa el último archivo de copia de seguridad disponible en esa carpeta. Si establece BACKUP_LOCATION en un archivo de copia de seguridad específico de la carpeta, será ese archivo el que importe la herramienta de recuperación en caso de desastre.
  Nota:
  Si la copia de seguridad tarda mucho en empaquetarse durante la exportación, plantéese configurar BACKUP_LOCATION en una ruta local. Luego puede copiar el paquete terminado en su ubicación prevista. Asegúrese de que hay espacio suficiente en el disco local para almacenar la copia de seguridad temporalmente.
- COMPRESSION_METHOD= <copy | fastest | fast | normal | maximum | ultra>
  Determine el método de compresión para la copia de seguridad de webgissite. El valor predeterminado si no se rellena ni se excluye mediante la marca de comentario es copy. En la mayoría de las situaciones, se puede dejar excluido mediante la marca de comentario. Un administrador tiene la opción de comprimir aún más las copias de seguridad a costa de aumentar su tiempo de procesamiento.
- Si establece BACKUP_STORE_PROVIDER en AmazonS3, proporcione información para las siguientes propiedades:
  - S3_ACCESSKEY= <clave de acceso de su cuenta de Amazon Web Services (AWS)>
    Solo debe establecerla si ha establecido S3_CREDENTIAL_TYPE = accessKey. El usuario de IAM representado por esta clave de acceso debe tener acceso de lectura y escritura en el bucket de S3 que especifique con la propiedad S3_BUCKET.
  - S3_SECRETKEY= <clave secreta de su cuenta de AWS>
    Especifique la clave secreta asociada a la clave de acceso de su cuenta de AWS. Esto solo se utiliza si establece S3_CREDENTIAL_TYPE en accessKey.
  - S3_ENCRYPTED = false
    Déjelo establecido en false. Si S3_CREDENTIAL_TYPE está establecido en accessKey cuando ejecute la utilidad webgisdr, la utilidad cifrará la clave de acceso y la clave secreta y establecerá S3_ENCRYPTED en el valor de la clave de acceso cifrada.
  - S3_BUCKET= <nombre de bucket de S3>
    Es el nombre del bucket de Amazon S3 en el que desea almacenar su archivo de copia de seguridad de ArcGIS Enterprise.
  - S3_CREDENTIAL_TYPE= <IAMRole | accessKey>
    Configure S3_CREDENTIAL_TYPE en IAMRole si accederá a S3_BUCKET mediante un rol de IAM de AWS. Configúrelo en accessKey si accederá a S3_BUCKET utilizando un usuario de IAM de AWS mediante una clave de acceso. El rol o usuario de IAM debe tener acceso de lectura y escritura al bucket de S3 que especifique con la propiedad S3_BUCKET.
  - S3_REGION= <región AWS en la que se ha creado el bucket de S3>
  - S3_BACKUP_NAME = <nombre de archivo de copia de seguridad>
    Esta propiedad solo se utiliza cuando restaure una organización de ArcGIS Enterprise. Especifique el archivo de copia de seguridad que desea restaurar. Si no especifica un archivo de copia de seguridad, se restaura el último archivo de copia de seguridad.
- Si su organización de ArcGIS Enterprise se ejecuta en AWS y el directorio de contenido del portal está almacenado en Amazon S3, necesitará un bucket de copia de seguridad para el directorio de contenido. Este no debe ser el mismo bucket en el que se encuentra el portal o se producirá una duplicación de contenido cada vez que se realice una copia de seguridad. Cree un bucket de copia de seguridad en S3, defina PORTAL_BACKUP_S3_BUCKET en el archivo de propiedades en el nombre del bucket y cambie PORTAL_BACKUP_S3_REGION a la región de AWS en la que creó el bucket de S3. Consulte Configurar un ArcGIS Enterprise de alta disponibilidad con servicios de almacenamiento de AWS en la ayuda de ArcGIS Enterprise on Amazon Web Services para obtener más información sobre este tipo de implementación.
  Nota:
  Si los equipos de su organización acceden a Amazon S3 utilizando un extremo de VPC, no se permite copiar entre regiones. Al implementar la redundancia geográfica, cree un bucket en la misma región que el de respaldo y asegúrese de que el bucket de copia de seguridad de contenido del portal exportado se sincronice con AWS CLI (o un proceso automatizado) antes de ejecutar la operación de importación WebGISDR. El depósito replicado tendrá que especificarse en el archivo de restauración de webgisdr.properties como PORTAL_BACKUP_S3_BUCKET con la región adecuada.
- Si establece BACKUP_STORE_PROVIDER en AzureBlob, proporcione información para las siguientes propiedades:
  - AZURE_BLOB_ACCOUNT_NAME = <cuenta de almacenamiento de Azure>
    Especifique el nombre de la cuenta de almacenamiento de BLOB de Azure.
    Sugerencia:
    Especificó este nombre de cuenta de almacenamiento cuando eligió la opción Usar el almacenamiento en la nube de Azure para la configuración y el almacén de contenido en el panel Opciones de implementación de Cloud Builder.
  - AZURE_BLOB_ACCOUNT_KEY = <clave de cuenta>
    Especifique la clave de cuenta asociada a su cuenta de almacenamiento de BLOB de Azure.
  - AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED = false
    Especifique false cuando agregue por primera vez los valores de ACCOUNT_KEY al archivo. Cuando guarde el archivo webgisdr.properties, la clave se cifrará y la herramienta definirá estas propiedades como true.
  - AZURE_BLOB_CONTAINER_NAME = <nombre de su contenedor de almacenamiento de Blob de Azure>
    Especifique el nombre del contenedor BLOB.
  - AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <extremo de cuenta de almacenamiento de Blob>
    Especifique el extremo de la cuenta de almacenamiento del servicio BLOB.
  - (Opcional) AZURE_BLOB_ENDPOINT_URL = <URL de servicio Blob>
    Especifique la URL del extremo del servicio BLOB si utiliza un extremo de almacenamiento de BLOB personalizado. Si no utiliza un extremo personalizado, no elimine los comentarios de esta línea. La URL predeterminada tiene el formato https://<BLOB_ACCOUNT_NAME>.blob.core.windows.net.
- También puede almacenar el directorio de contenido del portal en un contenedor de almacenamiento de BLOB de Azure. Si lo hace, necesita un depósito de copia de seguridad para el directorio de contenido en Azure. Este no debe ser el mismo bucket en el que se encuentra el portal o se producirá una duplicación de contenido cada vez que se realice una copia de seguridad. El conjunto de propiedades que empiezan por PORTAL_BACKUP_BLOB define la cuenta utilizada para el directorio de contenido del portal. Los valores de estas propiedades deben coincidir con los definidos en la sección AZURE_BLOB anterior; las definiciones de esa sección se aplican aquí también.
  - PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <cuenta de almacenamiento de Azure>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <clave de cuenta>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
  - PORTAL_BACKUP_BLOB_CONTAINER_NAME = <nombre de su contenedor de almacenamiento de Blob de Azure>
  - PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <extremo de cuenta de almacenamiento de Blob>
  - (Opcional) PORTAL_BACKUP_BLOB_ENDPOINT_URL = <URL de servicio de Blob personalizado>
- IS_PORTAL_PKI_AUTHENTICATED = <verdadero | falso>
  Si ha configurado una infraestructura de clave pública (PKI) para proteger el acceso a su portal, defina este valor como true.
  Más información sobre las opciones de autenticación del portal
  Si se define como true, proporcione valores para las siguientes propiedades adicionales:
  - PORTAL_CLIENT_CERTIFICATE_FILE_PATH = <ruta de archivo totalmente certificada>
    Especifique la ruta completa del archivo del certificado PKI del portal en formato PKCS12.
  - PORTAL_CLIENT_CERTIFICATE_PASSWORD = <contraseña para certificado>
    Especifique la contraseña correspondiente al certificado PKI.
  - PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED = falso
    Cuando introduzca por primera vez el valor para la contraseña del certificado, deje este valor como false. Cuando ejecute la herramienta por primera vez después de guardar este valor, la herramienta cifrará la contraseña y cambiará esta propiedad a true.
En este ejemplo, un archivo de copia de seguridad del portal en la dirección URL https://portalhostname.domain.com:7443/arcgis, más los servicios y la configuración de sus servidores de alojamiento y federados, así como los datos de la capa de entidades alojados en el data store relacional de ArcGIS Data Store, se incluirán inicialmente en los archivos de \\\\myserver\\tempbackups. Los archivos separados se comprimirán en un único archivo de copia de seguridad (entbackup) y se copiarán en \\mybuserver\\wgbackups. Las cachés de capas de escenas del data store de caché de teselas de ArcGIS Data Store no se incluirán porque INCLUDE_SCENE_TILE_CACHES está establecido en 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
```
En este ejemplo, una copia de seguridad del portal en la dirección URL https://portalonaws.mydomain.com:7443/gis, su directorio de contenido (almacenado en el bucket S3 de portalcontent), los servicios y la configuración de los servidores de alojamiento y federados del portal, y los datos almacenados en los data stores relacionales y de caché de teselas se incluirán en el bucket S3 de entbackups en la región eu-west-1 de AWS. El archivo de copia de seguridad se llama fullbackup06June. Un rol de IAM se utiliza para acceder a la cuenta de 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
```
Ejemplo de almacenamiento de BLOB de Microsoft Azure. Una copia de seguridad del portal en la URL https://portalonazure.domain.com:7443/arcgis, su directorio de contenido, los servicios y la configuración de los servidores federados y de alojamiento del portal y los datos almacenados en los data stores relacionales y de caché de teselas se incluirán en el BLOB Azure de 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
```
Guarde el archivo de propiedades.
El valor de PORTAL_ADMIN_PASSWORD se cifrará en el archivo y PORTAL_ADMIN_PASSWORD_ENCRYPTED se establecerá en true una vez que ejecute la utilidad webgisdr con este archivo.
Abra un shell de comando en el equipo de Portal for ArcGIS, cambie el directorio a la ubicación de la utilidad webgisdr y ejecute la utilidad con la opción de exportación.
La utilidad webgisdr está instalada en <Portal for ArcGIS installation directory>/tools/webgisdr.
La sintaxis de la utilidad webgisdr es la siguiente:
```
webgisdr --{export | import} --file <location and name of properties file>
```
Tal y como se mencionó anteriormente, el archivo de propiedades (mywebgis.properties) se guardó en el directorio creado por el usuario /home/ags/arcgis/portal/propfiles.
```
webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties
```
En la ubicación especificada se crea el archivo de copia de seguridad para la SHARED_LOCATION en el archivo de propiedades. El archivo se llama <timestamp>.webgissite.
Si su organización de ArcGIS Enterprise incluye cachés de servicio de mapas o de capas de teselas alojadas, haga manualmente una copia de seguridad de todos los directorios donde se almacenan las teselas de caché (por ejemplo, todo el directorio arcgiscache bajo C:\arcgisserver\directories\ o <ArcGIS Server installation directory>/arcgis/server/usr/directories).
Estos directorios contienen las teselas de caché de mapa y el archivo del esquema de ordenamiento en teselas conf.xml. Los directorios de caché también podrían contener una geodatabase de archivos, status.gdb, que contiene información sobre qué teselas se han construido.

Puede utilizar este archivo para restaurar ArcGIS Enterprise.

¿Algún comentario sobre este tema?

Nota:

Nota:

Nota:

Nota:

Sugerencia: