Production Release Criteria

Latest version of this document
23.01.2012: EMI_SA2_ProductionReleaseCriteria_v_2_1.pdf

1. Introduction

The Producton Release criteria defines the minimum set of criteria considered to be mandatory for a new product version to be released in the EMI production repository. It summarises what it is described in each policy as a mandatory requirement.

The criteria will be checked by QC who will write a verification report informing about the compliance with the criteria. This check takes place once the associated release task [R1] for the new product version has been certified by the PT, as described in the Change Management Policy [R2].

In case some of the defined criteria is not met, PTs should clearly justify why in the Remarks sections of the Testing or Certification reports attached to the release task. QC will then evaluate the given explanations on a case by case basis.

2. Production Release Criteria

2.1. Change Management Criteria

New versions of a product must be tracked in a release task created by the release manager in the EMI release tracker [R1]. PTs must fill in the remaining fields not provided by the release manager.

All the changes included in the new version of the product must be tracked in an RfC in the PT tracking tool. All the RfCs must be specified in the List of RfCs field in the release task.

Other changes coming from development tasks [R10], must be also linked to the release task using the Dependencies field in Savannah.

All the details on how to fill in and use release tasks and RfCs must be followed as specified in the Change Management Policy [R2].

2.2. Integration and Configuration criteria

New versions of a product must have a corresponding ETICS component (and subsystem) configuration in ETICS. The component configuration must contain a tag of the code. The configuration must build without errors:

  • For EMI major releases: in the development project configuration emi_B_X_dev.
  • For EMI updates: in the project configurations emi_R_X_rc and emi_R_X_prod.

All the details on how to build with ETICS must be followed as specified in the Configuration and Integration Policy [R5].

2.3. Packaging criteria

New versions of a product must include all new packages in all supported packaging formats.

For SL5 and SL6, the mandatory package formats are: rpm, src.rpm, binary tarballs per platform and source tarballs.

For Debian 6, the mandatory package formats are: deb, dsc, orig.tar.gz, debian.tar.gz and binary tarball.

All the details on packaging must be followed as specified in the Packaging Policy [R6].

2.4. Testing criteria

New versions of a product must run and report about the results of at least the following type of tests:

  • Unit Tests
  • Deployment Tests (Clean Installation and Upgrade, for minor releases and across major releases)
  • Basic Functionality Tests
  • Any existing and automated Regression Tests

The results of the tests must be reported in the Test Report that must be attached to the release task. The release task must also contain a link to the Test Plan of the product.

All the details about testing must be followed as specified in the Testing Policy [R7].

2.5. Documentation criteria

At least the following documents must be provided by PTs:

  • General Documentation
    • Release Notes
    • Functional description
  • User Documentation
    • User guide
    • Client Installation and Configuration
  • System Administrator Documentation
    • System Administrator Guide
    • Service Reference Card

All the details about documentation must be followed as specified in the Documentation Policy [R8].

2.6. Certification criteria

New versions of a product must be certified and the certification report must be attached to the corresponding release task.

All the details about certification must be followed as specified in the Certification Policy [R9].

2.7. Testbed Deployment criteria

New versions of a product must be successfully deployed in the EMI Testbed. Nagios probes and any other tests must also run successfully to consider the Testbed deployment successful.

3. EMI QA Dashboard and QC Verification Report

The Production Release Criteria is checked by QC for every certified release task with the help of the EMI QA Monitoring Dashboard [R3]. The Dashboard presents the certification and test report answers and compares them to what has been actually found in ETICS and the release task. The Dashboard automatically generates the Verification Report. The Verification Report summarises the review of the Production Release Criteria. A template of the Verification Report can be found in the QC Verification twiki [R4].

4. Table of References

Reference URL
R1 EMI Release Tracker
https://savannah.cern.ch/task/?group=emi-releases
R2 EMI Change Management Policy
Change Management Policy
R3 EMI QA Monitoring Dashboard
http://emi-dashboard.cern.ch/
R4 EMI QC Verification
https://twiki.cern.ch/twiki/bin/view/EMI/EMIQCVerificationReport
R5 EMI Integration and Configuration Policy
https://twiki.cern.ch/twiki/bin/view/EMI/EmiSa2ConfigurationIntegrationPolicy
R6 EMI Packaging Policy
https://twiki.cern.ch/twiki/bin/view/EMI/EmiSa2PackagingPolicy
R7 EMI Testing Policy
https://twiki.cern.ch/twiki/bin/view/EMI/EmiSa2TestPolicy
R8 EMI Documentation Policy
https://twiki.cern.ch/twiki/bin/view/EMI/EMISa2DocumentationPolicy
R9 EMI Certification Policy
https://twiki.cern.ch/twiki/bin/view/EMI/EmiSa2CertPolicy
R10 EMI Development tracker
https://savannah.cern.ch/task/?group=emi-dev

5. Changelog

v2.2

  • 06.02.2012: Update section 2.4 to clarify that there should be an upgrade path across major releases.

v2.1 (Approved on 23.01.2012)

  • 16.01.2012:
    • Adapt the mandatory packages to EMI2

v2.0

  • 22.08.2011:
    • Added development tasks in change management criteria.
    • Added the correct ETICS configs in the builds specified in the Config and Integration criteria.
  • 03.08.2011 :
    • Apply Release Manager feedback.
    • Change component with release where applicable.
    • Review all existing criteria per policy and make sure it's aligned with the latest versions of each policy.
    • Added Testbed Deployment Criteria.

v1.0

  • First version that has been used until 03.08.2011 when the document has been reviewed for EMI 2.

Edit | Attach | Watch | Print version | History: r23 < r22 < r21 < r20 < r19 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r23 - 2012-02-06 - unknown
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    EMI All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback