update documentation to latest insights

This commit is contained in:
2024-11-19 09:41:46 +01:00
parent 4a3e1f6c98
commit 99e35b8473
2 changed files with 35 additions and 35 deletions
+17 -6
View File
@@ -7,17 +7,17 @@ Repo containing cfg for **ecmc servers**, only **ecmc servers**.
## Usage
Clone the repository to the host:
```
Clone this repository to hosts:
```shell
cd /ioc/hosts/<hostname>
git clone git@git.psi.ch:motion/ecmc_server_cfg.git cfg
# then check the settings are valid
```
then check the settings are valid. A reboot is needed for the settings to take effect.
## note on IGB driver
The file ETHERCATDRVR defines what devices to use:
The file ETHERCATDRVR defines what drivers to use:
```
DEVICE_MODULES="igb generic"
```
@@ -37,6 +37,17 @@ ec_master 421888 4 ec_igb,ec_generic
In this case igb (ec_igb) driver is in use.
## add EtherCAT network interfaces
In ETHERCATDRVR define the EtherCAT interfaces by adding `LINK_DEVICES` and `LINK_DEVICE_MACS`
```shell
DEVICE_MODULES="igb generic"
LINK_DEVICES="ens2f0 ens2f1 ens2f2 ens2f3"
LINK_DEVICE_MACS="d4:f5:ef:b3:7b:d8 d4:f5:ef:b3:7b:d9 d4:f5:ef:b3:7b:da d4:f5:ef:b3:7b:db"
```
# workflow for new server
See [WORKFLOW](WORKFLOW.md)
+18 -29
View File
@@ -1,55 +1,44 @@
# workflow for a new ecmc server
## A bit unclear
* Setup ILO, 8213 (maybe hardware group)
## hardware group (Kurt)
* Order servers (keeps stock)
* Add server to packet-fence (default to office network)
* Add users to ecmc server
* Add hostname (need info from controls)
* Add ILO network interface to packet-fence (default role: office network)
* Add ILO hostname if provided in advance, otherwise controls needs to take care
* Keeps inventory up to date
* Sometimes equips with **empty** usb stick
* Install (power and network)
## controls
* Update boot parameters to boot from usb
* Add network interface to boot from (e.g. eth0) to packet-fence
* Set [role](#packet-fence-roles) in packet-fence for ILO and boot network interfaces
* [Prepare usb stick](#prepare-usb-stick)
* [Add host to warewulf config nodes.conf](#Add-warewulf-conf)
* [Add host startup cfg](#Add-ecmc-server-cfg)
* Configure IOC:s
* [Add host startup cfg](README.md)
* Configure IOC's (e.g. shellbox)
# prepare usb stick
# packet-fence roles
Prepare a boot usb stick:
```bash
# copy to usb stick
sls:
https://jira.psi.ch/browse/SLS2CASIT-96
# prepare boot usb stick
```shell
# copy EFI folder to usb stick
cp -r /afs/psi.ch/group/8211/anicic/iPXE/warewulf-ipxe/USBstick/EFI /path/to/your/usbstick
```
# add warewulf conf
# add server to warewulf nodes.conf
Add server to warewulf config (easiest to edit directlly in gitlab page):
Add server to warewulf config (easiest to edit directly in gitlab page):
https://git.psi.ch/controls-ci/warewulf-node-config/-/blob/master/nodes.conf
**NOTE**: The simplest is to copy another host and update the needed data.
**NOTE**: Configure only the boot network interface in nodes.conf. EtherCAT interfaces are configured in ETHERCATDRVR (see [README.md](README.md))
**WARNING**: No tabs are allowed, make sure the indention is made with spaces.
After the file has been updated, make sure that the pipelines passes:
https://git.psi.ch/controls-ci/warewulf-node-config/-/pipelines
# add ecmc server cfg
See [README](README.md), basically:
Clone this repository to the host dir:
```
cd /ioc/hosts/<hostname>
git clone git@git.psi.ch:motion/ecmc_server_cfg.git cfg
# Then check the settings are valid
# A reboot is needed for the settings to take effect.
```