ArcGIS Enterprise 백업 생성

ArcGIS Enterprise 배포의 컴포넌트를 백업 파일에 내보낸 다음, 나중에 하드웨어 장애나 데이터 손실이 발생했을 때 이 백업 파일을 사용하여 배포를 복원할 수 있습니다. 이 파일에는 포털 항목과 설정, 호스팅 웹 레이어, 페더레이션된 호스팅 서버 설정이 포함되며 ArcGIS Data Store를 사용하는 경우에는 호스팅 피처 레이어 데이터와 호스팅 씬 레이어 캐시도 포함됩니다. 백업 파일의 크기와 파일 생성 시간은 포털에 있는 항목 개수, 호스팅 웹 레이어의 개수와 유형, 페더레이션된 서버 개수, 호스팅 및 페더레이션된 서버에 있는 ArcGIS Server 머신의 개수에 따라 다릅니다. 데이터나 서비스가 포함되어 있지 않은 배포를 백업하면 약 400MB의 파일이 생성됩니다. 대개 백업 파일은 이 크기보다 큽니다.

ArcGIS Enterprise 백업을 생성하려면 내보내기 작업 및 등록정보 파일과 함께 webgisdr 유틸리티를 사용합니다. Portal for ArcGIS 도구 디렉터리에서 유틸리티를 찾을 수 있습니다. 이 유틸리티를 사용하려면 다음 조건을 충족해야 합니다.

• 지정한 공유 디렉터리의 크기는 내보낸 파일이 포함될 만큼 충분히 커야 합니다. ArcGIS Enterprise 배포 내보내기를 테스트하여 파일의 크기를 가늠해보고, 공유 디렉터리에 보관할 파일의 개수를 결정하고, 이에 따른 디렉터리의 크기를 정해야 합니다.
• ArcGIS Enterprise의 각 소프트웨어 컴포넌트를 설치하는 데 사용된 계정에는 공유 디렉터리에 대한 읽기 및 쓰기 권한이 있어야 합니다.
• 각 컴포넌트의 백업은 지정한 공유 디렉터리로 이동되기 전에 각 컴포넌트 머신의 임시 디렉터리에 배치됩니다. 따라서 다음 디렉터리는 각 컴포넌트의 백업이 포함될 만큼 충분한 공간이 있어야 합니다.
  • Portal for ArcGIS: <Portal_content_directory>/temp
  • ArcGIS Server: /<ArcGIS_Server_installation_directory>/temp
  • ArcGIS Data Store: <ArcGIS_Data_Store_directory>/temp
• 증분 백업(BACKUP_RESTORE_MODE = incremental)을 생성하려는 경우 ArcGIS Data Store 배포의 ArcGIS Enterprise 관계형 데이터 저장소에 지정 시간 복구 기능이 활성화되어 있어야 합니다.

ArcGIS Enterprise 배포의 백업을 생성하려면 다음 단계를 수행합니다.

1. 템플릿 등록정보 파일의 복사본을 만듭니다. 복사본은 템플릿과 같은 디렉터리에 저장할 수도 있고 새 디렉터리에 저장할 수도 있습니다.

   템플릿 등록정보 파일(webgisdr.properties)은 기본 설정에 따라 /arcgis/portal/tools/webgisdr에 설치되어 있습니다.

   이 예시에서 파일 복사본은 이름이 mywebgis.properties이며 /home/ags/arcgis/portal/propfiles에 저장됩니다.

