ArcGIS Notebook Server 사이트에 추가 머신 조인(Linux 컨테이너)

ArcGIS Notebook Server 10.7.1 이후 버전에서는 다중 머신 사이트가 지원됩니다. 다중 머신 사이트에서 각 머신은 같은 Docker 설정으로 동일하게 구성되며 각각 ArcGIS Notebooks에서 실행할 수 있습니다.

10.9부터는 ArcGIS Notebook Server에서 다중 라이선스 사이트를 지원하므로 사이트에 참여하는 모든 머신에 더 이상 동일한 레벨의 라이선스가 필요하지 않습니다. 예를 들어 advanced 라이선스로 구성된 1개의 머신과 standard 라이선스로 구성된 2개의 머신으로 총 3개의 머신 사이트를 설정할 수 있습니다. 10.9 이전에는 모든 머신에 동일한 레벨의 라이선스(advanced 또는 standard)가 필요했습니다. 10.9에 도입된 이 다중 라이선스 기능을 사용하면 Advanced 또는 Standard 라이선스가 있는 여러 머신으로 확장할 수 있습니다.

레거시:

10.7 릴리즈에서는 단일 머신 사이트만 지원되었습니다.

다중 머신 ArcGIS Notebook Server 사이트를 사용하면 더 많은 Notebook 사용자를 동시에 지원할 수 있습니다. 활성 사용자가 많거나 단일 머신의 리소스가 사용자의 요구에 부적합한 경우 다중 머신 사이트로 확장하는 것이 유용할 수 있습니다.

비고:

머신 리소스가 더 필요한 Notebook 사용자가 있는 경우 머신 추가에 대한 제한적인 대안으로 사이트의 리소스 제한 수정을 평가할 수 있습니다.

ArcGIS Notebook Server 사이트의 모든 머신에는 같은 버전의 동일한 소프트웨어가 설치되어 있습니다. 설정한 첫 번째 머신에서 ArcGIS Notebook Server 사이트를 만들어야 합니다. 그러면 추가 ArcGIS Notebook Server 머신을 사이트에 가입할 수 있습니다.

비고:

다른 ArcGIS Server 역할과는 달리, ArcGIS Notebook Server에서는 첫 번째 머신에서 머신을 사이트에 더 추가하는 기능이 지원되지 않습니다. ArcGIS Notebook Server 구성 마법사나 joinsite 유틸리티를 사용하여 각 머신에 차례로 접근하고 사이트에 가입해야 합니다.

설치하기 전에

사이트를 만들 때 구성 저장소를 저장할 위치, 중요한 파일을 호스팅하는 디렉터리, 사이트의 구성 정보를 결정합니다. 사이트에는 system과 workspace 서버 디렉터리도 있습니다.

ArcGIS Notebook Server 사이트를 만드는 경우에는 구성 저장소와 서버 디렉터리의 위치를 지정합니다. 다중 머신 사이트에서는 다른 머신이 접근할 수 있도록 구성 저장소와 서버 디렉터리를 공유해야 합니다. 사이트에 가입하는 각 머신에는 해당 공유 위치에 대한 읽기 권한과 쓰기 권한이 부여되어야 합니다.

Docker Desktop에 사용할 공유 드라이브 및 복제

다중 머신 ArcGIS Notebook Server 사이트에서 많은 서버 디렉터리와 사이트 구성 저장소는 각 머신에 접근할 수 있는 위치를 호스팅하고 공유합니다. 예외는 각 사용자의 Docker 컨테이너에 마운트되는 작업 영역 디렉터리입니다. Docker는 Windows 시스템의 컨테이너에 공유 드라이브 마운트를 지원하지 않으므로 작업 영역 디렉터리는 각 머신에서 로컬로 유지되어야 합니다. 사용자는 다중 머신 사이트의 모든 머신에서 컨테이너를 실행하고 Notebook을 열 수 있기 때문에 작업 영역 디렉터리의 콘텐츠를 여러 머신 간에 동기화해야 합니다.

Windows는 네이티브 복제 솔루션인 분산 파일 시스템(DFS) 데이터 복제를 제공합니다. 이 복제는 전체 항목이 아닌 변경된 데이터 패킷만 동기화하여 머신에서 효율적으로 데이터를 동기화합니다. DFS를 사용하면 복제할 폴더가 각 머신의 동일한 위치에 보관됩니다.

DFS 복제가 ArcGIS Notebook Server 사이트의 작업 영역 디렉터리 콘텐츠를 동기화하는 유일한 방법은 아닙니다. 그러나 Windows에서 기본적으로 자주 사용되는 방법이기 때문에 설정 단계가 ArcGIS Notebook Server에 대한 DFS 복제 구성에 설명되어 있습니다. IT 관리자와 상의하여 DFS 또는 다른 복제 시스템이 내 기관에 가장 적합한지를 확인할 수 있습니다.

