Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

This is a short guide on how to set up development environment for a OS Module.

Install VCL

  • ...

Setting up a new OS Module

  • Start by creating a Module/OS/ file.
    • See the other OS Module for examples.
    • Set the package path in the file
      package VCL::Module::OS::...;
  • Add an entry to the module table pointing to your new module with the package path mentioned above.
  • Add an entry to the OS table pointing to the entry you add to the module table.
  • Add entries to the image and imagerevision table for a base new image, with image.OSid pointing to the entry you add to the OS table.
  • Enter the computer information for a loaded new machine into VCL and make sure that the management node can access this machine via SSH.
  • Insert the code you want to test at the
    beginning of the process() subroutine in, followed by a call to exit:
Code Block
sub process {
my $self = shift;

my $request_data = $self->data->get_request_data();
my $imagerevision_id = $self->data->get_imagerevision_id();

print "\n\n---\n\n";

my $ip = $self->os->get_public_ip_address();
print "IP: $ip\n";

print "\n\n---\n\n";
  • To test things over and over again, run a script which inserts entries into the request and reservation tables with the request state and laststate set to 'new'. vcld picks up the reservation, configures everything as it would for a normal reservation, calls, test code is executed, then the process exits.
  • Once this is set up, it should be pretty efficient to test all of the subroutines in OS module.