Skip to content

Commit

Permalink
Merge pull request #124 from brianhlin/SOFTWARE-5663.release-series-s…
Browse files Browse the repository at this point in the history
…upport-policy

Migrate release series policy from technology to docs
  • Loading branch information
brianhlin authored Sep 26, 2023
2 parents 5b4dbbb + 0c2de2b commit 3c3be98
Showing 1 changed file with 38 additions and 14 deletions.
52 changes: 38 additions & 14 deletions docs/release/release_series.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,38 @@
DateReviewed: 2023-08-25
title: Release Series

Release Series
==============

An OSG release series is a sequence of OSG software releases that are intended to provide a painless upgrade path.
For example, the 3.2 release series contains OSG software 3.2.0, 3.2.1, 3.2.2, and so forth.
A release series corresponds to a set of Yum software repositories, including ones for development, testing, and
production use.
The Yum repositories for one release series are completely distinct from the repositories for a different release
series, even though they share many common packages.
A particular release within a series is a snapshot of packages and their exact versions at one point in time.
When you install software from a release series, say 3.2, you get the most current versions of software packages within
that series, regardless of the current release version.

When a new series is released, it is an opportunity for the OSG Technology area to add major new software packages, make
OSG Software releases are organized into release series, with the intent that software updates within a series do will
not take require manual configuration updates, cause significant downtime, or break dependent software.

When a new series is released, it is an opportunity for the OSG Software Team to add major new software packages, make
substantial updates to existing packages, and remove obsolete packages.
When a new series is initially released, most packages are identical to the previous release, but two adjacent series
will diverge over time.

Our goal is, within a series, that one may upgrade their OSG services via `yum update` cleanly and without any necessary
config file changes or excessive downtime.
Support Policy
--------------

The OSG Software Team supports at most two concurrent release series, __current__ and __previous__, where the goal is to
begin a new release series about every 12 months.
Once a new series starts, the Software Team will support the previous series until the __next__ release series and will
announce its end-of-life date at least 6 months in advance.

When support ends for a release series, it means that the Software Team no longer updates the software, fixes issues, or
troubleshoots installations for releases within the series.
The plan is to maintain interoperability between supported series, but there is no guarantee that unsupported series
will continue to function.

Files for release series older than current or previous will be removed from the OSG Software repositories no earlier
than when support ends for the previous release.
For example, files for OSG 3.2 were not removed until May 2018, when support ended for OSG 3.3 in May 2018.

Series Overviews
----------------

Since the start of the RPM-based OSG software stack, we have offered the following release series:
Since the start of the RPM-based OSG Software Stack, we have offered the following release series:

- **OSG 3.6** (started February 2021) overhauls the authentication and data transfer protocols used in the OSG
software stack:
Expand Down Expand Up @@ -55,6 +63,22 @@ Since the start of the RPM-based OSG software stack, we have offered the followi
Historically, there were 3.0.x releases as well, but there was no separate release series for 3.0 and 3.1;
we simply went from 3.0.10 to 3.1.0 in the same repositories.

Series Life-cycle
-----------------

Support ends at the end of the month of the following dates unless otherwise specified:

| Release Series | Initial Release | End of Regular Support | End of Critical Bug/Security Support |
|:--------------:|-----------------|------------------------|--------------------------------------|
| 23 | September 2023 (tentative) | Not set | Not set |
| 3.6 | Februrary 2021 | 31 March 2024 | 30 June 2024 |
| 3.5 | August 2019 | 30 August 2021 | 1 May 2022 |
| 3.4 | June 2017 | 29 February 2020 | 30 November 2020 |
| 3.3 | August 2015 | 31 December 2017 | 31 May 2018 |
| 3.2 | November 2013 | 29 February 2016 | 31 August 2016 |
| 3.1 | April 2012 | 31 October 2014 | 30 April 2015 |


Installing an OSG Release Series
--------------------------------

Expand Down

0 comments on commit 3c3be98

Please sign in to comment.