Document upgrade Red Hat / CentOS 7 to v 8.x (#3109)

hitachienergy · Apr 26, 2022 · 8eba8a7 · 8eba8a7
1 parent 2cb1247
commit 8eba8a7
Show file tree

Hide file tree

Showing 4 changed files with 22 additions and 3 deletions.
diff --git a/docs/changelogs/CHANGELOG-2.0.md b/docs/changelogs/CHANGELOG-2.0.md
@@ -27,6 +27,7 @@
 - [#1452](https://github.com/epiphany-platform/epiphany/issues/1452) - Create Kubernetes Native Storage Epiphany configuration for Azure provider
 - [#2891](https://github.com/epiphany-platform/epiphany/issues/2891) - Rook/Ceph Kubernetes Native Storage for AWS non-EKS
 - [#2887](https://github.com/epiphany-platform/epiphany/issues/2887) - Create Kubernetes Native Storage Epiphany configuration for AWS provider
+- [#2734](https://github.com/epiphany-platform/epiphany/issues/2734) - Document upgrade Red Hat / CentOS 7 to v 8.x
 
 ### Fixed
 

diff --git a/docs/home/ARM.md b/docs/home/ARM.md
@@ -1,4 +1,8 @@
 # ARM
+### **NOTE**
+---------------
+ARM Architecture is not supported in Epiphany 2.0.0. This feature will be added to platform in version 2.0.1
+--------------
 
 From Epiphany v1.1.0 preliminary support for the ```arm64``` architecture was added. As the ```arm64``` architecture is relatively new to the datacenter at the time of writing only a subset of providers, operating systems, components and applications are supported. Support will be extended in the future when there is a need for it.
 

diff --git a/docs/home/howto/OS_UPGRADE.md b/docs/home/howto/OS_UPGRADE.md
@@ -6,3 +6,17 @@ For information about upgrading Ubuntu release, please refer to [Ubuntu document
 
 For testing purposes, we use Ansible playbook ([ci/ansible/playbooks/os/ubuntu/upgrade-release.yml](../../../ci/ansible/playbooks/os/ubuntu/upgrade-release.yml)),
 however it is strongly recommended that an administrator is involved to prepare for and perform the upgrade.
+
+# How to upgrade from RHEL 7.x to RHEL 8.x
+
+Epiphany doesn't provide automation to perform Red Hat Enterprise Linux release upgrade.
+
+For information about upgrading RHEL release, please refer to [RHEL documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/upgrading_from_rhel_7_to_rhel_8/index).
+
+
+For testing purposes, we use Ansible playbook ([ci/ansible/playbooks/os/rhel/upgrade-release.yml](../../../ci/ansible/playbooks/os/rhel/upgrade-release.yml)),
+however it is strongly recommended that an administrator is involved to prepare for and perform the upgrade. This feature is still in experimental stage and is not fully operational yet.
+
+# CentOS upgrade
+
+Epiphany does not support upgrade of CentOS system since it's not supported in Epiphany 2.x at all. We switched to AlmaLinux 8 instead.
diff --git a/docs/home/howto/UPGRADE.md b/docs/home/howto/UPGRADE.md
@@ -46,7 +46,7 @@ Your airgapped existing cluster should meet the following requirements:
    other and have access to the internet:
 2. The cluster machines/vm`s are **upgraded** to the following versions:
   - AlmaLinux 8.5+
-  - RedHat 7.6
+  - RedHat 8.5+
   - Ubuntu 20.04
 3. The cluster machines/vm`s should be accessible through SSH with a set of SSH keys you provided and configured on each
    machine yourself.
@@ -78,12 +78,12 @@ Your airgapped existing cluster should meet the following requirements:
    with each other:
 2. The airgapped cluster machines/vm`s are **upgraded** to the following versions:
   - AlmaLinux 8.5+
-  - RedHat 7.6
+  - RedHat 8.5+
   - Ubuntu 20.04
 3. The airgapped cluster machines/vm`s should be accessible through SSH with a set of SSH keys you provided and
    configured on each machine yourself.
 4. A requirements machine that:
-  - Runs the same distribution as the airgapped cluster machines/vm`s (AlmaLinux 8, RedHat 7, Ubuntu 20.04)
+  - Runs the same distribution as the airgapped cluster machines/vm`s (AlmaLinux 8, RedHat 8, Ubuntu 20.04)
   - Has access to the internet.
 5. A provisioning machine that:
   - Has access to the SSH keys