Provisioning module objects are created by State.pm::initialize() when a new state object is created.
Provisioning module objects are available within state modules and OS modules
Provisioning module objects are not available within other types of modules for safety.
Explain:
define what we mean by "provisioning system"
give examples of provisioning systems
could be bare metal, virtual, differentiated, undifferentiated, a service, a special piece of hardware, eventually VCL could provision various types of resources
relationships among mgt nodes, computers, provisioning systems (such as computer is assigned 1 prov system at a time)
computer.provisioningid
provisioning table
future: management node to provisioning mapping
provisioning module implementation is responsible for knowing which OS interactions are necessary
image.pm calls provisioner->capture, new.pm calls provisioner->load, it calls OS subs as necessary
Provisioning Module Subroutines
...
load
Anchor
load
load
Description
A provisioning module's load() subroutine is responsible for provisioning the node.
This means starting a virtual machine, loading a image to disk, or nothing in the case of the standalone lab machine...
Expected Beginning State
...
Expected Ending State
...
Called By
...
Arguments & Calling Environment
Must only be called as an object method of a provisioning object ($provisioner->pre_capture())
No Arguments
Return Values
1
...
0
...
Undefined
...
power_off
Anchor
power_off
power_off
Description
...A provisioning module's power_off() subroutine is responsible for powering off or down a node.
Expected Beginning State
...
Expected Ending State
...
Called By
...
Arguments & Calling Environment
Must only be called as an object method of a provisioning object ($provisioner->pre_capture())
No Arguments
Return Values
1
...
0
...
Undefined
...
power_on
Anchor
power_on
power_on
Description
...A provisioning module's power_on() subroutine is responsible for powering on a node.
Expected Beginning State
...
Expected Ending State
...
Called By
...
Arguments & Calling Environment
Must only be called as an object method of a provisioning object ($provisioner->pre_capture())
No Arguments
Return Values
1
...
0
...
Undefined
...
get_current_image
Anchor
get_current_image
get_current_image
Description
A provisioning module's get_current_image() subroutine is responsible for trying to figure out what image is loaded on the node. By reading currentimage.txt located on the node's in root's user directory. This routine can be copied from another module.
Expected Beginning State
...
Expected Ending State
...The node is expected to be online and accessible.
Called By
...node_status()
Arguments & Calling Environment
Must only be called as an object method of a provisioning object ($provisioner->pre_capture())
No Arguments
Return Values
1
...
0
...
Undefined
...
get_image_size
Anchor
get_image_size
get_image_size
Description
..A provisioning module's get_image_size() subroutine is responsible for collected the disk usage of the image within the image library.
Expected Beginning State
...N/A
Expected Ending State
...
Called By
...
Arguments & Calling Environment
Must only be called as an object method of a provisioning object ($provisioner->pre_capture())