Skip to main content
Version: 16.0

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, Oracle or PostgreSQL).

  • 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 "51600" 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".

If users need to upload 10 GB or more of documents into the database, you need to modify an additional configuration file:

  • Edit the configuration file afts_server.conf in the folder "<ADOIT installation>/conf/module".

The following parameter needs to be modified:

  • ADOXX_JCC_JVM_MAX_HEAP_SIZE

    This parameter sets the Java heap size for the full-text search engine in megabytes. Increase it from 2048 to 8192.

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

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