ArcGIS Enterprise에는 ArcGIS Enterprise 기관의 운영에 부정적인 영향을 미칠 수 있는 다양한 아키텍처 및 구성 문제를 검사하는 Python 스크립트인 operationalHealth.py가 포함되어 있습니다. 이 스크립트는 안정적이고 최적화된 고기능의 생산 사이트를 제공하기 위한 몇 가지 모범 사례를 기반으로 문제를 찾습니다. 이 도구는 여러 조건 및 구성 등록정보를 분석하여 3가지 단계의 심각도(매우 중요, 중요, 권장)로 나눕니다. 이러한 기준은 다음 테이블에 설명되어 있습니다.
| ID | 심각도 | 등록정보 | 설명 |
|---|---|---|---|
OH01 | 중요 | Portal for ArcGIS 시스템 등록정보 | 기관 URL이 DNS 별칭 또는 로드 밸런싱된 URL을 사용하는 경우 포털 관리자에서 WebContextURL Portal for ArcGIS 시스템 등록정보를 설정해야 함을 나타냅니다. |
OH02 | 중요 | ArcGIS Server 시스템 등록정보 | 페더레이션 중에 정의된 서비스 URL에 DNS 별칭 또는 로드 밸런싱된 URL을 사용하는 경우 서버 관리에서 WebContextURL ArcGIS Server 시스템 등록정보를 설정해야 함을 나타냅니다. |
OH03 | 매우 중요 | Portal for ArcGIS 시스템 등록정보 | 포털이 고가용성인 경우 privatePortalURL 시스템 등록정보가 정의되었는지 여부를 확인합니다. 이 등록정보는 페더레이션된 서버 및 포털 간의 통신을 용이하게 하며, 포털이 고가용성이고 로드 밸런서로 설정되어야 하는 경우에 필요합니다. |
OH04 | 매우 중요 | Portal for ArcGIS 시스템 등록정보 | 포털이 고가용성인 경우 privatePortalURL 시스템 등록정보가 배포의 특정 머신으로 설정되었는지 여부를 확인합니다. 이 등록정보는 페더레이션된 서버 및 포털 간의 통신을 용이하게 하며, 특정 머신으로 설정되지 않아야 하고 로드 밸런서로 설정되어야 합니다. |
OH05 | 매우 중요 | Portal for ArcGIS 시스템 등록정보 | privatePortalURL 등록정보가 설정되면 URL에 대한 요청이 리디렉션되는지 여부를 확인합니다. 이는 privatePortalURL 값으로 사용되는 컴포넌트의 구성이 잘못되었음을 나타낼 수 있습니다. |
OH06 | 권장 | 고가용성 Portal for ArcGIS | 컴포넌트가 고가용성인 경우 포털이 고가용성이 아님을 나타냅니다. |
OH07 | 권장 | 고가용성 ArcGIS Server | 컴포넌트가 고가용성인 경우 하나 이상의 페더레이션된 서버가 고가용성이 아님을 나타냅니다. |
OH08 | 권장 | 고가용성 ArcGIS Data Store | 컴포넌트가 고가용성인 경우 페더레이션된 서버에 등록된 하나 이상의 데이터 저장소가 고가용성이 아님을 나타냅니다. |
OH09 | 중요 | Portal for ArcGIS 색인 | 색인이 동기화되어 있는지 여부를 확인합니다. 포털이 고가용성인 경우 색인이 머신 간에 동일한지 여부도 확인합니다. |
OH10 | 매우 중요 | 페더레이션된 서버 유효성 검사 | 페더레이션된 서버 사이트가 유효성 검사를 수행하는지 여부를 확인합니다. |
OH11 | 매우 중요 | 인증서 만료 | 포털 또는 서버 머신으로 가져온 인증서가 만료되었는지 여부를 확인합니다. |
OH12 | 매우 중요 | 인증서 만료 | 포털 또는 서버 머신으로 가져온 인증서가 15일 이내에 만료되는지 여부를 확인합니다. |
OH13 | 중요 | 인증서 만료 | 포털 또는 서버 머신으로 가져온 인증서가 30일 이내에 만료되는지 여부를 확인합니다. |
OH14 | 권장 | 인증서 만료 | 포털 또는 서버 머신으로 가져온 인증서가 40일 이내에 만료되는지 여부를 확인합니다. |
OH15 | 매우 중요 | 페더레이션된 서버 SSL 인증서 | 페더레이션된 서버의 관리 URL에 대한 인증서가 포털에서 확인한 신뢰할 수 있는 인증서가 아님을 나타냅니다. |
OH16 | 매우 중요 | 페더레이션된 서버 URL에 연결할 수 없음 | 페더레이션된 서버의 관리 URL에 접근할 수 없음을 나타냅니다. |
OH17 | 권장 | 페더레이션된 서버 SSL 인증서 | 페더레이션된 서버의 서비스 URL에 사용된 인증서가 포털에서 확인한 신뢰할 수 있는 인증서가 아님을 나타냅니다. |
OH18 | 권장 | 페더레이션된 서버 URL에 연결할 수 없음 | 포털에서 페더레이션된 서버의 서비스 URL에 연결할 수 없음을 나타냅니다. |
OH19 | 중요 | 페더레이션된 서버 비공개 포털 URL | 포털에 정의된 privatePortalURL 등록정보가 페더레이션된 서버에 정의된 privatePortalURL 등록정보와 일치하지 않음을 나타냅니다. |
OH20 | 중요 | 페더레이션된 서버 관리 URL | 페더레이션된 서버 사이트가 고가용성인 경우 페더레이션에 대한 관리 URL이 사이트의 특정 머신으로 설정되지 않았음을 나타냅니다. |
OH21 | 매우 중요 | Portal for ArcGIS 머신 상태 | 포털이 고가용성인 경우 배포의 포털 머신 중 하나에 접근할 수 없음을 나타내며 단일 장애 지점을 의미합니다. |
OH22 | 매우 중요 | ArcGIS Server 머신 상태 | 페더레이션된 서버 사이트가 다중 머신 사이트인 경우 사이트에 있는 하나 이상의 머신에 접근할 수 없음을 나타내며 단일 장애 지점을 의미합니다. |
OH23 | 매우 중요 | ArcGIS Data Store 머신 상태 | 등록된 ArcGIS Data Store가 고가용성인 경우 머신 중 하나에 접근할 수 없음을 나타내며 단일 장애 지점을 의미합니다. |
OH24 | 매우 중요 | WebGIS DR 백업 | WebGIS DR 유틸리티를 사용하여 배포를 백업한 적이 없음을 나타냅니다. 다른 데이터 손실 방지 방법을 사용하지 않는 경우 데이터 손실 위험이 높아집니다. |
OH25 | 중요 | WebGIS DR 백업 | WebGIS DR 도구를 사용하여 마지막으로 백업한 후 7일 이상이 지났음을 나타냅니다. |
OH26 | 중요 | WebGIS DR 백업 | BACKUP_RESTORE_MODE 등록정보가 full로 설정된 WebGIS DR 도구 실행으로 인해 트랜잭션 로그 제한이 해제되었음을 나타냅니다. 무료 증분 백업 일정을 사용하지 않는 한 등록정보를 backup으로 대신 설정합니다. |
OH27 | 중요 | Portal for ArcGIS 로그 파일 위치 | 포털의 로그 파일 위치가 네트워크 공유로 설정되어 새 로그를 작성하거나 로그를 쿼리할 때 성능 문제가 발생할 수 있음을 나타냅니다. 로그 위치를 로컬 경로로 설정하는 것을 권장합니다. |
OH28 | 중요 | Portal for ArcGIS 로그 수준 | 포털에 대한 로그 수준이 DEBUG로 설정되었음을 나타냅니다. 이는 문제 해결 용도로만 예약해야 하며 일반적인 용도로는 사용할 수 없습니다. |
OH29 | 중요 | ArcGIS Server 로그 파일 위치 | 페더레이션된 서버의 로그 파일 위치가 네트워크 공유로 설정되어 새 로그를 작성하거나 로그를 쿼리할 때 성능 문제가 발생할 수 있음을 나타냅니다. 로그 위치를 로컬 경로로 설정하는 것을 권장합니다. |
OH30 | 중요 | ArcGIS Server 로그 수준 | 페더레이션된 서버에 대한 로그 수준이 DEBUG로 설정되었음을 나타냅니다. 이는 문제 해결 용도로만 예약해야 하며 일반적인 용도로는 사용할 수 없습니다. |
OH31 | 중요 | 데이터 저장소 유효성 검사 | 페더레이션된 서버에 등록된 데이터 저장소가 유효성 검사 중이 아님을 나타냅니다. |
OH32 | 매우 중요 | 라이선스 만료 | 라이선스가 만료되었음을 나타냅니다. 해당 라이선스를 사용하는 워크플로는 더 이상 작동하지 않습니다. |
OH33 | 매우 중요 | 라이선스 만료 | 라이선스가 7일 이내에 만료됨을 나타냅니다. 해당 라이선스를 사용하는 워크플로는 더 이상 작동하지 않습니다. |
OH34 | 중요 | 라이선스 만료 | 라이선스가 14일 이내에 만료됨을 나타냅니다. 해당 라이선스를 사용하는 워크플로는 더 이상 작동하지 않습니다. |
OH35 | 권장 | 라이선스 만료 | 라이선스가 30일 이내에 만료됨을 나타냅니다. 해당 라이선스를 사용하는 워크플로는 더 이상 작동하지 않습니다. |
OH36 | 권장 | ArcGIS Data Store 등록 | 호스팅 서버가 아닌 하나 이상의 페더레이션 서버 사이트에 관계형 ArcGIS Data Store가 등록되어 있음을 나타냅니다. |
OH37 | 매우 중요 | 디스크 공간 사용 | 하나 이상의 디렉터리가 공간 부족 임계값 이내에 있음을 나타냅니다. 데이터 손실을 방지하기 위해 가용 디스크 공간을 늘리는 것이 중요합니다. |
OH38 | 중요 | 디스크 공간 사용 | 하나 이상의 디렉터리가 공간 부족 임계값의 1.5배 이내에 있음을 나타냅니다. 예를 들어 diskSpaceThreshold 값이 5GB인 경우 드라이브에 남아 있는 가용 공간이 7.5GB 미만임을 나타냅니다. 데이터 손실을 방지하기 위해 가용 디스크 공간을 늘리는 것이 중요합니다. |
OH39 | 권장 | 디스크 공간 사용 | 하나 이상의 디렉터리가 공간 부족 임계값의 2배 이내에 있음을 나타냅니다. 예를 들어 diskSpaceThreshold 값이 5GB인 경우 드라이브에 남아 있는 가용 공간이 10GB 미만임을 나타냅니다. 데이터 손실을 방지하기 위해 가용 디스크 공간을 늘리는 것을 권장합니다. |
operationalHealth.py 스크립트는 <Portal for ArcGIS installation location>\tools\operationalhealth 디렉터리에 있습니다. 커맨드 라인이나 셸에서 스크립트를 실행합니다. 스크립트를 실행할 때는 하나 이상의 매개변수를 지정할 수 있습니다. 필수 매개변수를 지정하지 않고 operationalHealth.py 스크립트를 실행하면 매개변수를 수동으로 입력하라는 메시지가 표시됩니다.
operationalHealth.py 매개변수
다음 테이블에는 operationalHealth.py 매개변수에 대한 설명이 나와 있습니다.
| 매개변수 | 설명 |
|---|---|
-n 또는 --hostname | Portal for ArcGIS가 설치되어 있는 머신의 정규화된 도메인 이름입니다(즉, portal.domain.com). 기본값은 스크립트를 실행하는 머신의 호스트 이름입니다. |
-u 또는 --username | 빌트인 관리자 계정의 사용자 이름입니다. |
-p 또는 --password | -u 매개변수로 지정하거나 수동으로 입력한 빌트인 관리자 계정의 비밀번호입니다. |
-f 또는 --passwordFile | -u 매개변수로 지정하거나 수동으로 입력한 빌트인 관리자 계정의 비밀번호를 저장하는 TXT 파일입니다. -p 또는 –-password 매개변수 대신 이 매개변수를 사용하면 머신에서 실행 중인 프로세스를 확인할 때 비밀번호가 나열되지 않습니다. |
-o 또는 --outputDir | 검사 보고서가 저장되는 디렉터리입니다. 기본 디렉터리는 스크립트를 실행하는 폴더입니다. 명령줄 사용자에게 해당 위치에 대한 읽기 및 쓰기 권한이 있는지 확인해야 합니다. |
-l 또는 --logFile | 결과 로그 파일이 저장되는 디렉터리입니다. 지정하지 않으면 정보가 콘솔이나 터미널에 기록됩니다. |
-t 또는 --token | 사용자 이름과 비밀번호 대신 토큰을 생성하여 사용할 수 있습니다. 토큰을 생성할 때 referrer 등록정보를 operationalhealth로 설정합니다. 이 매개변수는 스크립트를 실행하는 경우에만 인수로 제공할 수 있습니다. 토큰을 제공하면 입력된 사용자 이름이나 비밀번호는 무시됩니다. |
--ignoressl | SSL 인증서 확인을 비활성화합니다. 10.7.1부터 스크립트는 기본 설정에 따라 모든 SSL 인증서를 확인합니다. Python이 인증서 발급자를 신뢰하지 않으면 스크립트가 완료되지 않습니다. 필요한 경우 이 매개변수를 지정하여 모든 인증서를 무시할 수 있습니다. |
-d 또는 --debug | HTTP 요청에 대한 요청 및 응답을 기록합니다. 이를 통해 유틸리티 문제를 해결할 수 있습니다. |
-h 또는 -? | 스크립트를 실행할 때 지정할 수 있는 매개변수 목록을 출력합니다. |
예시: operationalHealth.bat -n portal.domain.com -u admin -p my.password -o C:\Temp
검사를 통해 HTML 형식의 보고서가 생성되는데 이 보고서에는 지정된 포털에서 발견된 위의 문제가 나와 있습니다.
기본 설정에 따라 보고서는 스크립트를 실행하는 폴더에 operationalHealthReport_<hostname>_<date>_<time>.html(이)라는 이름으로 저장됩니다.