SCDB Server-side Customizations

TOC(inline)

This page describes the server-side SCDB specific tools and how to customize them. It doesn't explain how to install Quattor server and configure it for SCDB. Server-side tools consist in 2 scripts involved in configuration deployment and triggered by ant deploy.

Subversion Hook Script

This script must be installed on the Subversion server (not necessarily the Quattor server), inside the hooks directory of the SCDB repository. For this you need write access to the directory containing the repository on the Subversion server.

This script must be named post-commit and be executable. It is distributed as part of SCDB tools, inside src/hooks directory.

At the start of this script they are a couple of variables you must edit to reflect your site configuration. In particular :

• QUATTORSRV : name of your Quattor server.
• NOTIFY : email address to notify of deployment errors.
• DEPLOYSCRIPT : path where is installed the deployment script (see below).
• Command path for SVNLOOK and SSH

Deployment Script

This script is called by the hook script and does the real work by updating local copy of SCDB repository with passed tag and calling standard ant tasks.

It needs to be installed on the Quattor server and will be called through SSH by hook script (you need to configure a SSH key without password between your Subversion server and your Quattor server). The defaut location to install the script is `/root/quattor/scripts' but you can put it wherever you want as soon as you update the hook script accordingly. This script, build-tag.pl, is provided as part of SCDB tools inside src/hooks directory.

This script needs to find a file quattor.build.properties in the parent directory of SCDB local cache (generally parent directory for the script location).

In addition, it is possible to customize this script by adding a file /etc/build-tag.conf. This file must contain key/value pairs (with spaces or tabs between key and value). Supported configuration options are :