ArcGIS Web Adaptor のインストール

ArcGIS Web Adaptor は、付属のセットアップ プログラムを使用してインストールできます。このプログラムは、Setup.exe という名前のユーティリティーを介して実行することも、Windows インストーラーのコマンド ライン パラメーターを使用してサイレント インストールすることもできます。

ArcGIS Web Adaptor は、付属のセットアップ プログラムを使用してインストールできます。このプログラムは、Setup.exe という名前のユーティリティーを介して実行することも、Windows インストーラーのコマンド ライン パラメーターを使用してサイレント インストールすることもできます。

ArcGIS Web Adaptor は、付属のセットアップ プログラムを使用してインストールできます。このプログラムは、Setup.sh という名前のユーティリティーを介して実行することも、コマンド ライン パラメーターを使用してサイレント インストールすることもできます。

インストール要件

• ArcGIS Web Adaptor のバージョンは、サーバー サイトまたはポータルのバージョンと一致しなければなりません。

• ArcGIS Web Adaptor は他のバージョンと一緒にインストールできます。 新しいバージョンへアップグレードする場合を除き、ArcGIS Web Adaptor をアンインストールする必要はありません。

• それぞれの ArcGIS Web Adaptor の名前は、一意である必要があります。1 つの Web サーバー上に同じ名前を持つ 2 つの ArcGIS Web Adaptor をインストールすることはできません。 インストール中に名前の重複が検出された場合、警告メッセージが表示されます。 競合を解決するには、同じ名前の前のバージョンをアンインストールする必要があります。 あるいは、一方の ArcGIS Web Adaptor の名前を変更してインストールを続行できます。

• ブラウザーを通じて ArcGIS Web Adaptor をサーバー サイトまたはポータルで使用できるように構成する場合、ArcGIS Web Adaptor と Tomcat を同じコンピューター上にインストールする必要はありません。 しかし、configurewebadaptor.exe ツールを使用して ArcGIS Web Adaptor を構成する場合、ArcGIS Web Adaptor と Tomcat は同じコンピューター上にインストールする必要があります。

  注意:

  Tomcat または ArcGIS Web Adaptor インスタンスを配置するアプリケーション サーバーは、必ず管理者権限で起動します。 管理者権限で起動しなかった場合、ArcGIS Web Adaptor を ArcGIS Server に登録する操作は失敗します。

• ブラウザーを通じて ArcGIS Web Adaptor をサーバー サイトまたはポータルで使用できるように構成する場合、ArcGIS Web Adaptor と Tomcat を同じコンピューター上にインストールする必要はありません。 しかし、configurewebadaptor.sh ツールを使用して ArcGIS Web Adaptor を構成する場合、ArcGIS Web Adaptor と Tomcat は同じコンピューター上にインストールする必要があります。

  注意:

  Tomcat または ArcGIS Web Adaptor インスタンスを配置するアプリケーション サーバーは、必ず管理者権限で起動します。 管理者権限で起動しなかった場合、ArcGIS Web Adaptor を ArcGIS Server に登録する操作は失敗します。

• アプリケーション サーバー上に ArcGIS Web Adaptor をデプロイすると、ArcGIS Web Adaptor の構成がユーザーのホーム ディレクトリーに書き込まれます。 続行する前に、ユーザーにホーム ディレクトリーが割り当てられており、読み取りと書き込みの権限があることを確認してください。

ArcGIS Web Adaptor をインストールする前に

ArcGIS Web Adaptor をインストールする前に以下を実行します:

1. システムがすべてのシステム要件を満たしていることを確認します。 サーバー サイトまたはポータルで構成できる ArcGIS Web Adaptor は 1 つだけです。

2. IIS と必要なコンポーネントを有効にします。

   注意:

   ArcGIS Web Adaptor を正常にインストールおよび構成するには、次のステップで指定された前提条件を満たす前に、IIS と必要なコンポーネントを有効化する必要があります。

3. ArcGIS Web Adaptor をインストールするコンピューターで、以下の前提条件が満たされていることを確認します。

   • Microsoft Web Deploy 4.0

   • ASP.NET Core ランタイム - Windows ホスティング バンドル 10.x

   注意:

   .NET Runtime および IIS のサポートを含む、ASP.NET Core ランタイム - Windows ホスティング バンドルをインストールする必要があります。

   注意:

   ASP.NET Core ランタイム - Windows ホスティング バンドルをインストールしてから IIS と必要なコンポーネントを有効化した場合、バンドル インストーラーを使用してバンドル インストールを修復する必要があります。

