Настройка Insights in ArcGIS Enterprise

Insights в ArcGIS Enterprise

Как администратор Insights in ArcGIS Enterprise, вы можете добавить файл конфигурации приложения, чтобы задать пользовательские опции. Файл конфигурации должен называться insights.json и должен быть размещён в следующем местоположении ArcGIS Server: ArcGIS Server install directory\framework\etc\insights.json. Ниже описаны имеющиеся опции.

Настройки администрирования

Следующие свойства используются для задания опций.

СвойствоОписание

max_feature_copy_limit

Контролирует максимальный размер удаленного векторного слоя, который может быть скопирован в реляционное хранилище или базу данных. Если количество записей набора данных превышает это значение, операции, при которых требуется копирование данных, вернут ошибку. Приемлемы целочисленные значения, по умолчанию 250 000. Это целочисленное значение, которое не нужно заключать в кавычки.

Примечание:

Это ограничение применяется к удаленным векторным слоям, доступ к которым осуществляется через прокси, слоям, доступ к которым осуществляется из развертывания ArcGIS Enterprise, на котором еще не установлен Insights, и слоям, портал размещения которых не может быть определен.

В случае превышения ограничения будет отображено следующее сообщение об ошибке: Набор данных содержит слишком много записей. Попробуйте уменьшить размер набора данных. Вы можете уменьшить размер набора данных с помощью атрибутивного или пространственного фильтра.

Пример: "max_feature_copy_limit": 250000

database_timeout

Определяет продолжительность временного отрезка в секундах, в течении которого операция, использующая данные из подключения к базе данных, будет запущена (до того, как время истечет). Если время выполнения операции превышает это значение, операция будет возвращена с ошибкой. Приемлемы целочисленные значения, по умолчанию 120 секунд. Это целочисленное значение, которое не нужно заключать в кавычки.

Пример: "database_timeout": 120

Примечание:

Операции, выполняемые с наборами данных SAP HANA, не имеют временных ограничений. Свойство database_timeout не будет применено к SAP HANA.

task_timeout_secs

Управляет временем в секундах, в течение которого может выполняться задача по расписанию до истечения времени ожидания. Если время выполнения запланированного обновления превышает это значение, операция будет возвращена с ошибкой. Допустимые значения - целочисленные, по умолчанию 1800 секунд (30 минут). Это целочисленное значение, которое не нужно заключать в кавычки.

Пример: "task_timeout_secs": 1800

allow_running_tasks_without_sandboxing

Примечание:

Эта настройка предназначена только для развертываний Linux.

Определяет, будет ли запланированная задача запущена изолировано. Допустимые значения true или false; по умолчанию - false. Это Булево значение, которое не нужно заключать в кавычки.

Пример: "allow_running_tasks_without_sandboxing": false

max_concurrent_task_runners

Управляет количеством задач по расписанию, которые могут выполняться одновременно. Если количество запланированных для запуска задач превышает максимальное значение, они будут стоять в очереди до тех пор, пока не завершится другая задача. Допустимые значения - целочисленные, по умолчанию 4. Это целочисленное значение, которое не нужно заключать в кавычки.

Пример: "max_concurrent_task_runners": 4

enforce_database_connection_sharing_permission

Определяет, должно ли подключение к базе данных быть общедоступным, когда отчет, ссылающийся на данные из соединения, является общедоступным. Допустимые значения true или false; по умолчанию - true. Это Булево значение, которое не нужно заключать в кавычки.

Если для свойства установлено значение true, вам потребуется предоставить общий доступ к подключению к базе данных на том же уровне, что и к отчетам, использующим ее данные (например, если отчет является общедоступным, база данных также должна быть общедоступной). Если для свойства установлено значение false, то подключение к базе данных не потребуется публиковать. Однако пользователи, имеющие доступ к отчету, также будут иметь доступ к таблицам, отображаемым на странице.

Пример: "enforce_database_connection_sharing_permission":true

Изменение настроек

