ArcGIS Enterprise ポータルのアップグレード—ArcGIS Enterprise

Portal for ArcGIS 10.6.1 セットアップは、Portal for ArcGIS の既存のインストールを検出してアップグレードするように設計されています。

Portal for ArcGIS のアップグレードの準備

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

10.5.1 またはそれ以前のバージョンから 10.6.1 にアップグレードしている場合は、10.6.1 の新しい認証ファイルを使用してソフトウェアを再認証する必要があります。My Esri で新たな認証ファイルにアクセスできます。10.6 からアップグレードしている場合、再認証は必要ありません。
Portal for ArcGIS 10.6.1 のセットアップを実行すると、ポータルは、自動的に 10.6.1 にアップグレードされます。以前にリリースされた Portal for ArcGIS の各バージョンを順に取得してインストールしたり、以前のバージョンをアンインストールしたりする必要はありません。
可用性の高いポータルを構成している場合、アップグレードを完了するには特定の手順に従う必要があります。これらの手順の概要については、「可用性の高いポータルの構成」をご参照ください。
注意:
10.6 では、可用性の高い配置のコンピューター間の通信に、ポート 5701、7005、7099、7654、7120、および 7220 が使用されます。これらのポート上でのローカル通信がファイアウォールによって許可されていて、これらのポートが別のアプリケーションによって現在使用されていないことを、確認する必要があります。
エンタープライズジオデータベースがホスティングサーバーの管理されたデータベースとして構成済みで 10.6.1 にアップグレードしている場合は、いくつか追加手順を実行する必要があります。サーバーのアップグレード後、エンタープライズジオデータベースを (管理されたデータベースではない) データベースとして登録する必要があります。次に、 ArcGIS Data Store をインストールしてリレーショナルデータストアとして登録します。これにより、ArcGIS Data Store はホスティングサーバーの管理対象データベースとして構成されます。
アップグレードが完了するまでの時間は、ポータルに含まれるコンテンツの量、登録されているアカウントの数、配置するコンポーネントとカスタマイズの数によって異なります。
テンプレートに基づいてアプリケーションを公開した場合は、そのテンプレートが廃止されているかどうかを確認してください。ポータルをアップグレードすると、廃止されたテンプレートは正常に動作しない場合や正しく表示されない場合があります。新しいアプリテンプレートを使用して、これらのアプリを再作成する必要があります。ポータルが数リリース前のものである場合、各リリースで廃止されたテンプレートを確認する必要がありますので注意してください。たとえば、Portal for ArcGIS 10.5 からアップグレードする場合、10.5 から現在のリリースまでのすべてのリリースで廃止されたテンプレートのリストを確認します。
Esri アプリがポータルで構成されている場合は、アップグレード前に 10.6.1 ポータルと互換性があるバージョンであることを確認する必要があります。
Insights for ArcGIS を構成済みである場合は、Insights for ArcGIS をアップグレードする前に ArcGIS Enterprise をアンインストールし、アップグレードの完了後に、互換性のあるバージョンの Insights for ArcGIS をインストールする必要があります。
ポータルで Navigator for ArcGIS モバイルマップパッケージを構成済みの場合は、ポータルを 10.6.1 にアップグレードした後で、それらを再構成する必要があります。

注意:

Portal for ArcGIS のセットアップでは、Windows サービスを実行するアカウントが要求されます。10.4 以降のバージョンからアップグレードする際、Windows サービスを実行しているアカウントに、これらの場所へのフルアクセスが付与されている場合は、共有ネットワークディレクトリ上の既存のコンテンツをアップグレードできます。

パスワードが適用されないローカルシステムアカウントで Windows サービスを現在実行している場合は、アップグレードを行う前に、パスワードが適用されるローカルアカウントに変更しておく必要があります。

ArcGIS Enterprise のアップグレードの順序

ArcGIS Enterprise ポータルが正しく機能するには、ホスティングサーバー、Web Adaptor、データストアと同じバージョンである必要があります。ArcGIS Enterprise の配置をアップグレードする場合に推奨される順序は次のとおりです。

Portal for ArcGIS のアップグレード
ArcGIS Web Adaptor (Portal 用) のアップグレード
ArcGIS Server のアップグレード (最初にホスティングサーバーをアップグレードし、次に他のサーバーをアップグレードします)
ArcGIS Web Adaptor (Server 用) のアップグレード
ArcGIS Data Store (最初にプライマリをアップグレードし、次にスタンバイをアップグレードします)