2. 등록정보 파일의 복사본을 열고 사이트 관련 정보가 포함되도록 편집합니다.

   • PORTAL_ADMIN_URL = <포털 관리자 디렉터리 URL>

     Portal for ArcGIS 관리자 디렉터리의 URL을 지정합니다. https://portalhostname.domain.com:7443/arcgis 형식으로 입력하며 여기서, portalhostname.domain.com은 Portal for ArcGIS가 설치된 머신의 정규화된 이름입니다.

   • PORTAL_ADMIN_USERNAME = <포털 관리자 사용자 이름>

     Esri에서 정의한 관리자 역할에 할당된 포털 구성원의 사용자 이름을 지정합니다.

   • PORTAL_ADMIN_PASSWORD = <포털 관리자 비밀번호>

     포털 관리자 계정의 비밀번호를 지정합니다.

   • PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>

     관리자 비밀번호로 파일을 처음 만드는 경우 이 옵션을 false로 설정합니다. 파일을 저장하면 비밀번호가 암호화되며 PORTAL_ADMIN_PASSWORD_ENCRYPTED의 값이 true로 설정되어 비밀번호가 암호화되었음을 나타냅니다. 나중에 비밀번호를 변경해야 할 경우에는 PORTAL_ADMIN_PASSWORD_ENCRYPTED = false로 설정하여 새 관리자 비밀번호를 제공한 후 파일을 저장합니다.

   • BACKUP_RESTORE_MODE = <full | incremental>

     전체 백업만 생성하는 경우 이 속성을 full로 설정할 수 있습니다. 그러나 백업 크기를 줄이려면 두 개별 등록정보 파일을 생성한 다음, 하나는 BACKUP_RESTORE_MODE = full로 설정하여 전체 백업을 생성하는 데 가끔씩 사용하고 다른 하나는 BACKUP_RESTORE_MODE = incremental로 설정하여 전체 백업 사이에 증분 백업을 생성하는 데 사용할 수 있습니다. 각 증분 백업에는 마지막 전체 백업 이후의 변경 사항이 모두 포함됩니다.

   • SHARED_LOCATION = <백업 파일의 위치>

     ArcGIS Server, Portal for ArcGIS, ArcGIS Data Store에 대한 백업 파일의 임시 복사본이 생성될 공유 위치를 지정합니다. ArcGIS Server, Portal for ArcGIS, ArcGIS Data Store가 설치된 계정과 webgisdr 유틸리티 실행 계정에는 이 위치에 대한 읽기 권한과 쓰기 권한이 있어야 합니다. 이 위치는 각 컴포넌트의 백업 파일이 포함될 여유 공간이 있어야 합니다. 백업 파일이 압축되었더라도 사용하는 데이터의 크기와 유형에 따라 파일 크기가 클 수 있습니다. 호스팅 씬 레이어 및 캐시를 사용하며 INCLUDE_SCENE_TILE_CACHES가 true로 설정되었다면 ArcGIS Data Store 백업 파일의 크기가 특히 클 수 있습니다.

     레거시:

     Portal for ArcGIS 10.4에서 이 등록정보는 SHARED_FOLDER이었습니다.

   • INCLUDE_SCENE_TILE_CACHES = <true | false>

     호스팅 씬 레이어를 포털에 발행하고 씬 캐시 데이터를 백업에 포함하려는 경우 INCLUDE_SCENE_TILE_CACHES를 true로 설정합니다. true로 설정하면 마지막 백업 이후에 생성된 새 캐시 데이터뿐 아니라 모든 씬 캐시 데이터가 백업에 포함됩니다. 마지막 백업 이후에 생성된 새 씬 캐시가 없거나 씬을 포털에 발행하지 않는 경우에는 INCLUDE_SCENE_TILE_CACHES를 false로 설정할 수 있습니다.

   • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | AzureBlob}

     webgissite 백업 파일을 파일 시스템이나 클라우드 저장소에 저장할지 여부를 정의합니다.

     ArcGIS Enterprise 백업을 온프레미스의 파일 공유 위치에 저장하기 위해 FileSystem을 지정하면 webgisdr 유틸리티는 BACKUP_LOCATION으로 지정된 파일 공유에 백업 파일을 저장합니다.

     ArcGIS Enterprise 백업을 Amazon Simple Storage Service(S3) 버킷에 저장하려는 경우에는 webgisdr 유틸리티에서 생성된 백업 파일을 저장하기 위한 S3 버킷을 생성한 다음, S3 등록정보를 버킷 접근에 필요한 정보로 업데이트합니다.

     ArcGIS Enterprise 백업을 Azure Blob 저장소에 저장하려는 경우에는 webgisdr 유틸리티에서 생성된 백업 파일을 저장하기 위한 Azure Blob 저장소 컨테이너를 생성한 다음, Azure 등록정보를 컨테이너 접근에 필요한 정보로 업데이트합니다.

   • BACKUP_LOCATION = <온-프레미스 백업 파일의 위치>

     webgissite 백업 파일의 위치를 지정합니다.

     백업 파일이 처음에는 SHARED_LOCATION에 저장되지만 BACKUP_LOCATION에 복사됩니다. 이 위치는 백업 파일이 포함될 만큼 공간이 충분해야 합니다. 백업 파일이 압축되었더라도 사용하는 데이터의 크기와 유형에 따라 파일 크기가 클 수 있습니다. webgisdr 유틸리티를 실행하는 계정에는 BACKUP_LOCATION에 대한 읽기 및 쓰기 권한이 있어야 합니다.

     BACKUP_LOCATION을 폴더로 설정한 경우 재해 복구 도구가 해당 폴더에서 사용 가능한 최신 백업 파일을 가져옵니다. BACKUP_LOCATION을 폴더의 특정 백업 파일로 설정한 경우에는 재해 복구 도구가 해당 파일을 가져옵니다.

   • BACKUP_STORE_PROVIDER를 AmazonS3으로 설정한 경우 다음 등록정보에 대한 정보를 제공합니다.
     • S3_ACCESSKEY= <AWS 계정의 접근 키>

       S3_CREDENTIAL_TYPE=accessKey로 설정한 경우에만 이 등록정보를 설정해야 합니다. 이 접근 키가 나타내는 IAM 사용자에게는 S3_BUCKET 등록정보로 지정한 S3 버킷에 대한 읽기 및 쓰기 권한이 있어야 합니다.

     • S3_SECRETKEY= <AWS 계정의 비밀번호 키>

       AWS 계정의 접근 키와 연관된 비밀번호 키를 지정합니다. 이 등록정보는 S3_CREDENTIAL_TYPE이 accessKey로 설정된 경우에만 사용됩니다.

     • S3_ENCRYPTED = false

       이 등록정보는 false로 그대로 유지합니다. webgisdr 유틸리티를 실행할 때 S3_CREDENTIAL_TYPE이 accessKey로 설정되어 있는 경우 이 유틸리티는 접근 키와 비밀번호 키를 암호화하고 S3_ENCRYPTED를 암호화된 접근 키 값으로 설정합니다.

     • S3_BUCKET= <S3 버킷의 이름>

       ArcGIS Enterprise 백업 파일이 저장될 Amazon S3 버킷의 이름입니다.

     • S3_CREDENTIAL_TYPE= <IAMRole | accessKey>

       AWS IAM 역할을 사용하여 S3_BUCKET에 접근할 경우 S3_CREDENTIAL_TYPE을 IAMRole로 설정합니다. 접근 키를 통한 AWS IAM 사용자를 사용하여 S3_BUCKET에 접근할 경우에는 accessKey로 설정합니다. IAM 역할 또는 사용자에게는 S3_BUCKET 등록정보로 지정한 S3 버킷에 대한 읽기 및 쓰기 권한이 있어야 합니다.

     • S3_REGION= <S3 버킷을 생성한 AWS 리전>
     • S3_BACKUP_NAME = <백업 파일 이름>

       이 등록정보는 ArcGIS Enterprise 배포를 복원하는 경우에만 사용됩니다. 복원하려는 백업 파일의 이름을 지정합니다. 백업 파일 이름을 지정하지 않으면 최신 백업 파일이 복원됩니다.

   • ArcGIS Enterprise 배포가 AWS에서 실행 중이고 포털 콘텐츠 디렉터리가 Amazon S3에 저장되어 있으면 콘텐츠 디렉터리용 백업 버킷이 있어야 합니다. S3에서 백업 버킷을 생성한 후 등록정보 파일에서 PORTAL_BACKUP_S3_BUCKET을 버킷 이름으로 설정하고 PORTAL_BACKUP_S3_REGION을 S3 버킷을 생성한 AWS 리전으로 설정합니다. 이러한 유형의 구현에 대한 자세한 내용은 ArcGIS Enterprise on Amazon Web Services 도움말의 AWS 저장소 서비스를 사용하여 고가용성 ArcGIS Enterprise 구성을 참고하세요.

     레거시:

     ArcGIS Enterprise 10.5.1 이전에는 PORTAL_BACKUP_S3_BUCKET 등록정보가 BACKUP_BUCKET_NAME이었습니다.

   • BACKUP_STORE_PROVIDER를 AzureBlob으로 설정한 경우 다음 등록정보에 대한 정보를 제공합니다.
     • AZURE_BLOB_ACCOUNT_NAME = <Azure 저장소 계정>

       Azure Blob Storage 계정 이름을 지정합니다.

       팁:

       이 저장소 계정 이름은 Cloud Builder의 배포 옵션 패널에서 Azure 클라우드 저장소를 사용하여 구성 및 콘텐츠 저장을 선택했을 때 지정됩니다.

     • AZURE_BLOB_ACCOUNT_KEY = <계정 키>

       Azure Blob Storage 계정과 연결된 계정 키를 지정합니다.

     • AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED = false

       ACCOUNT_KEY 값을 파일에 처음 추가하는 경우 false를 지정합니다. webgisdr.properties 파일을 저장하면 키가 암호화되며 도구가 해당 등록정보를 true로 설정합니다.

     • AZURE_BLOB_CONTAINER_NAME = <Azure Blob 저장소 컨테이너 이름>

       Blob 컨테이너 이름을 지정합니다.

     • AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Blob Storage 계정 끝점>

       Blob 서비스 Storage 계정 끝점을 지정합니다.

     • (선택)AZURE_BLOB_ENDPOINT_URL = <Blob 서비스 URL>

       사용자 정의 Blob 저장소 끝점을 사용하는 경우 Blob 서비스 끝점 URL을 지정합니다. 사용자 정의 끝점을 사용하지 않는 경우 해당 라인의 주석 처리를 제거하지 마세요. 기본 URL은 https://<BLOB_ACCOUNT_NAME>.blob.core.windows.net 형식입니다.

   • 또한 Azure Blob Storage 컨테이너에 포털 콘텐츠 디렉터리를 저장할 수 있습니다. 디렉터리를 저장하는 경우 Azure의 콘텐츠 디렉터리에 대한 백업 버킷이 필요합니다. PORTAL_BACKUP_BLOB으로 시작되는 등록정보는 포털 콘텐츠 디렉터리에 사용되는 계정을 정의합니다. 이러한 등록정보의 값은 위 AZURE_BLOB 섹션에서 설정한 값과 일치해야 합니다. 해당 섹션의 정의도 여기에 적용됩니다.
     • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Azure 저장소 계정>
     • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <계정 키>
     • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
     • PORTAL_BACKUP_BLOB_CONTAINER_NAME = <Azure Blob 저장소 컨테이너 이름>
     • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Blob Storage 계정 끝점>
     • (선택)PORTAL_BACKUP_BLOB_ENDPOINT_URL = <사용자 설정 Blob 서비스 URL>
   • IS_PORTAL_PKI_AUTHENTICATED = <true | false>

     포털 접근에 대한 보안을 유지하기 위해 공개 키 인프라(PKI)를 구성한 경우 해당 값을 true로 설정합니다.

     포털 인증 옵션에 대한 자세한 정보

     true로 설정한 경우 다음과 같은 추가 등록정보에 대한 값을 제공합니다.

     • PORTAL_CLIENT_CERTIFICATE_FILE_PATH = <전체 인증 파일 경로>

       포털 PKI 인증의 전체 파일 경로를 PKCS12 형식으로 지정합니다.

     • PORTAL_CLIENT_CERTIFICATE_PASSWORD = <인증 비밀번호>

       PKI 인증에 해당하는 비밀번호를 지정합니다.

     • PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED = false

       인증서 비밀번호의 값을 처음 입력하는 경우에는 해당 값을 false로 그대로 둡니다. 이 값을 저장한 후 처음 도구를 실행하면 도구가 비밀번호를 암호화하고 이 등록정보를 true로 변경합니다.

   이 예시에서는 https://portalhostname.domain.com:7443/arcgis URL의 포털 전체 백업, 호스팅 서버와 페더레이션된 서버의 서비스와 설정, ArcGIS Data Store 관계형 데이터 저장소에 저장된 호스팅 피처 레이어 데이터가 처음에는 \\\\myserver\\tempbackups의 파일로 출력됩니다. 각 파일이 단일 백업 파일(entbackup))로 압축되어 \\mybuserver\\wgbackups에 복사됩니다. INCLUDE_SCENE_TILE_CACHES가 false로 설정되었으므로 ArcGIS Data Store 타일 캐시 데이터 저장소의 씬 레이어 캐시는 포함되지 않습니다.

   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

   이 예시에서는 https://portalonaws.mydomain.com:7443/gis URL의 포털 전체 백업, 해당 콘텐츠 디렉터리(S3 버킷 portalcontent에 저장되어 있음), 포털의 호스팅 서버와 페더레이션된 서버의 서비스와 설정, 관계형 타일 캐시 데이터 저장소에 저장된 데이터가 AWS 리전 eu-west-1의 S3 버킷 entbackups에 출력됩니다. 백업 파일 이름은 fullbackup06June입니다. AWS 계정 접근에는 IAM 역할이 사용됩니다.

   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

   이 예시는 Microsoft Azure Blob 저장소에 대한 것입니다. https://portalonazure.domain.com:7443/arcgis URL의 포털 전체 백업, 해당 콘텐츠 디렉터리, 포털의 호스팅 서버와 페더레이션된 서버의 서비스와 설정, 관계형 타일 캐시 데이터 저장소에 저장된 데이터가 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

