ArcGIS Notebook Server 업그레이드(Linux 컨테이너)

ArcGIS Notebook Server 업그레이드는 사용자의 기존 Notebook을 유지하면서 기관에 소프트웨어 최신 기능과 개선 사항을 제공합니다. ArcGIS Enterprise 배포를 11.1로 업그레이드하는 경우 ArcGIS Notebook Server도 업그레이드해야 합니다.

ArcGIS Notebook Server 11.1 설치 패키지는 머신에 이전 버전의 ArcGIS Notebook Server 기존 설치가 있는지 여부를 감지합니다. 그러면 소프트웨어를 11.1로 업그레이드할 수 있습니다.

업그레이드 프로세스 중에 10.8.1 이전 버전에서 업그레이드한 경우에는 11.1에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증해야 합니다.

또한 Esri에서 새 컨테이너 이미지를 설치하여 사용자에게 11.1 Notebook 런타임을 제공해야 합니다. 이전 버전의 Notebook 런타임은 사이트에 남겨지며 사용자는 해당 런타임을 사용하여 Notebook을 계속 실행할 수 있습니다. 그러나 사용자가 11.1에서 새로운 기능을 사용하려는 경우 해당 Notebook의 런타임을 업데이트해야 합니다. 11.1에 해당하는 Notebook 런타임은 버전 8.0(ArcGIS Notebook Server Standard 8.0 및 ArcGIS Notebook Server Advanced 8.0)입니다.

비고:

사용자 설정 런타임을 사용하는 Notebook이 있는 경우, Windows Notebook Server에서 사용자 설정 런타임을 다시 빌드 및 재등록하고 연결된 Notebook 항목의 런타임 설정을 업데이트해야 합니다.

비고:

Notebook 런타임은 ArcGIS Enterprise 수명 주기 후에 지원 중단됩니다. Notebook은 지원 중단된 런타임을 사용하면 안 되며 지원되는 런타임으로 업데이트해야 합니다.

ArcGIS Enterprise 포털을 업그레이드하면 사이트 갤러리에서 사용 가능한 샘플 Notebook도 업데이트됩니다.

다중 머신 ArcGIS Notebook Server 사이트는 10.7.1 이상에서 지원됩니다. 단일 머신 사이트가 있고 업그레이드 후 ArcGIS Notebook Server 사이트를 여러 머신으로 확장하려는 경우 11.1로 업그레이드를 마친 후 사이트에 추가 머신을 가입하는 단계를 따릅니다.

ArcGIS Notebook Server의 업그레이드 프로세스는 내부 업그레이드이므로 소프트웨어를 제거하고 다시 설치할 필요가 없습니다. 업그레이드 프로세스 중에 사이트가 다운되며 사용자는 업그레이드가 완료될 때까지 Notebook에 접근하거나 Notebook을 실행할 수 없습니다.

아래 단계에 따라 ArcGIS Notebook Server를 11.1로 업그레이드합니다.

업그레이드 준비

업그레이드 전에 다음 정보를 신중하게 검토합니다.

• 11.1 컨테이너 이미지를 포함하여 업그레이드하기 전에 My Esri에서 필요한 모든 파일에 접근할 수 있습니다.
• ArcGIS Notebook Server를 올바르게 작동하려면 해당 버전이 페더레이션된 포털의 버전과 일치해야 합니다.
• Docker를 20.10.13 또는 그 이후 버전으로 업그레이드합니다.
• ArcGIS Enterprise 배포를 업그레이드하려면 다음을 수행합니다.
  1.  Portal for ArcGIS를 업그레이드합니다.
  2. ArcGIS Web Adaptor(포털용)를 업그레이드합니다.
  3. 포털의 호스팅 서버 역할을 하는 ArcGIS Server 사이트를 업그레이드합니다.
  4. ArcGIS Web Adaptor(서버용)를 업그레이드합니다.
  5. ArcGIS Data Store(프라이머리를 업그레이드한 후 스탠바이 업그레이드)를 업그레이드합니다.
  6. ArcGIS Notebook Server를 포함한 기타 서버를 업그레이드합니다.
  7. ArcGIS Notebook Server 샘플 데이터 설치
