EGI IGTF Release Process
This page is in draft
About this distribution
This page describe the procedure for the announcement and propagation of a new release of the EGI Trust Anchor distribution. The EGI Policy on Approved Certification Authorities describes the set of trust anchors accepted by EGI and put forward for consideration by the NGIs to install as the 'agreed set' of Identity Management trust anchors. For the time being, only PKI trust achors ('Certification Authorities') are included in this release.
The announcement and distribution of trust anchors within EGI and the NGIs should be done in a well defined order to ensure consistent deployment and to ensure that the monitoring of the NGIs and sites matches the currently recommended version of the trust anchors.
For historical reasons, most of the EGI sites (i.e. all those that do not have their own local or national distribution already), use as the meta-package that enshrines the EGI policy on approved CAs one called 'lcg-CA'. In the future, this package will go away, probably at the same time that the distribution repository itself is changed from linuxsoft.cern.ch to the new EGI repositories. Since at that time sites need to change anyway, doing this extra step will hopefully be less intrusive.
As of release 1.35, the set of packages distributed via both the old as well as the new process have not only this legacy RPM, but also the newly named 'ca-policy-egi' RPM. For the time being, both policies are the same, i.e., the same dependencies are included in both RPMs and installing either one of them will trigger the installation of the same set of CAs. After that, the EGI set of endorsed CAs will be encoded in the 'ca-policy-egi' meta-package.
Of course, it is not guaranteed that, in the future, the EGI and wLCG policies will stay aligned, so sites that relied on the 'lcg-CA' package distributed by EGEE to also comply with the wLCG policies on accepted CAs should keep this in mind. Also, the acceptable CA policy for your organisation, country or region may be different from the EGI one: for example, your organsiation or NGI may have approved additional CAs to support training activities on your infrastructure, or have additional bridges between your countries research federation and your site! As a result, you may want to install additional CAs that are not on the central EGI list.
- IGTF/EUGridPMA Liaison: David Groep (firstname.lastname@example.org)
- Monitoring Team (central monitoring configuration centre): CERN/James Casey
- Repository Team: GRNET (or CERN for a while?)
- EGI-MW team (configuration, integration and staged roll-out): LIP/Mario David
- Regional follow-up: NGI contacts and All Sites (via CIC portal)
- Security oversight and determination of grace period: EGI CSIRT/Mingchao Ma and Sven Gabriel
- David Groep (under EGI contract O-E-15/SA1) will also build the entire trust anchor package, currently called 'ca-policy-egi', and make that available on a special site only intended for INTERNAL use by the deployment process (there is also a ca-policy-lcg package). This "special" distribution would contain:
- the IGTF "classic", "mics", and "slcs" CAs (following the Policy on Accepted CAs)
- the "ca-policy-egi-core" as well as the (equivalent legacy) "lcg-CA" and the ca-policy-lcg meta package
- any other EGI specific CAs or exception as decided by EGI
- any appropriate meta-data, the readme file and repo headers
- This distribution will be unit tested before being released. These RPMs are made available on the dedicated EGI-IGTF liaison web site (not on production sites at that step). To download, you may need to instruct wget to ignore the robots.txt file:
- wget -e robots=off -r http://obscure-site.example.org/cadist/lcgpreview-X.YY-R/RPMS.lcg/
- or even
- wget -nd -r -np -i index.html -F --base=http://www.cern.ch/groep/cadist/lcgpreview-X.YY-R/RPMS.lcg/ http://www.cern.ch/groep/cadist/lcgpreview-X.YY-R/RPMS.lcg/
- David will upload this distribution to the EGI Repository "inbound" for starting the staged-rollout process
- New CA release is announced by David Groep (email@example.com) (following on or forwarding the EUGridPMA-Announce list) to
- the EGI CSIRT via firstname.lastname@example.org
- the EGI MW unit via email@example.com, firstname.lastname@example.org (or later email@example.com)
- the monitoring teams to update the SAM CE probes via firstname.lastname@example.org (Maria.Alandes.Pradillo@cern.ch, Konstantin.Skaburskas@cern.ch)
- the NGI Operations managers (to update the Nagios instances) via email@example.com
- Mail paste list: firstname.lastname@example.org, email@example.com, firstname.lastname@example.org, email@example.com, Maria.Alandes.Pradillo@cern.ch, Konstantin.Skaburskas@cern.ch, firstname.lastname@example.org, email@example.com, firstname.lastname@example.org, email@example.com
- Either the EGI CSIRT, the EGI Operational Security Coordinators, or the MW unit can declare this update as urgent.
- David will create a GGUS ticket, with with a standard subject: "CA update, version X.Y.Z-R" And with a comment inside saying: "please, assign this ticket to the EGI-MW team". The integration team will also be involved in the ticket to start preparing the repository ("Involve others:" in GGUS), as both changes are independent. The ticket will contain
- the URL, e.g.:
- the EGI specific change log in the body of the ticket. This change log is intended for direct distribution to the EGI sites
- To ensure a smooth, parallel update of the repository and the monitoring/Nagios tests, the non-urgent updates should be be started prior to Wednesdays at mid-day. The GGUS ticket that triggers the updates (which can be sent anytime), should systematically include a reminder not to start after mid-week, and preferably on a Monday.
- The EGI MW unit will put the release in staged roll-out for testing. This procedure should not take more than one day.
- The sites that participate in the staged roll-out are: LIP
- If staged roll-out is successful:
- the EGI-MW unit assigned the GGUS ticket to the Monitoring team, with a CC to the Repository, since the next two steps should be done in rapid succession. The monitoring team should act first (due to the structure of the CAdist-probe logic:
- The Monitoring team copies the old-style YUM headers/header.info file from the secret location to
- or has it re-created by hand. This header.info file is read by the Nagios CAdist-probe script to find the current list of required CAs.
- The Repository team copies the RPMs form the secret place to the repository and either
- copies all of the secret directory to the release location. This structure supports new-style Yum3 and old-style Yum2 downloads; or
- copies the RPMs into the repository and re-creates the headers locally
- updates the CA related web page at
- sends an announcement with changelog (from the GGUS ticket) to the NGI contacts that the repository contains new content through the Operations Portal (select "To ROC Managers", "To Production Site Admin"), with a CC to the gLite EMT. Template emails including email subjects can be found here. The change log to be included in the mail is part of the GGUS ticket, and can also be found at http://www.cern.ch/groep/cadist/lcgpreview-X.Y-Z/ in the file lcg-ca-X.Y-Z.txt.
- assigns the GGUS ticket to the EGI-CSIRT
- The ticket opened by David Groep at step 3 is closed by EGI-CSIRT Contact, only after verifying that the following three links of the CA related web page
- http://grid-deployment.web.cern.ch/grid-deployment/lcg2CAlist.html (to be moved later), with the link for Quattor templates at the bottom of the page.
- http://linuxsoft.cern.ch/LCG-CAs/current (to be moved later)
- http://glitesoft.cern.ch/LCG-CAs/current/RPMS.production/ (gLite EMT should take care of this one)
- of step 7 are updated containing reference to the new CA version:
- and that the relevant broadcast of step 8 is achieved by looking at https://cic.gridops.org/index.php?section=vo&page=broadcast_archive (limit the dates to the last few days, and fill "Criterion 3" with "CA"). GGUS ticket subject should be "CA update, version X.Y.Z-R".
Notes on the CAdist probe
- the list of required packages is based on parsing the old-style Yum header.info file. Once yum-arch has been completely replaced, this file should be created by hand and contain at least this one line:
- where [\d.]+ contains a version number like "1.35"
- the release date of the EGI distribution is taked from the Last-Modified header sent by the web server hosting the header.info file
- The latest IGTF version and release date are taken from the CHANGES file at http://dist.eugridpma.info/distribution/igtf/current/CHANGES, which the utility expects to be in a specific format (see sources)
- the grace period is always 7 days -- there is no means to enforce critical updates from the 'outside' of a site
Notes on the SAM tests
- SAM tests need to be updated, specifically the "lcg-sam-client-sensors" and "grid-monitoring-probes-org.sam" and these need to be installed in production
- Only them, upload the new CA RPMs to the gLite middleware repository