TrackStudio look for configuration files in the following order:
> java -Dtrackstudio.Home=c:/trackstudio <options and parameters>
> set TS_CONFIG=c:/trackstudio > java <options and parameters>
When you start a TrackStudio, following property files are loaded at startup:
|
File |
Server Manager tab |
Description |
|
trackstudio.properties |
General |
A general-purpose configuration file. |
|
trackstudio.hibernate.properties |
Database Connectivity |
Database connection configuration file. |
|
trackstudio.mail.properties |
E-Mail Notification E-Mail Submission |
E-mail notification and e-mail submission configuration file. |
|
trackstudio.ldap.properties |
LDAP Authorization |
LDAP configuration file |
|
trackstudio.license.properties |
N/A |
TrackStudio license file. You should not modify it. |
|
trackstudio.adapters.properties |
N/A |
TrackStudio adapters configuration. You should not modify it. |
|
Property |
Server Manager (General tab) |
Description |
Example |
|
trackstudio.siteURL |
HTTP port HTTPS port Host |
URL of your site. TrackStudio uses this URL to generate links (in e-mail notification messages, for example). |
http://www.mycompany.com:8080/TrackStudio |
|
trackstudio.logoutURL |
N/A |
Logout URL. The specified URL to load upon logout. If empty, goes to login screen. |
http://localhost:8888/TrackStudio |
|
trackstudio.uploadDir |
Upload directory |
Upload directory. Should exist and be accessible. We suggest you use the absolute (not relative) path here. |
/mnt/upload c:/TrackStudio/upload |
|
trackstudio.indexDir |
Index directory |
Full text search index directory. Should exist and be accessible. We suggest you use the absolute (not relative) path here. |
/mnt/index c:/TrackStudio/index |
|
trackstudio.indexMessages |
Index messages |
Index messages. |
yes |
|
trackstudio.debug |
Debug level |
Debug log level. Sets the type of log/debug messages that are sent to the log file. |
SILENT INFO DEBUG CALL |
|
trackstudio.encoding |
Character encoding |
Character encoding. Should match the codepage of the database. |
UTF-8 |
|
java.protocol.handler.pkgs |
N/A |
Handler for SSL protocol. |
com.sun.net.ssl.internal.www.protocol |
|
trackstudio.cluster |
Cluster node |
TrackStudio cluster support. |
yes no |
|
trackstudio.cluster.name |
Cluster name |
TrackStudio cluster name. |
MyCluster |
|
trackstudio.soap |
Enable SOAP |
Allowed to use SOAP interface. Enable to use SCM and IDE integration. |
yes |
|
trackstudio.maxUploadSize |
Max upload file size |
Max size for uploaded files. |
52428800 |
|
trackstudio.loginAsAnotherUser |
Enable logon as another user |
Allowed login as another user. To login as subordinate user, use their name and your password. |
yes |
|
trackstudio.skinPath |
N/A |
Skin path. |
/skins/defaultSkin |
trackstudio.hibernate.properties
|
Property |
Server Manager (Database Connectivity tab) |
Description |
Example |
|
hibernate.dialect |
Select DBMS |
SQL dialect |
net.sf.hibernate.dialect.HSQLDialect |
|
hibernate.connection.url |
URL |
JDBC connection URL |
jdbc:hsqldb:hsql://localhost |
|
hibernate.connection.driver_class |
JDBC driver |
JDBC driver class |
org.hsqldb.jdbcDriver |
|
hibernate.connection.username |
Login |
Database user |
sa |
|
hibernate.connection.password |
Password |
Database user password |
|
trackstudio.mail.properties
|
Property |
Server Manager (E-Mail Notification/Submission tabs) |
Description |
Example |
|
trackstudio.sendMail |
Enable e-mail notification |
Enable email notification |
yes no |
|
mail.transport.protocol |
Protocol |
Mail transport protocol. Should be smtp |
smtp |
|
mail.smtp.host |
SMTP server |
The SMTP server to connect to. |
127.0.0.1 |
|
mail.smtp.port |
SMTP port |
The SMTP port to connect to. |
|
|
mail.from |
TrackStudio e-mail |
This sets the envelope From address. |
trackstudio@127.0.0.1 |
|
mail.smtp.user |
SMTP server login |
SMTP user. Required only if SMTP server requires authentication |
|
|
mail.smtp.password |
SMTP server password |
SMTP password. Required only if SMTP server requires authentication |
|
|
mail.smtp.timeout |
N/A |
Socket I/O timeout value in milliseconds. Default is infinite timeout. |
10000 |
|
mail.smtp.connectiontimeout |
N/A |
Socket connection timeout value in milliseconds. Default is infinite timeout. |
10000 |
|
trackstudio.FormMailNotification |
Enable e-mail submission |
Enable e-mail submission. Enable this option with trackstudio.sendMail yes only. |
no |
|
mail.store.protocol |
Protocol |
Protocol |
pop3 imap |
|
mail.store.host |
Mail server |
POP3/IMAP host |
127.0.0.1 |
|
mail.store.port |
Mail port |
POP3/IMAP port |
|
|
mail.store.user |
Login |
Check this mailbox for email submission messages |
trackstudio@127.0.0.1 |
|
mail.store.password |
Password |
Mail server password |
ChangeMe |
|
mail.store.forward |
Delete/forward unprocessed e-mails |
Delete or forward an invalid e-mail submission messages |
yes no |
|
mail.store.fwdaddress |
Forward unprocessed e-mails to |
Forward e-mail address (when mail.store.forward yes) |
admin@mycompany.com |
|
mail.debug |
N/A |
SMTP/POP3/IMAP debug logs |
true false |
trackstudio.ldap.properties
|
Property |
Server Manager (LDAP Authorization) |
Description |
Example |
|
trackstudio.useLDAP |
Use LDAP authorization |
Specifies whether the authorization on the LDAP server is used. If the parameter is set to yes, the user authorization on the LDAP server will be performed alongside the usual authorization in the TrackStudio system. |
yes no |
|
ldap.host |
Server host |
Specifies the LDAP server address. |
192.168.22.10 |
|
ldap.port |
Server port |
Specifies the server port. |
389 |
|
ldap.baseDN |
Base DN |
Specifies the base DN. TrackStudio uses the specified DN for the user authentication. |
cn=users,dc=ldap-server,dc=my-company,dc=com |
|
ldap.userDN |
User DN |
Specifies the user DN, which is connected to the LDAP server. Objects (users, groups, computers) in the LDAP directory are referred to by the cn attribute -- the Common Name. Containers, which may contain many objects, are also referred to by the cn attribute. LDAP supports special containers -- Organizational Units and Domain Components. Part of the binding string composed of Domain Component elements is the DNS domain name. For example, the cn=TrackStudio user above is in the cn=users container, which is in the dc=ldap-server,dc=my-company,dc=com DNS domain (sometimes referred to as ldap-server.my-company.com). |
cn=TrackStudio,cn=users,dc=ldap-server,dc=my-company,dc=com |
|
ldap.userDNpass |
User DN password |
Specifies the password for the user detailed in ldap.userDN. |
|
|
ldap.loginAttrTS |
Authorize by TrackStudio properties |
Specifies which user parameters are used for authorization on the server. It shows which of the TrackStudio user parameters is authorizes on the LDAP server. |
name login |
|
ldap.loginAttrLDAP |
Authorize by LDAP properties |
Specifies the property which should be used to search the user on the LDAP server. For example, if the ldap.loginAttrLDAP is cn, the common name is used to search the user. |
displayName sAMAccountName |