Skip To Content

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
  • ArcGIS Enterprise 배포의 ArcGIS Data Store 관계형 데이터 저장소에는 지정 시간 복구가 활성화되어 있어야 합니다.

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

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

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

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

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

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

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

      기존:

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

    • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3}

      이 등록정보는 10.5.1에서 새로 도입되었습니다. ArcGIS Enterprise 백업을 온-프레미스의 파일 공유 위치에 저장하기 위해 FileSystem을 지정하면 webgisdr 유틸리티는 BACKUP_LOCATION으로 지정된 파일 공유에 백업 파일을 저장합니다.

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

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

      이 등록정보는 10.5.1에서 새로 도입되었습니다. BACKUP_STORE_PROVIDER = FileSystem으로 설정한 경우, 처음에는 백업 파일이 SHARED_LOCATION에 저장되고 그 다음부터는 BACKUP_LOCATION에 복사됩니다. 이 위치는 백업 파일을 저장할 수 있을 만큼 충분한 공간이 있어야 합니다. 백업 파일이 압축되었더라도 사용하는 데이터의 크기와 유형에 따라 파일 크기가 클 수 있습니다. webgisdr 유틸리티를 실행하는 계정에는 BACKUP_LOCATION에 대한 읽기 및 쓰기 권한이 있어야 합니다.

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

      Portal for ArcGIS 관리자 디렉터리의 URL을 지정합니다. https://portalhostname.domain.com:7443/arcgis 형식으로 입력하며 여기서, portalhostname.domain.comPortal 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로 설정하여 새 관리자 비밀번호를 제공한 후 파일을 저장합니다.

    • INCLUDE_SCENE_TILE_CACHES = <true | false>

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

    • BACKUP_RESTORE_MODE = <full | incremental>

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

      등록정보 파일에서 BACKUP_RESTORE_MODE를 설정하지 않으면 기본 설정에 따라 full 백업이 생성됩니다.

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

      기존:

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

    • ArcGIS Enterprise Cloud Builder for Microsoft Azure가 제공되는 10.5.1부터는 Azure Blob Storage 컨테이너에 포털 콘텐츠 디렉터리를 저장할 수 있습니다. webgisdr 유틸리티를 사용하여 이 배포의 백업을 생성하려면 10.5.1 버전에서 새로 도입된 다음 등록정보를 설정해야 합니다.
      • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Azure Storage 계정>

        PORTAL_BACKUP_BLOB_ACCOUNT_NAMEAzure Blob Storage 계정 이름으로 설정합니다.

        팁:

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

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <계정 키>

        PORTAL_BACKUP_BLOB_ACCOUNT_KEY를 Azure Blob Storage 계정과 연결된 계정 키로 설정합니다.

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false

        PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED 값을 처음 추가하는 경우 falsePORTAL_BACKUP_BLOB_ACCOUNT_KEY로 설정합니다. webgisdr.properties 파일을 저장하면 이 키가 암호화되며 도구가 PORTAL_BACKUP_BLOB_ACCOUNT_KEYtrue로 설정합니다.

      • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <Blob Storage 계정 끝점>

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

      • PORTAL_BACKUP_BLOB_ENDPOINT_URL = <Blob 서비스 URL>

        Blob 서비스 끝점 URL을 지정합니다. 이 URL은 https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name> 형식입니다.

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

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

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

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

      • S3_ENCRYPTED = false

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

      • S3_BUCKET= <S3 버킷의 이름>

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

      • S3_CREDENTIAL_TYPE= <IAMRole | accessKeys

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

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

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

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

    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

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

    BACKUP_STORE_PROVIDER = AmazonS3 SHARED_LOCATION = \\\\myserver\\tempbackups BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackupfile PORTAL_ADMIN_URL = https://portalhostname.mydomain.com:7443/arcgis 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. 등록정보 파일을 저장합니다.

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

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

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

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