configurebackuplocation

このユーティリティーはすべての ArcGIS Data Store タイプで使用されます。

configurebackuplocation ユーティリティーを使用すると、スケジュール設定されたバックアップと backupdatastore ユーティリティーで作成されたバックアップの両方に対して ArcGIS Data Store がバックアップ ファイルを書き込む場所を指定できます。 configurebackuplocation ユーティリティーを実行すると、バックアップ場所のプロパティを変更したり、バックアップ場所を削除したりすることもできます。

リレーショナル ストアは、デフォルトでローカルのバックアップ場所を使用して作成されます。 データの損失を防ぐために、change オプションを使用してリモート ファイル共有を登録することによって、デフォルト バックアップ場所を構成します。

時空間ビッグ データ ストア、グラフ ストア、オブジェクト ストアは、デフォルトのバックアップ場所を使用して作成されません。 バックアップの作成を始める前に、register オプションを渡して configurebackuplocation ユーティリティーを実行し、ファイル共有場所を指定する必要があります。指定できるのは、ネットワーク上の共有の場所、Amazon S3 (Simple Storage Service) バケット、Microsoft Azure Blob Storage コンテナーのいずれかです。

注意:

ローカル ドライブを、時空間ビッグ データ ストアのバックアップ ファイル用に使うことはできません。

backupdatastore ユーティリティーを使用して作成したバックアップを格納するための別のバックアップ場所を登録できます。 2 つ目のバックアップ場所には、共有のファイル ディレクトリー、S3 バケット、または Azure Blob Storage コンテナーを使用できます。

ArcGIS Data Store のバックアップの詳細については、「ArcGIS Data Store のバックアップの管理」をご参照ください。

構文

configurebackuplocation --store {relational | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]

必須オプション

configurebackuplocation ユーティリティーを実行する場合は、次のオプションを指定する必要があります。

• --store {relational | spatiotemporal | graph | object}

  バックアップ場所を構成またはクエリーする ArcGIS Data Store のタイプを指定します。 デフォルト値は relational です。

• --operation {change | register | unregister | list | setdefault}

  --operation オプションには、configurebackuplocaton ユーティリティーが実行するアクションを指定します。 デフォルト値は change です。

  --operation オプションで使用できる各引数の説明を次に示します:

オプション	説明
change	次のいずれかを変更する場合は、この引数を使用します。 スケジュール設定されたリレーショナル ストアのバックアップごとに別々の共有ファイル場所を指定します。 change 引数を使用して設定された場所は、常にリレーショナル ストアのデフォルトのバックアップ場所になります。 リレーショナル ストアのデフォルトのバックアップ場所を変更する場合は、--location オプションを指定する必要があります。 バックアップ場所の名前を変更します。 バックアップ場所の名前を変更する場合は、--location オプションと name 引数を指定する必要があります。 Azure または S3 で、バックアップ場所として設定した認証情報を更新します。 S3 の場合、過去に指定した情報を username または password オプションで変更できます。 Azure の場合は、password の値を変更できます。
register	バックアップ場所を登録する場合は、この引数を使用します。 register 引数を使用する場合は、--location オプションを指定する必要があります。 時空間ビッグ データ ストア、グラフ ストア、またはオブジェクト ストアに対して定義した最初のバックアップ場所が、デフォルトのバックアップ場所として設定されます。 時空間ビッグ データ ストア、オブジェクト ストア、またはグラフ ストアに対して別のバックアップ場所を登録した場合、2 つ目のバックアップ場所が登録されます。 リレーショナル ストアでは、register 引数で、2 つ目のバックアップ場所が常に登録されます。 2 つ目のバックアップ場所は、backupdatastore ユーティリティーで生成された手動バックアップを保存するために使用できます。
unregister	2 つ目のバックアップ場所をデータ ストアから削除する場合は、この引数を使用します。 登録されているバックアップ場所が 1 つしかない場合は、引数 unregister を使用して、時空間ビッグ データ ストア、オブジェクト ストア、またはグラフ ストアのバックアップ場所を完全に削除します。
list	--store オプションで指定したデータ ストアに登録されているバックアップ場所をすべて列挙します。 このリストには、物理的なバックアップ場所、バックアップ場所の名前、デフォルトとして登録されているバックアップ場所が表示されます。
setdefault	グラフ ストア、オブジェクト ストア、または時空間ビッグ データ ストアのバックアップ場所を複数構成している場合は、setdefault 引数を使用して、バックアップ場所のいずれかをデフォルトの場所として指定します。 これは定期バックアップの書き込み先であるほか、バックアップ場所を明示せずに、backupdatastore、listbackups、restoredatastore の各ユーティリティーを実行した場合にも、これがデフォルトの使用場所になります。

