Changes between Version 127 and Version 128 of Doc/gLite/TemplateCustomization

Timestamp:

Sep 3, 2009, 12:23:59 PM (16 years ago)

Author:

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

Comment:

--

Doc/gLite/TemplateCustomization

@@ -601 +601 @@
 WN configuration is derived from CE and batch system configuration. To configure your WN for specific local requirements, use variable `WN_CONFIG_SITE`` which must be a template with all the specific actions required on your local nodes. 
 
+=== WN Profile Cloning ===
+
+QWG templates support profile cloning, a feature known as ''dummy WN'' that allows to speed up dramatically compilation of WNs. This is based on the fact that all WNs generally share the same configuration information, except for the hardware description and some parameters like network configuration.... With profile cloning, instead of compiling separately all WNs (and generally rebuild all of them when one dependency was modified, only one profile, called the ''exact node'' and used as a reference profile, is really compiled. On the other WNs, even though the source profile looks the same, the compilation is not done but instead the reference profile is included in the WN profile and a very small part of the configuration is replayed to do the actual node customization.
+
+The main variable to enable profile cloning (currently supported only for gLite WN) is `USE_DUMMY`. It is `false` by default and must be set to `true` to enable profile cloning. This variable must be defined to `true` on all WNs, including the reference one (''exact node'').
+
+To use profile cloning, in additon to enable its use, you need to define a set of variables, generally in a common profile called by all WNs. This is generally done by creating a site-specific machine type for the WN (typically in `sites/xxx/machine-types/xxx/wn`, be sure no to overload standard `machine-types/wn`) that will do all the necessary initializations and include the standard `machine-types/wn`. 
+
+The variables you need to define for profile cloning to work are:
+{{{
+# Prefix of template names for all profiles. When using the old naming convention `profile_xxx`, define to `profile_`
+variable PROFILE_PREFIX ?= '';
+# Name of the reference profile (string after PROFILE_PREFIX in its profile name)
+variable EXACT_NODE ?= 'grid100';
+# Regexp (perl compatible) matching the node name part of profile names of eligible nodes
+variable NODE_REGEXP ?= 'grid.*';
+# Variable pointing to some site-specific templates. Customize to match your configuration.
+variable SITE_DATABASES ?= 'site/databases';
+variable GLOBAL_VARIABLES ?= 'site/global_variables';
+variable SITE_FUNCTION ?= 'site/functions';
+variable SITE_CONFIG ?= 'site/config';
+variable FILESYSTEM_CONFIG_SITE ?= "filesystem/config";
+variable GLITE_SITE_PARAMS ?= "site/glite/config";
+}}}
+
 == SE Configuration ==