Skip to main content
Version: 17.5

Web Application Installation

  1. Adapt the alias of the database connection and other important configuration parameters of the ADOIT application server in the file server.conf (see Configure ADOIT Application Server).

  2. Install the ADOIT application server as a Windows service (see Install ADOIT Application Server as a Service).

  3. Make sure Java 17/21/25 is installed on the web server by typing java -version in the Windows Command prompt. Install a new java version if necessary (see Download and Install Java Virtual Machine).

  4. Install Apache Tomcat as a Windows service (see Install Apache Tomcat as a Service):

    • Enter a value for the HTTP/1.1 Connector Port at which Apache Tomcat is accessible, e.g."8000".

    • For security reasons, the username and password for the Tomcat Manager page should be changed.

  5. Execute the file tomcat[10|11]w.exe to adapt the Apache Tomcat service settings (see Configure Tomcat Java Settings):

    • In the Java Virtual Machine box, specify the path to jvm.dll in the folder "<Java installation>\bin\server".

    • In the Java Options box, add the parameter " -Dfile.encoding=UTF-8".

    • Do NOT remove the default parameters from the Java 9 Options box.

    • Set Initial memory pool to 512MB, Maximum memory pool to at least 2048MB, and Thread stack size to 256KB.

  6. Set the encoding of Apache Tomcat to UTF-8 in the file server.xml. A preconfigured server.xml file can be found in the folder "03 Web Application" in the installation package (see Configure Tomcat's server.xml).

  7. We strongly recommend to set up the Apache Tomcat web server for use with SSL/TLS (see (Optional) Set up Apache Tomcat Web Server for use with SSL/TLS).

  8. Copy the file ADOIT17_5.war to the folder “<Tomcat installation>/webapps“ (see Install ADOIT Web Application).

  9. If necessary, adapt the settings for the login procedure on the application server side in the file adoxx_web_conf.js (see Settings for the Login Process).

  10. Adapt the settings for the login procedure on the web server side in the file adoxx_web.properties (see General Settings):

    • Enter the URL at which the ADOIT application server can be reached.

    • If necessary, adapt the other settings.

  11. Start the services (see Start Services):

    • ADOIT application server (service name e.g. "ADOITServer17.5Service")

    • Apache Tomcat web server (service name e.g. "Tomcat10")

    Now you can start using ADOIT.

  12. Optionally, you can set up a load balancing configuration to distribute workload across multiple aworker processes started by the ADOIT application server (see Set Up Load Balancing Configuration).

  13. Observe the recommendations of the security checklist (see Security Checklist).