管理ガイド> TDVコマンドラインユーティリティ> TDVパッケージエクスポートユーティリティ
 
TDVパッケージエクスポートユーティリティ
pkg_exportコマンドラインユーティリティを使用すると、指定したTDV Serverのディレクトリとリソースを単一のCARファイルにエクスポートできます。これにより、次の利点が得られます。
すべてのメタデータファイルとリソースが集約されます。
複数のリソースファイルが、圧縮されたポータブルアーカイブにパッケージ化されています。
pkg_exportユーティリティは、<TDV_install_dir>/binにあります。さまざまなコンピューティング環境で使用するために、さまざまなバージョンが提供されています。
プラットホーム
効用
Windows
pkg_export.bat
UNIX
pkg_export.sh
注: Studioを使用して選択したリソースをエクスポートする方法の詳細については、TDVユーザーガイドを参照してください。
ユーザーは、TDV_INSTALL/conf/serverディレクトリへの書き込みアクセス権を持っている必要があります
pkg_exportユーティリティは、リストされている各リソースをエクスポートします(/users/Composite/manager/sourcesなどの名前空間パスを使用)。ドメイン、ユーザー、グループ、またはサーバー設定は含まれません。
すべてのユーザーがこのコマンドを実行できます。指定されたリソースのいずれにも読み取り権限がない場合、エクスポートは失敗します。すべてのリソースとその子に対する読み取り特権がある場合は、すべての子も含まれます。
注:ユーザーが読み取り権限を持たない子リソースは、通知なしにエクスポートパッケージから除外されます。
パッケージエクスポートユーティリティを使用するには
1. コマンドプロンプトウィンドウを開きます。
2. <TDV_install_dir>/binに移動します。
3. pkg_exportコマンドを実行します。
./pkg_export -pkgfile <filename>
-encryptionPassword <encryptionPassword>
-server <hostname> [ -port <port> ] [ -encrypt ]
[-user <username> ] [ -password <password> ] [ -domain <domain> ]
[-sso ] [ -sspi ] [ -spn <spn> ] [ -krb5Conf <krb5Conf> ]
[-pkgname <name> ] [ -description <text> ]
[-optfile <filename> ] ...
[-optfilePassword <optpassword>]
[-newOptfilePassword <new optpassword>]
[-rebindable <path> <description> ] ...
[-includeaccess ] [ -includecaching ]
[-nosourceinfo ] [ -includejars ]
[-includeAllUsers] [ -includeUser <domain> <user> ] ...
[-includeGroup <domain> <group>] ... [ -includeDomain <domain> ]
[-includeRequiredUsers ] [ -includeDependencies ]
[-includeStatistics ]
[-genopt <filename> ] [-optfilePassword <optpassword>]
[-verbose ] [ -quiet ]
[-includeParentResources]
 
次の表は、pkg_exportパラメーターをアルファベット順に示しています。
パッケージエクスポートパラメータ
オプション/必須
コメントコメント
-pkgfile <file_name>
必須
新しいCARファイル名。
-encryptionPassword
必須
車のファイル内の機密データを暗号化/復号化するために使用されるパスワード(データソースパスワードなど)。
-server <host_name>
必須
ユーティリティが接続するTDV Serverホスト。
-port <port_number>
オプション
TDV Serverとの通信に使用するWebサービスのベースポート(HTTP)を指定します。デフォルト値は9400です。
-encrypt
オプション
専用のHTTPSポートを介して送信されるSSLを使用して、コマンドラインとTDV間の通信を暗号化します。 HTTPSポートは、ベースポート番号に2を加えたものです。
-user <user_name>
必須
TDVシステムの管理ユーザー名。ユーザーは、指定されたリソースの所有権を持っているか、少なくとも、アクセスツールとすべての構成の読み取り権限を持つ指定されたすべてのリソースに対する読み取り権限を持っている必要があります。
-password <password>
必須
パッケージのエクスポートに使用されるユーザープロファイルのパスワード。
:optfileを使用する場合、パスワードに二重引用符が含まれている場合は、二重引用符で文字をエスケープする必要があります。
-domain <domain>
オプション
ユーザードメイン。デフォルト値は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システムファイルが使用されます。
-pkgname “<name>”
オプション
パッケージ名を設定できます。スペースは使用できますが、句読点は使用できません。
-description "<text>"
オプション
アーカイブファイルのパッケージの説明。 Studioを使用してCARをインポートすると、表記が表示されます。
-optfile <file_name>
オプション
コマンドラインを使用せずにオプションを渡すオプションファイルを指定します。オプションファイルは、パスワード情報を非表示にするのに役立ちます。例として次を示します。
pkg_export
-server localhost
-user test
-password password
-pkgfile sample.car
 
