管理ガイド> TDVコマンドラインユーティリティ> TDVエクスポートおよびインポートユーティリティ> バックアップインポートユーティリティの使用
 
バックアップインポートユーティリティの使用
バックアップインポートユーティリティは、バックアップインポートユーティリティのルールに従って、backup_exportユーティリティまたはStudioで作成されたアーカイブファイルのコンテンツ全体をインポートします。 backup importコマンドを実行するには、管理者権限と完全なサーバーエクスポートCARファイルが必要です。
バックアップインポートユーティリティには、次の制限があります。
-pkgfileターゲットファイルは、backup_exportユーティリティまたはサーバーの完全バックアップ用のStudio機能のいずれかを使用してエクスポートされたCARファイルである必要があります。
-verboseオプションを使用すると、インポート後に情報メッセージが表示されます。このオプションがないと、エラーメッセージのみが表示されます。
-setオプションを使用すると、データソース接続情報を元の情報から指定または変更できます。
[-set <path> <attribute> <value>]
このオプションは通常、CARファイルを運用サーバーにデプロイするときに使用されます。最も一般的に変更されるプロパティは、ホスト、ポート、データベース、ユーザー、およびパスワードです。
ユーザーはTDV_INSTALL/conf/serverディレクトリへの書き込みアクセス権を持っている必要があります
バックアップインポートユーティリティを使用するには
1. コマンドプロンプトウィンドウを開きます。
2. <TDV_install_dir>/binに移動します。
3. backup_importコマンドを実行します。
.backup_import -server <hostname> [ -port <port> ] [ -encrypt ]
-pkgfile <filename> -user <username> -password<password>
[-domain <domain> ]
[-sso ] [ -sspi ] [ -spn <spn> ] [ -krb5Conf <krb5Conf> ]
[-relocate <oldPath> <newPath> ] ...
[-optfile <filename>] [-optfilePassword <optpassword>]
[-newOptfilePassword <new optpassword>]
[-set <path> <type> <attribute> <value>] ...
[-encryptionPassword <encryptionPassword>]
[-reintrospect OR -reintrospectNone ]
[-createCacheTables ]
[-updateCacheTables ]
[-printinfo ]
[-overwrite ]
[-genopt <filename>] [-optfilePassword <optpassword>]
[-verbose ] [-ignoreEncryption ]
次の表で、backup_importパラメーターについて説明します。
バックアップインポートパラメータ
オプション/必須
コメントコメント
-サーバー<ホスト名>
必須
ユーティリティがCARファイルのインポートのために接続するターゲットTDV。
-ポート<ポート番号>
オプション
オプションで、TDV Serverとの通信に使用されるWebサービスベースポート(HTTP)を指定します。デフォルト値は9400です。
-暗号化
オプション
専用のHTTPSポートを介して送信されるSSLを使用して、コマンドラインとTDV間の通信を暗号化します。
-pkgfile <file_name>
必須
CARファイルの場所とファイル名を指定します。
-pkgfileターゲットファイルは、backup_exportでエクスポートされたCARファイル、またはStudioからのサーバー全体のバックアップである必要があります。
-user <user_name>
必須
TDVシステム管理者のユーザー名。
-パスワード<パスワード>
必須
インポートを実行する管理ユーザーのパスワード。
:optfileを使用する場合、パスワードに二重引用符が含まれている場合は、二重引用符で文字をエスケープする必要があります。
-ドメイン<ドメイン>
オプション
ユーザードメイン。デフォルト値はcompositeです。
-sso
オプション
SSO認証を有効にします。 -spnオプションとともに使用する必要があります。ユーザー名やパスワードは必要ありません。
-sspi
オプション
SSPIで構成されたWindows環境の場合、このパラメーターは-ssoおよび-spnの後に使用できます。
-spn <spn>
オプション
-ssoを指定した後にこのパラメーターを使用して、サービスプリンシパル名を示します。使用しているプロトコルに応じて、次のいずれかの形式を使用してください。
SSPI形式は<ServiceName/Full_ComputerName@Realm>
JGSS形式は<ServiceName@Full_ComputerName>です。
-krb5Conf <krb5Conf>
オプション
複数のKerberos認証ファイルで構成された環境の場合、-ssoおよび-spnの後にこのパラメーターを使用して、使用する認証ファイルを指定できます。
<krb5Conf>は、使用するフルパスとファイル名を指定する必要があります。
このパラメーターが指定されていない場合、デフォルトのKerberosシステムファイルが使用されます。
-<old_path> <new_path>を再配置します
オプション
リソースの場所を古いパスにあったものから新しいパスにあるものに変更します。
このオプションは、すべてのレベルのすべての種類のリソースで機能し、個々のリソースまたはコンテナー全体(フォルダー)を再配置するために使用できます。唯一の制限は、ターゲットの場所が再配置されるリソースの種類に対して有効である必要があることです。
<new_path>をNOIMPORTに設定することにより、-relocateオプションを使用して、指定したリソースをインポートから除外できます。これを行うと、<old_path>で指定されたリソースはインポートされません。
-optfile <file_name>
オプション
コマンドラインを使用せずにオプションを渡すファイルを指定します。オプションファイルは、パスワード情報を非表示にするのに役立ちます。例として次を示します。
backup_import
-server localhost
-user test
-password <password>
-pkgfile sample.car
 
