# Console Installation

## Overview
A console is a multi user system (ideally running on standard hardware) with a graphical desktop. The individual users do not have admin rights on the system and all configuration and packages must be deployed by puppet (ensuring reproducibility and fast re-installation in case of hardware failures, etc.)

Consoles are, for example, used at experimental stations, beamlines, endstations. 

The standard naming of a console is: __<group>-cons-<two digit number>__
Due to various reasons these systems __must__ have a static IP assigned.

## Installation Workflow

1. Email to linux-eng@psi.ch to remove console from sls/swissfel environment (need to know hostname, command to be executed on puppet server is: `rm /srv/puppet/alias_reservation/<hostname>*`)
1. Upgrade BIOS/UEFI
1. "Activate" UEFI (instead of BIOS) - ensure secure boot is disabled
1. Register the machine in Package-Fence: https://enter.psi.ch:1443 to give it access to the PSI network
1. Register a static ip in https://qip.psi.ch/qip (or via request to the Network Team (via ServiceNow)) for the console 
2. Create the necessary bob entries for the machine:
```bash
bob node delete x12sa-cons-02
bob node add --environment sls_beamlines --group console --sub-group x12sa --boot netboot --mac 84:a9:3e:60:9b:16 --install rhel9 x12sa-cons-02
```

3. Create a host specific file (`<your-console.psi.ch>.yaml`)  in the respective hiera repository/directory with the following content:

```yaml
networking::setup: auto_static_ip
```

4. Ensure that the UEFI/BIOS is set to netboot
5. Kickstart the machine