Der folgende Installationsleitfaden soll Ihnen die ersten Schritte mit dem ImmoTool erklren und geht auf hufige Probleme beim Programmstart ein.


I. ImmoTool herunterladen
Das ImmoTool knnen Sie nach erfolgter Registrierung unter http://dev.openestate.org herunterladen und gem der Nutzungsbedingungen kostenlos verwenden.

    * Hier finden Sie auch das Ticketsystem, ber welches Sie mit uns bei individuellen Fragen und Problemen Kontakt aufnehmen knnen.
    * Hinweis: Jeder registrierte Anwender erhlt kostenlos Hilfestellung von den Entwicklern. Nach erfolgter Anmeldung, verwenden Sie dafr unser Ticketsystem.


II. ImmoTool installieren

(a) EXE-Installer (Windows)
Dies ist der einfachste und empfohlene Weg zur Installation des Programmes auf Windows-Betriebssystem.

    * Starten Sie den Installationsvorgang durch Ausfhrung der EXE-Datei.
    * Das Installationsprogramm sollte starten und Sie durch den weiteren Installationsvorgang leiten.
    * Hinweis: Sollte die Installation nach dem Entpachen abbrechen, ist Java vermutlich nicht korrekt installiert.  Im Abschnitt 'Hufige Probleme' finden Sie weitere Hinweise.

(b) PKG-Installer (Mac OS X)
Dies ist der einfachste und empfohlene Weg zur Installation des Programmes auf Mac-Betriebssystem.

    * Nach dem Herunterladen, wird das Installationsprogramm in der Regel automatisch entpackt und gestartet.
    * Sollte keine automatischer Start stattfinden, gengt ein Doppelklick auf die heruntergeladene Datei um mit der Installation zu beginnen.
    * Das Installationsprogramm leitet Sie durch den weiteren Installationsvorgang.

(c) JAR-Installer (alle Betriebssysteme)
Dieses Installationsprogramm kann plattformbergreifend auf allen untersttzten Betriebssystemen verwendet werden.

    * In der Regel kann das Installationsprogramm durch Doppelklick auf die JAR-Datei gestartet werden.
    * Sollte der Start per Doppelklick nicht funktionieren, ffnen Sie eine Sie eine Eingabeaufforderung/Konsole/Terminal.
          o Wechseln Sie ggf. in das Verzeichnis, in welchem sich die heruntergeladene JAR-Datei befindet, z.B:

            cd c:\downloads

          o Zum Start der Installation geben Sie folgenden Befehl ein:

            java -jar OpenEstate-ImmoTool-0.9-Setup.jar

          o Sollte es Probleme mit der Darstellung von Sonderzeichen geben, verwenden Sie folgenden Befehl:

            java -Dfile.encoding=ISO-8859-1 -jar OpenEstate-ImmoTool-0.9-Setup.jar

          o Hinweis: Sollte der genannte Befehl nicht funktionieren, ist unter Umstnden Java nicht korrekt installiert. Im Abschnitt 'Hufige Probleme' finden Sie weitere Hinweise.
    * Nach Ausfhrung des Doppelklicks/Befehls sollte das Installationsprogramm sollte starten und Sie durch den weiteren Installationsvorgang leiten.

(d) ZIP-Archiv / TAR.GZ-Archiv (alle Betriebssysteme)
Alternativ zum Installationsprogramm, knnen auch fertige Programmarchive heruntergeladen werden. Diese Archive mssen nicht weiter installiert werden, ein einfaches Entpacken gengt.

    * Entpacken Sie das heruntergeladene Archiv an beliebiger Stelle auf Ihrem Rechner.
    * Das Programm kann mit den verschiedenen Startdateien ohne weitere Installation gestartet werden. (siehe unten)


III. ImmoTool starten

(a) Verknpfung im Startmen (Windows / Unix)
Whrend des Installationsvorganges (EXE-/JAR-Installer) versucht das Programm Verknpfungen im Startmen Ihres Betriebssystems (Ordner 'OpenEstate') anzulegen. ber diese Verknpfungen ist der Start des ImmoTools,  des Handbuches und die Deinstallation mglich.

(b) Programmstart im Explorer (Windows)
Im Installationsverzeichnis des Programmes (normalerweise C:\Programme\OpenEstate-ImmoTool) befindet sich eine 'ImmoTool.exe' und eine 'Manual.exe', die Sie mit Doppelklick starten knnen. Alternativ kann auch 'ImmoTool.bat' oder 'Manual.bat' verwendet werden.

