PDF-Mapper – Advanced Installation

To install the PDF-Mapper, proceed as described below.

Please note that for the installation and operation of the PDF-Mapper in your firewall https://service.exxtainer.com (173.249.12.23) must be enabled.

To use the support function of the PDF mapper, ftp://extranet-c.exxtainer.com (173.249.7.128) must be enabled in your firewall.

1. Download, save and unpack zip archive

1. Download the PDF-Mapper Advanced Installer

MD5 checksum for zip archive:
c9e77210d0ca7edc1095c5dac91bb6e4

2. Save the installer zip archive locally.

3. In Windows Explorer, navigate to the saved Installer zip archive. Select the entry and choose Extract All with the right mouse button…

4. Follow the instructions of the wizard and check Show extracted files when complete.

5. The next step is to check whether Java is already installed on your system or whether it still needs to be installed. Continue as described in section 2.

2. Installation with install.hta – recommended method

1. In the folder with the extracted files select start install.hta by double clicking.

A window opens and the installer searches for Java on your computer. If this is not possible, please continue as described in section 3.

2. Here you click on Run.

3. A new window opens.

If a Java version is already installed, it is displayed here. Please continue with step 6.

If no Java is installed, this can be done by clicking on the button Download Java. The browser opens on the Oracle page where Java can be downloaded.

If a Java is installed but not found by the installer, this can be done manually. To do this, click on the button Browse and navigate to the Java directory.

4. Please download Java 8 (http://java.com).

Please note the license terms of Oracle for Java 8.

Alternatively, you can also use an OpenJDK. You can find this, for example, at https://www.azul.com/downloads/zulu.

Note: The PDF-Mapper requires Java 8, a higher version such as Java 11 is currently not supported!

5. Now change to the download directory, execute the downloaded installation file and follow the instructions of the Java installer.

If Java has been installed, run the installer.hta file again (see step 1 in this section).

6. Here you can see all installed and found Java versions.

Select the desired version 8 and click on the Install button.

Alternatively, you can use the Browse button to use other Java-8 installations available on your system.

7. Now proceed with the installation of the application as described in section 4.

3. Installation via the command line with install.cmd

1.In the folder with the extracted files start install.cmd by double clicking.

A console window opens and the installer searches for Java on your computer.

2. If the installer does not find Java, the following message appears.

Confirm with No.

Otherwise, continue with step 4.

3. You will be asked to install Java and then start the installer again.

A click on OK opens your browser with the URL http://java.com/download. Follow the instructions there, install Java and start the installer again.

Please note the license terms of Oracle for Java 8.

Alternatively, you can also use an OpenJDK. You can find this, for example, at https://www.azul.com/downloads/zulu.

In the folder containing the extracted files, start install.cmd again by double-clicking (see step 1 in this section).

4. Now proceed with the installation of the application as described in section 4.

4. Installation of the PDF-Mapper Application

1. The installer unpacks itself and prepares the files for installation.

2. Start the installation of the PDF-Mapper by clicking on Next.

3. Please accept the license terms in order to continue.

4. Specify the installation directory for the software components.

Please note that the installation in Windows program directories – e.g. C:\Programme, C:\Program Files or C:\Program Files (x86) – leads to undesired behavior due to access restrictions by Windows.

Thus, we recommend to keep the default directory.

5. If the installation directory for the software components does not yet exist, please confirm with Yes.

6. Specify the Application Settings. Usually you can leave the default settings as they are.

If you do not want any entries in the Start menu, deactivate the corresponding button (not recommended). The same applies to the setting Set up service.

Note: If you deactivate the option Set up service, you must start the adapter manually via the Start menu entries or via the cmd command files after a system start!

Alternatively, you can use other operating system-specific mechanisms for automatic startup, such as Autostart or Scheduled Task in Windows.

7. The configuration mask for the Windows service only appears if the option Set up service is activated.

We recommend to select the points Install/Execute service directly only on a server machine.

If the service requires special user rights for directory access, enter the corresponding account details. You can change all of the entries made here later in the Windows system dialog to Services.

Note: You can also subsequently manage the services in the Service section of the Start menu (see → 17).

8. To perform the installation, click Install.

9. During installation, User Account Control dialogs appear in the Windows menu bar. Allow the changes by clicking Yes.

10. To complete, click OK and then click Finish.

11. Once you have created the entries in the Start menu, you can easily start (Start application) or stop (Stop application) the PDF-Mapper.

In the Service section you can manage the PDF-Mapper service.

On Windows with Metro user interface the start menu entries appear under Apps by name.

12. When starting the PDF-Mapper for the first time, it is possible that a dialog of the Windows firewall appears. Allow access.

13. Normally, when the PDF-Mapper is started, the browser is also started with the default URL http://localhost:9081/index.html.

We recommend that you save the URL in your browser favorites.

Note: If the default port 9081 is occupied, the PDF-Mapper automatically looks for the next higher free port.

14. If you want to define the ports used by PDF-Mapper yourself, you can configure this in the file app.properties.

Please also note the information in the user manual.