Requirements

The ELO Java Client requires Java Runtime Environment 8 (JRE 1.8.x) or newer. The version you require depends on the version of the ELO Java Client you are using (32-bit or 64-bit).

If the Java Runtime Environment (JRE) is not yet installed on your computer, JRE is installed by the ELO Java Client setup. You need an Internet connection to access the Oracle download server.

Alternatively, you can download and install JRE from the following URL:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

You need Windows administrator rights on the local computer to install the ELO Java Client.

Installation

1. Unzip the ELO_Java_Client_Windows.zip file.

2. Open the ELO_Java_Client_Windows folder.

3. Double-click the Setup.exe file.

Optional: If the Windows User Account Control window appears, confirm with Yes.

The Installer Language dialog box appears.

4. Choose the language for the installation and click OK in the drop-down menu.

Information: The language selection only refers to the installation. The language for the ELO Java Client user interface is set in the logon dialog box.

The ELO Java Client Setup dialog box appears.

5. Click Next.

The dialog box to select the installation directory appears.

Alternatively: Click Browse to change the suggested target directory and choose a different installation directory.

6. Click Next.

The dialog box for selecting the Start menu folder appears.

7. Change the settings as needed.

8. Click Install.

The installation starts.

Optional: If the Java installation dialog box appears, confirm with Install.

If necessary, Java is installed.

A notification message appears when the installation is complete.

9. Click Next.

A notification message indicates the progress of the installation.

10. Click Finish to complete the installation.

The ELO Java Client is fully installed.

Indexserver configuration

The ELO Java Client requires an Indexserver connection to access a repository. When you start the client for the first time, no Indexserver connection is registered yet and the ELO Indexserver dialog box appears.

Information: The ELO Indexserver also is displayed when you remove all existing Indexserver connections since at least one connection must be entered.

1. Start the client.

The ELO Indexserver dialog box appears.

2. Enter the name of the repository to the Name input field.

The name for the server connection is the same as the profile for the repository. The name is displayed during logon in the form of a repository selection and is used as the name in ELO link files.

This is why you should enter the same name for all computers. The repository name is usually used for this.

3. Enter the Indexserver URL.

Example

http://[server name]:[port]/ix-[repository name]/ix

Information: Determine the Indexserver URL with the help of the ELO Application Server Manager. Call the ELO Application Server Manager in your browser. Select the Indexserver to be used from the list of applications. You will find the associated repository name on the left.

You can also use HTTPS when the server is configured correctly.

If the URL entered was found, the color of the Indexserver URL input field switches to green.

Go to the Managing repository profiles section to learn more on how to add additional repositories or to edit an existing connection.

Optional: Logging

The ELO Java Client logger is set up via the configuration. You can configure a special logger in the registry for a more detailed log output. In this case, the logger settings in the configuration of the ELO Java Client are inactive and are not used.

1. Start the Registry Editor by entering the word regedit in the Run line.

2. Open the following directory:

HKEY_CURRENT_USER\Software\JavaSoft\Prefs\ELO Digital Office\eloenterprise

3. Create the logger entry by selecting New, String value from the context menu.

4. Enter logger as the name for the new string.

5. Enter the path to the file with the logger configuration.

Information: A default log4j.properties file is located in the installation directory of the ELO Java Client.

Warning: The storage location for the log file is defined in the log4j.properties file located in the ELO Java Client directory.

6. If you already need a log output before setting up the logger, start the EloClient.bat batch file located in the ELO Java Client installation directory.

Automated installation

You can automate the installation of the ELO Java Client. In this case, no user interaction is necessary and the installation can be performed on multiple computers at the same time. To do this, you need a Setup.ini file that contains the parameters for automated installation.

Define configuration

1. Create a file called Setup.ini that contains the following information:

Example

The following values must be entered in the Setup.ini:

• URL for the Indexserver: Enter the Indexserver URL.
• Name: This corresponds to the profile for the repository and is displayed during logon in the form of a repository selection and is used as a name in ELO link files.
• Installation directory path: Enter the path for the filing location of the ELOclient directory.
• Language codes (optional): Use this setting to determine a language for the user interface.

Information: The user can select the language for the user interface in the logon dialog box. The language of the last logon stored in the registry is always preset. If the client is started for the first time, the system language is used. You can preset a language with the language (language code) value in the Setup.ini file. This option makes sense in particular when using single sign-on (SSO) since the user in this case does not have an option to select the language.

The codes used are in accordance with ISO 8859-1.

Additional repositories

You can set up additional repositories. For a second repository, enter the required information for name 2 and repository 2, and for a third repository, the entries name 3 and repository 3, etc.

Automatic installation

1. Store the Setup.ini file in the same directory as the Setup.exe file.

2. Start the automated installation with the option "/S:".

Example

Setup.exe /S

Information: The character S must be capitalized, otherwise the installation will not start.