ArcGIS Enterprise バックアップの作成—Portal for ArcGIS

ArcGIS Enterprise 配置のコンポーネントをバックアップファイルにエクスポートして、後でハードウェアの故障やデータの損失が発生した場合に配置の復旧に使用できます。このファイルには、ポータルのアイテムと設定、ホストされている Web レイヤー、フェデレーション/ホスティングサーバー設定、および ArcGIS Data Store の使用時は、ホストフィーチャレイヤーデータとホストシーンレイヤーキャッシュが格納されます。バックアップファイルのサイズと作成にかかる時間は、ポータル内にあるアイテムの数、存在するホスト Web レイヤーの数とタイプ、存在するフェデレーションサーバーの数、およびホスティングサーバーとフェデレーションサーバーに属する ArcGIS Server コンピューターの数によって異なります。データもサービスも含まれていない配置のバックアップ時に生成されるファイルのサイズはおよそ 400 MB です。作成されるファイルは常にこれより大きいサイズになります。

ArcGIS Enterprise のバックアップを作成するには、エクスポート操作とプロパティファイルを指定した webgisdr ユーティリティを使用します。このユーティリティは、Portal for ArcGIS ツールディレクトリにあります。このユーティリティを使用するには、次の条件が満たされている必要があります。

指定した共有ディレクトリには、エクスポートファイルを格納するのに十分な容量が必要です。ArcGIS Enterprise 配置のエクスポートテストを実行して、ファイルがどのくらいの大きさになるか把握した後、共有ディレクトリに維持する予定のファイル数を決定し、それに従ってディレクトリのサイズを指定します。
ArcGIS Enterprise の各ソフトウェアコンポーネントをインストールするのに使用されたアカウントは共有ディレクトリに対する読み取り/書き込み権限を備えている必要があります。
各コンポーネントのバックアップは、各コンポーネントのコンピューター上にある一時ディレクトリに配置された後、指定した共有ディレクトリに移されるため、次のディレクトリには、各コンポーネントのバックアップを格納するのに十分な容量が必要です。
- Portal for ArcGIS: <Portal_content_directory>/temp
- ArcGIS Server: /<ArcGIS_Server_installation_directory>/temp
- ArcGIS Data Store: <ArcGIS_Data_Store_directory>/temp
ArcGIS Enterprise の配置内にある ArcGIS Data Store リレーショナルデータストアは、特定時点への復元を有効にする必要があります。

次の手順に従って、ArcGIS Enterprise の配置のバックアップを作成します。

テンプレートの properties ファイルのコピーを作成します。コピーは、テンプレートと同じディレクトリまたは新しいディレクトリに保存できます。
テンプレートプロパティファイルである webgisdr.properties はデフォルトで /arcgis/portal/tools/webgisdr にインストールされます。
この例では、ファイルのコピーは、mywebgis.properties という名前で /home/ags/arcgis/portal/propfiles に保存されます。
プロパティファイルのコピーを開き、サイトに固有の情報を含むようにそのファイルを編集します。
- SHARED_LOCATION = <バックアップファイルの場所>
  ArcGIS Server、Portal for ArcGIS、および ArcGIS Data Store のバックアップファイルの一時コピーが作成される共有場所を指定します。ArcGIS Server、Portal for ArcGIS、ArcGIS Data Store をインストールしたアカウントと、webgisdr ユーティリティを実行するアカウントには、この場所への読み取り権限と書き込み権限が必要です。この場所がバックアップファイルを保持するのに十分な大きさであることを確認します。ファイルは、圧縮されるとはいえ、存在するデータの量とタイプによっては非常に大きなサイズになることがあります。ホストシーンレイヤーおよびキャッシュが存在し、INCLUDE_SCENE_TILE_CACHES を true に設定している場合は特に、ArcGIS Data Store のバックアップファイルのサイズが大きくなる可能性があります。
  レガシー:
  Portal for ArcGIS 10.4 では、このプロパティは SHARED_FOLDER という名前でした。
- BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3}
  このプロパティは 10.5.1 の新機能です。ArcGIS Enterprise のバックアップをオンプレミスのファイル共有場所に格納する場合は、FileSystem を指定します。webgisdr ユーティリティを実行すると、BACKUP_LOCATION に指定したファイル共有にバックアップファイルが格納されます。
  ArcGIS Enterprise のバックアップを Amazon Simple Storage Service (S3) バケットに格納する場合は、webgisdr ユーティリティで生成されたバックアップファイルを格納するための専用の S3 バケットを作成し、そのバケットへのアクセスに必要な情報を S3 プロパティに反映します。
- BACKUP_LOCATION = <オンプレミスのバックアップファイルの場所>
  このプロパティは 10.5.1 の新機能です。BACKUP_STORE_PROVIDER = FileSystem に設定した場合、バックアップファイルは最初に SHARED_LOCATION に格納されますが、その後で BACKUP_LOCATION にコピーされます。この場所がバックアップファイルを保持するのに十分な大きさであることを確認します。ファイルは、圧縮されるとはいえ、存在するデータの量とタイプによっては非常に大きなサイズになることがあります。webgisdr ユーティリティを実行するアカウントには、BACKUP_LOCATION に対する読み取り権限と書き込み権限が必要です。
- PORTAL_ADMIN_URL = <ポータルの管理ディレクトリの URL>
  Portal for ArcGIS 管理ディレクトリの URL を指定します。形式 https://portalhostname.domain.com:7443/arcgis を使用します。ここで、portalhostname.domain.com は、Portal for ArcGIS がインストールされているコンピューターの完全修飾名です。
- PORTAL_ADMIN_USERNAME = <ポータル管理者のユーザー名>
  Esri 定義の管理者ロールに割り当てられるポータルメンバーのユーザー名を指定します。
- PORTAL_ADMIN_PASSWORD = <ポータル管理者のパスワード>
  ポータル管理者アカウントのパスワードを指定します。
- PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>
  初めてファイルに管理者パスワードを設定するときは、このオプションを false に設定します。ファイルを保存すると、パスワードが暗号化され、PORTAL_ADMIN_PASSWORD_ENCRYPTED の値が true に設定されて、パスワードが暗号化済みであることが示されます。パスワードを今後変更する必要がある場合は、PORTAL_ADMIN_PASSWORD_ENCRYPTED = false に設定し、新しい管理者パスワードを指定して、ファイルを保存します。
- INCLUDE_SCENE_TILE_CACHES = <true | false>
  ホストシーンレイヤーをポータルに公開して、シーンキャッシュデータをバックアップに含める場合は、INCLUDE_SCENE_TILE_CACHES を true に設定します。true に設定した場合は、最後のバックアップ以降に作成された新しいキャッシュデータだけではなく、すべてのシーンキャッシュデータがバックアップに含まれる点に注意してください。最後のバックアップ以降に新しいシーンキャッシュが作成されていないことがわかっている場合や、シーンをポータルに公開しない場合は、INCLUDE_SCENE_TILE_CACHES を false に設定できます。
- BACKUP_RESTORE_MODE = <full | incremental>
  完全バックアップのみを作成する場合、このプロパティを full に設定できます。一方で、バックアップのサイズを減らすために、2 つの異なるプロパティファイルを作成することができます。1 つは完全バックアップを作成するときに使用する BACKUP_RESTORE_MODE = full で、もう 1 つは完全バックアップ間の増分バックアップを作成する BACKUP_RESTORE_MODE = incremental です。各増分バックアップには、最後の完全バックアップ以降のすべての変更が含まれています。
  プロパティファイルで BACKUP_RESTORE_MODE を設定しないと、デフォルトで full バックアップが作成されます。
- ArcGIS Enterprise 配置が AWS で実行されており、ポータルのコンテンツディレクトリが Amazon S3 に格納されている場合は、コンテンツディレクトリのバックアップバケットが必要です。S3 にバックアップバケットを作成し、プロパティファイルで PORTAL_BACKUP_S3_BUCKET をバケットの名前に設定し、PORTAL_BACKUP_S3_REGION を S3 バケットを作成した AWS 領域に設定します。この実装の詳細については、ArcGIS Enterprise ヘルプの「AWS ストレージサービスでの可用性の高い ArcGIS Enterprise on Amazon Web Services の構成」をご参照ください。
  レガシー:
  ArcGIS Enterprise 10.5.1 より前は、PORTAL_BACKUP_S3_BUCKET プロパティは BACKUP_BUCKET_NAME でした。
