Files
gitea-pages/admin-guide/deployment/console_installation.md
2024-08-08 13:07:25 +02:00

36 lines
1.5 KiB
Markdown

# 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