4. ArcGIS Web Adaptor のインストール先とするコンピューターにサイン インします。

   注意:

   管理者権限を持つユーザーとしてサイン インする必要があります。

5. Web サイトがポート 80 で稼働しており、HTTPS がポート 443 で有効化されていることを確認します。 これは、ArcGIS Enterprise へのさまざまな暗号化された呼び出し、および暗号化されていない呼び出しに対応するためです。 Web サイトの作成方法については、IIS 製品ドキュメントをご参照ください。 HTTPS の設定と使用の詳細については、「Web サーバーで HTTPS を有効化」をご参照ください。

   注意:

   大多数のユーザーには、デフォルトの HTTPS ポート 443 を使用することが適切です。 まれに、組織特有の理由から、ArcGIS Web Adaptor インスタンスが Web サーバー上でポート 443 を使用できない場合があります。 組織がこれに該当する場合は、回避策を構成する追加手順の詳細について、「ポータルの ArcGIS Web Adaptor にデフォルト以外のポートを使用する」をご参照ください。

6. すべてのアプリケーションを閉じます。

7. ArcGIS Web Adaptor セットアップをダウンロードしたフォルダーに移動します。 適切なドライブに ArcGIS Server または Portal for ArcGIS のメディアを挿入して、自動的にセットアップを起動することもできます。

これで、ArcGIS Web Adaptor をインストールする準備が整いました。

注意:

URL に追加レベルを含めた ArcGIS Web Adaptor の構成はサポートされておらず、クライアント アプリケーションに問題が生じる原因になります。

1. システムがすべてのシステム要件を満たしていることを確認します。 サーバー サイトまたはポータルで構成できる ArcGIS Web Adaptor は 1 つだけです。

2. ArcGIS Web Adaptor のインストール先とするコンピューターにサイン インします。

   注意:

   管理者権限を持つユーザーとしてサイン インする必要があります。

3. Web サイトがポート 80 で稼働しており、HTTPS がポート 443 で有効化されていることを確認します。 これは、ArcGIS Enterprise へのさまざまな暗号化された呼び出し、および暗号化されていない呼び出しに対応するためです。 Web サイトの作成方法については、お使いの Java アプリケーション サーバー専用の製品ドキュメントをご参照ください。 HTTPS の設定と使用の詳細については、「Web サーバーで HTTPS を有効化」をご参照ください。

   注意:

   大多数のユーザーには、デフォルトの HTTPS ポート 443 を使用することが適切です。 まれに、組織特有の理由から、ArcGIS Web Adaptor インスタンスが Web サーバー上でポート 443 を使用できない場合があります。 組織がこれに該当する場合は、回避策を構成する追加手順の詳細について、「ポータルの ArcGIS Web Adaptor にデフォルト以外のポートを使用する」をご参照ください。

4. すべてのアプリケーションを閉じます。

5. ArcGIS Web Adaptor セットアップをダウンロードしたフォルダーに移動します。 適切なドライブに ArcGIS Server または Portal for ArcGIS のメディアを挿入して、自動的にセットアップを起動することもできます。

これで、ArcGIS Web Adaptor をインストールする準備が整いました。

1. システムがすべてのシステム要件を満たしていることを確認します。 サーバー サイトまたはポータルで構成できる ArcGIS Web Adaptor は 1 つだけです。

2. ArcGIS Web Adaptor のインストール先とするコンピューターにサイン インします。

   注意:

   管理者権限を持つユーザーとしてサイン インする必要があります。

3. Web サイトがポート 80 で稼働しており、HTTPS がポート 443 で有効化されていることを確認します。 これは、ArcGIS Enterprise へのさまざまな暗号化された呼び出し、および暗号化されていない呼び出しに対応するためです。 Web サイトの作成方法については、お使いの Java アプリケーション サーバー専用の製品ドキュメントをご参照ください。 HTTPS の設定と使用の詳細については、「Web サーバーで HTTPS を有効化」をご参照ください。

   注意:

   大多数のユーザーには、デフォルトの HTTPS ポート 443 を使用することが適切です。 まれに、組織特有の理由から、ArcGIS Web Adaptor インスタンスが Web サーバー上でポート 443 を使用できない場合があります。 組織がこれに該当する場合は、回避策を構成する追加手順の詳細について、「ポータルの ArcGIS Web Adaptor にデフォルト以外のポートを使用する」をご参照ください。

4. ArcGIS Web Adaptor セットアップをダウンロードしたフォルダーに移動します。 適切なドライブに ArcGIS Server または Portal for ArcGIS のメディアを挿入して、自動的にセットアップを起動することもできます。

