Systemdoku. Plattform: Scheduler. Dokumentenversion: bei Janek Winz

Transkript

1 Systemdoku Plattform: Scheduler Dokumentenversion: bei Janek Winz

2 Inhaltsverzeichnis KAPITEL / THEMA: SEITE: 1 Das Kyoto4u Projekt Systemanforderungen Installation Java VM Java Communications API SQL Datenbank Installation Kyoto4u Scheduler (Windows) Anpassung Datenbankeinstellungen Erzeugen der Datenbank und des Admin Kontos Einrichtung Smart Home Interfaces Starten des Schedulers Datensicherung Technische Unterstützung...14 Seite 2 von 14

3 1 Das Kyoto4u Projekt Das freie Closed-Source-Projekt Kyoto4u ist eine IT basierte Lösung zur Optimierung des Energieverbrauches von mittelständische Unternehmen, kleinen Konzernen und Privathaushalten. Unnötiger Energieverbrauch wird verhindert und der CO2-Ausstoß der Energielieferanten verringert. Eine weltweite Verbreitung von Kyoto4u wird zu maßgeblichen CO2-Einsparungen führen. 2 Systemanforderungen Kyoto4u wurde möglichst Systemressourcen schonend entwickelt, d.h. es ist möglich die Kyoto4u Plattform auf einem bereits in der Firma bestehenden Server zu installieren: der Prozessor und Speicher des Servers wird dabei kaum durch die Kyoto4u Plattform Software belastet. Bei 1-10 Kyoto4u Benutzern muss Ihr Server dabei lediglich Leistungsreserven frei haben, die ca. der Leistung eines Pentium III mit 500 MHz entsprechen. Wenn Sie einen neuen Server für diesen Zweck anschaffen möchten, können Sie ein Gerät mit Atom Prozessor anschaffen. Die Rechenleistung eines solchen verbrauchsoptimierten Systems reicht für Kyoto4u vollkommen aus. Folgende Technologien sind für den Betrieb der Kyoto4u Plattform erforderlich:

4 Software: Server: theoretisch überall, wo Java läuft, also z.b. Windows 98 Servlet- Container: Windows Vista, Windows Server, Linux und Mac OS (bislang erfolgreich getestet unter: Windows 2000 Prof. Sp4, XP SP2/SP3, Vista 32 Bit SP2, Vista 64 Bit Sp2 und Open Suse Linux 10.0 bitte andere Plattformen testen und Erfahrungen melden!) Tomcat 5.5.x VM: Java 1.50 oder neuer, (bei X10 Java Comm. API 2.0) Datenbank: MySQL 5 oder andere von Hibernate unterstützte SQL Datenbank Smart Home Netzwerke: PLC Powerline: X10 433MHz Funk: Intertechno Für das Steuern von Verbrauchern (=Geräte, die Energie verbrauchen) wird ein Smart Home Netzwerk benötigt. Derzeit unterstützt Kyoto4u das X10- und Intertechno-Protokoll. Beide Systeme erlauben eine kabellose Installation von fernsteuerbaren Relais- Modulen. Bei X10 wird die vorhandene Stromleitung zur Datenübertragung verwendet. Intertechno arbeitet per Funk im 433 MHz Band. Die Kombination beider Systeme ist möglich.

5 Beispiel einer Kyoto4u Installation: Hardware (Server): Prozessor: Taktrate: RAM: Festplatte: Bei Einsatz von X10: Einsatz von Intertechno: Intel Pentium III, vergleichbar oder besser 500MHz oder besser 512MB oder besser 1 GB frei oder besser CM11 oder CM11 USB PC Interface Allnet ALL3000RF Mk2 PC Interface

6 3 Installation 3.1 Java VM Wenn Ihr Server noch über kein installiertes Java verfügt, oder es älter als Version 1.50 (5.0) ist, laden Sie das Java Runtime Environment (JRE) Version 5.0 (oder aktueller) von herunter und installieren Sie sie auf dem Server in ein beliebiges Verzeichnis. 3.2 Java Communications API Wenn Sie das X10 System einsetzen möchten, benötigen Sie die Java Communications API 2.0 (auch wenn Sie die USB Variante des X10 Interfaces CM11 verwenden. Diese CM11 Ausführung stellt Ihnen dann einen virtuellen RS232 Port zur Verfügung). Laden Sie Java Comm. API von und installieren Sie es auf dem Server. Achtung! Fehlerquelle: vermeiden Sie es möglichst, mehrere Java VMs parallel auf dem Server zu installieren. Bei einigen Betriebsystemen ist eine VM gleich dabei! Wenn Sie JavaComm. API installieren, achten Sie darauf, dass Sie JavaComm bei der VM installieren, die für Kyoto4u verwendet wird. Andernfalls scheitert die Kommunikation mit dem PC Interface!

7 3.3 SQL Datenbank Wenn auf Ihrem Server keine Hibernate kompatible SQL Datenbank läuft, benötigen Sie eine entsprechende Datenbank. Wir empfehlen Ihnen die kostenlose SQL Datenbank MySQL Community Server 5.0. Ihr Leistungsumfang genügt den Anforderungen der Kyoto4u Plattform völlig und die Community Edition ist kostenfrei verfügbar. Sie können MySQL 5 unter herunterladen. Installieren Sie anschließend MySQL in ein beliebiges Verzeichnis und starten Sie die Datenbank. Achtung: Falls der Server über eine lokale Firewall verfügt, achten Sie darauf, dass die Kyoto4u Plattform Zugriff auf den SQL Server Port erhält. Tip: Es ist auch möglich, die SQL Datenbank auf einem anderen Server, als dem Kyoto4u Server laufen zu lassen. In dem Fall ist ebenfalls sicherzustellen, dass die Firewalls des Kyoto4u Servers und des SQL Datenbank Servers eine Kommunikation zulassen.

