/monitor web application

Start

To install service.monitor, follow the steps below:

  1. Optionally, you can first adjust the name of the WAR file monitor.war.

  2. Make sure that the Tomcat service is started.

  3. Then copy the WAR file into the %TOMCAT%\webapps folder. The file will now be unpacked automatically.

    Alternatively, you can use the Tomcat Manager to install the WAR file. If the Tomcat service is started, you can usually reach the Tomcat Manager at http://<yourserver>:8080/manager/html.

  4. When Tomcat unpacks the file, it will then attempt to start the web application. Due to missing configuration this initial start will fail.

Create data directory location

  1. Create a folder on the system that is going to contain the customised configuration values and is referred to below as data.directory. Within the new folder, also create a folder called license.

  2. Copy the %TOMCAT%\webapps\monitor\WEB-INF\classes\application.properties file to data.directory.

  3. In the %TOMCAT%\webapps\monitor\WEB-INF\classes\custom-application.properties file, change the configuration value from data.directory.location to the newly created folder data.directory.

Specify licence file

Copy the licence file to data.directory\license. The validity of the licence file is checked when the servlet container is started.

If you are not in possession of a licence file, please contact the con terra Support.

Configuring application.properties

All changes that need to be adjusted to the installation system or infrastructure are made in the application.properties file in the data.directory.

You need to adjust the following parameters. See the Common configuration page for an overview of the most commonly used parameters.

Internal account

security.user.admin.pw

Password for the internal default account monitor.

It is strongly recommended to set a new password for the internal default account monitor for operation. This is part of the built-in authentication procedure, which is the default after installation. A new password hash can be generated using the script resources\tools\createPassword.bat or resources\tools\createPassword.sh from the command line. The call is createPassword.bat SHA-512 <password>. Copy the output value of the tool into the file as a configuration value.

Public base URL

basehost.url

The public base URL for external communication without the context name.

Please also make sure to specify the correct protocol, e.g. https://[public.domain.tld].

Database connection

db.use

Specifies whether a direct database connection (JDBC) or a container-managed database connection (JNDI) is established.

In the case of JDBC, the other parameters described here must be configured. In the case of JNDI, follow the section JNDI.

Allowed Values: jdbc, jndi

db.type

Type of database.

Allowed Values: postgresql, oracle, oracle10, sqlserver

db.jdbc.url

Database connection URL.

db.jdbc.username

Name of db user.

db.jdbc.password

Password of db user.

Mail server

mailing.host

Mail server host.

mailing.port

Mail server port.

mailing.user

Name of SMTP user.

mailing.password

Password of SMTP user.

mailing.sender

Sender address.