これで、ArcGIS Web Adaptor をインストールする準備が整いました。

セットアップ プログラムを使用した ArcGIS Web Adaptor のインストール

セットアップ プログラムを使用して ArcGIS Web Adaptor をインストールするには、次の手順を実行します。

1. ArcGIS Web Adaptor セットアップ プログラムのダウンロードが終了すると、セットアップ プログラムが自動的に起動します。 セットアップが自動的に起動されなかった場合は、セットアップ ファイルのダウンロード先を参照し、Setup.exe をダブルクリックします。

2. マスター契約書を読み、同意する場合は容認してください。 次へ をクリックして、インストールを続けます。

3. ArcGIS Web Adaptor をポート 80 で稼働している Web サイトを選択してください。 使用可能な Web サイトは、<Web サイト名 (ポート)> という形式で表示されます。 Web サイトの選択 ダイアログ ボックスが表示されない場合は、1 つしか Web サイトが存在しないということです。 コンピューター上に 1 つしか Web サイトが見つからなかった場合、ArcGIS Web Adaptor は自動的にその Web サイト上に配置され、Web サイトの選択 ダイアログ ボックスは表示されません。

4. Web Adaptor の名前を入力します。 デフォルト値は arcgis です。 このインスタンス名にスペースは使用できません。

   注意:

   選択された Web サイトに ArcGIS Web Adaptor と同じ名前の仮想ディレクトリーがすでに存在する場合、メッセージが表示されます。 OK をクリックしてメッセージを閉じてから、ArcGIS Web Adaptor に別の名前を入力します。

5. 画面上の指示に従って、インストールを完了します。

注意:

ArcGIS Web Adaptor のインストールごとに、デフォルトの命名規則 ArcGISWebAdaptorAppPool<web adaptor name> でアプリケーション プールが作成されます。

1. ArcGIS Web Adaptor のインストール プログラムである Setup.exe を開始して、ようこそ画面と利用規約をお読みください。 準備が整ったら、次へ をクリックします。

2. マスター契約書を読み、同意する場合は容認してください。 次へ をクリックして、インストールを続けます。

3. 変更 をクリックしてインストール フォルダーを指定するか、次へ をクリックしてデフォルトの場所をそのまま使用します。

4. インストール をクリックしてインストールを開始します。

5. 完了 をクリックしてウィザードを終了します。

6. ArcGIS Web Adaptor のインストール フォルダーに移動します。 ポート 80 で稼働している Web サイト上の Java アプリケーション サーバーに arcgis.war ファイルを配置します。 .war ファイルを配置する方法については、Java アプリケーション サーバーのドキュメントをご参照ください。

7. また、複数の ArcGIS Web Adaptor をホスト コンピューターに配置する場合は、必要に応じて arcgis.war ファイルを再配置します。 複数の ArcGIS Web Adaptor を同じ Web サイト (ポート) に配置する場合は、名前を変える必要があるので注意してください。 たとえば、arcgis という 2 つの ArcGIS Web Adaptor は、同じ Web サイト上に存在できません。 複数の ArcGIS Web Adaptor を同じ名前にしたい場合は、異なる Web サイト (ポート) 上にインストールする必要があります。

8. ArcGIS Web Adaptor をサーバー サイトまたはポータルに接続します。

インストール後、Java アプリケーション サーバーで指定された言語で ArcGIS Web Adaptor が表示されます。 言語を変更するには、Java アプリケーション サーバーの製品ドキュメントをご参照ください。

1. ArcGIS Web Adaptor のインストール プログラムを開始して、はじめに ダイアログ ボックスに表示される内容を確認します。 準備が整ったら、次へ をクリックします。

2. マスター契約書を読み、同意する場合は容認してください。 次へ をクリックして、インストールを続けます。

3. 次へ をクリックしてデフォルトの場所を使用するか、選択 をクリックしてインストール フォルダーを指定します。

   注意:

   リモート ネットワーク ドライブに ArcGIS Web Adaptor をインストールすることはおすすめできません。 アンインストール時にリモート ドライブにアクセスできない場合、アンインストールが失敗し、ファイルが残る可能性があります。

4. インストール をクリックしてインストールを開始します。

5. インストールが完了したら、終了 をクリックしてウィザードを閉じます。

6. ArcGIS Web Adaptor のインストール フォルダーに移動します。 ポート 80 で稼働している Web サイト上の Java アプリケーション サーバーに arcgis.war ファイルを配置します。 .war ファイルを配置する方法については、Java アプリケーション サーバーのドキュメントをご参照ください。