다중 머신 사이트 설치와 구성

다중 머신 ArcGIS Notebook Server 사이트를 설정하려는 경우 이 설치 가이드에서 따를 추가 단계가 있습니다.

1. ArcGIS Notebook Server의 시스템 요구 사항을 검토하여 각 머신이 자격 대상인지 확인합니다. 각 머신에서는 ArcGIS Enterprise 배포의 각 머신에서 통신하기 위해 43번 포트를 열도록 방화벽을 조정합니다.

   설치된 ArcGIS Notebook Server 버전과 해당 라이선스 파일은 각 머신에서 동일해야 합니다. 각 설치 중에는 동일한 ArcGIS Notebook Server 계정을 입력합니다. 도메인 또는 Active Directory 계정을 사용하는 것을 권장하지만 로컬 계정을 선택하는 경우에는 동일한 이름과 비밀번호의 조합이 각 머신에 있어야 합니다. 지정하는 계정이 관리자 그룹에 속할 필요는 없습니다.

2. 이 시점에서 설치 프로세스 중에 다음 작업을 이미 수행했는지 확인합니다.
   1. 각 머신에 Docker Desktop을 설치합니다. 각 머신에서 Esri가 제공하는 Docker 이미지를 다운로드하여 시스템에서 접근할 수 있는 위치에 저장합니다.
   2. 각 머신에 ArcGIS Notebook Server를 설치하고 인증합니다. 소프트웨어를 자동으로 설치할 수도 있습니다.
   3. ArcGIS Notebook Server는 Windows용 Docker Desktop이 있는 Linux 컨테이너를 지원합니다. My Esri에서 설치에 해당하는 컨테이너 이미지를 다운로드하고 명령줄 PostInstaller 유틸리티(<ArcGIS Notebook Server installation directory>\tools\postInstallUtility에 있음)를 실행하여 ArcGIS Notebook Server에 대한 Docker 컨테이너 이미지를 설치합니다. 모든 ArcGIS Notebook Server 머신에 이 단계를 반복합니다. 설치 후 ArcGIS Notebook Server 구성 단계를 따릅니다.
3. 네트워크에서 2개의 디렉터리를 생성하고 공유합니다. 하나는 구성 저장소용이고 다른 하나는 일부 서버 디렉터리로 사용됩니다. Docker Desktop을 사용하는 경우 workspace 디렉터리는 로컬 경로에 유지되어야 합니다. 2개의 디렉터리에 대한 읽기 권한과 쓰기 권한을 각 머신의 ArcGIS Notebook Server 계정에 부여합니다(Microsoft File Explorer의 공유 탭과 보안 탭 모두에서 이 작업을 수행해야 함).

   비고:

   숨겨져 있거나 특수 문자(예시: $)를 사용하는 공유 네트워크 디렉터리는 ArcGIS Notebook Server에서 지원되지 않습니다.

   • 사이트를 만들 때 사용할 동일한 머신에 디렉터리가 있는 경우에도 수동으로 디렉터리를 만들고 공유하며 네트워크(UNC) 경로를 통해 참조해야 합니다.
   • ArcGIS Notebook Server 계정이 머신에 없는 경우(예시: 구성 저장소와 서버 디렉터리를 파일 서버에 배치한 경우) 배포의 다른 모든 머신에서 사용한 것과 동일한 이름과 비밀번호를 사용하여 ArcGIS Notebook Server 계정을 만들어야 합니다.
   • ArcGIS Notebook Server 계정에 그룹 관리 서비스 계정(gMSA)을 사용하는 경우, 공유 및 보안 탭에서 서비스 계정에 전체 제어 권한을 부여해야 합니다. 권한 편집기에서 추가를 클릭한 다음 객체 유형 대화 상자를 엽니다. 서비스 계정 체크 박스를 선택합니다.
4. 머신 중 하나에서 ArcGIS Notebook Server 사이트를 생성합니다. 이전에 설정한 서버 디렉터리와 구성 저장소의 경로를 사용했는지 확인합니다.
5. 이전 단계가 완료되면 구성 마법사를 사용하여 생성한 사이트에 각 머신을 추가로 가입할 수 있습니다. 명령줄을 통해 사이트에 가입하려면 6단계를 참고하세요.
   1. 첫 번째 추가 머신에서 ArcGIS Notebook Server 구성 마법사를 엽니다.
   2. 마법사에 제공된 지침을 검토하고 따른 다음, 계속을 클릭합니다.
   3. 기존 사이트 가입을 클릭합니다.
   4. 4단계에서 생성한 ArcGIS Notebook Server 사이트의 자격 증명과 사이트 URL을 입력합니다.
   5. 사이트에 조인할 머신을 추가할 때마다 하위 단계 a~d를 반복합니다.
