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

ArcGIS Notebook Server는 다중 머신 사이트를 지원합니다. 다중 머신 사이트에서 각 머신은 동일한 구성, 동일한 OS, 동일한 Mirantis Container Runtime 설정, 작업 영역 디렉터리에 대해 동일한 드라이브 문자로 매핑된 네트워크 드라이브를 포함해야 합니다.

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

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

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

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

2. 설치 프로세스 중에 다음 작업을 이미 수행했는지 확인합니다.
   1. 각 머신에 Mirantis Container Runtime을 설치합니다. 각 머신에서 Esri가 제공하는 Docker 이미지를 다운로드하여 시스템에서 접근할 수 있는 위치에 저장합니다.
   2. 각 머신에 ArcGIS Notebook Server를 설치하고 인증합니다. 소프트웨어를 자동으로 설치할 수도 있습니다.
   3. ArcGIS Notebook Server는 Mirantis Container Runtime이 있는 Windows 컨테이너를 지원합니다. My Esri에서 설치에 해당하는 컨테이너 이미지를 다운로드하고 명령줄 PostInstaller 유틸리티(<ArcGIS Notebook Server installation directory>\tools\postInstallUtility에 있음)를 실행하여 ArcGIS Notebook Server에 대한 Docker 컨테이너 이미지를 설치합니다. 모든 ArcGIS Notebook Server 머신에 이 단계를 반복합니다. 설치 후 ArcGIS Notebook Server 구성 단계를 따릅니다.
3. 네트워크에서 2개의 디렉터리를 생성하고 공유합니다. 하나는 구성 저장소용이고 다른 하나는 일부 서버 디렉터리로 사용됩니다. workspace 디렉터리는 Mirantis Container Runtime을 사용할 때 네트워크 드라이브로 매핑된 UNC 공유를 유지해야 합니다. 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 사이트에 머신을 가입합니다. 추가할 각 머신에 대해 이 단계를 반복합니다.

작업 영역 디렉터리에 매핑된 네트워크 드라이브 설정

이 프로세스는 다중 머신 Notebook Server 사이트를 설정하려는 경우에만 필요한 옵션입니다.

1. Notebook Server에 접근할 수 있는 별도의 머신에서 ArcGIS Notebook Server 작업 영역 디렉터리에 대한 UNC 공유를 생성합니다.

   비고:

   이 디렉터리에는 ArcGIS Notebook Server Windows 실행 계정에 대한 읽기/쓰기 권한이 있어야 합니다. ArcGIS Notebook Server 사이트에 참여하는 머신과 별도의 머신에서 ArcGIS Notebook Server 작업 영역 디렉터리에 대한 UNC 공유를 생성하는 것을 권장합니다. 머신을 다시 시작할 때 Notebook Server가 오프라인 상태인 경우 SMB 공유가 동일한 머신에서 생성되는 알려진 문제가 있습니다.

2. Notebook Server 머신에서 관리자로 PowerShell 창을 엽니다.
3. 다음 명령을 사용하여 나중에 사용할 수 있도록 ArcGIS Notebook Server 사용자 계정 비밀번호를 보안 문자열로 저장합니다.

   $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

4. PowerShell 기능에 자격 증명 지원을 추가합니다.

   $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

5. 영구 플래그가 설정된 폴더를 마운트합니다.

   New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

6. ArcGIS Notebook Server 사이트에 참여하는 모든 머신에서 2~5단계를 반복하고 모든 머신의 매핑된 드라이브에 동일한 드라이브 문자를 할당합니다.
7. 이전 단계에서 생성한 공유 네트워크 드라이브를 사용하여 ArcGIS Notebook Server 사이트 생성 시 작업 영역 디렉터리를 구성합니다.