The AnthillPro server and agent allow you to override the default location for the storage of a number of things. If it is necessary to override the default locations, a system property must be passed. Before overriding the default location(s), keep the following in mind:

• Storage Directory - If you change a storage directory, you are responsible for moving existing files in the directory to the new storage location.
• Upgrading - A server upgrade will overwrite the startup script and the setting will need to be added again.
• Windows Services - If running the server as a Windows service, the JAVA_OPTS (see below) in the service installer in the bin/service directory will need to be modified. Once modified, the service will need to be removed and reinstalled.
• Windows Mapped Drives - If running the server on Windows and using a mapped drive as a storage location, Windows has been known the remove the mapping almost at random due to inactivity. Furthermore, mapped drives are not available to the LOCALSYSTEM account, and a UNC path is required.

Different releases have different instructions as to which modifications need made. Find out more about that, below.

3.7.* Versions

To override the default storage location for the AnthillPro server and/or agent, modify the startup script to pass a system property.

Modify the ah3server.cmd or ah3server file

Go to the anthillpro server's \bin\ directory and open the ah3server.cmd or ah3server file (depending on which operating system you installed with) inside a smart text editor, such as vim or Notepad++. Then, locate the JAVA_OPTS line. Append properties to the end of this line, to add them to the startup script. They will need added in the following format:

-Dpropertyname="path"

A relative path can be given as the value and the relative path is calculated from the server's bin directory. A absolute path is also an option.

3.8.* Versions

To override the default storage location for the AnthillPro server and/or agent, modify the installed.properties file to pass a system property, or follow the same method as above as an alternative.

Modify the installed.properties file

Go to the anthillpro server's \conf\server directory and open the installed.properties file inside a smart text editor, such as vim or Notepad++. Then, navigate to the end of the file. Append each property you want to add here in the following format:

propertyname=path

You need to escape strings, though:

property.to.modify=C\:\\ParentDir\\ChildDir

A relative path can be given as the value and the relative path is calculated from the server's bin directory. A absolute path is also an option.

Modify the ah3server.cmd or ah3server file

Go to the anthillpro server's \bin\ directory and open the ah3server.cmd or ah3server file (depending on which operating system you installed with) inside a smart text editor, such as vim or Notepad++. Then, locate the JAVA_OPTS line. Append properties to the end of this line, to add them to the startup script. They will need added in the following format:

-Dpropertyname="path"

A relative path can be given as the value and the relative path is calculated from the server's bin directory. A absolute path is also an option.

Available Directory Overrides

The following directories can be overridden to a new location:

Server Properties

• anthill3.artifacts.dir (defaults to ../var/artifacts). Storage for files published to Codestation. This will contain all artifacts on any buildlife ever created in anthillpro.
• anthill3.codestation.dir (defaults to ../var/codestation). Storage for file in Codestation project Build Lives. This will contain all artifacts on any Codestation Buildlife ever created in anthillpro.
• anthill3.publish.dir (defaults to ../var/published). Storage for published files that are accessible under the Reports tab of the Build Life.
• anthill3.reports.dir (defaults to ../var/reports). Storage for published data files that are not accessible but used by the server.
• anthill3.mavencache.dir (defaults to ../var/mavencache). Storage for files used with the Maven dependency integration.
• anthill3.changelog.dir (defaults to ../var/changelog). Storage for data files used internally by AnthillPro for change log processing.
• anthill3.var.dir (defaults to ../var). The location of the \var\ directory.
• anthill3.logs.dir (defaults to ../var/log). Storage for logging files using the default logging configuration.
• anthill3.temp.dir (defaults to ../var/temp). Storage for temporary files that created for short-term temporary use.

Agent Properties

• anthill3.work.dir (defaults to ../work/jobs). The base directory for agent working directories.

Appendix A: Overrides and Upgrades

Click here for important information regarding directory overrides and server upgrades!