ArcGIS Enterprise のポータルのバージョンは、それとフェデレートされているホスティングサーバー、GeoAnalytics Server、GeoEvent Server、および Raster Analytics Server のバージョンと一致する必要があります。ただし、10.6 のポータルは、10.5 以降のバージョンのあらゆるフェデレーションサーバーと連携します。たとえば、10.5 の GIS Server (ホスティングサーバーではない) と 10.5.1 の Business Analyst Server は、そのホスティングサーバーのバージョンが 10.6 であれば、10.6 のポータルとフェデレートできます。
フェデレートされていない ArcGIS Server サイトのアイテムをポータルに登録している場合は、ポータルでサイトのサービスを使用するためにそのサーバーを 10.6.1 にアップグレードする必要はありません。以前のバージョンの ArcGIS Server から提供されているサービスは、Portal for ArcGIS 10.6.1 でも使用できます。
ポータルとフェデレートした ArcGIS Server サイトが複数のコンピューターで構成されている場合は、GIS サーバーを連続してアップグレードしてください。 ArcGIS Server サイトで ArcGIS Web Adaptor (単一または複数) が構成されている場合は、その ArcGIS Web Adaptor も、ArcGIS Server と同じバージョンに更新する必要があります。
現在の ArcGIS Web Adaptor を更新できない場合、同じコンピューターに旧バージョンと ArcGIS Web Adaptor (IIS) 10.6.1 をインストールできます。たとえば、バージョン 10.5 の ArcGIS Web Adaptor (IIS) を残したまま、同じ Web サーバーに 10.6.1 をインストールできます。アップグレードの際は、同じ ArcGIS Web Adaptor のコンテキストを維持する必要があります。これには、現在ポータルに構成されている ArcGIS Web Adaptor をアンインストールします。その後、以前使用していたのと同じ名前で 10.6.1 の ArcGIS Web Adaptor をインストールします。同じコンテキストを持つ 2 つの ArcGIS Web Adaptor を同一コンピューターにインストールすることはできません。

コンテンツのバックアップ

ArcGIS Data Store をポータルのホスティングサーバーと組み合わせて使用している場合は、アップグレードする前に、データストアの完全バックアップを作成しておく必要があります。

また、config.js で変更したプロパティなど、ポータルをカスタマイズした構成をバックアップする必要もあります。

レガシー:

これまでは、ポータルにインポートした証明書を含む証明書キーストア (portal.ks) をバックアップする必要がありました。これは 10.4.1 から必要なくなり、ポータルキーストアはアップグレード中に自動的に移行されるようになりました。

以前のバージョンのポータルを大幅にカスタマイズしている場合、別のコンピューターに 10.6.1 をインストールして、ポータルのアップグレードのプロトタイプを作成することをお勧めします。
Operations Dashboard または Web AppBuilder のエクステンションもバックアップする必要があります。これらのクライアント用に配置されたエクステンションはいずれも、アップグレード時に維持されません。アップグレードが完了したら、ユーザーがエクステンションを再配置する必要があります。
一方で、コンテンツ、サービス、サイト情報、およびセキュリティ設定は、アップグレード時にすべて自動的にバックアップされ、保存されます。ポータル Web サイトで編集した一般設定 (Web サイトへの組織サイトのロゴや名前の追加など) も、アップグレード時に維持されます。アップグレードの前にこれらの情報を手動でバックアップする必要はありません。
アップグレード中の自動バックアップに十分に対応できる空き容量があるかどうかを確認するには、ポータルの content、index、db、および temp ディレクトリに割り当てられた空き容量を調べます。ディスクの空き領域が、この量の少なくとも 2.5 倍であることを確認します。不足している場合は、ディスク上に 2.5 倍以上の領域を割り当てます。ポータルのアップグレードでは、ポータルのコンテンツ、サイト情報、およびセキュリティ情報を正常にバックアップしてアップグレードするために、この空き領域が必要です。これらのディレクトリのデフォルトの場所は C:\arcgisportal です。
アップグレードの完了時に、バックアップされた情報はディスクに保持されます。たとえば、この情報が含まれるディレクトリの末尾には、_10.<version number> が付加されます。この情報を別の場所に移動して、ディスク領域を節約することをお勧めします。
arcgisportal コンテンツディレクトリフォルダーをバックアップしておくこともお勧めします。アップグレードで問題が発生し、以前にインストールしたバージョンに戻す必要がある場合、このフォルダーを適用して、ポータルのコンテンツを復元できます。

