configurebackuplocation

Эта утилита используется со всеми типами ArcGIS Data Store.

Утилита configurebackuplocation позволяет указать местоположение, в которое ArcGIS Data Store записывает файлы резервных копий как для резервного копирования по расписанию, так и для выполняемого при помощи утилиты backupdatastore. Утилита configurebackuplocation также позволяет изменить свойства расположения резервного хранилища или удалить его.

Реляционные хранилища создаются в местоположении локальной резервной копии по умолчанию. Чтобы избежать потери данных, настройте местоположение резервных копий по умолчанию, зарегистрировав удаленное файловое хранилище с помощью опции change.

Пространственно-временные хранилища больших данных, хранилища графов и хранилища объектов не создаются с расположением резервной копии по умолчанию. Прежде чем начать создавать резервные копии, необходимо запустить утилиту configurebackuplocation с опцией register, чтобы указать местоположение файлового хранилища, бакета Amazon Simple Storage Service (S3) или контейнера хранилища Microsoft Azure Blob для этих резервных копий.

Примечание:

Вы не можете использовать локальный диск для резервных копий файлов хранилища пространственно-временных больших данных.

Можно зарегистрировать второе местоположение резервной копии для хранения резервных копий, созданных с помощью утилиты backupdatastore. Вы можете использовать общедоступную файловую директорию, бакет S3 или контейнер хранилища Azure Blob для вторичных местоположений резервных копий.

Для получения дополнительной информации о резервных копиях ArcGIS Data Store см. раздел Управление резервными копиями ArcGIS Data Store.

Синтаксис

configurebackuplocation --store {relational | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]

Обязательные опции

При запуске утилиты настройки расположения резервных копий configurebackuplocation необходимо указать следующие опции:

--store {relational | spatiotemporal | graph | object}

Укажите тип ArcGIS Data Store, для которого настраиваются или запрашиваются местоположения резервных копий. Значение по умолчанию равно relational.
--operation {change | register | unregister | list | setdefault}

Опция --operation определяет действие, которое выполнит утилита configurebackuplocaton. Значение по умолчанию равно change.

Ниже приведено объяснение каждого аргумента, который можно использовать с опцией --operation:


Опция	Описание
`change`	Используйте этот аргумент для изменения любого из следующих значений: Укажите другое местоположение общего файла для запланированных резервных копий реляционного хранилища. Для реляционных хранилищ местоположение, заданное при помощи аргумента `change`, всегда будет местоположением резервной копии по умолчанию. При изменении местоположения резервной копии реляционного хранилища по умолчанию необходимо указать опцию `--location`. Измените имя места хранения резервной копии. Необходимо указать опцию `--location` и ее аргумент `name` при изменении имени места хранения резервной копии. Обновите информацию об аутентификации, заданную для местоположений резервных копий на Azure или S3. Для S3 можно изменить информацию, ранее заданную с помощью опций `username` и `password`. Для Azure можно поменять значение `password`.
`register`	Используйте этот аргумент для регистрации местоположения резервной копии. При использовании аргумента `register` необходимо указать опцию `--location`. Первое заданное вами местоположение резервных копий для хранилища пространственно-временных больших данных, хранилища графов или хранилища объектов будет установлено местоположением резервных копий по умолчанию. При регистрации другого местоположения резервной копии для хранилища пространственно-временных больших данных, хранилища объектов или хранилища графов регистрируется вторичное местоположение резервной копии. Для реляционного хранилища аргумент `register` всегда регистрирует вторичное местоположение резервной копии. Вторичное местоположение резервной копии может использоваться для хранения резервных копий, созданных вручную с помощью утилиты backupdatastore.
`unregister`	Используйте этот аргумент для удаления вторичного местоположения резервных копий из хранилища данных. Если зарегистрировано только одно местоположение резервной копии, аргумент unregister полностью удалит местоположение резервной копии для хранилища пространственно-временных больших данных, хранилища объектов и хранилища графов.
`list`	Перечисляет все местоположения резервных копий, зарегистрированные для хранилища данных, указанного с помощью опции `--store`. В списке указано физическое хранилище резервных копий, имя хранилища резервных копий и то, какое из них зарегистрировано в качестве хранилища резервных копий по умолчанию.
`setdefault`	Если настроено несколько местоположений резервного копирования для хранилища графов, хранилища объектов или хранилища пространственно-временных больших данных, используйте аргумент `setdefault`, чтобы указать одно из местоположений резервного копирования в качестве местоположения по умолчанию. Это то местоположение, куда по расписанию записываются резервные копии, и это местоположение по умолчанию используется для запуска утилит backupdatastore, listbackups или restoredatastore без указания резервного местоположения.

Опция местоположения

Опция --location требуется в следующих сценариях:

