From ad9722bf5d06ebac925fef58999492fc61e1a69b Mon Sep 17 00:00:00 2001 From: Simon Ebner Date: Wed, 4 Aug 2021 16:47:31 +0200 Subject: [PATCH] fix headings --- rhel8-guides-beta/installation_guide.md | 30 +++++++++++-------------- 1 file changed, 13 insertions(+), 17 deletions(-) diff --git a/rhel8-guides-beta/installation_guide.md b/rhel8-guides-beta/installation_guide.md index 77d3f155..3587f5cb 100644 --- a/rhel8-guides-beta/installation_guide.md +++ b/rhel8-guides-beta/installation_guide.md @@ -1,18 +1,14 @@ # Installation Guide -## Table of Contents - -[[_TOC_]] - -# 1. Introduction +## 1. Introduction This guide is about installing a RHEL-8 Beta system at Paul Scherrer Insitute (called PSI furtheron) and how to provide empirical feedback to PSI Linux Engineering for further development of the release candidate aimed for 15th October of 2020. **Check back to this documentation frequently, while the RHEL-8 Beta is valid, as changes may occur every day!** -# 2. How to find help and give feedback +## 2. How to find help and give feedback -## 2.1. How to receive help +### 2.1. How to receive help There are two ways to receive help. @@ -30,29 +26,29 @@ There is also the [PSI Linux Mailing List](mailto:linux@lists.psi.ch) that you c To subscribe to the list, click [here](mailto:linux-requests@lsits.psi.ch?subject=subscribe) and submit the email. -## 2.2. How to give feedback +### 2.2. How to give feedback * Create an Issue [here](https://git.psi.ch/linux/engineering/documentation/rhel-8-beta-guide/issues) with the label *suggestion* or *enhancement* Be as precise as possible and give an example that is easy to understand
Be polite and constructive to motivate our PSI Linux Engineering :thumbsup: -## 2.3. Known things that can cause problems +### 2.3. Known things that can cause problems At the moment there can be: * Various permission and access problems If you happen to fall into one of the categories, receive help as described in [2.1. How to receive help](#21-how-to-receive-help) -# 3. Installing a system +## 3. Installing a system -## 3.1 Prerequisites and information +### 3.1 Prerequisites and information * If you are creating a Virtual Machine, make sure to use normal BIOS mode instead of EFI. EFI booting is not yet supported. * If you are working on **ScienceIT** systems in Leonardo Sala's team, please make sure to use the **"RHEL-8/AIT"** hostgroup. ScienceIT is a division of AIT. -## 3.2. Easy +### 3.2. Easy 1. Login to [Red Hat Ansible Tower (AWX)](https://rhel-8-awx.psi.ch/) using your PSI credentials 2. Launch the "Create Host" [template](https://rhel-8-awx.psi.ch/#/templates?template_search=page_size:20;order_by:name;type:workflow_job_template,job_template;search:Create;search:Host) @@ -63,7 +59,7 @@ If you happen to fall into one of the categories, receive help as described in [ 7. The system will install and reboot 8. After the first reboot the system will configure itself and will be accessible in a couple of minutes -## 3.3. Advanced +### 3.3. Advanced Be mindful with the information you enter, usually the minimal steps provided here are perfectly fine for 99% of all systems. If you change settings, you might break the system installation or configuration. @@ -78,9 +74,9 @@ Be mindful with the information you enter, usually the minimal steps provided he 9. The system will install and reboot 10. After the first reboot the system will configure itself and will be accessible in a couple of minutes -# 4. Removing a system +## 4. Removing a system -## 4.1. Easy +### 4.1. Easy 1. Power off your hardware or virtual machine 2. Login to [Red Hat Ansible Tower (AWX)](https://rhel-8-awx.psi.ch/) using your PSI credentials @@ -88,7 +84,7 @@ Be mindful with the information you enter, usually the minimal steps provided he 4. Enter the survey and finalize the launch -## 4.2. Advanced +### 4.2. Advanced 1. Power off your hardware or virtual machine 2. Login to [Red Hat Satellite](https://satint.psi.ch/hosts) using your PSI credentials @@ -97,7 +93,7 @@ Be mindful with the information you enter, usually the minimal steps provided he 5. In the right upper corner of the host pane click "Delete" 6. Confirm the deletion -# 5. Accessing an installed system +## 5. Accessing an installed system RHEL-8 beta systems can be accessed with your PSI Active Directory Kerberos user and password. Including native Kerberos authentication.