IBM Marketing Platform のユーティリティーおよび SQL スクリプト

ユーティリティーの場所

Marketing Platform ユーティリティーは、Marketing Platform インストールの下の tools/bin ディレクトリーにあります。

ユーティリティーのリストと説明

Marketing Platform は、以下のユーティリティーを提供します。

• alertConfigTool - IBM Marketing Software 製品のアラートと構成を登録します。
• configTool - 構成設定 (製品の登録を含む) のインポート、エクスポート、および削除を行います。
• datafilteringScriptTool - データ・フィルターを作成します。
• encryptPasswords - パスワードを暗号化および保管します。
• encryptTomcatDBPasswords - Tomcat アプリケーション・サーバーが内部で使用するデータベースのパスワードを暗号化します。
• partitionTool - パーティションのデータベース・エントリーを作成します。
• populateDb - Marketing Platform データベースにデータを設定します。
• restoreAccess - ユーザーに platformAdminRole 役割を復元します。
• scheduler_console_client - トリガーを listen するように構成されている IBM Marketing Software のスケジューラー・ジョブをリストまたは開始します。

Marketing Platform ユーティリティーを実行するための前提条件

以下は、すべての Marketing Platform ユーティリティーを実行するための前提条件です。

• すべてのユーティリティーは、それらが存在するディレクトリー (デフォルトでは、Marketing Platform インストールの下の tools/bin ディレクトリー) から実行します。
• UNIX では、ベスト・プラクティスは、Marketing Platform が配置されている アプリケーション・サーバーを実行するユーザー・アカウントと同じユーザー・アカウントでユーティリティーを実行することです。異なるユーザー・アカウントでユーティリティーを実行する場合、platform.log ファイルの権限を調整して、そのユーザー・アカウントがこのファイルに書き込めるようにします。権限を調整しないと、ユーティリティーはログ・ファイルに書き込むことができず、ツールは正しく機能しているのにエラー・メッセージが表示される可能性があります。

ユーティリティーの認証

例えば configTool などの IBM Marketing Software バックエンド・ユーティリティーのようなユーティリティーは、システム管理者が使用するように設計されており、起動するためにはホスト・サーバーへの物理アクセスを必要とします。そのため、これらのユーティリティーの認証は、UI 認証メカニズムから独立して設計されています。これらのユーティリティーへのアクセスは、Marketing Platform 管理者特権のあるユーザーが行えます。これらのユーティリティーに対するアクセスは Marketing Platform でローカルに定義され、その同じ定義に基づいて認証されることになっています。

接続の問題のトラブルシューティング

encryptPasswords を除くすべての Marketing Platform ユーティリティーは、Marketing Platform システム・テーブルと対話します。システム・テーブル・データベースに接続するために、これらのユーティリティーは以下の接続情報を使用します。この情報は、Marketing Platform のインストール時に提供される情報を使ってインストーラーによって設定されます。この情報は、Marketing Platform インストールの下の tools/bin ディレクトリーにある jdbc.properties ファイルに保管されます。

• JDBC ドライバー名
• JDBC 接続 URL (ホスト、ポート、およびデータベース名を含む)
• データ・ソース・ログイン
• データ・ソース・パスワード (暗号化)

さらに、これらのユーティリティーは、Marketing Platform のインストール済み環境の tools/bin ディレクトリーにある setenv スクリプトまたはコマンド行で設定された、JAVA_HOME 環境変数に依存しています。この変数は Marketing Platform インストーラーによって setenv スクリプトで自動的に設定されるはずですが、ユーティリティーの実行に問題がある場合は JAVA_HOME 変数が設定されていることを確認することをお勧めします。JDK は Sun バージョンでなければなりません (例えば WebLogic で入手できる JRockit JDK は不可です)。

特殊文字

オペレーティング・システムで予約文字として指定されている文字は、エスケープする必要があります。予約文字のリストおよびそれをエスケープする方法については、オペレーティング・システムの資料を参照してください。

Marketing Platform ユーティリティーの標準オプション

すべての Marketing Platform ユーティリティーで、以下のオプションを使用できます。

-l logLevel

コンソールに表示されるログ情報のレベルを設定します。オプションは、high、medium、および low です。デフォルトは low です。

-L

コンソール・メッセージのロケールを設定します。デフォルト・ロケールは en_US です。使用可能なオプション値は、Marketing Platform が翻訳されている言語に依存します。ISO 639-1 および ISO 3166 に応じて、ICU ロケール ID を使ってロケールを指定します。

-h

使用法に関する簡潔なメッセージをコンソールに表示します。

-m

このユーティリティーのマニュアル・ページをコンソールに表示します。

-v

実行の詳細をコンソールに表示します。