Installation in general
From OpenEstate-Wiki
Inhaltsverzeichnis |
The following article describes the installation steps for OpenEstate-ImmoTool and answers the most common questions about the program start.
Install the Java Runtime Environment (JVM)
Before you start the installation of OpenEstate-ImmoTool, please make sure that the latest available Version of Java is installed on your computer.
Windows / Unix / Solaris
- Informations & Downloads for Java can be found directly at Sun / Oracle.
Mac OS X
- Use the MacOS X internal procedure for software updates (inside the Apple-menu), to check for the latest version of Java.
Linux
- As a general rule, the Linux-distributors offer ready-to-use 'Sun Java'-packages. It is recommended to install these packages.
- Debian: Install the package sun-java6-jre from the non-free repository.
- Ubuntu: Install the package sun-java6-jre from the multiverse repository.
- Arch Linux: Install the package jre6 from the Community repository.
- SUSE / openSUSE: Informations about Java-Installation at opensuse.org.
- If you have problems with a certain Linux distribution, please contact your distributor or install one of the packages provided by Sun /Oracle.
BSD
- For BSD systems, there is no official 'Sun Java' available at the moment. But it should be possible, to install the official Linux packages by Sun / Oracle and use it in the 'Linux compability mode'.
- FreeBSD: see informations about Sun Java at freebsd.org.
- NetBSD: see informations about Sun Java at netbsd.org.
- OpenBSD: see JDK-Ports at openbsd.org.
Download OpenEstate-ImmoTool
After you have been registered, you can log in to the users area. There you can request your individual license and download OpenEstate-ImmoTool for free! Every registered user may also use the ticket system, to discuss problems and ideas with the developers.
Install OpenEstate-ImmoTool
EXE-Installer for Windows
This is the easiest way to install the program in your Windows operating system.
- Start the installation process by executing the EXE file.
- The installation program should start right now and leads you through the rest of the installation process.
- Note: If the installation is cancelled after file extraction, your Java is presumably not installed correctly. Please consult the Common problems-section of this document for further information.
PKG-Installer for MacOS X
This is the easiest way to install the program in your Mac OS X operating system.
- After the download, the installation program will be extracted and started automatically.
- If the automatic startup fails, you can start the installation with a double-click on the downloaded file.
- The program will lead you through the rest of the installation process.
JAR-Installer for all operating systems
This installation program can be used platform-indenpendently with any supported operating system.
- In some cases, the installation can be started with a double-click on the JAR file.
- If the program does not start via double-click, please open your shell / console / terminal.
- Jump into the directory, where the JAR file is stored - e.g.
cd c:\downloads - Execute the following command to start the installation program:
java -jar OpenEstate-ImmoTool-0.9-Setup.jar - If a problem with special characters occurs, use the following command:
java -Dfile.encoding=ISO-8859-1 -jar OpenEstate-ImmoTool-0.9-Setup.jar - Note: If the command does not work, your Java is presumably not installed correctly. Please consult the Common problems-section of this document for further information.
- The program will lead you through the rest of the installation process.
ZIP / TAR.GZ package for all operating systems
As an alternative to the installation program, you can download a complete archive. These files just need to be extracted - no further installation steps are required.
- Extract the downloaded archive to any location on your computer.
- Use one of the startup files to execute the program.
Start OpenEstate-ImmoTool
Shortcut in the start menu at Windows and Unix
The installation program (EXE-/JAR) tries to create some entries in your start menu during installation. After installation is completed, you can find them in the folder 'OpenEstate' of your start menu. Use these shortcuts to quickly start ImmTool.
Startup via Explorer at Windows
In the programs folder (e.g. C:\Program Files\OpenEstate-ImmoTool) you can find an ImmoTool.exe and a Manual.exe. With a double-click on these files, you can start the program.
Startup via Finder at MacOS X
The installation program (PKG-Installer) does not create any shortcuts. If nothing different was specified, you can find the program in your applications-directory. Inside the folder OpenEstate-ImmoTool you can find the applications ImmoTool and Manual. Double-click on these applications to start the program.
Startup via command line / terminal at Windows, Unix & MacOS X
The program can also be started directly from command line / terminal / shell. During the execution of the program, all log messages are also written to the terminal.
Start from command line with Windows
- Open the Windows terminal (Start-menu => Run => enter 'cmd' => OK)
- Jump into the programs directory (e.g. C:\Program Files\OpenEstate-ImmoTool)
cd C:\Program Files\OpenEstate-ImmoTool - Execute the program by running one of the start files.
ImmoTool.exe
ImmoTool.bat
Manual.exe
Manual.bat
Start from command line with Unix / Mac OS X
- Open a terminal / console / shell and change to the programs directory. (by default the folder 'OpenEstate-ImmoTool' in the users home-directory)
cd ~/OpenEstate-ImmoTool - Start the programs with one of the following commands:
sh ImmoTool.sh
sh Manual.sh - If the shell-scripts are executable,
chmod +x ImmoTool.sh
chmod +x Manual.sh - ... you can also execute them directly via:
./ImmoTool.sh
./Manual.sh
Start via a direct call of the Java Runtime / JVM at all operating systems
- If you experience problems with the startup files, you can also execute the program directly with the following commands:
java -jar OpenEstate-Tool.jar - The complete command, including memory- & language-settings, is:
java -Xms32m -Xmx256m -XX:MaxPermSize=64m -Dfile.encoding=UTF-8 -jar OpenEstate-Tool.jar
Common problems
The installation is cancelled after extraction / The program does not start
The most common reason for this problem is a wrongly configured Java Runtime Environment.
Installation of Java
- Please make sure, that you have an up to date version of Java installed. In most cases it is not recommended, to do multiple installation of Java.
- At java.com you can download the latest Java release for free.
Find out, what version of Java is installed
- After the Java-Runtime was installed, you can find a entry 'Java' inside the system-control panel. Among other things you can find their the version-nr of your Java installation.
- Alternatively you can open your console / shell / terminal and enter the following command:
java -version - In case of success, something like this should be displayed:
Java(TM) SE Runtime Environment (build 1.6.0_13-b03)
Java HotSpot(TM) Server VM (build 11.3-b02, mixed mode)
Setup the path to Java runtime by hand
- Maybe the path to your Java runtime needs to be fixed. In that case, you can modify the path inside of the startup scripts (ImmoTool.sh / ImmoTool.bat).
Setup the path environment by hand
- This documentation at java.com describes the procedure of setting up the path.
