ArcGIS Notebook Server (Linux コンテナー) のアップグレード

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

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

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

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

注意:

ノートブックがカスタム ランタイムを使用している場合、Windows ノートブック サーバーのカスタム ランタイムを再構築および再登録して、関連するノートブック アイテムのランタイム設定を更新する必要があります。

注意:

ノートブック ランタイムは ArcGIS Enterprise ライフ サイクルの後で廃止される予定です。 ノートブック ランタイムは、関連付けられている ArcGIS Enterprise のバージョンが廃止されるのと同時に廃止される予定です。 ノートブックは廃止されたランタイムを使用してはならず、サポートされているランタイムに更新する必要があります。

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

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

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

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

アップグレードの準備

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

• アップグレード前に、11.3 コンテナー イメージなど、My Esri にある必要なすべてのファイルにアクセスできます。
• ArcGIS Notebook Server を正しく機能させるために、バージョンをフェデレーションされているポータルのバージョンと一致させる必要があります。
• 現在ノートブック サーバーが読み取り専用モードである場合、アップグレード プロセスを開始する前にモードをオフにします。
• Docker をバージョン 23.0 以降にアップグレードします。
• 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 Notebook Server をアップグレードすることができます。 これらのアップグレード方法のいずれかを選択します。
• アップグレード前に ArcGIS Notebook Server コンピューターで使用しているすべての Web ブラウザーのキャッシュをクリアします。

ワークスペース ディレクトリの移動

このプロセスには、ワークスペース ディレクトリがノートブック サーバーのインストール ディレクトリにある Linux 上の単一コンピューターの ArcGIS Notebook Server デプロイメントが必要です。

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 ディレクトリに手動でコピーします。

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

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

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

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

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

1. ArcGIS Notebook Server Administrator Directory を開き、管理者権限を持つユーザーとしてサイン インします。

   URL は、通常 https://notebookserver.domain.com:11443/arcgis/admin です。

2. [site] > [Export Site] の順に参照します。
3. ファイルのエクスポート先となるコンピューター上の場所の絶対パスを入力します。

   サイトからこのディレクトリにアクセスできる必要があります。

4. [エクスポート] をクリックします。

   エクスポート操作が完了すると、ディレクトリからサーバー上のバックアップ ファイルの場所へのリンクが作成されます。

5. できるだけ早く、.agssite ファイル拡張子を持つファイルをダウンロードします。

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

注意:

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

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

ArcGIS Notebook Server は、ArcGIS Notebook Server コンポーネントの既存のインストールを検出してアップグレードするように設計されています。

セットアップ プログラムを使用してアップグレードするには、次の手順を実行します。

1. ArcGIS Notebook Server を抽出した場所から ./Setup を実行します。さらに、画面上の指示に従ってアップグレードを完了します。

   セットアップは、既存の 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 コマンド ライン ユーティリティを使用したサイトのアップグレード

   このユーティリティには、次の 2 つのパラメーターがあります。

   • -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 をコンピューターにインストールする必要があります。 次のコマンドを実行してコンピューターで Docker がアクティブになっているかを確認します: ./PostInstallUtility.sh -d
5. Docker Desktop がインストールされていない場合はインストールします。
6. Notebooks イメージのファイル パスを指定してインストールします。 イメージは .tar.gz 形式で圧縮しておく必要があります。 Advanced ライセンスと Docker Desktop がある場合は、コマンドを 2 回実行して、My Esri からダウンロードした Standard と Advanced の両方のコンテナー イメージをインストールします。

   注意:

   コンピューターに 75 GB 以上のディスク空き容量があることを確認します。

   次のコマンドを実行します: ./PostInstallUtility.sh -l <path of .tar.gz Docker image>

   注意:

   必ず両方のコンテナー イメージをインストールしてください。 Advanced ライセンスがある場合でも、ユーザーは Standard ランタイムを使用する必要がある場合があります。

注意:

古いイメージは自動では削除されません。 前のランタイム イメージを削除する前に、各ノートブックに関連付けられたランタイムを新しいバージョンに手動で更新する必要があります。

ArcGIS Notebook Server のサンプル データのインストールと構成

複数コンピューターの ArcGIS Notebook Server サイトを設定する場合は、Notebook Server をインストールしてサイトを作成した 1 台目のコンピューターにのみ、サンプル データをインストールして構成する必要があります。

ArcGIS Notebook Server サンプル データをインストールするには、次の手順に従います。

1. ArcGIS Notebook Server を実行するユーザーとしてコマンド シェルを開きます。 My Esri から ArcGIS Notebook Server のサンプル データ tar.gz ファイルをダウンロードしたディレクトリを参照します。
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 Administrator Directory にサイン インします。
   2. [System] > [Web Adaptors] > [<登録済みコンピューター>] の順に参照します。
   3. [Unregister Web Adaptor] をクリックします。
2. ArcGIS Web Adaptor 11.3 の新しいインスタンスをインストールして、ArcGIS Notebook Server を使用するように構成します。
デプロイメントのアップグレードが完了したら、11.3 の機能を利用できます。
3. 10.8 またはそれ以前のバージョンからアップグレードする場合、ポータルでノートブックのスケジューリングを有効にするには以下を実行します。
   1. 必要に応じて、ノートブック権限を含むカスタム ロールを更新して、新しい [ノートブックのスケジュール設定] 権限を追加します。
   2. スケジュール設定機能を使う場合は自分のノートブックのランタイムを更新するようノートブック作成者に指示します。

      スケジュール設定ができるのは 10.8.1 ランタイム (バージョン 4.0) 以降を使っているノートブックだけです。

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