| | 1 | = SCDB Server-side Customizations = |
| | 2 | [[TracNav]] |
| | 3 | |
| | 4 | [[TOC(inline)]] |
| | 5 | |
| | 6 | |
| | 7 | This page describes the server-side SCDB specific tools and how to customize them. It doesn't explain how to [wiki:Download/SCDB install] Quattor server and configure it for SCDB. Server-side tools consist in 2 scripts involved in configuration deployment and triggered by `ant deploy`. |
| | 8 | |
| | 9 | |
| | 10 | == Subversion Hook Script == |
| | 11 | |
| | 12 | 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. |
| | 13 | |
| | 14 | This script must be named `post-commit` and be executable. It is distributed as part of SCDB tools, inside [source:SCDB/tags/pro/src/hooks src/hooks] directory. |
| | 15 | |
| | 16 | At the start of this script they are a couple of variables you '''must''' edit to reflect your site configuration. In particular : |
| | 17 | * `QUATTORSRV` : name of your Quattor server. |
| | 18 | * `NOTIFY` : email address to notify of deployment errors. |
| | 19 | * `DEPLOYSCRIPT` : path where is installed the deployment script (see below). |
| | 20 | * Command path for SVNLOOK and SSH |
| | 21 | |
| | 22 | == Deployment Script == |
| | 23 | |
| | 24 | 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. |
| | 25 | |
| | 26 | 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, [source:SCDB/tags/pro/src/hooks/build-tag.pl build-tag.pl], is provided as part of SCDB tools inside [source:SCDB/tags/pro/src/hooks src/hooks] directory. |
| | 27 | |
| | 28 | This script needs to find a file [source:SCDB/tags/pro/src/hooks/quattor.build.properties quattor.build.properties] in the parent directory of SCDB local cache (generally parent directory for the script location). |
| | 29 | |
| | 30 | 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 : |
| | 31 | |