location オプション

--location オプションは次のシナリオで必要となります:

• バックアップ場所を登録する場合またはリレーショナル ストアのデフォルトの初期バックアップ場所を変更する場合には、バックアップの格納場所を指定します。

• 既存のバックアップ場所の名前を変更するには、name 引数と新しい名前の値を指定します。

  --location オプションは、デフォルトのバックアップ場所を設定する場合またはバックアップ場所を削除する場合に使用できます。また、バックアップ名を使用することもできます。

時空間ビッグ データ ストアの場合、またはリレーショナル ストアの 2 つ目のバックアップ場所を登録する場合には、--location オプションとともに次の引数をセミコロン (;) で区切って指定し、引数文字列全体を二重引用符 (") で囲んでください:

--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]"。

--location オプションでサポートされている各引数の説明を次に示します:

引数	説明
type=	この引数は必須です。 バックアップに使用する場所のタイプを定義します。 バックアップをファイル共有に格納する場合は、fs を指定します。 リレーショナル ストアの場合は、デフォルトのバックアップ場所をファイル共有にする必要があります。 バックアップを Amazon S3 バケットに格納する場合は、s3 を指定します。 バックアップを Azure Blob Storage コンテナーに格納する場合は、azure を指定します。
location=	この引数は必須です。 ファイル共有の場合、ファイル パスを指定します。 Amazon S3 バケットの場合は、バケット名とバケットへのパスを指定します。 Blob Storage コンテナーの場合はコンテナー名とコンテナーへのパスを指定します。 この引数を使用して、初期のデフォルトのリレーショナル ストア バックアップ場所を変更する場合、既存の登録済みバックアップ場所を指定できません。
name=	バックアップ場所に名前を割り当てることができます。 たとえば、バックアップ場所が \\sharedserver_sharedfolders_datastorebackups のようなファイル パスである場合は、この場所に dsbackupsfolder などの名前を指定することができます。 backupdatastore、listbackups、restoredatastore の各ユーティリティーを実行する場合は、場所のパスの代わりに、この名前を指定できます。 データ ストアのバックアップ場所を設定する際、名前を指定しなければ、ArcGIS Data Store がデフォルトの名前を割り当てます。
username=	type= 引数を azure または s3 に設定した場合、この引数は必須です。 S3 バケットの場合、AWS (Amazon Web Services) アカウントのアクセス キー ID を指定します。 Azure Blob Storage コンテナーの場合、Blob Storage コンテナーにアクセスできる Microsoft Azure ストレージ アカウントの名前を指定します。
password=	type= 引数を azure または s3 に設定した場合、この引数は必須です。 S3 バケットの場合、AWS アカウントのシークレット キーを指定します。 Azure Blob Storage コンテナーの場合、username 引数で指定した Azure アカウント用のキーを指定します。
endpointsuffix=	type= 引数を azure に設定した場合は、endpointsuffix 引数を使用して、Azure Blob Storage コンテナーの配置場所を示すことができます。 デフォルトでは、endpointsuffix は core.windows.net に想定されています。 コンテナーが Microsoft Azure Government クラウド環境に存在する場合、endpointsuffix=core.usgovcloudapi.net を設定します。 コンテナーがプライベート クラウドに存在する場合は、endpointsuffix を Azure プライベート クラウドのエンドポイントの接尾辞に設定します。
region=	type= 引数を s3 に設定した場合、この引数は必須です。 地域コードを指定する必要があります。 たとえば、バケットがアジア太平洋 (シドニー) 地域に配置されている場合、地域を ap-southeast-2 に設定します。 地域コードについては AWS のドキュメントをご参照ください。

