Multiple Instances of the ADONIS NP 11.0 Web Client on a Single Machine#

If multiple instances of the ADONIS NP 11.0 web client should be run on a single machine, some adaptations have to be made. An interesting use of this scenario is that it allows you to provide access to different application libraries at the same time.

note

The steps described below are NOT necessary if you want to operate

  • different versions of the ADONIS NP web client (e.g. ADONIS NP 10.0 and ADONIS NP 11.0) or

  • web client installations of different BOC Management Office products

on a single machine. Sufficient separation of these instances is inherently provided.

Before you start, stop the Apache Tomcat web server.

Create a new deployment of ADONIS NP 11.0

You cannot run multiple instances of the ADONIS NP 11.0 Web Client from the same installation directory. Therefore:

  • Copy ADONIS NP 11.0 to a new folder.

Next, the copied instance of ADONIS NP 11.0 is adapted so that it can run on the same machine as the original instance. The below configuration steps helps you achieve this.

Adapt the Application Server

The ADONIS NP application server configuration has to be adapted:

  • Edit the configuration file server.conf in the folder "<ADONIS NP installation>/conf".

The configuration parameters that have to be adapted are listed below:

  • ports

    Enter a unique port for each ADONIS NP application server. In case of load balanced scenarios, enter a unique port for every aworker process that should be started by a ADONIS NP application server.

  • service.name

    The name under which the ADONIS NP application server is installed as a Windows service. Enter a unique service name here.

  • service.display_name

    The service display name is used, e.g., in the Service Control Manager to provide a user-readable descriptive name for the service. Enter a unique service display name here.

  • service.description

    The service description is used to describe the purpose of the installed service to the user. Enter a unique service description here.

Install ADONIS NP Application Server as a Service

Make sure that each ADONIS NP application server is run under a different Windows user account.

  • Open the Windows Command Prompt and navigate to "<ADONIS NP installation>". Notice that the installing user must have administrator rights on the target machine.

  • Type aserver.exe -i [-u username -pw password] to install the Windows Service and simultaneously assign a user under which it will run.

Install ADONIS NP Web Client

Next, you have to deploy a copy of the ADONIS NP 11.0 web application archive to the Apache Tomcat web server:

  • Rename the web application archive ADONISNP11_0.war before you copy it to the folder “<Tomcat installation>/webapps“.

Adapt the Apache Tomcat Web Server

Adapt the settings for the login procedure on the web server side:

  • Open the folder “<Tomcat installation>/webapps“ and open the file ADONISNP11_0.war with a file archiver. Edit the file adoxx_web.properties which can be found inside. Save the changes afterwards.

The configuration parameters that have to be adapted are listed below:

  • aservers

    Enter the port for the ADONIS NP application server which you specified earlier in the file server.conf.

Next, you have to adapt the configuration of the log4j logging component, so that the application messages of the ADONIS NP 11.0 web applications are logged into different files:

  • Open the folder “<Tomcat installation>/webapps“ and open the file ADONISNP11_0.war with a file archiver. Edit the file WEB-INF/classes/log4j.properties which can be found inside.

  • Rename all occurrences of ADONISNP11_0 and ADONIS NP 11.0. Save the changes afterwards.

Done! Now you can start the services and start using the web clients.