Выполните следующие шаги для настройки параметров Insights in ArcGIS Enterprise:

  1. Создайте файл описания с именем insights.json.
  2. Добавьте настройки, которые хотите сконфигурировать как единый объект, в файле JSON.
  3. Скопируйте файл insights.json в \framework\etc\.
  4. Перезапустите ArcGIS Server.
  5. Если ваше внедрение Insights in ArcGIS Enterprise включает более одного ArcGIS Server, повторяйте шаги 3 и 4 для каждого ArcGIS Server вашего сайта. Настройки должны быть одинаковыми для всех серверов.
Примечание:

Убедитесь, что файл insights.json содержит корректный JSON. Эти настройки не вступят в силу, если файл не был отформатирован корректно.

Если вы захотите восстановить настройки администрирования по умолчанию, можно удалить insights.json и перезапустить ArcGIS Server. Убедитесь, что вы повторили эти действия для всех ArcGIS Server своего сайта.

Пример

Содержание файла insights.json при настройке enrich_max_features, locate_geocode_max_features, buffer_network_max_features, max_feature_copy_limit:

{  
"enrich_max_features": 10000,  
"locate_geocode_max_features": 10000,  
"buffer_network_max_features": 1000,
"max_feature_copy_limit": 500000 
}

Механизм обеспечения изоляции (Sandboxing)

Примечание:

Настройки изоляции используются только в развертывании Linux.

Запланированные обновления для опубликованных отчетов требуют выполнения кода JavaScript, который работает в специальной версии браузера Chromium. Chromium имеет функцию безопасности (механизм изолированного запуска (sandboxing)), которая действует как дополнительная защита, если код, выполняемый браузером, способен обойти любые собственные ограничения безопасности. Он работает путем изоляции процесса от остальной части системы с помощью защищенного пространства namespace или setuid.

Пространство namespace требует запроса ядра для создания клона пользователя namespace без привилегий. Если флаг ядра поддерживается в вашей системе, уточните у администратора возможность активации функции, используя следующие параметры:

sudo sysctl -w kernel.unprivileged_userns_clone=1

Если namespace sandbox не поддерживается, вы можете настроить setuid sandbox.

Действия, выполняемые в setuid sandbox требуют прав доступа root. То есть он должен быть настроен таким образом, чтобы любой мог запустить его как root.

  1. Найдите файл chrome-sandbox в вашей установке ArcGIS Server по следующему пути: framework/runtime/insights/linux/
  2. Смените владельца на root, используя следующую команду: sudo chown root chrome-sandbox.
  3. Разрешите любому пользователю выполнить chrome-sandbox от имени владельца (root), используя следующую команду: sudo chmod 4755 chrome-sandbox.

В крайнем случае, если запланированные обновления завершатся неудачей из-за отсутствия рабочего изолированного пространства, эта функция безопасности может быть отключена с помощью настройки параметра Insights allow_running_tasks_without_sandboxing. Если изолированное пространство работает, настройка игнорируется. Или задача будет запущена без изоляции на системном уровне.

Esri User Experience Improvement программа

Программа Esri User Experience Improvement собирает сведения об использовании и применяет эти данные для дальнейшего совершенствования ПО.

Администраторы могут отказаться от этой программы во время установки. По завершении процесса установки Insights in ArcGIS Enterprise, можно воспользоваться настройками, чтобы отказаться от участия в программе.

Настройка параметров для Windows

Если вы устанавливаете Insights in ArcGIS Enterprise на Windows, вы можете снять отметку Щелкните здесь, чтобы участвовать в программе Esri User Experience Improvement в мастере установки, чтобы отказаться от участия в программе.

Настройки программы Esri User Experience Improvement можно изменить с помощью файла настроек (<portal_install_dir>/apps/insights/settings.json). Чтобы отказаться от участия в программе, измените параметр с eueiEnabled: "true" на eueiEnabled: "false".

Настройка параметров для Linux

Если вы устанавливаете Insights in ArcGIS Enterprise на Linux, можно запустить команду установки ./Insights-Setup.sh -e No, чтобы отказаться от участия в программе Esri User Experience Improvement.

Настройки программы Esri User Experience Improvement можно изменить с помощью файла настроек (<portal_install_dir>/apps/insights/settings.json). Чтобы отказаться от участия в программе, измените параметр с eueiEnabled: "true" на eueiEnabled: "false".