Insights in ArcGIS Enterprise 구성

Insights in ArcGIS Enterprise

Insights in ArcGIS Enterprise 관리자는 응용프로그램의 구성 파일을 추가하여 다양한 사용자 옵션을 지정할 수 있습니다. 구성 파일은 insights.json이라는 이름으로 ArcGIS Server의 다음 위치에 배치되어야 합니다. ArcGIS Server install directory\framework\etc\insights.json. 아래에는 사용 가능한 옵션이 설명되어 있습니다.

관리 설정

다음 등록정보를 사용하여 옵션을 정의합니다.

등록정보설명

max_feature_copy_limit

관계형 데이터 저장소 또는 데이터베이스에 복사할 수 있는 원격 피처 레이어의 최대 크기를 제어합니다. 데이터셋의 레코드 수가 이 값을 초과할 경우 데이터를 복사해야 하는 작업을 수행하면 오류가 반환됩니다. 사용 가능한 값은 정수이며 기본값은 250,000입니다. 이 값은 정수 등록정보 값이므로 따옴표는 필요하지 않습니다.

비고:

이 제한은 프록시를 통해 접근한 원격 피처 레이어, Insights가 설치되어 있지 않은 ArcGIS Enterprise 배포에서 접근한 레이어, 호스팅 포털을 확인할 수 없는 레이어에 적용됩니다.

제한 값을 초과한 경우 다음 오류 메시지가 표시됩니다. 데이터셋에 레코드가 너무 많이 포함되어 있습니다. 데이터셋 크기를 줄여 보세요. 속성 필터 또는 공간 필터를 사용하여 데이터셋 크기를 줄일 수 있습니다.

예시: "max_feature_copy_limit": 250000

database_timeout

제한 시간이 종료되기 전에 데이터베이스 연결을 통해 데이터를 사용하여 작업을 실행할 시간(초)을 제어합니다. 작업 실행 시간이 해당 값을 초과할 경우 오류가 반환됩니다. 사용 가능한 값은 정수이며 기본값은 120초입니다. 이 값은 정수 등록정보 값이므로 따옴표는 필요하지 않습니다.

예시: "database_timeout": 120

비고:

SAP HANA 데이터베이스를 사용하여 수행되는 작업은 시간 제한이 없습니다. database_timeout 등록정보는 SAP HANA에 적용되지 않습니다.

task_timeout_secs

제한 시간이 종료되기 전에 예약된 작업을 실행할 수 있도록 시간(초)을 제어합니다. 예약된 업데이트 실행 시간이 해당 값을 초과할 경우 오류가 반환됩니다. 사용 가능한 값은 정수이며 기본값은 1,800초(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가 포함되어 있는 경우 사이트의 각 ArcGIS Server에 대해 3단계와 4단계를 반복합니다. 설정은 모든 서버에서 같아야 합니다.
비고:

insights.json 파일에 유효한 JSON이 포함되어 있는지 확인합니다. 파일의 형식이 잘못 지정되었다면 설정이 적용되지 않습니다.

기본 관리 설정을 복원하려면 insights.json을 삭제하고 ArcGIS Server를 다시 시작하면 됩니다. 사이트의 각 ArcGIS Server에 대해 이러한 작업을 반복해야 합니다.

예시

enrich_max_features, locate_geocode_max_features, buffer_network_max_features, max_feature_copy_limit을 구성하는 경우의 insights.json 파일 내용:

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

샌드박스

비고:

샌드박스 설정은 Linux 배포에서만 사용됩니다.

발행된 보고서에 예약된 업데이트를 사용하려면 JavaScript 코드를 실행해야 하며 이 작업은 Chromium 브라우저 특수 빌드를 통해 수행됩니다. Chromium에는 샌드박스라는 보안 기능이 있는데 이 기능은 브라우저 실행 코드가 자체 보안 제한을 무시할 수 있다는 점을 고려한 추가 보안 기능입니다. 샌드박스는 네임스페이스 샌드박스 또는 setuid 샌드박스를 통해 프로세스를 시스템의 나머지 부분과 분리하는 방식으로 작동합니다.

네임스페이스 샌드박스의 경우 권한 없는 사용자 네임스페이스 복제를 수행하도록 커널에 요청해야 합니다. 시스템에서 커널 플래그가 지원되는 경우 다음을 사용하여 이 기능을 활성화하는 방법을 관리자에게 문의하세요.

sudo sysctl -w kernel.unprivileged_userns_clone=1

네임스페이스 샌드박스가 지원되지 않으면 대신 setuid 샌드박스를 설정할 수 있습니다.

setuid 샌드박스에서 수행하는 작업에는 루트 권한이 필요합니다. 따라서 누구나 루트로 실행할 수 있도록 구성해야 합니다.

  1. 다음 경로의 chrome-sandbox 설치에서 ArcGIS Server 파일을 찾습니다. framework/runtime/insights/linux/
  2. 다음 명령을 사용하여 소유자를 루트로 변경합니다. sudo chown root chrome-sandbox.
  3. 다음 명령을 사용하여 모든 사용자가 소유자(루트)로 chrome-sandbox를 실행할 수 있도록 허용합니다. sudo chmod 4755 chrome-sandbox.

마지막으로 작동 중인 샌드박스가 없어 예약된 업데이트가 실패한 경우에는 Insights 설정 allow_running_tasks_without_sandboxing을(를) 사용하여 이 보안 기능을 비활성화할 수 있습니다. 샌드박스가 작동 중이라면 이 설정이 무시됩니다. 작동 중이 아닌 경우 시스템 수준 샌드박스 없이 작업이 실행됩니다.

Esri UX 개선 프로그램

Esri UX 개선 프로그램은 사용자로부터 사용 내역 정보를 수집하고 데이터를 사용하여 소프트웨어를 개선합니다.

Administrator는 설치 프로세스 동안 프로그램을 설치하지 않도록 선택할 수 있습니다. Insights in ArcGIS Enterprise 설치 프로세스가 완료되면 프로그램 참여를 중단하도록 설정을 구성할 수 있습니다.

Windows 설정 구성

Windows에서 Insights in ArcGIS Enterprise를 설치하는 경우 설치 마법사에서 여기를 클릭하여 Esri UX 개선 프로그램에 참여를 선택 취소하여 설치하지 않도록 선택할 수 있습니다.

설정 파일(<portal_install_dir>/apps/insights/settings.json)을 사용하여 Esri UX 개선 프로그램의 설정을 구성할 수 있습니다. 프로그램을 설치하지 않도록 선택하려면 설정을 eueiEnabled: "true"에서 eueiEnabled: "false"로 변경합니다.

Linux 설정 구성

Linux에서 Insights in ArcGIS Enterprise를 설치하는 경우 ./Insights-Setup.sh -e No 명령 설치를 실행하여 Esri UX 개선 프로그램을 설치하지 않도록 선택할 수 있습니다.

설정 파일(<portal_install_dir>/apps/insights/settings.json)을 사용하여 Esri UX 개선 프로그램의 설정을 구성할 수 있습니다. 프로그램을 설치하지 않도록 선택하려면 설정을 eueiEnabled: "true"에서 eueiEnabled: "false"로 변경합니다.