인터넷에 연결되어 있지 않거나 내 기관이 인터넷 접근을 금지한 환경에서 ArcGIS Enterprise를 구성하는 경우 다음과 같은 문제가 발생할 수 있습니다.
- 웹 맵을 인쇄하거나 미리 볼 수 없습니다.
- 웹 맵에서 주소 검색이나 찾기가 실행되지 않습니다.
- 면적 계산 또는 지오메트리 그리기가 올바르게 작동하지 않습니다.
- 포털 웹사이트에서 웹 맵 항목의 범위를 지정할 수 없습니다.
- OGC WMS 서비스를 Map Viewer Classic에 추가할 때 베이스맵이 나타나지 않습니다.
- 소셜 미디어에 공유를 활성화한 경우 이러한 링크는 404 오류와 함께 열립니다.
이러한 문제를 해결하려면 특정 HTTPS 설정을 구성하고 로컬 리소스를 가리키도록 포털을 다시 지정해야 합니다. 시작하려면 다음 섹션을 참고하세요.
HTTPS 설정 구성
오프라인 환경에서 ArcGIS Enterprise portal을 설정하려면 포털이 인증 기관의 인증서를 신뢰하는지 확인해야 합니다. 자세한 내용은 인증 기관의 인증서를 신뢰하도록 포털 구성을 참고하세요.
로컬 리소스를 가리키도록 포털 지정
로컬 리소스를 가리키도록 지정해야 하는 항목에는 ArcGIS Enterprise 포털의 유틸리티 서비스 및 웹사이트 관련 등록정보가 포함됩니다. 유틸리티 서비스는 포털을 통해 구성됩니다. 웹사이트에는 수정해야 하는 고유한 구성 파일이 있습니다.
외부 콘텐츠 비활성화
일부 Esri 콘텐츠에는 외부 인터넷 접근이 필요하므로 ArcGIS Online 리소스 요청을 방지하기 위해 콘텐츠를 비활성화해야 합니다. 콘텐츠를 비활성화할 때 다음과 같은 항목의 선택 그룹이 비활성화됩니다.
- "esri_[lang]"에서 소유한 모든 베이스맵
- "esri_nav"에서 소유한 모든 콘텐츠
- "esri"에서 소유한 모든 콘텐츠
외부 콘텐츠를 비활성화하려면 다음 단계를 완료합니다.
- ArcGIS Portal Directory에 내 기관의 관리자로 로그인합니다. URL은 https://webadaptorhost.domain.com/webadaptorname/portaladmin 형식입니다.
- 시스템 > 콘텐츠 > 구성 > 업데이트를 클릭합니다.
- False 옵션 이 선택되어 있는지 확인하고 업데이트를 클릭합니다.
외부 콘텐츠가 비활성화되면 베이스맵 갤러리에 베이스맵을 표시할 사용자 정의 그룹을 지정해야 합니다.
베이스맵
ArcGIS Enterprise portal은 ArcGIS Online에서 베이스맵 컬렉션으로 미리 구성되어 있습니다. 이 베이스맵은 오프라인 환경에서 사용하도록 지원되지 않습니다. 대신 자체 사용자 정의 베이스맵을 생성하고 베이스맵 갤러리에서 이러한 베이스맵을 포털이 제공하도록 구성합니다.
비고:
사용자 정의 베이스맵을 생성하기 전에 Esri 기본값 래스터 베이스맵을 이용해 ArcGIS Enterprise 포털을 구성합니다. 이 단계를 완료하면 사용자 정의 베이스맵을 작성할 때 Map Viewer Classic 기능이 올바르게 작동합니다.
- 포털 웹사이트에 관리자 또는 기관 웹사이트 관리 권한이 있는 구성원으로 로그인하세요.
- 기관을 클릭한 다음 설정을 클릭합니다.
- 맵 탭을 클릭합니다.
- 베이스맵 갤러리에서 ArcGIS apps에서 지원되는 Esri 벡터 베이스맵 사용 박스를 선택 해제합니다.
ArcGIS Enterprise 포털에서 사용자 정의 베이스맵을 생성하고 구성하려면 자세한 내용은 사용자 정의 베이스맵을 참고하세요.
ArcGIS Living Atlas of the World 콘텐츠
ArcGIS Living Atlas of the World는 ArcGIS Online에서 제공되는 즉시 사용 가능한 지리 콘텐츠 컬렉션입니다. 오프라인 환경의 경우 ArcGIS Enterprise 포털에서 비활성화될 수 있습니다. 그러나 ArcGIS Living Atlas에서 파일을 다운로드한 후 포털에 피처 레이어로 발행하여 오프라인 환경에서 My Esri 경계 레이어 콘텐츠를 계속 사용할 수 있습니다.
유틸리티 서비스
로컬 서비스를 가리키도록 유틸리티 서비스를 업데이트하는 방법에 대한 자세한 내용은 유틸리티 서비스 구성을 참고하세요. 다음은 주요 변경 사항의 개요입니다.
인쇄 서비스 — 포털 Map Viewer 또는 Map Viewer Classic에서 인쇄를 클릭하면 맵을 미리 보고 인쇄하는 데 인쇄 서비스가 사용됩니다. 기본 설정에 따라 서비스는 ArcGIS Online에서 시작됩니다. 오프라인 환경에서는 ArcGIS Server에서 인쇄 서비스를 사용하도록 포털을 구성해야 합니다. 그렇지 않으면, 웹 맵을 인쇄하고 미리 볼 수 없습니다. 이 서비스는 ArcGIS Server 사이트의 미리 구성된 인쇄 서비스 또는 서버에서 호스팅되는 사용자 설정 인쇄 서비스가 될 수 있습니다.
포털의 호스팅 서버를 지정하면 호스팅 서버의 인쇄 서비스가 자동으로 포털에 구성됩니다. 인쇄 서비스를 시작하고 공유하기만 하면 포털에서 사용할 수 있습니다. 그러나 이전에 포털에서 인쇄 서비스를 구성했으면 호스팅 서버를 지정할 때 URL이 업데이트되지 않습니다. 서비스를 시작하고 공유한 다음 유틸리티 서비스로 구성해야 합니다.
지오코드 서비스 — ArcGIS Enterprise 포털은 ArcGIS Online에서 호스팅되는 ArcGIS World Geocoding Service를 사용하도록 미리 구성되며, 해당 서비스를 통해 지정된 주소나 위치 이름을 찾고 매핑할 수 있습니다. 오프라인 환경에서 주소를 찾으려면 사용자의 자체 ArcGIS Server 지오코드 서비스를 설정해야 합니다.
지오메트리 서비스 — 지오메트리 서비스는 면적 계산 및 버퍼와 같은 공간 분석을 하는 데 필요한 계산을 수행합니다. ArcGIS Enterprise 포털에서는 기본 설정에 따라 ArcGIS Online 지오메트리 서비스를 사용합니다. 오프라인 환경에서는 사용자의 자체 ArcGIS Server 지오메트리 서비스를 설정해야 합니다. 이 서비스는 ArcGIS Server 사이트의 미리 구성된 지오메트리 서비스 또는 서버에서 호스팅되는 사용자 정의 지오메트리 서비스가 될 수 있습니다.
경로 서비스 — 경로 서비스는 여러 위치 간의 길찾기에 사용됩니다. 포털의 경로 유틸리티 서비스는 웹 맵에서 제공되는 경로 찾기 기능에 사용됩니다. 기본 설정에 따라 포털에 구성되는 경로 서비스는 없습니다. 오프라인 환경에서 Map Viewer 또는 Map Viewer Classic에 길찾기를 나타내도록 하려면 사용자의 자체 ArcGIS Server 경로 서비스를 발행해야 합니다.
웹사이트 등록정보
extentService: "<로컬 맵 서비스 URL>", — 범위 서비스는 포털 웹사이트의 범위 설정 대화 상자에서 웹 맵 항목의 범위를 업데이트하거나 설정하는 데 사용됩니다. 기본 설정에 따라 범위 서비스는 ArcGIS Online에서 시작됩니다. 오프라인 환경에서는 GIS Server 타일 맵 서비스로 포털을 구성해야 합니다. 이 서비스에서는 WKID(well-known ID)가 4326인 WGS 1984 지리 좌표계를 사용해야 합니다.
gcsBasemapService: "<로컬 맵 서비스 URL>", — GCS 베이스맵 서비스는 Web Mercator 좌표 체계를 지원하지 않는 OGC WMS 서비스의 베이스맵으로 사용됩니다. 기본 설정에 따라 GCS 베이스맵 서비스는 ArcGIS Online에서 시작됩니다. 오프라인 환경에서는 GIS Server 맵 서비스로 포털을 구성해야 합니다. 이 서비스에서는 WKID(well-known ID)가 4326인 WGS 1984 지리 좌표계를 사용해야 합니다.
configurePortalAGOEnv: "www.arcgis.com" — 구성된 유틸리티 서비스에 사용되는 프록시를 결정하는 데 사용됩니다. 구성된 유틸리티 서비스의 기본 프록시는 www.arcgis.com입니다. 오프라인 환경에서는 이 등록정보를 false로 설정합니다.
portalAGOConfigEnabled: true, — 기관 설정 페이지의 ArcGIS Online 탭 표시를 제어합니다. 오프라인 환경에서는 이 등록정보를 false로 설정합니다. ArcGIS Living Atlas 콘텐츠에 대한 접근을 비활성화하려면 다음 단계에 따라 포털에서 Living Atlas 콘텐츠에 대한 접근을 비활성화한 다음, 이 등록정보를 false로 설정합니다.
portalLivingAtlasConfigEnabled: true, — portalAGOConfigEnabled 등록정보와 함께 사용하여 기관 설정 페이지의 ArcGIS Online 탭 내 Living Atlas 콘텐츠 구성 섹션 표시를 제어합니다. 오프라인 환경에서는 다음 단계에 따라 포털에서 Living Atlas 콘텐츠에 대한 접근을 비활성화한 다음, 이 등록정보를 false로 설정합니다.
searchArcGISOnlineEnabled: false, — 이 등록정보를 사용하면 Map Viewer Classic에서 ArcGIS Online의 레이어를 검색할 수 있는 옵션을 비활성화할 수 있습니다. 기본값은 true입니다. 이 등록정보를 비활성화하면 ArcGIS Online에서 레이어를 검색할 수 있는 옵션이 Map Viewer Classic의 레이어 검색 대화 상자에서 숨겨집니다.
비고:
Map Viewer에서 이 옵션을 비활성화하려면 <Portal for ArcGIS installation directory>\apps\mapviewer\js\config\viewer.json에 있는 구성 파일에서 searchArcGISOnlineEnabled 등록정보를 false로 업데이트해야 합니다. 등록정보를 업데이트하고 파일을 저장했으면 Map Viewer를 열기 전에 브라우저의 캐시를 지웁니다. 이 등록정보에 대한 모든 업데이트는 업그레이드 후에 유지되지 않습니다.
showSocialMediaLinks: false, — Facebook 및 Twitter 링크를 항목 세부정보 대화 상자에 표시할지 여부를 나타냅니다. 기본값은 false입니다. 즉, 링크가 나타나지 않습니다. 설치 후 이 등록정보가 true로 설정되어 있는 경우, 오프라인 환경에서는 링크를 비활성화해야 합니다.
이러한 등록정보를 포함하는 파일은 <Portal for ArcGIS installation directory>/customizations/<version number>/framework/webapps/arcgis#home/js/arcgisonline/config.js에 있습니다. 수정하기 전에 이 파일의 백업 복사본을 만드는 것을 권장합니다.
팁:
파일에서 등록정보를 수정한 후에는 포털을 다시 시작해야 편집 내용이 적용되며 브라우저 캐시(쿠키 포함)를 지워야 포털 웹사이트에 변경 사항이 나타납니다. 자세한 내용은 고급 포털 옵션 설정을 참고하세요.
이러한 등록정보의 수정 사항은 업그레이드 시 보존되지 않습니다. config.js 파일의 변경 사항은 업그레이드 후 다시 적용되어야 합니다.
ArcGIS API for JavaScript
Portal for ArcGIS 10.9.1에는 ArcGIS API for JavaScript의 3.37 및 4.20 버전이 설치의 일부로 포함되어 있습니다. 포털 및 웹 응용프로그램 템플릿은 설치된 API를 자동으로 참조합니다. API의 3.37 버전은 https://<webadaptor host>.<domain>.com/<webadaptor name>/jsapi/jsapi에서 제공됩니다. API의 4.20 버전은 https://<webadaptor host>.<domain>.com/<webadaptor name>/jsapi/jsapi4에서 제공됩니다.
ArcGIS API for JavaScript의 자체 버전을 다운로드 및 호스팅하여 ArcGIS Web AppBuilder의 개발자 버전을 사용하거나 최신 API 기능을 활용하려 할 수 있습니다.
로컬로 호스팅한 API를 Services Directory에서 ArcGIS Server 서비스를 미리 보는 데 사용할 수도 있습니다. 자세한 내용은 포털에 ArcGIS Server ArcGIS Server Services Directory 연결을 참고하세요.
웹 응용프로그램 템플릿
ArcGIS Enterprise에는 사용자가 포털에 발행하거나 다운로드하여 웹 서버에서 호스팅할 수 있는 다양한 웹 응용프로그램 템플릿이 포함되어 있습니다. 자세한 내용은 포털 도움말에서 구성 설정 응용프로그램 템플릿을 참고하세요.
사용자가 포털에 발행하는 즉시 사용 가능한 웹 응용프로그램 템플릿은 로컬로 호스팅되는 ArcGIS API for JavaScript를 사용하도록 자동으로 구성됩니다. 사용자가 웹 응용프로그램 템플릿을 다운로드하여 이를 통해 웹서버에서 호스팅되는 응용프로그램을 생성하려면, 템플릿과 함께 번들로 제공된 readme.html 파일에 포함된 지침을 따라야 합니다.