# Installation Guide

## 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.1. How to receive help

There are two ways to receive help.

1. If you have a minor question or easy request (< 5 minutes of effort) you can contact the PSI Linux Engineering Slack channel via https://controls-ha.slack.com/archives/CUZDL5094
2. Any other requests can be made by opening a request with the Linux Engineering team under [Issues](https://git.psi.ch/linux/engineering/documentation/rhel-8-beta-guide/issues)
Please explain what is the exact problem or question and provide what you would behaviour you would expect from the system/solution

List of documentation that can answer general questions:

* [Product Documentation for Red Hat Enterprise Linux 8](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/)
* [Product Documentation for Red Hat Satellite 6.7](https://access.redhat.com/documentation/en-us/red_hat_satellite/6.7/)
* [Ansible Tower User Guide](https://docs.ansible.com/ansible-tower/latest/html/userguide/index.html)

There is also the [PSI Linux Mailing List](mailto:linux@lists.psi.ch) that you can always ask Linux related questions. It is even better to use as a lot of readers will also get answers to questions they might have had in the future.
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

* 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

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.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

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)
3. **IMPORTANT: Select a hostgroup that is appropriate to the designated department eg. "RHEL-8/AIT"**
4. Enter the survey and finalize the launch (Your PSI username and password must be supplied to allow the template to create the Host) 
5. Power on you hardware or virtual machine and boot from network
6. In the network boot prompt enter "satint" and press enter
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

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.

1. Login to [Red Hat Satellite](https://satint.psi.ch/hosts) using your PSI credentials
2. Click on Hosts->Create Host
3. Enter the designated hostname without the domain suffix psi.ch
4. Select a hostgroup starting with "RHEL-8/..."
5. In the "Interfaces" tab provide a mac address for the interface
6. Click "Submit" to create the host
7. Power on you hardware or virtual machine and boot from network
8. In the network boot prompt enter "satint" and press enter
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.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
3. Launch the "Delete Host" [template](https://rhel-8-awx.psi.ch/#/templates?template_search=page_size:20;order_by:name;type:workflow_job_template,job_template;search:Host;search:Delete)
4. Enter the survey and finalize the launch 


### 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
3. Click on Hosts->All Hosts
4. Click in your Host's name
5. In the right upper corner of the host pane click "Delete"
6. Confirm the deletion

## 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.

```shell
kinit spreitzer_s@D.PSI.CH
ssh -K my-new-system@psi.ch
su -
```

or

```shell
ssh root@my-new-system.psi.ch
```

> The default root password for the RHEL-8 beta is 'redhatredhat' without the quotation marks