ポータルの配置のアップグレード

注意:

ポータルの配置、ポータルとフェデレートしているすべての ArcGIS Server サイト、ArcGIS Data Store (使用している場合)、および ArcGIS Pro (使用している場合) は、アップグレード中にオフラインになります。

次の情報をバックアップします。
ヒント:
以下の手順に従ってサイトを手動でバックアップするか、webgisdr ユーティリティを使用して ArcGIS Enterprise の配置のバックアップを作成することができます。これを実行するには、手順に従ってエクスポートArcGIS Enterpriseします。
- ポータルで構成したすべてのカスタマイズ (config.js で変更したプロパティなど)。以前のバージョンのポータルを大幅にカスタマイズしている場合、別のコンピューターに 10.6.1 をインストールして、ポータルのアップグレードのプロトタイプを作成することをお勧めします。
- ArcGIS Data Store の管理されたデータベースです。バックアップの実行の詳細については、「ArcGIS Data Store のアップグレード」をご参照ください。
- Operations Dashboard または Web AppBuilder 用に配置したすべてのエクステンション。これらは、アップグレード時に維持されないため、アップグレードの完了後に再配置する必要があります。
- ArcGIS Server サイトをバックアップしておけば、以前のバージョンにサイトを戻す必要がある場合に、サイトをインポートして復元できます。
ポータルの content、index、db、および temp ディレクトリに割り当てられた空き容量を確認します。ディスクの空き領域が、この量の少なくとも 2.5 倍であることを確認します。不足している場合は、ディスク上に 2.5 倍以上の領域を割り当てます。ポータルのアップグレードでは、ポータルのコンテンツ、サイト情報、およびセキュリティ情報を正常にバックアップしてアップグレードするために、この空き領域が必要です。これらのディレクトリのデフォルトの場所は C:\arcgisportal です。コンテンツディレクトリが別のコンピューターにある場合も、推奨事項は同じです。
注意:
アップグレードの完了時に、バックアップされた情報はディスクに保持されます。たとえば、upgrade-backup というフォルダーが新規に作成され、バックアップコンテンツを含むバージョン固有のフォルダーが格納されます。この情報を別の場所に移動して、ディスク領域を節約することをお勧めします。
ポータルで使用している ArcGIS Web Adaptor をホストしているコンピューターにログインし、ArcGIS Web Adaptor をアンインストールします。詳細な手順については、IIS、Java (Windows)、または Java (Linux) のアンインストールに関するトピックをご参照ください。ArcGIS Web Adaptor をアンインストールする前に、そのコンテキストを必ずメモしてください。
Portal for ArcGIS のセットアッププログラム (Setup.exe) を起動して、ようこそ画面と利用条件を確認します。準備が整ったら、[次へ] をクリックします。次のコマンドラインパラメーターを使用して、Portal for ArcGIS をサイレントにアップグレードすることもできます。
<path to Portal for ArcGIS setup download>\setup.exe /qb USER_NAME=admin PASSWORD=itsasecret
使用許諾契約書に目を通した上で内容に合意します。合意しない場合は、終了してください。インストールされる機能が表示されます。
[インストール] をクリックしてアップグレードを開始します。インストールプロセスを中断しないでください。
[完了] をクリックして、インストールウィザードを終了します。新しい認証ファイルでソフトウェアを認証する必要があります。ポータル Web サイトがブラウザーウィンドウに表示されます。
ブラウザーのキャッシュを cookie を含めて消去します。以前のバージョンの Web サイトのキャッシュに残っている情報により、アップグレードした Web サイトが正しく表示されず、ログインできない場合があります。アップグレードしたポータル Web サイトを表示するすべてのブラウザーで、キャッシュを (cookie を含めて) 消去することをお勧めします。
[ポータルのアップグレードの継続] ボタンをクリックします。アップグレードが起動し、ポータルのコンテンツ、サイト情報、およびセキュリティ設定のバックアップが作成されます。この手順は、完了するまでに数分かかります。
ArcGIS Portal Directory を開き、初期管理者アカウントでサインインします。URL の形式は、https://portal.domain.com:7443/arcgis/portaladmin です。
ディレクトリページに、コンピューターが完全にはアップグレードされていないという警告メッセージが表示されます。[アップグレード後] の操作をクリックします。

注意:

10.6 以降、upgradeportal コマンドラインユーティリティを使用して、アップグレード操作とアップグレード後の操作をサイレント実行することもできます。コマンドラインで、<Portal install directory>/tools/upgradeportal フォルダーに移動して、upgradeportal.bat -s を実行します。ヘルプが必要な場合は、-h または --help を使用してコマンドを実行します。

[System] > [Indexer] > [Reindex] の順にクリックします。
[Mode] ドロップダウンリストをクリックして、[Full] を選択します。
[Reindex] をクリックします。この手順で、ポータルのアップグレードが完了します。ポータルのユーザー数およびコンテンツのボリュームによって、インデックスの再構築が完了するまでにかかる時間は異なります。インデックスの再構築プロセスを中断しないでください。インデックスの状態を監視するには、新しいブラウザーウィンドウ (またはタブ) を開き、[System] > [Indexer] > [Get Index Status] に移動して、そのページを更新します。[store] と [index] のカウントが同じであれば、インデックスの再構築とアップグレードは完了しています。
ポータルで使用する ArcGIS Web Adaptor をインストールします。詳細な手順については、IIS、Java (Windows)、または Java (Linux) のインストールに関するトピックをご参照ください。以前のバージョンで使用した ArcGIS Web Adaptor のコンテキストを使用してください。
ポータルに ArcGIS Web Adaptor を構成します。詳細な手順については、IIS、Java (Windows)、または Java (Linux) の構成に関するトピックをご参照ください。
組織サイトの管理者として ArcGIS Web Adaptor の URL を使用してポータル Web サイトにサインインできることを確認します。URL の形式は、https://webadaptorhost.domain.com/webadaptorname/home です。
組織サイトの管理者としてサインインしている間に、ArcGIS Living Atlas of the World コンテンツをアップグレードします。[組織] > [サイト設定] > [ArcGIS Online] の順に選択します。[Living Atlas コンテンツの構成] セクション内にある [コンテンツのアップグレード] をクリックします。ポータルで [ArcGIS Online] コンテンツのアップグレードが終了するまで、[ArcGIS Online] ページを閉じないでください。[保存] をクリックして、[組織] ページに戻ります。Living Atlas コンテンツにアクセスするようにポータルが構成されていない場合、この手順は必要ありません。
ArcGIS Server サイトをポータルとフェデレートしていて、ArcGIS Server サイトで ArcGIS Web Adaptor を使用している場合は、ArcGIS Web Adaptor をホストしているコンピューターにログインして ArcGIS Web Adaptor をアンインストールします。ArcGIS Web Adaptor の名前を記録します。再インストールする際に、同じ名前を使用する必要があります。詳細な手順については、IIS、Java (Windows)、または Java (Linux) のアンインストールに関するトピックをご参照ください。
ArcGIS Server サイトをポータルとフェデレートしている場合は、各 ArcGIS Server サイトを 10.6.1 にアップグレードします。アンインストールおよび再インストールする必要ありません。各 ArcGIS Server サイトの GIS サーバーコンピューターごとに、セットアップを実行する必要があります。GIS サーバーを連続してアップグレードします。詳細な手順については、「以前のバージョンの ArcGIS Server のアップグレード」をご参照ください。
サーバーのアップグレードが完了したら、ArcGIS Server Services Directory のローカル URL にアクセスできることを確認します。URL の形式は、https://gisserver.domain.com:6443/arcgis/rest/services です。
以前に ArcGIS Web Adaptor と ArcGIS Server を使用していた場合は、ArcGIS Web Adaptor を再インストールします。以前のインストールで ArcGIS Web Adaptor に指定していたのと同じ名前を使用します。詳細な手順については、IIS、Java (Windows)、または Java (Linux) のインストールに関するトピックをご参照ください。
サーバーに ArcGIS Web Adaptor を構成します。詳細な手順については、IIS、Java (Windows)、または Java (Linux) の構成に関するトピックをご参照ください。以前に ArcGIS Web Adaptor を介した ArcGIS Server への管理アクセスを有効化していた場合、再度有効化してください。これは、ポータルと ArcGIS Server サイトをフェデレートする際、ArcGIS Web Adaptor の URL を管理 URL に使用していた場合に特に重要です。
ArcGIS Web Adaptor の URL を使用して ArcGIS Server Services Directory にアクセスできることを確認します。URL の形式は、https://webadaptorhost.domain.com/webadaptorname/rest/services です。
ポータルのホスティングサーバーが ArcGIS Data Store を使用している場合は、データストアのバックアップを作成し、ArcGIS Data Store をアップグレードして、ArcGIS Server で動作するようにデータストアを再構成します。具体的な手順については、「ArcGIS Data Store のアップグレード」をご参照ください。
ArcGIS Pro ライセンスを組織で構成している場合、必要に応じて、ArcGIS License Server Administrator をアップグレードします。ArcGIS License Server Administrator をアップグレードしている間、ArcGIS Pro ライセンスを持つメンバーは ArcGIS Pro にアクセスできなくなります。メンバーが現在 ArcGIS Pro にログインしている場合、プログラムは 24 時間使用できないことを示すメッセージが表示されます。メンバーは、この期間内に作業を完了または保存できます。ArcGIS License Server Administrator をアップグレードした後に、ArcGIS Pro ライセンスを再構成する必要はありません。
以前に構成したカスタマイズをポータルに復元します。ポータルのカスタマイズを 10.6.1 で復元するときに、以前のバージョンで変更したファイルを 10.6.1 のファイルに置き換えないようにしてください。置き換えると、10.6.1 の配置に悪影響を及ぼします。この場合、各ファイルを 10.6.1 で開き、以前のバージョンのカスタム動作を手動でもう一度追加する必要があります。
ヒント:
アップグレードされた ArcGIS Enterprise ポータルでのセキュリティのベストプラクティスとして、portalScan.py スクリプトを使用してチェックすることをお勧めします。

