From 8eba8a77dcb6a468b0b66ff9727f7f6cbbb6d7fb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Irek=20G=C5=82ownia?= <48471627+plirglo@users.noreply.github.com> Date: Tue, 26 Apr 2022 09:39:13 +0200 Subject: [PATCH] Document upgrade Red Hat / CentOS 7 to v 8.x (#3109) --- docs/changelogs/CHANGELOG-2.0.md | 1 + docs/home/ARM.md | 4 ++++ docs/home/howto/OS_UPGRADE.md | 14 ++++++++++++++ docs/home/howto/UPGRADE.md | 6 +++--- 4 files changed, 22 insertions(+), 3 deletions(-) diff --git a/docs/changelogs/CHANGELOG-2.0.md b/docs/changelogs/CHANGELOG-2.0.md index 33f97bf8ff..beafb13177 100644 --- 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 index 94466f141b..1fc7b36ad1 100644 --- 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 index f2ce5f0dd3..940aa145bd 100644 --- 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 index dbe4eddc29..1e0843cba3 100644 --- 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