# Installation

This chapter contains information on installing the ELO Java Client.

Please note

If possible, avoid installing the ELO Java Client on Microsoft Windows server systems.

If you want to uninstall an ELO Java Client on a Windows server, follow the instructions in the Uninstalling on a Windows server system section.

# Installation with ISO file

Requirements

You will find a list of the system requirements for the ELO Java Client in the ELO system requirements (opens new window) documentation.

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

Method

There are different ways to install the ELO Java Client. The following method describes how to install ELO from the ISO file.

Start page of the ELO ECM Suite DVD with module list and tiles

  1. Select ELO Java Client under Clients.

    'ELO Java Client' page

    The ELO Java Client page opens.

  2. Select ELO Java Client Windows (64-bit).

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

    'ELO Java Client Setup' dialog box with drop-down menu for installation language

    The ELO Java Client Setup dialog box appears.

  3. Choose the language for the installation in the drop-down menu and select OK.

    Information

    The language you select only applies to the language used during the installation. The user can select the language of the ELO Java Client interface in the logon dialog box.

    'ELO Java Client Setup' dialog box

    The ELO Java Client Setup dialog box appears.

  4. Select Next.

    Product information

    The Product Features page appears.

    Optional: Select which additional components you want to install.

    The following components are available:

    • ELO Dropzone: ELO Dropzone allows users to drag and drop documents to ELO using customizable tiles.

    • ELO Print&Archive: ELO Print&Archive enables users to transfer documents via a virtual printer from a third-party program to ELO.

      Please note

      ELO Print&Archive is no longer being developed. It is nevertheless compatible with the current versions of the ELO Java Client.

    Information

    You will find additional information about these components in the ELO Dropzone (opens new window), Filing via ELO Dropzone (opens new window), and ELO Print&Archive (opens new window) documentation.

  5. Select Next.

    Select a target directory

    The Destination Folder screen appears.

    Optional: Select Change to change the suggested target folder and choose a different installation directory.

  6. Select Next.

    The Ready to install ELO Java Client screen opens.

  7. Select Install.

    The installation starts.

    A message appears when the installation is completed.

  8. Select Finish to complete the installation.

Result

The ELO Java Client is installed.

# Configure ELO Indexserver

The ELO Java Client needs to connect to an ELO Indexserver to access a repository. When you run the client for the first time, there is no ELO Indexserver connection registered and the ELO Indexserver dialog box appears.

Information

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

Method

  1. Start the client.

    'ELO Indexserver' dialog box

    The ELO Indexserver dialog box appears.

  2. Enter a name for the first profile in the Profile name field.

    The name is displayed during logon 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 normally used here.

  3. Enter the ELO Indexserver URL.

    URL example:

    http://<server name>:<port>/ix-<repository name>/ix
    

    Information

    You can find the ELO Indexserver URL in the ELO Application Server Manager. Open the ELO Application Server Manager in your browser. Select the ELO Indexserver you want to use from the list of applications. You will find the corresponding repository name on the left.

    You can also use HTTPS if the server is configured accordingly.

    If the URL you entered was found, the color of the Indexserver URL field turns to green.

  4. Select OK.

Result

The logon dialog box opens and you can log on the client.

Outlook

Go to the Create new profile section to learn 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 Windows Registry Editor (regedit).

  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

    The installation directory of the ELO Java Client contains a predefined log4j1.xml file.

    Important

    You need to specify the storage location of the log file in the log4j1.xml file in the ELO Java Client directory.

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

# ELO Java Client with additional components

Start the AIO Installer in the window 'Make AIO Installer Structure'

If you select the Installation Program for ELO Java Client (Windows) with Additional Components menu item, the Make AIO Installer Structure program opens. By default, the program selects a directory shared as ELO JC AIO Installer on the local computer. If you attempt to start copying files and the directory does not exist, you will get an error message.

Method

  1. Select a directory on the local computer or network.

  2. Select Start Copy to copy the files.

    After all files have been copied successfully, you will see the status message Copying finished.

  3. Select End and navigate to this directory in a file browser.

    You will see several files and folders in this directory that allow you to customize the installer for the ELO Java Client. Immediately after copying the files, the EloJC_AIO.exe file appears.

    'EloJC_AIO.exe' file in the directory

  4. Run the EXE file.

Result

AIO Installer start screen

The ELO ECM Suite Client Installation window opens.

This installs the ELO Java Client along with all available optional components by default.

Information