8 3.4 Installation Kyoto4u Scheduler (Windows) Rufen Sie das Installationsprogramm des Kyoto4u Schedulers auf. Kyoto4u Installation Bei der Installation werden Sie zum Pfad befragt, in dem der Scheduler installiert werden soll. Diesen Pfad können Sie beliebig wählen. Bitte beachten: die Datenbank muss vor dem Start des Kyoto4u Schedulers laufen!

9 3.5 Anpassung Datenbankeinstellungen Öffnen Sie die Datei hibernate.cfg.xml im Installationsverzeichnis mit einem Texteditor (z.b. Notepad unter Windows oder z.b. vi unter Linux). In dieser Datei tragen Sie den Pfad zur Datenbank, den Benutzernamen und das Passwort für den Datenbankzugriff, den Datenbankdialekt und den Datenbanktreiber der zu verwendenden Datenbank ein. Der Datenbanktreiber zu Ihrer Datenbank muß in Form einer JAR-Datei im Verzeichnis WEB-INF\lib unterhalb des Installationsverzeichnisses liegen. Hier ein Beispiel für den Einsatz mit einer MySQL Datenbank: Hibernate Konfiguration anpassen 3.6 Erzeugen der Datenbank und des Admin Kontos Wenn Sie für Kyoto4u noch keine Datenbank eingerichtet haben, installieren Sie nun die Kyoto4u Webplattform und befolgen Sie die dort im Systemhandbuch beschriebenen Schritte bezüglich der Datenbankeinrichtung.

10 3.7 Einrichtung Smart Home Interfaces Kyoto4u unterstützt derzeit die Smart Home Interfaces CM11 (Powerline X10 Module) und Allnet ALL3000RF Mk2 (Intertechno 433MHz Module). In der Datei WINZ.CFG tragen Sie die Parameter der vorhandenen Interfaces ein. Öffnen Sie die Datei mit einem Texteditor (z.b. Notepad unter Windows oder VI unter Linux): Der erste Wert gibt den Com-Port (also die serielle Schnittstelle) an, an dem ein CM11 angeschlossen ist. Bei der USB Variante des CM11 ist zwar keine reale serielle Schnittstelle vorhanden, wird aber emuliert. Wenn Sie die Nummer nicht wissen, können Sie im Gerätemanager nach schauen:

11 Tragen Sie diese Nummer dann in der WINZ.CFG ein. Standard ist COM 2. Wenn Sie keinen CM11 benutzen, spielt dieser Eintrag keine Rolle. Die 7000 bezeichnet den Port, über den der Scheduler mit den PC Clients kommuniziert. Sie können ihn hier bei Bedarf ändern. Die IP-Adresse ist die IP-Adresse des Allnet Intertechno Interfaces. Tragen Sie sie hier ein, wenn Sie dieses Interface benutzen. Speichern Sie die Datei. Falls der Scheduler schon läuft, starten Sie ihn nach Änderungen an dieser Datei neu.

12 4 Starten des Schedulers Zum Starten des Schedulers rufen Sie den Scheduler über die Verknüpfung in der Programmgruppe auf. Diese Anwendung fragt minütig die Datenbank nach anstehenden Schaltbefehlen ab und führt diese aus. Bitte beachten: die Datenbank muss vor dem Start des Schedulers laufen und korrekt eingerichtet sein! Für die Kommunikation über das Netzwerk müssen für den Scheduler der Port 7000 geöffnet sein. Im Scheduler Fenster werden Systemmeldungen ausgegeben, denen Sie keine weitere Beachtung schenken müssen. Im Fehlerfalle erhalten Sie hier aber weitere Informationen zur Ursache. Wenn Sie Support brauchen, sind diese Fehlermeldungen wichtig! Zum Beenden des Schedulers klicken Sie auf das x oben rechts in der Menüleiste.

13 5 Datensicherung Dieses Verfahren gilt nur für die Datenbank MySQL. Die Kyoto4u Datenbank befindet sich komplett im Verzeichnis \data\kyoto4u unterhalb des MySQL Verzeichnisses: Speicherort Datenbank Sichern Sie dieses Verzeichnis regelmäßig komplett auf einen externen Datenträger (z.b. DVD RAM- Medium oder USB Stick). Im Falle eines Datenbankschadens können Sie dieses Verzeichnis vom Backup- Medium zurück kopieren und haben die Datenbank wieder im Zustand vom Sicherungsdatum. Bei größeren Datenbanken sind ggf. differentielle Backupverfahren einzusetzen.

14 6 Technische Unterstützung Die Kyoto4u Software wird kostenfrei angeboten. Wenden Sie sich daher bei Fragen bitte zuerst an Ihren Systemadministrator oder geeignete Foren im Internet. Für Anregungen, konstruktive Kritik und Verbesserungsvorschläge können Sie sich wenden an: development ät kyoto4u punkt de Während der Beta-Phase können Sie auch Support über diese -Adresse erhalten. Ein Anspruch darauf besteht aber nicht! Weiterführende Informationen zu Kyoto4u erhalten Sie unter: Download: Web: bei Janek Winz