Datenbankbefehle
Mithilfe der Datenbankbefehle für das BAM-Verwaltungsdienstprogramm können Sie mit den BAM-Datenbanken arbeiten:
setup-databases: Erstellt die BAM-spezifischen Datenbanken.
migrate-sql: Migriert Ihre BAM-Datenbanken aus:
Microsoft SQL Server 2000 bis Microsoft SQL Server 2008
Microsoft SQL Server 2005 bis Microsoft SQL Server 2008
enable-reference: Aktiviert einen Verweis auf eine verteilte primäre BAM-Importdatenbank.
get-references: Ruft eine Liste der Verweise auf verteilte primäre BAM-Importdatenbanken ab.
disable-reference: Deaktiviert einen Verweis auf eine primäre BAM-Importdatenbank.
Hinweis
Sie können die Ablaufverfolgung für jeden BM-Hilfsprogrammbefehl aktivieren, indem Sie den Parameterschalter -Trace:on|off einschließen. Die Ablaufverfolgungseinstellungen in der Konfigurationsdatei werden durch die Verwendung dieser Option überschrieben. Der Schalter kann in Verbindung mit jedem normalen BM-Befehl verwendet werden.
Hinweis
Auf einem System, das Unterstützung für die Benutzerkontensteuerung (User Account Control, UAC) bietet, müssen Sie das Tool möglicherweise mit Administratorrechten ausführen.
Befehl „setup-databases“
Verwendung
bm.exe setup-databases-ConfigFile:configuration file>[ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ]<
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| ConfigFile:<Konfigurationsdatei> | Die BAM-Konfigurationsdatei, aus der die Datenbank erstellt werden soll. |
| Benutzername des NSUser:<notifications-Diensts> | Optional: Die Benutzer-ID eines Benachrichtigungsdienstebenutzers mit Berechtigungen zum Erstellen von Datenbanken. |
| NSUserPassword | Optional: Das Kennwort für den angegebenen Benachrichtigungsdienstbenutzer. |
Erstellt die in der Konfigurationsdatei beschriebenen Datenbanken (primäre BAM-Importdatenbank, BAM-Sternschema-Datenbank, BAM-Archivdatenbank, BAM-Analysedatenbank und Benachrichtigungsdatenbank), wenn diese noch nicht vorhanden sind. Nach Abschluss der Datenbankerstellung werden durch den Befehl die dazugehörigen BAM-Metadatentabellen und gespeicherten Prozeduren erstellt.
Die Parameter „NSUser“ und „NSUserPassword“ sind erforderlich, wenn Sie BAM-Benachrichtigungen einrichten möchten. Wenn „NSUserPassword“ in der Befehlszeile nicht angegeben ist, werden Sie von bm.exe zur Eingabe des Kennworts aufgefordert.
Hinweis
Nach Abschluss des Befehls wird möglicherweise eine vom "AlertModule" stammende Ausnahme im Ablaufverfolgungsprotokoll angezeigt:
„Das angegebene Konto ist der Datenbankbesitzer. Der Datenbankbesitzer verfügt stets über Zugriff auf die Ansicht und kann nicht dazu hinzugefügt oder entfernt werden.“
Außerdem wird möglicherweise eine Warnung im Ereignis von NotificationServices #19001 angezeigt.
Wenn während der Ausführung des Befehls keine Fehler gemeldet wurden, können Sie diese Hinweise ignorieren.
Wichtig
Wenn Sie den Befehl „setup-database“ unter Verwendung einer BAM-Konfigurationsdatei ausführen, die keinen Benachrichtigungsabschnitt enthält, und Sie BAM-Benachrichtigungen bereits konfiguriert haben, wird die Konfiguration von bm.exe so überschrieben, dass Benachrichtigungen nicht mehr funktionieren.
Zum Einrichten der BAM-Datenbanken müssen Sie auf dem Microsoft SQL-Server, der als Host für die primäre BAM-Importdatenbank, die BAM-Sternschema-Datenbank sowie die BAM-Archivdatenbank dient, über Administratorberechtigungen verfügen. Zum Einrichten der SQL Notification Services-Datenbanken müssen Sie über Administratorberechtigungen verfügen und Mitglied der lokalen Administratorgruppe und aller weiteren Administratorgruppen sein, die konfiguriert wurden (z. B. der BTS-Administratorengruppe).
Beispiele
bm.exe setup-databases -ConfigFile:BamConfiguration.xml
bm.exe setup-databases -ConfigFile:cfg.xml -NSUser:domain\user1
Befehl „migrate-sql“
Verwendung
bm.exe migrate-sql -From:sql2000 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]
- Oder -
bm.exe migrate-sql -From:sql2005 -To:sql2008 [ -NSUser:<notifications service user name> ][ -NSUserPassword:<notifications service user password> ][ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Von: sql2000 | Gibt an, dass aus einer Microsoft SQL Server 2000-Datenbank konvertiert wird. |
| To:sql2008 | Gibt an, dass Sie in eine Microsoft SQL Server 2008-Datenbank konvertieren. |
| Von: sql2005 | Gibt an, dass Sie aus einer Microsoft SQL Server 2005-Datenbank konvertieren. |
| To:sql2008 | Gibt an, dass Sie in eine Microsoft SQL Server 2008-Datenbank konvertieren. |
| Benutzername des NSUser:<notifications-Diensts> | Optional: Die Benutzer-ID eines Notifications Services-Benutzers mit Berechtigungen zum Erstellen von Datenbanken. |
| NSUserPassword | Optional: Das Kennwort für den angegebenen Notifications Services-Benutzer. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die konvertierte Datenbank befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem die Microsoft SQL Server 2008-Datenbank gehostet wird. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Anschließender Name der konvertierten Datenbank. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Migriert die BAM-Infrastruktur von Microsoft SQL Server 2000 oder Microsoft SQL Server 2005 zu Microsoft SQL Server 2008. Verwenden Sie diesen Befehl, nachdem Sie den Datenbankserver und Den Analyseserver von Microsoft SQL Server 2000 oder Microsoft SQL Server 2005 auf Microsoft SQL Server 2008 aktualisiert haben.
Die Parameter „NSUser“ und „NSUserPassword“ sind erforderlich, wenn BAM-Benachrichtigungen konfiguriert sind. Wenn „NSUserPassword“ in der Befehlszeile nicht angegeben ist, werden Sie von bm.exe zur Eingabe des Kennworts aufgefordert.
Zum Migrieren der Datenbanken für SQL Server Notification Services müssen Sie über Administratorberechtigungen verfügen und Mitglied der lokalen Administratorgruppe und aller weiteren Administratorgruppen sein, die konfiguriert wurden (z. B. der BTS-Administratorengruppe).
Hinweis
Wenn Sie die Fehlermeldung "ERROR: Service NS$BAMAlerts on computer name"< (Fehler: Dienst NS$BAMAlerts auf Computername> nicht starten) erhalten. Der Dienst antwortete nicht rechtzeitig auf die Start- oder Steuerungsanforderung“ angezeigt wird, versuchen Sie, den Dienst manuell neu zu starten. Wenn der SQL-Server während einer Migration stark ausgelastet ist, kann der Dienst möglicherweise nicht neu gestartet werden.
Hinweis
Um den Befehl migrate-sql auf dem Computer auszuführen, auf dem Notification Services installiert ist, müssen Sie zur Gruppe der lokalen Administratoren auf diesem Computer gehören.
Beispiele
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
Befehl „enable-reference“
Verwendung
bm.exe enable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| TargetServer:<Zielserver> | Der Name des Servers, für den der Verweis aktiviert wird. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. |
| TargetDatabase:<target database> | Der Name der Datenbank, für die der Verweis aktiviert wird. |
| Server:<Server> | Optional: Der Name des Servers, auf dem ein Verweis auf den Zielserver und die Datenbank aktiviert ist. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, für die ein Verweis auf den Zielserver und die Datenbank aktiviert ist. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Aktiviert einen Verweis auf eine andere verteilte primäre BAM-Importdatenbank. Dies ermöglicht Abonnements aus der aktuellen Datenbank für die Ansichts- und Aktivitätsmetadaten in der primären BAM-Import-Zieldatenbank. Sie verwenden diesen Parameter, um die Navigation der verteilten Aktivitäten zu ermöglichen.
Sie können den Zielserver als eine Instanz von SQL Server angeben (z. B. mymachine2\myinstance).
Beispiele
bm.exe enable-reference -TargetServer:MySrv -TargetDatabase:BamPrimaryImport
bm.exe enable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1
Befehl „get-references“
Verwendung
bm.exe get-verweise [ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Server:<Server> | Optional: Der Name des Servers, auf dem eine Liste von Verweisen abgerufen werden soll. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, für die eine Liste von Verweisen abgerufen werden soll. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Listet die Verweise auf, die auf dem Computer aktiviert sind, auf dem der Befehl ausgeführt wird.
Beispiele
bm.exe get-references
bm.exe get-references -Server:MyServer -Database:MyPrimaryImport
Befehl „disable-reference“
Verwendung
bm.exe disable-reference -TargetServer:<target server> -TargetDatabase:<target database>[ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| TargetServer:<Zielserver> | Der Name des Servers, auf dem die Verweise deaktiviert werden sollen. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. |
| TargetDatabase:<Target Database> | Der Name der Datenbank, in der die Verweise deaktiviert werden sollen. |
| Server:<Server> | Optional: Der Name des Servers, auf dem Verweise auf den Zielserver und die Datenbank deaktiviert werden sollen. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, für die Verweise auf den Zielserver und die Datenbank deaktiviert werden sollen. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Deaktiviert einen Verweis auf eine andere verteilte primäre BAM-Importdatenbank auf dem Zielserver.
Sie können den Zielserver als eine Instanz von SQL Server angeben (z. B. mymachine2\myinstance).
Beispiele
bm.exe disable-reference -TargetServer:MySrv -TargetDatabase:BamPI
bm.exe disable-reference -TargetServer:s2 -TargetDatabase:db1 -Server:s1