diff --git a/README.md b/README.md index e629dc3..1b5edca 100644 --- a/README.md +++ b/README.md @@ -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/ 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) diff --git a/WORKFLOW.md b/WORKFLOW.md index 34bcb14..c35d115 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -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/ -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. -```