Der folgende Installationsleitfaden soll Ihnen die ersten Schritte mit dem ImmoTool erklären und geht auf häufige Probleme beim Programmstart ein.


I. ImmoTool herunterladen
Das ImmoTool können 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 können.
    * Hinweis: Jeder registrierte Anwender erhält kostenlos Hilfestellung von den Entwicklern. Nach erfolgter Anmeldung, verwenden Sie dafür 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 Ausführung 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 'Häufige 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, genügt 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 plattformübergreifend auf allen unterstützten 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 Umständen Java nicht korrekt installiert. Im Abschnitt 'Häufige Probleme' finden Sie weitere Hinweise.
    * Nach Ausführung 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, können auch fertige Programmarchive heruntergeladen werden. Diese Archive müssen nicht weiter installiert werden, ein einfaches Entpacken genügt.

    * 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) Verknüpfung im Startmenü (Windows / Unix)
Während des Installationsvorganges (EXE-/JAR-Installer) versucht das Programm Verknüpfungen im Startmenü Ihres Betriebssystems (Ordner 'OpenEstate') anzulegen. Über diese Verknüpfungen ist der Start des ImmoTools,  des Handbuches und die Deinstallation möglich.

(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 können. Alternativ kann auch 'ImmoTool.bat' oder 'Manual.bat' verwendet werden.

(c) Programmstart im Finder (Mac OS X)
Während des Installationsvorganges (PKG-Installer) werden keine Verknüpfungen 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 können.

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

    * (1) Programmstart unter Windows
          o Öffnen Sie die Eingabeaufforderung. (Startmenü => Ausführen => 'cmd' eingeben => OK)
          o Wechseln Sie in das Installationsverzeichnis des Programmes (standardmäßig C:\Programme\OpenEstate-ImmoTool)

            cd C:\Programme\OpenEstate-ImmoTool

          o Starten Sie das Programm durch Ausführung 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. (standardmäßig 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 ausführbar sind,

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

            können 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 vollständige Befehl mit korrekten Speicher- & Spracheinstellungen lautet:

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


IV. Häufige Probleme

(a) Die Installation bricht nach dem Entpacken ab / Das Programm startet nicht
Die warscheinlichste Ursache für 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(möglichst aktuelle Java-Laufzeitumgebung (ab Version 5) installiert ist.
          o Unter folgender Adresse können 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 ungefähr 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 erläutert Ihnen die dafür nötigen 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 müssen. 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 hinzugefügt 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.
                + Geändert werden muss die Benutzer-Variable oder System-Variable 'Path' (falls es beides gibt und man unsicher ist, die Benutzer-Variable). Man fügt 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 -> Zubehör -> Systemwerkzeuge -> Systeminformation.
                + Ein Fenster 'Microsoft Help and Support' erscheint.
                + Im Extras-Menü Systemkonfiguration wählen. Auf den Reiter Umgebung wechseln.
                + PATH wählen und auf Editieren klicken.
                + Den Pfad zum bin-Verzeichnis unterhalb des JDK-Verzeichnisses nach einem Semikolon (;) hinzufügen.
                + 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, fügt man sie hinzu:

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

                  Falls es bereits eine solche Zeile gibt, fügt 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 früheren 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 längerer Hinweis auf die korrekte Verwendung.
                + Falls man das bin-Verzeichnis unterhalb des JDK-Verzeichnisses zum PATH hinzufügen 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 eingefügt werden müssen, ist unterschiedlich.
                      # Die .bashrc im Homeverzeichnis kommt in Frage.
                      # Eine andere Möglichkeit ist, sie in eine Datei java.sh zu speichern, diese ausführbar zu machen und nach /etc/profile.d zu verschieben, sie sollte dann beim Start jeder Bash automatisch ausgeführt werden.
                      # Falls man Schwierigkeiten hat, sollte man sich an ein distributions-spezifisches Forum wenden und posten, dass man den JDK installiert hat (erläutern 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.
