meta data for this page

WebConfig

Introduction

The WebConfig application allows you to configure options of the web interface. It is possible to change the connection parameters to the PostgreSQL database, to the web server as well as to modify the trace options.

For the modifications to be taken into account by the server, the “Vigilens web server” service must be restarted.

Connection

WebConfig can be launched

  • via the Windows menu by explicitly searching for the name WebConfig
  • by its executable: <Vigilens install folder>/WebCnfg.exe

The connection is made with a user name defined by the AdminTool management menu, and this user and his group must have appropriate rights (see Access to applications).

This application is made of two tabs:

  • Server: Contains the server settings (Connection to the Vigilens Web database; Web server configuration; …)
  • Advanced log file configuration (Allows you to configure what the log file records)

Server Tab

Database for web application

It is possible to redefine the connection properties to the Vigilens database.

  • Host: IP address of the server having the database.
  • Port: Listening port of the database.
  • User: Administrator account of the Vigilens database.
  • Password: Password of the administrator account of the Vigilens database.

Web Server

The server can listen on another port than the default one and also ignore requests from other IP addresses than the specified one.
This second option can be useful if another server (apache, IIS, nginx, …) is used as a reverse proxy and you don't want to make the web server directly visible without using this reverse proxy.

  • Accepting connections from : The value 0.0.0.0 indicates that all remote IP addresses are accepted.
    The default value is: 0.0.0.0.0
  • Port Number: Port on which the server listens to incoming requests.
    Default value is: 10,000
  • It is also possible to define a directory that will contain the temporary files necessary for the operation of the website.
    When the field is empty the directory used is: C:\ProgramData\Vigilens\WebData
  • Inactivity time allows you to specify in minutes the time before a user must use the website before being automatically logged out. \ The minimum value is 1 minute and the default is 10 minutes.

The inactivity of a user is determined by the server, so the delay is calculated in relation to the last action requiring a request to the server.

Activation of the secured HTTPS protocol

The server can be used with the HTTPS protocol, to do this just check the “Enable HTTPS protocol” box. Then you have to specify the location of the files linked to the certificate to set up a secure connection.

  • Certificate: Location of the certificate file provided by a certification authority (it usually has the extension “*.crt”).
  • Private key: Location of the private key file, also provided by the certification authority (usually has the extension “*.key”).

Once these changes have been saved, restart the “Vigilens web server” service, you will now have to reach the site by typing “https:” in the browser.

Advance setup for log file tab

This tab allows you to configure certain aspects of the Vigilens WEB logging system.

  • Tracing files are only 30MB maximum, after which a new file is created.
  • The old tracing files are not automatically deleted, so please remember to clean them up regularly.
  • Tracing files are named: vigiweb-default_server–{DATECREATION}.log where the creation date is in the format “year-month-day-hour-minutes-seconds” (without dashes).

Path for log files

It is possible to choose a folder in which the logging files will be saved. When the area is empty the default directory is the application directory.

Choice of the elements to be logged

In order to limit the speed at which the trace files fill up it is possible to choose certain categories that will be logged with a certain level of criticality.

  • None: Category is not logged
  • Debug: Writes very detailed information useful for application debugging. Makes trace files huge.
  • Information: Allows to follow the general functioning of the processing. Makes trace files big.
  • Warning: Writes in the trace only the problems encountered.
  • Error: Writes in the trace only the errors that forced the stop of some treatments.
  • Fatal Error: Traces the errors that forced the program to stop or make the program inoperable.

With the exception of the level “None”, the value selected corresponds to the minimum level recorded in the trace. So if you choose the value “Warning” then all the messages of the category will be written in the trace in the levels “Warning”, “Error”, “Fatal error”.

Unless you are trying to debug a particular problem, we recommend that you set the traces to “Error” or “Warning” level.
If you do not want to generate a log file, you should set all categories to “None”.