BAM 管理ユーティリティ データベース コマンドを使用すると、BAM データベースを操作できます。
setup-databases: BAM 固有のデータベースを作成します。
migrate-sql: BAM データベースを次の場所から移行します。
Microsoft SQL Server 2000 から Microsoft SQL Server 2008
Microsoft SQL Server 2005 から Microsoft SQL Server 2008
enable-reference: 分散 BAM プライマリ インポート データベースへの参照を有効にします。
get-references: 分散 BAM プライマリ インポート データベースへの参照の一覧を取得します。
disable-reference: BAM プライマリ インポート データベースへの参照を無効にします。
注
-Trace:on|off パラメーター スイッチを含めることで、任意の BM ユーティリティ コマンドでトレースを有効にすることができます。 トレース スイッチを使用すると、構成ファイルのトレース設定がオーバーライドされます。 スイッチは、通常の BM コマンドと組み合わせて使用できます。
注
ユーザー アカウント制御 (UAC) をサポートするシステムでは、管理者特権でツールを実行することが必要になる場合があります。
setup-databases コマンド
使用方法
bm.exe setup-databases-ConfigFile:<configuration file>[ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ]
パラメーター
| パラメーター | 説明 |
|---|---|
| ConfigFile:<configuration ファイル> | データベースの作成元となる BAM 構成ファイル。 |
| NSUser:<notifications サービスのユーザー名> | 省略可能: データベースを作成するアクセス許可を持つ通知サービス ユーザーのユーザー ID。 |
| NSUserPassword | 省略可能: 指定された通知サービス ユーザーのパスワード。 |
構成ファイル (BAM プライマリ インポート、BAM スター スキーマ、BAM アーカイブ、BAM 分析、およびアラート) に記述されているデータベースがまだ存在しない場合に作成します。 データベースが作成されると、関連付けられている BAM メタデータ テーブルとストアド プロシージャが作成されます。
BAM アラートを設定する場合は、NSUser パラメーターと NSUserPassword パラメーターが必要です。 コマンド ラインで NSUserPassword が指定されていない場合は、bm.exe パスワードの入力を求められます。
注
コマンドが完了した後、トレース ログの AlertModule からの例外を書き留めておきます。
"指定されたアカウントはデータベース所有者です。 データベース所有者は常にビューにアクセスでき、ビューに追加したり、ビューから削除したりすることはできません。
さらに、NotificationServices #19001 からのイベントに警告が表示される場合があります。
コマンドの実行中にエラーが報告されなかった場合は、これらの通知を無視しても問題ありません。
Important
警告セクションを含まない BAM 構成ファイルを使用してセットアップ データベース コマンドを実行し、BAM アラートを既に構成している場合、bm.exe はアラートが機能しなくなった構成を上書きします。
BAM データベースを設定するには、BAMPrimaryImport、BAMStarSchema、BAMArchive データベースをホストする Microsoft SQL サーバーに対する管理者権限が必要です。 SQL Notification Services データベースを設定するには、管理者アクセス許可があり、ローカル管理者グループのメンバーである必要があります。また、BTS Admins グループなど、構成されているその他の管理グループのメンバーである必要があります。
例
bm.exe setup-databases -ConfigFile:BamConfiguration.xml
bm.exe setup-databases -ConfigFile:cfg.xml -NSUser:domain\user1
migrate-sql コマンド
使用方法
bm.exe migrate-sql -From:sql2000 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]
- または -
bm.exe migrate-sql -From:sql2005 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]
パラメーター
| パラメーター | 説明 |
|---|---|
| From: sql2000 | Microsoft SQL Server 2000 データベースから変換することを指定します。 |
| To:sql2008 | Microsoft SQL Server 2008 データベースに変換することを指定します。 |
| From: sql2005 | Microsoft SQL Server 2005 データベースから変換することを指定します。 |
| To:sql2008 | Microsoft SQL Server 2008 データベースに変換することを指定します。 |
| NSUser:<notifications サービスのユーザー名> | 省略可能: データベースを作成するアクセス許可を持つ Notifications Services ユーザーのユーザー ID。 |
| NSUserPassword | 省略可能: 指定した Notifications Services ユーザーのパスワード。 |
| Server:<server> | 省略可能: 変換されたデータベースが存在するサーバーの名前。 サーバーは、Microsoft SQL Server 2008 データベースをホストしているコンピューターと同じドメインに存在する必要があります。 サーバー名が指定されていない場合、bm.exe は localhost の既定の名前を使用します。 |
| Database:<database> | 省略可能: 変換されたデータベースの名前。 名前が指定されていない場合、bm.exe は既定の名前 BamPrimaryImport を使用します。 |
BAM インフラストラクチャを Microsoft SQL Server 2000 または Microsoft SQL Server 2005 から Microsoft SQL Server 2008 に移行します。 データベース サーバーと分析サーバーを Microsoft SQL Server 2000 または Microsoft SQL Server 2005 から Microsoft SQL Server 2008 にアップグレードした後、このコマンドを使用します。
BAM アラートが構成されている場合は、NSUser パラメーターと NSUserPassword パラメーターが必要です。 コマンド ラインで NSUserPassword が指定されていない場合は、bm.exe パスワードの入力を求められます。
SQL Server Notification Services データベースを移行するには、管理者権限を持ち、ローカル管理者グループのメンバーである必要があります。また、BTS Admins グループなど、構成されているその他の管理グループのメンバーである必要があります。
注
"ERROR: Cannot start service NS$BAMAlerts on computer '<computer name>' というエラー メッセージが表示された場合。 サービスが、開始要求または制御要求にタイムリーに応答しませんでした。"、サービスを手動で再起動してみてください。 移行中に SQL Server が非常にビジー状態の場合、サービスが再起動しない可能性があります。
注
Notification Services がインストールされているコンピューターで migrate-sql コマンドを実行するには、そのコンピューターのローカル管理者グループに属している必要があります。
例
bm.exe migrate-sql -From:sql2000 -To:sql2008 -NSUser:domain\user1
bm.exe migrate-sql -From:sql2000 -To:sql2008 -Server:MyServer -Database:db1
bm.exe migrate-sql -From:sql2005 -To:sql2008 -NSUser:domain\user1
bm.exe migrate-sql -From:sql2005 -To:sql2008 -Server:MyServer -Database:db1
enable-reference コマンド
使用方法
enable-reference -TargetServer:<target server> -TargetDatabase:<target databasebm.exe>[ -Server:<server> ][ -Database:<database> ]
パラメーター
| パラメーター | 説明 |
|---|---|
| TargetServer:<target サーバー> | 参照が有効になっているサーバーの名前。 サーバーは、bm.exeを実行しているコンピューターと同じドメインに存在する必要があります。 |
| TargetDatabase:<target データベース> | 参照が有効になっているデータベースの名前。 |
| Server:<server> | 省略可能: ターゲット サーバーとデータベースへの参照が有効になるサーバーの名前。 サーバー名が指定されていない場合、bm.exe は localhost の既定の名前を使用します。 |
| Database:<database> | 省略可能: ターゲット サーバーとデータベースへの参照が有効になるデータベースの名前。 名前が指定されていない場合、bm.exe は既定の名前 BamPrimaryImport を使用します。 |
別の分散 BAM プライマリ インポート データベースへの参照を有効にします。 これにより、現在のデータベースからターゲット BAM プライマリ インポート データベースのビューとアクティビティのメタデータへのサブスクリプションが許可されます。 これを使用して、分散アクティビティのナビゲーションを有効にします。
ターゲット サーバーを SQL Server のインスタンスとして指定できます (例: "mymachine2\myinstance")。
例
bm.exe enable-reference -TargetServer:MySrv -TargetDatabase:BamPrimaryImport
bm.exe enable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1
get-references コマンド
使用方法
bm.exe get-references [ -Server:<server> ][ -Database:<database> ]
パラメーター
| パラメーター | 説明 |
|---|---|
| Server:<server> | 省略可能: 参照の一覧を取得するサーバーの名前。 サーバーは、bm.exeを実行しているコンピューターと同じドメインに存在する必要があります。 サーバー名が指定されていない場合、bm.exe は localhost の既定の名前を使用します。 |
| Database:<database> | 省略可能: 参照の一覧を取得するデータベースの名前。 名前が指定されていない場合、bm.exe は既定の名前 BamPrimaryImport を使用します。 |
コマンドが実行されるコンピューターで有効になっている参照を一覧表示します。
例
bm.exe get-references
bm.exe get-references -Server:MyServer -Database:MyPrimaryImport
disable-reference コマンド
使用方法
bm.exe disable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]
パラメーター
| パラメーター | 説明 |
|---|---|
| TargetServer:<target サーバー> | 参照を無効にするサーバーの名前。 サーバーは、bm.exeを実行しているコンピューターと同じドメインに存在する必要があります。 |
| TargetDatabase:<target データベース> | 参照を無効にするデータベースの名前。 |
| Server:<server> | 省略可能: ターゲット サーバーとデータベースへの参照を無効にするサーバーの名前。 サーバーは、bm.exeを実行しているコンピューターと同じドメインに存在する必要があります。 サーバー名が指定されていない場合、bm.exe は localhost の既定の名前を使用します。 |
| Database:<database> | 省略可能: ターゲット サーバーとデータベースへの参照を無効にするデータベースの名前。 名前が指定されていない場合、bm.exe は既定の名前 BamPrimaryImport を使用します。 |
ターゲット サーバー上の別の分散 BAM プライマリ インポート データベースへの参照を無効にします。
ターゲット サーバーを SQL Server のインスタンスとして指定できます (例: "mymachine2\myinstance")。
例
bm.exe disable-reference -TargetServer:MySrv -TargetDatabase:BamPI
bm.exe disable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1