reshuffling

admin-guide/deployment/console_installation.md

@@ -0,0 +1,36 @@
+# 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