remove redundancies in install documentation

2024-09-24 16:54:01 +02:00
parent f007817031
commit 682947346e
5 changed files with 14 additions and 36 deletions
@@ -3,7 +3,9 @@
 Linux systems are installed using PXE and Kickstart. The Kickstart
 configuration is auto-generated base on the configuration stored in sysdb/bob.

+```{info}
 When PXE boot is not an option, e.g. in restricted networks, it is possible to start iPXE from a USB stick or other media.
+```

 The general process for a installation is:

@@ -12,11 +14,10 @@ The general process for a installation is:
 3. Reboot the system and trigger a PXE boot (usually by pressing F12 during
   POST)

-The default way to interact with sysdb is to use [bob](https://git.psi.ch/linux-infra/bob). `bob` is already set up on `lxsup.psi.ch` for general use.
+The default way to interact with sysdb is to use [bob](https://git.psi.ch/linux-infra/bob). `bob` is already set up on `lxsup.psi.ch` for general use. Remember that you need a valid Kerberos ticket before modifying a sysdb entry via `bob`.

-Altenatively you many have on your workstation a local copy of `bob`. This can be done by installing the RPM from the pli-misc repository - https://repos.psi.ch/rhel8/latest/pli-misc/ or by installing the Python package manually.
+Altenatively you many have on your workstation a local copy of `bob`. This can be done by installing the RPM from the pli-misc repository - https://repos.psi.ch/rhel8/latest/pli-misc/ or by installing the Python package manually. More details regaring `bob` can be found [here](https://git.psi.ch/linux-infra/bob).

-You might need to set a `PSI_BOB_USER` environment variable (`export PSI_BOB_USER=<you-name-it>`) or use the option `--user` if your local user is different from the one on sysdb.

 ## Sysdb Configuration

@@ -36,21 +37,20 @@ bob node set-attr $FQDN ipxe_installer=rhel8install
 bob node set-attr $FQDN puppet_role=role::server
 ```

-and optional:
+and **optional**:
 ```bash
 # static IP address (options: static, dhcp)
 bob node set-attr $FQDN network=static
+
+# if you want to use hiera groups and sub-groups
 bob node set-attr $FQDN puppet_group=cluster
 bob node set-attr $FQDN puppet_subgroup=compute
+
+# use a differnt puppet environment
 bob node set-attr $FQDN puppet_env=prod
 ```


-Finally ensure that the node is set to `netboot`:
-```bash
-bob node netboot $FQDN
-```
-
 ### Example

 Minimal example:
@@ -6,25 +6,10 @@

 ## Network Installation

-The machine you want to install needs to be [registered in `sysdb`](../../deployment/basic_installation.md). If you don't have the bob command installed locally you can login to __lxsup.psi.ch__ to use it. Remember that you need a valid Kerberos ticket before modifying a sysdb entry via `bob`.
-More details regaring `bob` can be found [here](https://git.psi.ch/linux-infra/bob).
-
-Optional you can set `netboot` and RHEL 8 installer but that can also be selected manually in be boot menu:
-
-```
-bob node netboot $FQDN
-bob node set-attr $FQDN ipxe_installer=rhel8install
-```
-
-
+The machine you want to install needs to be [registered in `sysdb`](../../deployment/basic_installation.md). 

 ### Installation with UEFI
-Start the machine and select network boot (if not already the default), then you get following menu:  
-![Grub default menu](_static/installation_grub_default.png)
-
-There select "Install Red Hat Enterprise Linux 8.7"
-![Grub menu selection for iPXE](_static/installation_grub_select.png)  
-
+This is the default (and only really supported) installation mode - No manual steps are needed!

 __NOTE:__ After the installation the boot order will be changed to localboot again! So if you reinstall make sure that you re-set the bootorder via the efi menu or the commandline: https://linux.die.net/man/8/efibootmgr
 ```
@@ -6,17 +6,10 @@

 ## Network Installation

-The machine you want to install needs to be [registered in `sysdb`](../basic_installation.md). If you don't have the bob command installed locally you can login to __lxsup.psi.ch__ to use it. Remember that you need a valid Kerberos ticket before modifying a sysdb entry via `bob`.
-More details regaring `bob` can be found [here](https://git.psi.ch/linux-infra/bob).
+The machine you want to install needs to be [registered in `sysdb`](../basic_installation.md).

-Optional you can set `netboot` and RHEL 9 installer but that can also be selected manually in be boot menu:
-
-```
-bob node netboot $FQDN
-bob node set-attr $FQDN ipxe_installer=rhel9install
-```
 ### Installation with UEFI
-Start the machine and select network boot
+Default and supported mode.

 ### Installation with Legacy BIOS 
-Not supported yet
+Not supported!