Командные утилиты, которые устанавливаются в ArcGIS Data Store, предоставляют администратору хранилища данных инструменты управления хранилищами данных. В этом разделе вы найдёте описание утилит, а также синтаксис и примеры.
Все утилиты должны запускаться с компьютера ArcGIS Data Store. Вы можете найти утилиты в директории <ArcGIS Data Store installation directory>/datastore/tools.
Чтобы получить помощь в синтаксисе, введите имя утилиты, а после него --help.
allowconnection
Используется с реляционными хранилищами данных.
В целях безопасности все подключения к хранилищу данных по умолчанию выполняются через сайт GIS Server. Если вы хотите, чтобы реляционное хранилище данных было открыто для подключений с дополнительного компьютера, можно использовать утилиту командной строки allowconnection.
Утилиту allowconnection можно запустить только на основном компьютере реляционного хранилища данных.
Синтаксис
allowconnection <host name> <user name> [<database>]
Укажите имя компьютера, для которого вы хотите разрешить подключение к реляционному хранилищу данных (имя хоста), и одну из учетных записей базы данных, которые используются хранилищем данных (имя пользователя): администратора хранилища данных, владельца реплики, администратора базы геоданных или управляемого пользователя (т.е. пользователя, который публикует данные векторного слоя); эту информацию вы можете получить с помощью утилиты listadminusers или listmanageduser. Вы также можете указать имя основной базы данных реляционного хранилища данных, но, поскольку существует только одна основная база данных, это значение имеет необязательный характер.
Пример
В данном примере разрешено подключение к реляционному хранилищу данных с компьютера workcom для управляемого пользователя hqo.n_1E7.
./allowconnection.sh workcom hqo.n_1E7
backupdatastore
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Если вам необходимо создать резервную копию реляционного хранилища данных за определенный период времени, используйте утилиту backupdatastore. Используйте эту утилиту для создания вручную полной резервной копии перед обновлением хранилища данных или перед внесением большого числа изменений в хранилище данных.
Во время первого запуска утилиты backupdatastore для резервного копирования хранилища данных полистного кэша в резервную копию копируются все существующие базы данных хранилищ данных полистного кэша. Последующее использование утилиты backupdatastore создаст резервные копии всех баз данных хранилища данных полистного кэша, созданных позже последнего запуска утилиты.
Во время первого запуска утилиты backupdatastore для хранилища пространственно-временных больших данных создаётся полный архив. Поскольку хранилища пространственно-временных больших данных могут быть весьма крупными, все последующие запуски утилиты backupdatastore создают файлы резервного копирования, содержащие только изменения с момента создания первоначальной полной резервной копии.
Утилиту backupdatastore можно запустить только на компьютере с основным реляционным хранилищем данных или хранилищем данных полистного кэша. Эту утилиту можно запускать на любом компьютере, входящем в большое хранилище пространственно-временных больших данных.
Во всех случаях убедитесь, что местоположение архива имеет достаточно места для размещения резервных копий. Чтобы изменить местоположения архивов хранилищ данных, воспользуйтесь утилитой configurebackuplocation.
Синтаксис
backupdatastore [<backup name>] [--store {relational|tileCache|spatiotemporal}] [--location <backup_arguments>] [--prompt <yes | no>]
Параметр --location поддерживается для больших хранилищ пространственно-временных данных и реляционных хранилищ данных. Аргументы для этого параметра следующие, и должны разделяться точкой с запятой (;):
- type=: Корректные типы fs (файлообменник), s3 (AWS S3-корзина) или azure (контейнер хранилища Azure blob).
- name=: Если вы назначили имена мест резервного копирования, настроенных для вашего хранилища пространственно-временных больших данных, вы можете использовать имя местоположения, чтобы указать, где вы хотите создавать резервные файлы при запуске утилиты backupdatastore.
- location=: Если вы не укажете имя места резервного копирования для своего хранилища, вы должны указать резервную копию type и location. Для общего доступа к файлам предоставьте путь к этим файлам. Для S3-корзин предоставьте имя корзины. Для контейнеров хранилищ Azure blob предоставьте имя контейнера.
Пример
В данном примере с помощью утилиты configurebackuplocation в заданной архивной папке создан файл резервной копии для хранилища данных, имя созданного файла – project1bu. По умолчанию создаются архивы реляционных хранилищ данных; в следующем примере будет создан архив реляционного хранилища данных.
./backupdatastore.sh 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
В данном примере файл резервной копии под названием localbu5 создан в хранилище пространственно-временных больших данных в файловом местоположении, которое вы назвали gadbu при настройке местоположения резервной копии.
./backupdatastore.sh tcbu5 --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
В этом примере создаётся резервная копия хранилища пространственно-временных больших данных в контейнере хранилища Azure blob под названием blob4backups, имя созданного файла резервной копии – spds311016:
./backupdatastore.sh 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
Используется с реляционными хранилищами данных.
Прежние версии:
EsriEsri считает утилиту changebackuplocation устаревшей. Она все ещё присутствует, чтобы существующие скрипты продолжали работать, но вместо неё уже надо использовать утилиту configurebackuplocation.
По умолчанию файлы резервных копий реляционного хранилища данных хранятся на том же компьютере, что и само хранилище данных. Следует переместить файлы резервного копирования на другой компьютер, чтобы гарантированно обеспечить их доступность в случае, если компьютер с установленным ArcGIS Data Store будет недоступен.
Убедитесь, что учетная запись, под которой работает утилита changebackuplocation, имеет права доступа для чтения/записи в общей директории.
Утилита changebackuplocation применяется только к архивам, созданным для реляционного хранилища данных.
Синтаксис
changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]
Укажите --is-shared-folder true, если файлы резервного копирования находятся на общедоступном сетевом компьютере. Если вы хотите переместить существующие файлы резервного копирования в новое местоположение, укажите --keep-old-backups true.
changedatastoremode
Используется с реляционными хранилищами данных.
Утилита changedatastoremode позволяет перевести реляционное хранилище данных в режим только чтение, пока будете выполнять обслуживание хранилища данных. Например, если вам необходимо выполнить задачу по обслуживанию, которая вызовет перезапуск хранилища данных, например, изменить местоположение резервного архива с одного диска на другой или изменить свойства базы данных, следует перевести реляционное хранилище данных в режим "только для чтения", чтобы пользователи не могли публиковать или редактировать данные при перезапуске хранилища.
Утилита changedatastoremode используется также для обратного переключения находящегося в режиме "только для чтения" реляционного хранилища данных в режим "чтение и запись", когда обслуживание будет закончено, или когда на компьютер с основным хранилищем данных будет добавлено необходимое дисковое пространство, что позволит хранилищу данных работать правильным образом в режиме "чтение и запись".
Утилиту changedatastoremode можно запустить только на основном компьютере с реляционным хранилищем данных.
Примечание:
Если ArcGIS Data Store поместил ваше хранилище реляционных данных в режиме "только для чтения" из-за недостаточности свободного дискового пространства, будет также отключена автоматическая архивация, чтобы не заполнять диск данными. Поэтому вам также будет нужно сбросить своё расписание автоматического архивирования с помощью утилиты updatebackupschedule после обратного переключения хранилища реляционных данных в режим "чтение и запись".
Синтаксис
changedatastoremode readonly|readwrite [--prompt <yes|no>]
Пример
В этом примере реляционное хранилище данных переключено обратно в режим "чтение и запись", поэтому клиенты могут возобновить такие действия, как публикация размещенных векторных слоев на портале, редактирование данных посредством размещенных векторных слоев и добавление файлов CSV в Map Viewer.
./changedatastoremode.sh readwrite --prompt no
changedbproperties
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и хранилищ пространственно-временных больших данных.
Утилита changedbproperties позволяет изменять разные свойства, в зависимости от типа хранилища данных, для которого она запускается.
Синтаксис
changedbproperties --store <relational | tileCache | spatiotemporal> [configuration options]
Поддерживаемые опции настройки:
- disk-threshold-readonly: этот параметр переводит реляционное хранилище данных в режим "только для чтения" с целью предотвращения потери данных из-за недостаточности свободного дискового пространства. Значение дискового пространства по умолчанию - 1024 Мб. Задайте размеры в Мб.
- max-connections: Используйте этот параметр, чтобы указать максимальное количество подключений, допустимых для реляционного хранилища данных. Реляционные хранилища данных разрешают до 150 подключений по умолчанию. Можно использовать свойство --max-connections с утилитой changedbproperties, чтобы изменить число допустимых подключений. При определении необходимого количества подключений для хранилища данных необходимо принять во внимание, что внутренние процессы ArcGIS Data Store могут брать на себя до пяти подключений. Кроме того, примите во внимание количество одновременных подключений, ArcGIS Data Store которое может разрешить ваш компьютер без ущерба для своей производительности. Если у компьютера с запущенным ArcGIS Data Store недостаточно памяти, может понадобиться сократить число допустимых подключений.
Указанный номер не может быть меньше, чем 10. При изменении максимального разрешенного количества подключений это количество изменится как на основном, так и на резервных компьютерах хранилища данных. Этот параметр не поддерживается для хранилищ пространственно-временных больших данных или хранилищ данных полистного кэша.
- pitr: эта настройка определяет, будет ли ArcGIS Data Store создавать накопительные резервные копии реляционного хранилища данных, что позволит вам восстанавливать реляционное хранилища данных на определенный момент времени. Возможные входные данные для этой опции: enable или disable. Восстановление на определенный момент времени по умолчанию отключено.
Примечание:
Необходимо активировать восстановление на определенный момент времени, если вы планируете использовать утилиту webgisdr для создания накопительных резервных копий вашего развертывания ArcGIS Enterprise.
- enablessl: Этот параметр контролирует использование протокола безопасности при заполнении хранилища данных с полистным кэшированием. Протокол безопасности изменился в ArcGIS Data Store 10.6.1.
ArcGIS Data Store 10.6.1 использует протокол Transport Layer Security (TLS) при заполнении хранилища данных с полистным кэшированием.
Поддерживаются следующие опции для параметра enablessl в 10.6.1:
- admin: Установка по умолчанию. Укажите admin для использования Transport Layer Security при создании контейнера в хранилище данных с полистным кэшированием.
- data: Укажите data для использования Transport Layer Security при записи данных слоев сцен в хранилище данных с полистным кэшированием.
- admin,data: Укажите admin,data для использования Transport Layer Security при создании и записи данных в хранилище данных с полистным кэшированием.
- none: Укажите none для использования подключения к хост-серверу по протоколу HTTP при создании и записи данных в хранилище данных с полистным кэшированием.
ArcGIS Data Store 10.6.1 использует протокол безопасности SSLv3 при заполнении хранилища данных с полистным кэшированием. Для использования шифрования SSLv3, для компьютеров хост-сервера должно быть активировано SSLv3. Для большинства компьютеров эта опция выключена и вы можете настроить хранилище данных с полистным кэшированием для использования подключения HTTP с хост-сервером, и, таким образом, нет необходимости активировать SSLv3 на компьютерах хост-сервера.
Поддерживаются следующие опции для параметра enablessl в 10.6:
- admin: Определяет для admin использование протокола безопасности SSLv3 при создании контейнера для хранилища данных с полистным кэшированием. Для этого на компьютерах хост-сервера должен быть активирован протокол SSLv3. Свяжитесь с администратором ArcGIS Server или администратором IT, если вам нужна информация о том, включен ли протокол на этих компьютерах. Если администратор хочет активировать SSLv3 на компьютерах хост-сервера, он может воспользоваться инструкциями в разделе Общие проблемы и решения в справке ArcGIS Server.
- data: Определяет для data использование протокола безопасности SSLv3 при записи данных слоев сцен в хранилище данных с полистным кэшированием. Для этого на компьютерах хост-сервера должен быть активирован протокол SSLv3.
- admin,data: Определяет для admin,data использование протокола безопасности SSLv3 при создании и записи данных в хранилище данных с полистным кэшированием. Для этого на компьютерах хост-сервера должен быть активирован протокол SSLv3.
- none: Определяет для none использование подключения к хост-серверу по протоколу HTTP при создании и записи данных в хранилище данных с полистным кэшированием. Используйте эту настройку, если увидите сообщение Опубликованные инструменты не могут подключиться к хранилищу данных с полистным кэшированием. Это может быть связано с настройками безопасности, которые влияют на то, как хост-сервер взаимодействует с хранилищем данных с полистным кэшированием в журналах хост-серверов, или вы знаете, что протоколы безопасности не допускают использования SSLv3.
- heap-size: Используйте этот параметр, чтобы изменить объем динамической памяти (в Мб), используемой хранилищем пространственно-временных больших данных. По умолчанию этот тип хранилища данных при запуске будет использовать половину доступного ОЗУ. Этот параметр не поддерживается для хранилищ данных полистного кэша или реляционных хранилищ данных.
- rebalance: по умолчанию этот параметр задан как true, что означает, что хранилище больших пространственно-временных данных будет распределять данные по другим компьютерам, если какой-либо один компьютер недоступен. Если необходимо осуществить обслуживание одного компьютера с хранилищем больших пространственно-временных данных, например, обновить его, можно временно отключить балансировку, задав этому параметру значение false. Операция балансировки будет приостановлена на время, заданное для параметра max-rebalance-off. Данный параметр применяется только для хранилищ пространственно-временных больших данных.
Прежние версии:
В ArcGIS 10.4.x это была опция reallocation.
- max-rebalance-off: Настройка этого параметра используется, когда параметр rebalance устанавливается на false. По умолчанию, max-rebalance-off имеет значение 60 минут. Это означает, что если вы временно отключите балансировку, она снова запустится через 60 минут. Если для выполнения задач обслуживания, для которых вы приостанавливаете балансировку, требуется больше или меньше времени, измените настройку времени для max-rebalance-off. Данный параметр применяется только для хранилищ пространственно-временных больших данных.
Прежние версии:
В ArcGIS 10.4.x это была опция max-allocation-off.
- prompt: При запуске этой утилиты вам будет предложено подтвердить указанное действие. Если вы автоматизируете использование этой утилиты, задайте параметр prompt как false, в противном случае скрипт не будет выполняться, пока вы не ответите на запрос.
Пример
В данном примере максимальное количество подключений, допустимое для реляционного хранилища данных, задано равным 100:
./changedbproperties.sh --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В этом примере опция max-rebalance-off задаёт значение 15 минут, в истечении которых хранилище пространственно-временных больших данных автоматически изменит значение rebalance на true.
./changedbproperties.sh --store spatiotemporal --max-rebalance-off 15
В этом примере параметр enablessl используется для конфигурации хранилища данных с полистным кэшированием для использования Transport Layer Security при создании контейнера и при записи данных в хранилище данных с полистным кэшированием версии 10.6.1.
./changedbproperties.sh --store tileCache --enablessl admin,data
В этом примере параметр enablessl используется для активации подключения HTTP к хост-сервером при заполнении хранилища данных с полистным кэшированием версии 10.6, что позволяет пользователям публиковать слои сцен, не требуя от администратора ArcGIS Server включения SSLv3 на компьютерах хост-серверов.
./changedbproperties.sh --store tileCache --enablessl none
changeloglocation
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Если вы не хотите, чтобы хранилище данных использовало местоположение файла журнала ошибок, заданное по умолчанию, то есть <ArcGIS Data Store installation directory>\arcgisdatastore\logs, вы можете запустить утилиту changeloglocation, чтобы создать файлы журнала ошибок в другой директории.
Синтаксис
changeloglocation <directory path>
Пример
В данном примере файлы журнала будут созданы в локальной директории – ../datastorefiles/logs.
./changeloglocation.sh '../datastorefiles/logs'
changenosqldslocation
Используется для хранилищ данных полистного кэша.
Хранилище данных полистного кэша может быть увеличено, если вы храните в нем множество листов с высоким разрешением. В этих случаях вам может понадобиться переместить данные либо на другой диск на том же сервере, либо в общее расположение на другом сервере.
Если вы перемещаете данные в общую директорию, вы должны предоставить права на чтение и запись этой директории пользователю, запускающему процесс (Linux) или сервис (Windows) для ArcGIS Data Store.
Синтаксис
changenosqldslocation <path> [--prompt {yes | no}]
Пример
В этом примере базы данных, в которых хранятся кэши слоя сцены, теперь будут созданы в общей директории с именем dstorecache на компьютере server2.
changenosqldslocation /net/server2/dstorecache
changepassword
Используется с реляционными хранилищами данных.
ArcGIS Data Store случайным образом генерирует имена пользователей и пароли для учетных записей, используемых для реляционных хранилищ данных. Если для вашего сайта необходимо задать ваши собственные пароли, получите пароли для учетных записей хранилища данных и запустите changepassword, чтобы поменять пароли.
Используйте утилиту listadminusers для получения имен пользователей и паролей для пользователей-администраторов и утилиту listmanageduser для получения имен пользователей и паролей для владельцев данных.
Утилиту changepassword можно запустить только на основном компьютере реляционного хранилища данных.
Синтаксис
changepassword <user name> <new password> [--prompt {yes | no}]
Подсказка:
Если необходимо сменить пароль с помощью скрипта, следует вставить флаг для отмены подтверждения, как в следующем примере:
changepassword gwi_n2Te0 Phfl4mp --prompt no
Пример
В данном примере пароль пользователя gwi_n2Te0 изменен на Phfl4mp!.
./changepassword.sh 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 извлекает сжатые архивные файлы в промежуточное местоположение. Это означает, что вам необходимо иметь это временное местоположение, способное вместить эти распакованные данные. Если в реляционном хранилище данных находится много данных, иногда лучше создать отдельную временную папку и указать ее местоположение в процессе восстановления.
Синтаксис
changestaginglocation <directory path>
Пример
В этом примере промежуточным местоположением является /net/sanmarcos/stage.
./changestaginglocation.sh /net/sanmarcos/stage
configurebackuplocation
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Утилита configurebackuplocation позволяет указать местоположение, в которое ArcGIS Data Store записывает файлы резервных копий как для резервного копирования по расписанию, так и выполняемого при помощи утилиты backupdatastore. Она также позволит удалить местоположение резервной копии, когда архивы ArcGIS Data Store станут больше не нужны.
Реляционные и хранилища данных полистного кэша создаются в местоположении резервной копии по умолчанию. Используйте опцию change, чтобы задать более безопасное местоположение по умолчанию резервной копии этих хранилищ данных в общей удалённой директории.
В местоположении по умолчанию хранилища пространственно-временных больших данных не создаются. Прежде чем начать создавать резервные копии, вам надо запустить утилиту configurebackuplocation с опцией register для указания общего сетевого местоположения, корзины Amazon Simple Storage Service (S3) или хранилища blob Microsoft Azure для этих резервных копий. Вы не можете использовать локальный диск для хранения резервных копий файлов хранилища пространственно-временных больших данных.
И для хранилищ пространственно-временных больших данных, и для реляционных хранилищ данных, вы можете зарегистрировать второе резервное местоположение для хранения полных резервных копий, создаваемых при помощи утилиты backupdatastore. Вы можете использовать общедоступную файловую директорию, корзину S3 или контейнер хранилища Azure Blob для вторичных резервных копий.
Синтаксис
configurebackuplocation --location '<backup_location_arguments>' [options]
Поддерживаются следующие опции:
- --location 'type=fs|s3|azure location=<backup_location> [name=<backup_location_name>] [username=<AWS_or_Azure_login>] [password=<AWS_or_Azure_account_password>]': Укажите местоположение, в котором вы хотите, чтобы ArcGIS Data Store хранило файлы резервной копии. Для пространственно-временных больших хранилищ данных или для регистрации вторичного местоположения резервного хранилища для реляционного хранилища данных укажите следующие аргументы, разделенные точкой с запятой (;) и заключите всю строку аргумента в одинарные кавычки ('):
- type=: Укажите какой тип местоположения использовать для резервных копий. Вы можете указать s3 для хранения резервных копий корзины Amazon S3, azure для хранения резервных копий в контейнере хранилища Azure Blob или fs для хранения резервных копий в файловом хранилище (это по умолчанию).
- location=: Для файловых хранилищ укажите путь к файлу. Для S3-корзин укажите имя корзины. Для контейнеров хранилищ Blob укажите имя контейнера.
- name=: Вы можете присвоить имя местоположению резервной копии. Например, если местоположение резервной копии в файлах, типа \\sharedserver_sharedfolders_datastorebackups, вы можете назначить имя для этого местоположения, такое как dsbackups. Когда вы запускаете утилиту backupdatastore, listbackups или restoredatastore, вы можете предоставить это имя вместо полного пути.
Если вы не предоставили имя при настройке местоположения резервной копии хранилища данных, ArcGIS Data Store назначит имя по умолчанию.
- username=: Требуется, если местоположением резервной копии является корзина S3 или контейнер хранилища Blob. Для корзин S3 предоставьте ключ доступа ID к вашей учётной записи AWS. Для контейнеров хранилищ Azure Blob предоставьте имя пользователя учётной записи Microsoft Azure, у которой есть доступ к контейнеру хранилища Blob.
- password=: Требуется, если местоположением резервной копии является корзина S3 или контейнер хранилища Blob. Для корзин S3 предоставьте секретный ключ для вашей учётной записи AWS. Для контейнеров хранилищ Azure blob предоставьте пароль для учётной записи Azure, которую вы указали в аргументе username.
- --store relational|tileCache|spatiotemporal: Значением по умолчанию является relational.
- --operation change|register|unregister|list|setdefault: Значением по умолчанию является change. Ниже следует объяснение по каждой опции:
- change: Используйте реляционное или кэшированное хранилище данных для указания другого общедоступного местоположения для файлов резервных копий. Местоположение, устанавливаемое при помощи опции change, всегда будет местоположением резервной копии по умолчанию.
- register: Используйте хранилище больших пространственно-временных данных для регистрации местоположения резервного файла. Первое заданное вами местоположение резервных копий будет установлено местоположением резервных копий по умолчанию. Начиная с версии 10.6.1, используйте с реляционным хранилищем данных для регистрации дополнительного места резервного копирования для резервных копий вручную.
- unregister: Используйте для отмены регистрации местоположения резервной копии из хранилища пространственно-временных больших данных. Начиная с версии 10.6.1, используйте для удаления вторичного местоположения резервных копий из реляционного хранилища данных.
- list: Перечисляет все местоположения резервных копий, зарегистрированные для хранилища пространственно-временных больших данных. Начиная с версии 10.6.1, также перечисляет все местоположения резервных копий реляционного хранилища данных.
- setdefault: Если у вас несколько местоположений резервных копий для хранилища пространственно-временных больших данных, вы можете использовать setdefault для предназначения одного из них в качестве местоположения по умолчанию. Это то местоположения, куда по расписанию записываются резервные копии, и это местоположение по умолчанию используется для запуска утилит backupdatastore, listbackups или restoredatastore без указания местоположения резервного местоположения.
- --prompt yes | no: Значением по умолчанию является yes.
В 10.6 вы можете использовать опции register, unregister, list и setdefault только для хранилищ пространственно-временных больших данных. В 10.6.1 вы можете использовать для реляционных хранилищ данных register, unregister и list.
Если не указать опцию --store, предполагается, что это хранилище реляционных данных.
Примечание:
Опция location требуется при указании опций register или change.
Примеры
В первом примере в качестве местоположения резервной копии реляционного хранилища данных задана директория fsdata_bu на компьютере myshare.
./configurebackuplocation.sh --operation change --store relational --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
В данном примере местоположение второй резервной копии на Azure зарегистрировано для этого же хранилища пространственно-временных больших данных.
./configurebackuplocation.sh --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 spatiotemporal --location 'type=fs;location=/net/sharedmachine/ge_bu;name=fshare'
В данном примере местоположение архива на AWS указано для хранилища пространственно-временных больших данных. Имя, awsloc, назначается резервному местоположению.
configurebackuplocation --operation register --store spatiotemporal --location 'type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0'
В данном примере местоположение архива на Azure зарегистрировано для хранилища пространственно-временных больших данных.
configurebackuplocation --operation register --store spatiotemporal --location 'type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount'
В этом примере корзина 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 /net/sharedmachine/ge_bu false awsloc s3 mybucket true mazloc azure myblobs false
configuredatastore
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
После установки ArcGIS Data Store вы можете запустить утилиту configuredatastore, чтобы создать хранилище данных и зарегистрировать его на сайте GIS Server. Вы можете создать следующие типы хранилищ данных при помощи этих команд:
- Хранилище данных для данных размещенного векторного слоя (реляционное хранилище данных)
- Хранилище данных для полистных кэшей размещенного слоя сцены (хранилище данных полистного кэша)
- Хранилище для данных, которые создали запущенные Инструменты геоаналитики, или хранилище данных для сохранения данных наблюдений из ArcGIS GeoEvent Server (хранилище больших пространственно-временных данных)
Для перенастройки хранилища больших пространственно-временных данных после его обновления можно также запустить утилиту configuredatastore.
Синтаксис
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores <relational|tileCache|spatiotemporal>] [--nosql-only true|false]
URL-адрес администратора сайта ArcGIS Server имеет вид: https://gisserver.domain.com:6443. Обратите внимание на то, что даже если сайт GIS Server использует веб-адаптер, вы должны предоставить URL-адрес в указанном выше формате.
Введите имя пользователя и пароль для учетной записи (встроенной, не корпоративной), которая имеет права доступа администратора сайта GIS Server.
Директория данных – это желаемое местоположение на локальном компьютере, где будут создаваться файлы хранилища данных.
Хотя это не рекомендуется, вы все же можете настроить несколько типов хранилищ данных на одном компьютере, используя список типов, разделенных запятыми (без пробелов). Например, чтобы на одном компьютере с общей директорией хранилища данных настроить и реляционное, и хранилище данных полистного кэша, укажите --stores relational,tileCache. Esri настоятельно рекомендует использовать хранилища пространственно-временных больших данных на отдельных компьютерах, отдельно от других хранилищ данных или ПО .
Прежние версии:
В предыдущих версиях опцию --nosql-only можно было задать как true, чтобы создать хранилище данных только для листов кэша слоя сцены. Эта опция все ещё существует, чтобы существующие скрипты могли продолжать работать. Все новые скрипты надо вместо этого настраивать на опцию --stores для tileCache.
Настройка определённого типа хранилища данных
Вы можете настроить ArcGIS Data Store для данных размещённого векторного слоя, указав relational с опцией --stores.
Для публикации размещённого слоя сцены вам понадобятся хранилище данных для кэша сцены и хранилище данных для размещённых векторных слоёв, поскольку ArcGIS при публикации размещённого слоя сцены создаёт размещённый векторный слой, размещённый слой сцены и кэш сцены. Можно указать relational,tileCache с опцией --stores для настройки хранилищ обоих типов либо задать только tileCache с опцией --stores и использовать свою управляемую базу данных в качестве хранилища данных для размещённых векторных слоёв.
Если вы используете ArcGIS GeoEvent Server и хотите хранить высокообъёмные и высокоскоростные данные наблюдений, создайте хранилище больших пространственно-временных данных, указав spatiotemporal с опцией --stores.
Более подробно о работе с хранилищами пространственно-временных больших данных см. справку ArcGIS GeoEvent Server.
Если вы хотите использовать Инструменты геоаналитики в Map Viewer или из ArcGIS Pro, создайте хранилище пространственно-временных больших данных, указав spatiotemporal с опцией --stores.
Если вы захотите с помощью скрипта создать на нескольких компьютерах хранилища пространственно-временных больших данных, то сначала надо настроить одно из этих хранилищ с GIS Server, и только после этого вы сможете с помощью скрипта создать на других компьютерах, дополнительные хранилища пространственно-временных больших данных.
Можно создать несколько типов хранилищ данных на одном компьютере. Однако Esri не рекомендует вам этого делать, поскольку хранилища данных будут конкурировать за память и другие ресурсы, что отрицательно скажется на производительности или вообще всё перестанет работать.
Настройка хранилищ данных после обновления инсталляций ArcGIS Data Store
В рамках обновления ArcGIS Data Store, вы должны переконфигурировать имеющиеся компьютеры с хранилищами данных. После установки новой версии ArcGIS Data Store поверх существующего ArcGIS Data Store на всех компьютерах с хранилищем данных, вы можете записать журнал первичных машин с реляционным или кэша листов хранилищем данных и запустить утилиту configuredatastore для завершения обновления хранилищ данных. Когда вы запускаете утилиту с основной машины, резервная машина с реляционным или кэшем листов тоже обновляется.
Если ваша основная машина содержит и реляционное и кэша листов хранилище данных, укажите --stores relational,tileCache при запуске утилиты configuredatastore, и она обновит основное и резервное реляционное и кэша листов хранилища данных.
Чтобы переконфигурировать обновлённые машины с хранилищем пространственно-временных больших данных, зайдите на одну из машин с этим хранилищем и запустите утилиту configuredatastore. Это обновит все компьютеры с хранилищем пространственно-временных больших данных.
Обратите внимание, что если вы не установили новую версию ArcGIS Data Store на все машины, конфигурация выполнена не будет.
Пример
В этом примере создается хранилище данных для данных размещенного векторного слоя (реляционное хранилище данных). URL-адрес сайта GIS Server, который будет использоваться для хранилища данных - https://gisserver.domain.com:6443, имя пользователя и пароль администратора сайта - admin и Iph33l$ik соответственно, а папка для хранилища данных - /dstore/data.
./configuredatastore.sh https://gisserver.domain.com:6443 admin Iph33l$ik /dstore/data --stores relational
deletebackup
Используется с реляционными хранилищами данных.
Утилита deletebackup позволяет удалять созданные вами архивные файлы реляционного хранилища данных. Сначала запустите утилиту listbackups, чтобы просмотреть имена и время создания архивных файлов. Затем вы можете запустить утилиту deletebackup, чтобы удалить ненужные архивные файлы.
Обратите внимание, что вы можете удалить только те архивы, которые не требуются для восстановления вашего хранилища данных. Например, вы не можете удалить самую последнюю резервную копию реляционного хранилища данных.
Синтаксис
deletebackup <backup name> [--prompt <yes | no>]
Пример
./deletebackup.sh featuresMarchbu You are attempting to delete backup 'featuresMarchbu'. 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.
- Пороговое значение объема памяти на жестком диске, при котором реляционное хранилище данных будет переведено в режим только для чтения, а хранилища пространственно-временных больших данных и данных полистного кэша будут остановлены.
- Местоположения архива, используемые каждым типом хранилища данных
- Находится ли на общем сетевом ресурсе реляционное хранилище данных или хранилище данных полистного кэша
- Как часто создается резервная копия хранилища данных (График резервного копирования)
- Число дней хранения файлов архивов реляционного хранилища данных
- Работает ли в данный момент хранилище данных (Состояние хранилища данных)
- Дата и время, когда автономное реляционное хранилище данных или хранилище данных полистного кэша стало основным хранилищем данных (Last failover – Последний сбой); не отображается, если сбоев никогда не случалось
- Имена компьютеров, участвующих в реляционном хранилище данных или хранилище данных полистного кэша (Участвующие компьютеры)
- Максимально допустимое количество подключений к реляционному хранилищу данных
- URL-адрес сайта GIS Server, на котором зарегистрировано данное хранилище данных (URL-адрес системы владельца)
- URL-адрес портала, использующего сайт GIS Server в качестве своего хост-сервера (URL-адрес портала)
- Количество текущих подключений векторного слоя к реляционному хранилищу данных
- Список всех компьютеров, в данный момент участвующих в хранилище пространственно-временных больших данных (Компьютеры в пространственно-временном кластере)
- Компьютер хранилища больших пространственно-временных данных, настроенный в настоящий момент в качестве основного (Текущий основной компьютер в кластере)
- Список всех компьютеров в кластере хранилища пространственно-временных больших данных (Зарегистрированные пространственно-временные компьютеры); отображаются все компьютеры кластера, независимо от их статуса
Синтаксис
describedatastore
Пример
Утилита describedatastore возвращает общую информацию, применимую ко всем хранилищам данных, расположенным на компьютере, и особые отдельные разделы с информацией о каждом типе хранилищ данных.
Хотя скорее всего на разных компьютерах у вас будут разные хранилища данных, тем не менее ниже показан компьютер со всеми тремя типами хранилищ, и вы можете видеть разные разделы для каждого типа хранилищ.
./describedatastore.sh
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....10.5.0.7777 Staging location............./arcgis/datastore/staging Log location................./arcgis/datastore/logs Free disk space..............174.00GB Threshold for READONLY mode..1024MB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location.........../net/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 Last failover.............20150130190334005 Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM Maximum connections.......150 Owning system URL.........https://gisserver.domain.com:6443/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal Number of connections.....8 connection(s) to managed database
Information for tile cache data store ds_wztxj7um
==============================================================
Tile cache location......./arcgis/datastore/nosqldata Data location............./arcgis/datastore/nosqldata Data store status.........Started Last failover.............20150130190334005 Backup location.........../arcgis/datastore/backup Is backup folder shared...false Member machines...........MACHINE1.DOMAIN.COM Owning system URL.........https://gisserver.domain.com:6443/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal
Information for spatiotemporal big data store ds_qpko99Cl
==============================================================
Max rebalance off time..............60 minutes Automatic rebalance ................On Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM Current master machine in cluster...MACHINE1.DOMAIN.COM Registered spatiotemporal machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver.domain.com:6443/arcgis/adminexportmanageddb
Прежние версии:
Esri считает утилиту exportmanageddb устаревшей, начиная с версии 10.5.1. Ее функциональность была встроена в утилиту backupdatastore. Утилита exportmanageddb присутствует, чтобы позволить существующим скриптам продолжить работать корректно, но вам необходимо начать использовать вместо нее утилиту backupdatastore для создания файла резервной копии, а затем использовать утилиту restoredatastore для восстановления хранилища данных из файла резервной копии.
Используется для реляционных хранилищ данных и хранилищ данных полистного кэша.
Утилита exportmanageddb создаёт файл дампа реляционного хранилища данных, метаданные об этом хранилище данных и все базы данных, в которых хранится полистный кэш размещённого слоя сцены. Экспортируйте это хранилище данных, если вам необходимо создать резервную копию для восстановления установки ArcGIS Data Store на компьютере с другой операционной системой или другой версией ArcGIS Data Store.
Убедитесь, что никто не редактирует векторные слои и не выполняет публикацию на вашем портале, перед тем, как импортировать хранилище данных на новый компьютер. Также проверьте, что местоположение, куда вы экспортируете хранилище данных, содержит достаточно свободного места для файла дампа реляционного хранилища данных и копий всех баз данных полистного кэша размещённого слоя сцены.
Утилита exportmanageddb не выполняет экспорт хранилища пространственно-временных больших данных.
Синтаксис
exportmanageddb <output location> <backup name> [options]
Выходное местоположение - место на диске, где будут созданы папка (<backup name>) и файлы экспорта. Вам требуются права доступа для записи данных в эту директорию.
Поддерживаются следующие опции:
- [--stores {relational|tileCache}]: Указывает, какой тип хранилища данных вы хотите экспортировать. Если реляционное хранилище данных и хранилище данных полистного кэша размещены на одном компьютере, и вы хотите экспортировать оба этих хранилища, укажите их, разделив запятой, например: --stores relational,tileCache. Если не указать опцию --stores, предполагается, что это хранилище реляционных данных.
- [--include-tilecache <true|false>]: Эта опция нужна только для обратной совместимости. Если опция --stores не задана или указано --stores relational, то вы можете проверить, было ли с помощью этой опции экспортировано хранилище данных полистного кэша или нет.
- [--prompt {yes|no}]: Определяет, надо ли будет отвечать на приглашение запустить утилиту.
Пример
В следующем примере дамп-файл, копии баз данных кэша размещённого слоя сцены и связанные файлы хранилища данных перемещены в общую сетевую папку, которая называется movedsfirstexp и находится на сервере с именем backupserver.
./exportmanageddb.sh preupgradeexp /net/backupserver movedsfirstexp --stores relational,tileCache You are attempting to back up database 'db_e3hsm'. This 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
importmanageddb
Используется для реляционных хранилищ данных и хранилищ данных полистного кэша.
Если вы выполнили экспорт ArcGIS Data Store, содержащего базы данных размещенного векторного слоя или кэша размещенного слоя сцены (или обоих), можно использовать утилиту importmanageddb для восстановления хранилища данных. Можно использовать восстановление для обновления компьютера ArcGIS Data Store или для установки ArcGIS Data Store на компьютере с операционной системой, отличной от исходного ArcGIS Data Store.
Если вы хотите, чтобы ArcGIS Data Store было зарегистрировано на том же сайте GIS Server, что и раньше, укажите --bound true и не задавайте --server-url. Учтите, что --bound задана как true по умолчанию. Обязательно перезапустите сайт GIS Server после восстановления.
Если при восстановлении вы хотите зарегистрировать хранилище данных на новом сайте GIS Server, укажите --server-url при импорте хранилища данных.
По умолчанию импортируются реляционное хранилище данных и все базы данных кэша размещённого слоя сцены, составляющие хранилище данных полистного кэша в файле экспорта. Если вы не хотите включать базы данных кэша размещённого слоя сцены, укажите опцию --include-tilecache как false.
Утилита importmanageddb не выполняет импорт хранилища пространственно-временных больших данных.
Синтаксис
importmanageddb <source backup location> <backup name> [options]
Поддерживаются следующие опции:
- [--server-url <ArcGIS Server URL registered with data store>] :Если вы указали --bound true и уже переместили свои сервисы на новый сайт GIS Server, используйте опцию --server-url, чтобы указать URL-адрес нового сайта GIS Server. Помните, пока вы не переместите сервисы на этот новый сервер, данные хранилищ будут недоступны.
- [--server-admin <user name of ArcGIS Server admin>]: эта опция требуется только при задании --bound true или если опция --bound не задана. Укажите имя пользователя администратора ArcGIS Server.
- [--server-password <password of ArcGIS Server admin>]: эта опция требуется только при задании --bound true или если опция --bound не задана. Введите пароль администратора ArcGIS Server.
- [--data-dir <data store data directory>]: Директория ArcGIS Data Store. По умолчанию, ею является директория ArcGIS Data Store зарегистрированных на данный момент хранилищ данных.
- [--stores {relational|tileCache}]: Показывает, какой тип хранилища вы хотите импортировать. Если реляционное хранилище данных и хранилище данных полистного кэша размещены на одном компьютере, и вы хотите импортировать оба этих хранилища, укажите их, разделив запятой, например: --stores relational,tileCache. Если не указать опцию --stores, предполагается, что это хранилище реляционных данных.
- [--include-tilecache <true|false>]: Эта опция нужна только для обратной совместимости. Если опция --stores не задана или указано --stores relational, то вы можете проверить, было ли с помощью этой опции восстановлено хранилище данных полистного кэша или нет.
- [--bound {true|false}]
- Если указано --bound trueили опция --bound не задана, необходимо ввести URL-адрес сайта GIS Server с опцией --server-url и указать учетные данные администратора ArcGIS Server с опциями --server-admin и --server-password. Если вы выполняете импорт на тот же сайт GIS Server, на котором был зарегистрирован ArcGIS Data Store при экспорте хранилища данных, необходимо указать адрес URL для этого сайта GIS Server и предоставить учетные данные администратора ArcGIS Server. Чтобы привязать хранилище данных к новому сайту GIS Server, введите адрес URL и учетные данные администратора этого нового сайта.
Примечание:
Указывайте информацию для нового сайта GIS Server только в том случае, если вы уже переместили свои веб-сервисы на этот новый сайт GIS Server.
- Если хранилище данных больше не будет использовать сайт GIS Server, который использовался ранее, и вы ещё не переместили все свои веб-сервисы на новый сайт GIS Server, укажите --bound false. Затем вам необходимо запустить утилиту registerdatastore, чтобы настроить хранилище данных с новым сайтом GIS Server после того, как вы переместите на него свои сервисы.
- Если указано --bound trueили опция --bound не задана, необходимо ввести URL-адрес сайта GIS Server с опцией --server-url и указать учетные данные администратора ArcGIS Server с опциями --server-admin и --server-password. Если вы выполняете импорт на тот же сайт GIS Server, на котором был зарегистрирован ArcGIS Data Store при экспорте хранилища данных, необходимо указать адрес URL для этого сайта GIS Server и предоставить учетные данные администратора ArcGIS Server. Чтобы привязать хранилище данных к новому сайту GIS Server, введите адрес URL и учетные данные администратора этого нового сайта.
- [--prompt {yes|no}]: Определяет, надо ли будет отвечать на приглашение запустить утилиту.
Пример
В следующем примере хранилище данных восстановлено в более новой версии установки ArcGIS Data Store. Указана директория данных нового ArcGIS Data Store. Хранилище данных все ещё привязано к существующему сайту GIS Server, поэтому хранилище данных и существующие размещённые векторные слои и слои сцены продолжают работать. Перезапустите сайт GIS Server, чтобы разрешить публикацию размещенного векторного слоя и слоя сцены на новом компьютере.
./importmanageddb.sh /net/backupserver/expdir preupgradeexp --source-loc --data-dir /usr/arcgis/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s --bound true
В этом примере сайт GIS Server и реляционное хранилище данных были перемещены на новые компьютеры. Веб-сервисы уже перенесены на новый сайт GIS Server, поэтому для опции --server-url указан новый URL-адрес сайта. Имя резервной копии - movedbexp, и она хранится на /net/backupserver/expdir.
./importmanageddb.sh /net/backupserver/expdir movedbexp --data-dir /usr/arcgis/datastore --server-admin siteadmin --server-password SAup.4s --stores relational --bound true --server-url https:\\newgisserver.domain.com:6443
В данном примере веб-сервисы не были перенесены на новый сайт GIS Server. Хранилища данных полистного кэша и реляционные хранилища данных не будут работать, пока не будут перенесены сервисы, и пока вы не зарегистрируете это хранилище данных на новом сайте GIS Server. Имя резервной копии - movedsfirstexp, и она хранится на /net/backupserver/expdir/movingexp2.
./importmanageddb.sh /net/backupserver/dbdump/movingexp2 movedsfirstexp --data-dir /usr/arcgis/datastore --stores relational,tileCache --bound false
listadminusers
Используется с реляционными хранилищами данных.
Утилита listadminusers выводит имена пользователей и пароли для администратора, владельца реплики и администратора базы геоданных реляционного хранилища данных.
Синтаксис
listadminusers
Пример
./listadminusers.sh Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_11zyx / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
listbackups
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и хранилищ пространственно-временных больших данных. При запуске для хранилища реляционных данных или для хранилища данных полистного кэша утилита listbackups будет работать только на основном компьютере хранилища.
Утилита listbackups возвращает имена файлов резервных копий и местоположение, в которое они записываются. Утилита listbackups также возвращает состояние резервного копирования (завершено или нет), время начала, а также информацию о режиме, который использовался при создании архива (ручной или автоматический режим) посредством ArcGIS Data Store.
Когда вы запускаете утилиту listbackups для хранилищ пространственно-временных больших данных, укажите местоположение резервной копии, для которого хотите видеть список файлов резервных копий. Если не указать местоположение, утилита listbackups возвращает резервные копии для местоположения резервных копий по умолчанию.
Вы можете использовать утилиту listbackups, чтобы узнать, завершилось ли резервное копирование или ещё продолжается, определить, сколько у вас резервных копирований в ручном режиме, или чтобы подтвердить имя файла перед запуском утилиты deletebackup.
Синтаксис
listbackups [--store <relational|tileCache|spatiotemporal>] [--location '<location_arguments>']
Если вы не укажете тип хранилища данных, утилита выдаст список резервных копий всех хранилищ, работающих на компьютере, на котором запущена эта утилита.
Параметр location поддерживается для больших хранилищ пространственно-временных данных и реляционных хранилищ данных. Аргументы следующие:
- name=: Имя местоположения резервной копии. Вы указали это имя, когда настраивали местоположение резервной копии или если не указали имя, то ArcGIS Data Store присвоил имя по умолчанию.
- location=: Либо путь к общей файловой директории, имя корзины S3 или имя контейнера хранилища blob.
Пример
В данном примере резервные копии хранилищ пространственно-временных больших данных перечислены для местоположения резервных копий под названием sbdsbu:
./listbackups.sh --store spatiotemporal --location 'name=sbdsbu' Backup_Name Status Backup_Time Mode ==================================================================================== backup1 BackupComplete 2016-07-11 09:47 manual Backups located at: '/net/myserver.ntw.com/spatiotemporal'
listmanageduser
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Утилита listmanageduser возвращает имя пользователя и пароль учётной записи, которая является владельцем данных размещённого векторного слоя реляционного хранилища данных и хранилища пространственно-временных больших данных. Кроме того, эта утилита возвращает имя пользователя и пароль владельца данных для хранилищ данных полистного кэша.
Синтаксис
listmanageduser
Пример
В следующем примере listmanageduser запущена на основном компьютере, содержащем реляционное хранилище данных и хранилище данных полистного кэша.
./listmanageduser.sh
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.sh
Managed user for spatiotemporal big data store bds_6udbx4321 ================================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
registerdatastore
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Хранилище данных сохраняет информацию об именах компьютеров сайта GIS Server. Если вы переместите сайт GIS Server на другие компьютеры (например, в случае приобретения нового компьютера или поломки имеющегося компьютера с GIS Server), то в этом случае, чтобы удалить эту информацию, вы должны отменить регистрацию хранилища данных на сайте GIS Server. Как только GIS Server будет настроен на новом компьютере (или компьютерах), вы можете зарегистрировать хранилище данных на сайте GIS Server с помощью командной утилиты registerdatastore.
Обратите внимание, что эта утилита используется для регистрации хранилища данных на том же сайте GIS Server, на котором оно было зарегистрировано ранее. Это хранилище данных содержит данные для размещенных слоев на существующем сайте GIS Server. При регистрации этого хранилища на другом сайте GIS Server не происходит повторного создания размещённых векторных слоёв, кэшей слоёв сцены или архивов данных потокового сервиса.
Утилиту registerdatastore можно запустить только на компьютере с основным реляционным хранилищем данных или хранилищем данных полистного кэша. Ее можно запустить на любом компьютере с хранилищем больших пространственно-временных данных.
Синтаксис
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password> --stores <relational|tileCache|spatiotemporal>
Хотя это и не рекомендуется, если у вас на одном компьютере установлено несколько типов хранилищ данных, вы можете одновременно их зарегистрировать, указав их типы и разделив их запятыми (без пробелов). Например, введите --stores relational,tileCache.
Пример
В этом примере реляционное хранилище данных зарегистрировано на сайте GIS Server с URL https://gisserver.domain.com:6443. Имя пользователя основного администратора сайта ArcGIS Server – agsadmin, а пароль – Tan$p0n.
./registerdatastore.sh https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational
removemachine
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Используйте утилиту removemachine, чтобы удалить из установки ArcGIS Data Store что-то из следующего:
- Удалить резервный компьютер из реляционного хранилища данных. Может быть запущен только на отдельной машине или с основной машины в случае, если отдельная недоступна.
- Удалить резервный компьютер из хранилища данных полистного кэша. Может быть запущен только на отдельной машине или с основной машины в случае, если отдельная недоступна.
- Удалить компьютер из реляционного хранилища пространственно-временных больших данных. Обратите внимание, что невозможно запустить removemachine в хранилище пространственно-временных больших данных, состоящем только из одного компьютера.
Синтаксис
removemachine <machine name> --store <relational|tileCache|spatiotemporal> [--force <true | false>] [--prompt <yes | no>]
--force: По умолчанию установлено false. Укажите true с этой опцией только если зарегистрированный сайт ArcGIS Server недоступен.
--prompt: По умолчанию установлено yes. Если вы не хотите подтверждать действие, укажите с этой опцией no.
Пример
В этом примере компьютер хранилища пространственно-временных больших данных, gefour, удалён из хранилища данных.
./removemachine.sh gefour --store spatiotemporal
В этом примере сайт хост-сервера недоступен и компьютер реляционного хранилища данных fsdata удалён из хранилища данных.
./removemachine.sh fsdata --store relational --force true
removestandbymachine
Прежние версии:
Esri считает утилиту removestandbymachine устаревшей. Она все ещё присутствует, чтобы существующие скрипты продолжали работать, но вместо неё уже надо использовать утилиту removemachine.
Вы можете использовать команду remove ArcGIS Server REST от администратора сайта ArcGIS Server, чтобы удалить резервный компьютер из реляционного хранилища данных или хранилища данных полистного кэша. Но если сайт GIS Server недоступен, вы не сможете войти на сайт под учётной записью администратора, чтобы это выполнить. В таких случаях запустите утилиту removestandbymachine, чтобы удалить резервный компьютер из хранилища данных.
Утилиту removestandbymachine можно запустить только на резервном компьютере реляционного хранилища данных или хранилища данных полистного кэша.
Синтаксис
removestandbymachine <machine name> --store <relational|tileCache> [--prompt <yes | no>]
restoredatastore
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Если вы потеряете доступ к данным, которые используются размещёнными на портале векторными слоями, слоями сцен или архивированными данными реального времени, используйте архивные файлы и утилиту командной строки restoredatastore, чтобы восстановить хранилище данных.
Если вы не может восстановить хранилище данных, установите ArcGIS Data Store на новый компьютер, не настраивая его, и восстановите архив на этом компьютере.
Если вы используете реляционное хранилище данных и хотите откатить размещённый векторный слой назад на определённое время в прошлом, выполните восстановление поверх существующего реляционного хранилища. Обратите внимание, что восстановить можно только то состояние реляционного хранилища данных в прошлом, для которого имеются и доступны файлы резервной копии. Например, если вы сохраняете архивы только за пять дней, то и хранилище данных может быть восстановлено до момента времени в пределах этих пяти дней.
Утилиту restoredatastore можно запустить на основном компьютере с реляционным хранилищем данных или хранилищем данных полистного кэша. Ее можно запустить на любом компьютере с хранилищем больших пространственно-временных данных.
Синтаксис
restoredatastore [options]
Поддерживаются следующие опции:
- [--store {relational|tileCache|spatiotemporal}]
- [--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}] Эта опция поддерживается только реляционными хранилищами данных.
- [--source-loc <location of source backup files>]: Для пространственно-временных больших хранилищ данных вы можете указать имя места резервного копирования или указать местоположение резервной копии S3 или Azure с помощью этой опции. Начиная с версии 10.6.1, вы также можете использовать эту опцию с хранилищами реляционных данных, чтобы задать расположение архива в файловом хранилище, на S3 или Azure. Если вы задаете вторичное местоположение архива для хранилища реляционных данных, вместо используемого по умолчанию, опция --target задается согласно имени файла архива. Для хранилищ данных полистного кэша можно задать только путь к файловому хранилищу, эта опция требуется для хранилищ данных полистного кэша только при восстановлении на новом компьютере.
- [--bound {true | false}]: Опция --bound поддерживается только для реляционных и полистных хранилищ данных.
- [--data-dir <new data store directory>]: используйте --data-dir, если вы восстанавливаете хранилище данных на новом компьютере. При восстановлении на новом компьютере, необходимо задать опцию --source-loc.
- [--server-url <ArcGIS Server URL registered with data store>]: Если вы указали --bound true для сохранения хранилища данных, зарегистрированного на том же сайте GIS Server, на котором оно было зарегистрировано при создании резервной копии, укажите адрес URL этого сайта GIS Server. Если вы задали --bound true и уже переместили свои веб-сервисы на новый сайт GIS Server воспользуйтесь опцией --server-url для задания URL нового сайта GIS Server. Помните, что если вы указали URL нового сайта и пока вы не переместите сервисы на этот новый сервер, данные хранилищ будут недоступны.
- [--server-admin <user name 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.
- [--prompt {yes | no}]
При восстановлении после сбоя или для перемещения реляционного хранилища данных укажите --target most-recent. При восстановлении реляционного хранилища данных по состоянию на определённый момент времени укажите дату и время (универсальное координированное время – UTC), которые вы желали бы восстановить для этого хранилища данных. Если вы хотите восстановить определенный архивный файл, укажите имя этого файла. Если файл не задан, будет восстановлен самый последний архив.
По умолчанию восстановленное хранилище данных привязано к своему сайту GIS Server. Чтобы восстановить хранилище данных без сохранения привязки хранилища данных к сайту GIS Server, достаточно указать --bound false. Это можно делать только в крайнем случае, если прежний сайт GIS Server потерян без возможности восстановления; вы можете восстановить это хранилище данных без привязки и настроить его с новым интегрированным сайтом GIS Server. Однако слои, которые использовали данные из хранилища, прекратят свое существование. Вам придется подключиться к базе данных хранилища данных, чтобы извлечь данные в другой формат и заново опубликовать их на портале.
Примеры
В этом примере, самый свежий архив поступает из хранилища реляционных данных по умолчанию и будет восстановлен в имеющемся хранилище данных. Поскольку типом хранилища по умолчанию является реляционное, и оно по умолчанию остается привязанным к сайту GIS Server, на котором оно зарегистрировано, указывать --store relational или --bound true необязательно. Однако не нужно задавать URL-адрес GIS Server и учетные данные администратора.
./restoredatastore.sh --target most-recent --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
В этом примере реляционное хранилище данных со включенным восстановлением на определенный момент времени восстанавливается из хранилища реляционных данных по умолчанию в состояние, в котором оно было в 14:30. (UTC) 17 июля 2014 г.
./restoredatastore.sh --target 2014-07-17-14:30:00 --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
В этом примере, реляционное хранилище данных восстанавливается на новом компьютере из файла архива movedatastore. При восстановлении на новом компьютере, необходимо указать местоположения файла архива и новой директории данных ArcGIS Data Store. Поскольку размещенные сервисы объектов по-прежнему работают на том же сайте GIS Server, на котором зарегистрировано реляционное хранилище данных, --bound true не требуется, но URL-адрес GIS Server и учетные данные администратора необходимы.
./restoredatastore.sh --target movedatastore --source-loc /net/buserver/data/backups --data-dir /usr/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
В следующем примере хранилище данных полистного кэша восстанавливается на новом компьютере. При восстановлении на новом компьютере, необходимо указать местоположения файла архива и новой директории данных ArcGIS Data Store. Поскольку сервисы сцен по-прежнему работают на том же сайте GIS Server, на котором зарегистрировано хранилище данных кэша, --bound true не требуется, но URL-адрес GIS Server и учетные данные администратора необходимы.
./restoredatastore.sh --source-loc /net/buserver/scenedata/backups --data-dir /usr/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
В данном примере резервный файл хранилища пространственно-временных больших данных (bds1) восстановлен из именованного местоположения резервной копии (awsloc).
./restoredatastore.sh --target bds1 --store spatiotemporal --source-loc 'name=awsloc' --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
Подробные шаги и пример восстановления хранилища больших пространственно-временных данных после сбоя оборудования см. в разделе Восстановление хранилища данных.
revokeconnection
Используется с реляционными хранилищами данных.
Если вы используете утилиту allowconnection для того, чтобы разрешить клиенту напрямую подключаться к реляционному хранилищу данных, можно отключить возможность подключения, запустив утилиту revokeconnection.
Утилиту revokeconnection можно запустить только на основном компьютере реляционного хранилища данных.
Синтаксис
revokeconnection <host name> <user name> [<database>]
Пример
В данном примере база данных хранилища данных не будет воспринимать подключения, выполненные с компьютера workcom при входе в систему от имени пользователя hqo.n_1E7.
./revokeconnection.sh workcom bn0_3Wa.m hqo.n_1E7
unregisterdatastore
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
Можно использовать утилиту командной строки unregisterdatastore для следующих действий:
- Отмените регистрацию основного компьютера реляционного хранилища данных или хранилища данных полистного кэша на сайте GIS Server. Сделайте это только в том случае, если вы удалили размещённые векторные слои, слои кэша и слои сцен, которые используют данные из этого хранилища данных. В противном случае вы получите неиспользуемые слои, оставшиеся на портале, и неиспользуемые сервисы, запущенные на размещенном сервере.
Заметьте, что если имеется резервный компьютер, то сначала вы должны удалить его из хранилища данных и только потом отменить регистрацию основного компьютера.
- Отменить регистрацию хранилища пространственно-временных больших данных, размещенного на одном компьютере.
Вы можете отменить регистрацию хранилища данных на сайте GIS Server, если вы решили, что больше не будете использовать это хранилище данных или зависящие от него сервисы. При отмене регистрации компьютера в хранилище данных, сайт GIS Server больше не сможет подключаться к этому компьютеру, а все сервисы, которые содержали данные из этого хранилища данных, работать больше не будут. Эта команда не удаляет данные, однако, если хранилище данных все-таки нужно, можно использовать утилиту registerdatastore или configuredatastore, чтобы восстановить его.
Утилиту unregisterdatastore можно запустить только на основном компьютере реляционного хранилища данных или хранилища данных полистного кэша после того, как вы запустите removemachine, чтобы удалить резервный компьютер. Утилиту unregisterdatastore можно запустить для хранилища больших пространственно-временных данных, только когда у вас останется один компьютер после запуска removemachine, чтобы удалить все другие компьютеры хранилища больших пространственно-временных данных.
Синтаксис
unregisterdatastore --stores <relational|tileCache|spatiotemporal> [--prompt {yes | no}]
Если у вас установлено несколько типов хранилищ данных на одном компьютере, и вы хотите отменить регистрацию более одного за один раз, сформируйте список типов, разделив из запятыми (без пробелов). К примеру, чтобы отменить регистрацию реляционного хранилища данных и хранилища данных полистного кэша, введите --stores relational,tileCache.
Пример
Здесь утилита unregisterdatastore запущена, чтобы отменить регистрацию реляционного хранилища данных и хранилища данных полистного кэша на сайте GIS Server. В режиме по умолчанию запрашивается подтверждение. Чтобы подсказки не выводились, укажите --prompt No.
./unregisterdatastore.sh --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.sh 10
updatebackupschedule
Используется для реляционных хранилищ данных, хранилищ данных полистного кэша и пространственно-временных хранилищ больших данных.
По умолчанию ArcGIS Data Store создает полный архив реляционного хранилища данных каждые четыре дня. С помощью утилиты updatebackupschedule вы можете изменить частоту, с которой будет производиться полная архивация.
По умолчанию автоматическое создание архивов хранилищ больших пространственно-временных данных и хранилищ полистного кэша не предусмотрено. Чтобы задать расписание автоматического архивирования для хранилища больших пространственно-временных данных, сначала необходимозадать корректное местоположение резервной копии.
Укажите время начала, используя 24-часовую систему: для полуночи – 00:00:00, для часа дня (13:00) – 13:00:00. Используйте опцию частоты, чтобы указать количество дней между созданием резервных копий. Чтобы отключить автоматическое создание архивов, задайте частоту равной 0. Если вы отключаете автоматическое создание архивов, не забывайте запускать утилиту backupdatastore, чтобы создавать резервные копии вручную.
Утилиту backupdatastore можно запустить на основном компьютере с реляционным хранилищем данных или хранилищем данных полистного кэша. Этот инструмент может быть запущен на любом компьютере с хранилищем больших пространственно-временных данных.
Синтаксис
updatebackupschedule [--store relational|tileCache|spatiotemporal] [--starttime <local server time>] --frequency <number of days>
Если вы не зададите новое начальное время, существующее начальное время не изменится. Если тип хранилища данных не указан, предполагается реляционное хранилище данных.
Пример
В этом примере полные резервные копии реляционного хранилища данных будут созданы в 23-00. (локальное время сервера) через каждые 10 дней:
./updatebackupschedule.sh --starttime 23:00:00 --frequency 10
В данном примере расписание архивирования задано для хранилища данных полистного кэша. После выполнения начальным архивированием копирования всех баз данных хранилища полистного кэша ArcGIS Data Store копирует вновь созданные базы данных хранилища в местоположение, указанное в configurebackuplocation, каждые 14 дней.
./updatebackupschedule.sh --store tileCache --frequency 14
updatelicense
Используется с реляционными хранилищами данных.
Если срок действия лицензии ArcGIS Server истекает, необходимо обновить лицензию на сайте ArcGIS Server. Информация о лицензии также хранится в реляционном хранилище данных ArcGIS Data Store; поэтому, после обновления лицензии для сайта ArcGIS Server, с помощью которого настроено хранилище данных, вы должны обновить лицензию хранилища данных. Чтобы сделать это, запустите утилиту updatelicense с компьютера, на котором установлен основной ArcGIS Data Store. Если у вас установлен автономный ArcGIS Data Store, обновленная лицензия будет реплицирована на него.
Синтаксис
updatelicense
Пример
После того как вы обновите лицензию ArcGIS Server, запустите утилиту updatelicense для перемещения новой лицензии в хранилище данных.
./updatelicense.sh
updatesslcertificate
Используется со всеми типами хранилищ данных.
Вы можете заменить самозаверенный сертификат, используемый для аутентификации обмена данными, между хост-сервером и хранилищем данных, а также между компьютерами хранилища данных, на сертификат, проверенный и заверенный центром сертификации (CA), или на доменный сертификат.
Синтаксис
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
Пример
После получения файла сертификата, заверенного центром сертификации, запустите updatesslcertificate для замены самозаверенного сертификата ArcGIS Data Store.
./updatesslcertificate.sh /usr/files/mysignedcert.pfx ps4mycert dsmachinename