Web Client 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 8 or 11 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 tomcat9w.exe to adapt the Apache Tomcat service settings (see Configure Apache Tomcat Web Server Service Settings):

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

    • Initial memory pool of 512MB.

    • Maximum memory pool of at least 2048MB.

    • Thread stack size of 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 Client” on the installation medium (see Configure Apache Tomcat Web Server Settings).

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

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

  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. "ADOITServer12.0Service")

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

    Now you can start using the ADOIT web client.

  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).