Documentation

Server installation

Dependency

Rawtask requires the Java Runtime Environment 7 (or newer) to be installed on your system. You can check your Java version using java -version

The server installation only requires to unzip the download zip file.

To start the server from command line, use : java -jar rawtask-server.jar

The first time you start the server, it will create a data directory which is used for storing attachments and the database (rawtask.h2.db).

See documentation of your operating system in order to create startup script or service if needed.

Eclipse Mylyn integration

To connect to your Rawtask server, use the Trac connector provided by Eclipse.

In the Task List view, click on the add button and select Add Repository....

Repository

Now select the Trac connector. Rawtask implements an XMLRPC interface compatible with the Trac interface.

Mylyn connector

Enter the address of your server, for example :
- https://192.168.1.100:8443/rawtask
- https://yourserver.com:8443/rawtask if you prefer use a domain name.

To configure the server on port 443 or other, see advanced configuration.

The default user is admin with admin as password.

Do not use http:// , the server only supports https:// for secutiry reason.

Repository

Validate settings and click Finish.

See the Mylyn user guide to learn of to master Mylyn.

You are now ready to use Rawtak!

Rawtask administration

Rawtak provides a web service to configures users and project related fields (components, milestones and versions).

Open your browser to : https://yourserver.com:8443/rawtask

The web server is using by default a self signed certificate, you have to accept this certificate or configure your own.

The default user is admin with admin as password.

The main page is used to add, rename or delete components, milestones and versions.

All the operations are applied instantly.

Admin page

User admin page

The user page is used to add, rename or delete users.

All the operations are applied instantly.

Advanced configuration

Change port

To change the port of the server, stop the server, edit the rawtask.properties file and restart Rawtask.

You need to uncomment (by removing #) and modify the line : #port=8443
For example, port=443

Force admin password

To force an admin password (if you lost it for example) of the server, stop the server, edit the rawtask.properties file and restart Rawtask.

You need to uncomment (by removing #) and modify the line : #admin.password=admin
For example, admin.password=mypassword

Use your own SSL certificate (to avoid warning on administration pages)

Certificates are stored in the keystore.jks file, to edit it we recommend Keystore Explorer. Use this tool to change the certificate named rawtask. Passwords for keystore and entries MUST be 'rawtask'. Stop the server before modifying the keystore.

©ILM Informatique