ArcGIS Notebook Server 업그레이드

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

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

업그레이드 프로세스 중에 10.7.1 이하에서 업그레이드한 경우에는 10.8.1에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증해야 합니다. 10.8에서 10.8.1로 업그레이드하는 경우에는 소프트웨어를 다시 인증할 필요가 없습니다.

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

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

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

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

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

업그레이드 준비

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

• 10.8.1 컨테이너 이미지를 포함하여 업그레이드하기 전에 My Esri에서 필요한 모든 파일에 접근할 수 있습니다.
• ArcGIS Notebook Server를 올바르게 작동하려면 해당 버전이 페더레이션된 포털의 버전과 일치해야 합니다.
• 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를 포함한 기타 서버를 업그레이드합니다.
• 기존 ArcGIS Notebook Server를 제거하지 마세요. ArcGIS Notebook Server 설치 및 명령줄 설치 프로그램은 ArcGIS Notebook Server 컴포넌트의 기존 설치를 검색하여 업그레이드하도록 설계되었습니다.
• 업그레이드 프로세스 중에는 포털에서 ArcGIS Notebook Server 사이트를 페더레이션 해제하거나 포털의 Notebook Server로 지정을 제거하지 마세요. 이는 포털에서 호스팅하는 기존 ArcGIS 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를 10.8.1로 업그레이드하려면 설치 파일을 사용하는 것을 권장합니다. 기관 제한으로 인해 설치 파일을 사용할 수 없는 경우에는 스크립트를 사용하여 ArcGIS Notebook Server 관리자 디렉터리에서 사이트 업그레이드 작업을 호출할 수 있습니다.

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

1. 설치하는 동안 마스터 계약서를 읽고 동의하거나, 조건에 동의하지 않는 경우 종료합니다.

   설치 프로그램에는 설치될 기능과 하드 드라이브에 필요한 여유 디스크 공간이 표시됩니다.

2. 다음 대화 상자에서 계정 로그인 자격 증명을 지정하거나 구성 파일을 제공합니다.

   ArcGIS Server 계정 상자에는 기존 설치에 사용한 ArcGIS Notebook Server 계정이 미리 채워져 있습니다. ArcGIS Notebook Server 계정의 비밀번호를 입력합니다. 일반적으로는 소프트웨어를 설치할 때 정의한 비밀번호를 입력하면 됩니다.

   비밀번호 유효성 검사가 실패하면 비밀번호가 잘못되었음을 나타내는 오류 메시지가 나타납니다. ArcGIS Notebook Server 계정의 비밀번호가 기억나지 않으면 시스템 관리자에게 문의하거나 ArcGIS Notebook Server 관리자 디렉터리를 사용해 비밀번호를 재설정하세요.

   구성 파일을 제공하는 경우 서버 구성 파일의 자격 증명은 기존 ArcGIS Notebook Server 사이트에서 사용하는 것과 동일한 자격 증명이어야 합니다.

3. 계정 이름 및 비밀번호 지정을 선택한 후 ArcGIS Notebook Server 계정 정보를 수동으로 입력한 경우 나타나는 대화 상자에서 서버 구성 파일을 내보낼 수 있습니다. 구성 파일을 내 보내지 않으려면 다음을 클릭하고 기본 구성 파일을 내보내지 않음 옵션을 수락합니다. 향후 설치를 위해 서버 구성 파일을 내보내려면 구성 파일 내보내기를 클릭하고 보안 폴더를 찾은 후 구성 파일의 이름을 제공합니다.

   비고:

   다음 중 하나를 수행해야 하는 경우 서버 구성 파일을 내보낼 수 있습니다.

   • 여러 머신에 설치하는 경우 동일한 ArcGIS Notebook Server 계정을 만듭니다.
   • 최신 버전으로 업그레이드할 때 사용할 계정을 저장합니다.
   • 사용자 이름과 비밀번호가 암호화된 자동 설치를 수행합니다.

   주의:

   서버 구성 파일을 네트워크 공유에 내보낼 때 ArcGIS Notebook Server가 설치 중인 머신에 있는 로컬 시스템 계정은 네트워크 공유에 대한 쓰기 권한이 있어야 합니다. 권한이 설정되지 않은 경우 서버 구성 파일을 성공적으로 내보낼 수 없습니다. 네트워크 공유에 대해 올바르게 권한을 설정하는 방법을 모르는 경우 시스템 관리자에게 문의하거나 서버 구성 파일을 로컬로 내보내고 네트워크 공유에 복사합니다.