3. 등록정보 파일을 저장합니다.

   PORTAL_ADMIN_PASSWORD 값은 파일에서 암호화되며 이 파일을 사용하여 webgisdr 유틸리티를 실행하고 나면 PORTAL_ADMIN_PASSWORD_ENCRYPTED가 true로 설정됩니다.

4. Portal for ArcGIS 머신에서 커맨드 셸을 열고 디렉터리를 webgisdr 유틸리티의 위치로 변경한 후에 내보내기 옵션과 함께 유틸리티를 실행합니다.

   webgisdr 유틸리티는 <Portal for ArcGIS installation directory>/tools/webgisdr에 설치되어 있습니다.

   webgisdr의 구문은 다음과 같습니다.

   webgisdr --{export | import} --file <location and name of properties file>

   앞에서 설명한 것처럼 등록정보 파일(mywebgis.properties)은 사용자가 생성한 디렉터리인 /home/ags/arcgis/portal/propfiles에 저장되었습니다.

   webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties

   백업 파일은 등록정보 파일에 지정한 SHARED_LOCATION 위치에 생성됩니다. 파일 이름은 <timestamp>.webgissite입니다.

5. ArcGIS Enterprise 배포에 맵 서비스 또는 호스팅 타일 레이어 캐시가 포함되어 있는 경우 캐시 타일이 저장되는 모든 디렉터리(예시: C:\arcgisserver\directories\ 또는 <ArcGIS Server installation directory>/arcgis/server/usr/directories 아래의 전체 arcgiscache 디렉터리)의 백업 복사본을 수동으로 만듭니다.

   이러한 디렉터리에는 맵 캐시 타일 및 타일링 스키마 파일 conf.xml이 포함됩니다. 캐시 디렉터리에는 작성된 타일에 대한 정보가 들어 있는 파일 지오데이터베이스 status.gdb도 포함될 수 있습니다.

이 파일을 사용하여 ArcGIS Enterprise를 복원할 수 있습니다.