Configure ADONIS NP Application Server#

Before installing the ADONIS NP application server as a service, the configuration has to be adapted. In order to do so:

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

The most important configuration parameters are listed below. Usually it should not be necessary to change the other parameters.

  • dbname

    Alias of the database connection, e.g. an ODBC data source in case of the SQL server.

  • dbtype

    Type of the database (SQL Server or Oracle).

  • libname

    This parameter specifies the application library that is used by the ADONIS NP application server. This section is usually commented out. Only adapt this parameter if there are multiple application libraries in the ADONIS NP database. In this case, enter the language-independent name of the desired application library.

  • ports

    The application server default port. Set to "41100" by default. You only need to change this port if it is already used by other services in your environment, or to set up a load balancing configuration.

  • webtierauth.trusted_hosts (optional)

    Parameter for trusted web login. Normally this should be the IP address of the web server as it needs the trusted login on startup for transferring plugin data and icons (by default set to 127.0.0.1).

  • logging.worker.stdout

    Destination for the logging output. By default, the logging output is written to the file aworker.log in the folder "<ADONIS NP installation>/logs".

When you have adapted the configuration, you can install the ADONIS NP application server.

Install ADONIS NP Application Server as a Service#

In order to install the ADONIS NP application server as a Windows service:

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

  • Type aserver.exe -i to install the Windows Service (e.g. "ADONISNPServer11.0Service").

note

The installing user must have administrator rights on the target machine. Right-click the file "<Windows>/System32/cmd.exe", and then select Run as administrator.

Change the User Account that Runs the Windows Service#

By default, the ADONIS NP application server service is run by the local system account. If ADONIS NP has been configured to connect to a SQL Server database using Windows authentication, you have to reconfigure the service to run with a Windows account.

To change the user account:

  • Open the Services management. Press Windows+R to open the Run box, enter services.msc, and then click OK.

  • Right click the ADONIS NP application server service (service name e.g. "ADONISNPServer11.0Service"), and then click Properties.

  • In the Log on tab, select the option This account. Provide the credentials of the user under which the application server will be run, and then click OK.

Uninstall ADONIS NP Application Server#

In order to uninstall the ADONIS NP application server as a Windows service:

  • Open the Windows Command Prompt and navigate to "<ADONIS NP installation>".

  • Type aserver.exe -r to uninstall the Windows Service (e.g. "ADONISNPServer11.0Service").

  • Install ADONIS NP Application Server as a Service
  • Change the User Account that Runs the Windows Service
  • Uninstall ADONIS NP Application Server