Skip to main content

ArcGIS Notebook Server のサイレント インストール

コマンド ライン パラメーターを使用することで、インストール ウィザードを使用せずに ArcGIS Notebook Server のインストールと認証が実行できます。

ヒント:

選択するインストール モードによって、デフォルトのアンインストール モードが決定されます。 たとえば、コマンド ラインからサイレント インストールすると、デフォルトでコマンド ラインからのサイレント アンインストールに設定されます。

ArcGIS Notebook Server のインストールを始める前に、システム要件をご確認ください。

注意:

コマンド ライン パラメーターでは、大文字と小文字が区別されます。 インストールがうまくいかない場合は、大文字と小文字の使い方が下のコード例に示されている各プロパティと一致していることを確認してください。

ArcGIS Notebook Server のインストールの準備

インストールを始める前に、次の手順を実行します。

  1. My Esri にサイン インして必要なファイルを取得します。 以下が必要です。

    • ArcGIS Notebook Server ソフトウェアのダウンロード。

    • 認証ファイル。

    • いずれかまたは両方の Docker コンテナー イメージ (ライセンスによる) これらのコンテナー イメージには ArcGIS Notebooks の実行に必要なすべてのコンポーネントがあります。 詳細については、コンテナー エンジンおよび ArcGIS Notebook Server をご参照ください。

  2. ArcGIS Notebook Server をインストールする各コンピューターがシステム要件を満たしていることを確認します。

  3. ArcGIS Notebook Server で使用するポート 11443 で通信できるように、各コンピューターのファイアウォールを変更します。

インストール場所の指定

デフォルトでは、ArcGIS Notebook Server は C:\Program Files\ArcGIS\NotebookServer\ にインストールされます。

必要に応じて INSTALLDIR プロパティを使用して、ArcGIS Notebook Server のインストール場所をこのデフォルトの場所から変更します。 このコマンドを実行しないと、デフォルトのインストール場所が使用されます。

<setup directory>\setup.exe /qb INSTALLDIR=C:\NotebookServer ACCEPTEULA=yes

ユーザーが ArcGIS Notebook Server インストール ディレクトリーに対する完全な権限を持っていることを確認します。 ArcGIS Notebook Server のインストールに使用したユーザー アカウントが、ソフトウェアの実行に使用されるアカウントになります。

Windows アカウントの構成

ソフトウェアのサイレント インストールを実行する場合は、ArcGIS Notebook Server アカウントを構成する必要があります。 運用システムの場合は、ドメインまたは Active Directory に既存のアカウントを指定したうえで、組織のセキュリティー ポリシーに従うことを推奨します。

サイレント インストール中にコマンド ライン パラメーターで ArcGIS Notebook Server アカウントを構成しなかった場合は、アカウントがローカル システム アカウントに設定されます。

アカウントの構成には、以下のコマンド ライン パラメーターを使用します。

アカウント認証の直接的な引き渡し

注意:

サイレント (/qb) インストール中に ArcGIS Notebook Server アカウントを定義しなかった場合や認証情報が無効な場合は、インストール中にセットアップに警告メッセージが表示されます。 このメッセージは、OK をクリックすると閉じることができます。 この場合、ArcGIS Notebook Server アカウントはローカル システム アカウントに設定されます。

  • USER_NAME=<operating system account>

    このアカウントは、ドメイン アカウントでもローカル アカウントでもかまいません。 ドメイン アカウントを使用する場合は、既存のアカウントから選択する必要があります。 ローカル アカウントを使用するときに既存のローカル アカウントがない場合は、自動的に作成されます。 無効なアカウントである場合は、アカウントやパスワードが無効であることを示すメッセージ ボックスがインストール中に表示されます。

  • MSA=TRUE

    このパラメーターは Managed Service アカウントでのみ使用してください。 ドメイン上に、Managed Service アカウントが事前に存在する必要があります。 パスワードを含むローカル アカウントまたはドメイン アカウントでこのパラメーターを使用しないでください。 Managed Service アカウントは、PASSWORD パラメーターを使用しません。

  • PASSWORD=<account password>

    [USER_NAME] パラメーターに指定したアカウントのパスワードです。 無効なパスワードである場合は、アカウントやパスワードが無効であることを示すメッセージ ボックスがインストール中に表示されます。

