Skip to content

Commit 4e76a98

Browse files
committed
restructure version page
1 parent 2cae33d commit 4e76a98

File tree

1 file changed

+70
-34
lines changed

1 file changed

+70
-34
lines changed

docs/rocky/version.md

+70-34
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Rocky Linux Release Version Guide
2+
title: Rocky Linux Release and Version Guide
33
---
44

55
This page goes over the Rocky Linux Release Versions, their support, timelines, and how it affects our users.
@@ -8,35 +8,62 @@ This page goes over the Rocky Linux Release Versions, their support, timelines,
88

99
Below is a table of Rocky Linux versions, with accompanying general release and (planned or are planned) end of life dates.
1010

11-
| Major Version | Codename | Release Date | Active Support | End of Life | Latest Version |
12-
|----------------|----------------|---------------|----------------------|----------------------|--------------------------|
13-
| Rocky Linux 8 | Green Obsidian | May 1, 2021 | May 31, 2024 | May 31, 2029 | 8.9 (November 22, 2023) |
14-
| Rocky Linux 9 | Blue Onyx | July 14, 2022 | May 31, 2027 | May 31, 2032 | 9.3 (November 20, 2023) |
11+
| Release | Codename | Release Date | Active Support | End of Life | Latest/Current Version |
12+
|-----------------|----------------|---------------|----------------------|----------------------|--------------------------|
13+
| Rocky Linux 8 | Green Obsidian | May 1, 2021 | May 31, 2024 | May 31, 2029 | 8.9 (November 22, 2023) |
14+
| Rocky Linux 9 | Blue Onyx | July 14, 2022 | May 31, 2027 | May 31, 2032 | 9.3 (November 20, 2023) |
1515

16-
Click any of the tabs below to obtain more information about a current release.
16+
For more detailed information on each version, click any of the tabs below.
1717

1818
{% include "releng/version_table.md" %}
1919