• 기존 ArcGIS Notebook Server를 제거하지 마세요. 이 ArcGIS Notebook Server 설치 및 명령줄 설치 프로그램은 ArcGIS Notebook Server 컴포넌트의 기존 설치를 검색하여 업그레이드하도록 설계되었습니다.
• 업그레이드 프로세스 중에는 포털에서 ArcGIS Notebook Server 사이트를 페더레이션 해제하거나 포털의 Notebook Server로 지정을 제거하지 마세요. 이는 포털에서 호스팅하는 기존 Notebook에 부정적인 영향을 줍니다.
• 설치 또는 명령줄 설치 프로그램을 사용해 ArcGIS Notebook Server를 업그레이드할 수 있습니다. 이러한 방법 중 하나를 선택하여 업그레이드합니다.
• 업그레이드하기 전에 ArcGIS Notebook Server 머신에서 사용되는 모든 웹브라우저의 캐시를 지우세요.
• ArcGIS Notebook Server 사이트의 Windows 서비스 계정(해당 실행 계정)은 업그레이드할 때 동일하게 유지되어야 합니다.

배포 백업

업그레이드하기 전에 배포를 백업하는 것을 권장합니다.

레거시:

10.7에서는 사이트의 구성 저장소 및 서버 디렉터리를 수동으로 백업해야 합니다.

Notebook은 webgisdr 유틸리티를 사용하여 포털 백업에 포함됩니다.

아래에 설명된 대로 ArcGIS Notebook Server 관리자 디렉터리에서 exportSite 작업을 수행하여 사이트의 구성 저장소를 백업할 수 있습니다. 이 사이트 구성 백업 외에도 파일 시스템의 수동 백업을 고려합니다.

백업 작업을 실행하려면 다음 단계를 수행합니다.

1. ArcGIS Notebook Server 관리자 디렉터리를 열고 관리자 권한이 있는 사용자로 로그인합니다.

   URL은 일반적으로 https://notebookserver.domain.com:11443/arcgis/admin입니다.

2. 사이트 > 사이트 내보내기로 이동합니다.
3. 파일을 내보낼 머신에서 위치의 전체 경로를 입력합니다.

   해당 사이트에는 이 디렉터리에 대한 접근 권한이 있어야 합니다.

4. 내보내기를 클릭합니다.

   내보내기 작업이 완료되면 디렉터리에 서버의 백업 파일 위치 링크가 제공됩니다.

5. 가능한 빨리 .agssite 파일 확장자가 있는 파일을 다운로드합니다.

설치 프로그램을 사용하여 업그레이드

비고:

설치 파일을 사용하여 ArcGIS Notebook Server를 11.1로 업그레이드 설치를 업그레이드한 후 구성 마법사 또는 업그레이드 사이트 유틸리티를 사용하여 ArcGIS Notebook Server 사이트를 업그레이드해야 합니다.

다중 머신 사이트가 있는 경우 한 머신에 대해 1~5단계를 수행한 후 사이트의 각 머신에 대해 해당 단계를 반복합니다.

ArcGIS Notebook Server는 ArcGIS Notebook Server 컴포넌트의 기존 설치를 검색하여 업그레이드하도록 설계되었습니다.

1. 업그레이드를 시작하려면 ArcGIS Notebook Server가 추출된 위치에서 ./Setup을 실행하고 메시지에 따라 업그레이드를 완료합니다.

   기존 ArcGIS Notebook Server를 설치한 사용자 계정으로 설치 프로그램을 실행해야 합니다. 설치 중에는 설치 프로그램이 기존 설치를 식별하여 업그레이드를 확인하라는 메시지가 표시됩니다. 설치를 계속하려면 선택 y를 입력합니다.

   그러면 ArcGIS Notebook Server의 이전 버전이 제거되고 업그레이드된 버전의 ArcGIS Notebook Server가 설치됩니다.

2. 업그레이드 유틸리티가 완료되면 11.1에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증합니다. 소프트웨어 인증 마법사를 사용하여 인증을 완료합니다.
3. 설치 업그레이드 끝에 나오는 URL을 사용하여 구성 마법사를 열고 화면의 지시에 따라 사이트를 업그레이드하십시오.
4. 다중 머신 사이트의 경우 사이트의 각 머신에 대해 1~3단계를 수행합니다.

명령줄을 통해 업그레이드

명령줄에서 업그레이드하려면 다음 단계를 완료합니다.

