beoconfig – View or manipulate a Scyld ClusterWare configuration files.


beoconfig [-a, –all string] [-c, –config file] [-d, –delete string] [-D, –deleteall string] [-i, –insert string] [-r, –replace string1 string2] [-n, –node nodes] [-w, –withcomments] [-l, –syslog] [-h, –help] [-u, –usage] [-V, –version]


beoconfig manipulates a Scyld ClusterWare configuration file to insert, replace, or delete “string” entries. A “string” consists of an initial keyword, plus zero or more parameters, plus an optional comment. This utility is commonly used in script files to retrieve parameters from the config file.


The following options are available to the beoconfig program.

-a, --all search-string

Return all entries with specified search-string keyword.

-c file, --config file

Read configuration file file. Default is /etc/beowulf/config.

-d, --delete string

Delete the specified string from the config file.

-D, --deleteall string

Delete all instances of specified string from the config file.

-h, --help

Show a usage message.

-i, --insert string

Append the specified string to the config file if it does not already exist. When inserting a “node” entry, you must also specify a --node nodes argument.

-l, --syslog

Log error messages to the syslog (/var/log/messages).

-n, --node nodes

Perform action on specified nodes only. Nodes can be specified individually, as ranges, or as a comma-separated list of individual nodes and/or ranges.

-r, --replace <string1 string2>

Replace string1 with string2.

-u, --usage

Show a usage summary.

-V, --version

Show this version number.

-w, --withcomments

Show entries including comments.


[user@cluster user] $ export CLUSTERDEV="beoconfig interface"
[user@cluster user] $ $CLUSTERDEV

View MAC addresses for all nodes in /etc/beowulf/config:

[user@cluster user] $ beoconfig -a "node"
00:50:45:01:03:68 00:50:45:01:03:69
00:50:45:5C:29:F6 00:50:45:5C:29:F7
00:50:45:BB:A6:EA 00:50:45:BB:A6:EB

Demonstrate –withcomments

[root@cluster ~]#  beoconfig --insert "newkeyword param1 # with comment"
[root@cluster ~]#  beoconfig newkeyword
[root@cluster ~]#  beoconfig -w newkeyword
param1 # with comment
# Now remove the unnecessary "newkeyword" entry:
[root@cluster ~]#  beoconfig -d newkeyword

Enable only Nodes 1, 2 and 8, to use IPMI

[root@cluster ~]#  beoconfig --node 1 --insert "ipmi enabled"
[root@cluster ~]#  beoconfig --node 8 --insert "ipmi enabled"
[root@cluster ~]#  beoconfig --node 2 --insert "ipmi enabled"
[root@cluster ~]#  beoconfig --node 1 "ipmi"
[root@cluster ~]#  beoconfig --node 3 "ipmi"

Looking in /etc/beowulf/config, one will see that the ‘ipmi’ keyword has a global value of ‘disabled’. However, there is another ‘ipmi’ keyword entry, and this one has an embedded node-set.

[root@cluster ~]# cat /etc/beowulf/config | grep ipmi
ipmi disabled
ipmi 1-2,8 enabled

Replace functionality: Suppose the config file has a ‘nodewake’ line to invoke an IPMI version 2.0 script for nodes 1 through 10, but node 5 has been replaced with a machine that supports only IPMI version 1.5. An admin must now replace node 5’s nodewake script.

[root@cluster ~]#  cat /etc/beowulf/config | grep nodewake
#nodewake /usr/lib/beoboot/bin/node_wake_ipmi
nodewake 1-10 /nfs/support/scripts/nodeup_ipmiv2.0
[root@cluster ~]#  beoconfig --node 5 --replace "nodewake *" \
                      "nodewake /nfs/support/scripts/nodeup_ipmiv1.5"
[root@cluster ~]#  cat /etc/beowulf/config | grep nodewake
#nodewake /usr/lib/beoboot/bin/node_wake_ipmi
nodewake 1-4,6-10 /nfs/support/scripts/nodeup_ipmiv2.0
nodewake 5 /nfs/support/scripts/nodeup_ipmiv1.5

Insert node-holes for node’s 0 through 9, while adding a MAC address for node 10

[root@cluster ~]#  beoconfig -a node
[root@cluster ~]#  beoconfig -i "node 00:11:22:33:44:55 " --node 10
[root@cluster ~]#  beoconfig -a node
off ##node number 000
off ##node number 001
off ##node number 002
off ##node number 003
off ##node number 004
off ##node number 005
off ##node number 006
off ##node number 007
off ##node number 008
off ##node number 009
node 00:11:22:33:44:55

Get the MAC address for node 10

[root@cluster ~]# beoconfig -n 10 node