runppmadmin parameters

-killsession <sessionid>

Dieser Parameter dient zur Abmeldung der Sitzung des aktuellen Benutzers. Der Parameter meldet nur die Benutzeroberflächen-Sitzungen ab. Sitzungen, die über Kommandozeilenprogramme (z. B. runppmconfig, runppmimport) gestartet wurden, können nicht abgemeldet werden.

-showusers

Gibt alle Sitzungen der zur Laufzeit im System angemeldeten Benutzer in tabellarischer Form auf der Konsole aus.

-clearcache

Löscht die im System verwendeten Caches.

-fillcache

Stößt die Berechnung der im System verwendeten Caches an. Nur Einträge, für die eine Neuberechnung aussteht, werden aktualisiert. Wenn Sie sicherstellen möchten, dass alle Favoriten neu berechnet werden, rufen Sie zuvor runppmadmin -clearcache auf.

Wenn Sie das automatische Füllen des Cache in der mandantenspezifischen Datei Keyindicator_settings.properties mit der Einstellung AUTO_FILL_CACHE=false ausgeschaltet haben, können Sie bei jeder Änderung Cache-relevanter Daten das erneute Füllen des Cache über die Kommandozeile mit den Optionen –clearcache und -fillcache anstoßen.

-clearpchistory

Der gesamte Historien-Cache von Performance Dashboard wird gelöscht.

-savepchistory

Der Inhalt des speicherbasierten Historien-Cache von Performance Dashboard wird in der Datenbank gespeichert. Bereits existierende Einträge des Cache gehen hierbei verloren.

-addpchistory

Der Inhalt des speicherbasierten Historien-Cache des Performance Dashboard wird um neu hinzugekommene Einträge erweitert. Bereits existierende Einträge des Cache bleiben erhalten.

-memoryinfo <Datei>

Folgende Informationen werden ausgegeben und in die angegebene Datei geschrieben:

Diese Informationen sind für den erfahrenen Anwender gedacht, um Optimierungspotential des Analyseservers zu erkennen.

Bei Ausführung dieses Kommandos kann es zu Wartezeiten bei der Analyse kommen, da der Analyseserver vor Ermitteln der Informationen zunächst einen internen Speicherbereinigungsprozess (Garbage Collection) ausführt, während dessen er keine Analyseanfragen beantworten kann.

Selektivität der konfigurierten Indexe

Für jeden Index wird die durchschnittliche Selektivität in Bezug auf die Abfragen angezeigt.

Die Selektivität wird individuell für jede Abfrage berechnet, in der die Dimension als Filter erscheint. Die Selektivität wird folgendermaßen berechnet:

Erwartete Anzahl an zu lesenden Process Cube-Zeilen (Prozessinstanzen), wenn die festgelegten Filterwerte dieser Dimension verwendet werden, geteilt durch die Anzahl der gesamten Zeilen, wenn nur der Prozesstypfilter verwendet wird.

In der Index-Statistik wird der Durchschnitt der Selektivität der einzelnen Abfragen pro Dimension angegeben. Zusätzlich werden die Selektivitätswerte der Dimension < 25 %, < 50 %, < 75 % und < 100 % ausgegeben. Eine geringe Selektivität nahe an 0 (oder 0 %) ist gut, da dies bedeutet, dass bei der Verwendung des Indexes nur sehr wenige Datenreihen pro Prozessinstanz geprüft werden mussten. Ohne einen Index hätte eine deutlich höhere Anzahl an Datenreihen geprüft werden müssen.

-recoveryfile force

Mit der Option -recoveryfile force erzwingen Sie die Neuerstellung der Wiederherstellungsdateien des PPM-Analyseservers, unabhängig vom Status der Servers. Für jeden Mandanten werden jeweils alle Wiederherstellungsdateien erstellt.

Die Wiederherstellungsdateien des Mandanten werden standardmäßig im Verzeichnis <Installationsverzeichnis>\ppm\server\bin\work\data_ppm\recovery\<Mandant> abgelegt.

Der Pfad zu den Wiederherstellungsdateien ist in der mandantenspezifischen Datei AnalysisServer_settings.properties durch den Schlüssel RECOVERY_FOLDER definiert.

-statisticinfo <Datei>

Gibt statistische Informationen als Ausgabe zurück und schreibt die Ausgabe in die angegebene Datei. In skalierten Systemen werden die statistischen Informationen von jedem Analyse-(Sub-)Server separat angezeigt.

Die folgenden Informationen werden als Ausgabe zurückgegeben:

Die Ausgabe zu den ersten vier Punkten ist identisch mit der Ausgabe zum Parameter -memoryinfo. Dieser Parameter unterscheidet sich vom Parameter -memoryinfo in der Hinsicht, dass er den Server nicht anweist, eine Speicherbereinigung durchzuführen und in der Ausgabe keine Informationen zur Runtime-Umgebung enthalten sind. Die Informationen zu den konfigurierten Indexen umfassen auch statistische Informationen zu den Indexen.

Die statistischen Informationen zu den Abfragen sind auch in der Ausgabe für die Analysis Engine enthalten, und zwar für alle Prozessdimensionen, für die ein Index erstellt werden kann:

- Anzahl aller Abfragen an den Analyseserver.

- Anzahl aller Abfragen an den Analyseserver mit einem Filter auf einer Prozessdimension, für die der Server einen Index erstellen kann.

- Tabelle von Abfragen zu Prozessdimensionen (die ersten vier Spalten bilden zusammen den Primärschlüssel der Tabelle):

Beachten Sie, dass in den statistischen Informationen nur Abfragen angezeigt werden, die an die Analysis Engine gesendet wurden. Abfragen, die Daten aus dem Cache verwenden, sind in den Statistiken nicht enthalten. Die statistischen Informationen werden nicht gespeichert und alle Statistiken werden nach einem Neustart des Analyseservers gelöscht.

-clearstatistic

Die auf dem Analyseserver vorhandenen Statistik-Informationen werden gelöscht. In skalierten Systemen werden die statistischen Informationen von allen Analyse-(Sub-)Servern gelöscht.