Freigeben über

Befehle zur Bereitstellung von BAM-Definitionen (Überwachungsmodell)

  • Artikel

Mit den Bereitstellungsbefehlen im BAM-Verwaltungsdienstprogramm können Sie Definitionen anwenden, ändern und entfernen.

  • deploy-all: Stellt eine BAM-Definition bereit.

  • update-all: Updates eine BAM-Definition.

  • remove-all: Entfernt eine BAM-Definition.

  • update-livedataworkbook: Updates die Datenbankverbindungsinformationen in einer Livedatenarbeitsmappe.

  • regenerate-livedataworkbook: Generiert die Livedatenarbeitsmappe auf dem Server neu.

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 'deploy-all'

Verwendung

bm.exe deploy-all -DefinitionFile:<def file>[ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter BESCHREIBUNG
DefinitionFile:<def file> Der Pfad und der Name der Datei, die die bereitzustellenden Definitionen enthält.
Server:<Server> Optional: Der Name des Servers, auf dem die Definitionen bereitgestellt 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, in der die Definitionen bereitgestellt werden sollen. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Stellt alle Elemente aus der angegebenen BAM-Definitions-XML-Datei auf dem angegebenen Server und in der angegebenen Datenbank bereit. Die Datei kann eine Textdatei mit dem BAM-Definitions-XML oder eine BAM-Excel-Arbeitsmappe sein. Die Definitionsdatei darf nur neue Elemente enthalten. Wenn sich in der Datei Elemente befinden, die bereits bereitgestellt wurden, schlägt die Bereitstellung fehl, und es wird ein Fehler gemeldet.

Überlegungen zum Bereitstellen von BAM-Definitionen

Beim Bereitstellen von Benachrichtigungsabonnements müssen Benutzer-IDs der Abonnenten im Format "Domäne\Benutzer" angegeben werden.

Der DTC-Dienst (Distributed Transaction Coordinator) muss auf dem Computer ausgeführt werden, auf dem der Befehl deploy-all ausgegeben wird.

Beim Bereitstellen einer Definition unterstützt das BAM-Verwaltungsdienstprogramm in der RTA-Ansicht (Real-Time Aggregation, Echtzeitaggregation) höchstens 14 Dimensionsebenen. Beim Versuch, zusätzliche Ebenen bereitzustellen, wird ein Fehler ausgegeben, und die Bereitstellung schlägt fehl.

Wenn Sie mehrere Ansichten definieren, in denen verschiedene Spracheinstellungen verwendet werden, und Ihre Lösung auf einem Server mit nur einer Spracheinstellung bereitstellen, können die Ansichten nicht bereitgestellt werden. Dieses Szenario wird nur in Fällen unterstützt, in denen keine geplanten Aggregationen vorhanden sind, die als Teil der BAM-Definition OLAP erfordern.

Sind BAM-Benachrichtigungen aktiviert, wird die Zahl der bereitgestellten Aktivitätsansichten vom BAM-Verwaltungsdienstprogramm auf 49 beschränkt. Die Anzahl der Aktivitätsansichten ergibt sich aus der Summation der 1 (...) N Ansicht(en), multipliziert mit der Anzahl der übergeordneten Aktivitäten. Wenn Sie z. B. eine Ansicht bereitstellen, die auf zwei Aktivitäten basiert, erhalten Sie zwei Aktivitätsansichten. Wenn Sie zwei Ansichten bereitstellen, von denen eine zwei Aktivitäten umfasst und die andere auf einer einzelnen Aktivität basiert, erhalten Sie 3 Aktivitätsansichten.

Das BAM-Verwaltungsdienstprogramm blockiert die Bereitstellung von BAM-Definitionen mit mehreren PivotTable-Berichten, die in derselben Kombination von RTA- und Cubename definiert sind. Bm.exe beendet die Bereitstellung und gibt den folgenden Fehler zurück:

Bereitstellen von Ansicht... FEHLER: Fehler bei der BAM-Bereitstellung.

In einer bestimmten Echtzeitaggregation und einem Cube kann nur eine PivotTable-Ansicht definiert werden.

Die Namen in der nachstehenden Liste sind reserviert und verursachen Fehler bei der Definitionsbereitstellung:

  • RecordID

  • Aktivitäts-ID

  • Sichtbar

  • IsComplete

  • LastModified

Hinweis

Wenn bm.exe während der Bereitstellung einen Fehler findet, wird der Vorgang abgebrochen und für alle an Ansichten und Aktivitäten vorgenommenen Änderungen wird ein Rollback durchgeführt. Änderungen an OLAP-Cubes sind hiervon ausgenommen, da transaktionale Bereitstellungen von OLAP nicht unterstützt werden.

Hinweis

BAM-Definitionen, die auf einem Computer mit einer bestimmten Gebietsschemaeinstellung erstellt wurden, können auf einem Computer mit einer anderen Gebietsschemaeinstellung nicht bereitgestellt werden. Beispiel: Eine BAM-Definition, die mit der englischen Sprachversion von Microsoft Excel auf einem Computer mit einer englischen Gebietsschemaeinstellung generiert wurde, kann nicht auf einem Computer bereitgestellt werden, der mit einer japanischen Gebietsschemaeinstellung für Japanisch konfiguriert wurde.

Beispiele

bm.exe deploy-all -DefinitionFile:MyDef.xml  
bm.exe deploy-all -DefinitionFile:MyWorkbook.xls -Server:machine1

Befehl 'update-all'

Verwendung

bm.exe update-all -DefinitionFile:<def file>[ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter BESCHREIBUNG
DefinitionFile:<def file> Der Pfad und Name der Datei, die die Definitionen enthält, mit denen die Aktualisierung durchgeführt werden soll.
Server:<Server> Optional: Der Name des Servers, auf dem die Definitionsupdates bereitgestellt 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, in der die Definitionsupdates bereitgestellt werden sollen. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Aktualisiert bestimmte Elemente aus dem BAM-Definitions-XML. Die Datei kann eine Textdatei mit dem BAM-Definitions-XML oder eine BAM-Excel-Arbeitsmappe sein. Durch das Aktualisieren werden keine Elemente gelöscht, die nicht in der aktuellen Definitionsdatei beschrieben sind. Dabei können neue Prüfpunkte zu Aktivitäten hinzugefügt werden, jedoch keine Prüfpunkte aus bereitgestellten Aktivitäten gelöscht werden. Beim Aktualisieren können Prüfpunkte weder umbenannt noch deren Eigenschaften geändert werden.

Nachdem eine Aktivität bereitgestellt wurde, sind die Aktionen, die Sie an einer Aktivität durchführen können, eingeschränkt. Insbesondere können Sie keine Elemente aus einer Aktivität löschen. Hierfür müsste Ihr Administrator die Bereitstellung der gesamten BAM-Aktivität und Ansichtensätze zurücknehmen und diese erneut bereitstellen. Dies kann zu einer Unterbrechung der Sichtbarkeit und zu Datenverlusten führen, wenn der Administrator keine Sicherung und Wiederherstellung der Daten durchführt.

Hinweis

Sie können mit diesem Befehl keine neuen Aktivitäten zu einer vorhandenen Ansicht hinzufügen. Zum Hinzufügen einer Ansicht zu einer Aktivität müssen Sie eine neue Ansicht erstellen, die die neue Aktivität enthält. Danach können Sie die Bereitstellung der alten Ansicht zurücknehmen. Bei diesem Vorgang gehen jedoch die OLAP-Verlaufsdaten verloren.

Beispiele

bm.exe update-all -DefinitionFile:MyDef.xml  
bm.exe update-all -DefinitionFile:MyWorkbook.xls -Server:machine1

Befehl 'remove-all'

Verwendung

bm.exe definitionFile:<def file> [ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter BESCHREIBUNG
DefinitionFile:<def file> Der Pfad und Name der Datei, die die Definitionen enthält, die entfernt werden sollen.
Server:<Server> Optional: Der Name des Servers, von dem die Definitionen entfernt werden. 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, aus der die Definitionen entfernt werden. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Entfernt alle Elemente, die in der BAM-Definitions-XML-Datei angegeben sind. Die Datei kann eine Textdatei mit dem BAM-Definitions-XML oder eine BAM-Excel-Arbeitsmappe sein. Die Definition für jedes Element muss genau mit der Originaldefinition übereinstimmen, die für die Bereitstellung verwendet wurde.

Beispiele

bm.exe remove-all -DefinitionFile:MyDef.xml  
bm.exe remove-all -DefinitionFile:MyWorkbook.xls -Server:machine1

Befehl 'update-livedataworkbook'

Verwendung

bm.exe update-livedataworkbook -Name:<livedata workbook file name>[ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter BESCHREIBUNG
Name:<livedata-Arbeitsmappe> Der Name der vorhandenen Livearbeitsmappe, die aktualisiert werden soll.
Server:<Server> Optional: Der Name des Servers, auf dem sich die Arbeitsmappe befindet. 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, in der sich die Arbeitsmappe befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Aktualisiert die Verbindungsinformationen der primären BAM-Importdatenbank in der angegebenen BAM-Livedaten-Arbeitsmappe.

Hinweis

Beim Konfigurieren einer neuen Verbindungszeichenfolge muss der TDDS-Dienst neu gestartet werden, damit dieser die Änderung erkennt. Weitere Informationen zum TDDS-Dienst finden Sie unter Gespeicherte Prozeduren des BAM Event Bus-Diensts.

Beispiele

bm.exe update-livedataworkbook -Name:SalesManager_Live.xls  
bm.exe update-livedataworkbook -Name:SalesManager_Live.xls -Server:SalesSrv

Befehl 'regenerate-livedataworkbook'

Verwendung

bm.exe regenerate-livedataworkbook -WorkbookName:<livedata workbook file name>[ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter BESCHREIBUNG
WorkbookName:<livedata-Arbeitsmappendateiname> Der Name der Arbeitsmappe, die aktualisiert werden soll.
Server:<Server> Optional: Der Name des Servers, auf dem sich die Arbeitsmappe befindet. 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, in der sich die Arbeitsmappe befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Generiert eine BAM-Livedaten-Arbeitsmappe, stellt die Arbeitsmappe jedoch nicht bereit.

Beispiele

bm.exe regenerate-livedataworkbook -WorkbookName:SalesManager_Live.xls  
bm.exe regenerate-livedataworkbook -WorkbookName:SM_Live.xls -Server:S1

Weitere Informationen

BAM-Verwaltungshilfsprogramm