Configure ADOIT Application Server#

Before installing the ADOIT 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 "<ADOIT 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 ADOIT application server. This section is usually commented out. Only adapt this parameter if there are multiple application libraries in the ADOIT database. In this case, enter the language-independent name of the desired application library.

  • ports

    The application server default port. Set to "51200" 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 "<ADOIT installation>/logs".

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

Install ADOIT Application Server as a Service#

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

  • Open the Windows Command Prompt and navigate to "<ADOIT 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. "ADOITServer12.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 ADOIT application server service is run by the local system account. If ADOIT 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 ADOIT application server service (service name e.g. "ADOITServer12.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 ADOIT Application Server#

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

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

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

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