Changes between Version 24 and Version 25 of Doc/SCDB/Usage

Timestamp:

Aug 18, 2009, 8:28:21 AM (15 years ago)

Author:

/O=GRID-FR/C=FR/O=CNRS/OU=LAL/CN=Michel Jouvin

Comment:

--

Doc/SCDB/Usage

@@ -201 +201 @@
 
 The configuration options (called `properties`) available are documented at the beginning of `quattor.build.xml`. They allow to customize much of the layout used to organize and locate templates. It is recommended to avoid unnecessary changes as it may become more difficult to troubleshoot problems.
+
+== Advanced Features ==
+
+=== Management of Package Repository Templates ===
+
+Each package repository has an associated templates describing its contents. The template must be updated after any change to the package repository with the following command:
+{{{
+external/ant/bin/ant update.rep.templates
+}}}
+
+The only important information in this template are the first comments at the head of the templates. They are used to generate the locate the package repository and generate the template with the appropriate information. Theses comments look like:
+{{{
+# name = glite_3_2
+# owner = grid.support@lal.in2p3.fr
+# url = http://quattor.web.lal.in2p3.fr/packages/glite/3.2/release/
+}}}
+
+where:
+ * `name` is the internal name used in the node profile to refer to the repository. It is an arbitrary name.
+ * `url` is the URL to use to access the repository
+
+The generated template will have a namespace formed with `repository/` followed by the repository name.
+
+To create a new repository, just create a new template with the appropriate name (it must match the repository name) and add the initial comments. Then run the command to update the template.
+
+It is possible, when updating templates describing package repositories (`ant update.rep.templates`), to generate an additional template, `repository/allrepositories.tpl`, that defines the variable `ALL_REPOSITORIES`. This variable is a nlist where the key is the repository name and the value the repository information as expected by `/software/repositories`.
+
+Currently, there is no specific handling for colliding repository names (repository with the same name existing in different part of the configuration database and normally not used in the same clusters). This results in duplicated keys in `ALL_REPOSITORIES` that must be sorted out manually. Even though this is a perfectly valid configuration, you should avoid colliding repository names if you want to use this feature.
+
+To activate this feature, define property `rep.templates.allReposTemplateDir` in `quattor.build.properties` (see [#ConfiguringSCDBAntTools documentation]) as the relative directory under directory specified by property `cfg.repos`(default `cfg/`) where to create `repository/allrepositories.tpl`.