次の例をご参照ください。

ドメイン アカウントの使用

<path to the ArcGIS Notebook Server setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=mydomain\mydomainaccount PASSWORD=my.password

新しいまたは既存のローカル アカウントの使用

<path to the ArcGIS Notebook Server setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password

Managed Service アカウントの使用

<path to the ArcGIS Notebook Server setup download>\setup.exe /qb ACCEPTEULA=yes MSA=TRUE USER_NAME=mydomain\mymsa

ファイルからのアカウントの認証情報のインポート

サーバー構成ファイルを使用して Windows アカウントの認証情報をインポートすることもできます。 ArcGIS Notebook Server のインストール中にサーバー構成ファイルをエクスポートし、今後のインストールで使用することができます。 認証情報を既存のサーバー構成ファイルからインポートするには、次の 2 つのパラメーターを設定します。

  • ACCOUNT - 認証情報をファイルからインポートする場合、このパラメーターを UseConfigFile に設定します (大文字小文字を正確に一致させます)。 このパラメーターで有効な値と見なされるのは、これだけです。

  • CONFIGPATH - 使用しているサーバー構成ファイルの絶対パスと名前を指定します。

    <setup directory>\setup.exe /qb ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\serverconfigs\standardaccount.xml ACCEPTEULA=yes

サーバー構成ファイルへの認証情報のエクスポート

現在の ArcGIS Notebook Server のインストールで使用されているアカウント認証情報をエクスポートして、今後のインストールで再使用することができます。 作成されるサーバー構成ファイルは、暗号化された .xml ファイルです。

サーバー構成ファイルをネットワーク共有に出力する場合、ArcGIS Notebook Server のインストール先コンピューター上のローカル システム アカウントは、そのネットワーク共有への書き込み権限を持っている必要があります。 たとえば、Turing というコンピューターに ArcGIS Notebook Server をインストールしている場合、Turing のローカル システム アカウントは、ネットワーク共有への書き込み権限を持っている必要があります。 権限が設定されていない場合、サーバー構成ファイルは正常に出力されません。

注意:

ネットワーク共有に対する権限の設定方法がわからない場合は、システム管理者に連絡するか、サーバー構成ファイルをローカルに出力して、それをネットワーク共有にコピーします。

次の 2 つのコマンド ライン パラメーターを使用して、ArcGIS Notebook Server アカウントの認証情報をサーバー構成ファイルにエクスポートします:

  • EXPORTCONFIG - このパラメーターを Yes に設定すると、USER_NAME パラメーターおよび PASSWORD パラメーターに設定したアカウント情報をサーバー構成ファイルにエクスポートします。 デフォルトでは、このパラメーターは「No」に設定されています。

  • CONFIGPATH - 作成するサーバー構成ファイルの絶対パスと名前を、ファイル拡張子 .xml を含めて指定します。 指定したフォルダーがすでに存在する必要があります。

  1. OS のユーザー アカウント (ArcGIS Notebook Server をインストールするアカウント) を docker という Unix グループに追加します。 このワークフローは Docker の Web サイトに記載されています。

    注意:

    root アカウントを使用した ArcGIS Notebook Server のインストールはサポートされていません。

コマンド ラインからの ArcGIS Notebook Server のサイレント インストール

コマンド ラインから ArcGIS Notebook Server のサイレント インストールを実行するには、次の手順に従います。

