ArcGIS Notebook Server のアップグレード—ArcGIS Notebook Server

ArcGIS Notebook Server をアップグレードすると、ソフトウェアの最新機能と機能改善を利用しながら、ユーザーの既存の ArcGIS Notebooks を保持できます。 ArcGIS Enterprise 配置を 10.9.1 にアップグレードする場合、ArcGIS Notebook Server もアップグレードする必要があります。

ArcGIS Notebook Server 10.9.1 セットアップパッケージは、コンピューターに以前のバージョンの ArcGIS Notebook Server の既存のインストールがあるか検出します。検出された場合、ソフトウェアが 10.9.1 にアップグレードされます。

10.8.1 以前からアップグレードする場合は、アップグレード処理中に 10.9.1 用に ArcGIS Notebook Server ソフトウェアを再認証する必要があります。

また、Esri から提供された新しいコンテナーイメージをインストールして、ユーザーに 10.9.1 ノートブックランタイムを提供する必要があります。以前のバージョンのノートブックランタイムはサイトで維持されるため、ユーザーは引き続きそれらのランタイムを使ってノートブックを実行できます。ただし、10.9.1 の新機能をユーザーが使う場合は、ノートブックのランタイムを更新する必要があります。 10.9.1 に対応するノートブックランタイムはバージョン 6.0 になります ([ArcGIS Notebook Server Standard 6.0] と [ArcGIS Notebook Server Advanced 6.0])。

ArcGIS Enterprise ポータルをアップグレードすると、サイトのギャラリーで利用できるサンプルノートブックも更新されます。

複数コンピューター ArcGIS Notebook Server サイトは 10.7.1 以降でサポートされています。単一コンピューターサイトがあり、アップグレード後に ArcGIS Notebook Server サイトを複数コンピューターに拡張したい場合は、10.9.1 へのアップグレード後にサイトにコンピューターを追加するための手順に従います。

ArcGIS Notebook Server のアップグレードプロセスはインプレースアップグレードであるため、ソフトウェアのアンインストールと再インストールが必要ありません。アップグレードプロセス中はサイトがダウンするため、アップグレードが完了するまでユーザーはノートブックにアクセスしたり実行することはできません。

以下の手順に従って ArcGIS Notebook Server を 10.9.1 にアップグレードします。

アップグレードの準備

アップグレードを実行する前に、次の情報をよく確認してください。

アップグレード前に、10.9.1 コンテナーイメージなど、My Esri にある必要なすべてのファイルにアクセスできます。
ArcGIS Notebook Server を正しく機能させるために、バージョンをフェデレーションされているポータルのバージョンと一致させる必要があります。
Docker をサポートされているバージョンにアップグレードします。
ArcGIS Enterprise の配置をアップグレードするには以下を実行します。
1. Portal for ArcGIS をアップグレードします。
2. ArcGIS Web Adaptor (Portal 用) をアップグレードします。
3. ポータルのホスティングサーバーとして機能する ArcGIS Server サイトをアップグレードします。
4. ArcGIS Web Adaptor (Server 用) をアップグレードします。
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 としての指定を削除したりしないでください。これによって、ポータルでホストされている既存の ArcGIS Notebooks に悪影響が及びます。
セットアップまたはコマンドラインインストーラーのいずれかを使用して、ArcGIS Notebook Server をアップグレードすることができます。これらのアップグレード方法のいずれかを選択します。
アップグレード前に ArcGIS Notebook Server コンピューターで使用しているすべての Web ブラウザーのキャッシュをクリアします。
アップグレード時には ArcGIS Notebook Server サイトの Windows サービスアカウント (実行アカウント) を同じにしておく必要があります。

デプロイメントのバックアップ

アップグレード前にデプロイメントのバックアップを取ることをお勧めします。

レガシー:

10.7 ではサイトの構成ストアとサーバーディレクトリのバックアップを手動で取る必要があります。

ノートブックが webgisdr ユーティリティを使ってポータルバックアップに保存されます。

以下のように ArcGIS Notebook Server Administrator Directory で exportSite 操作を使用して、サイトの構成ストアをバックアップできます。このサイト構成バックアップに加え、ファイルシステムの手動バックアップを作成することも検討してください。

バックアップ操作を実行するには、次の手順を実行します。

