Handbuch für OpenEstate-ImmoTool

Verzeichnisse des ImmoTool-Servers

Für den Betrieb des ImmoTool-Servers werden verschiedene Verzeichnisse auf der Festplatte verwendet.

Programm-Verzeichnis des ImmoTool-Servers

Das Programm-Verzeichnis enthält die installierten Dateien des ImmoTool-Servers.

• Unter Windows lautet das Verzeichnis standardmäßig C:\Programme\OpenEstate-ImmoServer. Bei der Installation kann jedoch bei Bedarf ein anderes Verzeichnis gewählt werden.

• Unter macOS hängt es davon ab, wohin das Programm bei der Installation kopiert wurde. Standardmäßig befindet sich das Programm-Paket unter dem Pfad /Applications/OpenEstate-ImmoServer.app. Das Programm-Verzeichnis selbst befindet sich im Unterordner Contents/Resources des Programm-Pakets.

• Wenn unter Debian, Ubuntu, Linux Mint & Co. das Debian-Paket (bzw. Debian-Repository) zur Installation verwendet wurde, wird das Programm unter /opt/OpenEstate-ImmoServer installiert.

• Wenn unter Linux das TAR.GZ-Paket zur Installation verwendet wurde, hängt es davon ab wohin Sie das entpackte Verzeichnis während der Installation verschoben haben.

Im Programm-Verzeichnis finden Sie einen Unterordner namens bin, der diverse Skripte und Programme für den ImmoTool-Server enthält.

Der ImmoTool-Server schreibt keine Dateien in das Programm-Verzeichnis. Aus diesem Verzeichnis wird nur gelesen.

Daten-Verzeichnis des ImmoTool-Servers

Im Daten-Verzeichnis speichert der ImmoTool-Server standardmäßig die verwalteten Datenbanken sowie automatisch erzeugte Datensicherungen.

• Wenn unter Debian, Ubuntu, Linux Mint & Co. das Debian-Paket (bzw. Debian-Repository) zur Installation verwendet wurde, wird das Verzeichnis /var/lib/OpenEstate-ImmoServer als Daten-Verzeichnis verwendet.

• Bei allen anderen Installationen (Windows, macOS, Linux via TAR.GZ-Paket) wird im persönlichen Benutzer-Verzeichnis des ausführenden Benutzers ein Ordner namens OpenEstate-Files erzeugt und als Daten-Verzeichnis verwendet.

Protokoll-Verzeichnis des ImmoTool-Servers

Im Protokoll-Verzeichnis speichert der ImmoTool-Server verschiedene Protokolle mit Meldungen, die während der Ausführung des Programms auftreten können.

• Wenn unter Debian, Ubuntu, Linux Mint & Co. das Debian-Paket (bzw. Debian-Repository) zur Installation verwendet wurde, wird das Verzeichnis /var/log/OpenEstate-ImmoServer als Protokoll-Verzeichnis verwendet.

• Bei allen anderen Installationen (Windows, macOS, Linux via TAR.GZ-Paket) wird der Unterordner logs im Daten-Verzeichnis des ausführenden Benutzers verwendet.

Konfigurations-Verzeichnis des ImmoTool-Servers

Aus dem Konfigurations-Verzeichnis lädt der ImmoTool-Server seine Konfigurationen.

• Unter Windows wird der Unterordner etc des Programm-Verzeichnisses als Konfigurations-Verzeichnis verwendet.

• Unter macOS wird beim ersten Programmstart im Daten-Verzeichnis des ausführenden Benutzers ein Unterordner etc erzeugt. Die Konfigurations-Dateien werden in diesen Ordner kopiert.

• Wenn unter Debian, Ubuntu, Linux Mint & Co. das Debian-Paket (bzw. Debian-Repository) zur Installation verwendet wurde, wird das Verzeichnis /etc/OpenEstate-ImmoServer als Konfigurations-Verzeichnis verwendet.

• Wenn unter Linux das TAR.GZ-Paket zur Installation verwendet wurde, werden die Konfigurationen aus dem etc Unterordner des Programm-Verzeichnisses geladen.

Verzeichnisse des ImmoTool-Servers konfigurieren

Bei Bedarf können die vom ImmoTool-Server verwendeten Verzeichnisse konfiguriert werden.

Verzeichnisse unter Linux & macOS konfigurieren

Unter Linux und macOS kann eine Datei /etc/default/OpenEstate-ImmoServer mit folgendem Inhalt angelegt werden:

# Pfad zum Konfigurations-Verzeichnis
SERVER_ETC_DIR="/etc/OpenEstate-ImmoServer"

# Pfad zum Protokoll-Verzeichnis
SERVER_LOG_DIR="/var/log/OpenEstate-ImmoServer"

# Pfad zum Daten-Verzeichnis
SERVER_VAR_DIR="/var/lib/OpenEstate-ImmoServer"

In den Variablen können die Pfade entsprechend hinterlegt werden. Beim nächsten Start des ImmoTool-Servers werden diese Verzeichnisse verwendet.

Verzeichnisse unter Windows konfigurieren

Unter Windows hängt es davon ab, wie die einzelnen Programme des ImmoTool-Servers gestartet werden.

• Falls EXE-Dateien verwendet werden, können die gleichnamigen l4j.ini Dateien mit einem Texteditor bearbeitet werden. Folgende Zeilen können darin geändert werden:

  # Pfad zum Konfigurations-Verzeichnis
  -Dopenestate.server.etcDir=D:\OpenEstate-ImmoServer\etc
      
  # Pfad zum Protokoll-Verzeichnis
  -Dopenestate.server.logDir=D:\OpenEstate-ImmoServer\logs
      
  # Pfad zum Daten-Verzeichnis
  -Dopenestate.server.varDir=D:\OpenEstate-ImmoServer
  

• Falls BAT-Dateien verwendet werden, können diese mit einem Texteditor bearbeitet werden. Folgende Zeilen können darin geändert werden:

  :: Pfad zum Konfigurations-Verzeichnis
  set "SERVER_ETC_DIR=D:\OpenEstate-ImmoServer\etc"
      
  :: Pfad zum Protokoll-Verzeichnis
  set "SERVER_LOG_DIR=D:\OpenEstate-ImmoServer\logs"
      
  :: Pfad zum Daten-Verzeichnis
  set "SERVER_VAR_DIR=D:\OpenEstate-ImmoServer"
  

• Falls ein Dienst unter Windows eingerichtet wurde, können die Pfade über die Dienst-Verwaltung angepasst werden (siehe "Dienst unter Windows verwalten").

  

  Wählen Sie in der Dienst-Verwaltung den Tab "Java" und tragen Sie im Textfeld "Java Options" die gewünschten Pfade hinter den folgenden Variablen ein:

  • Hinter -Dopenestate.server.etcDir= kann der Pfad des Konfigurations-Verzeichnisses eingetragen werden.
  • Hinter -Dopenestate.server.logDir= kann der Pfad des Protokoll-Verzeichnisses eingetragen werden.
  • Hinter -Dopenestate.server.varDir= kann der Pfad des Daten-Verzeichnisses eingetragen werden.