Portal for ArcGIS をアップグレードした後の注意事項

アップグレードを実行した後は、次の情報をよく確認してください。

アップグレードの後、ポータル Web サイトが正しく表示されない、エラーメッセージが表示される、もしくはログインできません。何が原因ですか？

ブラウザーのキャッシュを cookie を含めて消去します。一般的に、これらのエラーの原因は、ブラウザーにキャッシュされた以前のバージョンの Web サイトの情報が残っていることです。キャッシュを消去してもログインできない場合は、初期管理者アカウントまたはポータルの管理権限を持つアカウントを使用していることを確認してください。

アップグレードの後、ポータルにアイテム、グループ、およびユーザーが一部しか表示されません。どうすればよいでしょうか。

ソフトウェアをインストールして初期管理者アカウントを指定した後に、ポータルのインデックスを再構築する必要があります。この手順で、ポータルのアップグレードが完了します。初期状態ではインデックスの再構築が完了していないため、アイテム、グループ、およびユーザーの一部が表示されない場合があります。ポータルのユーザー数およびコンテンツのボリュームによって、インデックスの再構築が完了するまでにかかる時間は異なります。たとえば、Portal for ArcGIS を 8 コアのコンピューターで実行している小規模な組織 (数百のユーザーとコンテンツアイテム) の場合は、インデックスの再構築に 15 分程度かかります。一方、Portal for ArcGIS を 8 コアのコンピューターで実行している大規模な組織 (数万のユーザーとコンテンツアイテム) の場合は、インデックスの再構築に 3 時間以上かかります。

インデックスの再構築の状態は、次の手順で確認できます。[store] と [index] のカウントが同じであれば、インデックスの再構築とアップグレードは完了しています。

ArcGIS Portal Directory を開き、初期管理者アカウントでサインインします。URL の形式は、https://portal.domain.com:7443/arcgis/portaladmin です。
[System] > [Indexer] > [Index Status] の順にクリックします。
ページを更新して、最新の状態を確認します。

10.6.1 にアップグレードすると、ポータルから Living Atlas コンテンツにアクセスできなくなります。

アップグレード後にポータルから Living Atlas レイヤーにアクセスできない場合は、そのアイテムが今回のリリースで廃止された可能性があります。「Portal for ArcGIS の新機能」で、廃止されたアイテムの最新のリストを確認してください。

