Manual for OpenEstate-ImmoTool
Directories of ImmoTool-Server
ImmoTool-Server operates on different directories on the hard drive.
Application directory of ImmoTool-Server
The application directory contains the installed files necessary to run ImmoTool-Server.
On Windows systems the path
C:\Programme\OpenEstate-ImmoServeris used by default. But during the installation process the user might select another location.
On macOS systems it depends, where the application bundle was copied to during the installation. By default the application bundle should be located at
/Applications/OpenEstate-ImmoServer.app. The application directory itself is located inside the application bundle in the
If the Debian package (or Debian repository) was used on Debian, Ubuntu, Linux Mint or similar for installation, the application directory is located at
If the TAR.GZ package was used on Linux for installation, it depends where the extracted folder was moved to.
The application directory contains a
bin subfolder with several scripts and applications for ImmoTool-Server.
ImmoTool-Server does not write any files / data into to the application directory. It only reads from this directory.
TipIt is recommended to make sure, that regular users of the operating system only have read access to the application directory. Administrators might set appropriate permissions to this directory in order to avoid accidental modifications.
Data directory of ImmoTool-Server
All data, that is created and written by ImmoTool-Server, is stored in the data directory (e.g. databases, backups, log files).
If the Debian package (or Debian repository) was used on Debian, Ubuntu, Linux Mint or similar for installation, the data directory is located at
For all other types of installation (Windows, macOS, Linux via TAR.GZ package) the data directory is located at the subfolder
OpenEstate-Filesof the home directory by the user, who executed the application.
Protocol directory of ImmoTool-Server
The protocol directory contains log files with messages created during the execution of ImmoTool-Server.
If the Debian package (or Debian repository) was used on Debian, Ubuntu, Linux Mint or similar for installation, the protocol directory is located at
Configuration directory of ImmoTool-Server
ImmoTool-Server uses the configuration directory to load its configurations.
On Windows systems the
etcsubfolder of the application directory is used as configuration directory.
On macOS systems the application creates an
etcsubfolder in the data directory of the executing user on the first startup. The program copies its default configuration files into this folder.
If the Debian package (or Debian repository) was used on Debian, Ubuntu, Linux Mint or similar for installation, the configuration directory is located at
NoticeThe chapter "Configure ImmoTool-Server" contains further information about how to configure ImmoTool-Server for your personal needs.
Configure directories of ImmoTool-Server
It is possible to change the location of the directories used by Immotool-Server.
NoticeThe user of the operating system, who starts ImmoTool-Server, needs write permission on the protocol and data directory. For the configuration directory only read access is required.
Configure directories on Linux & macOS
On Linux and macOS systems you can create a file at
/etc/default/OpenEstate-ImmoServer with the following contents:
# path to configuration directory SERVER_ETC_DIR="/etc/OpenEstate-ImmoServer" # path to protocol directory SERVER_LOG_DIR="/var/log/OpenEstate-ImmoServer" # path to data directory SERVER_VAR_DIR="/var/lib/OpenEstate-ImmoServer"
Enter the desired path of the directories behind the variables and restart ImmoTool-Server afterwards.
Configure directories on Windows
On Windows it depends, how the individual applications provided by ImmoTool-Server are started.
If EXE files are used, you can edit the identically named
l4j.iniwith a text editor. Change the following lines in these files:
# path to configuration directory -Dopenestate.server.etcDir=D:\OpenEstate-ImmoServer\etc # path to protocol directory -Dopenestate.server.logDir=D:\OpenEstate-ImmoServer\logs # path to data directory -Dopenestate.server.varDir=D:\OpenEstate-ImmoServer
If BAT files are used, you can edit these files with a text editor. You can change the following lines:
:: path to configuration directory set "SERVER_ETC_DIR=D:\OpenEstate-ImmoServer\etc" :: path to protocol directory set "SERVER_LOG_DIR=D:\OpenEstate-ImmoServer\logs" :: path to data directory set "SERVER_VAR_DIR=D:\OpenEstate-ImmoServer"
If a service was installed on Windows, you can edit the path to the directories in the service management application (siehe "Manage service on Windows").
Open the tab "Java" in the service management application and update the values in the "Java Options" text field according to your requirements: