configTool ユーティリティー
「構成」ページのプロパティーと値は、システム・テーブルに保管されます。 configTool ユーティリティーを使用すると、システム・テーブルとの間で構成設定のインポートおよびエクスポートが行えます。
configTool を使用する場合
configTool を使用する理由として、以下が考えられます。
*
Campaign に付属のパーティションおよびデータ・ソースのテンプレートをインポートする場合。その後、「構成」ページを使用してこれらのテンプレートを変更したり複製したりできます。
*
製品インストーラーがプロパティーをデータベースに自動的に追加できない場合に IBM® EMM 製品を登録する (その構成プロパティーをインポートする)。
*
バックアップのため、または IBM® EMM の別のインストールにインポートするために、構成設定の XML バージョンをエクスポートする。
*
「カテゴリーの削除」リンクを持たないカテゴリーを削除する。 この操作を行うには、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 オプションを使用します。
-vp コマンドとともに -d を使用すると、指定のパス内にある下位ノードがユーザーの指定した XML ファイルに含まれていない場合、configTool はそれらのノードを削除します。
-i -p "parentElementPath" -f importFile [o]
指定された XML ファイルから構成プロパティーとその設定をインポートします。
インポートするには、カテゴリー・インポート先の上の親要素へのパスを指定します。 configTool ユーティリティーは、パスで指定されたカテゴリーの下のプロパティーをインポートします。
カテゴリーは最上位より下のどのレベルにでも追加できますが、最上位カテゴリーと同じレベルに追加することはできません。
親要素のパスでは、カテゴリーおよびプロパティーの内部名を使用する必要があります。 これらの内部名は、「構成」ページに移動して、必要なカテゴリーまたはプロパティーを選択し、右側のペインの括弧内に表示されるパスを調べることによって得ることができます。 | 文字を使用して構成プロパティーの階層内のパスを区切り、そのパスを二重引用符で囲みます。
インポート・ファイルの場所は、tools/bin ディレクトリーからの相対パスで指定することも、完全ディレクトリー・パスで指定することもできます。 相対パスを指定するかパスを指定しない場合、configTool はまず tools/bin ディレクトリーに相対するファイルを探します。
デフォルトではこのコマンドは既存のカテゴリーを上書きしませんが、-o オプションを使用して上書きを強制することができます。
-x -p "elementPath" -f exportFile
構成プロパティーとその設定を、指定された名前の XML ファイルにエクスポートします。
構成プロパティーをすべてエクスポートすることも、構成プロパティー階層内のパスを指定することによってエクスポートを特定のカテゴリーに制限することもできます。
要素のパスには、カテゴリーとプロパティーの内部名を使用する必要があります。これらの内部名は、「構成」 ページに移動して、目的のカテゴリーまたはプロパティーを選択し、右側のペインの括弧内に表示されるパスを調べることによって得ることができます。 | 文字を使用して構成プロパティーの階層内のパスを区切り、そのパスを二重引用符で囲みます。
エクスポート・ファイルの場所は、現行ディレクトリーからの相対パスで指定することも、完全ディレクトリー・パスで指定することもできます。 ファイル指定に区切り文字 (UNIX の場合は /、Windows の場合は / または¥) が含まれていない場合、configToolMarketing Platform インストール済み環境の tools/bin ディレクトリーにファイルを書き込みます。 xml 拡張子を指定しなくても、configTool はそれを追加します。
-vp -p "elementPath" -f importFile [-d]
このコマンドは、主に手動によるアップグレードで、構成プロパティーをインポートするために使用します。 新しい構成プロパティーを含んだフィックスパックを適用した後で、手動によるアップグレード・プロセスの一環として構成ファイルをインポートしてアップグレードした場合、フィックスパック適用時に設定した値がオーバーライドされる可能性があります。 -vp コマンドを使用すると、前に設定した構成値がインポートによってオーバーライドされることがありません。
*
-vp オプションを指定して configTool ユーティリティーを使用した後で、変更を適用するために、Marketing Platform が配置されている Web アプリケーション・サーバーを再始動する必要があります。
-vp コマンドとともに -d を使用すると、指定のパス内にある下位ノードがユーザーの指定した XML ファイルに含まれていない場合、configTool はそれらのノードを削除します。
-r productName -f registrationFile
アプリケーションを登録します。 登録ファイルの場所は、tools/bin ディレクトリーからの相対位置にすることも、絶対パスにすることもできます。 デフォルトではこのコマンドは既存の構成を上書きしませんが、-o オプションを使用して上書きを強制することができます。 productName パラメーターは、上記にリストされている名前のいずれかでなければなりません。
次のことに注意してください。
*
-r コマンドを使用する場合、登録ファイルの XML の最初のタグは <application> でなければなりません。
そのほかにも、Marketing Platform データベースに構成プロパティーを挿入するために使用できるファイルが製品に付属している場合があります。 これらのファイルについては、-i コマンドを使用します。 -r コマンドで使用できるファイルは、最初のタグが <application> タグであるファイルのみです。
*
Marketing Platform の登録ファイルの名前は Manager_config.xml で、最初のタグは <Suite> です。 このファイルを新しいインストール済み環境に登録するには、「IBM® Marketing Platform インストール・ガイド」の説明に従って、populateDb ユーティリティーを使用するか、Marketing Platform インストーラーを再実行します。
*
初回インストール後に、Marketing Platform 以外の製品を再登録するには、-r コマンドおよび -o を指定した configTool を使用して、既存のプロパティーを上書きします。
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