(c) Programmstart im Finder (Mac OS X)
Whrend des Installationsvorganges (PKG-Installer) werden keine Verknpfungen erstellt. Das Programm befindet sich (wenn nicht anders angegeben) unter den installierten Programmen im Ordner 'OpenEstate-ImmoTool'. In diesem Ordner befinden sich u.a. zwei Anwendungen 'ImmoTool' und 'Manual', die durch Doppelklick gestartet werden knnen.

(d) Programmstart via Kommandozeile/Terminal (Windows / Unix / Mac OS X)
Das Programm kann auch direkt von der Kommandozeile / Terminal / Shell gestartet werden. Whrend der Ausfhrung des Programmes werden die Log-Meldungen auf dem Terminal ausgegeben.

    * (1) Programmstart unter Windows
          o ffnen Sie die Eingabeaufforderung. (Startmen => Ausfhren => 'cmd' eingeben => OK)
          o Wechseln Sie in das Installationsverzeichnis des Programmes (standardmig C:\Programme\OpenEstate-ImmoTool)

            cd C:\Programme\OpenEstate-ImmoTool

          o Starten Sie das Programm durch Ausfhrung einer der Startdateien:

            ImmoTool.exe
            ImmoTool.bat
            Manual.exe
            Manual.bat

    * (2) Programmstart unter Unix / Mac OS X
          o ffnen Sie ein Terminal (bzw. Konsole / Shell / Eingabeaufforderung) und wechseln Sie in das Programmverzeichnis. (standardmig im Home-Verzeichnis der Ordner OpenEstate-ImmoTool)

            cd ~/OpenEstate-ImmoTool

          o Starten Sie das ImmoTool / Handbuch mit folgendem Befehl:

            sh ImmoTool.sh
            sh Manual.sh

          o Wenn die Dateien ausfhrbar sind,

            chmod +x ImmoTool.sh
            chmod +x Manual.sh

            knnen Sie diese auch direkt gestartet werden mit:

            ./ImmoTool.sh
            ./Manual.sh

    * (3) Programmstart durch Direktaufruf der Java-Laufzeitumgebung / JVM (alle Betriebssysteme)
          o Bei Problemen mit den Startdateien, sollte auf jedem Betriebssystem folgender Direktaufruf das ImmoTool starten:

            java -jar OpenEstate-Tool.jar

          o Der vollstndige Befehl mit korrekten Speicher- & Spracheinstellungen lautet:

            java -Xms32m -Xmx256m -XX:MaxPermSize=64m -Dfile.encoding=UTF-8 -jar OpenEstate-Tool.jar


IV. Hufige Probleme

