Ниже описываются доступные для администратора ArcGIS Video Server свойства. Описано каждое свойство наряду с путем, по которому оно расположено на сайте администрирования ArcGIS Video Server при переходе по URL https://machine.domain.com:21443/arcgis/admin.
Импорт корневого сертификата
Чтобы импортировать корневой сертификат, щелкните На главную > Компьютеры > MachineName > sslCertificates > importRootOrIntermediate.
Эта операция импортирует корневой и промежуточный сертификаты сервера в хранилище ключей (keystore). Чтобы создать сертификат качества, заверенный CA, добавьте сертификаты CA к хранилищу ключей, которое включает механизм SSL для проверки достоверности CA (а также заверяемых им сертификатов). Поскольку большинство популярных сертификатов СА доступны в хранилище ключей, вы можете использовать эту операцию, если у вас есть пользовательский СА или особые промежуточные сертификаты.
Обновление конфигурации безопасности
Чтобы обновить конфигурацию безопасности, щелкните Home (На главную) > Security > Config > Update.
Эта операция обновляет конфигурацию безопасности, включая протоколы TLS и наборы шифров для вашего сайта ArcGIS Video Server. Эта операция приводит к тому, что конечные точки сервиса REST должны быть заново развернуты на каждом компьютере сайта. Если вы обновили протокол сообщения, как часть этой операции, то ArcGIS Web Adaptor понадобится одна минута, чтобы распознать изменения в протоколе коммуникации на сайте.
Редактирование системных свойств
Администраторы могут править свойства ArcGIS Video Server, чтобы он максимально подходил для организации. Пользовательские значения свойств можно задавать в https://machine.domain.com:21443/arcgis/admin/system/properties/update. При настройки пользовательского системного свойства необходимо указать корректный объект JSON. Одновременно может быть установлено несколько системных свойств, если они связаны вместе как допустимый JSON. Ниже приведен пример:
{
"maxFrameCount": 1000,
"maxFileUploadSize": 5000
}
Определите максимальное количество фреймов.
Максимальное количество фреймов определяет их максимальное количество, которое может быть возвращено при операции создания набора фреймов. Минимально допустимое максимальное число фреймов равно 100.
Значение по умолчанию равно 1000 фреймов, например, {"maxFrameCount": 1000}.
Определите максимальный размер файла для загрузки
Максимальный размер загружаемого файла устанавливает максимальный порог для размера одного файла, который может быть загружен на видеосервер при публикации видеофайлов. Если во время публикации будет загружен файл, размер которого превышает этот максимальный размер, процесс завершится неудачей. Максимальное значение, которое может быть установлено для этого свойства, составляет 10 ГБ (10000). Если для этого свойства установлено значение 0 ГБ, публикация видеофайлов будет отключена.
Значение по умолчанию равно 5 ГБ, например, {"maxFileUploadSize":"5000"}.
Задать источник данных высот
Администратор может определить источник данных высот, используемый для ортотрансформации вычисленного полигона контура каждого изображения. В качестве источника можно установить ID элемента сервиса изображений высот. Если источник высот не определен, используется постоянная высота = 0. Использование источника высот повышает точность контуров изображений.
По умолчанию используется постоянная высота = 0, но ее можно задать с помощью существующего ID элемента сервиса изображений высот, например, {"elevationSource":"a08984c643a24bfd8f8d2eb0d192357d"}.
Источники высот перечислены в конечной точке /rest/self/ и могут добавляться или удаляться из ArcGIS Video Server через конечную точку /admin/system/properties/ с помощью параметра elevationSources. При указании ID элемента сервисов изображений высот становятся доступны дополнительные опции.
Настройка ArcGIS Web Adaptor
Чтобы настроить ArcGIS Web Adaptor, щелкните На главную > Система > Web Adaptors > WebAdaptorConfig.
Настройка ArcGIS Web Adaptor - это источник для всех параметров конфигурации, которые доступны на сайте Web Adaptors. Этот источник определяет общий ключ, который используется всем веб-адапторами, для шифрования битов ключевых данных во входящих запросах к серверу.
Изменение настроек журнала
Чтобы изменить настройки журнала, щелкните На главную > Журналы > Настройки > Редактировать.
Эта операция обновляет параметры журнала для всего сайта сервера, такие как расположение, уровень и формат выходных данных журнала, а также возраст файла журнала.
Установите хранилище данных элемента по умолчанию
Чтобы отредактировать хранилище данных элемента по умолчанию, щелкните На главную > Данные > Элементы > Установить элемент по умолчанию.
Хранилище данных элемента по умолчанию — это место, где после успешной операции публикации будут храниться исходные видеофайлы и соответствующие им файлы метаданных, а также выходные закодированные видеофайлы и соответствующие им файлы метаданных. По умолчанию для него установлено значение FILESYSTEM.
Регистрировать хранилище данных
Чтобы зарегистрировать существующее хранилище данных, щелкните На главную > Данные > Настройка корпоративных хранилищ данных > Отправить.
По умолчанию все файлы видео и метаданных сохраняются ArcGIS Video Server в файловой системе. Организация может зарегистрировать существующее хранилище данных объектов для использования в качестве выходного местоположения видео и метаданных. Эта процедура выполняет поиск существующего хранилища данных объекта и регистрирует его на сервере video server. Затем это хранилище данных можно установить в качестве хранилища данных по умолчанию, используя рабочий процесс Установить хранилище данных элемента по умолчанию.
Удаление сайта
Чтобы удалить сайт, щелкните На главную > Удалить сайт.
Эта операция удаляет конфигурацию сайта и освобождает все ресурсы сервера. Она подходит для серверов разработки и тестирования, которые нужно регулярно чистить; также ее можно выполнить перед деинсталляцией. Будьте внимательны при использовании этой опции, поскольку она удаляет все настройки и другие конфигурации, также ее нельзя отменить или восстановить.
Эта операция выполняет следующие задачи:
- Все компьютеры сервера, участвующие в этом сайте, будут остановлены.
- Для всех компьютеров сервера отменяется регистрация на сайте.
- Удаляется хранилище конфигураций.
Создание резервной копии сайта
Рекомендуется часто экспортировать настройки сайта через API администратора. Это можно сделать путем перехода к Главная > Экспорт сайта. При определении свойства destination для экспортируемого сайта укажите в качестве местоположения сетевой диск или местоположение, отличное от компьютера с ArcGIS Video Server. Назначение должно быть местоположением, доступным для компьютера ArcGIS Video Server. В случае сбоя сайта сайт можно будет восстановить, создав новый сайт сервера и перейдя на Главная > Импорт сайта.
Импорт сайта
Внимание:
Эта административная операция не доступна при входе через Web Adaptor. Воспользуйтесь этой операцией через прямой URL одного из серверов ГИС на сайте.
Эта операция импортирует конфигурацию сайта в текущий работающий сайт. Импортирование сайта означает замену всех конфигураций сайта (включая службы ГИС, конфигурации безопасности и т. д.) текущего запущенного сайта на те, которые содержатся в файле конфигурации сайта, предоставленном вами в качестве ввода. Входной файл конфигурации сайта можно получить с помощью операции exportSite.
Эта операция восстанавливает всю информацию, включенную в резервную копию, как указано в разделе Экспорт сайта ниже. После завершения эта операция возвращает отчет в качестве ответа. Просмотрите этот отчет и устраните все перечисленные в нем проблемы, чтобы сайт снова мог полноценно функционировать.
Операция importSite позволяет восстановить ваш сайт из резервной копии, созданной с помощью операции exportSite. Операция importSite использует пути к серверным директориям из экспортированной конфигурации. Эти пути должны быть доступны для успешного завершения операции importSite.
Внимание:
Эта операция восстановления требует значительных вычислений и занимает продолжительное время. По завершении этой операции может потребоваться ручное вмешательство для устранения выявленных проблем. Поскольку эта операция полностью изменяет конфигурацию сайта, рекомендуется не обращаться к сервисам ГИС и не администрировать сайт во время выполнения этой операции.
Параметры запроса
| Параметр | Детали |
|---|---|
| location | Путь к файлу экспортированной конфигурации или идентификатору, ссылающийся на сохраненную конфигурацию на сервере. Пример |
| validate | Введено в ArcGIS Enterprise 11.1. Этот параметр проверяет путь к файлу, указанный в параметре местоположение, гарантируя его доступность перед выполнением операции importSite. Если установлено значение true, путь будет проверен, и операция вернет либо ответ об успешном выполнении, либо сообщение об ошибке. Значение по умолчанию false. Значения: true | false |
| f | Формат ответа. Формат ответа по умолчанию html. Значения: html | json | pjson |
Пример использования
Далее приведен пример запроса POST для importSite:
POST /arcgis/admin/importSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=\\server\share\backup\Jan-15-2023_11-50-33.agssite&validate=true&f=pjsonЭкспорт сайта
Конфигурация сайта экспортируется в указанное вами расположение, используемое как входные данные для этой операции. Экспортированный файл включает или исключает следующую информацию:
Внимание:
Во время резервного копирования вы не сможете вносить другие административные изменения в конфигурацию сайта. Перед выполнением операции exportSite убедитесь, что выполнены все необходимые настройки сайта.
Защитная информация, не включенная в резервную копию
Как упоминалось выше, некоторая информация не включается в резервную копию сайта. Рекомендуется вручную сделать резервную копию этой информации одновременно с запуском утилиты архивирования. Когда вы будете восстанавливать этот сайт, вручную скопируйте или переместите эту информацию обратно на сайт, например:
- Сервисные данные — если данные, используемые вашими сервисами, не были скопированы в папку на сервере при публикации, они не будут включены в резервную копию. Вручную выполните резервное копирование директорий данных, баз геоданных, исходных таблиц и любой другой информации, которую используют эти сервисы. При восстановлении сайта проверьте, есть ли у ArcGIS Video Server право доступа к местоположениям с данными. Дополнительные сведения см. в разделе Предоставление доступа к данным для ArcGIS Video Server.
- Сообщения журнала – Когда сайт работает, журналы создаются и распространяются среди всех компьютеров ArcGIS Video Server, включенных в сайт. Когда вы будете восстанавливать этот сайт, переместите или скопируйте эту информацию обратно в исходную директорию журналов.
- Имя и пароль учетной записи основного администратора сайта – после восстановления сайта вы можете продолжать использовать имя пользователя и пароль учетной записи главного администратора сайта, которые действовали на момент выполнения восстановления сайта. Это происходит, даже если учетная запись основного администратора сайта была отключена. Рекомендуется записать имя пользователя и пароль и хранить их в надежном месте до выполнения восстановления.
- Статистические данные – во время работы сайта ведется запись различных статистических данных сервиса. Когда вы будете восстанавливать этот сайт, переместите или скопируйте эту информацию обратно в исходную директорию статистики.
- Настройки ArcGIS Web Adaptor – если сайт содержит один или несколько ArcGIS Web Adaptor, после восстановления необходимо будет их перенастроить для работы с сайтом. Подробные инструкции см. в разделах по настройке IIS, Java (Windows) и Java (Linux).
Параметры запроса
| Параметр | Детали |
|---|---|
| location (Дополнительный) | Путь к папке, доступной для ArcGIS Video Server, куда будет записана экспортированная конфигурация сайта. Если параметр местоположение не указан, сервер записывает экспортированный файл конфигурации сайта в каталог, принадлежащий серверу, и возвращает виртуальный путь (HTTPS URL) к каталогу. Экспортированную конфигурацию сайта можно загрузить из каталога, перейдя по возвращенному URL-адресу. Пример |
| validate | Представлено в ArcGIS Enterprise 11.1. Этот параметр проверяет путь к файлу, указанный в параметре местоположение, гарантируя его доступность перед выполнением операции importSite. Если установлено значение true, путь будет проверен, и операция вернет либо ответ об успешном выполнении, либо сообщение об ошибке. Значение по умолчанию false. Значения: true | false |
| f | Формат ответа. Формат ответа по умолчанию html. Значения: html | json | pjson |
Пример использования
Ниже приведен пример запроса POST для операции exportSite с определенным параметром местоположения:
POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=\\server\share\backup&f=jsonНиже приведен пример запроса POST для операции exportSite, демонстрирующей отсутствие определения параметра местоположения:
POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=&validate=false&f=pjsonПример ответа JSON
Приведенный ниже пример ответа относится к запросу, в котором определен параметр location.
{
status: "success",
location: "\\videoserver\share\backup\Jan-15-2013_11-50-33.agssite"
}Приведенный ниже пример ответа относится к запросу, в котором не определен параметр location.
{
status: "success",
location: "https://machine.domain.com/webadaptor/admin/uploads/i33d579b6-d8a8-4886-a1bc-671ae52e7a00"
}Примеры с проверкой
Приведенный ниже пример ответа относится к запросу, в котором определен параметр location и установлено значение validate для true. В этом примере показан успешный ответ, означающий, что путь был доступен для ArcGIS Server:
{
status: "success",
}Приведенный ниже пример ответа относится к запросу, в котором определен параметр location и установлено значение validate для true. В этом примере показана ошибка, означающая, что путь недоступен для ArcGIS Server:
{
"status": "error",
"messages": ["Unable to write to \\videoserver\share\backup. Verify the location is accessible and the service account running ArcGIS Video Server can write to it."],
"code": 500
}
ArcGIS Video Server импорт и экспорт из локальной файловой системы
На первый взгляд различий нет. Для учетной записи сервиса требуются разрешения на чтение и запись в папке вывода/ввода. В Linux эквивалент учетной записи сервиса — пользователь, установивший ArcGIS Video Server. У вас должны быть полные права на чтение, запись и запуск для всех соответствующих каталогов, включая каталог импорта/экспорта.
ArcGIS Video Server импорт и экспорт из объекта или хранилища данных
Если используется общий сетевой каталог или хранилище объектов, рекомендуется запускать сервис Video Server Windows с учетной записью домена. Для учетной записи сервиса в выбранном местоположении требуются полные разрешения на чтение и запись. В Linux эквивалент учетной записи сервиса — пользователь, установивший ArcGIS Video Server.
Активация режима только для чтения
Администраторы могут включить режим только для чтения, чтобы временно запретить внесение каких-либо изменений в Video Server. Сюда входит публикация новых сервисов и доступ к конечным точкам администратора и REST через любые веб-адаптеры. Чтобы включить режим только для чтения, перейдите в конечную точку администратора, а затем в меню Режим. Измените значение Доступно для редактирования на Только для чтения. Чтобы отключить режим только для чтения, перейдите к конечной точке администратора, используя прямой порт (21443), и измените этот параметр обратно на Доступно для редактирования.
Включение и отключение протоколов и портов прямой трансляции ArcGIS Video Server
Основные администраторы сайта могут включать и отключать определенные протоколы прямой трансляции, начиная с версии ArcGIS Enterprise 12.0, через интерфейс администратора. Для этого перейдите к административной конечной точке ArcGIS Video Server, а затем к конечным точкам System и Livestream (/admin/system/livestream/). Используйте операцию Update, чтобы изменить определенные порты, используемые этими протоколами прямой трансляции. Client Mode Protocols и Server Mode Protocols можно включить или отключить с помощью соответствующих конечных точек и операции Update.
ArcGIS Video Server изменяет имя хоста livestream sourceUrl по умолчанию для новых и существующих сервисов
Для прямых трансляций в режиме сервера каждому слою назначается свойство sourceUrl, содержащее полное доменное имя ArcGIS Video Server. Это можно настроить, перейдя к конечным точкам System и Properties (/admin/system/properties/). Используйте операцию Update, чтобы добавить новое свойство с именем "LivestreamGatewayHostname". Для этого свойства укажите хост и домен, которые будут использоваться для sourceUrl прямых трансляций в режиме сервера (например, "test.sample.com"). После обновления sourceUrl автоматически будет использовать вновь назначенное имя хоста. Чтобы вернуть значение sourceUrl по умолчанию, просто удалите свойство LivestreamGatewayHostname.
Примечание:
Изменения, внесенные в свойство LivestreamGatewayHostname, применятся без перезапуска сервиса.