Die ROOTS Web Console ist gedacht für die Nutzung durch mit OSGi vertraute Administratoren und Anwendungsentwickler.
Die Konsole wird im Internet Browser gestartet:
http://<IP>:8080/system/console
Zur Änderung der Zugangsdaten wird auf das entsprechende Kapitel dieses Dokumentes verwiesen.
Die voreingestellten Login-Daten sind
Benutzername=admin
Passwort=admin
Nach der Abfrage des Benutzernamens und Passworts wird die Konsole mit der Liste der Bundles angezeigt, die durch den Start des ROOTS Servers geladen wurden:
Ein Bundle ist eine Komponente in Form eines .jar-Archives, die eigenständig im OSGi Framework installiert und ggf. gestartet werden kann.
Jedes bundle hat eine eindeutige ID, einen Name, eine Version und evtl. eine Kategorie, die Bedeutung dieser Eigenschaften geht aus dem Eigenschaftennamen hervor.
Zusätzlich wird für jedes Bundle in der Bundle Liste ein Status und vier Aktionen angezeigt:
Mögliche Stati eines Bundles sind Installed, Resolved und Fragment bzw. Starting und Active.
Tool Tip auf jedem der vier Aktionsbuttons gibt Auskunft über die Aktion:
Stoppen des Bundles (Stop Button), Aktualisieren der package Imports (Refresh Package Imports Button), ein Update des Bundles (Update Button) und Entfernen eines Bundles (Uninstall Button).
Zusätzlich wird in der Bundle Sicht die Möglichkeit geboten die Bundles neu zu laden, die Packages zu aktualisieren und ein Udate auf bestehende Bundles durchzuführen oder neue Bundles zu installieren:
Klickt man auf den Namen eines Bundles, wird eine Bundle Sicht mit weitergehenden Informationen wie z.B. importierte und exportierte Packages und verwendete und registrierte Services zu dem Bundle angezeigt:
WICHTIG
Die in der Bundles Sicht zur Verfügung stehenden OSGi spezifischen bundle-Aktionen dürfen nur von versierten Anwendungsentwicklern während der Entwicklung verwendet werden, denn sie unterwandern das ROOTS RApp deploy Konzept für Subsysteme! In einem ROOTS Produktivsystem wird von der Nutzung dieser Mechanismen auf Bundle-Ebene dringend abgeraten, da in dem Fall ein konsistenter Zustand der ROOTS RApps nicht mehr garantiert werden kann.
Folgende weitere Sichten sind in der Konsole verfügbar:
Die ROOTS Shell ermöglicht es die Konsolenkommandos für das OSGi Framework sowie für ROOTS auszuführen. Das Kommando help listet alle ausführbaren Kommandos auf.
Soll über einen anderen Port als 8080 gearbeitet werden, so ist dies über die Datei roots.conf im Verzeichnis <RootsECPServer>/system/yajsw/conf einstellbar:
Die Änderung der Zugangsdaten erfolgt in der roots.conf Konfigurationsdatei des ROOTS Servers und ist beschrieben ist im Dokument ROOTS Server beschrieben.
Die folgende Abbildung zeigt einen Ausschnitt aus der Konfigurationsdatei mit entsprechenden Konfigurationsparametern.
Die Möglichkeit der Änderung der Zugangsdaten direkt über die ROOTS Web Konsole ist in Planung.
In diesem Abschnitt werden die wichtigsten Kommandos der ROOTS Shell beschrieben.
