************************ elbe-initvm ************************ .. __name: NAME ==== elbe-initvm - High Level Interface to the ELBE System. Allows one to create an initvm and directly build Rootfilesystems using ELBE. .. __synopsis: SYNOPSIS ======== :: elbe initvm [options] attach elbe initvm [options] create [ | ] elbe initvm [options] submit [ | ] elbe initvm [options] start elbe initvm [options] stop elbe initvm [options] ensure .. __description: DESCRIPTION =========== This command allows one to build and manage an initvm. Initvms are managed via libvirt, and its necessary, that a user is a member of the libvirt group. .. __options: OPTIONS ======= --directory Directory where the initvm resides, or is supposed to reside. (Defaults to *./initvm*) --cdrom ISO image of Binary cdrom. --devel Install elbe Version from the current working into initvm. --skip-download After the build has finished, the generated Files are downloaded from the initvm to the host. This step is skipped, when this option is specified. --output Directoryname where the generated and downloaded Files should be saved. The default is to generate a directory with a timestamp in the current working directory. --skip-build-bin Skip building binary repository CDROM, for exact reproduction. --skip-build-sources Skip building source CDROM. --output Output downloaded files to . --keep-files Don’t delete elbe project files after a build in the initvm use *elbe control list_projects* to get a list of available projects --writeproject Write project name to . --nesting Allow initvm to support nested kvm. This makes /proc/cpuinfo inside initvm differ per host. --build-sdk Also make *initvm submit* build an SDK. .. __xml_options: XML OPTIONS =========== --variant comma separated list of variants --proxy add proxy to mirrors .. __commands: COMMANDS ======== *attach* Attach to the initvm console, which is accessed via virsh. *create* [ \| ] This command triggers a complete rebuild of the Elbe XML File. It also includes rebuilding the initvm. If an initvm is already available, you should use the *submit* command, to build a project in an existing initvm. Note that only a single initvm can be running on your host. When a iso Image with the binaries has been built earlier, it can also be used to recreate the original image. The source.xml from the iso will be used, and all the binary packages available also. *submit* [ \| ] This command triggers a complete rebuild of the Elbe XML File. It will however use an existing initvm. When a iso Image with the binaries has been built earlier, it can also be used to recreate the original image. The source.xml from the iso will be used, and all the binary packages available also. *start* Start initvm in the Background. *stop* Shutdown running initvm. *ensure* Make sure an initvm is running in the Background. .. __examples: Examples ======== - Build an initvm and on that build an elbe example: :: $ elbe initvm create /usr/share/doc/elbe-doc/examples/rescue.xml - Reuse the initvm built in the previous Step to build another example xml :: $ elbe initvm submit /usr/share/doc/elbe-doc/examples/elbe-desktop.xml .. __see_also: SEE ALSO ======== elbe-control1 .. __elbe: ELBE ==== Part of the elbe1 suite