Upgrading fixx
If you are using the Remember Me functionality to keep you logged into fixx, please ensure you log-out of fixx before you upgrade it.
Windows
- Download the new fixx zip file and store it somewhere you can find it easily.
- Navigate to the fixx zip file.
- Extract the contents of the zip file to a new location that is different from your existing fixx installation (C:\ drive, desktop, etc). Please do not extract the zip in the same location as your old fixx installation.
- Important: Shutdown your old fixx instance. Then back-up your entire old fixx installation (either to a fixx_backup directory or to a zip file of your choice). This will allow you to restore your system to the original fixx installation if upgrade fails.
- Then copy the data directory from your old fixx installation directory to your new fixx installation directory.
- If you are using an external database (like MySQL), please back-up the entire database before you begin the upgrade.
- If you are using an external database (like MySQL), ensure you copy the database driver from /fixx/WEB-INF/lib to /fixx/WEB-INF/lib.
- If you are using fixx with an external database (like MySQL), then please copy the following files from your old installation to the new installation.
fixx/WEB-INF/classes/applicationContext-resources.xml
fixx/WEB-INF/classes/applicationContext-dao.xml
- Open the new fixx installation 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
- Download the new fixx zip file and store it somewhere you can find it easily.
- Navigate to the fixx zip file.
- Extract the contents of the zip file to a new location that is different from your existing fixx installation (C:\ drive, desktop, etc). Please do not extract the zip in the same location as your old fixx installation.
- Important: Shutdown your old fixx instance. Then back-up your entire old fixx installation (either to a fixx_backup directory or to a zip file of your choice). This will allow you to restore your system to the original fixx installation if upgrade fails.
- Then copy the data directory from your old fixx installation directory to your new fixx installation directory.
- If you are using an external database (like MySQL), please back-up the entire database before you begin the upgrade.
- If you are using an external database (like MySQL), ensure you copy the database driver from /fixx/WEB-INF/lib to /fixx/WEB-INF/lib.
- If you are using fixx with an external database (like MySQL), then please copy the following files from your old installation to the new installation.
fixx/WEB-INF/classes/applicationContext-resources.xml
fixx/WEB-INF/classes/applicationContext-dao.xml
- Make the shell scripts in the bin folder of the fixx installation executable, by running chmod +x *.sh in bin.
- Change directory to bin and 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.