- 10.5.1 ArcGIS Enterprise Cloud Builder for Microsoft Azure 以降は、ポータルのコンテンツディレクトリを Azure Blob Storage コンテナーに格納できます。webgisdr ユーティリティを使用してこの配置のバックアップを作成するには、次のプロパティを設定する必要があります (10.5.1 の新機能)。
  - PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Azure Storage アカウント>
    PORTAL_BACKUP_BLOB_ACCOUNT_NAME を Azure Blob Storage アカウント名に設定します。
    ヒント:
    この Storage アカウント名は、Cloud Builder の [配置オプション] パネルで [構成およびコンテンツストアに Azure Cloud Storage を使用] を選択した場合に指定しました。
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <アカウントキー>
    PORTAL_BACKUP_BLOB_ACCOUNT_KEY を Azure Blob Storage アカウントに関連付けられているアカウントキーに設定します。
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
    PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED の値を最初に追加するとき、false を PORTAL_BACKUP_BLOB_ACCOUNT_KEY に設定します。webgisdr.properties ファイルを保存するとき、キーは暗号化され、ツールによって PORTAL_BACKUP_BLOB_ACCOUNT_KEY が true に設定されます。
  - PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <Blob Storage アカウントエンドポイント>
    Blob サービスの Storage アカウントエンドポイントを指定します。
  - PORTAL_BACKUP_BLOB_ENDPOINT_URL = <Blob サービスの URL>
    Blob サービスエンドポイントの URL を指定します。この URL の形式は https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name> です。
- BACKUP_STORE_PROVIDER を AmazonS3 に設定する場合は、次のプロパティ (10.5.1 の新機能) の情報を指定します。
  - S3_ACCESSKEY= <AWS アカウントのアクセスキー>
    この設定は、S3_CREDENTIAL_TYPE = accessKeys に設定した場合にのみ必要となります。このアクセスキーで表される IAM ユーザーには、S3_BUCKET プロパティで指定した S3 バケットに対する読み取り権限と書き込み権限が必要です。
  - S3_SECRETKEY= <AWS アカウントの秘密鍵>
    AWS アカウントのアクセスキーに関連付けられた秘密鍵を指定します。これは、S3_CREDENTIAL_TYPE を accessKeys に設定した場合にのみ使用します。
  - S3_ENCRYPTED = false
    この設定を false のままにします。S3_CREDENTIAL_TYPE が accessKeys に設定されている場合に、webgisdr ユーティリティを実行すると、アクセスキーと秘密鍵が暗号化され、S3_ENCRYPTED が暗号化済みのアクセスキー値に設定されます。
  - S3_BUCKET= <S3 バケットの名前>
    ArcGIS Enterprise バックアップファイルを格納する Amazon S3 バケットの名前です。
  - S3_CREDENTIAL_TYPE= <IAMRole | accessKeys
    AWS IAM ロールを使用して S3_CREDENTIAL_TYPE にアクセスする場合は、IAMRole を S3_BUCKET に設定します。AWS IAM ユーザーとしてアクセスキーを介して accessKeys にアクセスする場合は、S3_BUCKET に設定します。IAM ロールまたはユーザーには、S3_BUCKET プロパティで指定した S3 バケットに対する読み取り権限と書き込み権限が必要です。
  - S3_REGION= <S3 バケットを作成した AWS 領域>
  - S3_BACKUP_NAME = <バックアップファイルの名前>
    このプロパティは、ArcGIS Enterprise 配置を復元する場合にのみ使用します。復元するバックアップファイルの名前を指定します。バックアップファイルの名前を指定しないと、最新のバックアップファイルが復元されます。