ArcGIS Notebook Server Administrator Directory を開き、管理者権限を持つユーザーとしてサインインします。 URL は、通常 https://notebookserver.domain.com:11443/arcgis/admin です。
[site] > [Export Site] の順に参照します。
ファイルのエクスポート先となるコンピューター上の場所の絶対パスを入力します。サイトからこのディレクトリにアクセスできる必要があります。
[エクスポート] をクリックします。
エクスポート操作が完了すると、ディレクトリからサーバー上のバックアップファイルの場所へのリンクが作成されます。できるだけ早く、*.agssite ファイル拡張子を持つファイルをダウンロードします。

セットアッププログラムを使用したアップグレード

注意:

セットアップファイルを使用して ArcGIS Notebook Server を 10.9.1 にアップグレードすることをお勧めします。セットアップをアップグレード後、構成ウィザードまたはアップグレードサイトユーティリティを使用して ArcGIS Notebook Server サイトをアップグレードする必要があります。

複数コンピューターサイトがある場合は、単一コンピューター用の手順 1 から 3 に従ってサイトの各コンピューターでこれらの手順を繰り返します。

ArcGIS Notebook Server は、ArcGIS Notebook Server コンポーネントの既存のインストールを検出してアップグレードするように設計されています。アップグレードを開始するには、ArcGIS Notebook Server を抽出した場所から ./Setup を実行します。さらに、画面上の指示に従ってアップグレードを完了します。セットアップは、既存の ArcGIS Notebook Server のインストールに使用したユーザーアカウントで実行する必要があります。インストール時に、セットアッププログラムは既存のインストールを識別し、アップグレードを確認するようプロンプトが表示されます。「y」と入力してインストールを続行します。
これにより、ArcGIS Notebook Server の以前のバージョンがアンインストールされ、ArcGIS Notebook Server のアップグレードバージョンがインストールされます。
アップグレードユーティリティが完了した後に 10.9.1 用に ArcGIS Notebook Server ソフトウェアを再認証する必要があります。ソフトウェア認証ウィザードを使用して認証を完了します。
インストールのアップグレード終了時にリストされる URL を使用して構成ウィザードを開き、画面上の指示に従ってサイトをアップグレードします。
複数コンピューターサイトについては、サイトの各コンピューターに対して手順 1 から 3 を実行します。

コマンドラインからのアップグレード

アップグレードを開始するには、以下の例に示す引数を使用して Notebook Server セットアップコマンドを実行します。これにより、ArcGIS Notebook Server の以前のバージョンがアンインストールされ、ArcGIS Notebook Server のアップグレードバージョンがインストールされます。既存のインストールと同じ ArcGIS Notebook Server アカウントを使用していることを確認します。
```
setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password>
```
upgradesite ユーティリティを使用し、次のコマンドを実行してアップグレードを完了します。デフォルトでは、upgradesite ユーティリティは C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat にあります。
```
upgradesite.bat -s
```
ユーティリティに進捗レポートが表示され、アップグレードが完了すると停止します。このユーティリティには、次の 2 つのパラメーターがあります。
- -s - コマンドに含めると、ユーティリティでアップグレードが実行されます。 -s なしではアップグレードは実行されません。これは、準備ができているときだけアップグレードを実行するための安全策です。
- -h - ツールのヘルプを表示します。 -s なしでコマンドを実行してもヘルプが表示されます。
複数コンピューターサイトについては、サイトの各コンピューターに対して手順 1 と 2 を繰り返し、次のセクションの手順を実行します。

サイレント認証

10.8.1 以前からアップグレードした場合は、アップグレードユーティリティが完了した後に 10.9.1 用に ArcGIS Notebook Server ソフトウェアを再認証する必要があります。

次の構文を使用して SoftwareAuthorization.exe を実行し、ArcGIS Notebook Server のサイレント認証を実行します。すべての完全なユーザー情報を認証ファイルまたはプロビジョニングファイルに含めてから、このファイルを実行する必要があります。

認証ファイルがあってコンピューターがインターネットに接続している場合は以下を実行します。

<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 に送信されます。

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>