The default entries for installation directory, profile name, and ELO Indexserver URL are just examples of valid entries and usually need to be adjusted for your specific requirements.

Outlook

You can select or remove all the options in this window.

You can also modify the default settings by changing the parameters of the config.ini file. The latter option is particularly useful for network rollouts. You can find more information in the Configuration via the 'config.ini' file section.

'config.ini' file in the directory

The following is a list of possible installation options.

# Installation directory

The ELO Java Client is installed to this directory when you run the program on a local computer. You can change the default directory by specifying INSTALLDIR="<path>" as the command line parameter when you run the file.

# Profile name

This is the name of the profile that the user sees when logging on to the repository with the ELO Java Client. You can enter any name here, but it is recommended to specify a name that helps the user identify the repository they are about to use. It is recommended to specify a name that helps the user identify the repository they are about to use.

Note

The AIO Installer sets up global profile names for all users. If the same profile name already exists in the user profiles, only this name appears in the ELO Java Client profile list.

# ELO Indexserver URL

This is the URL to the ELO Indexserver for your repository. Change the default URL by altering the URL from http://server:9090/ix-database/ix to <http(s)>://<server name>:<Port>/<repository name>/ix.

Select what you want to install: The ELO OCR service performs text recognition on image files, usually from the ELO Intray. The TIFF and PDF printer options install printer drivers that allow documents to be printed from or to ELO in each of the respective output formats.

Select the programs you want to link to ELO with the macro: In this area, define which programs in Windows you want to install an ELO add-in to. The add-in provides you with additional in-program buttons that send documents directly to the ELO repository or Intray.

# Configuration via the 'config.ini' file

You can configure the AIO program via the config.ini file. This offers several options for a rollout installation with predefined values.

Please note

You can find more information on configuration in the AIO Installer directory in the Readme file. Several options are explained in this file.

# Example

Installation options after configuration via 'config.ini'

The settings shown correspond to the following values in the config.ini configuration file:

[SETTINGS]
Language=de
SilentInstallation=0
InstallationDir=%ProgramFiles%\ELO Java Client
[clients]
EloClient=1
XMX=
XMS=
SERNO_BARCODE=
Dropzone=1
Ocr=0
[REPOSITORIES]
ServerUrl_1=https://<server>:<port>/ix-EXTEN/ix
ProfileName_1=EXTEN
...
[Macros]
AllUserInstallation=0
Word=0
Excel=0
PowerPoint=0
Outlook=0
WindowsExplorer=0
Firefox=0
Chrome=0
[Printer]
PdfPrinter=1
PdfPrinterDropzone=1
PdfPrinterPrintArchive=1
TiffPrinter=1
PsConverter=1
PdfPrinterRestartSpooler=0
PdfPrinterDropzoneRestartSpooler=0
PdfPrinterPrintArchiveRestartSpooler=0
PsConverterInstaller=ELO_PS_Converter40.msi
PsConverterInstallVcRedist=0

# Uninstalling on a Windows server system section

If you install the ELO Java Client on a Windows server system with the Setup.exe in the AIO installer, a path to the *.mst file in the installation folder is created in the registry entry.

Path example: |C:\Users\Administrator\Desktop\AIO_JC_20_03_000_144\JavaClient\1031.mst

If the installation files are removed later, the client can no longer be deleted because the *.mst file is missing. You will see the following error message: "Error applying transforms".

If you install the ELO Java Client on a Windows server system with the AIO EloJC.exe file, an uninstall error also occurs if the AIO installation folder was deleted beforehand.

In these cases, you can perform one of the following steps to allow uninstallation:

  • Install the MSI package. If the ELO Java Client.msi file is executed, no Transforms entry is created that refers to the *.mst file. This allows you to uninstall independently of the installation folder.
  • Delete the registry entry with the path to the MST file.
  • Use the Microsoft program for troubleshooting installations and uninstallations. For more information, refer to the Microsoft support page (opens new window).

# Terminal server operation

It is also possible to run the ELO Java Client in a terminal server environment.

# Memory

Each instance of the Java Client is assigned 1 GB of RAM by default. This may require excessive amounts of system RAM in terminal server environments. It is possible to reduce this value to 500 MB in most environments without drawbacks.

  1. To do so, open the Windows Registry and search for ELOJavaClientw.exe.

    The registry key where this is stored also contains the parameter -Xmx1000m.

  2. Change this value to -Xmx500m.

Please note

Do not change the memory settings for the ELO Java Client without first testing performance with different document types in the actual repository. Reducing this value to less than 500 MB is not recommended.

