| | 29 | One important design choice in QWG templates is to try as much as possible to avoid interdependencies between services to ensure the final configuration is not dependent of the order the services have been configured. This is not always possible (e.g. BDII and GIP are by design quite inter-dependent) and in this case it must be clearly documented in the templates. |
| | 30 | |
| | 31 | ''Note: QWG configuration relies heavily on global variables to customize a service configuration. It is important to ensure there is no conflict between variables used by two different services. The good practice is to prefix any variable used by a service by something identifying unambiguously the service like `WMS_`, `LB_`, `SEDPM`, `BDII`...'' |
| | 32 | |
| | 33 | === RPMs === |
| | 34 | |
| | 35 | === service.tpl === |
| | 36 | |
| | 37 | === config.tpl === |
| | 38 | |
| | 39 | === Machine type === |
| | 40 | |
| | 41 | VO config |
| | 42 | |
| | 43 | == Documenting Configuration of a gLite Service == |
| | 44 | |
| | 45 | Whether configuration for a gLite service is modified/enhanced or wether configuration for a new service is added to QWG, it is '''very important''' to document them '''immediatly''' on the [lcgqwg:wiki:WikiStart LCG QWG wiki]. There are potentially 2 places where the change/addition must be documented: |
| | 46 | * [wiki:Doc/gLite/TemplateCustomization gLite Customization]: this page is an How-To page describing configuration of a particular service. Main entries in this page are mainly high-level services, with a few exceptions like NFS, Torque/MAUI, MPI. The most important information there is the officially supported variables available to customize the service. Information is added here as soon as (sometimes a little bit before!) the new configuration is committed to trunk. |
| | 47 | * [wiki:ReleaseNotes/gLite-3.1 Release Notes]: this page is a log (in reverse chronological order) of every major change/addition to the templates. It should be a short description linking to [wiki:Doc/gLite/TemplateCustomization gLite Customization] for details. Every entry in the log starts with the version of QWG templates where the change was introduced. The version used when the entry is added, as explained in the page, is always the next version to be released : don't wait for the official release to add entries! |
| | 48 | |