Requirements

You must have the following in order to run fixx:

• You must have JDK 1.5.0 installed and set up. Please note that fixx will NOT work with JDK 1.6.0 until Update 4 due to a bug in the Sun XML libraries that fixx uses. You MUST configure fixx to use JDK 1.5.0 or JDK 1.6.0 Update 4 upwards.
• Your browser must have Javascript enabled.

Installing fixx

Windows

• Download fixx and store it somewhere you can find it easily.
• Navigate to the fixx zip file
• Extract the contents of the zip file to your desired location (C:\ drive, desktop, etc). Please ensure that the path you extracted fixx into does not have any spaces in it. For example C:\Users\jamesbond\Documents\fixx is valid but C:\Users\james bond\Documents\fixx is not valid.
• If you want to use an external database with fixx, rather than the default embedded HSQLDB database, implement the steps described below before running your fixx server. Choose the database server you want to use below,

MySQL or SQL Server

• Once extracted open the folder, navigate to 'bin', and open it.
• Run startup.bat.
• Go to http://localhost:9000 to get started with painless bug tracking.

Mac OS X / Unix / Linux

Ubuntu/Linux users - Please note that fixx requires the JDK provided by Sun. Although it will run under Open JDK, image attachments require some Sun specific classes. To install the Sun-specific JDK, update your /etc/apt/sources.list to include multiverse and install sun-java6-jdk.

• Download fixx and store it somewhere you can find it easily.
• Navigate to the fixx zip file.
• Extract the contents of the zip file to your desired location. Please ensure that the path you extracted fixx into does not have any spaces in it. For example /Users/jamesbond/Documents/fixx is valid but /Users/james bond/Documents/fixx is not valid.
• If you want to use an external database with fixx, rather than the default embedded HSQLDB database, implement the steps described below before running your fixx server. Choose the database server you want to use below,

MySQL or SQL Server

• Make the shell scripts in the bin folder of the fixx installation executable, by running chmod +x *.sh in bin.
• Change directory to the bin folder. Run startup.sh.

Note: It is essential that you change your working directory to bin before you run fixx, in order for fixx to configure the right paths.

• Go to http://localhost:9000 to get started with painless bug tracking.