Files
gitea-pages/admin-guide/deployment/console_installation.md

1.7 KiB

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 the machine in Package-Fence: https://enter.psi.ch:1443 to give it access to the PSI network
  2. Register a static ip in https://qip.psi.ch/qip (or via request to the Network Team (via ServiceNow)) for the console
  3. Create the necessary bob entries for the machine:
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
  1. Create a host specific file (<your-console.psi.ch>.yaml) in the respective hiera repository/directory with the following content:
networking::setup: auto_static_ip
  1. Ensure that the UEFI/BIOS is set to netboot
  2. Kickstart the machine