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

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

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

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

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

비고:

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

비고:

Notebook 런타임은 ArcGIS Enterprise 수명 주기 후에 지원종료됩니다. Notebook 런타임은 ArcGIS Enterprise 관련 버전이 만료되는 동시에 지원종료됩니다. Notebook은 지원종료된 런타임을 사용할 수 없으며 지원되는 런타임으로 업데이트해야 합니다.

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

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

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

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

업그레이드 준비

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

• 11.3 컨테이너 이미지를 포함하여 업그레이드하기 전에 My Esri에서 필요한 모든 파일에 접근할 수 있습니다.
• ArcGIS Notebook Server를 올바르게 작동하려면 해당 버전이 페더레이션된 포털의 버전과 일치해야 합니다.
• Notebook Server가 현재 읽기 전용 모드인 경우에는 업그레이드 프로세스를 시작하기 전에 이 모드를 끕니다.
• Docker를 23.0 이후 버전으로 업그레이드합니다.
• 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 머신에서 사용되는 모든 웹브라우저의 캐시를 지우세요.

작업 영역 디렉터리 이동

이 프로세스는 Notebook Server 설치 디렉터리에 작업 영역 디렉터리\가 있는 ArcGIS Notebook Server에서 단일 머신 Linux 배포에 필요합니다.

1. 관리자로 ArcGIS Enterprise 포털에 로그인하여 ArcGIS Notebook Server Manager를 엽니다.
2. 설정 탭을 클릭합니다.
3. 디렉터리를 클릭합니다.
4. arcgisworkspace 디렉터리로의 현재 경로가 ArcGIS Notebook Server 설치 디렉터리에 있는지를 확인합니다.

   <installdir>/arcgis/notebook/directories/arcgisworkspace

   arcgisworkspace 디렉터리가 ArcGIS Notebook Server 설치 디렉터리에 있는 경우 작업 영역 디렉터리를 설치 디렉터리 외부의 위치로 이동해야 업그레이드할 수 있습니다.

   arcgisworkspace 디렉터리가 ArcGIS Notebook Server 설치 디렉터리에 없는 경우 이 섹션의 나머지 단계를 수행할 필요가 없습니다.

5. arcgisworkspace 디렉터리에 대해 편집을 클릭합니다.
6. 기존 디렉터리 경로 값을 설치 디렉터리 외부의 arcgisworkspace 디렉터리에 대한 새 경로로 바꿉니다.

   <installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace

7. 저장을 클릭합니다.
8. 이전 arcgisworkspace 디렉터리의 모든 콘텐츠를 새 arcgisworkspace 디렉터리로 직접 복사합니다.

배포 백업

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

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.3로 업그레이드 설치를 업그레이드한 후 구성 마법사 또는 업그레이드 사이트 유틸리티를 사용하여 ArcGIS Notebook Server 사이트를 업그레이드해야 합니다.

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

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

설치 프로그램을 사용하여 업그레이드하려면 다음 단계를 완료합니다.

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

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

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

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

명령줄을 통해 업그레이드

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

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

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

   <untar directory>/Setup -l yes -m silent

2. 업그레이드 유틸리티가 완료되면 11.3에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증합니다. ArcGIS Notebook Server를 자동 인증하려면 다음 구문으로 소프트웨어 인증을 실행합니다.

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware

   인증에 대한 모든 옵션을 보려면 다음 명령을 실행합니다.

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

   비고:

   오프라인 환경에서 ArcGIS Notebook Server 설치를 인증하는 방법에 대한 정보는 오프라인 환경에서 인증 섹션을 참고하세요.

3. upgradesite 명령줄 유틸리티를 사용하여 사이트를 업그레이드합니다.

   유틸리티에는 두 가지 매개변수가 있습니다.

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

   기본 설정에 따라 upgradesite 유틸리티는 ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh에 있습니다.

   업그레이드 전에 이 항목의 시작 부분에 있는 준비 정보를 검토하세요. 업그레이드 준비가 완료되면 업그레이드 중인 머신에서 명령 터미널을 엽니다. 유틸리티가 있는 디렉터리로 이동하여 다음 명령을 실행합니다.

   > ./upgradesite.sh -s

   유틸리티에 진행률 보고서가 표시되며 업그레이드가 완료되면 중지됩니다.

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

자동 인증

업그레이드 유틸리티가 완료되면 11.3에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증해야 합니다.

ArcGIS Notebook Server를 자동 인증하려면 다음 구문으로 소프트웨어 인증을 실행합니다.

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

인증에 대한 모든 옵션을 보려면 다음 명령을 실행합니다.

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

오프라인 환경에서 인증

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

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

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>

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

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

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

업그레이드 후 단계

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

설치 후 유틸리티 실행

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

1. ArcGIS Notebook Server 설치 디렉터리를 사용해 터미널을 엽니다.
2. ArcGIS Notebook Server 도구 폴더로 디렉터리를 변경합니다. 기본 설정에 따라 이 경로는 ${HOME}/arcgis/notebookserver/tools/postInstallUtility입니다.
3. 필요에 따라 ./PostInstallUtility.sh -h 명령을 실행하여 유틸리티의 도움말을 참조하세요.
4. ArcGIS Notebook Server을 사용하려면 Docker Engine이 머신에 설치되어 있어야 합니다. ./PostInstallUtility.sh -d 명령을 실행하여 머신에서 Docker가 활성 상태인지 확인합니다.
5. Docker Desktop가 설치되지 않은 경우 지금 설치하세요.
6. 해당 파일 경로를 지정하여 Notebooks 이미지를 설치합니다. 이미지는 .tar.gz 형식으로 압축해야 합니다. Advanced 라이선스 및 Docker Desktop이 있는 경우 명령을 두 번 실행하여 My Esri에서 다운로드한 Standard 컨테이너 이미지와 Advanced 컨테이너 이미지를 모두 설치합니다.

   비고:

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

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

   비고:

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

비고:

이전 이미지는 자동으로 제거되지 않습니다. 이전 런타임 이미지를 삭제하기 전에 각 Notebook과 연결된 런타임을 최신 버전으로 직접 업데이트해야 합니다.

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

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

ArcGIS Notebook Server 샘플 데이터를 설치하려면 다음 단계를 완료합니다.

1. ArcGIS Notebook Server를 실행할 사용자로 명령 셸을 엽니다. ArcGIS Notebook Server에서 tar.gz 샘플 데이터 My Esri 파일을 다운로드한 디렉터리로 이동합니다.
2. 다음 명령으로 tar.gz 파일의 압축을 해제합니다.

   tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz

3. <install directory>/notebookserver/License(으)로 이동하여 라이선스 동의서를 읽습니다.
4. 디렉터리에서 스크립트를 실행합니다.

   ./ArcGISNotebookServerSamplesData-Setup.sh

5. ArcGIS Notebook Server 도구 폴더로 디렉터리를 변경합니다.

   기본 설정에 따라 이 경로는 ${HOME}/arcgis/notebookserver/tools/postInstallUtility입니다.

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

   > ./PostInstallUtility.sh -h

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

   > ./PostInstallUtility.sh -x

ArcGIS Web Adaptor 인스턴스 바꾸기

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

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

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

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