머신이 추가로 사이트에 가입되면 해당 머신이 사이트에서 동일하게 간주됩니다. 프라이머리 머신은 없습니다.
6. 구성 마법사를 사용하는 대신 다음과 같이 명령줄 유틸리티를 사용하여 머신을 사이트에 가입할 수 있습니다.
   1. ArcGIS Notebook Server 계정으로 머신에 로그인했는지 확인합니다.
   2. 명령 프롬프트를 열고 <ArcGIS Notebook Server install directory>\tools\JoinSiteUtility\joinsite.bat에 있는 유틸리티를 실행합니다. 유틸리티의 명령줄 매개변수는 다음과 같습니다.

      매개변수	설명
      -u 또는 --username	기본 사이트 관리자의 사용자 이름입니다. \/:*?|<> 문자는 포함할 수 없습니다.
      -p 또는 --password	기본 사이트 관리자의 비밀번호입니다. 비밀번호에는 다음과 같은 문자가 포함될 수 없습니다. \/:*?|<>
      -f 또는 --file	joinsite 유틸리티의 구성 저장소 연결 파일입니다.
      -s 또는 --siteUrl	가입할 기존 ArcGIS Notebook Server 사이트의 URL로, https://notebookserver.domain.com:11443 형식입니다.
      -h 또는 --help	명령줄 도움말을 나타내고 종료합니다.

      유틸리티의 예시 명령은 다음과 같습니다.

      <ArcGIS Notebook Server install directory>\tools\JoinSiteUtility\joinsite.bat -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443

      계정 자격 증명과 사이트 URL을 올바르게 입력하면 유틸리티가 ArcGIS Notebook Server 사이트에 머신을 가입합니다. 추가할 각 머신에 대해 이 단계를 반복합니다.

이 시점에서 ArcGIS Notebook Server 머신 전체에 작업 영역 디렉터리에 대한 복제 시스템을 설정할 수 있습니다. 복제 옵션을 설정하는 단계는 ArcGIS Notebook Server에 대한 DFS 복제 구성에 설명되어 있습니다. 설치 프로세스 중 언제든지 복제 시스템을 설정할 수 있습니다.

모든 머신이 사이트에 가입되면 나머지 설치 프로세스는 단일 머신 사이트와 동일합니다. 사이트를 통해 ArcGIS Web Adaptor 설치와 구성을 계속합니다. 그런 다음, ArcGIS Enterprise 포털에서 사이트를 구성합니다.

명령줄을 통해 사이트에 가입

joinSite 명령줄 유틸리티를 사용하여 ArcGIS Notebook Server 사이트에 머신을 가입시킬 수도 있습니다. 이 유틸리티를 사용하려면 기존 사이트의 URL 대신 구성 저장소 위치를 지정해야 합니다. 따라서 URL 사용이 사이트에 대한 네트워크 요청 대기 목록을 가득 채우는 특정한 경우에 이 유틸리티를 사용하는 것이 유용합니다. ArcGIS Notebook Server 사이트의 머신이 이미 네트워크 요청으로 오버로드되어 있거나 다수의 머신을 한 번에 사이트에 가입시키려는 경우 이 유틸리티 사용을 고려해보세요.

join-site 유틸리티는 ArcGIS Notebook Server 설치 디렉터리의 \tools\JoinSiteUtility에 설치됩니다. 기존 사이트에 추가할 ArcGIS Notebook Server 머신에서 ArcGIS Notebook Server의 Run As 계정을 사용하여 join-site 유틸리티를 실행합니다.

1. 기존 사이트의 구성 저장소 폴더에 대한 읽기/쓰기 권한을 사이트에 가입할 머신에서 ArcGIS Notebook Server 서비스를 실행하는 데 사용되는 네트워크 계정에 부여합니다.
2. 이름이 connection.json인 JSON(JavaScript Object Notation) 파일을 생성합니다.
3. 파일에 다음 행을 추가하여 <path to the configuration store>을(를) 기존 ArcGIS Server 사이트의 구성 저장소 위치로 대체합니다.

   {"configPersistenceType": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   이 예시에서 기존 사이트의 구성 저장소 경로는 \\\\myshare\\arcgisserver\\config-store입니다.

   {" configPersistenceType": "FILESYSTEM", "connectionString": "\\\\myshare\\arcgisserver\\config-store"}

4. connection.json 파일을 저장한 후 닫습니다.
5. 사이트에 가입할 머신 또는 사이트에 가입할 머신에서 접근할 수 있는 공유 디렉터리에 connection.json 파일을 배치합니다.
6. 명령 프롬프트를 열고 join-site를 실행합니다.
구문은 다음과 같습니다.
joinSite -f <The file path to the configuration store JSON file>
이 예시에서 구성 저장소 JSON 파일(connection.json)은 join-site 도구(\tools\JoinSiteUtility)와 동일한 디렉터리에 있는 것으로 가정합니다.
joinsite.bat -f connection.json

머신이 ArcGIS Notebook Server 사이트에 가입됩니다.