create-image

Packages an existing system up as an image

This command performs the complex process of converting an existing virtual system into a Cloudmin image. It has three required parameters : --host followed by the hostname of the system to image, --desc followed by a description of the image, and --id followed by a new unique image ID. The ID is typically formatted like type-os-software, such as xen-centos6-virtualmin.

If the ID refers to an image that already exists and you want to replace it, add the --overwrite paramter to the command line. You should also use --version followed by a version number, to make it easier to keep track of different instances of the same image.

By default, files created as part of the image will be copied to the default storage locations. Typically this is just the /var/webmin/server-manager directory on the Cloudmin master. However, you can use the --storage flag followed by a storage spec to use a different location. This is typically given in host:path format.

Creation takes several minutes, but the command will display each step in the process as it proceeds, and inform you of its final success or failure.

Example usage

  cloudmin create-image --host xenrails.home --desc "Image with rails" --id xen-centos5.0-rails
  Creating temporary directory for image files ..
  .. done
  Shutting down system ..
  .. done
  Mounting Xen instance filesystem ..
  .. mounted on /mnt/xen-xenrails
  Removing Virtualmin licence ..
  .. done
  Resetting root password ..
  .. done
  Removing authorized SSH keys ..
  .. done
  Un-mounting Xen instance filesystem ..
  .. done
  Compressing filesystem image ..
  .. done
  Transferring image files to Cloudmin master ..
  .. transferred all files
  Deleting compressed filesystem image ..
  .. done
  Mounting Xen instance filesystem ..
  .. mounted on /mnt/xen-xenrails
  Undoing licence and password changes ..
  .. done
  Un-mounting Xen instance filesystem ..
  .. done
  Starting up system ..
  .. done
  Refreshing system status ..
  .. done

Command Line Help

Converts an existing virtual system into an image.

cloudmin create-image --host name
                      --desc "image description"
                      --id image-id
                     [--overwrite]
                     [--version number | --inc-version]
                     [--no-serial]
                     [--no-compress]
                     [--storage spec]
                     [--ignore-fsck]