GeoAnalytics Server 설정

여러 등록정보를 구성하여 배포에서 GeoAnalytics Server의 설정을 변경할 수 있습니다. GeoAnalytics Server의 성능을 최적화하려면 내 기관에 대해 이러한 설정을 적합하게 구성해야 합니다. 이러한 설정을 구성할 때는 다음 사항을 고려해야 합니다.

• 동시에 실행할 작업의 수
• 사용 중인 데이터의 크기
• 작업을 실행할 빈도
• 사용 가능한 리소스

포털 구성원들이 실행하는 GeoAnalytics 도구는 ArcGIS Server 사이트의 GeoAnalyticsTools 시스템 서비스 내 작업을 통해 제공됩니다. 아래의 시스템 속성은 GeoAnalytics Server 사이트에서 설정되는 반면 인스턴스의 수와 서비스 속성은 GeoAnalyticsTools 시스템 서비스 자체에 대해 설정됩니다. 매개변수를 수정하기 전에 모든 설정 옵션에 대한 설명을 확인하여 GeoAnalytics 구성을 계획하세요.

주의:

새 버전의 ArcGIS Enterprise로 업그레이드하는 경우 이러한 GeoAnalytics Server 설정은 유지되지 않습니다. 업그레이드하기 전에 변경한 설정을 적어 두었다가 업그레이드가 완료되면 교체하세요.

이 항목에서는 다음 예시를 사용합니다.

• 예시 1: 작업을 한 번에 하나씩 실행하는 머신 3개로 구성된 GeoAnalytics Server 사이트
• 예시 2: 작업을 한 번에 2개씩 실행하는 머신 3개로 구성된 GeoAnalytics Server 사이트

이러한 두 예시에는 모두 머신(노드) 3개가 포함되며 각 머신은 16GB RAM 및 CPU 코어 4개로 구성됩니다. 따라서 각 GeoAnalytics Server 사이트의 총 메모리는 48GB RAM이고 코어는 12개입니다.

참고 사항:

GeoAnalytics에는 메모리를 머신당 30GB까지만 할당하는 것이 좋습니다.

시스템 등록정보

다음 시스템 속성은 사이트 관리자가 ArcGIS Server 사이트의 각 머신에서 계산 플랫폼 작업자 프로세스용 CPU 및 메모리 리소스를 할당하기 위해 구성할 수 있는 선택적 속성입니다.

• percentageMaxAllowedComputeCores - 단일 노드의 계산 플랫폼 작업자 프로세스가 사용할 최대 CPU 코어(머신에서 사용 가능한 총 코어의 백분율)를 나타냅니다. 기본값은 80%이고, 허용되는 최대값은 90%입니다. 지정한 값이 CPU 코어 1개 미만에 해당하면 계산 플랫폼 작업자 프로세스에 CPU 코어 1개가 사용됩니다.
• percentageMaxAllowedComputeMemory - 단일 노드의 계산 플랫폼 작업자 프로세스가 사용할 최대 메모리(머신에서 사용 가능한 총 메모리의 백분율)를 나타냅니다. 기본값은 80%이고, 허용되는 최대값은 90%입니다.

시스템 등록정보를 편집하려면 다음 단계를 완료하세요.

1. 관리 권한이 있는 사용자로 ArcGIS Server Administrator Directory에 로그인합니다. URL은 http://gisserver.domain.com:6080/arcgis/admin/ 형식입니다.
2. 시스템 > 등록정보로 이동합니다.
3. 업데이트를 클릭합니다.
4. JSON 형식으로 속성을 추가합니다. { "percentageMaxAllowedComputeCores": <value>, "percentageMaxAllowedComputeMemory": <value>} 예를 들면 다음과 같습니다. {"percentageMaxAllowedComputeCores": 90, "percentageMaxAllowedComputeMemory": 90}

서비스 등록정보

