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

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

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

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

   두 머신 모두에서 동일한 운영 체제 사용자를 사용하여 설치해야 합니다. ArcGIS Notebook Server 설치에 사용되는 사용자 계정은 소프트웨어 실행에 사용되는 계정입니다. 그룹 사용자와 기타 모든 사용자는 적어도 ArcGIS Notebook Server 설치 디렉터리에 대한 실행 권한이 있어야 합니다. 루트 계정으로 ArcGIS Notebook Server를 설치하는 기능은 지원되지 않습니다. 예를 들어 2개의 머신에 설치하는 데 사용되는 사용자 계정은 다음과 같습니다.

   1. ArcGIS Notebook Server에서 사용자 ID(58103)를 사용하여 사용자 AGS로 첫 번째 머신에 /data/ags를 설치합니다.
   2. 동일한 사용자 이름과 ID(AGS, 사용자 ID 58103)를 사용하여 /data/ags에서 두 번째 머신에 ArcGIS Notebook Server를 설치합니다.
2. 이 시점에서 설치 프로세스 중에 다음 작업을 이미 수행했는지 확인합니다.
   1. 각 머신에 Docker를 설치합니다. 각 머신에서 Esri가 제공하는 Docker 이미지를 다운로드하여 시스템에서 접근할 수 있는 위치에 저장합니다.
   2. 각 머신에 ArcGIS Notebook Server를 설치하고 인증합니다. 소프트웨어를 자동으로 설치할 수도 있습니다.
   3. Docker 이미지를 각 머신의 로컬 저장소에 불러오려면 명령줄 PostInstaller 유틸리티(<ArcGIS Notebook Server installation directory>/tools/postInstallUtility에 있음)를 실행합니다.
   4. 설치 후 ArcGIS Notebook Server 구성 단계를 따릅니다.
3. 설치 사용자를 소유자로 지정하여 네트워크에 2개의 디렉터리를 생성하고 공유합니다. 하나는 구성 저장소용이고 다른 하나는 서버 디렉터리로 사용됩니다. 폴더에 700개 이상의 권한을 부여해야 합니다.

   비고:

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

   예:
   1. 이름이 config-store인 디렉터리를 생성합니다. 사용자 ID 58103을 사용하여 소유자를 ags로 지정합니다. 디렉터리에 700개 이상의 권한을 부여합니다.
   2. 두 머신이 동일한 경로를 사용하여 디렉터리에 접근할 수 있도록 config-store 폴더를 공유합니다(예시: /net/myserver/config-store).
   3. 이름이 arcgisnotebookserver인 디렉터리를 생성합니다. 사용자 ID 58103을 사용하여 소유자를 ags로 지정합니다. 디렉터리에 700개 이상의 권한을 부여합니다.
   4. 두 머신이 동일한 경로를 사용하여 디렉터리에 접근할 수 있도록 arcgisnotebookserver 폴더를 공유합니다(예시: /net/myserver/arcgisnotebookserver).

      사이트를 만들 때 사용할 동일한 머신에 디렉터리가 있는 경우에도 수동으로 디렉터리를 만들고 공유하며 네트워크 경로를 통해 참조해야 합니다.

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.sh에 있는 유틸리티를 실행합니다. 유틸리티의 명령줄 매개변수는 다음과 같습니다.

      매개변수	설명
      -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.sh -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443

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

모든 머신이 사이트에 가입되면 나머지 설치 프로세스는 단일 머신 사이트와 동일합니다. 사이트를 통해 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>"}

   이 예시에서 기존 사이트의 구성 저장소 경로는 /net/mymachine/data/arcgisnotebookserver/usr/config-store입니다.

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

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 사이트에 가입됩니다.