ArcGIS Web Adaptor の構成

ArcGIS Web Adaptor をインストールした後は、サーバーサイトと ArcGIS Enterprise ポータルで動作するように構成する必要があります。これは、ArcGIS Web Adaptor とともにインストールされる構成用の Web ページまたはコマンドラインユーティリティーで行います。

構成ページを開くと、ArcGIS Web Adaptor の現在の状態が表示されます。これには、ArcGIS Web Adaptor が過去に構成されたことがあるかどうかが示されます。 ArcGIS Web Adaptor のプラットフォームのタイプとバージョン番号を表示するには、構成ページの情報をクリックします。

注意:

ArcGIS Enterprise 11.5 では、Web Adaptor 経由での ArcGIS Server サイトへの管理アクセスがデフォルトで有効になっており、無効化することはできません。インターネットに接続している ArcGIS Enterprise デプロイメントの場合、Web Adaptor ではなく、プロダクショングレードの Web アプリケーションファイアウォール (WAF) 対応のロードバランサーをフロントエンドとして使用することを検討してください。詳細については、「ArcGIS Enterprise 強化ガイド」をご参照ください。

ArcGIS Web Adaptor を ArcGIS Enterprise ポータルですでに構成していて、別の ArcGIS Web Adaptor を使用するようにポータルを更新する場合は、はじめに現在の ArcGIS Web Adaptor を登録解除する必要があります。この操作には、必ず ArcGIS Portal Directory を使用します。登録解除機能は、構成ページやポータル Web サイトでは利用できません。詳細は「Portal for ArcGIS からの ArcGIS Web Adaptor の登録解除」をご参照ください。

注意:

ポータルの ArcGIS Web Adaptor は新しい ArcGIS Web Adaptor を登録することによって変更できますが、これを行うと、ポータル内のユーザーコンテンツ (マップメモや他のアイテムなど) も影響を受ける場合があります。

注意:

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

サーバーサイトでの ArcGIS Web Adaptor の構成

以降のセクションでは、構成ページとコマンドラインユーティリティーから、ArcGIS Web Adaptor をサーバーサイトで構成する方法について説明します。

構成 Web ページからの構成

ソフトウェアとともにインストールされた構成用の Web ページからサーバーサイトで ArcGIS Web Adaptor を構成するには、次の手順に従います。

注意:

ArcGIS Mission Server、ArcGIS Notebook Server、および ArcGIS Video Server にはその他の注意事項があり、この時点で確認する必要があります。

Web ブラウザーで構成ページを開きます。

URL の形式は https://webadaptorhost.example.com/webadaptorname/webadaptor です。

注意:

ArcGIS Web Adaptor をインストールした Web サーバーがフォワードプロキシーを使用するように構成されている場合、ArcGIS Web Adaptor の登録時には無効にします。フォワードプロキシーを使用するように構成されていない場合は、Web Adaptor 構成ページにアクセスできません。
ArcGIS Web Adaptor と構成するサーバーのタイプを選択します。次へをクリックします。
サイトに登録しているいずれかのサーバーのコンピューター名を入力します。

このコンピューター名を使用して、サーバーサイトに属しているコンピューターをすべて検出し、それらを ArcGIS Web Adaptor に登録できます。コンピューター名の形式は server.example.com です。
サーバーサイトに対する管理権限を持つアカウントのユーザー名とパスワードを入力します。通常は、サイトを作成したときに定義したプライマリーサイト管理者のアカウントのユーザー名とパスワードを使用します。プライマリーサイト管理者のアカウントを無効にした場合は、サイトに対して管理アクセス権限を持つアカウントを指定する必要があります。
構成をクリックして、設定内容を ArcGIS Web Adaptor に適用します。

構成が完了すると、ArcGIS Web Adaptor が認識したコンピューターのリストが構成ページの下部に表示されます (緑色でハイライト表示されます)。いつでもこのページに戻って、認識されているコンピューターのリストを表示し、Web Adaptor の設定を調整することができます。

コマンドラインからの構成

C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools にあるコマンドラインユーティリティー (ConfigureWebAdaptor.exe) を使用して、ArcGIS Web Adaptor をサーバーサイトで構成できます。

使用できるパラメーターは次のとおりです:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password>

<ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools にあるコマンドラインユーティリティー (ConfigureWebAdaptor.bat) を使用して、ArcGIS Web Adaptor をサーバーサイトで構成できます。

使用できるパラメーターは次のとおりです:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

<ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools にあるコマンドラインユーティリティー (configurewebadaptor.sh) を使用して、ArcGIS Web Adaptor をサーバーサイトで構成できます。これは、ArcGIS Web Adaptor をホストするコンピューターが GUI (グラフィカルユーザーインターフェイス) を持たない場合に特に便利です。

使用できるパラメーターは次のとおりです:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