GeoAnalyticsTools서비스에는 작업당 허용되는 최대 메모리 및 CPU 코어를 할당하기 위한 서비스 레벨 속성 두 개가 있습니다. 기본값은 머신당 6GB 및 CPU 코어 4개로 설정됩니다. 사이트에서 사용 가능한 메모리 및 CPU 리소스를 기준으로 하여 이러한 값을 적합한 값으로 업데이트하는 것이 좋습니다. 기본값을 사용하는 경우 분산 계산 기능을 활용하지 않으므로 성능이 저하됩니다.

참고 사항:

관리자만 서비스 레벨 속성을 설정할 수 있습니다. 서버 사이트의 코어 수와 각 머신의 RAM 용량을 알아야 합니다. 이러한 값을 모르는 경우에는 GeoAnalytics 상태 확인을 사용하여 값을 파악할 수 있습니다.

GeoAnalytics 상태 확인에 대한 자세한 정보

다음 방정식을 사용하여 머신별로 작업당 허용된 최대 메모리를 추정할 수 있습니다.

Floor(((percentageMaxAllowedComputeCores) * (total cores on the Server Site) / (number of simultaneous jobs)) = (Maximum allowed compute cores per job)

다음 방정식은 작업당 허용된 최대 계산 코어를 추정하는 데 사용됩니다.

Floor((percentageMaxAllowedComputeMemory) * (GB of RAM on a single GeoAnalytics machine) / (number of simultaneous jobs)) = (Maximum allowed memory per job per machine)

참고 사항:

머신별로 사용된 메모리 양은 모든 GeoAnalytics Server 머신에서 동일합니다. GeoAnalytics Server 사이트에 RAM의 양이 서로 다른 머신이 여러 개 있는 경우에는 최소 용량의 RAM으로 머신의 값을 사용합니다.

예시 1에서는 시스템 속성에서 설명한 대로 사용 가능한 계산 코어 및 계산 메모리의 최대 80%를 사용하는 것으로 가정합니다. 총 12개의 CPU 코어와 48GB RAM(각 머신에 16개)이 있는 사이트에서 코어 및 RAM의 양은 아래의 방정식을 사용하여 결정됩니다.

• 코어 수:

  Floor(((.80) * (12))/1) = Floor(9.6) = 9

• 머신당 RAM의 양:

  Floor(((.80) * (16))/1) = Floor(12.8) = 12

GeoAnalytics Server에서 사용 가능한 리소스를 활용하고 사이트의 여러 머신으로 작업을 분산시키려는 경우 값을 다음과 같이 업데이트할 수 있습니다.

• 머신별 작업당 허용되는 최대 메모리(GB): 12
• 작업당 허용되는 최대 계산 코어(CPU): 9

이렇게 하면 작업이 사이트의 머신 3개로 분산되며 모든 머신에서 사용 가능한 리소스의 80% 미만을 사용합니다. 이 할당 집합은 아래에서 설명하는 것처럼 인스턴스 수에도 영향을 줍니다.

예시 2에서는 시스템 속성에서 설명한 대로 사용 가능한 계산 코어 및 계산 메모리의 최대 80%를 사용하는 동시에 2개 작업을 동시에 실행하는 것으로 가정합니다. 즉, 항상 2개 작업에 대해 리소스를 설정해야 함을 의미합니다. 총 12개의 CPU 코어와 48GB RAM(머신당 16개)이 있는 사이트에서 코어 및 RAM의 양은 아래의 방정식을 사용하여 결정됩니다.

• 코어 수:

  Floor(((.80) * (12))/2) = Floor(4.8) = 4

• 머신당 RAM의 양:

  Floor(((.80) * (16))1) = Floor(6.4) = 6

GeoAnalytics Server에서 사용 가능한 리소스를 활용하고 사이트의 여러 머신으로 작업을 분산시키려는 경우 값을 다음과 같이 업데이트할 수 있습니다.

• 머신별 작업당 허용되는 최대 메모리(GB): 6
• 작업당 허용되는 최대 계산 코어(CPU): 4

이러한 속성을 수정하려면 다음을 수행하세요.

1. GeoAnalytics Server에서 관리 권한이 있는 사용자로 ArcGIS Server Manager에 로그인합니다. URL은 https://gisserver.domain.com:6443/arcgis/manager 형식입니다.
2. 서비스 탭에서 시스템 폴더를 선택합니다.
3. 사용 가능한 서비스 목록에서 GeoAnalyticsTools 서비스를 찾아 편집하도록 선택합니다.
4. 매개변수 탭을 사용하여 서비스의 등록정보를 설정합니다. 이러한 등록정보에는 다음 항목이 포함됩니다.
   • 머신별 작업당 허용되는 최대 메모리(GB) - 머신당 각 작업에 사용할 수 있는 메모리의 양(GB)을 나타냅니다.
   • 작업당 허용되는 최대 계산 코어(CPU) - 군집의 모든 머신에서 작업당 사용할 수 있는 CPU 코어의 총 수를 나타냅니다.
5. 설정을 완료한 후 저장 후 다시 시작을 클릭하여 서비스 등록정보를 업데이트합니다.

초기 값을 수정하지 않은 경우 GeoAnalytics 작업은 사용 가능한 리소스 중 일부분을 사용합니다(예시 설정의 경우 사용 가능한 12코어 및 48GB 중 4코어 및 18GB).

참고 사항:

사용할 메모리의 양을 선택할 때는 머신 리소스에 대해 설정된 백분율(기본값: 80%)보다 작거나 같은 수를 설정해야 합니다. 이렇게 설정하면 작업이 실제로 사용할 수 없는 리소스를 사용하기 위해 1분간 대기한 후 다음 오류와 함께 취소됩니다. ERROR BD_101057: 분산 작업을 시작할 수 없습니다. GeoAnalyticsTools 서비스 설정을 확인하고 작업을 실행하는 데 충분한 리소스가 있는지 확인하세요. 다른 작업에서 리소스를 사용하고 있어 리소스를 사용할 수 없는 경우에도 이 오류가 표시됩니다.

GeoAnalyticsTools 서비스의 최소/최대 인스턴스 수

GeoAnalyticsTools 서비스의 기본 최소 및 최대 인스턴스 수는 사이트의 ArcGIS Server 머신당 1개로 설정됩니다. GeoAnalytics Server 사이트에 있는 머신의 수(n)에 따라 GeoAnalytics 작업을 수락하는 데 사용할 수 있는 인스턴스의 수는 (n)개가 됩니다. 서비스 등록정보에서 작업당 할당된 메모리 및 CPU 코어 수와 인스턴스 수에 따라 동시 요청을 하나 이상 처리할 수 있습니다. GeoAnalytics 도구에 대한 추가 요청은 인스턴스 또는 메모리 및 CPU 리소스를 사용할 수 있을 때까지 대기됩니다. 1분 후에도 리소스를 사용할 수 없으면 작업이 취소됩니다.

필요한 작업의 경우에는 작업당 가능한 최대 메모리 및 CPU 코어를 할당하는 것이 이상적입니다.

여러 작업을 동시에 처리하려는 경우 사이트에 있는 둘 이상의 머신에 대해 필요한 대로 최대 인스턴스를 늘릴 수 있습니다. 그러나 이렇게 하는 경우에는 각 동시 작업에 사용 가능한 CPU 및 메모리 리소스가 충분하도록 작업당 CPU 및 메모리 제한도 수정해야 합니다.

GeoAnalyticsTools 서비스의 최소 및 최대 인스턴스 수를 설정하려면 다음 단계를 완료합니다.

1. ArcGIS Server Administrator Directory에 로그인합니다. URL은 https://gisserver.domain.com:6443/arcgis/admin 형식입니다.
2. 서비스 > 시스템 > GeoAnalyticsTools로 이동합니다.
3. 편집을 클릭합니다.
4. maxInstancesPerNode 및 minInstancesPerNode 등록정보를 편집하고 편집사항 저장을 클릭합니다.

머신이 3개인 예시에서는 예시 1 및 예시 2의 사용 사례를 모두 충족하는 데 충분한 총 3개의 인스턴스를 사용할 수 있습니다. 이 3개의 머신 시나리오에서 4개 이상의 동시 작업을 실행하려면 CPU 및 메모리 제한을 조정하는 것 외에도 인스턴스 수를 업데이트해야 합니다.

모든 인스턴스에 적용되는 총 CPU 및 메모리 제한은 CPU 및 메모리의 시스템 제한보다 작아야 합니다. 노드당 총 메모리에 인스턴스 수를 곱한 값은 단일 머신에서 사용 가능한 메모리의 값(16GB x 0.80/2개 인스턴스 = 6.4인데 이 값은 정수여야 하므로 6)보다 작아야 합니다. 그리고 계산 코어는 총 코어 수를 인스턴스 수로 나눈 값(12코어 x 0.80/2개 인스턴스 = 4.8인데 이 값은 정수여야 하므로 4)보다 작아야 합니다.

GeoAnalyticsTools 서비스의 시간 제한

기본 설정에 따라 GeoAnalyticsTools 서비스에서 처리하는 오래 실행되는 작업은 24시간 후에 시간이 초과됩니다. 도구가 더 긴 시간이나 더 짧은 시간 동안 실행된 후 시간이 초과되도록 이 등록정보를 편집할 수 있습니다. 아래 단계에 따라 ArcGIS Server Manager에서 GeoAnalyticsTools 서비스의 시간 제한 등록정보를 편집할 수 있습니다.

1. ArcGIS Server Manager에 로그인합니다. URL은 https://gisserver.domain.com:6443/arcgis/manager 형식입니다.
2. 서비스 탭에서 시스템 폴더를 선택합니다.
3. 사용 가능한 서비스 목록에서 GeoAnalyticsTools 서비스를 찾아 편집하도록 선택합니다.
4. 풀링 탭을 사용하여 서비스 시간 제한 지정 섹션에서 서비스의 시간 제한 등록정보를 설정합니다. 클라이언트가 서비스를 사용할 수 있는 최대 시간을 새 시간 제한 등록정보에 사용하려는 시간(초)으로 변경합니다.
5. 저장 후 다시 시작을 클릭하여 서비스를 업데이트합니다.

GeoAnalytics Server 임시 파일 위치

작업이 GeoAnalytics Server에서 실행되는 경우 기본 설정에 따라 임시 파일이 \<ArcGIS Server installation directory>\server\framework\runtime\spark\work> 폴더에 작성됩니다. 관리자는 아래 단계에 따라 geoAnalyticsTempFolder 속성을 지정하여 임시 파일의 대체 위치를 선택할 수 있습니다.

참고 사항:

geoAnalyticsTempFolder 위치는 GeoAnalytics Server 사이트의 각 머신에 있는 로컬 디렉터리여야 하며 매우 큰 데이터셋에서 GeoAnalytics 작업의 실행을 지원하는 데 사용할 수 있는 디스크 공간이 있어야 합니다.

1. GeoAnalytics Server 사이트에서 관리 권한이 있는 사용자로 ArcGIS Server 관리자 디렉터리에 로그인합니다. URL은 http://gisserver.domain.com:6080/arcgis/admin/ 형식입니다.
2. 시스템 > 등록정보로 이동합니다.
3. 업데이트를 클릭합니다.
4. JSON 형식으로 속성을 추가합니다. {"geoanalyticsTempFolder": "<value>"} 예를 들면 다음과 같습니다. {"geoanalyticsTempFolder": "C:\\temp"} 변경 사항이 시스템 속성 페이지에 반영되는 데 최대 1분이 소요됩니다.
5. 계산 플랫폼 상태 확인 서비스를 사용하여 GeoAnalytics Server의 상태를 확인할 수 있습니다. 시스템 > 플랫폼 서비스 > 계산 플랫폼으로 이동한 후 상태를 클릭합니다.