beoconfig

Name

beoconfig -- Operate on Scyld ClusterWare cluster configuration files.

Synopsis

beoconfig [-a, --all "string"] [-c, --config file] [-h, --help] [-l, --syslog] [-i, --insert "string"] [-d, --delete "string" ] [-D, --deleteall "string"] [-r, --replace "string 1" "string 2"] [-n, --node Number]
[-u, --usage] [-V, --version]

Description

beoconfig parses the /etc/beowulf/config file and returns values associated with the keyword requested in the quote enclosed string parameter. This utility is intended for use in script files, to provide parameters from the config file.

Options

The following options are available to the beoconfig program.

-a, --all

Return all entries with specified keyword (default).

-c file, --config file

Read configuration file file. Reads /etc/beowulf/config by default.

-h, --help

Show this usage message.

-l, --syslog

Log error messages to syslog

-i, --insert "insert string"

Append the specified string to the config-file if it does not already exist

-d, --delete "delete string"

Delete the specified string from the config file

-D, --deleteall "delete string"

Delete ALL instances of specified string from the config file.

-r, --replace "search string" "replacement string"

replace "search string" with "replacement string"

-n, --node

Perform action on specified node only.

-u, --usage

Show a usage summary.

-V, --version

Show this version number.

Examples

[user@cluster user] $ export CLUSTERDEV='beoconfig interface'
[user@cluster user] $ echo CLUSTERDEV
  eth1

View MAC addresses for ALL nodes in the node-db

[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
none
none
00:50:45:CD:BE:61

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"
enabled
[root@cluster ~]#  beoconfig --node 3 "ipmi"
disabled
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. Say that the /etc/beowulf/config 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 five'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
none ##node number 000
none ##node number 001
none ##node number 002
none ##node number 003
none ##node number 004
none ##node number 005
none ##node number 006
none ##node number 007
none ##node number 008
none ##node number 009
node 00:11:22:33:44:55

Get the MAC address for node 10

[root@cluster ~]# beoconfig -n 10 node
00:11:22:33:44:55

See Also

beowulf-config(5), beonetconf(1), beosetup(1)