(a) Die Installation bricht nach dem Entpacken ab / Das Programm startet nicht
Die warscheinlichste Ursache fr dieses Problem wird sein, dass keine Java-Laufzeitumgebung installiert ist oder gefunden wurde.

    * (1) Installation von Java
          o Stellen Sie sicher, dass auf Ihrem PC eine(mglichst aktuelle Java-Laufzeitumgebung (ab Version 5) installiert ist.
          o Unter folgender Adresse knnen Sie ein aktuelles Java kostenlos herunterladen: http://java.com/de/
    * (2) Feststellen ob (und mit welcher Version) Java installiert ist
          o Unter Windows finden Sie in der Systemsteuerung einen Eintrag von Java. Unter anderem finden Sie dort auch die Versionsnummer.
          o Alternativ geben Sie folgenden Befehl in der Eingabeaufforderung / Konsole ein:

            java -version

            Im Erfolgsfall sollte ungefhr Folgendes dargestellt werden:

            Java(TM) SE Runtime Environment (build 1.6.0_13-b03)
            Java HotSpot(TM) Server VM (build 11.3-b02, mixed mode)

    * (3) Pfad zur Java-Laufzeitumgebung (JVM) von Hand einstellen
          o Der Pfad zur verwendeten JVM kann in den Startskripten (ImmoTool.sh / ImmoTool.bat) von Hand korrigiert werden.
          o Dieser Blog-Artikel erlutert Ihnen die dafr ntigen Schritte: http://www.openestate.org/2009/06/04/tipp-immotool-jvm/
    * (4) Sicherstellen, dass die Pfadvariablen korrekt gesetzt sind
          o Folgender Anleitungstext stammt aus dieser Anleitung: http://www.javaschubla.de/2007/javaerst0010.html
          o Bitte beachten Sie, dass die Verzeichnisnamen nicht mit Ihrer Installation bereinstimmen mssen. Es handelt sich lediglich um Beispiele.
          o Das bin-Verzeichnis unterhalb des JDK-Verzeichnisses, also z.B. C:\Programme\Java\jdk1.5.0_11\bin, muss zur PATH-Variable des Systems hinzugefgt werden. Die PATH-Variable sagt dem System, wo es nach Programmen suchen soll.
          o Windows NT, 2000 und XP
                + Start (-> Einstellungen) -> Systemsteuerung -> System.
                + Windows NT: Auf den Reiter 'Umgebung' wechseln.
                + Windows 2000 und XP: Auf den Reiter 'Fortgeschritten' wechseln und dann auf 'Umgebungsvariablen' klicken.
                + Gendert werden muss die Benutzer-Variable oder System-Variable 'Path' (falls es beides gibt und man unsicher ist, die Benutzer-Variable). Man fgt den Pfad zum bin-Verzeichnis unterhalb des JDK-Verzeichnisses nach einem Semikolon (;) hinzu. (Falls bereits ein Pfad zu einer lteren Java-Installation existiert, muss er entfernt werden.)
                + Ein Reboot ist nicht erforderlich, nur in bereits offenen MS-DOS-Fenstern wirkt die nderung nicht.
          o Windows ME
                + Start -> Programme -> Zubehr -> Systemwerkzeuge -> Systeminformation.
                + Ein Fenster 'Microsoft Help and Support' erscheint.
                + Im Extras-Men Systemkonfiguration whlen. Auf den Reiter Umgebung wechseln.
                + PATH whlen und auf Editieren klicken.
                + Den Pfad zum bin-Verzeichnis unterhalb des JDK-Verzeichnisses nach einem Semikolon (;) hinzufgen.
                + Speichern und rebooten.
          o Windows 95 und 98
                + Man bearbeitet die Datei C:\Windows\autoexec.bat mit Notepad.
                + Wenn es keine Zeile mit PATH am Anfang gibt, fgt man sie hinzu:

                  PATH "C:\Programme\Java\jdk1.5.0_11\bin"

                  Falls es bereits eine solche Zeile gibt, fgt man den Pfad zum bin-Verzeichnis rechts nach einem Semikolon (;) hinzu:

                  PATH "C:\WINDOWS;C:\WINDOWS\COMMAND;C:\Programme\Java\jdk1.5.0_11\bin"

                + Falls von einer frheren Java-Installation bereits ein Eintrag vorhanden ist, muss er entfernt werden.
                + Ein Reboot ist notwendig.
          o Linux
                + Unter Linux ist das ndern der PATH-Variable meist nicht erforderlich.
                + Am einfachsten probiert man aus, ob die Kommandos javac und java in der Konsole (Terminal) funktionieren, d.h. das nicht 'command not found' ausgegeben wird, sondern ein lngerer Hinweis auf die korrekte Verwendung.
                + Falls man das bin-Verzeichnis unterhalb des JDK-Verzeichnisses zum PATH hinzufgen will, geht das so:

                  JAVA_HOME=/usr/java/j2sdk1.5.0
                  export JAVA_HOME
                  PATH=$JAVA_HOME/bin:$PATH
                  export PATH

                + /usr/java/j2sdk1.5.0 ist durch das korrekte Verzeichnis zu ersetzen. Falls man es nicht findet, sollte man in /usr (evtl. auch in /opt) nach 'javac' suchen.
                + In welche Datei diese Zeilen eingefgt werden mssen, ist unterschiedlich.
                      # Die .bashrc im Homeverzeichnis kommt in Frage.
                      # Eine andere Mglichkeit ist, sie in eine Datei java.sh zu speichern, diese ausfhrbar zu machen und nach /etc/profile.d zu verschieben, sie sollte dann beim Start jeder Bash automatisch ausgefhrt werden.
                      # Falls man Schwierigkeiten hat, sollte man sich an ein distributions-spezifisches Forum wenden und posten, dass man den JDK installiert hat (erlutern wie, also ob man rpm, bin oder ein distributionseigenes Paket verwendet hat), aber beim Eingeben von javac in ein Terminal immer noch 'command not found' erscheint.
