Handbuch für OpenEstate-ImmoTool

ImmoTool-Server installieren

Der ImmoTool-Server wird benötigt, wenn mehrere Mitarbeiter gleichzeitig auf einem gemeinsamen Datenbestand arbeiten sollen (siehe "Betrieb an mehreren Arbeitsplätzen").

Programmpaket installieren

Laden Sie die zu Ihrem Betriebssystem passende Installationsdatei für den ImmoTool-Server herunter (siehe "Programme herunterladen").

Installation unter Windows

Laden Sie die zu Ihrem Windows passende EXE-Installationsdatei herunter. Unter einem 64bit-Windows sollte möglichst auch die 64bit-Installationsdatei verwendet werden.

Öffnen Sie die heruntergeladene EXE-Datei mit einem Doppelklick. Es startet daraufhin ein Installationsprogramm, welches Sie durch die weiteren Schritte der Installation leitet.

Installation unter macOS

Laden Sie die DMG-Installationsdatei herunter und öffnen Sie die Datei durch einen Doppelklick. Es öffnet sich daraufhin ein Fenster, über welches das Programm installiert werden kann.

Ziehen Sie mit der Maus das Programmsymbol "OpenEstate-ImmoServer" in den Ordner "Applications". Sie können das Programm dann zukünftig über den Finder im Ordner "Programme" öffnen.

Alternativ können Sie das Programmsymbol auch aus dem Installationsprogramm heraus auf die Arbeitsfläche oder an eine andere beliebige Stelle auf Ihrer Festplatte ziehen.

Installation unter Debian, Ubuntu & Co.

Wenn Sie eine Debian-basierte Linux-Distribution nutzen (z.B. Debian, Ubuntu oder Linux Mint), empfehlen wir die Nutzung des Repositories (siehe "Pakete aus Debian-Repository beziehen"). Nachdem das Repository erfolgreich eingerichtet wurde, kann das Debian-Paket über folgende Befehle installiert werden:

1. Abruf der Paketliste:

   sudo apt update
   

2. Installation des ImmoTools:

   sudo apt install openestate-immoserver
   

Sollten Sie das Repository nicht nutzen wollen, können Sie alternativ das Debian-Paket (bzw. die DEB-Installationsdatei) herunterladen und per Doppelklick oder durch folgenden Befehl installieren:

sudo dpkg -i openestate-immoserver_x.y.z_amd64.deb

(Wobei x.y.z durch die jeweilige Versions-Nummer zu ersetzen ist.)

Installation unter Linux

Wenn Sie keine Debian-basierte Linux-Distribution nutzen oder das Repository nicht einbinden wollen, können Sie alternativ die TAR.GZ-Installationsdateien herunterladen. Achten Sie darauf die richtige Installationsdatei für die verwendete Prozessor-Architektur zu verwenden (meist wird x86-64 verwendet).

Nachdem Sie diese Datei auf Ihrem Rechner entpackt haben finden Sie einen Ordner namens OpenEstate-ImmoServer. Verschieben Sie diesen Ordner an eine Stelle Ihrer Wahl (z.B. ins Benutzerverzeichnis oder nach /opt/OpenEstate-ImmoServer).

ImmoTool-Server starten

Für die erste Einrichtung bietet es sich an den ImmoTool-Server von Hand zu starten.

Erst wenn das Programm soweit erfolgreich eingerichtet wurde und von den Arbeitsplätzen erfolgreich auf den ImmoTool-Server zugegriffen werden kann, empfiehlt sich im nächsten Schritt die Einrichtung eines Dienstes, sodass der ImmoTool-Server automatisch beim Hochfahren des Rechners gestartet wird (siehe "ImmoTool-Server als Dienst einrichten").

ImmoTool-Server unter Windows starten