20-
See the timeline and release cadence sections below for more information on how these dates are determined.
20+
See the [Timeline and Terminology](#timeline-and-terminology) and [Release Cadence](#release-cadence) sections for more information on how these dates are determined.
2121

22-
## Timeline
22+
## Timeline and Terminology
2323

24-
For a major release of Red Hat Enterprise Linux and thus Rocky Linux, the following should be true:
24+
### Terminology
2525

26-
* Major version is released with support of ten (10) years (exception is Rocky Linux 8, which started at 8.4)
27-
* Five (5) years of minor release updates
26+
Throughout this page, you will see terms such as "major version" or "minor version", among others. You will see these terms used throughout many discussions online forums, mail lists, or even our Mattermost. See below for their basic definitions.
2827

29-
* There is generally one (1) major release with ten (10) minor release updates
30-
* Minor releases come typically every six (6) months
31-
* Minor releases generally come with new features, modules, and sometimes software rebases
28+
| Term | Definition |
29+
|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
30+
| Major Version | A major version is denoted by a whole number, such as "Rocky Linux 9". This number is left-most number in a version, such as 9.0, where "9" is the major version. |
31+
| Minor Version | A minor version is denoted by the right-most number in a version, such as "Rocky Linux 9.3". "9" being the major version, "3" being the minor version. These updates come with version upgrades, rebases, new software and features. |
32+
| Release | Release typically refers to a major version release, such as "Rocky Linux 9". It is typically assumed it is referring to the latest/current version of that release. |
33+
| Minor Release | Used as "Minor Version" in most cases. |
3234

33-
* After five (5) years of minor releases, Enterprise Linux and derivatives go into maintenance only mode for the remainder of its life
35+
### Timeline
36+
37+
Rocky Linux strives to follow Red Hat Enterprise Linux and CentOS Stream within reason. As such, Rocky Linux releases should follow fairly close to our upstreams.
38+
39+
#### Major Version Release
40+
41+
For a new Rocky Linux release, the following should be true:
42+
43+
* New major version is released with support of ten (10) years[1], starting at `.0`.
44+
* Release will have five (5) years of minor version updates
45+
46+
* Releases come with two minor version releases a year: Every six (6) months
47+
* Minor releases will come with new features, software rebases, and sometimes brand new software
48+
* Final minor version will almost always be `.10`
49+
50+
#### Minor Version Release
51+
52+
For a new Rocky Linux minor version release, the following should be true:
53+
54+
* New minor version is released with new features and/or software
55+
* Previous minor version is moved to the [vault](repo.md#vault) and is no longer supported
56+
57+
However, when the minor version is `.10`, this means:
58+
59+
* Rocky Linux (and other Enterprise Linux derivatives) go into security maintenance for the next five (5) years
60+
* This version of Rocky Linux will likely not receive new features nor new software
3461

3562
### Release Cadence
3663

37-
Based on the cadence set out by Red Hat, the months of May and November are generally when minor releases should be released. May is also generally when major releases arrive. Rocky Linux attempts to follow as closely as possible to this same cadence.
64+
Based on Red Hat's life cycle policy, the month of May is when new major versions are released *and* every May and November a new minor version release is provided for prior supported releases. Rocky Linux attempts to follow as closely as possible to this same cadence.
3865

39-
Below is a general guideline (based on Red Hat documentation) for the "full support" cycle for an Enterprise Linux distribution.
66+
Below is a general guideline (based on Red Hat documentation) for the "full support" cycle for Rocky Linux.
4067

4168
| Version | Month |
4269
|---------|----------|
@@ -52,46 +79,46 @@ Below is a general guideline (based on Red Hat documentation) for the "full supp
5279
| .9 | November |
5380
| .10 | May |
5481

55-
Upon a new minor release (`X.Y+1`), the previous Rocky Linux release is no longer supported and is moved to the [vault](repo.md#vault).
82+
Upon a new minor release (`X.Y+1`), the previous Rocky Linux minor version is no longer supported and is moved to the [vault](repo.md#vault).
5683

5784
After `X.10` is released, the following may be true:
5885

5986
* Maintenance Mode starts for the next five (5) years
60-
* No more minor releases; `X.10` is considered the final release version and only this receives updates until End of Life
61-
* CentOS Stream X will cease development (likely before release)
87+
* `X.10` is considered the final version for a release and only this receives updates until End of Life
88+
* CentOS Stream X will cease development near the end of the month of May
6289

6390
## Version Policy
6491

65-
Rocky Linux attempts to follow the same pattern as Red Hat Enterprise Linux. As such, releases aim to be as on time as possible as they are released upstream.
92+
Rocky Linux attempts to follow closely with the updates of our upstream Red Hat Enterprise Linux. As such, updates aim to be released as on time as possible.
6693

67-
For Rocky Linux 8, previous versions of packages will coexist in the repositories to allow a user to downgrade in case of a regression or other use cases (such as security only updates).
94+
**For Rocky Linux 8**: Previous versions of packages will coexist in the repositories to allow a user to downgrade in case of a regression or other use cases (such as security only updates).
6895

69-
Rocky Linux 9 does not currently support this policy and can be expected in a future Rocky Linux 9 version. Please see [Peridot Issue #18](https://github.com/rocky-linux/peridot/issues/18). Older versions of packages can by found in [Koji](https://kojidev.rockylinux.org) when they're uploaded.
96+
**For Rocky Linux 9**: This policy is not currently supported and can be expected in a future Rocky Linux version. Please see [Peridot Issue #18](https://github.com/rocky-linux/peridot/issues/18). Older versions of packages can by found in [Koji](https://kojidev.rockylinux.org) when they're uploaded or the vault.
7097

71-
For all Rocky Linux versions: When a new minor release arrives, all previous updates/versions are *not* carried over.
98+
**For all Rocky Linux versions**: When a new minor release arrives, all previous updates/versions are *not* carried over.
7299

73100
### General Update Timeline
74101

75102
Updates for Rocky Linux are generally expected to be built and released between twenty-four (24) and fourty-eight (48) hours, assuming best effort allows the packages to build without any complications or unforeseen added dependencies by upstream mid-support cycle.
76103

77104
Minor releases for Rocky Linux are generally expected to be built and released at least a week (7 days) after upstream, assuming best effort allows the packages to build without any complications and it passes the Testing Team OpenQA and general testing.
78105

79-
## End of Life and Unsupported Release Policy
106+
## End of Life and Unsupported Release/Version Policy
80107

81-
A version of Rocky Linux is considered unsupported if:
108+
A release or version of Rocky Linux is considered unsupported if:
82109

83-
* The Rocky Linux version has been superseded by another minor release *or*
110+
* The Rocky Linux minor version has been superseded by another minor release *or*
84111
* The Rocky Linux release is End of Life
85112

86113
See the examples below.
87114

88-
### Example: An Unsupported Release
115+
### Example: An Unsupported Version
89116

90-
When a new Rocky Linux minor release arrives (using version format `X.Y`, `Y+1` or an increment of `Y`) the following is true:
117+
When a new Rocky Linux minor release arrives (`X.Y+1`) the following is true:
91118

92119
* The previous version is no longer supported by Release Engineering and the community
93120
* This version is no longer updated and is moved to the [vault](http://dl.rockylinux.org/vault/rocky/).
94-
* This version does not receive bug fix nor security updates.
121+
* This version **does not** receive bug fix nor security updates.
95122
* You are recommended to update your system with `dnf update`.
96123

97124
### Example: An End of Life Release
@@ -103,13 +130,16 @@ When a Rocky Linux release has reached its End of Life date typically after ten
103130
* This release no longer receives updates and thus no longer supported.
104131
* You are recommended to install a supported Rocky Linux version and migrate your data.
105132

106-
If you cannot install a new system and migrate and you still need support for your system or systems, you may be able to find a support provider. Note that support providers will maintain their own packages and policies outside of the Rocky Linux ecosystem, and thus their policies *do not* apply here. The release is still considered EOL and unsupported by the Rocky Linux project.
133+
If you cannot install a new system and migrate and you still need support for your system or systems, you may be able to find a support provider.
134+
135+
!!! warning
136+
Support providers will maintain their own packages and policies outside of the Rocky Linux ecosystem, and thus their policies *do not* apply here. The release is still considered EOL and unsupported by the Rocky Linux project.
107137

108138
## Beta to Stable Policy
109139

110-
Rocky Linux may release beta versions that are typically in line with the upstream Red Hat Enterprise Linux beta releases. These are released specifically to find bugs or issues in our build process as well as correlate the issues with the upstream beta in case they also have bugs. These are released typically to the Testing team members and others in the community (whether or not they're publicly announced) and are free to download and test by anyone else.
140+
Rocky Linux may release beta versions when possible. These are typically close to our upstreams where reasonably possible. These are released specifically to find bugs or issues in our build process. This also helps correlate issues with our upstreams in the event they also have bugs. These are provided to our Testing Team members and others in the community and are free to download and test by anyone in the community.
111141

112-
When the stable version is released, updating from the beta to the stable version is not a supported nor recommended system setup.
142+
However, when the stable minor version is released, updating from the beta to the stable version is not recommended nor is it supported, even for experienced users.
113143

114144
The following is unsupported:
115145

@@ -118,4 +148,10 @@ The following is unsupported:
118148

119149
## Upgrade Policy
120150

121-
Upgrades are not generally supported by Release Engineering nor most of the Rocky community. If you wish to perform upgrades between releases, there is a tool called ELevate that can help you. But as a note of caution, this has not been formally tested and we cannot provide official assistance.
151+
Upgrades are not generally supported by Release Engineering nor most of the Rocky community. If you wish to perform upgrades between releases, there is a tool called ELevate that may be able to help you. But as a note of caution, this has not been formally tested and we cannot provide official assistance.
152+
153+
!!! warning
154+
Some users have expressed success with doing upgrades with this tool. However, it is not formally tested by the Rocky Linux project and we cannot provide official assistance.
155+
156+
!!! note
157+
If you wish to be part of an effort to ensure upgrades are possible, we recommend that you join us in our Mattermost and ask how you can help.

0 commit comments

Comments
 (0)