You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

pre_capture

  • Description
    • Configures the OS so that it can be captured by a provisioning module.
    • Configures the OS so that it will successfully boot after the captured image is reloaded on another resource.
    • Adds and configures drivers so that the image will load on other resources.
    • Removes files which should not be saved in the image.
    • Examples of tasks performed by the pre_capture subroutine:
      • Log off users which were created for the imaging reservation and delete the accounts
      • Set root and administrator passwords to standard, known values 
      • Disable and delete page or swap files
      • Delete temp files
      • Copy scripts and utilities to the computer which are required after the computer boots up but before it has network connectivity
      • Copy drivers to the computer
      • Run a generalization or sealing utility such as Sysprep.exe
  • Expected Beginning State
    • Resource is up and accessible
    • Administrator has configured the resource
    • Administrator may or may not have logged out
  • Expected Ending State
    • (Default) Resource is shut down and turned off
    • Image captured of resource can be loaded and booted on other hardware
    • Loaded image will successfully boot up, establish network connectivity, and be accessible by the OS module's post_load() subroutine
  • Called By
    • Provisioning module's capture() subroutine
  • Arguments & Calling Environment
    • Must only be called as an object method of an OS object ($os->pre_capture()) 
    • Optional Argument:
      • Name: end_state
      • Type: hash reference
      • Description:
        • Instructs pre_capture() to leave the resource in a particular state after the subroutine's tasks are complet instead of shutting down the resource.
      • Possible Values:
        • on - Leave the resource on.  Do not shut it down or reboot it.
        • off (Default) - Shut the resource down.
        • reboot - Initiate a reboot and return.
  • Return Values
    • 1
      • All pre_capture tasks completed successfully.
      • Resource was either shut down or left in the state specified by the end_state argument.
      • Provisioning module can proceed to capture the image.
    • 0
      • Resource OS could not be completely prepared to be captured.
      • Provisioning module should not proceed to capture the image.
  • No labels