1. 업그레이드를 시작하려면 아래 예시에 표시된 인수를 사용하여 ArcGIS Notebook Server 설치 명령을 실행합니다. 기존 설치에서 사용한 것과 동일한 ArcGIS Notebook Server 계정을 사용해야 합니다.

   그러면 ArcGIS Notebook Server의 이전 버전이 제거되고 업그레이드된 버전의 ArcGIS Notebook Server가 설치됩니다.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. upgradesite 유틸리티를 사용하고 다음 명령을 실행하여 업그레이드를 완료합니다. 기본 설정에 따라 upgradesite 유틸리티는 C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat에 있습니다.

   upgradesite.bat -s

   유틸리티에 진행률 보고서가 표시되며 업그레이드가 완료되면 중지됩니다. 이 유틸리티에는 두 가지 매개변수가 있습니다.

   • -s- 명령에 포함된 경우 유틸리티를 통해 업그레이드를 실행하라는 메시지가 표시됩니다. 해당 업그레이드는 -s 없이 실행되지 않습니다. 이는 준비가 완료된 경우에만 업그레이드를 실행하도록 하기 위한 보호 조치입니다.
   • -h- 도구에 대한 도움말을 표시합니다. -s 없이 명령이 실행되는 경우에도 도움말이 표시됩니다.

3. 다중 머신 사이트의 경우 사이트의 각 머신에 대해 1~2단계를 반복하고 다음 섹션의 단계를 계속 진행합니다.

자동 인증

업그레이드 유틸리티가 완료된 후 10.8.1 이전 버전에서 업그레이드한 경우에는 11.1에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증해야 합니다.

ArcGIS Notebook Server를 자동 인증하려면 다음 구문으로 SoftwareAuthorization.exe를 실행합니다. 파일을 실행하기 전에 인증 또는 프로비저닝 파일에서 모든 사용자 정보를 완료한 상태여야 합니다.

인증 파일이 있고 머신이 인터넷에 연결되어 있는 경우 다음을 실행합니다.

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

오프라인 환경에서 인증

프로비저닝(.prvc) 파일을 사용하여 오프라인 환경에서 ArcGIS Notebook Server를 인증할 수 있습니다. 프로세스 중에 프로세스를 완료하기 위해 Esri에 보낼 파일이 생성됩니다.

1. 프롬프트에서 ArcGIS Notebook Server 업그레이드가 완료되면 아래에 제공된 명령을 실행합니다.

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. 결과 정보 파일이 생성되면 다음 중 하나를 수행합니다.
   • Esri 고객 서비스 웹사이트 https://service.esri.com/drm로 이동합니다. 화면의 지시에 따라 인증 정보 파일을 업로드하고 .ecp 인증 파일을 다운로드합니다.
   • 인증 정보 파일을 [e-mail]에 이메일로 보냅니다. 그러면 Esri로부터 .ecp 인증 파일이 이메일로 다시 수신됩니다.
3. 위 방법 중 하나로 .ecp 인증 파일을 받으면 authorizeSoftware 스크립트를 다시 실행하여 처리하고 서버 인증 프로세스를 완료합니다.

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

ArcGIS Notebook Server를 실행하는 각 머신에 이 워크플로를 반복합니다.

업그레이드 후 단계

업그레이드되고 다시 인증된 ArcGIS Notebook Server 사이트를 사용하려면 먼저 설치 후 유틸리티를 실행하여 새 Docker 컨테이너 이미지를 사이트에 추가해야 합니다. 또한 새 버전과 일치하도록 사이트에 등록된 ArcGIS Web Adaptor 인스턴스를 교체해야 합니다.

설치 후 유틸리티 실행

설치 후 유틸리티를 실행하려면 다음 단계를 완료합니다.

1. 관리자로 명령 프롬프트 창을 엽니다.
2. ArcGIS Notebook Server 도구 폴더로 디렉터리를 변경합니다. 기본 설정에 따라 이 경로는 C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility입니다.
3. 필요에 따라 PostInstallUtility.bat -h 명령을 실행하여 유틸리티의 도움말을 참조하세요.
4. ArcGIS Notebook Server을 사용하려면 Docker Engine 커뮤니티 버전이 머신에 설치되어 있어야 합니다. PostInstallUtility.bat -d 명령을 실행하여 머신에서 Docker가 활성 상태인지 확인합니다.
5. Docker Desktop가 설치되지 않은 경우 지금 설치하세요.

   ArcGIS Notebook Server는 Docker Desktop에서 Linux 컨테이너를 사용합니다. Docker Desktop을 설치할 때 Linux 컨테이너를 지정했는지 확인합니다. Windows 컨테이너로 전환 옵션은 클릭하지 마세요.