アップグレード後に、登録者のコンテンツまたはプレミアムコンテンツのアイテムが開かない場合は、Living Atlas コンテンツのアップグレード手順を完了しているかどうかを確認してください。

10.6.1 へのアップグレード後、すべてのメンバーがメンバーシップレベル 2 に属していることがわかりました。一部のメンバーをメンバーシップレベル 1 に更新できますか？

デフォルトでは、アップグレードされたすべてのメンバーはメンバーシップレベル 2 のロールに割り当てられます。ポータルの管理者は、メンバーが独自のコンテンツを保有しておらず、十分なメンバーシップを確認できた場合は、そのメンバーをメンバーシップレベル 1 のロールに更新できます。メンバーが独自のコンテンツを保有している場合、ポータル管理者はメンバーシップレベルを変更する前に、コンテンツを再度割り当てる必要があります。

ポータルに登録されたメンバーの数がそのポータルにライセンスされている最大数を超えたことを示す、ソフトウェア認証エラーが表示されました。どうすればこの問題を解決できますか？

Portal for ArcGIS 10.2.1 以降のバージョンで、ポータルの指定ユーザーライセンスモデルが適用されています。現在ライセンス提供されている数よりも多くのメンバーをポータルに追加することができなくなります。10.6.1 で、ポータルにライセンスされているメンバー数を超えた場合、管理権限を持つアカウントを使用してポータル Web サイトにアクセスしたときに、ソフトウェア認証エラーメッセージが表示されます。さらに、ユーザーは新しいアカウントを作成できなくなり、管理者権限を持たないメンバーは、そのポータルにサインインできなくなります。これらの問題の解決方法については、「指定ユーザーライセンスの適用」をご参照ください。

最初の管理者アカウントの作成中にエラーが発生しました。アップグレードを完了するにはどうすればよいですか？

初期管理者アカウントの作成中にこのエラーが発生した場合は、ポータルのログに記録されている情報が問題の解決に役立ちます。一般的に、このエラーは、アカウントの作成時にネットワーク接続が一時的に失われた場合に発生します。ログにアクセスするには、ログディレクトリを参照して、最新のログファイル (たとえば、C:\arcgisportal\logs\<machine name>\portal\portal-20141201.095803-8596-0.0.log) を開きます。必要な場合は、この情報を Esri Support と共有できます。

10.3.1 からアップグレードする際に、Survey123 for ArcGIS または Collector for ArcGIS がポータルに構成されている場合、アップグレードを継続するには Esri Support に連絡する必要があります。

以前の配置に戻す場合、以前のバージョンに戻す前にすべてのログファイルをコピーして、サポートインシデントのトラブルシューティングを容易にします。(ログにアクセスするには、ログディレクトリ (例: C:\arcgisportal\logs\) を参照します。

アップグレード後にユーティリティサービスに何かをする必要がありますか？

OfflinePackaging、RasterUtilities、または GeocodingTools ユーティリティサービスを使用している場合、アップグレード後にそれらを手動で更新する必要があります。

アップグレードが完了したら、ユーティリティサービスを所有するユーザーとして ArcGIS Server Manager にログインします。
[サービス] タブの [サービスの管理] セクションで、[ユーティリティ] フォルダーをクリックします。
[プロパティの共有] アイコンをクリックします。
表示されたダイアログボックスで [保存] をクリックします。ArcGIS Enterprise ポータルのサービスが更新されます。
管理者としてポータルにログインします。[コンテンツ] タブで、更新したサービスを見つけます。[共有] をクリックします。必要に応じて共有設定を更新してから、[OK] をクリックします。共有している各グループでサービスが更新されます。
該当するサービスごとに、これらの手順を繰り返します。

ArcGIS Online World ジオコードサービスを使用して、ポータルを構成しています。アップグレード後に再構成する必要がありますか？

バージョン 10.2.x からアップグレードした場合、ポータル内のプロキシアイテムを ArcGIS Online World ジオコードサービスに合わせて再作成する必要があります。その後、アイテムをポータルのジオコーダーとして構成します。10.3.1 以降、プロキシアイテムを ArcGIS Online World ジオコードサービスに合わせて更新する必要はありません。

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