ArcGIS Data Store에 설치된 유틸리티는 데이터 스토어를 관리할 수 있는 데이터 스토어 관리자 도구를 제공합니다. 이 페이지에서는 유틸리티를 설명하고 구문과 예시를 제공합니다.
모든 유틸리티는 ArcGIS Data Store 머신에서 실행해야 합니다. 유틸리티는 <ArcGIS Data Store installation directory>\datastore\tools 디렉터리에서 찾을 수 있습니다. 유틸리티는
--help를 붙인 유틸리티 이름을 입력하여 구문 지원을 받을 수 있습니다.
비고:
ArcGIS Data Store 유틸리티를 사용하려면 로그인 시 Windows 관리자 그룹의 구성원이어야 하고 관리자 권한으로 실행 옵션을 사용하여 명령 프롬프트를 열어야 합니다.
allowconnection
이 유틸리티는 관계형 데이터 저장소에 사용됩니다.
보안상, 데이터 저장소에 대한 모든 연결은 기본 설정에 따라 GIS Server 사이트를 통해 이루어집니다. 연결을 위해 추가 머신에서 관계형 데이터 스토어를 열려면 allowconnection 유틸리티를 사용하면 됩니다.
allowconnection 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서만 실행할 수 있습니다.
구문
allowconnection <host name> <username> [<database>]
관계형 데이터 저장소에 연결할 컴퓨터의 이름(호스트 이름), 데이터 저장소에서 사용하는 데이터베이스 계정(istadminusers 또는 listmanageduser 유틸리티를 사용하여 획득할 수 있는 데이터 저장소 관리자, 복사본 소유자, 지오데이터베이스 관리자 또는 관리되는 사용자(피처 레이어 데이터를 발행하는 사용자))(사용자 이름) 중 하나를 지정합니다. 데이터 저장소 데이터베이스가 하나뿐이기 때문에 프라이머리 관계형 데이터 저장소 데이터베이스 이름도 지정할 수 있지만 이 값은 선택 사항입니다.
예시
이 예시에서는 hqo.n_1E7 관리되는 사용자로 연결될 때 workcom 컴퓨터에서 관계형 데이터 저장소로 연결이 허용됩니다.
allowconnection workcom hqo.n_1E7
backupdatastore
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
예약된 백업 시간 사이에 관계형 데이터 저장소 백업을 생성해야 하는 경우 backupdatastore 유틸리티를 사용합니다. 이 유틸리티를 사용하면 데이터 저장소를 많이 변경하거나 업그레이드하기 전에 수동으로 전체 백업을 생성할 수 있습니다.
백업 위치 설정 후 타일 캐시 데이터 저장소에 대해 backupdatastore 유틸리티를 처음으로 실행하면 모든 기존 타일 캐시 데이터 저장소 데이터베이스의 백업 복사본이 작성됩니다. 그 이후부터는 backupdatastore 유틸리티를 사용하면 마지막 유틸리티 실행 이후에 생성된 타일 캐시 데이터 저장소 데이터베이스에 대해 백업 복사본이 생성됩니다.
백업 위치 설정 후 시공간 빅데이터 저장소에 대해 backupdatastore 유틸리티를 처음 실행하면 전체 백업이 생성됩니다. 시공간 빅데이터 저장소는 매우 거대하므로 backupdatastore 유틸리티 후속 사용 시 초기 전체 백업 이후에 변경된 내용만 포함된 백업 파일이 생성됩니다.
backupdatastore 유틸리티는 비디오 서비스 데이터를 위한 객체 스토어의 전체 백업을 생성합니다. 피처 레이어 쿼리 캐시는 백업 파일에 포함되어 있지 않습니다.
backupdatastore 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서 실행할 수 있습니다. 이 유틸리티는 타일 캐시 또는 시공간 빅데이터 저장소의 구성원인 머신에서 실행할 수 있습니다.
어떤 경우든 백업 위치가 백업 파일을 저장할 수 있을 만큼 충분히 커야 합니다. 데이터 저장소 백업 위치를 변경하려면 configurebackuplocation 유틸리티를 사용하세요.
ArcGIS Data Store 백업에 대한 자세한 내용은 데이터 스토어 백업 관리를 참고하세요.
구문
backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <backup_arguments>] [--prompt {yes | no}]
--location 매개변수의 인수는 다음과 같으며 세미콜론(;)으로 구분해야 합니다.
- type= — 유효한 유형은 fs(파일 공유), s3(Amazon Simple Storage Service (S3)버킷), 또는 azure(Microsoft Azure Blob 저장소 컨테이너)입니다.
- name= — 데이터 저장소용으로 구성한 백업 위치에 이름을 지정한 경우 backupdatastore 유틸리티를 실행할 때 이 위치 이름을 사용하여 백업 파일을 생성할 위치를 지정할 수 있습니다.
- location= — 백업 위치 이름을 지정하지 않은 경우 백업 type 및 location을 지정해야 합니다. 파일 공유의 경우 파일 경로를 제공합니다. S3 버킷의 경우 버킷 이름을 입력합니다. Azure Blob 저장소 컨테이너의 경우 컨테이너 이름을 입력합니다.
예시
이 예시에서는 backupdatastore 유틸리티를 사용하여 데이터 스토어용으로 지정한 백업 위치에 project1bu라는 전체 백업 파일이 생성됩니다. 기본 설정에 따라 백업이 관계형 데이터 저장소에 대해 생성되므로 이 예에서는 관계형 데이터 저장소 백업이 생성됩니다.
backupdatastore project1bu You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
다음 예시에서는 백업 위치를 구성할 때 이름을 gadbu로 지정한 파일 공유 위치에 시공간 빅데이터 저장소의 localbu5라는 백업 파일이 생성됩니다.
backupdatastore localbu5 --store spatiotemporal --location name=gadbu You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
다음 예시에서는 blob4backups라는 Azure Blob 저장소 컨테이너에 시공간 빅데이터 저장소의 백업이 생성되며 백업 파일의 이름은 spds311016입니다.
backupdatastore spds311016 --store spatiotemporal --location type=azure;location=blob4backups You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
changebackuplocation
레거시:
Esri 유틸리티는 더 이상 지원하지 않습니다. 이 유틸리티는 기존 스크립트를 계속 사용할 수 있도록 아직 제공됩니다. configurebackuplocation 유틸리티를 사용합니다.
changedatastoremode
이 유틸리티는 관계형 및 시공간 빅데이터 저장소에 사용됩니다.
changedatastoremode 유틸리티를 사용하면 데이터 저장소에 대한 유지 보수가 수행되는 동안 관계형 데이터 저장소를 읽기 전용 모드로 전환할 수 있습니다. 예를 들어 백업 위치를 다른 드라이브로 변경하거나 데이터베이스 등록정보를 변경하는 등의 데이터 저장소를 다시 시작하게 될 유지 보수 작업을 수행해야 하는 경우 데이터 저장소가 다시 시작될 때 데이터를 발행하거나 편집하는 사용자가 존재하지 않도록 관계형 데이터 저장소를 읽기 전용 모드로 전환할 수 있습니다.
또는 changedatastoremode 유틸리티는 유지 보수를 마친 후 또는 프라이머리 데이터 저장소 머신에 충분한 디스크 공간을 추가한 후에 관계형 데이터 저장소를 읽기-쓰기 모드로 다시 전환하여 데이터 저장소가 읽기-쓰기 모드에서 제대로 작동될 수 있도록 하는 데에도 사용됩니다.
changedatastoremode 유틸리티는 스탠바이 머신이 아니라 프라이머리 관계형 데이터 저장소 머신에서 실행해야 합니다.
비고:
디스크 공간이 부족하여 ArcGIS Data Store에서 관계형 데이터 저장소가 읽기 전용 모드로 전환된 경우 자동 백업도 비활성화되어 디스크가 더 소모되지 않도록 합니다. 그러므로 관계형 데이터 저장소를 읽기/쓰기 모드로 재설정한 후에는 updatebackupschedule 유틸리티를 사용하여 자동 백업 일정을 재설정해야 합니다.
ArcGIS Data Store는 시공간 빅데이터 저장소의 디스크 공간이 부족해지면 데이터 손상을 방지하기 위해 읽기 전용 모드로 전환합니다. 시공간 빅데이터 저장소 머신에 충분한 디스크 공간을 추가한 후 changedatastoremode 유틸리티를 사용하여 시공간 빅데이터 저장소를 읽기/쓰기 모드로 되돌릴 수 있습니다.
구문
changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}
예시
다음 예시에서는 관계형 데이터 저장소가 다시 읽기/쓰기 모드로 전환되어 클라이언트가 호스팅 피처 레이어를 ArcGIS Enterprise에 발행하거나 호스팅 피처 레이어를 통해 데이터를 편집하거나 CSV 파일을 Map Viewer에 추가하는 등의 작업을 계속할 수 있습니다.
changedatastoremode readwrite --store relational --prompt no
시공간 빅데이터 저장소를 읽기/쓰기 모드로 설정하려면 다음 예시와 같이 spatiotemporal 옵션과 함께 --store을 지정합니다.
changedatastoremode readwrite --prompt no --store spatiotemporal
changedbproperties
이 유틸리티는 관계형, 타일 캐시, 시공간 빅데이터 저장소에 사용됩니다.
changedbproperties 유틸리티를 사용하면 유틸리티가 실행될 데이터 저장소의 유형에 따라 여러 등록정보를 변경할 수 있습니다.
구문
changedbproperties --store {relational | tileCache | spatiotemporal} [configuration options]
지원되는 구성 옵션은 다음과 같습니다.
- disk-threshold-readonly — 관계형 데이터 저장소에만 사용됩니다.
이 설정은 디스크 공간 부족으로 인한 데이터 손실을 방지하기 위해 관계형 데이터 저장소가 읽기 전용 모드로 전환하게 되는 때를 제어합니다. MB 단위로 크기를 지정하세요. 기본 디스크 공간 값은 1024MB입니다.
- max-connections — 관계형 데이터 저장소에만 사용됩니다.
이 매개변수를 사용하면 관계형 데이터 저장소에 허용되는 최대 연결 수를 지정할 수 있습니다. 기본 설정에 따라 관계형 데이터 저장소에는 최대 150개의 연결이 허용됩니다. --max-connections 등록정보를 changedbproperties 유틸리티에 사용하여 허용 연결 수를 변경할 수 있습니다.
데이터 저장소에 필요한 연결 수를 결정할 때는 ArcGIS Data Store 내부 프로세스가 연결을 5개까지 사용할 수 있음을 고려해야 합니다. 또한 ArcGIS Data Store 머신에서 성능을 계속 유지하며 수용할 수 있는 동시 연결 수도 고려합니다. ArcGIS Data Store 실행 머신의 메모리가 부족하다면 허용 연결 수를 줄여야 할 수 있습니다.
지정된 숫자는 10 이상이어야 합니다. 허용된 최대 연결 수를 변경하면 프라이머리 및 스탠바이 데이터 저장소 머신에도 변경 사항이 적용됩니다. 타일 캐시 데이터 저장소, 시공간 빅데이터 저장소에 대해서는 이 매개변수가 지원되지 않습니다.
- pitr — 관계형 데이터 저장소에만 사용됩니다.
이 설정은 관계형 데이터 저장소를 특정 시점으로 복구할 수 있도록 ArcGIS Data Store에서 관계형 데이터 저장소에 대한 증분 백업을 생성하는지 여부를 나타냅니다. 이 옵션에 사용 가능한 입력은 enable 또는 disable입니다. 지정 시간 복구는 기본 설정에 따라 비활성화되어 있습니다.
비고:
webgisdr 유틸리티를 사용하여 ArcGIS Enterprise 배포의 증분 백업을 생성할 경우 지정 시간 복구를 활성화해야 합니다.
- enablessl — 관계형 타일 캐시 데이터 저장소에만 사용됩니다.
이 매개변수는 타일 캐시 데이터 저장소를 채울 때와 관계형 데이터 저장소 및 호스팅 서버 간의 통신을 위한 전송 계층 보안(TLS) 프로토콜 사용 여부를 제어합니다.
enablessl 매개변수에 지원되는 인수는 다음과 같습니다.
- true — 해당 옵션이 기본 설정입니다. 즉, --store tileCache를 지정할 때 씬 레이어 데이터를 타일 캐시 데이터 저장소에 작성하는 경우와 --store relational를 지정할 때 관계형 데이터 저장소와 호스팅 서버 간에 통신하는 경우 전송 레이어 보안 프로토콜이 사용됩니다.
- false — 데이터를 타일 캐시 데이터 저장소에 작성할 때 호스팅 서버의 HTTP 통신을 사용하려면 false 및 --store tileCache를 지정합니다. 호스팅 서버 및 관계형 데이터 저장소 간에 HTTP 통신을 사용하려면 false 및 --store relational을 지정합니다.
- heap-size — 시공간 빅데이터 저장소에만 사용됩니다.
이 매개변수를 사용하면 시공간 빅데이터 저장소에서 사용되는 힙 메모리(MB)의 양을 변경할 수 있습니다. 기본 설정에 따라 이 유형의 데이터 저장소는 시작될 때 머신의 RAM 절반(사용 가능한 RAM의 최대 70%)을 사용합니다. 힙 크기는 512MB~32,000MB에서 변경할 수 있지만 지정한 양이 머신에서 사용 가능한 양을 초과하지 않아야 합니다.
- rebalance — 시공간 빅데이터 저장소에만 사용됩니다.
기본 설정에 따라 이 매개변수는 true로 설정되며 사용 가능한 머신이 없는 경우 시공간 빅데이터 저장소의 데이터가 다른 머신에 분산됩니다. 시공간 빅데이터 저장소 머신에 업그레이드 등의 유지 보수 작업을 수행해야 할 경우에는 이 매개변수를 false로 설정하여 리밸런스를 일시적으로 멈출 수 있습니다. max-rebalance-off 매개변수에 설정한 시간 동안 리밸런스 옵션이 일시 중지됩니다.
- max-rebalance-off — 시공간 빅데이터 저장소에만 사용됩니다.
rebalance 매개변수를 false로 설정하면 이 매개변수의 설정이 사용됩니다. 기본 설정에 따라 max-rebalance-off는 60분으로 설정됩니다. 즉, 리밸런스를 일시적으로 중지한 경우 60분 후에 다시 시작됩니다. 이 설정 값이 리밸런스를 일시 중지해야 하는 유지 관리 작업의 수행 시간보다 많거나 적은 경우에는 max-rebalance-off의 시간 설정을 변경합니다.
- prompt — 이 유틸리티를 실행하면 지정한 작업을 확인하라는 메시지가 나타납니다. 확인 메시지 없이 이 유틸리티가 자동으로 사용되도록 하려면 prompt 매개변수를 no로 설정합니다. 그렇지 않으면 확인 메시지에 응답할 때까지 스크립트가 진행되지 않습니다.
예시
다음 섹션에는 changedbproperties 유틸리티에서 사용할 수 있는 옵션을 사용하는 예시가 포함되어 있습니다.
관계형 데이터 저장소에 대한 읽기 전용 임계치 변경
기본 설정에 따라 관계형 데이터 저장소는 사용 가능한 디스크 공간이 1,024MB 이하가 되면 읽기 전용 모드로 설정됩니다. 다음 예시에서는 머신에 쓰는 다른 앱이 있으므로 관리자는 관계형 데이터 저장소를 더 빨리 읽기 전용 모드로 설정하도록 구성합니다. 머신의 사용 가능한 디스크 공간이 4,000MB 이하인 경우:
changedbproperties --store relational --disk-threshold-readonly 4000
You are changing the following database properties:
...disk space threshold to change relational data store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes관계형 데이터 저장소에 허용된 연결 수 변경
이 예시에서는 관계형 데이터 저장소에 허용되는 최대 연결의 수가 100으로 설정됩니다.
changedbproperties --store relational --max-connections 100
You are changing the following database properties:
...max number of connections to 100 (on all relational data store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes관계형 데이터 저장소에 대한 지정 시간 복구 활성화
지정 시간 복구는 기본 설정에 따라 비활성화되어 있습니다. 이 예시에서 지정 시간 복구는 관계형 데이터 저장소에 대해 활성화됩니다.
changedbproperties --store relational --pitr enable
You are changing the following database properties:
...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesSSL 비활성화
기본 설정에 따라 관계형 데이터 저장소는 HTTPS를 통해 호스팅 서버와 통신합니다. 이 예시에서 enablessl 매개변수는 HTTP를 통해 호스팅 서버와 통신하도록 관계형 데이터 저장소를 구성하는 데 사용됩니다.
changedbproperties --store relational --enablessl false
You are changing the following database properties:
...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes시공간 빅데이터 저장소의 힙 크기 변경
기본 설정에 따라 시공간 빅데이터 저장소는 시작될 때 머신의 RAM 절반(사용 가능한 RAM의 70%)을 사용합니다. 힙 크기를 줄이면 데이터 저장소가 시작되지 않을 수 있습니다. 힙 크기를 늘리는 경우 머신에서 사용 가능한 RAM 양을 초과하는 숫자를 지정하지 마세요.
이 예시에서 힙 크기는 1,600MB로 설정됩니다.
changedbproperties --store spatiotemporal --heap-size 1600
You are changing the following database properties:
...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes시공간 빅데이터 저장소에 대한 리밸런스 일시 중지
이 예시에서 관리자는 시공간 빅데이터 저장소의 머신 하나에서 간단한 유지관리 절차를 수행해야 하며 데이터 저장소 리밸런스를 원하지 않습니다. 이를 수행하려면 rebalance 및 max-rebalance-off 옵션을 사용하여 리밸런스를 30분 동안 일시 중지합니다. 30분이 지나면 시공간 빅데이터 저장소가 rebalance를 true로 자동 변경합니다.
이는 주기적으로 수행되어야 하므로 관리자는 다음 문을 스크립트에 보관하고 프롬프트 옵션을 no로 설정합니다.
changedbproperties --store spatiotemporal --rebalance false --prompt no changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no
changeloglocation
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
데이터 저장소가 <ArcGIS Data Store directory>\arcgisdatastore\logs의 기본 오류 로그 파일 위치를 사용하지 않게 하려면, changeloglocation 유틸리티를 실행하여 다른 디렉터리에 오류 로그 파일을 생성하면 됩니다.
ArcGIS Data Store 계정은 지정한 폴더에 대한 쓰기 권한이 있어야 합니다.
구문
changeloglocation <directory path>
예시
이 예시에서 로그 파일은 로컬 디렉터리인 d:\datastorefiles\logs에 생성됩니다.
changeloglocation 'd:\datastorefiles\logs'
changenosqldslocation
이 유틸리티는 타일 캐시 데이터 저장소에 사용됩니다.
타일 캐시 데이터 저장소는 고해상도 타일을 대량 저장하는 경우 크기가 커질 수 있습니다. 이 경우 데이터를 같은 서버의 다른 드라이브나 다른 서버의 공유 위치로 이동하려고 할 수 있습니다.
데이터를 공유 디렉터리로 이동하는 경우 ArcGIS Data Store 프로세스(Linux) 또는 서비스(Microsoft Windows)를 실행하는 사용자에게 디렉터리에 대한 읽기 및 쓰기 권한을 부여해야 합니다.
구문
changenosqldslocation <path> [--prompt {yes | no}]
예시
이 예시에서는 씬 레이어 캐시가 저장되는 데이터베이스가 머신 server2의 dstorecache라는 공유 디렉터리에 생성됩니다.
changenosqldslocation \\server2\dstorecache
changepassword
이 유틸리티는 관계형 데이터 저장소에 사용됩니다.
ArcGIS Data Store는 관계형 데이터 저장소에 사용되는 데이터베이스 계정에 대해 사용자 이름과 비밀번호를 임의로 생성합니다. 사이트에 고유한 비밀번호를 설정해야 하는 경우 데이터 저장소 계정의 비밀번호를 획득하고 비밀번호 변경을 실행하여 비밀번호를 재설정합니다.
listadminusers 유틸리티를 사용하면 관리자의 사용자 이름과 비밀번호를 구할 수 있으며 listmanageduser 유틸리티를 사용하면 피처 데이터 소유자의 사용자 이름과 비밀번호를 구할 수 있습니다.
changepassword 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서만 실행할 수 있습니다.
구문
changepassword <username> <new password> [--prompt {yes | no}]
팁:
비밀번호 변경 내용을 스크립팅해야 한다면 다음 예시에서와 같이 확인 프롬프트를 숨기는 플래그를 포함시킵니다.
changepassword gwi_n2Te0 Phfl4mp --prompt no
예시
이 예시에서는 사용자 gwi_n2Te0 to Phfl4mp!의 비밀번호가 변경됩니다.
changepassword gwi_n2Te0 Phfl4mp You are going to change the password for user gwi_n2Te0. Do you want to continue (Yes or No)?Yes
changestaginglocation
이 유틸리티는 관계형 타일 캐시 데이터 스토어 및 그래프 스토어에 사용됩니다.
관계형 데이터 저장소 또는 타일 캐시 저장소를 복원할 때 ArcGIS Data Store가 스테이징 위치의 압축된 백업 파일을 추출합니다. 즉, 압축 해제한 이 데이터를 수용할 수 있는 스테이징 위치가 있어야 합니다. 관계형 또는 타일 캐시 데이터 저장소에 많은 데이터가 있으면 별도의 스테이징 위치를 설정해 복구용으로 지정합니다.
마찬가지로, configurebackuplocation 유틸리티를 사용하여 관계형, 타일 캐시 또는 그래프 스토어 백업 파일에 대한 S3 버킷이나 Azure Blob 스토리지 컨테이너를 정의하는 경우 스테이징 위치는 백업 파일을 클라우드 스토리지 위치에 복사하기 전에 패키징하는 데 사용됩니다.
구문
changestaginglocation <directory path>
예시
이 예시에서는 지정된 스테이징 위치가 \\netserver\rbustage입니다.
changestaginglocation \\netserver\rbustage
configurebackuplocation
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
configurebackuplocation 유틸리티를 사용하면 ArcGIS Data Store에서 예약된 백업과 backupdatastore 유틸리티로 생성된 백업 둘 다의 백업 파일이 생성되는 위치를 지정할 수 있습니다. 또한 configurebackuplocation 유틸리티를 사용하여 백업 위치의 등록정보를 변경하고 백업 위치를 제거할 수 있습니다.
관계형 데이터 저장소는 기본 로컬 백업 위치를 사용하여 생성됩니다. 데이터 손실을 방지하기 위해 change 옵션을 사용하여 원격 파일 공유를 등록함으로써 기본 백업 위치를 구성할 수 있습니다.
프라이머리-스탠바이 모드로 생성된 타일 캐시 데이터 저장소부터는 기본 백업 위치를 구성할 수 있는 반면,군집 모드로 생성된 타일 캐시 데이터 저장소는 기본 백업 위치를 구성할 수 없습니다. 두 경우 모두 register 옵션과 함께 configurebackupplocation 유틸리티를 사용하여 공유 네트워크 위치, Amazon Simple Storage Service (S3) 버킷 또는 Microsoft Azure Blob Storage 컨테이너를 지정함으로써 타일 캐시 데이터 저장소 백업을 안전하게 저장할 수 있습니다. 데이터 저장소가 군집 모드로 실행 중인 경우에는 타일 캐시 백업 파일에 로컬 드라이브를 사용할 수 없습니다.
시공간 빅데이터 스토어, 그래프 스토어, 객체 스토어는 기본 백업 위치를 사용하여 생성되지 않습니다. 백업 생성을 시작하려면 먼저 register 옵션으로 configurebackuplocation 유틸리티를 실행하여 이러한 백업에 대한 파일 공유 위치, Amazon Simple Storage Service (S3) 버킷 또는 Microsoft Azure Blob 저장소 컨테이너를 지정해야 합니다.
비고:
시공간 빅데이터 저장소 백업 파일에는 로컬 드라이브를 사용할 수 없습니다.
backupdatastore 유틸리티로 생성한 백업이 저장될 두 번째 백업 위치를 등록할 수 있습니다. 공유 파일 디렉터리, S3 버킷, Azure Blob 저장소 컨테이너를 두 번째 백업 위치로 사용할 수 있습니다.
ArcGIS Data Store 백업에 대한 자세한 내용은 데이터 스토어 백업 관리를 참고하세요.
구문
configurebackuplocation --store {relational | tileCache | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]
필수 옵션은 다음과 같습니다.
- --store {relational | tileCache | spatiotemporal | graph | object} — 백업 위치를 구성 또는 쿼리할 ArcGIS Data Store의 유형을 지정합니다. 기본값은 relational입니다.
- --operation {change | register | unregister | list | setdefault} — 기본값은 change입니다 다음은 각 인수에 대한 설명입니다.
- change — 해당 인수를 사용하여 다음을 변경할 수 있습니다.
- 예약된 관계형 데이터 저장소 백업에 대해 다른 공유 파일 위치를 지정합니다. change 인수로 설정된 위치는 항상 관계형 데이터 스토어에 대한 기본 백업 위치입니다.
- 백업 위치에 할당된 이름을 변경합니다.
- Azure 또는 S3의 백업 위치에 대해 설정한 인증 정보를 업데이트합니다. S3의 경우 이전에 username 및 password 옵션으로 지정한 정보를 변경할 수 있습니다. Azure의 경우에는 password 값을 변경할 수 있습니다.
- register — 백업 위치를 등록하는 데 해당 인수를 사용합니다. 시공간 빅데이터 저장소, 그래프 저장소 또는 클러스터 모드에서 실행되는 타일 캐시 데이터 저장소에 대해 정의한 첫 번째 백업 위치가 기본 백업 위치로 설정됩니다. 타일 캐시 데이터 스토어(프라이머리-스탠바이 또는 클러스터 모드), 시공간 빅데이터 스토어 또는 그래프 스토어의 다른 백업 위치를 등록하면 두 번째 백업 위치가 등록됩니다.
관계형 데이터 스토어에 대해 register 인수를 지정하는 경우 항상 두 번째 백업 위치가 등록됩니다. 두 번째 백업 위치는 backupdatastore 유틸리티로 생성된 수동 백업을 저장하는 데 사용할 수 있습니다.
비고:
register 인수를 사용할 때는 --location 옵션에 대한 정보를 제공해야 합니다.
- unregister — 데이터 스토어에서 두 번째 백업 위치를 제거하는 데 해당 인수를 사용합니다. 백업 위치가 하나만 등록된 경우에는 타일 캐시, 시공간 빅데이터 스토어 또는 그래프 스토어의 백업 위치를 완전히 제거하는 데 등록 해제 인수를 사용할 수 있습니다.
- list — --store 옵션으로 지정하는 데이터 스토어용으로 등록된 모든 백업 위치를 나열합니다. 해당 목록은 물리적인 백업 위치, 백업 위치의 이름(위치를 등록할 때 이름을 지정한 경우), 기본 백업 위치로 등록된 항목을 나타냅니다.
- setdefault — 그래프 스토어, 타일 캐시 데이터 스토어 또는 시공간 빅데이터 스토어용 백업 위치가 여러 개인 경우 setdefault를 사용하여 백업 위치 중 하나를 기본 위치로 지정할 수 있습니다. 해당 위치는 예약된 백업이 기록되는 위치이며, 백업 위치를 지정하지 않고 backupdatastore, listbackups 또는 restoredatastore 유틸리티를 실행하는 경우에 사용되는 기본 위치입니다.
- change — 해당 인수를 사용하여 다음을 변경할 수 있습니다.
백업 위치를 등록하거나 변경할 때, ArcGIS Data Store가 백업 파일을 저장할 위치를 지정하려면 --location 옵션을 사용합니다. 백업 이름을 구성하지 않은 경우, 기본 백업 위치를 설정하거나 백업 위치를 제거할 때 --location 옵션을 사용합니다.
타일 캐시 데이터 스토어 또는 시공간 빅데이터 스토어의 경우, 또는 관계형 데이터 스토어의 두 번째 백업 위치를 등록하려는 경우 세미콜론(;)으로 구분된 --location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>]" 인수를 지정합니다.
--location 옵션이 지원되는 각각의 인수에 대한 설명이 다음 목록에 나와 있습니다.
- type= — 해당 인수는 필수입니다. 백업에 사용할 위치 유형을 지정합니다. Amazon S3 버킷에 백업을 저장하려면 azure, Azure Blob 저장소 컨테이너에 백업을 저장하려면 fs, 파일 공유(기본값)에 백업을 저장하려면 s3를 지정합니다.
- location= — 해당 인수는 필수입니다. 파일 공유의 경우 파일 경로를 지정합니다. Amazon S3 버킷의 경우 버킷 이름 및 버킷 경로를 지정합니다. Blob 스토리지 컨테이너의 경우 컨테이너 이름 및 컨테이너 경로를 지정합니다.
- name= — 백업 위치에 이름을 지정할 수 있습니다. 예를 들어 백업 위치가 \\sharedserver_sharedfolders_datastorebackups와 같은 파일 경로인 경우 이 위치의 이름을 dsbackups와 같이 지정할 수 있습니다. backupdatastore, listbackups 또는 restoredatastore 유틸리티를 실행하는 경우 전체 경로 대신 해당 이름을 입력합니다.
데이터 저장소 백업 위치를 구성할 때 이름을 제공하지 않으면 ArcGIS Data Store에서 기본 이름을 지정합니다.
- username= — 백업 위치가 S3 버킷 또는 Blob 스토리지 컨테이너인 경우에 해당 인수가 필요합니다. S3 버킷의 경우 Amazon Web Services (AWS) 계정에 대한 접근 키 ID를 입력합니다. Azure Blob 저장소 컨테이너의 경우 Blob 저장소 컨테이너에 접근할 수 있는 Microsoft Azure 저장소 계정의 이름을 입력합니다.
- password= — 백업 위치가 S3 버킷 또는 Blob 스토리지 컨테이너인 경우에 해당 인수가 필요합니다. S3 버킷의 경우 AWS 계정에 대한 비밀번호 키를 입력합니다. Azure Blob 저장소 컨테이너의 경우 Azure 인수를 사용하여 지정한 username 계정의 비밀번호를 입력합니다.
- endpointsuffix= — 해당 인수를 사용하면 Azure Blob 스토리지 컨테이너가 있는 위치를 나타낼 수 있습니다. 기본 설정에 따라 endpointsuffix는 core.windows.net으로 간주합니다. 컨테이너가 Microsoft Azure 정부 클라우드 환경에 있는 경우 endpointsuffix=core.usgovcloudapi.net를 설정합니다. 컨테이너가 프라이빗 클라우드에 있는 경우 endpointsuffix를 Azure 프라이빗 클라우드의 EndpointSuffix로 설정합니다. 해당 인수는 Azure Blob 스토리지 컨테이너에 백업을 저장하는 경우에만 사용됩니다.
- region= — 백업 위치가 S3 버킷인 경우에 해당 인수가 필요합니다. 지역 코드를 제공해야 합니다. 예를 들어, 버킷이 아시아 태평양(시드니) 지역에 배포된 경우 지역을 ap-southeast-2로 설정합니다. 지역 코드에 대해서는 AWS 문서를 참고하세요.
configurebackuplocation 유틸리티를 사용하여 다음과 같은 옵션을 추가로 제공할 수 있습니다.
- --force {true | false} — 해당 옵션은 관계형 데이터 저장소에만 사용되며 이 옵션을 사용하면 기존 기본 백업 위치에 접근할 수 없더라도 기본 백업 위치를 변경할 수 있습니다.
관계형 데이터 저장소의 기본 백업 위치를 변경하는 경우 ArcGIS Data Store가 이전 위치에 있는 기존 백업 파일을 새 위치로 복사합니다. ArcGIS Data Store가 이전 위치에 접근할 수 없다면 파일을 복사할 수 없습니다. 이전 릴리스에서는 이 경우에 configurebackuplocation 도구가 실패했습니다. 기존 백업 파일을 복사하지 않고 기본 백업 위치 변경을 진행하려면 --force true를 지정합니다.
해당 옵션의 기본값은 false로, ArcGIS Data Store가 기존 기본 위치에 접근할 수 없는 경우에는 기본 백업 위치를 변경할 수 없음을 의미합니다.
- --prompt {yes | no} — 기본값은 yes입니다
예시
다음 섹션에서는 데이터 저장소의 백업 위치를 변경, 설정 또는 나열하는 예시를 제공합니다.
관계형 데이터 저장소의 기본 백업 위치 변경
다음의 예시에서는 관계형 데이터 저장소의 백업 위치가 myshare 머신의 fsdata_bu 디렉터리로 설정됩니다.
configurebackuplocation --operation change --store relational --location "type=fs;location=\\myshare\fsdata_bu" You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
관계형 데이터 저장소의 백업 위치 추가
해당 예시에서는 Azure의 두 번째 백업 위치가 동일한 관계형 데이터 저장소용으로 등록됩니다.
configurebackuplocation --operation register --store relational --location "type=azure;location=mybackups; name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount" You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
그래프 저장소의 백업 위치 설정
이 예시에서는 그래프 저장소용으로 네트워크 공유의 백업 위치가 등록됩니다. fshare라는 이름이 백업 위치에 지정됩니다.
configurebackuplocation --operation register --store graph --location "type=fs;location=\\sharedmachine\g_bu;name=fshare"
백업 위치 추가 및 기본 위치 설정
해당 예시에서는 두 번째 백업 위치가 시공간 빅데이터 저장소용으로 지정됩니다. 추가 백업 위치는 Azure 저장소에 있습니다.
configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs; name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount"
해당 예시에서는 유럽(스페인) 지역에 있는 AWS의 두 번째 백업 위치가 동일한 시공간 빅데이터 스토어용으로 지정됩니다. awsloc라는 이름이 백업 위치에 지정됩니다.
configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc; username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2"
이 예시에서는 백업 위치 이름(awsloc)을 사용하여 S3 버킷이 시공간 빅데이터 저장소의 기본 백업 위치로 설정됩니다.
configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc"
데이터 저장소의 모든 백업 위치 목록 가져오기
이 예시에서는 시공간 빅데이터 저장소의 모든 백업 위치가 나열됩니다.
configurebackuplocation --operation list --store spatiotemporal Backup locations for spatiotemporal big data store: ================================================================ Name Type Location isDefault ================================================================ fsshare fs \\sharedmachine\ge_bu false awsloc s3 mybucket true mazloc azure myblobs false
configuredatastore
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
ArcGIS Data Store를 설치한 후, configuredatastore 유틸리티를 실행하여 데이터 저장소를 생성하고 GIS Server 사이트에 등록할 수 있습니다. 이 유틸리티를 사용하여 다음과 같은 유형의 데이터 스토어를 생성할 수 있습니다.
또한 데이터 저장소의 모든 머신에서 ArcGIS Data Store 소프트웨어를 업데이트한 후 configuredatastore 유틸리티를 실행하여 데이터 저장소를 업그레이드할 수 있습니다.
구문
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | graph | object}] [--mode {singleInstance | primaryStandby | cluster}]
- <ArcGIS Server admin URL> — ArcGIS Enterprise 호스팅 서버로 사용되고 있거나 사용될 GIS Server 사이트입니다. ArcGIS Server 관리자 URL은 https://gisserver.domain.com:6443 형식입니다
비고:
GIS Server 사이트가 웹 어댑터 또는 로드 밸런서를 사용하는 경우에도 앞에서 언급한 형식의 URL을 제공해야 합니다.
- <ArcGIS Server administrator> — GIS Server 사이트에 Administrator 권한이 있는 빌트인 사용자(기관별 사용자 아님)에 대한 사용자 이름을 제공합니다.
- <ArcGIS Server administrator password> — 위에서 사용된 계정의 비밀번호를 입력합니다.
- <data directory> — 데이터 디렉터리는 데이터 저장소 파일을 생성할 로컬 머신의 위치입니다.
- {relational | tileCache | spatiotemporal | graph | object} — 생성할 데이터 저장소의 유형을 지정합니다. 여러 유형의 데이터 저장소를 공백 없이 쉼표로 분리해 지정하여 동일한 머신에 데이터 저장소를 둘 이상 구성할 수 있지만 권장되지는 않습니다. 예를 들어 공유 데이터 저장소 디렉터리가 있는 동일한 머신에 관계형 타일 캐시 데이터 저장소를 모두 구성하려면 --stores relational,tileCache를 지정합니다. 하지만 Esri에서는 시공간 빅데이터 저장소 및 그래프 저장소를 다른 데이터 저장소 또는 소프트웨어 머신과는 별도의 머신에서 실행하도록 권장합니다. 그렇지 않으면 성능이 저하되거나 데이터 저장소를 사용할 수 없게 될 수 있습니다.
- --mode — 이 선택 옵션은 타일 캐시 데이터 스토어, 객체 스토어, 그래프 스토어에만 적용됩니다. 기본 설정에 따라 타일 캐시 데이터 스토어, 그래프 스토어, 객체 스토어는 primaryStandby 모드에서 생성됩니다.
primaryStandby 모드에서 생성된 타일 캐시 데이터 저장소에는 두 대의 머신을 포함할 수 있습니다. 스탠바이 타일 캐시 데이터 저장소에는 프라이머리와 같은 데이터가 포함되어 있습니다. 프라이머리 데이터 저장소가 실패하면 스탠바이가 프라이머리 타일 캐시 데이터 저장소로 사용됩니다. 많은 씬 레이어 캐시를 저장하기 위해 3대 이상의 머신이 포함되도록 타일 캐시 데이터 스토어를 확장해야 하는 경우, 타일 캐시 데이터 스토어를 cluster 모드로 생성합니다. 모드 옵션을 사용하여 타일 캐시 데이터 스토어를 primaryStandby 모드에서 클러스터 모드로 전환할 수 있습니다.
primaryStandby 모드에서 생성된 객체 저장소는 현재 하나의 머신만 포함할 수 있습니다. 고가용성을 제공하기 위해 객체 저장소에 여러 머신이 필요한 경우 클러스터 모드에서 객체 저장소를 배포합니다. 클러스터 모드에서 사용되는 경우 객체 저장소에는 3대 이상의 머신이 포함되어야 합니다. 자세한 내용은 데이터 저장소에 머신 추가를 참고하세요.
특정 유형의 데이터 저장소 구성
생성할 데이터 저장소의 유형은 --stores 옵션에 다음 설정을 사용하여 지정할 수 있습니다.
- relational
- tileCache
- spatiotemporal
- graph
- object
동일한 머신에 데이터 저장소 유형을 2개 이상 구성하려면 각 유형을 쉼표로 구분합니다. 예를 들어 동일한 머신에 관계형 타일 캐시 데이터 저장소를 구성하려면 --stores relational,tileCache를 지정합니다.
비고:
동일한 머신에 구성된 데이터 저장소는 메모리 및 기타 리소스를 놓고 경쟁할 수 있습니다. 이는 성능에 부정적인 영향을 주고 데이터 저장소의 작동을 중지시킬 수 있습니다. 특히 시공간 빅데이터 저장소, 그래프 저장소, 객체 저장소의 경우에 그러한 영향을 주므로 시공간 빅데이터 저장소, 그래프 저장소 또는 객체 저장소는 다른 데이터 저장소나 기타 ArcGIS 컴포넌트와 동일한 머신에 구성하지 마세요.
여러 시공간 빅데이터 저장소 머신 생성을 스크립팅하는 경우 GIS Server 사이트에 하나의 시공간 빅데이터 저장소 머신을 수동으로 구성해야 추가 시공간 빅데이터 저장소 머신 생성을 스크립팅할 수 있습니다. 스크립트에 대기 시간을 포함시켜 추가 시공간 빅데이터 저장소 머신이 동시에 추가되지 않도록 해야 합니다.
자세한 내용은 데이터 저장소 생성을 참고하세요.
ArcGIS Data Store 설치를 업데이트한 후 데이터 저장소 구성
ArcGIS Data Store 업그레이드의 일부로 기존 데이터 저장소 머신을 다시 구성해야 합니다. 모든 데이터 저장소 머신에서 기존 ArcGIS Data Store 위에 새 버전의 ArcGIS Data Store를 설치한 후 임의 데이터 저장소 머신에 로그인하고 configuredatastore 유틸리티를 실행하여 해당 데이터 저장소 업그레이드를 완료할 수 있습니다. 예를 들어 프라이머리 관계형 데이터 저장소 머신에서 configuredatastore 유틸리티를 실행하면 스탠바이 머신도 업그레이드됩니다.
머신에 관계형 타일 캐시 데이터 저장소가 포함된 경우에는 configuredatastore 유틸리티를 실행할 때 --stores relational,tileCache를 지정합니다. 그러면 데이터 저장소의 머신이 모두 업데이트됩니다.
업데이트된 시공간 빅데이터 저장소 머신을 다시 구성하려면 시공간 빅데이터 저장소에 있는 머신 중 하나에 로그온하여 configuredatastore 유틸리티를 실행합니다. 그러면 시공간 빅데이터 저장소의 모든 머신이 업데이트됩니다.
일부 머신에 새 버전의 ArcGIS Data Store를 설치하지 않은 경우에는 구성을 계속할 수 없습니다.
자세한 내용은 ArcGIS Data Store 업그레이드를 참고하세요.
타일 캐시 데이터 스토어 모드 변경
타일 캐시 데이터 저장소에 설정된 현재 모드를 확인하려면 타일 캐시 데이터 저장소 머신에서 describedatastore 유틸리티를 실행합니다.
타일 캐시 데이터 스토어 모드를 primaryStandby에서 클러스터 모드로 변경해야 하는 경우 --mode 옵션을 cluster로 설정하여 configuredatastore 유틸리티를 실행합니다.
비고:
--mode 옵션을 사용하면 데이터 스토어를 생성할 때 타일 캐시 데이터 스토어, 객체 스토어 또는 그래프 스토어 모드를 지정하거나 타일 캐시 데이터 스토어의 모드를 primaryStandby에서 클러스터 모드로 변경할 수 있지만, 타일 캐시 데이터 스토어를 업그레이드할 때는 모드를 변경할 수 없으며 타일 캐시 데이터 스토어 모드를 클러스터에서 primaryStandby로 변경할 수 없고 객체 스토어 또는 그래프 스토어의 모드를 변경할 수 없습니다.
예시
이 예시에서는 호스팅 피처 레이어 데이터용 데이터 저장소(관계형 데이터 저장소)가 생성됩니다. 이 데이터 저장소가 사용될 GIS Server 사이트의 URL은 https://gisserver.domain.com:6443, 사이트 관리자의 사용자 이름은 admin, 비밀번호는 Iph33l$ik이며 데이터 저장소의 데이터 디렉터리는 C:\datastore\data\입니다.
configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\data\ --stores relational
다음 예시에서는 기존 타일 캐시 데이터 저장소(프라이머리-스탠바이)가 클러스터 모드로 변경됩니다.
configuredatastore https://gisserver.mydomain.com:6443 portaladmin S00perSecret c:\datastore\scenedata\ --stores tileCache --mode cluster
configureserviceaccount
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
configureserviceaccount 유틸리티는 ArcGIS Data Store 계정에 사용되는 로그인을 변경합니다. 이 유틸리티를 사용하여 계정을 설정할 때 계정 정보를 파일로 내보낼 수 있습니다. 비밀번호는 파일에서 암호화됩니다. 다른 ArcGIS Data Store를 설정하고 동일한 계정을 사용하려는 등의 경우에 이 파일을 사용하여 동일한 계정 정보를 가져올 수 있습니다. 이 경우 새 머신에서 configureserviceaccount 유틸리티를 실행하여 계정 정보가 포함되어 있는 파일을 가져옵니다.
이 유틸리티를 사용하여 ArcGIS Data Store 계정의 비밀번호를 업데이트할 수도 있습니다. Windows 계정의 비밀번호가 변경된 경우 이 유틸리티를 실행하여 기존 계정에 새 비밀번호를 지정합니다.
ArcGIS Data Store 계정을 그룹 관리 서비스 계정으로 설정하는 경우 사용자 이름 매개변수를 이용해 지정한 계정은 계정 이름 끝에 $를 붙이거나 생략할 수 있습니다. 그룹 관리 서비스 계정을 사용할 때는 비밀번호 매개변수를 지정할 필요가 없습니다.
구문
configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]
예시
이 예시에서 configureserviceaccount는 mynetwork\datastore 계정이 ArcGIS Data Store 서비스를 실행하도록 설정하고 ArcGIS Data Store 시스템 폴더 및 파일에 필요한 권한을 이 계정에 부여합니다.
configureserviceaccount --username mynetwork\datastore --password SewL0ng
이 예시에서는 ArcGIS Data Store 계정에 그룹 관리 서비스 계정을 사용합니다.
configureserviceaccount --username mydomain\datastore-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml
서비스 실행 계정을 변경하면 서비스가 다시 시작됩니다.
이 예시에서는 ArcGIS Data Store 계정이 변경되며 계정 정보가 C:\adminfiles의 파일(adsainfo)에 기록됩니다.
configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo.xml
이 예시에서는 ArcGIS Data Store가 다른 머신에 설치되며 관리자가 이전 예시에서 생성된 파일로 configureserviceaccount 유틸리티를 실행하여 동일한 계정을 설정합니다.
configureserviceaccount --readconfig C:\adminfiles\adsainfo
deletebackup
해당 유틸리티는 관계형 데이터 스토어 및 객체 스토어에 사용됩니다.
deletebackup 유틸리티를 사용하면 관계형 데이터 스토어 또는 객체 스토어에 대해 생성한 백업 파일을 삭제할 수 있습니다. 먼저 --operation 옵션을 list(으)로 설정해 configurebackuplocation 유틸리티를 실행하여 데이터 스토어에 대해 구성된 모든 백업 위치의 목록을 가져옵니다. 다음으로, 한 위치에서 listbackups 유틸리티를 실행하여 해당 위치에 있는 백업의 이름과 생성 시간을 확인합니다. 모든 백업 위치에 대해 해당 단계를 반복합니다. 그런 다음 deletebackup 유틸리티를 실행하여 더 이상 필요 없는 백업 파일을 삭제할 수 있습니다. 백업 파일을 삭제하려는 각 위치에 대해 deletebackup을 별도로 실행해야 합니다.
비고:
데이터 스토어를 복구하는 데 필요하지 않은 백업만 삭제할 수 있습니다. 예를 들어 관계형 데이터 저장소의 최근 전체 백업은 삭제할 수 없습니다.
구문
deletebackup <backup name> [--store {relational | object}] [--location "<backup-location>"] [--prompt {yes | no}]
예시
해당 예시에서는 기본 백업 위치에서 featuresMarchbu라는 관계형 데이터 스토어가 삭제되었습니다.
deletebackup featuresMarchbu --store relational You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
해당 예시에서는 videobucket이라는 백업 위치에서 객체 스토어의 june-videobu가 삭제되었습니다.
deletebackup june-videobu --store object -- location "videobucket" You are attempting to delete backup 'june-videobu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
describedatastore 유틸리티를 사용하면 ArcGIS Data Store 설치에 대한 다음과 같은 정보를 볼 수 있습니다.
- 머신에 설치된 데이터 스토어의 유형(사용 가능한 ArcGIS Data Store에 나열되어 있음)
비고:
머신에 데이터 스토어가 설치되어 있지만 구성되지 않은 경우, 사용할 수 있는 ArcGIS Data Store로 표시되지만 해당 데이터 스토어 유형에 대해 추가 정보가 반환되지 않습니다.
- 설치된 ArcGIS Data Store의 소프트웨어 릴리스 번호
- 데이터 복원을 위해 데이터 저장소에서 사용되는 스테이징 위치
- 데이터 저장소의 로그 파일 위치
- ArcGIS Data Store가 설치된 머신에 남아 있는 사용 가능한 디스크 공간
- 관계형 및 시공간 빅데이터 저장소가 읽기 전용 모드로 전환되고 타일 캐시 데이터 저장소가 중지될 자유 디스크 공간 임계치
- 데이터 스토어 유형별로 사용된 기본 백업 위치
- 관계형 타일 캐시 데이터 저장소 백업 위치가 네트워크 공유 폴더에 있는지 여부
- 데이터 저장소에 대한 백업이 생성되는 주기(백업 일정)
- 관계형 데이터 스토어 백업 파일의 보관 기관과 관계형 데이터 스토어를 특정 시점으로 복원할 수 있는지 여부
- 데이터 저장소 실행 여부(데이터 저장소 상태)
- 관계형 데이터 스토어에서 SSL 통신이 활성화되어 있는지 여부
- 스탠바이 그래프 스토어, 관계형 스토어 또는 타일 캐시 데이터 스토어(프라이머리-스탠바이 모드)가 프라이머리 데이터 스토어가 되는 날짜 및 시간(마지막 페일오버); 페일오버가 발생하지 않으면 이 등록정보가 나타나지 않음
- 관계형 또는 타일 캐시 데이터 저장소에 참여한 머신의 이름(구성원 머신)
- 관계형 데이터 저장소에 허용된 최대 연결 수
- 데이터 저장소가 등록되는 GIS Server 사이트의 URL(시스템 URL 소유)
- 호스팅 서버(포털 URL)로 GIS Server 사이트를 사용하는 포털의 URL
- 관계형 데이터 저장소에 대한 현재 피처 레이어 연결 수
- 현재 시공간 빅데이터 저장소에 참여하고 있는 모든 머신의 목록(시공간 클러스터의 머신)
- 시공간 빅데이터 저장소 내에서 현재 코디네이터 머신으로 지정되어 있는 머신(클러스터 내의 현재 코디네이터)
- 타일 캐시 또는 시공간 빅데이터 스토어 클러스터나 그래프 또는 객체 스토어 내의 모든 머신 목록(등록된 <데이터 스토어 유형> 머신); 상태와 관계없이 모든 머신이 표시됨
- 타일 캐시 데이터 스토어, 객체 스토어 또는 그래프 스토어에 대해 구성된 배포 모드
- 관계형 또는 시공간 빅데이터 스토어가 읽기/쓰기 또는 읽기 전용 모드(데이터 스토어 모드)인지 여부
구문
describedatastore
예시
describedatastore 유틸리티는 머신의 모든 데이터 저장소에 적용된 일반 정보와 함께 데이터 저장소 유형별 정보가 포함되어 있는 개별 섹션을 각각 반환합니다.
머신마다 데이터 저장소가 각기 달라야 하지만 각 유형에 대해 반환된 정보를 볼 수 있도록 다음 결과에서는 동일한 머신에 모든 ArcGIS Data Store 유형이 있는 머신을 보여줍니다. 첫 번째 섹션(일반 정보)은 항상 반환됩니다. describeatastore에서 반환되는 데이터 저장소 섹션은 머신에 있는 데이터 저장소 유형에 따라 다릅니다.
describedatastore
Available ArcGIS Data Stores
==============================================================
Relational Data Store
Tile Cache Data Store
Spatiotemporal Big Data Store
Graph Store
Object Store
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....11.2.0.1234
Staging location.............C:\arcgisdatastore\staging
Log location.................C:\arcgisdatastore\logs
Free disk space..............174.00GB
Threshold for READONLY mode..2048MB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location...........\\nwshare\dsbackups
Is backup folder shared...true
Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31
Data store status.........Started
SSL enabled...............true
Last failover.............20150130190334005
Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections.......150
Owning system URL.........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal
Number of connections.....8 connection(s) to managed database
Data Store mode.....................READWRITE
Is Point-in-time recovery enabled...No
Query optimizer enabled.............Yes
Information for tile cache data store ds_wztxj7um
==============================================================
Data location...................C:\arcgisdatastore\nosqldata
Data store status...............Started
Backup location.................\\mybackups\scenebackup
Backup schedule.................{schedule-frequency":"Every 1 DAYS"}
Is backup folder shared.........true
Mode............................cluster
Member tile cache machines......MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered tile cache machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...........https://portal_webadaptor.domain.com/portal
Information for spatiotemporal data store ds_qpko99Cl
==============================================================
Backup location.....................\\nwshare2\sbds_bu
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator in cluster......MACHINE1.DOMAIN.COM
Registered spatiotemporal machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data Store mode.....................READWRITE
Information for graph store x2b7s0n
==============================================================
Deployment mode..................primaryStandby
Access endpoint..................MACHINE1:9829
Backup location..................\\nwshare3\graphbu
Registered graph store machines..MACHINE1.DOMAIN.COM
Owning system URL................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL............https://portal_webadaptor.domain.com/portal
Information for object store w1tiknx
==============================================================
Deployment mode...................singleInstance
Access endpoint...................MACHINE1:9900
Backup location...................\\nwshare4\myfiles\ods_bu
Registered object store machines..MACHINE1.DOMAIN.COM
Owning system URL.................https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.............https://portal_webadaptor.domain.com/portaldiskcleanup
이 유틸리티는 관계형, 타일 캐시, 시공간 빅데이터 저장소에 사용됩니다.
diskcleanup 유틸리티는 restoredatastore 및 ArcGIS Data Store 업그레이드와 같은 작업에서 남은 임시 파일을 제거합니다. 업그레이드 후 특정 파일이 유지되어 실패한 업그레이드 또는 복원 작업 문제를 해결할 수 있습니다. 업그레이드 또는 복원 작업이 완료되어 시스템이 예상대로 작동하는 것이 확인되면 이 도구를 실행하여 해당 임시 파일을 제거하고 데이터 스토어 머신에서 여유 디스크 공간을 다시 확보할 수 있습니다.
이 유틸리티는 한 번에 머신 한 대의 디스크 공간을 정리합니다. 동일한 데이터 저장소에 있는 둘 이상의 머신에서 파일을 정리해야 하는 경우 각 머신에서 도구를 실행해야 합니다.
구문
diskcleanup
예시
diskcleanup 유틸리티를 실행하려면 계속 진행할 것인지 확인해야 합니다.
diskcleanup
You are attempting to cleanup some archived data generated as part of ArcGIS Data Store upgrades or backup-restore operations. Once removed, this data can't be recovered. Do you want to continue (Yes or No)?
exportmanageddb
레거시:
Esri는 10.5.1에서 exportmanageddb 유틸리티를 더 이상 지원하지 않습니다. 이 기능은 backupdatastore 유틸리티에 통합되었습니다. backupdatastore 유틸리티를 사용하여 백업 파일을 대신 생성합니다.
importmanageddb
레거시:
importmanageddb 유틸리티는 이전 내보내기 파일을 사용할 수 있도록 관련 exportmanageddb 유틸리티가 더 이상 사용되지 않은 후 여러 릴리즈에서 유지되었습니다. 그러나 ArcGIS Data Store 11부터는 backupdatastore 유틸리티를 사용하여 백업 파일을 생성하며 내보내기 파일에서 관계형 타일 캐시 데이터 저장소를 가져오는 대신 restoredatastore 유틸리티를 사용하여 백업 파일에서 데이터 저장소를 복원합니다.
listadminusers
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
listadminusers 유틸리티는 관계형 데이터 저장소의 관리자, 복사본 소유자, 지오데이터베이스 관리자의 사용자 이름과 비밀번호를 반환합니다. 타일 캐시, 시공간 빅데이터 저장소 및 그래프 저장소의 관리자를 반환합니다.
구문
listadminusers
예시
이 예시에서 listadminusers는 관계형 데이터 저장소만 설치된 머신에서 실행됩니다.
listadminusers
Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
이 예시에서 listadminusers는 시공간 빅데이터 저장소만 설치된 머신에서 실행됩니다.
listadminusers
Admin users for spatiotemporal big data store bds_abcd1234 ================================================= Store admin user.... els_321ret / B1as70fF1
이 예시에서 listadminusers는 그래프 저장소만 설치된 머신에서 실행됩니다.
listadminusers
Admin users for graph store s2t0ic1 ================================================= Store admin user....root / ypz5kx2c5tk4fequ
이 예시에서 listadminusers는 객체 저장소만 설치된 머신에서 실행됩니다.
listadminusers
Admin users for object store w1tiknx ================================================= Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4
listbackups
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
관계형 데이터 저장소에 대해 실행할 경우 listbackups 유틸리티는 프라이머리 데이터 저장소 머신에서만 작동합니다.
listbackups 유틸리티를 실행하여 다음을 확인합니다.
- 백업 작업이 시작된 시간
- 백업이 완료되었는지 아니면 여전히 실행 중인지 여부
- 백업이 backupdatastore 유틸리티를 사용하여 수동으로 생성되었는지 아니면 ArcGIS Data Store에서 자동으로 생성되었는지 여부
- 보유한 백업 파일 개수(삭제해야 하는지 여부를 판단하기 위해)
- deletebackup 유틸리티를 실행하기 전에 백업 파일 이름 확인
listbackups 유틸리티를 실행하는 경우 백업 파일 목록을 확인할 백업 위치를 지정합니다. 위치를 지정하지 않으면 listbackups 유틸리티에서 기본 백업 위치에 대한 백업을 반환합니다.
구문
listbackups [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <location_arguments>]
데이터 저장소 유형을 지정하지 않은 경우 유틸리티는 relational을 기본값으로 사용하며 해당 머신에서 실행 중인 관계형 데이터 저장소의 백업을 반환합니다. 유틸리티를 실행하는 머신에 관계형 데이터 스토어가 없는 경우, 유틸리티는 오류 메시지를 반환합니다.
location 매개변수는 백업 파일이 저장된 위치를 나타냅니다. 인수는 다음과 같습니다.
- name=: 백업 위치의 이름입니다. 백업 위치를 구성할 때 이 이름을 지정했거나, 이름을 지정하지 않은 경우 ArcGIS Data Store에서 기본 이름을 지정했습니다.
- location=: 공유 파일 디렉터리, S3 버킷 또는 Blob 스토리지 컨테이너의 경로입니다.
예시
다음 예시에서는 관계형 데이터 스토어의 기본 백업 위치에 대한 백업이 나열됩니다.
listbackups --store relational Backup_Name Status Backup_Time Mode ======================================================================= phase1proj_bu BackupComplete 2023-03-08 14:12 manual phase2proj_bu BackupComplete 2023-02-21 11:43 manual ds_gdt1omh-2023020130 BackupComplete 2023-02-01 03:00 scheduled Backups located at: '\\myserver.net.com\dsbackups'
이 예시에서는 sbdsbu라는 백업 위치에 대한 시공간 빅데이터 저장소 백업이 나열됩니다.
listbackups --store spatiotemporal --location "name=sbdsbu" Backup_Name Status Backup_Time Mode ================================================================== backup1 BackupComplete 2023-07-11 09:47 manual Backups located at: '\\myserver.net.com\spatiotemporal'
listdatasources
이 유틸리티는 시공간 빅데이터 저장소에 사용됩니다.
10.8.1의 버그로 인해 10.9 이후 버전으로 업그레이드한 후에는 사각형 또는 육각형 집계를 사용하는 ArcGIS GeoEvent Server 맵 서비스가 렌더링되지 않습니다. 이를 해결하려면 listdatasources 유틸리티를 실행하여 GeoEvent Server 맵 서비스의 이름을 가져오고 upgradedatasource 유틸리티와 함께 반환하는 서비스 이름을 사용하여 개별 서비스에 대한 데이터를 업데이트할 수 있습니다.
listdatasources 유틸리티는 시공간 빅데이터 저장소의 모든 머신에서 실행할 수 있습니다.
구문
listdatasources
예시
명령 프롬프트에서 listdatasources 유틸리티를 실행하여 GeoEvent Server 맵 서비스 목록을 반환합니다.
listdatasources
listmanageduser
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
listmanageduser 유틸리티는 관계형 및 시공간 빅데이터 저장소의 호스팅 피처 레이어 데이터를 소유한 계정의 사용자 이름과 비밀번호를 반환합니다. 이 유틸리티는 타일 캐시 데이터 저장소의 씬 캐시 소유자 및 그래프 저장소 그래프의 소유자에 대한 사용자 이름과 비밀번호도 반환합니다.
구문
listmanageduser
예시
다음 예시에서는 관계형 타일 캐시 데이터 저장소가 포함된 머신에서 listmanageduser를 실행합니다. 이 머신은 프라이머리 관계형 데이터 저장소입니다.
listmanageduser
Managed user for relational data store ds_abcd1234 =================================================== UserName Password Database gwi_n2Te0 4cXddhZhve=Y db_qv5e1 Managed user for tile cache data store tcs_e41f0rj2 =================================================== UserName Password usr_n8778 y47ccno913
다음 예시에서 listmanageduser는 시공간 빅데이터 저장소 머신에서 실행됩니다.
listmanageduser
Managed user for spatiotemporal big data store bds_6udbx4321 ============================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
다음 예시에서는 그래프 저장소 머신에서 listmanageduser를 실행합니다.
listmanageduser
Managed user for graph store s2t0ic1 ================================================ UserName Password mu_vwmp8c6 m5c2so76y3b0qczf
다음 예시에서 listmanageduser는 객체 저장소 머신에서 실행됩니다.
listmanageduser
Managed user for object store w1tiknx ============================================================= Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4
registerdatastore
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
데이터 저장소는 GIS Server 사이트 머신 이름에 대한 정보를 보관합니다. GIS Server 사이트를 새 머신으로 이동하는 경우(예: 새 하드웨어를 구매했거나 기존 GIS Server 머신에서 장애가 발생한 경우) 이 정보를 제거하려면 GIS Server 사이트에서 데이터 저장소를 등록 해제해야 합니다. 새 머신에서 GIS Server를 구성한 후 registerdatastore 유틸리티를 사용하여 GIS Server 사이트에 데이터 스토어를 등록할 수 있습니다.
비고:
registerdatastore 유틸리티는 이전에 등록된 것과 동일한 GIS Server 사이트에 데이터 스토어를 등록하는 데 사용됩니다. 데이터 저장소는 기존 GIS Server 사이트에서 호스팅 레이어에 대한 데이터를 포함합니다. 다른 GIS Server 사이트에 등록하면 호스팅 레이어가 다시 생성되지 않습니다.
registerdatastore 유틸리티는 프라이머리 관계형 데이터 저장소 머신 또는 프라이머리-스탠바이 모드에서 실행 중인 타일 캐시 데이터 저장소 또는 객체 저장소의 프라이머리 머신에서 실행할 수 있습니다. 클러스터 모드에서 실행되는 타일 캐시 데이터 저장소 또는 객체 저장소의 모든 머신이나 시공간 빅데이터 저장소 머신에서도 실행할 수 있습니다.
구문
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator username> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | graph | object}
권장 구성은 아니지만 서로 다른 유형의 데이터 저장소가 동일한 머신에 설치되어 있는 경우 각각의 데이터 저장소를 공백 없이 쉼표로 분리해 지정하여 한꺼번에 등록할 수 있습니다(예시: --stores relational,tileCache).
예시
다음 예시에서 관계형 데이터 저장소는 URL이 GIS Server인 https://gisserver.domain.com:6443 사이트에 다시 등록됩니다. ArcGIS Server 기본 사이트 관리자의 사용자 이름은 agsadmin이고 비밀번호는 Tan$p0n입니다.
registerdatastore https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational
removemachine
이 유틸리티는 관계형, 타일 캐시, 시공간 빅데이터 저장소, 그래프 저장소에 사용됩니다.
removemachine 유틸리티는 둘 이상의 머신이 포함된 데이터 저장소에서 머신을 제거하는 데 사용됩니다. 다음 시나리오에서 removemachine 유틸리티가 사용됩니다.
- 관계형 데이터 스토어 또는 그래프 스토어에서 스탠바이 머신을 제거합니다. 스탠바이 머신이나 프라이머리 머신(스탠바이 머신을 사용할 수 없는 경우)에서 이 유틸리티를 실행할 수 있습니다.
- 타일 캐시 데이터 저장소에서 머신을 제거합니다. 단일 머신으로만 구성된 타일 캐시 데이터 저장소를 제외하고 타일 캐시 데이터 저장소의 임의 머신에서 이 유틸리티를 실행할 수 있습니다.
- 시공간 빅데이터 저장소에서 머신을 제거합니다. 단일 머신으로만 구성된 시공간 빅데이터 저장소를 제외하고 시공간 빅데이터 저장소의 임의 머신에서 이 유틸리티를 실행할 수 있습니다.
구문
removemachine <machine name> --store {relational | tileCache | spatiotemporal | graph} [--force {true | false}] [--prompt {yes | no}]
--force — 기본 설정에 따라 false로 설정됩니다. 등록된 ArcGIS Server 사이트를 사용할 수 없는 경우에만 이 옵션을 true로 지정합니다.
--prompt — 기본 설정에 따라 yes로 설정됩니다. 동작을 확인하지 않으려면 이 옵션을 no로 지정합니다.
예시
이 예시에서는 시공간 빅데이터 저장소 머신인 gefour가 데이터 저장소에서 제거됩니다.
removemachine gefour --store spatiotemporal
이 예시에서는 호스팅 서버 사이트를 사용할 수 없으며, 관계형 데이터 저장소 머신 fsdata가 데이터 저장소에서 제거됩니다.
removemachine fsdata --store relational --force true
removestandbymachine
레거시:
Esri는 removestandbymachine 유틸리티를 더 이상 지원되지 않습니다. 이 유틸리티는 기존 스크립트를 계속 사용할 수 있도록 아직 제공되고 있지만 앞으로는 이 유틸리티 대신 removemachine 유틸리티를 사용해야 합니다.
restoredatastore
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
호스팅 레이어가 사용하는 데이터에 접근할 수 없는 경우 백업 파일과 restoredatastore 유틸리티를 사용하여 데이터 스토어를 복구합니다.
데이터 스토어를 복구할 수 없는 경우 새 머신에 ArcGIS Data Store를 설치한 다음 데이터 스토어를 구성하지 않고 마지막 전체 백업을 새 머신에 복원합니다.
관계형 데이터 저장소를 사용하며 과거의 특정 시간으로 호스팅 피처 레이어 데이터를 롤백하려면 기존 관계형 데이터 저장소 위에서 복원합니다. 백업 파일을 사용할 수 있는 이전 관계형 데이터 저장소 상태로만 복원할 수 있습니다. 예를 들어 5일간 백업을 유지하는 경우 해당 5일 이내 어떤 시점으로만 데이터 저장소를 복구할 수 있습니다.
다중 머신 타일 캐시 데이터 저장소에 있는 머신 중 하나를 교체해야 하는 경우, 타일 캐시 데이터 저장소 간에 씬 레이어 캐시를 리밸런싱해야 할 가능성이 매우 높습니다. 이 프로세스의 일환으로 replicatedata 옵션을 true로 설정하여 타일 캐시 데이터 저장소를 복원해야 합니다. 자세한 내용은 데이터 저장소 복구를 참고하세요.
restoredatastore 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서 실행할 수 있습니다. 해당 유틸리티는 모든 타일 캐시 데이터 스토어, 시공간 빅데이터 스토어, 그래프 스토어 또는 객체 스토어 머신에서 실행할 수 있습니다.
구문
restoredatastore [options]
지원되는 옵션은 다음과 같습니다.
- [--store {relational | tileCache | spatiotemporal | graph | object}] — 복원할 데이터 저장소의 유형을 표시합니다.
- [--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}] — 모든 데이터 저장소 유형은 target 옵션과 함께 백업 파일 이름을 지원합니다. 타임스탬프와 most-recent는 관계형 데이터 저장소로만 지원됩니다.
- [--source-loc <parent directory of the source backup file location>] — 상위 레벨 디렉터리로, 배치된 데이터 저장소를 복원하는 데 사용할 백업 파일의 위치입니다. 이 위치는 파일 공유 위치의 경로, 백업 위치 이름, Amazon S3, Azure Blob 저장소 백업 위치가 될 수 있습니다.
팁:
--operation 옵션을 list로 설정해 configurebackuplocation 유틸리티를 실행하여 백업 원본 위치를 가져올 수 있습니다. configurebackuplocation 유틸리티를 실행할 수 없는 경우(예시: 데이터 스토어 머신이 충돌하고 데이터 스토어를 복구하기 위해 새 시스템으로 복원하는 경우) agsds_backup_sig 파일이 있으면 백업 원본 위치를 식별할 수 있습니다.
- [--bound {true | false}] — --bound 옵션은 관계형 데이터 저장소에만 지원됩니다.
- [--data-dir <new data store directory>] — 데이터베이스를 복원하는 머신의 ArcGIS Data Store 디렉터리입니다. 데이터 저장소를 새 머신에 복원하는 경우에만 --data-dir을 사용합니다. 새 머신에 복원하려는 경우에는 --source-loc 옵션도 지정해야 합니다.
- [--server-url <ArcGIS Server URL registered with data store>] — 백업을 생성했을 때 동일한 GIS Server 사이트에 등록된 데이터 저장소를 유지하기 위해 --bound true를 지정하는 경우, 해당 GIS Server 사이트의 URL을 지정합니다. --bound true를 지정하고 서비스를 이미 새 GIS Server 사이트로 이동한 경우 --server-url 옵션을 사용하여 새 GIS Server 사이트의 URL을 지정합니다. 새 사이트 URL을 지정한 서비스가 새 서버로 이동되지 않은 경우 데이터 저장소의 데이터에 접근할 수 없습니다.
- [--server-admin <username of ArcGIS Server admin>] — 이 옵션은 --bound true를 지정하거나 --bound 옵션을 지정하지 않은 경우에 필요합니다. ArcGIS Server 관리자의 사용자 이름을 제공합니다.
- [--server-password <password of ArcGIS Server admin>] — 이 옵션은 --bound true를 지정하거나 --bound 옵션을 지정하지 않은 경우에 필요합니다. ArcGIS Server 관리자의 비밀번호를 제공합니다.
- [--loaddata {true | false}] — 타일 캐시 및 시공간 빅데이터 스토어, 그래프 및 객체 스토어에서 지원됩니다. 데이터 저장소를 새 머신에 복원해야 하지만 데이터가 첫 번째 머신에 맞지 않는 경우 이 옵션을 false로 설정합니다. 이를 통해 데이터 저장소의 스키마를 복원하고 데이터 저장소에 더 많은 머신을 추가하여 모든 데이터를 수용한 다음 restoredatastore가 --loaddata로 설정된 true 유틸리티를 다시 실행하여 데이터를 복원할 수 있습니다. 기본 설정에 따라 이 옵션은 true로 설정됩니다.
- [--replicatedata {true | false}] — 타일 캐시 데이터 저장소로 지원됩니다. 타일 캐시 데이터 저장소에 머신을 추가한 후 씬 캐시 데이터를 재조정하는 경우 옵션을 true로 설정합니다.
- [--mode {primaryStandby | cluster}] — 타일 캐시 데이터 저장소를 새 머신에 복원할 때 고가용성을 위해 두 머신의 타일 캐시 데이터 저장소를 사용할지(primaryStandby) 또는 확장 가능한 다중 머신 타일 캐시 데이터 저장소를 사용할지(cluster)를 지정할 수 있습니다.
- [--prompt {yes | no}]
관계형 데이터 저장소를 충돌 후 복원하거나 이동하는 경우 --target most-recent를 지정합니다. 관계형 데이터 저장소를 특정 시점으로 복원할 경우 데이터 저장소를 복원할 날짜와 시간(UTC)을 지정합니다. 복원할 특정 백업 파일이 있는 경우 백업 파일 이름을 대신 지정합니다. 대상을 지정하지 않으면 최근의 백업이 복원됩니다.
기본 설정에 따라, 복원된 데이터 저장소는 GIS Server 사이트와 연결(바인딩)됩니다. 데이터 저장소의 GIS Server 사이트와 연결을 유지하지 않고 데이터 저장소를 복원하려는 경우에만 --bound false를 지정합니다. 이 작업은 이전 GIS Server 사이트가 손실되고 복구할 수 없는 경우에 최후의 수단으로만 수행합니다; 바인딩되지 않은 데이터 저장소를 복원하여 이를 새로 페더레이션된 GIS Server 사이트에 구성할 수 있습니다. 그러나 데이터 저장소의 데이터를 사용하는 레이어는 더 이상 존재하지 않게 됩니다. 다른 형식으로 데이터를 추출하여 ArcGIS Enterprise에 다시 발행하려면 데이터 저장소 데이터베이스에 연결해야 합니다.
예시
이 예시에서 가장 최근 백업은 rdsbackups라는 백업 위치에 있으며 기존 데이터 저장소로 복원됩니다. 기본 저장소 유형이 관계형이고 데이터 저장소는 기본 설정에 따라 등록되었던 GIS Server 사이트에 바인딩되어 있으므로 --store relational 또는 --bound true를 지정할 필요가 없습니다. 하지만 GIS Server URL과 관리자 자격 증명을 지정해야 합니다.
restoredatastore --target most-recent --source-loc rdsbackups --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
이 예시에서는 지정 시간 복구가 활성화된 관계형 데이터 저장소가 네트워크 공유의 관계형 데이터 저장소 백업 위치에서 2014년 7월 17일 오후 2시 30분(UTC)의 상태로 복원됩니다.
restoredatastore --target 2014-07-17-14:30:00 --source-loc \\sharedserver\entbackups\relds --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
이 예시에서는 movedatastore라는 이름의 백업 파일을 사용하여 관계형 데이터 저장소가 새 머신에 복원됩니다. 새 머신에 복원하려는 경우 백업 파일의 위치와 새 ArcGIS Data Store 데이터 디렉터리의 위치를 지정해야 합니다. 호스팅 피처 서비스는 관계형 데이터 저장소가 등록된 동일한 GIS Server 사이트에서 계속 실행되고 있으므로 --bound true를 지정할 필요가 없지만 GIS Server URL과 관리자 자격 증명은 지정해야 합니다.
restoredatastore --target movedatastore --source-loc \\buserver\data\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
다음 예시에서는 타일 캐시 데이터 저장소가 새 머신에 복원됩니다. 새 머신에 복원하려는 경우 백업 파일의 위치와 새 ArcGIS Data Store 데이터 디렉터리의 위치를 지정해야 합니다. 씬 서비스는 타일 캐시 데이터 저장소가 등록된 동일한 GIS Server 사이트에서 계속 실행되고 있으므로 --bound true를 지정할 필요가 없지만 GIS Server URL과 관리자 자격 증명은 지정해야 합니다.
restoredatastore --store tilecache --source-loc \\buserver\scenedata\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $SAup.4s You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
이 예시에서는 새 머신이 타일 캐시 데이터 저장소에 추가된 후 타일 캐시 데이터 저장소가 mybackupfilename이라는 파일을 통해 복원되어 씬 캐시 데이터를 리밸런싱합니다.
restoredatastore --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
다음 예시에서는 시공간 빅데이터 저장소 백업 파일(bds1)이 기명 백업 위치(awsloc)에서 복원됩니다.
restoredatastore --target bds1 --store spatiotemporal --source-loc name=awsloc --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
하드웨어 장애 후의 시공간 빅데이터 저장소 복원에 대한 단계와 예시는 데이터 저장소 복구를 참고하세요.
revokeconnection
이 유틸리티는 관계형 데이터 저장소에 사용됩니다.
allowconnection 유틸리티를 사용하여 다른 클라이언트가 관계형 데이터 저장소에 직접 연결할 수 있도록 일시적으로 허용한 경우 revokeconnection 유틸리티를 실행하여 연결 기능을 취소할 수 있습니다.
revokeconnection 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서만 실행할 수 있습니다.
구문
revokeconnection <host name> <username> [<database>]
예시
이 예시에서는 hqo.n_1E7 사용자로 로그인했을 때 데이터 저장소 데이터베이스가 더 이상 workcom 머신의 연결을 허용하지 않습니다.
revokeconnection workcom hqo.n_1E7
unregisterdatastore
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
unregisterdatastore 유틸리티를 사용하면 다음을 수행할 수 있습니다.
- 단일 머신으로만 구성된 모든 유형의 데이터 스토어를 호스팅 GIS Server 사이트에서 등록 해제합니다.
객체 저장소의 등록을 해제한 후 호스팅 서버를 다시 시작해야 합니다.
- 프라이머리-스탠바이 모드에서 실행되는 데이터 스토어에서는 스탠바이 머신을 제거한 후에 프라이머리 머신을 등록 해제할 수 있습니다.
- 클러스터 모드로 실행되는 시공간 빅데이터 스토어 및 타일 캐시 데이터 스토어의 경우 클러스터의 다른 모든 머신을 제거한 후에 마지막 머신을 등록 해제할 수 있습니다.
비고:
데이터 스토어를 등록 해제하여 배포에서 영구적으로 제거하는 경우, 해당 데이터 스토어를 등록 해제하기 전에 데이터를 사용하는 호스팅 레이어를 삭제합니다. 예를 들어 기관 구성원이 GeoAnalytics Tools를 테스트하고 있으며 도구에서 생성된 레이어에 시공간 빅데이터 스토어를 사용했지만 그 대신 레이어를 관계형 데이터 스토어에 저장할 수 있겠다고 판단한 경우, 시공간 빅데이터 스토어를 등록 해제하기 전에 테스트 호스팅 시공간 피처 레이어를 삭제하면 됩니다. 그렇지 않으면 사용할 수 없는 레이어 항목이 포털에 남겨지며 사용할 수 없는 서비스가 호스팅 서버에서 실행됩니다.
데이터 스토어에서 머신을 등록 해제하면 호스팅 GIS Server 사이트(또는 지식 그래프의 경우 ArcGIS Knowledge Server 사이트)에서 해당 머신에 더 이상 연결할 수 없으며 등록 해제된 데이터 스토어의 데이터가 포함된 모든 서비스가 작동하지 않습니다. 그러나 해당 유틸리티는 데이터를 삭제하지 않습니다; 데이터 스토어가 계속 필요한 경우에는 registerdatastore 또는 configuredatastore 유틸리티를 사용하여 다시 추가할 수 있습니다.
구문
unregisterdatastore --stores {relational | tileCache | spatiotemporal | graph | object} [--prompt {yes | no}]
동일한 머신에 설치되어 있는 두 가지 이상의 데이터 저장소를 한 번에 등록 해제하려는 경우에는 각각의 데이터 저장소를 공백 없이 쉼표로 분리하여 지정합니다. 예를 들어 관계형 타일 캐시 데이터 저장소를 등록 해제하려면 --stores relational,tileCache를 입력합니다.
예시
다음 예시에서는 unregisterdatastore 유틸리티를 실행하여 관계형 타일 캐시 데이터 스토어를 호스팅 GIS Server 사이트에서 등록 해제합니다. 기본 설정에 따라 프롬프트 메시지가 반환됩니다. 프롬프트를 나타내지 않으려면 --prompt No를 지정합니다.
unregisterdatastore --stores relational,tileCache You are going to unregister the data store. Do you want to continue (Yes or No)?Yes
updatebackupretaindays
이 유틸리티는 관계형 데이터 저장소에 사용됩니다.
ArcGIS Data Store 기본 설정에 따라 관계형 데이터 저장소 백업 파일을 7일 동안 보관합니다. updatebackupretaindays 유틸리티를 실행하여 백업 파일이 백업 디렉터리에서 제거되는 빈도를 변경할 수 있습니다.
updatebackupretaindays 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서만 실행할 수 있습니다.
구문
updatebackupretaindays <number of days>
예시
다음 예시에서는 백업 파일 보관 기간이 10일로 변경되었습니다.
updatebackupretaindays 10
updatebackupschedule
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
기본 설정에 따라 ArcGIS Data Store에서는 관계형 데이터 저장소에 대한 전체 백업을 4일 주기로 생성합니다. updatebackupschedule 유틸리티를 실행하여 전체 백업이 생성되는 빈도를 변경할 수 있습니다.
타일 캐시, 시공간 빅데이터 저장소 또는 그래프 저장소에 대한 기본 자동 백업은 없습니다. 시공간 빅데이터 저장소에 대한 기본 자동 백업 일정을 설정하려면 먼저 올바른 백업 위치를 설정해야 합니다.
24시간 표기법을 사용하여 시작 시간을 지정합니다(예시: 자정은 00:00:00, 오후 1시는 13:00:00). frequency 옵션을 사용하여 백업 간의 기간을 지정합니다. 자동 백업을 비활성화하려면 빈도를 0으로 설정합니다. 자동 백업을 비활성화한 경우에는 backupdatastore 유틸리티를 사용하여 백업을 수동으로 생성해야 합니다.
updatebackupschedule 유틸리티는 프라이머리 관계형 데이터 저장소 머신에서 실행할 수 있습니다. 타일 캐시 또는 시공간 빅데이터 저장소 머신에서도 실행할 수 있습니다.
ArcGIS Data Store 백업에 대한 자세한 내용은 데이터 스토어 백업 관리를 참고하세요.
구문
updatebackupschedule [--store {relational | tileCache | spatiotemporal | graph | object}] [--starttime <local server time>] --frequency <number of days>
새 시작 시간을 지정하지 않으면 기존의 시작 시간 설정이 변경되지 않습니다. 데이터 저장소 유형을 지정하지 않으면 관계형 데이터 저장소로 간주됩니다.
예시
다음 예시에서는 관계형 데이터 저장소에 대한 전체 백업이 10일 간격으로 오후 11시(로컬 서버 시간)에 수행됩니다.
updatebackupschedule --starttime 23:00:00 --frequency 10
다음 예시에서는 백업 일정이 타일 캐시 데이터 저장소에 대해 설정됩니다. 모든 타일 캐시 데이터 저장소 데이터베이스에 대한 초기 백업 이후 ArcGIS Data Store에서는 새로 생성된 데이터 저장소 데이터베이스를 configurebackuplocation 유틸리티에서 지정한 위치에 14일 주기로 복사합니다.
updatebackupschedule --store tileCache --frequency 14
updatesslcertificate
이 유틸리티는 모든 데이터 저장소 유형에 사용됩니다.
호스팅 서버와 데이터 저장소 간의 통신과 데이터 저장소 머신 간의 통신을 인증하는 데 사용되는 자체 서명된 인증서를 CA(인증 기관)에서 서명한 인증서 또는 도메인 인증서로 바꿀 수 있습니다.
자세한 내용은 ArcGIS Data Store SSL 인증서 바꾸기를 참고하세요.
구문
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
예시
CA 서명 인증서 파일을 수신한 후 updatesslcertificate를 실행하여 ArcGIS Data Store 자체 서명된 인증서를 바꿉니다.
updatesslcertificate C:\myfiles\mysignedcert.pfx "ps4mycert" dsmachinename
upgradedatasource
이 유틸리티는 시공간 빅데이터 저장소에 사용됩니다.
10.8.1의 버그로 인해 10.9 이후 버전으로 업그레이드한 후에는 사각형 또는 육각형 집계를 사용하는 ArcGIS GeoEvent Server 맵 서비스가 렌더링되지 않습니다. 이를 해결하려면 upgradedatasource 유틸리티를 실행하여 이러한 GeoEvent Server 맵 서비스의 원본 데이터와 연결된 색인을 업데이트합니다.
색인이 업데이트되는 동안에는 아무도 맵 서비스에 접근할 수 없습니다.
upgradedatasource 유틸리티는 시공간 빅데이터 저장소의 모든 머신에서 실행할 수 있습니다.
구문
upgradedatasource [<service name>]
예시
이 예시에서는 모든 GeoEvent Server 맵 서비스 원본이 업그레이드됩니다.
upgradedatasource
이 예시에서 upgradedatasource 유틸리티는 GeoEvent Server 맵 서비스 조정에서 사용하는 색인을 업데이트합니다. 서비스 이름은 listdatasources 유틸리티를 사용하여 결정되었습니다.
upgradedatasource recon