<Mode> - ArcGIS Web Adaptor と構成するコンポーネント。デフォルトでは、このパラメーターは server に設定され、ArcGIS Web Adaptor はサーバーサイトとともに使用するように構成されます。以下は、その他のコンポーネントの構成に使用できるパラメーターです。
- Portal for ArcGIS - portal
- ArcGIS Mission Server - mission
- Notebook Server - notebook
- Video Server - video
- ArcGIS Monitor - monitor
- ArcGIS Data Pipelines - datapipelines
<WebAdaptorURL> - コマンドラインから構成する Web Adaptor の URL。これは、Web ブラウザーから ArcGIS Web Adaptor の構成ページにアクセスする場合に使用する URL と同じです。 ArcGIS Web Adaptor がデフォルトポートの 80 以外でインストールされている場合、URL にポートを指定します。
<MachineName|URL> - サーバーサイト内にあるいずれかのコンピューターのコンピューター名 (例: server.example.com)。コンピューター名の代わりにサーバーコンピューターの URL を使用することもできます。 ArcGIS Server とともに使用するように ArcGIS Web Adaptor を構成している場合、サイトに属しているすべてのコンピューターを検出するために、コンピューター名または URL が使用されます。
<Username> - サーバーサイトに対する管理者権限を持つアカウントのユーザー名。 ArcGIS Server の場合、このアカウントは、サイトが最初に作成されたときに入力されたプライマリーサイト管理者のアカウント、または管理者権限を割り当てられているアカウントです。 ArcGIS Mission Server、Notebook Server、および Video Server の場合、サイトが作成されたときに使用されたプライマリーサイト管理者アカウントのユーザー名を入力します。
<Password> - サーバーサイトに対する管理者権限を持つアカウントのパスワード。

以下の例をご参照ください: ConfigureWebAdaptor.exe /m server /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g server.example.com /u siteadmin /p secret

以下の例をご参照ください: ConfigureWebAdaptor.bat -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

以下の例をご参照ください: $ ./configurewebadaptor.sh -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

注意:

コマンドラインユーティリティーを実行するには、ArcGIS Web Adaptor をホストするコンピューター上に JRE (Java Runtime Environment) が必要です。 JRE がコンピューター上に存在しない場合、ユーティリティーを実行するとエラーが発生します。コンピューター上に JRE をダウンロードおよびインストールする方法については、Java SE Downloads サイトをご参照ください。

ポータルでの ArcGIS Web Adaptor の構成

以降のセクションでは、構成ページとコマンドラインユーティリティーから、ArcGIS Web Adaptor を ArcGIS Enterprise ポータルで構成する方法について説明します。

構成 Web ページからの構成

ソフトウェアとともにインストールされた構成 Web ページからポータルで ArcGIS Web Adaptor を構成するには、次の手順を実行します。

注意:

ArcGIS Server サイトがポータルとフェデレートされた後に DNS エイリアスまたはリバースプロキシーを追加する方法については、「組織 URL の更新」をご参照ください。