と同じです:
pkg_export
-optfile sample.opt -optfilepassword password
このパラメーターが指定されていない場合、デフォルトのKerberosシステムファイルが使用されます。
sample.optに含まれるもの:
-server localhost -user test
-password password
-pkgfile sample.car
メモ
コマンドラインユーティリティを実行すると、optファイルが変更され、ファイル内のパスワード文字列が暗号化されます。
optfileにアクセスするには、optfilePasswordが必要です。
8.4より前のバージョンのTDV Serverにはこの機能がありません。
-optfilePassword
optfileを使用する場合は必須です。
オプションファイルにアクセスするために必要なパスワード。
-newOptfilePassword
オプション
このオプションを使用して、optfileパスワードを変更し、オプションファイルのパスワード文字列を再暗号化します。
-rebindable <path> <description> ...
オプション
インポート時に再バインドするためのリソース依存関係をマークします。再バインド可能なリソースがインポートされると、リマインダーと<Description>がコマンドラインに表示されます。インポート時にアクションを実行するには、インポート時に-rebindオプションを指定する必要があります。そのメッセージはStudioにも表示され、リソースの依存関係として新しいリソース(パス)の指定を促します。
このオプションでインポート中に再バインドするための新しいリソースが指定されていない限り、再バインドはインポート後に実行する必要があります。
-includeAccess
オプション
エクスポートファイルのリソースに対する現在のユーザーアクセス制御(特権仕様)を含めます。管理者がエクスポートした場合でも、デフォルト設定にはアクセス制御は含まれていません。
このオプションが使用され、エクスポートするユーザーが管理者グループ(すべてのリソースを読み取る権限を持つ)のメンバーでない場合、エラーが発生する可能性があります。
-includeCaching
オプション
ビューとプロシージャのキャッシュの詳細をエクスポートファイルに含めます。このオプションを指定して、マテリアライズド・ビューからのキャッシュ・データ、またはキャッシュ更新のスケジューリングを含む構成を含める必要があります。
-nosourceinfo
オプション
データソース接続の詳細(ユーザー名、パスワード、ホスト名、ポートなど)はデフォルトで含まれています。これらを除外するには、‑nosourceinfoを指定します。パスワードが含まれている場合、それらは暗号化されます。
-includeJars
オプション
含まれているカスタムJavaプロシージャデータソースのJARをエクスポートします。
-includeallusers
オプション
すべてのドメイン、グループ、およびユーザーをエクスポートファイルにエクスポートします。すべてのユーザーを読む権利が必要です。
-includeuser <domain_name> <user_name>
オプション
指定されたユーザーをエクスポートファイルに含めます。このオプションを繰り返して、複数のユーザーをエクスポートできます。オプションキーワード-includeUserを、新しいドメインとユーザーの引数とともに必要な回数繰り返します。
-includegroup <domain_name> <group_name>
オプション
指定したグループに関するグループ情報をエクスポートファイルにエクスポートします。
-includedomain <domain_name>
オプション
指定したドメインメタデータをエクスポートファイルにエクスポートします。
-includeRequiredUsers
オプション
必要なユーザーに関する情報をエクスポートファイルに含めます。
-includeDependencies
オプション
エクスポートすることを選択したリソースのすべての依存リソースを収集して含めます。
-includeStatistics
オプション
テーブルまたは列の境界について既知のリソース統計が含まれます。
-genopt
オプション
このオプションとoptファイル名を指定すると、パラメーターは暗号化されたパスワードでoptファイルに保存されます。エクスポートまたはインポート操作を実行している間、保存されたパスワードはクリアテキストとして表示されません。
注:生成されたoptfileには、optfilePasswordが必要です。 8.4より前のTDVバージョンには、このoptfileパスワード機能がありません。
-verbose
オプション
エクスポート中に発生した問題を報告します。 verboseもquietも言及されていない場合、verboseがデフォルトの動作です。
-quiet
オプション
このオプションが設定されている場合、コマンド情報は報告されません。
-includeParentResources
オプション
このオプションを有効にすると、データソースメタデータのエクスポート中に親リソースが含まれます。
この例では、myParameterizedQueryは、ordersデータソースからのproductsテーブルを含む依存関係とともにエクスポートされます。 -rebindableオプションは、インポート中に製品リソースをリバウンドする必要があることをユーザーに通知または通知するために指定されます。
pkg_export -pkgfile MyExport.car
shared/procedures/myParameterizedQuery
-server localhost
-user admin -password AdminPassword
-includeDependencies
-rebindable shared/sources/ds_orders/products This needs rebinding to the production data source.
例2
この例では、共有/ソースはSources_Backup.carにバックアップされています。
pkg_export -pkgfile Sources_Backup.car
shared/sources
-optfile C:/BackupScripts/Sources/weekly.opt -optfilepassword password
-includeDependencies
-nosourceinfo
 
オプションファイルweekly.optには、元のコマンドで欠落していた必須の引数が含まれている必要があります。たとえば、いくつかの値を持つ次のオプションが必要になる場合があります。
-server localhost
-user DBASecure1
-password Password
-domain EnterpriseLDAP
 
オプションファイルを動的に生成して、ユーザー名、パスワード、ドメインなどのオプションと引数を指定できます。これにより、スケジュールされたスクリプトを実行する前にDBAログインがアプリケーションウィンドウまたはファイルに表示されないようにしながら、プログラムによるバックアップを設定できます。