ContentsInstallation and setup

Installation with Apache Tomcat

Applies to ISPICIO_E 2.1.1.0 Last reviewed

Install Java and Apache Tomcat, deploy the ISPICIO_E web application and connect it to the PostgreSQL database.

On this page

Requirements

  • Java 25 or newer and Apache Tomcat 11 or newer for ISPICIO_E 2.1.1.0.
  • The PostgreSQL database is set up, see Set up the database.
  • The SAP system is prepared, see Preparations in SAP.
  • You have downloaded ISPICIO_E from the Downloads page and unpacked the ZIP archive. It contains the web application as the WAR file e2022.war.

The steps describe the installation on Windows. For Linux, this page only contains the file for the database connection.

Install Java

  1. Open the Adoptium page Windows MSI installer packages and click Download.

    Adoptium page Windows MSI installer packages with the Download link marked

  2. On the release page, select your operating system and, under Version, Java 25 or newer. Download the .msi file.

    Eclipse Temurin release page with the filters Operating System, Architecture, Package Type and Version

  3. Run the installer. On the Custom Setup page, enable the feature Set JAVA_HOME variable.

    Temurin setup, Custom Setup page with the feature Set JAVA_HOME variable marked

  4. Open a terminal and check the installation:

    java --version

Install Apache Tomcat

  1. Download the Windows Service Installer from the official website: Apache Tomcat 11 Software Downloads.

  2. Run the installer and click Next >.

    Welcome page of the Apache Tomcat setup

  3. On the Choose Components page, select the components. The screenshot shows the install type Normal with Start Menu Items, Documentation and Manager.

    Tomcat setup, Choose Components: install type Normal with Start Menu Items, Documentation and Manager selected

  4. On the Configuration page, specify the port in HTTP/1.1 Connector Port. The default is 8080. If you want to use the Tomcat Manager, also enter a user name and password under Tomcat Administrator Login.

    Tomcat setup, Configuration: HTTP/1.1 Connector Port 8080 marked, below it the Tomcat Administrator Login

  5. On the Java Virtual Machine page, select the folder of the Java installation from the previous section.

    Tomcat setup, Java Virtual Machine: path of the installed Java version

  6. On the last page, leave Run Apache Tomcat selected and click Finish. Tomcat starts.

    Last page of the Tomcat setup with Run Apache Tomcat selected and the Finish button

Deploy ISPICIO_E

  1. Open the folder webapps of your Tomcat installation, for example C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps.

  2. Copy the WAR file into this folder, for example by drag and drop.

    Windows Explorer with the Tomcat folder webapps; a note says to drag and drop the WAR file there

Connect to the database

ISPICIO_E reads the database connection from environment variables. You set them in a file in the Tomcat folder bin.

  1. Open the folder bin of your Tomcat installation, for example C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin.

  2. Create a new text file: right-click and choose New > Text Document.

    Windows Explorer in the Tomcat folder bin: context menu New with the entry Text Document

  3. Enter the following lines, depending on your operating system. Adapt the values to your database, in particular user and password.

    Windows:

    set ISPE_DB_HOST=localhost
    set ISPE_DB_PORT=5432
    set ISPE_DB_NAME=ispe
    set ISPE_DB_USER=postgres
    set ISPE_DB_PASSWORD=ispicio

    Linux:

    export ISPE_DB_HOST=localhost
    export ISPE_DB_PORT=5432
    export ISPE_DB_NAME=ispe
    export ISPE_DB_USER=postgres
    export ISPE_DB_PASSWORD=ispicio
  4. Save the file and change its name and file type:

    • Windows: setenv.bat
    • Linux: setenv.sh

    New file in the Tomcat folder bin while it is being renamed to a .bat file

    The file name must be exactly setenv.bat or setenv.sh.

    On Linux, the file must also be executable, see Upgrade from e2016.

  5. Restart Tomcat.

Next step

Tomcat makes the application available under the name of the WAR file. With e2022.war and port 8080, you open ISPICIO_E in the browser at localhost:8080/e2022. The first login and the setup are described in Admin.