# macOS

If you are installing the ELO Java Client on macOS, you need to consider the following information.

Please note

In rare cases, the macOS Gatekeeper prevents the execution of the ELO Java Client or functions such as PDF conversion even if a signature is valid. Apple sets a quarantine flag on the app, which can be removed with the following command:

sudo xattr -r -d com.apple.quarantine /Applications/ELOClient/ELOClient.app

# Java Runtime Environment

The ELO Java Client for macOS includes a Java Runtime Environment package. This means you don't need to install the Java Runtime Environment separately.

# Installation

The installation files are provided as a disk image file (DMG). If you downloaded the installation package from the ELO SupportWeb, the DMG file comes in a ZIP file. If you have already copied the InstallELOClient DMG file to your Mac, continue reading from the Start installation section.

# ZIP file

  1. Download the latest version of the ZIP file for macOS.

  2. Extract the ZIP file to your Mac.

The InstallELOClient DMG file is now available.

# Start installation

You can now proceed with the installation.

  1. Double-click to open the DMG file.

    'InstallELOClient' finder window

    The DMG file is executed. The InstallELOClient finder window appears.

  2. Drag the ELOClient folder to the Applications folder.

    Information

    A confirmation dialog appears if there is an update. Click Replace to confirm that you want to overwrite existing files.

    Installation starts. When installation is completed, the ELOClient folder is located in the Program files directory.

# Start the ELO Java Client

  1. Open the ELOClient folder.

  2. Double-click ELOClient.app to start the ELO Java Client.

    Configure ELO Indexserver

    The ELO Indexserver dialog box appears. If you have already entered an ELO Indexserver, the logon dialog box appears immediately.

The ELO Java Client needs to connect to an ELO Indexserver to access a repository. Learn how to establish this connection in the Configure ELO Indexserver section.

# Logging

If you want to use parameters when you start the ELO Java Client, you can do this via the terminal.

  1. Execute the following command to see which parameters you can use:

    /Applications/ELOClient/ELOClient.app/Contents/MacOS/ELOClient -h
    
  2. To run the ELO Java Client with the desired parameters, adjust the command as required.

    Example:

    /Applications/ELOClient/ELOClient.app/Contents/MacOS/ELOClient -logging DEBUG
    

# Linux

If you want to install the ELO Java Client on a Linux system, you need to consider the following information.

# Install Java

If you are using Linux, there are two different methods for installing the required Java components. Select one of the following methods.

  • Install the latest version of Oracle JDK.

OR

  • Install the latest versions of OpenJDK and OpenJFX.

# Check Java installation

To check if Java already is installed, proceed as follows:

  1. Start a terminal.

  2. Enter the following command:

    java -version

  3. Check whether the Java version is identical to or higher than the one listed in the version history.

# Install the ELO client

The installation package for Linux comes in a compressed TAR repository (TAR.GZ format).

  1. Download the latest installation package for Linux.

    Extract installation package

  2. Extract the directory to your Linux computer.

  3. Copy the folder ELOclient in the directory on your Linux computer.

    This is the installation directory of the ELO Java Client that the client is run from.

# Start the ELO Java Client

In Linux, the ELO Java Client is started with the ELOclient.sh shell script.

  1. Open the ELOClient folder.

  2. Double-click to open the ELOClient.sh file.

    Alternative: Start the shell script with the following terminal command:

    ./ELOclient.sh

    Information

    If you do not have permission to run the command, run the command sudo ./ELOclient.sh. You will be asked for the user's password.

    Configure ELO Indexserver

    The ELO Indexserver dialog box appears. If you have already entered an ELO Indexserver, the logon dialog box appears immediately.

The ELO Java Client needs to connect to an ELO Indexserver to access a repository. Learn how to establish this connection in the Configure ELO Indexserver section.

# Profile

The name of the server connection is the same as the profile for the repository. The name is displayed during logon under the available repositories and is used as the name in ELO link files.

This is why the same name must be entered for all computers. The repository name is normally used here.

# Logging

If you want to use parameters when you start the ELO Java Client, you can do this via the terminal.

  1. Execute the following command in the installation directory of the ELO Java Client to see which parameters you can use:

    ./ELOclient.sh -h

  2. To run the ELO Java Client with the desired parameters, adjust the command as required.

    Example:

    ./ELOclient.sh -logging DEBUG
    
Last updated: October 24, 2024 at 10:03 AM