出力情報ファイルが作成されたら、次のいずれかを実行します。
- Esri カスタマーサービスの Web サイト (https://service.esri.com/drm) を参照します。画面上の指示に従って、認証情報ファイルをアップロードしてから、*.ecp 認証ファイルをダウンロードします。
- 認証情報ファイルを電子メールで authorize@esri.com に送信します。Esri から *.ecp 認証ファイルが返信されます。
上記のいずれかの方法を使用して *.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 インスタンスを新しいバージョンに合わせて置き換える必要があります。

ポストインストールユーティリティの実行

管理者としてコマンドプロンプトウィンドウを開きます。
ディレクトリを ArcGIS Notebook Server ツールフォルダーに変更します。デフォルトではこのパスは C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility になります。
必要に応じて、ユーティリティのヘルプを参照するために次のコマンドを実行します: > PostInstallUtility.bat -h
ArcGIS Notebook Server では Docker Engine Community Edition をコンピューターにインストールする必要があります。次のコマンドを実行してコンピューターで Docker がアクティブになっているかを確認します: > PostInstallUtility.bat -d
Docker がインストールされていない場合はインストールします。
ArcGIS Notebook Server では Windows コンテナーではなく Docker の Linux コンテナーを使用します。 Docker をインストールする際は Linux コンテナーを指定して [Switch to Windows containers] オプションをクリックしないようにします。
Docker で次の設定をそれぞれ変更します。
1. システムトレイで [Docker] ボタンを右クリックして [Settings] をクリックします。 [General] で [Expose daemon on tcp://localhost:2375 without TLS] チェックボックスをオンにします。
  Docker Remote API を使用するため、ポート 2375 を使用する必要があります。
2. システムトレイで [Docker] ボタンを右クリックして [Settings] をクリックします。 [Settings] メニューで、[Resources] > [File sharing] の順にクリックし、ArcGIS Notebook Server 構成ストアに使用するドライブのディレクトリを追加します。
  注意:
  Docker for Windows は、Linux コンテナーと共有される Windows のローカルディレクトリにのみ対応しています。
Docker イメージのファイルパスを指定してインストールします。イメージは .tar.gz 形式で圧縮しておく必要があります。 Advanced ライセンスがある場合は、コマンドを 2 回実行して My Esri からダウンロードした Standard と Advanced 両方のコンテナーイメージをインストールします。次のコマンドを実行します: > 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 がインストールされているディレクトリにインストールされます。
管理者としてコマンドプロンプトウィンドウを開きます。
ディレクトリを ArcGIS Notebook Server ツールフォルダーに変更します。
このパスのデフォルトは C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility です。
必要に応じて、ユーティリティのヘルプを参照するために次のコマンドを実行します:
```
 > PostInstallUtility.bat -h
```
ポストインストールユーティリティを実行して、サンプルデータを Notebook Server サイトの arcgisworkspace ディレクトリに解凍します。
```
 PostInstallUtility.bat -x
```

ArcGIS Web Adaptor インスタンスの置換

サイトから ArcGIS Web Adaptor の以前のインスタンスを登録解除してアンインストールします。
1. ArcGIS Notebook Server Administrator Directory にサインインします。
2. [システム]、[Web Adaptors]、登録済みコンピューターの順に参照します。
3. [Unregister Web Adaptor] をクリックします。
ArcGIS Web Adaptor 10.9.1 の新しいインスタンスをインストールして ArcGIS Notebook Server に登録します。
配置のアップグレードが完了したら、10.9.1 の機能を利用できます。 10.8 またはそれ以前のバージョンからアップグレードする場合、ポータルでノートブックのスケジューリングを有効にするには以下を実行します。
- ノートブック権限を含むカスタムロールを更新して、必要に応じて新しい [ノートブックのスケジュール設定] 権限を追加します。
- スケジュール設定機能を使う場合は自分のノートブックのランタイムを更新するようノートブック作成者に指示します。スケジュール設定ができるのは 10.8.1 ランタイム (バージョン 4.0) 以降を使っているノートブックだけです。

これで ArcGIS Notebook Server 10.9.1 サイトで ArcGIS Notebooks をホストする準備が整いました。

このトピックへのフィードバック

アップグレードの準備

デプロイメントのバックアップ

レガシー:

セットアップ プログラムを使用したアップグレード

注意:

コマンド ラインからのアップグレード