configTool ユーティリティー
「構成」ページの プロパティーおよび値は、システム・テーブルに保管されています。configTool ユーティリティーを 使用して、構成設定をシステム・テーブルにインポートしたり、システム・テーブルからエクスポートしたりできます。
configTool を使用する状況
configTool は、次のような場合に使用することがあります。
*
Campaign と共に提供されるパーティションおよびデータ・ソース・テンプレートを インポートする場合。その後、それを「構成」ページで変更したり複製したりできます。
*
製品インストーラーによって自動的にプロパティーをデータベースに追加できないときに IBM® EMM 製品を登録 (構成プロパティーをインポート) する場合。
*
バックアップ用に XML バージョンの構成設定をエクスポートする、あるいは IBM® EMM の別のインストール済み環境にインポートする場合。
*
「カテゴリーの削除」リンクのないカテゴリーを削除する場合。 これを行うには、configTool を使用して構成をエクスポートし、 カテゴリーを作成する XML を手動で削除してから、編集した XML を configTool を使用してインポートします。
*
このユーティリティーは、構成プロパティーおよびそれらの値が含まれる Marketing Platform システム・テーブル・データベース の usm_configuration および usm_configuration_values テーブル を変更します。最適な結果を得るには、これらのテーブルのバックアップ・コピーを作成するか、configTool を使って既存の構成をエクスポートした結果のファイルをバックアップしてください。こうすると、configTool を使ってインポートするときにエラーが発生した場合でも、構成を復元することが可能です。
構文
configTool -d -p "elementPath" [-o]
configTool -i -p "parent ElementPath" -f importFile [-o]
configTool -x -p "elementPath" -f exportFile
configTool -vp -p "elementPath" -f importFile [-d]
configTool -r productName -f registrationFile [-o] configTool -u productName
コマンド
-d -p "elementPath" [o]
構成プロパティー階層のパスを 指定して、構成プロパティーとその設定を削除します。
エレメント・パスには、カテゴリーおよびプロパティーの内部名が 使用されている必要があります。それらを 得るには、「構成」ページの 目的のカテゴリーまたはプロパティーを選択して、右のペインに ある括弧内に示されているパスを確認します。構成プロパティーの階層のパスを | 文字を使用して区切り、パスを二重引用符で囲みます。
次のことに注意してください。
*
*
「構成」ページに「カテゴリーの削除」リンクのないカテゴリーを削除 するには、-o オプションを使用します。
-d を指定した -vp コマンドを使用する場合、configTool はユーザーが指定するパスにあるすべての下位ノードを削除します (これらのノードが、ユーザーの指定する XML ファイルに含まれていない場合)。
-i -p "parentElementPath" -f importFile [o]
指定した XML ファイルから構成プロパティーおよびそれらの設定をインポートします。
インポート を行うには、カテゴリーのインポート先とする親エレメントへのパスを 指定します。configTool ユーティリティー は、パスに指定するカテゴリーの下にプロパティーをインポートします。
最上位の下の任意のレベルにカテゴリーを追加できますが、 最上位カテゴリーと同じレベルにカテゴリーを追加することはできません。
親エレメント・パスには、カテゴリーおよびプロパティーの内部名が 使用されている必要があります。それらを 得るには、「構成」ページの 必要なカテゴリーまたはプロパティーを選択して、右のペインに ある括弧内に示されたパスを確認します。構成プロパティーの階層のパスを | 文字を使用して区切り、パスを二重引用符で囲みます。
tools/bin ディレクトリーからの相対的なインポート・ファイル・ロケーションを指定するか、 絶対ディレクトリー・パスを指定することができます。相対パスを指定する、 あるいはパスを指定しない場合、configTool はまず tools/bin ディレクトリーから相対的な位置にあるファイルを探します。
デフォルト では、このコマンドは既存のカテゴリーを上書きしませんが、-o オプションを使用すると上書きを強制 することができます。
-x -p "elementPath" -f exportFile
構成プロパティー およびその設定を、指定した名前の XML ファイルにエクスポートします。
すべての構成プロパティーをエクスポートするか、 構成プロパティー階層のパスを指定することで特定のカテゴリーのみをエクスポートします。
エレメント・パスには、カテゴリーおよびプロパティーの内部名 が使用されている必要があります。それらを得るには、「構成」ページの目的のカテゴリーまたはプロパティーを選択して 右側のペインにある括弧内に示されたパスを確認します。 構成プロパティーの階層のパスを | 文字を使用して区切り、パスを二重引用符で囲みます。
現行ディレクトリー から相対のエクスポート・ファイル・ロケーションを指定するか、 絶対ディレクトリー・パスを指定することができます。ファイル指定に区切り記号 (UNIX の場合は /、 Windows の場合は / または ¥) が含まれていない場合、configTool はファイルを Marketing Platform インストール済み環境の tools/bin ディレクトリーの下に作成します。 xml 拡張子を指定しないと、configTool によって追加されます。
-vp -p "elementPath" -f importFile [-d]
このコマンドは 、主に手動アップグレードにおける構成プロパティーのインポートに使用されます。 新しい構成プロパティーが含まれるフィックスパックを適用し、その後にアップグレードする場合、 手動アップグレード・プロセスの一部として構成ファイルをインポートすると、 フィックスパックを適用したときに設定された値がオーバーライドされる場合があります。-vp コマンドを使用すると、 インポートを行っても、それ以前に設定された構成値はオーバーライドされません。
*
configTool ユーティリティーを -vp オプションを指定して使用したら、変更が適用されるように、Marketing Platform が デプロイされている Web アプリケーション・サーバーを再始動する必要があります。
-d を指定した -vp コマンドを使用する場合、configTool はユーザーが指定するパスにあるすべての下位ノードを削除します (これらのノードが、ユーザーの指定する XML ファイルに含まれていない場合)。
-r productName -f registrationFile
アプリケーションを 登録します。登録ファイルのロケーションは、tools/bin ディレクトリーからの相対パスで指定することも、 絶対パスで指定することもできます。デフォルト では、このコマンドは既存の構成を上書きしませんが、 -o オプションを使用すると上書きを強制 することができます。productName パラメーターは、上記にリストされているうちのいずれかでなければなりません。
次のことに注意してください。
*
-r コマンドを使用する場合、登録ファイルには XML 内の最初のタグとして <application> がある 必要があります。
Marketing Platform データベースに構成プロパティーを 挿入するために使用できる他のファイルが、製品と一緒に提供されることがあります。 これらのファイルには、-i コマンドを使用します。 最初のタグとして <application> タグのあるファイルのみを -r コマンドと共に使用できます。
*
Marketing Platform 用の登録ファイルは Manager_config.xml という名前で、 最初のタグは <Suite> です。このファイルを 新しいインストールに登録するには、populateDb ユーティリティーを使用するか、 Marketing Platform インストーラーを再実行します (「IBM® Marketing Platform インストール・ガイド」を参照してください)。
*
最初のインストールの後、Marketing Platform 以外の製品を再登録 するには、configTool-r コマンドおよび -o を指定して実行して、既存のプロパティーを上書きします。
configTool ユーティリティーは、製品の登録または登録解除を行うコマンドのパラメーターとして製品名を使用します。 IBM® EMM の 8.5.0 のリリースでは、 多くの製品名が変更になりました。ただし、configTool が認識する名前は変更されていません。configTool で使用できる有効な製品名を、現在の製品名とともに以下にリストします。
IBM® SPSS® Modeler Advantage Enterprise Marketing Management Edition
-u productName
productName で指定されているアプリケーションを登録解除します。 製品カテゴリーにパスを含める必要はありません。製品名は必須で、それのみで十分です。この処理は、 製品のすべてのプロパティーおよび構成設定を削除します。
オプション
-o
-i または -r と 共に使用すると、既存のカテゴリーまたは製品登録 (ノード) を上書きします。
-d と共に使用すると、「構成」ページ に「カテゴリーの削除」リンクがないカテゴリー (ノード) を削除することができます。
*
Marketing Platform インストール済み環境の下の conf ディレクトリーの Product_config.xml という名前のファイルから構成設定をインポートします。
configTool -i -p "Affinium" -f Product_config.xml
*
提供された Campaign データ・ソース・テンプレートを デフォルトの Campaign パーティション partition1 にインポートします。この例では、ユーザーが Oracle データ・ソース・テンプレート OracleTemplate.xmlMarketing Platform インストール済み環境の下の tools/bin ディレクトリー に置くことを想定しています。
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml
*
すべての構成設定を D:¥backups ディレクトリーの myConfig.xml という名前のファイルに エクスポートします。
configTool -x -f D:¥backups¥myConfig.xml
*
既存の Campaign パーティション (データ・ソース・エントリーを含む) をエクスポートし、それを partitionTemplate.xml という名前のファイルに 保存し、それを Marketing Platform インストール済み環境の下のデフォルトの tools/bin ディレクトリーに 保存します。
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
Marketing Platform インストール済み環境の下のデフォルトの tools/bin ディレクトリーにある app_config.xml という名前のファイルを使用して、productName という名前のアプリケーションを手動で登録して、このアプリケーションの既存の登録を上書きするように強制します。
configTool -r product Name -f app_config.xml -o
*
configTool -u productName