Web サーバーで HTTPS が有効になっていない場合は、有効化します。
HTTPS URL (https://webadaptorhost.example.com/webadaptorname/webadaptor など) を使用して、構成ページを Web ブラウザーで開きます。 DNS エイリアスをポータルで使用する場合は、DNS エイリアスで Web Adaptor を構成する必要があります (https://<dnsalias.example.com>/<webadaptorname>/webadaptor などの URL を使用)。

注意:

ArcGIS Web Adaptor をインストールした Web サーバー上でフォワードプロキシーを実行している場合は、ArcGIS Web Adaptor を登録すると同時に、そのプロキシーを無効化します。フォワードプロキシーを使用するように構成されていない場合は、Web Adaptor 構成ページにアクセスできません。
Portal for ArcGIS を選択して次へをクリックします。
Portal for ArcGIS をホストしているコンピューターの名前を入力します。サーバーの完全修飾ドメイン名を含めます (例: portal.example.com)。
Portal for ArcGIS への管理権限を持つアカウントのユーザー名とパスワードを入力します。通常は、ポータルを設定したときに定義した初期管理者アカウントのユーザー名とパスワードを使用します。初期管理者アカウントを降格または削除した場合は、ポータル Web サイトに対して管理アクセス権限を持つアカウントを指定する必要があります。
設定をクリックします。

ArcGIS Web Adaptor が Portal for ArcGIS をホストしているコンピューターとともに使用できるように構成されます。これで、ポート 7443 の代わりに ArcGIS Web Adaptor の URL を使用してポータルにアクセスできます。 URL の形式は次のとおりです: https://webadaptorhost.example.com/webadaptorname/home。

すべての通信に HTTPS を使用するようにポータルを構成した場合、インストールされているポータル Web サイトとヘルプのショートカットの URL を更新して、http の代わりに https を使用できるようにする必要があります。更新しない場合、元のショートカットの URL にアクセスしようとすると、ブラウザーでエラーが発生します。

組織のリバースプロキシーサーバーを使用して Portal for ArcGIS を構成する場合、プロキシーサーバーに関する情報をポータルで指定する必要があります。詳細な手順については、「ポータルと、リバースプロキシーまたはロードバランサーの統合」をご参照ください。

コマンドラインからの構成

C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools にあるコマンドラインユーティリティー (ConfigureWebAdaptor.exe) を使用して、ArcGIS Web Adaptor をポータルで構成できます。

使用できるパラメーターは次のとおりです:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password> -r <ReindexPortal>

使用できるパラメーターは次のとおりです:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

<ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools にあるコマンドラインユーティリティー (configurewebadaptor.sh) を使用して、ArcGIS Web Adaptor をポータルで構成できます。これは、ArcGIS Web Adaptor をホストするコンピューターが GUI (グラフィカルユーザーインターフェイス) を持たない場合に特に便利です。

使用できるパラメーターは次のとおりです:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

<Mode> - ArcGIS Web Adaptor と構成するコンポーネント。デフォルトでは、このパラメーターは server に設定され、Web Adaptor は GIS Server、Image Server、GeoAnalytics Server とともに使用するように構成されます。 Portal for ArcGIS と組み合わせて使用するように Web Adaptor を構成しているので、このパラメーターを portal に設定します。
<WebAdaptorURL> - コマンドラインから構成する Web Adaptor の URL。これは、Web ブラウザーから ArcGIS Web Adaptor の構成ページにアクセスする場合に使用する URL と同じです。 Web Adaptor の HTTPS URL を指定する必要があります (例: https://webadaptorhost.example.com/webadaptorname/webadaptor)。 DNS エイリアスをポータルで使用する場合は、DNS エイリアスで Web Adaptor を構成する必要があります (https://<dnsalias.example.com>/<webadaptorname>/webadaptor などの URL を使用)。
<MachineName|URL> - Portal for ArcGIS をホストしているいずれかのコンピューターのコンピューター名。コンピューターの完全修飾ドメイン名を含めます (例: portal.example.com)。コンピューター名の代わりに Portal for ArcGIS をホストしているコンピューターの URL を使用することもできます。
<Username> - Portal for ArcGIS への管理権限を持つアカウントのユーザー名。このアカウントは、ポータルを最初に設定したときに入力された初期管理者アカウント、または管理者権限を割り当てられているアカウントです。
<Password> - Portal for ArcGIS への管理権限を持つアカウントのパスワード。
<ReindexPortal> - Web Adaptor を登録する際にポータル内のデフォルトコンテンツのインデックスを再構築するかどうかを指定します。このオプションは、配置にリバースプロキシーまたはロードバランサーを構成する場合に便利です。 Web Adaptor の登録は、インデックスを作成しなくても時間はかかりません。 webContextURL が構成されると、ビルトインコンテンツが webContextURL を参照するようになります。

例: ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g portal.example.com /u initialadmin /p secret -r true

例: ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

例: ConfigureWebAdaptor.sh -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

コマンドを実行すると、ArcGIS Web Adaptor が Portal for ArcGIS をホストしているコンピューターとともに使用できるように構成されます。これで、ポート 7443 の代わりに ArcGIS Web Adaptor の URL を使用してポータルにアクセスできます。 URL の形式は次のとおりです: https://webadaptorhost.example.com/webadaptorname/home。

組織のプロキシーサーバーを使用して Portal for ArcGIS を構成する場合、プロキシーサーバーに関する情報をポータルで指定する必要があります。詳細な手順については、「ポータルと、リバースプロキシーまたはロードバランサーの統合」をご参照ください。

複数の ArcGIS Web Adaptor の構成

Web 層認証を使用する可用性の高いポータルを構成する場合、複数の ArcGIS Web Adaptor が必要です。 Portal for ArcGIS で複数の ArcGIS Web Adaptor を構成するには、ポータルへのアクセスに 1 つのエンドポイントを使用する必要があります。この URL は WebContextURL プロパティで定義する必要があります。 URL を定義したら、次の手順に従ってポータルで複数の ArcGIS Web Adaptor を構成できます。

ポータルで最初の ArcGIS Web Adaptor を構成します。
リバースプロキシーサーバーに Portal for ArcGIS を追加します。次のように WebContextURL プロパティを設定します:
1. Web ブラウザーを開き、組織の管理者として Portal Administrator Directory にサインインします。
  
  URL の形式は、https://portal.example.com:7443/arcgis/portaladmin です。
2. System > Properties > Update Properties の順にクリックします。
  
  Portal for ArcGIS サービスが自動的に再起動します。続行する前に、再起動が完了するのをお待ちください。
3. Update System Properties ダイアログボックスに次の JSON を挿入し、ユーザーが組織のファイアウォールの外部から参照する際に使用するリバースプロキシサーバーまたは DNS エイリアス URL に置き換えてください。
```
   {
      "WebContextURL": "https://reverseproxy.example.com/myorg"
   }
```
1. Update Properties をクリックします。
追加の ArcGIS Web Adaptor を構成します。

ポータルで構成されたすべての ArcGIS Web Adaptor は、構成サマリーページにリスト表示されます。ユーザーは、リバースプロキシサーバーまたは DNS エイリアス URL を使用してポータルにアクセスします。

注意:

Portal for ArcGIS は 1 つの組織 URL のみをサポートしています。