fix headings

This commit is contained in:
2021-08-04 16:47:31 +02:00
parent f9b71f2839
commit ad9722bf5d
+13 -17
View File
@@ -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<br/>
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.