Important notes first
After successful startup of TTraq, there will be created a standard administration user with the login data "admin" and "super" as password. Use this as the start login and administrate your own users and projects.
- There is a windows setup guid how to install Tomcat found here.
If you want to use TTraq on top of MySQL than use MySQL > 4.0.0
Binary Distribution (the short way)
Simply download the current binary WAR archive of TTraq and deploy it in your WEB container. (in Tomcat just copy it to $TOMCAT/webapps, and restart Tomcat if you don't have enabled autodeploy)
TTraq will be delivered with HSQL included, you can use any other major RDBMS if you like then prepare your prefered DBMS (database management system) and the proper access rights. Copy the JDBC driver for your DBMS in the JAVA classpath (eg. $JAVA/jre/lib/ext) or your containers classpath.
TTraq will prompt you with the importants setup questions at startup if it was not started before and will initiate the database for you. Important note: After saving the settings, these can be only reseted if you login via TTraq as an administrator and go to the Setup page or if you delete the Java preference files where TTraq did store the setup. (See FAQ for details)
Source Distribution (the long way)
The first step to install TTraq requires you to copy the build.properties file from ./etc to the project's main directory. You can do this manually or by executing 'ant prepare' instead. After that your task is to define all properties in build.properties with valid values. Each property is commented so adjusting will be easy.
The next step allows you to configure TTraq to match your needs. Therefore edit the file "src/TTraq.properties". Again the properties are documented.
Create database and tables
When the build environment is set up you have to create the database for TTraq. For most DBMS it is possible to do that task automatic by TTraq web setup. If the automatic setup fails the database schemas can be found in web/WEB-INF/classes/com/itth/ttraq/sql.
There is a file found as "src/hibernate.cfg.xml". If you did not setup TTraq for auto setup in the TTraq.properties, then you have to fill in your database connection details here. There are some samples in the file.
Compile and deploy the application
All available tasks can be found in the ant build file build.xml. The importants task are:
Deployment is supported via ant too, but is not well tested. If in doubt please deploy TTraq with the war archive.
Enter primary data
After TTraq has been deployed, startup the application and logon as the default superuser (see TTraq.properties). When your authenticity has been verified follow the 'administration' link to the admin page. With the forms on that page you can add users, projects and assignment information as you need. A note relating to the default administrator: The superuser is always created when TTraq cannot find any employee with administrator rights but is never deleted automatically. It is up to you to add another superuser and delete the default one if you wish.
Finally TTraq should be run calling the URL http://localhost:8080/ttraq. This URL can even accessed in your network with the machine name in it of course. The "8080" is the default port running Tomcat on. If you have no other web server running on your server, then you might want to change the port to "80" in the file "conf/server.xml" of your Tomcat installation. Then you can ommit the port specifiaction in your URL.