Once you've successfully installed a Hackystat server, you will want to upgrade it or its tool infrastructure as new releases become available. This section describes this process, which is quite easy and generally takes no more than a few minutes.
Let's assume that you followed our recommendation and have created a directory called "public_hackystat", which contains the Hackystat data directory, the Tomcat and Ant installations used for the Hackystat server, and the Hackystat binary distribution(s) themselves. This directory might look like the following:
c:\public_hackystat\
apache-ant-1.6.5\
apache-ant-1.6.5-bin.zip
apache-tomcat-5.5.12\
apache-tomcat-5.5.12.zip
hackystatdatadir\
hackystat-standard-7.0.1205\
hackystat-standard-7.0.1205.zip
In this example, you can see that we are storing user data in hackystatdatadir/, and we are currently running the release hackystat-standard-7.0.1205. Now let's say that we want to upgrade to a new release, such as hackystat-standard-7.1.1231.
Let's assume that a new stable release called hackystat-standard-7.1.123 is now available. Here's how you would install it.
Download the hackystat-standard-7.1.123.zip file, and unzip it into the public_hackystat directory.
The new directory contents might look like this:
c:\public_hackystat\
apache-ant-1.6.5\
apache-ant-1.6.5-bin.zip
apache-tomcat-5.5.12\
apache-tomcat-5.5.12.zip
hackystatdatadir\
hackystat-standard-7.0.1205\
hackystat-standard-7.0.1205.zip
hackystat-standard-7.1.123\
hackystat-standard-7.1.123.zip
Change directory to the new release and its subdirectory hackyCore_Build.
In this case, you would end up in c:\public_hackystat\hackystat-standard-7.1.123\hackyCore_Build
Invoke "ant -q hackyCore_Build.deployDist"
This updates the running Tomcat server with the new version of Hackystat.
Invoke "ant -q all.junit"
This runs all of the unit tests associated with the new release, which verifies that the installation succeeded.
If you have installed Hackystat from sources, upgrading is even easier. Simply perform an "svn update" on your hackystat svn directory, which will update the sources to the most recently committed version. Then, invoke "ant -q freshStart" to rebuild and reinstall your Hackystat server.
Occasionally, new releases of Hackystat's tool infrastructure (Java, Ant, Tomcat) become available. Here is how to do the update:
Shutdown Tomcat.
Download the new version of Java, Tomcat, or Ant.
Follow the instructions associated with the download to install it.
Update relevant environment variables as necessary.
Hackystat requires several environment variables to be defined. See Section 8.4, “Build tools installation” for details.
Update the hackystat.site.properties file.
See Section 8.5, “Hackystat system configuration” for details.
Startup Tomcat, redeploy Hackystat, and rerun the unit tests.
You should now be running the new version of Java, Tomcat, and/or Ant.