Apache ACE > Index > Documentation > Developer Documentation > Software Development Tools
Added by Marcel Offermans, last edited by Marcel Offermans on Jul 06, 2009  (view change)

This page contains some documentation for the tools that are part of our source base. They get deployed in the "dev-tools" deployment target.

BundleGenerator

(TODO)

RepositoryTool

This tool needs both RepositoryTool.jar and commons-cli-1.1.jar to be present in the same directory. With this tool, you can interact with repositories on (relay)servers. You can both talk to the normal repository (that allows query, checkout and commit operations) and the replication repository (that allows query, get and put operations and allows you to backup and restore whole repositories with one command).

Usage

java -jar RepositoryTool.jar

usage: RepositoryTool
 -c,--command <arg>    Command to send (query, commit, checkout, get, put,
                       backup, restore)
 -C,--customer <arg>   Customer ID
 -f,--file <arg>       File or directory
 -h,--host <arg>       Host URL of the repository
 -n,--name <arg>       Repository name
 -v,--version <arg>    Version

Apart from specifying options on the command line, you can also specify properties in a file named ".repository" which must then be found in the current directory. Properties use the long command names, and usually you specify things like the host URL, customer ID and repository name in such a file.

Examples

Query all repositories at a specific URL

java -jar RepositoryTool.jar -c query -h http://localhost:8080/

Commit a new version (assuming 2 was the last version in the repository)

java -jar RepositoryTool.jar -c commit -h http://localhost:8080/ -C luminis -n shop -v 2 -f filename

Backup a whole repository (to a local directory named backup)

java -jar RepositoryTool.jar -c backup -h http://localhost:8080/ -C luminis -n shop -f backup