June 20, 2007"> 7"> ganeti-os-interface"> Debian"> GNU"> GPL"> ]> 2006 2007 Google Inc. &dhdate; &dhucpackage; &dhsection; ganeti 1.2 ganeti guest OS interface specifications for guest OS types The method of supporting guest operating systems in Ganeti is to have, for each guest OS type, a directory containing a number of required files. There are four required files: create, import, export (executables) and ganeti_api_version (text file). create -i instance_name -b blockdev_sda -s blockdev_sdb The create command is used for creating a new instance from scratch. The argument to the -i option is the FQDN of the instance, which is guaranteed to resolve to an IP address. The create script should configure the instance according to this name. It can configure the IP statically or not, depending on the deployment environment. The -b and -s options denote the block devices which will be visible in the instance as sda and sdb. The sda block device should be used for the root disk (and will be passed as the root device for linux kernels). The sdb device should be setup for swap usage. import -i instance_name -b blockdev_sda -s blockdev_sdb The import command is used for restoring an instance from a backup as done by export. The arguments are the same as for create and the output of the export will be provided on stdin. export -i instance_name -b blockdev_sda This command is used in order to make a backup of the instance. The command should write to stdout a dump of the given block device. The output of this program will be passed to the import command. The options have the same meaning as for create and import, with the exception that the argument to -i denotes an existing instance. The ganeti_api_version file is a plain text file containing the version of the guest OS api that this OS definition complies with. The version documented by this man page is 4, so this file must contain 4 followed by a newline. All the scripts should display an usage message when called with a wrong number of arguments or when the first argument is -h or --help. &footer;