7. また、複数の ArcGIS Web Adaptor をホスト コンピューターに配置する場合は、必要に応じて arcgis.war ファイルを再配置します。 複数の ArcGIS Web Adaptor を同じ Web サイト (ポート) に配置する場合は、名前を変える必要があるので注意してください。 たとえば、arcgis という 2 つの ArcGIS Web Adaptor は、同じ Web サイト上に存在できません。 複数の ArcGIS Web Adaptor を同じ名前にしたい場合は、異なる Web サイト (ポート) 上にインストールする必要があります。

8. ArcGIS Web Adaptor をサーバー サイトまたはポータルに接続します。

インストール後、Java アプリケーション サーバーで指定された言語で ArcGIS Web Adaptor が表示されます。 言語を変更するには、Java アプリケーション サーバーの製品ドキュメントをご参照ください。

同じ手順を繰り返して、同じコンピューターに複数の ArcGIS Web Adaptor インスタンスを同時にインストールするか、別々のコンピューターにインストールします。複数の ArcGIS Web Adaptor を同じ Web サイト (ポート) にインストールするには、別々の名前を使用する必要があります。 たとえば、arcgis という 2 つの ArcGIS Web Adaptor は、同じ Web サイト上に存在できません。 複数の ArcGIS Web Adaptor を同じ名前にしたい場合は、異なる Web サイト (ポート) 上にインストールする必要があります。

注意:

セットアップは、ArcGIS Web Adaptor の名前が競合していないかを検出して、競合を防ぎます。 仮想ディレクトリーがすでに存在するというメッセージが表示される場合は、ArcGIS Web Adaptor に別の名前を指定するか、別の Web サイトを選択します。

注意:

ArcGIS Web Adaptor サービス パックを適用するためにベース インスタンスを削除することはできません。

ArcGIS Web Adaptor のサイレント インストール

以下のコマンド ラインは、ArcGIS Web Adaptor をサイレント インストールするときに使用するパラメーターです。 サイレント インストール時に、これらのコマンド ライン パラメーターが呼び出されない場合、デフォルト名の arcgis を使用して、ArcGIS Web Adaptor Web アプリケーションがデフォルトの Web サイトに作成されます。

• ACCEPTEULA=yes

  このプロパティは、サイレント インストール時に EULA (エンド ユーザー使用許諾契約書) に同意するために必要です。 EULA に同意してソフトウェアをインストールするには、yes を指定します。 no を指定するか、このプロパティを省略すると、インストールが失敗します。 PDF バージョンのエンド ユーザー使用許諾契約書 (EULA) がダウンロードに含まれています。 EULA.pdf ファイルは \Documentation フォルダー内にあります。

• WEBSITE_ID=<Web サイトの数値>

  WEBSITE_ID パラメーターは、ArcGIS Web Adaptor Web アプリケーションが作成される Web サイトを指定するために使用されます。 WEBSITE_ID の値は、サーバー上の各 Web サイトに固有の数値で、IIS によって割り当てられます。 サーバー上の Web サイトの ID は、IIS Manager で見つけることができます。 デフォルトの Web サイトでは、Web サイト ID が 1 になります。 デフォルトでは、(複数の Web サイトが存在する場合でも) WEBSITE_ID パラメーターは [既定の Web サイト] の値に設定されます。 WEBSITE_ID パラメーターでは、大文字と小文字が区別されます。

• PORT=<ポート番号>

  また、複数のポートで 1 つの Web サイトを保有している場合、PORT パラメーターを使用して、WEBSITE_ID の指定されたポートにインストールします。

  たとえば、パスは <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640 PORT=82 です。

• VDIRNAME=<ArcGIS Web Adaptor の名前>

  このコマンド ライン パラメーターはオプションです。 デフォルトでは、VDIRNAME プロパティは arcgis に設定されます。 コマンド ラインで VDIRNAME パラメーターを呼び出さない場合、ArcGIS Web Adaptor が arcgis として作成されます。 VDIRNAME パラメーターでは、大文字と小文字が区別されます。 ArcGIS Web Adaptor の名前にスペースは使用できません。

  たとえば、パスは <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb ACCEPTEULA=yes VDIRNAME=arcgis_external WEBSITE_ID=4059640 です。

• CONFIGUREIIS=TRUE

  このオプションのパラメーターを使用すると、セットアップ プログラムは ArcGIS Web Adaptor で必要となるすべての不足している Microsoft IIS コンポーネントをサイレントで設定してインストールすることができます。

以下は、ArcGIS Web Adaptor をサイレント インストールするときに使用する Windows Installer のコマンド ライン パラメーターです。

• ACCEPTEULA=yes

  このプロパティは、サイレント インストール時に EULA (エンド ユーザー使用許諾契約書) に同意するために必要です。 EULA に同意してソフトウェアをインストールするには、yes を指定します。 no を指定するか、このプロパティを省略すると、インストールが失敗します。 PDF バージョンのエンド ユーザー使用許諾契約書 (EULA) がダウンロードに含まれています。 EULA.pdf ファイルは \Documentation フォルダー内にあります。

• INSTALLDIR=<インストール場所>

  このプロパティを使用することで、ArcGIS Web Adaptor のインストール先をコマンド ラインで指定できます。 このプロパティを設定しないと、デフォルトのインストール先である C:\Program Files\ArcGIS\WebAdaptor12.0\java\ が使用されます。

  例:

  <path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes INSTALLDIR="C:\NewInstallDir" /qb

• インストール先を指定せずに ArcGIS Web Adaptor をサイレント インストールするには、次のコマンドを使用します。

  <path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes /qb

ArcGIS Web Adaptor をインストールした後は、サーバー サイトまたはポータルで構成できます。

注意:

インストール後、Java アプリケーション サーバーで指定された言語で ArcGIS Web Adaptor が表示されます。 言語を変更するには、Java アプリケーション サーバーの製品ドキュメントをご参照ください。

ArcGIS Web Adaptor のサイレント インストールを実行するには、次の手順に従います:

1. インストールを開始する前に、<CD_ROOT or untar directory>/Documentation/EULA.pdf にあるマスター契約書を読んで、条件に同意します。

2. プロンプトが表示されたら、セットアップをサイレントで実行します。 構文の例:

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

使用法: セットアップ [オプション]

オプション	説明
-m; --mode MODE	オプション。 デフォルトは GUI です。 MODE は、silent または gui です。
-l; --license-agreement CHOICE	サイレント モードに必要です。 CHOICE は Yes または No です。Yes は、Esri マスター契約 (E204、E300) を読み、同意したことを意味します。 https://www.esri.com/legal/licensing-translations にアクセスして契約書をお読みください。
-d; --directory DIRECTORY	オプション。 デフォルトでは、ArcGIS Web Adaptor は $HOME ディレクトリーにインストールされます。 DIRECTORY には、別のインストール ディレクトリーを指定します。 パス /arcgis/webadaptor12.0/ はインストール ディレクトリーにアペンドされます。 インストール ディレクトリー名は小文字でなければなりません。 サンプルやデータのデータ パスは小文字でなければなりません。 リモート ネットワーク ドライブに ArcGIS Web Adaptor をインストールすることはおすすめできません。 アンインストール時にリモート ドライブにアクセスできない場合、アンインストールが失敗し、ファイルが残る可能性があります。
-v; --verbose	インストーラーは冗長モードで実行されます。
-h; --help	コマンド ライン ヘルプを表示して、終了します。
-e; --examples	これらのオプションの使用例を表示し、終了します。

1. ArcGIS Web Adaptor のインストール フォルダーを参照し、ポート 80 で稼働している Web サイト上の Java アプリケーション サーバーに適切な .war ファイルを配置します。 Apache Tomcat 10.1.x を使用している場合、arcgis_tomcat10.war ファイルをデプロイする必要があります。 Tomcat 9.0.x およびその他すべての Java アプリケーション サーバーの場合は、arcgis.war ファイルを配置する必要があります。 .war ファイルを配置する方法については、Java アプリケーション サーバーのドキュメントをご参照ください。

2. また、複数の ArcGIS Web Adaptor をホスト コンピューターに配置する場合は、必要に応じて .war ファイルを再配置します。 複数の Web Adaptor を同じ Web サイト (ポート) に配置している場合、名前を変える必要があるので注意してください。たとえば、arcgis という 2 つの Web Adaptor は、同じ Web サイト上に存在できません。 複数の ArcGIS Web Adaptor を同じ名前にしたい場合は、異なる Web サイト (ポート) 上にインストールする必要があります。

3. ArcGIS Web Adaptor をインストールした後は、サーバー サイトまたはポータルで構成できます。

インストール後、Java アプリケーション サーバーで指定された言語で ArcGIS Web Adaptor が表示されます。 言語を変更するには、Java アプリケーション サーバーの製品ドキュメントをご参照ください。

コマンド ライン パラメーターを使用してセットアップを実行すると、複数の ArcGIS Web Adaptor をインストールすることができます。 複数の ArcGIS Web Adaptor をインストールするのに、追加のコマンド ライン パラメーターは必要ありません。