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 "51510" 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. "ADOITServer15.1Service").
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. "ADOITServer15.1Service"), 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. "ADOITServer15.1Service").