Changes between Version 5 and Version 6 of Obsolete/Development/Templates/gLite

Timestamp:

Jul 25, 2008, 11:09:06 AM (16 years ago)

Author:

jouvin

Comment:

--

Obsolete/Development/Templates/gLite

@@ -43 +43 @@
 === RPMs ===
 
-For each gLite service in [source:templates/trunk/grid/glite-3.1/glite glite/] directory, there is a list of the required RPMs for the service. This list is mainly generated from official list supplied by [http://glite.org gLite] with the release. It generally requires some manual tuning to solve some missing dependencies in the list provided by gLite. After the initial release, this list should not be edited, except for adding a new RPM required by an update. Replaced RPMs must be handled by [wiki:Development/Templates/Generated#ListofupdateRPMs update related] templates.
+Each gLite service is released with an official list of RPM, available on [http://glite.org gLite site]. The easiest way to get to this list is general by the page about releases where there is a link to high-level services available. From there you should get easily to the section with RPM list. The RPM list provided is generally reasonably accurate and complete.
 
-To generate the template from the gLite supplied list, you need to use [source:SCDB/trunk/src/utils/misc/createPackagesTemplate src/utils/misc/createPackagesTemplate] script provided with SCDB. The steps are :
- * Download the official list from [http://glite.org gLite] site. For example for gLite 3.1 WN, download http://glite.web.cern.ch/glite/packages/R3.1/deployment/glite-WN/3.1.0-1/glite-WN-3.1.0-1.html.
- * Process this file with [source:SCDB/trunk/src/utils/misc/createPackagesTemplate src/utils/misc/createPackagesTemplate] script :
+This RPM list must be downloaded in text format (there is a URL for this in every gLite RPM list) and then processed by [source:SCDB/trunk/src/utils/misc/createPackagesTemplate src/utils/misc/createPackagesTemplate] to produce the corresponding template in appropriate `rpms/arch` directory. Be sure to download the the RPM list for the appropriate architecture, when several are supported, as the version numbers are not always the same for each architecture.
+
+Use `src/utils/misc/createPackagesTemplate --help` for detailed information about options supported by this script. Main options are: script provided with SCDB. The steps are :
+ * `--rpmlist file`: name of the file containing the download RPM list.
+ * `--template file`: name of the template to create.
+ * `--namespace ns`: PAN namespace to use in the template 
+
+An example to create RPM list for the WN i386:
 {{{
 src/utils/misc/createPackagesTemplate --rpmlist glite-WN-3.1.0-1.html \
@@ -54 +59 @@
 }}}
 
+Once created, the generated templates must be tweaked to add missing dependencies if any but mainly to remove any RPM listed which is provided by the OS distribution. This is very important for the RPM list to be independent of a particular OS version. The RPMs provided by the OS must be moved to another template in templates specific to an OS version, in the `config/glite/3.1/` generally referred as ''OS hooks''. Most of the OS-provided RPMs are already present in `base.tpl` included in any gLite machine type. If some are missing, an OS hook template specific to the service must be created.
 
+Another common modification to the generated RPM list is to change architecture for RPMs not `noarch` to `PKG_GLITE_DEFAULT`. This helps copying RPM list from one architecture to another when this is useful.
+
+After the RPM list for each supported architecture is ready, it is necessary to create `rpms/config.tpl`. The easiest is to copy an existing one in another service as this is generally pretty much the same in every service. This template is the right place to force architecture used for the service independently of the machine OS. This is generally done by defining variable `PKG_GLITE_DEFAULT` to the appropriate architecture (must match the directory name under `rpms`,  currently `i386` for 32-bit architecture and `x86_64` for 64-bit architecture).
 
 === service.tpl ===