デフォルトでは、ArcGIS Notebook Server は ${HOME}/arcgis/notebookserver にインストールされます。

  1. ArcGIS Notebook Server を実行するユーザーとしてコマンド シェルを開きます。 My Esri から ArcGIS Notebook Server の tar.gz ファイルをダウンロードしたディレクトリーを参照します。

  2. 次のコマンドを使用して、tar.gz ファイルの圧縮を解除します。

    tar -xvzf ArcGIS_Notebook_Server_Linux_<version>.tar.gz

  3. ファイルの圧縮を解除したディレクトリーを参照して、<untar directory>/Documentation/EULA.pdf を参照します。 使用許諾契約書を読みます。

  4. このディレクトリーからサイレント セットアップを実行し、.prvc ファイルを使用して認証します。 構文は次のとおりです:

    <untar directory>/Setup -m silent -l yes -a <full path to .prvc file>

    コマンド ライン ツールのパラメーターは、次のとおりです。

    Parameter

    説明

    -m; --mode MODE

    (オプション) インストール モード: silent または GUI。 デフォルトは GUI です。

    -l; --license-agreement CHOICE

    サイレント モードの場合は必須であり、yes または no のいずれかを指定します。Yes は、Esri マスター契約 (E204、E300) を読み、同意したことを意味します。 いつでも使用許諾契約書を確認できます。

    -a; --authorization-file PATH_TO_FILE

    (オプション) Esri が提供する認証ファイルまたはプロビジョニング ファイルの絶対ファイル パス。

    このオプションを使用しない場合は、次のセクションで詳細に説明されているように、インストール後にソフトウェアを認証する必要があります。

    -d; --directory DIRECTORY

    (オプション) デフォルトでは、ArcGIS Notebook Server は $ ディレクトリーにインストールされます。 DIRECTORY には、別のインストール ディレクトリーを指定します。

    パス /arcgis/notebookserver/ はインストール ディレクトリーにアペンドされます。

    インストール ディレクトリー名は小文字でなければなりません。 インストールに付属のサンプルやデータのデータ パスは小文字でなければなりません。

    -v; --verbose

    (オプション) インストーラーを冗長モードで実行します。

    -h; --help

    コマンド ライン ヘルプを表示して、終了します。

    -e; --examples

    各オプションの使用例を表示し、終了します。

  5. systemd が ArcGIS Notebook Server 上でプロセスをブートストラップして管理することを許可するように、OS の権限を変更します。 この操作により、サービスはコンピューターの起動後すぐに開始されます。

    1. ターミナルで、ルート ユーザーに切り替えます。

    2. <ArcGIS Notebook Server install directory>/framework/etc/scripts/agsnotebook.service unit ファイルを /etc/systemd/system にコピーします。 この再配置されたファイルのファイル権限を 700 から 600 に変更します。

    3. ルート ユーザーのままで、次のコマンドを実行します。

    # systemctl enable agsnotebook.service

    1. systemd サービスを再起動してそのステータスを確認し、このサービスが適切に構成されていることを確認します。
       # systemctl stop agsnotebook.service
   # systemctl start agsnotebook.service
   # systemctl status agsnotebook.service

    1. root ユーザー セッションを終了します。

    2. オペレーティング システムを再起動し、ArcGIS Notebook Server が正しく起動することを確認します。

ソフトウェアのサイレント認証

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

認証ファイルがあってコンピューターがインターネットに接続している場合:

<ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /S /Ver <Version> /LIF <full path and name of authorization file>

インストール中にソフトウェアを認証しなかった場合、次の構文を使用してソフトウェア認証を実行し、ArcGIS Notebook Server のサイレント認証を実行します。 次のコマンドを実行して、認証用のすべてのオプションを表示します。

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

オフライン環境での認証

プロビジョニング (.prvc) ファイルを使用すると、オフライン環境でも ArcGIS Notebook Server を認証できます。 この処理中、処理の完了に必要なファイルが生成されて Esri に送信されます。

  1. ArcGIS Notebook Server のインストールが完了したら、プロンプトから以下に示したコマンドを実行します:

    <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

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

  2. 出力情報ファイルが作成されたら、次のいずれかを実行します。

    • Esri のセルフ サービス サイトを参照します。 画面上の指示に従って、認証情報ファイルをアップロードしてから、.ecp 認証ファイルをダウンロードします。

    • 認証情報ファイルを電子メールで authorize@esri.com に送信します。 Esri から .ecp 認証ファイルが返信されます。

  3. 上記のいずれかの方法を使用して .ecp 認証ファイルを取得したら、authorizeSoftware スクリプトをもう一度実行してファイルを処理し、サーバーの認証プロセスを完了します。

    <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .ecp file>

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

ArcGIS Notebook Server をインストールするコンピューターごとに、このワークフローを繰り返します。

すべてのソフトウェアのインストール後に、ArcGIS Notebook Server を構成してから、サーバー サイトを作成します。 createsite コマンド ライン ユーティリティーを使用してサイトを作成するオプションがあります。