その他のオプション

configurebackuplocation ユーティリティーと組み合わせて指定できる追加オプションを次に示します。

オプション	説明
--force	リレーショナル ストアでのみ使用されるオプションです。既存のデフォルトのバックアップ場所が使用できない場合でも、デフォルトのバックアップ場所を変更することができます。 有効な値は true または false です。 リレーショナル ストアのデフォルトのバックアップ場所を変更すると、ArcGIS Data Store は既存のバックアップ ファイルを古い場所から新しい場所にコピーします。 ArcGIS Data Store が古い場所にアクセスできない場合、ファイルをコピーできません。 過去のリリースでは、これは configurebackuplocation ツールが失敗する原因となっていました。 既存のバックアップ ファイルをコピーせずにデフォルトのバックアップ場所の変更を続行するには、--force true を指定します。 このオプションのデフォルト値は false です。つまり、ArcGIS Data Store が既存のデフォルト場所にアクセスできなければ、デフォルトのバックアップ場所を変更することはできません。
--prompt	有効な値は yes または no です。 このユーティリティーを実行するときに、指定したアクションを確認するプロンプトが表示されます。 このユーティリティーの使用を自動化する場合は、--prompt オプションを no に設定します。自動化しない場合は、プロンプトに答えるまでスクリプトが実行されません。

例

次のセクションでは、データ ストアのバックアップ場所の変更、設定、リスト表示について説明します。

リレーショナル ストアのデフォルトのバックアップ場所の変更

最初の例では、リレーショナル ストアのバックアップ保存場所が myshare というコンピューターの fsdata_bu というディレクトリーに設定されます。

./configurebackuplocation.sh --operation change --store relational --location "type=fs;location=/net/myshare/fsdata_bu"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

configurebackuplocation --operation change --store relational --location "type=fs;location=\\myshare\fsdata_bu"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

リレーショナル ストアのバックアップ場所の追加

この例では、同じリレーショナル ストア用として、Azure 上に第 2 のバックアップ場所を登録します。

./configurebackuplocation.sh --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

configurebackuplocation --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

グラフ ストアのバックアップ場所の設定

この例では、グラフ ストア用のネットワーク共有のバックアップ場所が登録されます。 バックアップ場所に fshare という名前を与えます。

./configurebackuplocation.sh --operation register --store graph --location "type=fs;location=/net/sharedmachine/g_bu;name=fshare" --prompt no

configurebackuplocation --operation register --store graph --location "type=fs;location=\\sharedmachine\g_bu;name=fshare" --prompt no

バックアップ場所の追加とデフォルトの場所の設定

この例では、時空間ビッグ データ ストア用として、第 2 のバックアップ場所を指定します。 追加のバックアップ場所は Azure ストレージにあります。

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

この例では、同じ時空間ビッグ データ ストア用として、AWS 上のヨーロッパ (スペイン) 地域に第 2 のバックアップ場所を指定します。 バックアップ場所に awsloc という名前を与えます。

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

この例では、バックアップ場所の名前 (awsloc) を使用して、S3 バケットを、時空間ビッグ データ ストア用のデフォルトのバックアップ場所として設定します。

./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

データ ストアのすべてのバックアップ場所のリストを取得

この例では、時空間ビッグ データ ストア用のバックアップ場所をすべて列挙します。

./configurebackuplocation.sh --operation list --store spatiotemporal

configurebackuplocation --operation list --store spatiotemporal

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       /net/sharedmachine/ge_bu     false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       \\sharedmachine\ge_bu        false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false