Bei der Installation unter Windows wird automatisch im Startmenü einen Ordner namens "OpenEstate-ImmoServer" mit verschiedenen Verknüpfungen erzeugt. Wählen Sie die Verknüpfung "ImmoServer manuell starten" aus dem Startmenü aus um den ImmoTool-Server von Hand zu starten.

Darüber hinaus können Sie das Programm auch über die Datei Start.exe (bzw. Start.bat) im Unterordner bin des Programm-Verzeichnisses manuell starten.

ImmoTool-Server unter macOS starten

Führen Sie einen Doppelklick auf das Programmsymbol mit der Bezeichnung "OpenEstate-ImmoServer" aus. Es öffnet sich daraufhin der Finder mit den vom ImmoTool-Server bereitgestellten Programmen.

Wenn Sie in diesem Fenster auf das Programmsymbol "Start" klicken, wird der ImmoTool-Server manuell gestartet.

ImmoTool-Server unter Linux starten

Wenn der ImmoTool-Server mit dem Debian-Paket installiert wurde, ist auf dem Betriebssystem bereits ein Dienst für den ImmoTool-Server eingerichtet und gestartet worden. Sie müssen in diesem Falle keine weiteren Schritte durchführen um das Programm zu starten.

Bei allen Installations-Varianten für Linux kann der ImmoTool-Server über die Datei Start.sh im Unterordner bin des Programm-Verzeichnisses manuell gestartet werden.

ImmoTool-Server vorbereiten

Bevor der ImmoTool-Server genutzt werden kann, muss darauf eine Datenbank eingerichtet werden. Um diesen Schritt durchzuführen muss das AdminTool gestartet werden, welches gemeinsam mit dem ImmoTool-Paket installiert wird.

Installieren Sie dafür das ImmoTool auf dem Server-Rechner oder einem anderen Rechner in Ihrem Netzwerk (siehe "ImmoTool installieren") und starten Sie danach das AdminTool (siehe "AdminTool starten").

Im dargestellten Fenster muss die Option "Mit entfernter Datenbank verbinden (auf Server gespeichert)" gewählt werden. Danach können die Verbindungsdaten des ImmoTool-Servers eingetragen werden:

• Datenbank:
  Hier sollte die Option "HSQL.remote" gewählt werden.

• Protokoll:
  Im Normalfall muss hier "hsql" gewählt werden. Wenn eine Verschlüsselung auf dem Server eingerichtet wurde, muss hier "hsqls" gewählt werden (siehe "SSL-Verschlüsselung einrichten").

• Hostname:
  Hier muss die IP-Adresse oder der Hostname des Rechners eingetragen werden, auf dem der ImmoTool-Server betrieben wird. Wenn das AdminTool vom gleichen Rechner gestartet wurde auf dem sich auch der ImmoTool-Server befindet, kann der Hostname "localhost" unverändert bleiben.

• Port-Nr:
  Die Port-Nummer lautet standardmäßig "9001". Nur wenn im ImmoTool-Server ein anderer Wert konfiguriert wurde, muss der Standard-Wert geändert werden.

• DB-Name:
  Der Name der Datenbank lautet standardmäßig "immotool". Nur wenn im ImmoTool-Server eine Datenbank unter einem anderen Namen konfiguriert wurde, muss der Standard-Wert geändert werden.

• Benutzer:
  Der Name des Administrator-Benutzers lautet "SA" und muss in der Regel nicht geändert werden.

• Passwort:
  Beim ersten Verbindungsaufbau mit dem ImmoTool-Server ist das Passwort leer. Nachdem ein Passwort in der Datenbank hinterlegt wurde, muss dieses hier eingetragen werden.

Nach einem Klick auf "Verbinden" verbindet sich das AdminTool mit dem ImmoTool-Server.

Im ersten Schritt wird das Programm feststellen, dass der Administrator-Benutzer ("SA") noch kein Passwort zugewiesen hat und um die Eingabe eines Passwortes bitten. Notieren Sie sich dieses Passwort!

