Downloads > Upgrading Agilefant

We don't recommend using the Tomcat's manager application for deploying Agilefant. Instead, read the following upgrading instructions.

1. Run the Agilefant upgrader

Since the version 2.0.2, upgrading the database has been simplified. Just unzip the package and browse to the upgrade/ folder inside it. Windows users should run the agilefant_upgrader.bat, and *nix users should run the agilefant_upgrader.sh.

The script will take a database dump, but if you want to be sure, please back up your database before running the script.

Old instructions on database upgrade can be found here.

2. Changing the database user and password

Currently, there are two ways of doing this. You can use Tomcat's JNDI resources, or change the JDBC properties directly in the war package. If you are already using JNDI resources, you can skip this step.

We recommend using the JNDI resources, as the upgrading process is much easier that way.

2.1 JNDI resources

See the installation guide installation guide for help on using JNDI with Agilefant.

2.2 Inside the .war package

Steps:

1. Rename the agilefant.war file to agilefant.war.zip
2. Open the zip file and extract the file database.properties from the webapp/WEB-INF folder
3. Change the hibernate.connection.(url|username|password) fields to correspond to your database configuration
4. Overwrite the original database.properties file with the modified version
5. Compress the package as zip and name it agilefant.war

If you use Windows, the easiest way is to open the zip file in your explorer, drag the file out of the displayed folder, modify it, and drag it back.

3. Upgrade the web application

Place the new war package in your Tomcat's webapps directory and start the Tomcat server.