Changes between Version 15 and Version 16 of Download/QWGTemplates/Install


Ignore:
Timestamp:
Apr 15, 2014, 8:09:46 PM (10 years ago)
Author:
/C=FR/O=CNRS/OU=UMR8607/CN=Michel Jouvin/emailAddress=jouvin@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Download/QWGTemplates/Install

    v15 v16  
    44[[TOC(inline)]]
    55
    6 ''Note : QWG templates are intended to work both with original CVS-based CDB and the new Subversion-based [wiki:Doc/SCDB SCDB]. But their integration has been tested mainly with SCDB and tools described here applies mainly to SCDB. Report any problem you could encounter with original CDB.''
     6''Note : QWG templates are intended to work both with [wiki:Doc/SCDB SCDB] and [wiki:Doc/Aquilon Aquilon]. But their integration has been tested mainly with SCDB and tools described here applies mainly to SCDB. Report every issue that you find on [http://github.com/quattor GitHub].''
    77
    88
     
    1515If you are using the recommended [wiki:Doc/TemplateCustom template layout] with separate areas for standard templates in your configuration database, upgrading should be no more than replacing the previous version of the templates.
    1616
    17 We do our best to ensure that new versions are backward compatible. This means that if you made site customization using the [wiki:Doc described method] (pro_lcg2_config_site, pro_site_cluster_info...) and didn't modify standard templates, no changes should be required to use new version of the templates. When this is really required to introduce a new feature or bring more flexibility for configuring a service, it can happen that this full compatibility cannot be retained. This is normally stated in release announcement. You are always better to check...
     17We do our best to ensure that new versions are backward compatible. This means that if you made site customization using the [wiki:Doc described method] (pro_lcg2_config_site, pro_site_cluster_info...) and didn't modify standard templates, no changes should be required to use new version of the templates. When this is really required to introduce a new feature or bring more flexibility for configuring a service, it can happen that this full compatibility cannot be retained. This is normally stated in release announcement. You are always better to check it before upgrading.
    1818
    1919Standard templates are made of 3 areas (see [wiki:Doc/TemplateCustom template layout]) :
    2020 * OS templates : they are never modified, except for fixes. The only modifications apply to errata RPM list. These errata are not installed by default.
    21  * Middleware templates (if using them) : they bring both changes and fixes at each release. They are intended to be backward compatible : that means the resulting configuration should be the same if you don't change your local configuration. As part of QWG releases, they deliver gLite updates : [wiki:Download/QWGTemplates/Install#ControllinggLiteUpdatesInstallation GLITE_UPDATE_VERSION] allows to control deployment of gLite updates as part of QWG templates update.
     21 * Middleware templates (if using them) : they bring both changes and fixes at each release. They are intended to be backward compatible : that means the resulting configuration should be the same if you don't change your local configuration.
     22 * Quattor templates: all the templates required to configure a given Quattor release (client, configuration modules...)
    2223 * Standard templates : all modifications in this area are entirely backward compatible
    2324
     
    2930
    3031An in-place upgrade basically involves :
    31  * Checking out the QWG template release you need, in a separate area from your configuration database.
    32  * Synchronize your configuration database with your local copy of QWG templates.
     32 * Getting a copy of the last version of the template library, using the [/wiki/Download/QWGTemplates download] procedure
     33 * Synchronize your configuration database with your local copy of the template library.
    3334
    34 ''Note : you are advised to maintain an area where you have checked out QWG templates from [https://svn.lal.in2p3.fr/LCG/QWG/templates QWG repository] (never check out the whole [source:templates templates] branch but only the version you need, [source:templates browse] through the repository to find it). This way updgrading to a new version is much more efficient : you can use `svn update` or `svn switch` to download only the changed bit.''
    35 
    36 To integrate new/changed templates in your configuration database, you can use the tool documented at [wiki:Development/Templates/RepUpdate], originally developped to do the reverse synchronization (update QWG repository from a real configuration database). This tool can be used '''only''' with [wiki:Doc/SCDB SCDB], as it relies on [http://subversion.tigris.org Subversion] to do a non destructive update. As a benefit, it cannot damage your configuration database as every change made by this tool can be reverted with Subversion.
     35To integrate new/changed templates in your configuration database, the easiest is to use the tool . This tool can be used '''only''' with [wiki:Doc/SCDB SCDB], as it relies on [http://subversion.tigris.org Subversion] to do a non destructive update. As a benefit, it cannot damage your configuration database as every change made by this tool can be reverted with Subversion.
    3736
    3837After importing all the changes with `directory-sync` (or manually), you need to commit them into your SCDB, after checking it compiles successfully and the changes in the profiles look appropriate (generally mainly some RPMS update). For this last check you can use `src/utils/profiles/compare_xml` script. After integrating the new templates, identify the changed templates, review the change if necessary and revert those not appropriate. You'll probably need to revert changes of all templates in directories `repository` (these templates are site specific but some of them are required to reside in standard directories for multiple version support).