Im folgenden Schritt wird das Programm feststellen, dass die Datenbank noch nicht eingerichtet wurde. Klicken Sie im Dialogfenster "Neues Projekt erzeugen" auf "Übernehmen" um die Datenbank zur Verwendung für das ImmoTool vorzubereiten.

Nachdem diese Schritte abgeschlossen sind, können Sie bei Bedarf über das AdminTool weitere Benutzerkonten in der Datenbank anlegen (siehe "Benutzer bearbeiten").

Wenn eventuelle Nacharbeiten abgeschlossen wurden, kann das AdminTool geschlossen werden. Ab diesem Zeitpunkt können sich Anwender über das ImmoTool mit dem ImmoTool-Server verbinden.

Verbindung zum ImmoTool-Server herstellen

Nachdem der ImmoTool-Server erfolgreich vorbereitet wurde (siehe "ImmoTool-Server vorbereiten") kann über das ImmoTool auf die Datenbank zugegriffen werden.

Auf jedem Arbeitsplatz muss dafür das ImmoTool installiert werden (siehe "ImmoTool installieren"). Nach dem Programmstart (siehe "ImmoTool starten") muss ein sogenanntes Mehrplatz-Projekt angelegt werden. Öffnen Sie dafür den Projekt-Assistenten (falls dieser nicht automatisch startet via "Hauptmenü → Projekt → neues Projekt").

Folgende Einstellungen sind im Projekt-Assistenten vorzunehmen:

• Projekt-Name:
  Tragen Sie einen beliebigen Namen für das Projekt ein.

• Projekt-Art:
  Wählen Sie "Neue Verbindung zu einem Mehrplatz-Projekt erzeugen." aus.

• Datenbank:
  Hier sollte die Option "HSQL.remote" gewählt werden.

• Protokoll:
  Im Normalfall muss hier "hsql" gewählt werden. Wenn eine Verschlüsselung auf dem Server eingerichtet wurde, muss hier "hsqls" gewählt werden (siehe "SSL-Verschlüsselung einrichten").

• Hostname:
  Hier muss die IP-Adresse oder der Hostname des Rechners eingetragen werden, auf dem der ImmoTool-Server betrieben wird. Wenn das ImmoTool vom gleichen Rechner gestartet wurde auf dem sich auch der ImmoTool-Server befindet, kann der Hostname "localhost" unverändert bleiben.

• Port-Nr:
  Die Port-Nummer lautet standardmäßig "9001". Nur wenn im ImmoTool-Server ein anderer Wert konfiguriert wurde, muss der Standard-Wert geändert werden.

• DB-Name:
  Der Name der Datenbank lautet standardmäßig "immotool". Nur wenn im ImmoTool-Server eine Datenbank unter einem anderen Namen konfiguriert wurde, muss der Standard-Wert geändert werden.

• Benutzer:
  Der Name des Benutzers, der sich auf der Datenbank anmeldet. Wenn über das AdminTool weitere Benutzer angelegt wurden, kann hier dessen Login-Name eingetragen werden. Andernfalls kann der Benutzer "SA", um sich als Administrator anzumelden.

• Passwort:
  Das Passwort des Benutzers, der sich auf der Datenbank anmeldet. Wenn über das AdminTool weitere Benutzer angelegt wurden, kann hier dessen Passwort eingetragen werden. Andernfalls kann das zuvor gewählte Passwort des Benutzers "SA" verwendet werden.

Bevor das Projekt erzeugt werden kann, muss auf "Anmelden" geklickt werden. Wenn hier kein Fehler auftritt, kann das Projekt durch Klick auf "Projekt erzeugen" erzeugt werden. Das Mehrplatz-Projekt wird daraufhin erzeugt und automatisch geöffnet.

Bei zukünftigen Programmstarts kann das erzeugte Mehrplatz-Projekt im Programm geöffnet werden. Der Benutzer muss sich dann nur noch mit seinem Benutzernamen und Passwort authentifizieren.