qemu-toolkit 0.2.18 → 0.3.0

data/doc/vmadm.1.ronn

@@ -0,0 +1,86 @@
+
+# vmadm(1) -- manages qemu-toolkit virtual machines
+
+## SYNOPSIS
+
+`vmadm` [-h]<br>
+`vmadm list`<br>
+`vmadm create` <name><br>
+`vmadm start` [--bootiso <iso_file>]<name><br>
+`vmadm shutdown` <name><br>
+`vmadm kill` <name><br>
+`vmadm monitor` <name><br>
+`vmadm vnc` <name><br>
+`vmadm console` <name><br>
+
+## DESCRIPTION
+
+The `vmadm` command manages virtual machines. A virtual machine is defined 
+by using the `virtual_machine` syntax in a file below `/etc/qemu-toolkit`. 
+(see qemu-toolkit-configuration(7)) 
+
+  * `vmadm list`:
+    Lists all virtual machines that are defined on this system. 
+  
+  * `vmadm create` <name>: 
+    Creates a new virtual machine definition and fills it with sensible default
+    values. 
+  
+  * `vmadm start` <name>: 
+    Starts a virtual machine using QEMU/KVM. 
+    
+    * `--bootiso` <iso_file>:
+      Boots the virtual machine once from virtual cdrom backed by the iso file
+      given. Upon reboot, the machine will use its first disk to boot. 
+    
+  * `vmadm shutdown` <name>: 
+    Sends the virtual machine a system/powerdown event. 
+    
+  * `vmadm kill` <name>: 
+    Immediately kills the virtual machine.
+    
+  * `vmadm monitor` <name>: 
+    Enters an interactive monitor mode that controls the virtual machine. The
+    machine must be running for this to work. Use Control+D to exit. 
+    
+  * `vmadm vnc` <name>: 
+    Connect the terminal to a VNC server that displays the console of the 
+    virtual machine. 
+    
+  * `vmadm console` <name>: 
+    Connects the terminal to the serial console of the virtual machine. Note
+    that this must be specially configured for most guest OSes.
+    
+## EXAMPLES
+
+### Example 1 Boot a virtual machine
+The following command starts the virtual machine and boots it from its 
+first disk. 
+
+    # vmadm start my_vm
+    
+### Example 2 Install a virtual machine from ISO
+The following command boots the virtual machine from a virtual cdrom. The
+cdrom is backed by an ISO file called ubuntu.iso. 
+
+    # vmadm start my_vm --bootiso ubuntu.iso
+
+## BUGS
+
+When using iscsi targets, you have to relaunch the vm twice to get it to 
+start up. We have code in place to work around this, but it is not effective. 
+Work to fix this is underway. 
+
+## SEE ALSO
+
+qemu-toolkit-overview(7), qemu-toolkit-install(7),
+qemu-toolkit-configuration(7), storadm(1), vmadm(1), README(7)
+
+## AUTHORS
+
+Copyright (c) 2012 Kaspar Schiess. 
+
+## COPYRIGHT
+
+This tool is under a MIT license. Please see the LICENSE file in the original
+source.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: qemu-toolkit
 version: !ruby/object:Gem::Version
-  version: 0.2.18
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,35 +9,37 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-08 00:00:00.000000000 Z
+date: 2012-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clamp
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
-description: 
+        version: '0.5'
+description: ! "\n    qemu-toolkit is a collection of small tools that help in managing
+  and\n    running QEMU virtual machines on Illumos/OmniOS. It supports both\n    local
+  operation and SAN-style block storage via iSCSI. \n  "
 email: kaspar.schiess@technologyastronauts.ch
 executables:
 - vmadm
 - storadm
 extensions: []
 extra_rdoc_files:
-- README
+- README.md
 files:
 - LICENSE
-- README
+- README.md
 - lib/qemu-toolkit/backend/illumos.rb
 - lib/qemu-toolkit/config.rb
 - lib/qemu-toolkit/dsl.rb
@@ -52,12 +54,26 @@ files:
 - bin/storadm
 - bin/vmadm
 - bin/vmconnect
-homepage: 
-licenses: []
+- doc/index.txt
+- doc/qemu-toolkit-configuration.7
+- doc/qemu-toolkit-configuration.7.ronn
+- doc/qemu-toolkit-install.7
+- doc/qemu-toolkit-install.7.ronn
+- doc/qemu-toolkit-overview.7
+- doc/qemu-toolkit-overview.7.ronn
+- doc/README.7
+- doc/README.md
+- doc/storadm.1
+- doc/storadm.1.ronn
+- doc/vmadm.1
+- doc/vmadm.1.ronn
+homepage: http://kschiess.bitbucket.org/qemu-toolkit/README.7.html
+licenses:
+- MIT
 post_install_message: 
 rdoc_options:
 - --main
-- README
+- README.md
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -65,7 +81,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/README

@@ -1,7 +0,0 @@
-SYNOPSIS
-
-qemu-toolkit is a small set of scripts to control QEMU kvm virtualised
-machines on a set of illumos hosts.
-
-Have a look at 'storadm' and 'vmadm' - inline help will show you the
-possibilities.