この例では、URL が https://portalhostname.domain.com:7443/arcgis のポータル、そのポータルのホスティングサーバーおよびフェデレーションサーバーのサービスと設定、ArcGIS Data Store リレーショナルデータストアに格納されたホストフィーチャレイヤーデータの完全バックアップが最初に \\\\myserver\\tempbackups 内のファイルに出力されます。これらのファイルは別々に圧縮されて 1 つのバックアップファイル (entbackup)) に格納された後、\\mybuserver\\wgbackups にコピーされます。INCLUDE_SCENE_TILE_CACHES が false に設定されているため、ArcGIS Data Store タイルキャッシュデータストアのシーンレイヤーキャッシュは含まれません。
```
BACKUP_STORE_PROVIDER = FileSystem
SHARED_LOCATION = \\\\myserver\\tempbackups
BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup
PORTAL_ADMIN_URL = https://portalhostname.domain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = admin
PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
INCLUDE_SCENE_TILE_CACHES = false
BACKUP_RESTORE_MODE = full
```
この例では、URL が https://portalonaws.mydomain.com:7443/gis のポータル、そのポータルのコンテンツディレクトリ (S3 バケット portalcontent に格納されている)、そのポータルのホスティングサーバーおよびフェデレーションサーバーのサービスと設定、リレーショナルデータストアおよびタイルキャッシュデータストアに格納されたデータの完全バックアップが AWS 領域 eu-west-1 内の S3 バケット entbackups に出力されます。バックアップファイルの名前は fullbackup06June です。IAM ロールは、AWS アカウントへのアクセスに使用されます。
```
BACKUP_STORE_PROVIDER = AmazonS3 SHARED_LOCATION = \\\\myserver\\tempbackups BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackupfile PORTAL_ADMIN_URL = https://portalhostname.mydomain.com:7443/arcgis PORTAL_ADMIN_USERNAME = entadmin PORTAL_ADMIN_PASSWORD = p0rtl.a.p PORTAL_ADMIN_PASSWORD_ENCRYPTED = false INCLUDE_SCENE_TILE_CACHES = true BACKUP_RESTORE_MODE = full PORTAL_BACKUP_S3_BUCKET = portalcontent S3_BUCKET = entbackups S3_CREDENTIAL_TYPE = IAMRole S3_REGION = eu-west-1
S3_BACKUP_NAME = fullbackup06June
```
プロパティファイルを保存します。
このファイルを指定して webgisdr ユーティリティを実行すると、ファイル内で PORTAL_ADMIN_PASSWORD の値が暗号化され、PORTAL_ADMIN_PASSWORD_ENCRYPTED が true に設定されます。
Portal for ArcGIS コンピューター上でコマンドシェルを開き、webgisdr ユーティリティの格納場所にディレクトリを変更し、エクスポートオプションを指定して webgisdr ユーティリティを実行します。
webgisdr ユーティリティは <Portal for ArcGIS installation directory>/tools/webgisdr にインストールされます。
webgisdr の構文は、次のとおりです。
```
webgisdr --{export | import} --file <location and name of properties file>
```
上述のように、プロパティファイル (mywebgis.properties) は、ユーザーが作成したディレクトリ /home/ags/arcgis/portal/propfiles に保存されました。
```
webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties
```
バックアップファイルは、プロパティファイルの SHARED_LOCATION に指定された場所に作成されます。ファイル名は <timestamp>.webgissite です。
ArcGIS Enterprise 配置にマップサービスまたはホストタイルレイヤーのキャッシュが含まれている場合、キャッシュタイルが格納されているすべてのディレクトリ (たとえば、arcgiscache または C:\arcgisserver\directories\ の下の <ArcGIS Server installation directory>/arcgis/server/usr/directories ディレクトリ全体) のコピーを手動でバックアップします。
これらのディレクトリには、マップキャッシュタイルおよびタイルスキーマファイル conf.xml が含まれます。キャッシュディレクトリには、構築済みのタイルに関する情報を含む、ファイルジオデータベースの status.gdb も格納できます。

このファイルを使用して、ArcGIS Enterprise を復元できます。

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

レガシー:

レガシー:

ヒント: