This page allows you to configure the Track+ system with basic parameters. The only system parameters that can not be set from this menu are those related to the database system and connection you like to use. The database type and conection URL has to be set in file Torque.properties in the WEB-INF folder of your installation.
In the following we describe the different entries on this form. The first block handles version and license key information:
System version is an entry in the database that is either empty or automatically configured by the system. This serves to check for possible incompatibilities between your database version, the last version of Track+ that used this database, and the current version.
Database version is configured when installing or upgrading the database and helps the system to check for possible version problems.
A valid license key is only necessary if you operate Track+ in a commercial environment with more than 10 active users. Otherwise this field may be empty.
All valid licenses contain an expiration date. Enter the date here that came with your commercial license.
All valid licenses define an upper limit on the number of active users in the database. Enter the number here that came with your commercial license.
The second block deals with setting up the email subsystem of Track+. A variety of configurations are possible. As a minimum, you should provide an SMTP server address to be used for sending notification emails.
Track+ system email: here you should define an email account which is being inserted as "send from" by Track+ in any email the systems sends out
Mail encoding: You need to define an email encoding that is being used by Track+ when sending out emails. You need to use the MIME names such as "UTF-8", "koi8-r", or "ISO-8859-1". For western languages, "ISO-8859-1" usually works fine.
SMTP server name: For Track+ to be able to send notifications you need to give it the name of your SMTP server. Some company internal installations do not require authentication before using the server, some do. If authentication is being used, it can be either SMTP authentication or POP before SMTP. In the first case you also have to set the SMTP user name and SMTP password described below. In the second case you have to configure the POP parameters.
SMTP Port : Default is 25. Usually, you don't have to change this.
SMTP user name : In case you SMTP server requires SMTP authentication, supply the user name here.
SMTP password : In case you SMTP server requires SMTP authentication, supply the password here.
POP server name : In case of POP before SMTP authentication, supply your POP server here.
POP port : Default is 110. You usually do not have to change this
POP user : In case of POP before SMTP authentication, supply your POP user account here.
POP password : In case of POP before SMTP authentication, supply your POP password here.
Allowed email pattern : Track+ can be configured such that users may register themselves. However, you can restrict registration to specific domains and even user email accounts, for example such that only your customers are allowed to register with the system. The pattern that is allowed to register is a Perl pattern. For detailed information have a look at the manual.
The third block deals with LDAP server setup and various other settings.
LDAP : here you can turn LDAP password handling on or off. If LDAP is turned on, Track+ uses the LDAP directory for user authentification instead of the data stored in its own database.
LDAP server URL: If LDAP is turned on, enter the server URL here.
LDAP login attribute name: Enter the LDAP login attribute name here (default: uid).
LDAP-bind DN: If searching in LDAP can by done with anonymous bind, keep this field empty. Otherwise provide the distinguished name (DN) used for searching.
LDAP-bind password: If searching in LDAP can by done with anonymous bind, keep this field empty. Otherwise provide the password for the DN you entered above.
Attachment root directory: Track+ saves attachments on the regular file system. Here you can specifiy where the attachments are being stored. It is strongly recommended to set this parameter since it makes upgrades much easier. On some application servers (e.g. JBoss) it is not even possible to leave this empty. If not set, all attachments will be stored inside the Track+ webapps directory.
Track+ Server URL: In proxied environments it is recommended to set here your absolute server URL as seen from the outside. This helps to prevent errors with pop windows such as for the attachments or the help.
Description length: This sets the length of the description field in the overview reports.
Self registration enabled: Here you can enable or disable self registration of users with the Track+ system
Is a demo site: A convenience switch if you want to set up a demo site. It prevents that user data such as email address or password can be altered.
Set Track+ From address: The emails received from the Track+ system contain as sender either the person that initiated this email, for example due to a state change, or the Track+ system account. Some SMTP server refuse to use another send from address than that used for authentification. In this case you have to have this box checked.
Graphviz Executable: The graphical display of workflows requires installation of the free Graphviz software on the server. Here you set the absolute path to the executable (called something like "dot" or "dot.exe"). The software can be obtained from http://www.graphviz.org.