Указание местоположения хранилища резервных копий при регистрации местоположения резервной копии или при изменении изначального местоположения резервной копии по умолчанию для реляционного хранилища.
Для изменения имени существующего хранилища резервных копий укажите аргумент name и значение нового имени.

Можете использовать опцию --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>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]".

Пояснения к каждому из этих аргументов, поддерживаемых опцией --location, приведены ниже:


Аргумент	Описание
`type=`	Этот аргумент является обязательным. Укажите какой тип местоположения использовать для резервных копий. Укажите `fs` для хранения резервных копий в файловом хранилище. Для реляционных хранилищ местоположением резервных копий по умолчанию должно быть файловое хранилище. Укажите `s3` для хранения резервных копий в бакете Amazon S3. Укажите `azure` для хранения резервных копий в Blob контейнере Azure.
`location=`	Этот аргумент является обязательным. Для файловых хранилищ укажите путь к файлу. Для бакетов Amazon S3 укажите имя бакета и путь к нему. Для контейнеров хранилищ Blob укажите имя контейнера и путь к нему. При использовании этого аргумента для изменения начального местоположения резервной копии реляционного хранилища по умолчанию указанное вами расположение не может быть существующим зарегистрированным местоположением резервной копии.
`name=`	Вы можете присвоить имя местоположению резервной копии. Например, если местом хранения резервной копии является путь к файлу, например `\\sharedserver_sharedfolders_datastorebackups`, вы можете указать имя для этого места, например, dsbackupsfolder. При запуске утилит backupdatastore, listbackups или restoredatastore можете ввести это имя вместо пути. Если вы не задали имя при настройке местоположения резервной копии хранилища данных, ArcGIS Data Store назначит имя по умолчанию.
`username=`	Этот аргумент является обязательным, если для аргумента `type=` задано значение `azure` или `s3`. Для бакетов S3 укажите идентификатор ключа доступа для вашего аккаунта Amazon Web Services (AWS). Для контейнеров хранилища Azure Blob укажите имя для учётной записи хранилища Microsoft Azure, у которой есть доступ к контейнеру хранилища Blob.
`password=`	Этот аргумент является обязательным, если для аргумента `type=` задано значение `azure` или `s3`. Для бакетов S3 предоставьте ключ доступа к вашей учётной записи AWS. Для контейнеров хранилища Azure Blob укажите ключ для учетной записи Azure, который вы указали в аргументе `username`.
`endpointsuffix=`	Если для аргумента `type=` вы зададите значение `azure`, то вы сможете использовать аргумент `endpointsuffix`, чтобы указать, где находится контейнер хранилища Blob Azure. По умолчанию предполагается, что `endpointsuffix` - это `core.windows.net`. Если ваш контейнер находится в облачной среде Microsoft Azure Government Government, укажите `endpointsuffix=core.usgovcloudapi.net`. Если контейнер находится в частном облаке, установите значение `endpointsuffix` для суффикса конечной точки вашего частного облака Azure.
`region=`	Этот аргумент требуется, если аргумент `type=` установлен на `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`. При запуске этой утилиты вам будет предложено подтвердить указанное действие. Для автоматизации использования этой утилиты установите для опции `--prompt` значение `no`; в противном случае скрипт не будет выполняться, пока вы не ответите на запрос.

Примеры

В следующих разделах приведены примеры изменения, настройки или составления списка локаций резервных копий для хранилищ данных.

Изменение места хранения резервных копий по умолчанию для реляционного хранилища

В первом примере в качестве местоположения резервной копии реляционного хранилища задана директория fsdata_bu на компьютере myshare.

./configurebackuplocation.sh --operation change --store relational --location "type=fs;location=/net/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

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.sh --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

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.sh --operation register --store graph --location "type=fs;location=/net/sharedmachine/g_bu;name=fshare" --prompt no

configurebackuplocation --operation register --store graph --location "type=fs;location=\\sharedmachine\g_bu;name=fshare" --prompt no

Добавление местоположений резервных копий и их настройка по умолчанию

В данном примере второе местоположение резервных копий задается для хранилища пространственно-временных больших данных. Дополнительное местоположение резервных копий находится в хранилище Azure.

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

В данном примере второе местоположение резервных копий в регионе Европа (Испания) на AWS указано для того же хранилища пространственно-временных больших данных. Имя, awsloc, назначается резервному местоположению.

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

В этом примере бакет S3 задан в качестве местоположения резервной копии по умолчанию для хранилища пространственно-временных больших данных с использованием имени местоположения этой резервной копии (awsloc).

./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

Получение списка всех местоположений резервных копий для хранилища данных

В этом примере перечислены все местоположения резервных копий для хранилища пространственно-временных больших данных.

./configurebackuplocation.sh --operation list --store spatiotemporal

configurebackuplocation --operation list --store spatiotemporal

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       /net/sharedmachine/ge_bu     false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false

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