6. Docker Desktop을 사용할 경우 다음 설정을 각각 수정합니다.
   1. 시스템 트레이의 Docker 버튼을 마우스 오른쪽 버튼으로 클릭한 다음 설정을 클릭합니다. 일반에서 TLS 없이 tcp://localhost:2375에서 데몬 노출  체크 박스를 선택합니다.

      그러면 포트 2375를 사용해야 하는 Docker 원격 API를 사용하게 됩니다.

   2. 시스템 트레이의 Docker 버튼을 마우스 오른쪽 버튼으로 클릭한 다음 설정을 클릭합니다. 설정 메뉴에서 리소스 > 파일 공유를 클릭하고 ArcGIS Notebook Server 구성 저장소에 사용할 드라이브 디렉터리를 추가합니다.

      비고:

      Windows용 Docker는 Linux 컨테이너와 공유할 Windows에서 로컬 디렉터리만 지원합니다.

7. 해당 파일 경로를 지정하여 Notebooks 이미지를 설치합니다. 이미지는 .tar.gz 형식으로 압축해야 합니다. Advanced 라이선스 및 Docker Desktop이 있는 경우 명령을 두 번 실행하여 My Esri에서 다운로드한 Standard 컨테이너 이미지와 Advanced 컨테이너 이미지를 모두 설치합니다.

   비고:

   머신의 사용 가능한 디스크 공간이 75GB 이상인지 확인합니다.

   PostInstallUtility.bat -l <path of .tar.gz Docker image> 명령을 실행합니다.

   비고:

   두 컨테이너 이미지는 모두 설치해야 합니다. Advanced 라이선스를 가지고 있더라도 사용자는 Standard 런타임이 아직 필요할 수 있기 때문입니다.

ArcGIS Notebook Server 샘플 데이터 설치 및 구성

다중 머신 ArcGIS Notebook Server 사이트를 설정하는 경우 Notebook Server를 설치하고 사이트를 생성한 첫 번째 머신에만 샘플 데이터를 설치하고 구성해야 합니다.

샘플 데이터를 설치하고 구성하려면 다음 단계를 따릅니다.

1. My Esri에서 다운로드한 ArcGIS Notebook Server 샘플 데이터 설치 마법사를 실행합니다.

   그러면 ArcGIS Notebook Server가 설치된 디렉터리에 샘플 데이터가 설치됩니다.

2. 관리자로 명령 프롬프트 창을 엽니다.
3. ArcGIS Notebook Server 도구 폴더로 디렉터리를 변경합니다.

   기본 설정에 따라 이 경로는 C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility입니다.

4. 필요에 따라 다음 명령을 실행하여 유틸리티의 도움말을 참조할 수 있습니다.

    > PostInstallUtility.bat -h

5. 설치 후 유틸리티를 실행하여 Notebook 서버 사이트의 arcgisworkspace 디렉터리에 샘플 데이터를 추출합니다.

    PostInstallUtility.bat -x

ArcGIS Web Adaptor 인스턴스 바꾸기

ArcGIS Web Adaptor 인스턴스를 바꾸려면 다음 단계를 완료합니다.

1. 사이트에서 ArcGIS Web Adaptor의 이전 인스턴스를 등록 해제하고 제거합니다.
   1. ArcGIS Notebook Server 관리자 디렉터리에 로그인합니다.
   2. 시스템 > 웹 어댑터 > 등록된 머신으로 이동합니다.
   3. 웹 어댑터 등록 해제를 클릭합니다.  
2. ArcGIS Web Adaptor 11.1의 새 인스턴스를 설치하고 ArcGIS Notebook Server로 구성합니다.
배포 업그레이드가 완료되면 11.1 기능을 사용할 수 있습니다.
3. 10.8 이전 버전에서 업그레이드하는 경우 포털에서 Notebook 예약을 활성화하려면 다음을 수행합니다.
   1. 필요한 경우 새 Notebook 예약 권한을 추가하려면 Notebook 권한을 포함하는 사용자 설정 역할을 업데이트합니다.
   2. 예약 기능을 사용하려는 경우 Notebook 작성자에게 각 Notebook의 런타임을 업데이트하도록 합니다.

      10.8.1 런타임(버전 4.0) 이상을 사용하는 Notebook만 예약할 수 있습니다.

이제 ArcGIS Notebook Server 11.1 사이트에서 ArcGIS Notebooks을 호스팅할 준비가 되었습니다.