Some miscellaneous configuration

Some items are not configured in ruby scripts instead of YAML files under /etc. This document list some of them.

1. How to change the default frisbee image filename?

When running command like "omf load all" without specifying the frisbee image filename, nodehandler4 will use the default image file, which is specified in file "/opt/nodehandler4-4.2.0/repository/system/exp/imageNode.rb", line 6, like this

defProperty('image', 'baseline.ndz', "Image to load on nodes")

Another thing need to mention is the "defaultImage" item in file "/etc/gridservices2/enabled/frisbee.yaml" does not work.

2. How to change the default NFS path for saving image?

When running command like "omf save [1,2]", node_1_2 will mount a NFS path from the server(10.10.0.10). The path is assigned in file
/opt/nodehandler4-4.2.0/lib/handler/node.rb around line 303 like this.

302   def saveImage(imgName = nil,
303                 nsfDir = 'frisbee:/export/orbit/image/tmp',
304                 disk = OConfig.DEFAULT_DISK)

You may change the default path directly in file node.rb. A better way is changing the invoking point at file
/opt/nodehandler4-4.2.0/repository/system/exp/saveNode.rb around line 15 like this.

 14   n.onNodeUp {|n|
 15     n.saveImage(nil,'your_server_IP_or_name:/your/own/NFS/path/for/images')
 16   }

3. All available parameters for the configuration of groups

In the experiment script, You need define groups which consist of one or several nodes like this below.

defGroup('firstWorker', [1,1]) {|node|

   # Associate the prototype to use with this group
   # and configure any eventual parameters
   #
   node.prototype("gentlePing", {
     'destination' => "192.168.0.2"
   })

   # Configure the wireless interface on the node(s) in this set
   node.net.w0.mode = "ad-hoc"
   node.net.w0.type = "g"
   node.net.w0.essid = "tutorial"
   node.net.w0.ip = "192.168.0.1"
}

All available parameters for a node are defined in file /opt/nodehandler4-4.2.0/lib/handler/nodeSet.rb, between line 843 and 852 like this

 843   VALID_PATHS = {
 844     "mode=" => %r{net/[ew][01]},
 845     "type=" => %r{net/[ew][01]},
 846     "rts=" => %r{net/[ew][01]},
 847     "rate=" => %r{net/[ew][01]},
 848     "essid=" => %r{net/[ew][01]},
 849     "ip=" => %r{net/[ew][01]},
 850     "channel=" => %r{net/[ew][01]},
 851     "tx_power=" => %r{net/[ew][01]},
 852     "enforce_link=" => %r{net/[ew][01]},
 853
 854     "net" => //
 855   }

"mode", "type", "rts", "rate", "essid", "channel", "tx_power" and "enforce_link" are eventually configured by iwconfig on nodes. So you may find valid value for these parameter with "man iwconfig". Parameter "ip" is configured by ifconfig with form like "192.168.0.1".

Valid network devices include "w0", "w1", "e0" and "e1", which correspond device ath0, ath1, eth0, and eth1 respectively on nodes. Don't try to configure w1 because there is only one wireless device(w0) on each node. Never use e0 for experiments because eth0 is the port that is used to communicate with Console and Service by nodes.