geni.rspec.emulab.emuext¶

Common set of RSpec extensions supported by many Emulab-based aggregates

exception geni.rspec.emulab.emuext.EmulabExtensionDuplicateStatement(classname)[source]¶

This exception gets thrown if something that was only supposed to get added once to a Request, Node, Link, etc. gets added multiple times.

class geni.rspec.emulab.emuext.InstantiateOn(parent)[source]¶

Added to a node to specify that it a Xen VM should be bound to (instantiated on) another node in the topology. Argument is the node instance or the client id of another node in the topology.

exception InvalidParent(parent)[source]¶

class geni.rspec.emulab.emuext.ProgramAgent(name, command, directory=None, onexpstart=False)[source]¶

Add an Emulab Program Agent, which can be controlled via the Emulab event system. Optional argument ‘directory’ specifies where to invoke the command from. Optional argument ‘onexpstart’ says to invoke the command when the experiment starts (time=0 in event speak). This is different than the Execute service, which runs every time the node boots.

class geni.rspec.emulab.emuext.setCollocateFactor(mfactor)[source]¶

Added to a top-level Request object, this extension limits the number of VMs from one experiment that Emulab will collocate on each physical host.

class geni.rspec.emulab.emuext.setDelayImage(urn)[source]¶

Added to a top-level Request object, this extension sets the disk image that will be used for all delay nodes configured for the experiment.

class geni.rspec.emulab.emuext.setForceShaping[source]¶

Added to a Link or LAN object, this extension forces Emulab link shaping to be enabled, even if it is not strictly necessary. This allows the link properties to be changed dynamically via the Emulab event system.

class geni.rspec.emulab.emuext.setPackingStrategy(strategy)[source]¶

Added to a top-level Request object, this extension controls the strategy used for distributing VMs across physical hosts

class geni.rspec.emulab.emuext.setRoutingStyle(style)[source]¶

Added to a top-level Request object, this extension controls the routing that is automatically configured on the experiment (data-plane) side of the network.

class geni.rspec.emulab.emuext.setUseTypeDefaultImage[source]¶

Added to a node that does not specify a disk image, this extension forces Emulab to use the hardware type default image instead of the standard geni default image. Useful with special hardware that should run a special image.