...

• 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

...

• 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()) 
  • No Arguments
• Return Values
  • 1
    • ...
  • 0
    • ...
  • Undefined
    • ...