4. 설치를 완료하려면 화면의 지시를 따릅니다.
5. 설치가 완료되면 구성 마법사가 브라우저에서 열립니다. 구성 마법사에 제공된 지침에 따라 업그레이드 프로세스를 완료합니다.
6. 다중 머신 사이트가 있는 경우 사이트의 나머지 머신에 대해 1~5 단계를 수행합니다. 단일 머신 사이트가 있고 다중 머신 사이트로 업그레이드하려는 경우 사이트에 추가 머신을 가입할 수 있습니다. 또한 각 머신에 접근할 수 있는 공유 위치를 사용하려면 서버 디렉터리 및 구성 저장소의 경로를 수정해야 합니다. 단, 작업 영역 디렉터리와 사용자 설정 데이터 디렉터리는 예외입니다. 해당 디렉터리는 각 머신에서 로컬로 유지되어야 하며 DFS와 같은 시스템을 사용하여 복제되어야 합니다.

명령줄을 통해 업그레이드

10.8부터 시작하는 ArcGIS Notebook Server 유틸리티를 사용하여 명령줄에서 upgradesite를 업그레이드할 수도 있습니다.

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

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

기본 설정에 따라 upgradesite 유틸리티는 C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat에 있습니다.

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

> upgradesite.bat -s

유틸리티에 진행률 보고서가 표시되며 업그레이드가 완료되면 중지됩니다. 사이트에 여러 머신이 있는 경우 각 머신에서 이 명령을 반복한 후 다음 섹션의 단계를 계속합니다.

자동 인증

업그레이드 프로세스가 완료된 후 10.7.1 이전에서 업그레이드한 경우에는 10.8.1에 대한 ArcGIS Notebook Server 소프트웨어를 다시 인증해야 합니다. 10.8에서 10.8.1로 업그레이드하는 경우에는 소프트웨어를 다시 인증할 필요가 없습니다.

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

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

<System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /S /Ver 10.7 /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. ArcGIS Notebook Server다음으로 실행 계정을 사용하여 명령 프롬프트 창을 엽니다.
2. 해당 파일 경로를 지정하여 Docker 이미지를 설치합니다. 이미지는 .tar.gz 형식으로 압축해야 합니다. Advanced 라이선스가 있는 경우 명령을 두 번 실행하여 My Esri에서 다운로드한 Standard 및 Advanced 컨테이너 이미지를 모두 설치합니다.> PostInstallUtility.bat -l <path of .tar.gz Docker image>

   비고:

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

3. 사이트에서 ArcGIS Web Adaptor의 이전 인스턴스를 등록 해제하고 제거합니다.
   1. ArcGIS Notebook Server 관리자 디렉터리에 로그인합니다.
   2. 시스템 > 웹 어댑터 > 등록된 머신으로 이동합니다.
   3. 웹 어댑터 등록 해제를 클릭합니다.  
4. ArcGIS Web Adaptor 10.8.1의 새 인스턴스를 설치하고 ArcGIS Notebook Server에 등록합니다.
5. 배포 업그레이드가 완료되면 10.8.1 기능을 활용할 수 있습니다. 포털에서 Notebook 예약을 활성화하려면 다음을 수행합니다.

   • 원하는 경우 새 Notebook 예약 권한을 추가하려면 Notebook 권한을 포함하는 사용자 설정 역할을 업데이트합니다.
   • 예약 기능을 사용하려는 경우 Notebook 작성자에게 각 Notebook의 런타임을 업데이트하도록 합니다. 10.8.1 런타임(버전 4.0)을 사용하는 Notebook만 예약할 수 있습니다.

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