と同じです:
backup_import
-optfile sample.opt -optfilepassword password
 
sample.optに含まれるもの:
-server localhost
-user test
-password <password>
-pkgfile sample.car
メモ
コマンドラインユーティリティを実行すると、optファイルが変更され、ファイル内のパスワード文字列が暗号化されます。
optfileにアクセスするには、optfilePasswordが必要です。
8.4より前のTDVバージョンにはこの機能がありません。
-optfilePassword
optfileを使用する場合は必須です。
オプションファイルにアクセスするために必要なパスワード。
-newOptfilePassword
オプション
このオプションを使用して、optfileパスワードを変更し、オプションファイルのパスワード文字列を再暗号化します。
-
<パス>
<タイプ>
<属性>
<値>を設定します
オプション
インポート中にリソース属性を変更できます。このオプションを繰り返して、異なる属性または複数のクラスパスを設定できます。
<path>はTDVリソース名です。
<属性>がクラスパス、ホスト、ポート、データベース、ユーザー、またはパスワードの場合、<タイプ>はDATA_SOURCEです。
<属性>は次のようになります(ソースタイプによって異なります)。
ユーザー<login>または<user_name>またはエラー
パスワード<パスワード>またはエラー
user2 <app_user_name>またはOracleEBSでない場合はエラー
password2 <app_password>またはOracleEBSでない場合はエラー
ホスト<url_IP>または<dsn>または<server>または<appServer>または<url>または<root>またはエラー
ポート<url_port>または<port>またはエラー
データベース<url_database_name>または<enterprise>または<app_server>またはエラー
パス<root>または<url>またはエラー
アノテーション
<value>を選択した属性の有効なエントリに設定します。スペースを含む文字列値は、二重引用符で囲むことができます。
Windowsシステムの場合、区切り文字としてセミコロンを使用します。
C:\DevZone\ATeam\Jars\my.jar;
D:\Current\Ref\classes
 
UNIXシステムの場合、区切り文字としてコロンを使用します。
/lib/ext/classes:/lib/src/jars
-encryptionPassword
オプション
車のファイル内の機密データを暗号化/復号化するために使用されるパスワード(データソースパスワードなど)。
8.0より前のバージョンのTDVから車のファイルをインポートする場合は、このパラメーターを指定する必要はありません。
-reIntrospect
オプション
このオプションは、インポートの最後にすべてのデータソースを再イントロスペクションするかどうかを制御するために使用されます
-createcachetables
オプション
使用する場合、インポートするCARファイルのメタデータに記述されているように、データソースのデータベースにまだ存在しない場合は、キャッシュされたリソースに必要なキャッシュステータス、トラッキング、およびターゲットテーブルが作成されます。
インポートプロセスでは、cache_status、cache_tracking、およびターゲットテーブルのTDVリソースが、CARファイルのメタデータに記述されていない場合、それらは作成されません。
-updateCacheTables
オプション
はい、もしくは、いいえ。このオプションの値を使用して、キャッシュテーブルを削除し、CARファイルに含まれる可能性のある変更を加えて再作成するかどうかを指定します。
-printinfo
オプション
実際のインポートプロセスを無効にし、代わりにコマンドウィンドウにアーカイブファイルを出力して表示します。
-上書き
オプション
バックアップCARをインポートする前に、すべてのリソースをクリアします。 TDVリソースツリーがインポートされたCARファイルの内容と一致することを確認します。
-genopt
オプション
このオプションとoptファイル名を指定すると、パラメーターは暗号化されたパスワードでoptファイルに保存されます。エクスポートまたはインポート操作を実行している間、保存されたパスワードはクリアテキストとして表示されません。
注:生成されたoptfileには、optfilePasswordが必要です。 8.4より前のTDVバージョンには、このoptfileパスワード機能がありません。
-動詞
オプション
エクスポートプロセスを説明する出力をコマンドラインウィンドウに生成します。デフォルトでは、エラーメッセージのみが表示またはログに記録されます。
-ignoreEncryption
オプション
このオプションを使用すると、有効な暗号化キーが提供されたかどうかに関係なく、すべてのバックアップデータがインポートされます。これは、インポートが失敗しないことを意味します。このオプションを使用すると、バックアップされたデータを部分的にインポートできます。ただし、インポートプロセスでは、暗号化されていないデータ、または提供された暗号化キーを使用して復号化できるデータのみがインポートされます。復号化できないバックアップデータの暗号化された部分はすべて空の値としてインポートされ、それ以外の場合はインポートが成功します。
これは、バックアップデータ内のすべての暗号化された値に影響します。これには、データソースとLDAPドメイン接続のパスワードが含まれますが、これらに限定されません。
データソースのパスワードプロパティを変更するためのサンプルコマンドラインは次のとおりです。
backup_import
-user admin -password admin mycar.car
-set /shared/myDataSource DATA_SOURCE password myNewPassword
 
この例では、-setはオプション、DATA_SOURCEはインポートされるリソースのタイプ、passwordは変更されるプロパティです。