# 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. Register a static ip in https://qip.psi.ch/qip for the console
2. Create the necessary bob entries for the machine:
```bash
bob node add <your-console.psi.ch> <hiera environment without "data-"> netboot
bob node add-mac <your-console.psi.ch> xx:xx:xx:xx:xx:xx
bob node set-attr <your-console.psi.ch> network=static
bob node set-attr <your-console.psi.ch> ipxe_installer=rhel8install

bob node set-attr <your-console.psi.ch> puppet_role=role::console
bob node set-attr <your-console.psi.ch> puppet_env=prod
bob node set-attr <your-console.psi.ch> puppet_group=default  # replace default if needed

# Optional
bob node set-attr <your-console.psi.ch> puppet_subgroup=collector
```

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