From johnf@paravon.sfbay.sun.com Thu Apr 16 08:55:10 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n3GFt9M8002904
	for <LSARC-ext@sac.sfbay.sun.com>; Thu, 16 Apr 2009 08:55:10 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n3GFt5xM004504;
	Thu, 16 Apr 2009 16:55:08 +0100 (BST)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KI700G0BAVPBQ00@brm-avmta-1.central.sun.com>; Thu,
 16 Apr 2009 09:55:01 -0600 (MDT)
Received: from paravon.sfbay.sun.com ([192.168.83.160])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KI700BHEAVN9Q50@brm-avmta-1.central.sun.com>; Thu,
 16 Apr 2009 09:54:59 -0600 (MDT)
Received: from paravon.sfbay.sun.com (localhost [127.0.0.1])
	by paravon.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n3GFsw8i004893;
 Thu, 16 Apr 2009 08:54:59 -0700 (PDT)
Received: (from johnf@localhost)
	by paravon.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n3GFsw2q004889; Thu,
 16 Apr 2009 08:54:58 -0700 (PDT)
Date: Thu, 16 Apr 2009 08:54:58 -0700 (PDT)
From: John Fischer <johnf@paravon.sfbay.sun.com>
Subject: virt-manager upgrade [LSARC/2009/243 FastTrack timeout 04/23/2009]
To: LSARC-ext@sun.com
Cc: matt.Keenan@sun.com
Message-id: <200904161554.n3GFsw2q004889@paravon.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 2612


Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 virt-manager upgrade
    1.2. Name of Document Author/Supplier:
	 Author:  Matt Keenan
    1.3  Date of This Document:
	16 April, 2009
4. Technical Description
The "Virtual Machine Manager" (virt-manager) is a desktop application 
for managing virtual machines. The Xen team is planning on delivering libvirt 
0.6.0 into snv_116, and this project will coincide with them and upgrade
from virt-manager 0.4.0 to virt-manager 0.6.1.  The project will be delivering 
into a minor release of Solaris.

Besides various bug fixes, only the CLI and some new gconf keys are modified 
within this new version of vert-manager.  The CLI additions are:

  --no-fork
    0.4.0 always ran in the foreground, by default 0.6.1
    runs in background, this option is provided for backwards compatibility

  --no-conn-autostart
    0.4.0 always prompted for xen connection at startup, 0.6.1 has new
    dom0 configuration option to auto connect to a given server on
    startup, this option disables this, again backwards compatibility.

  --debug
    output debug information


The new gconf keys stored in virt-manager.schema which just allow for the
customization of the GUI, and to save previous settings etc. and default
values are (all prefessed by /apps/virt-manager/):

    stats/enable-disk-poll   boolean=0   Poll Disk I/O
    stats/enable-net-poll    boolean=0   Poll Network I/O
    stats/enable-mem-poll    boolean=1   Poll Memory I/O
    stats/enable-cpu-poll    boolean=1   Poll CPU I/O
    console/grab-notify      boolean=1   Show grab notification
    details/show-toolbar     boolean=1   Show Toolbar
    new-vm/local-sound       boolean=1   Install sound device for local VM's
    new-vm/remote-sound      boolean=1   Install sound device for remote VM's

Thus, the changed interfaces are:

    Exported Interfaces        Stability      Comments
    -------------------------  -------------  --------------------------------
    /usr/bin/virt-manager      Volatile       Virtual manager GUI application,
                                              CLI change
    virt-manager.schema        Volatile       new gconf keys introduced

All imported interfaces and contracts remain the same.  See Virtual Machine 
Manager (LSARC/2007/175) for details.


6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		JDS - Desktop
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open


From john.fischer@sun.com Fri Apr 17 11:35:06 2009
Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n3HIZ5X1014844
	for <LSARC-ext@sac.sfbay.sun.com>; Fri, 17 Apr 2009 11:35:06 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n3HIYv3q026312
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Sat, 18 Apr 2009 02:35:04 +0800 (SGT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KI900707CYFCD00@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@sun.com); Fri, 17 Apr 2009 11:35:03 -0700 (PDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KI9004LMCYEZS90@nwk-avmta-1.sfbay.Sun.COM> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Fri,
 17 Apr 2009 11:35:03 -0700 (PDT)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n3HIZ2OZ009445	for
 <LSARC-ext@sun.com>; Fri, 17 Apr 2009 18:35:02 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009))
 id <0KI900900CUS5C00@mail-amer.sun.com> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@sun.com); Fri, 17 Apr 2009 12:35:02 -0600 (MDT)
Received: from [192.168.10.7] ([unknown] [76.20.56.47])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-5.01 64bit
 (built Feb 19 2009)) with ESMTPSA id <0KI900M2TCYDDX40@mail-amer.sun.com>; Fri,
 17 Apr 2009 12:35:02 -0600 (MDT)
Date: Fri, 17 Apr 2009 11:34:03 -0700
From: John Fischer <john.fischer@sun.com>
Subject: Re: virt-manager upgrade [LSARC/2009/243 FastTrack timeout 04/23/2009]
In-reply-to: <200904161554.n3GFsw2q004889@paravon.sfbay.sun.com>
Sender: john.fischer@sun.com
To: John Fischer <johnf@paravon.sfbay.sun.com>
Cc: LSARC-ext@sun.com, Matt.Keenan@sun.com
Reply-to: john.fischer@sun.com
Message-id: <49E8CB9B.9070903@sun.com>
MIME-version: 1.0
Content-type: multipart/mixed; boundary="Boundary_(ID_j5wE0PXEQ18XN9bDHQWTXg)"
X-PMX-Version: 5.4.1.325704
References: <200904161554.n3GFsw2q004889@paravon.sfbay.sun.com>
User-Agent: Thunderbird 2.0.0.21 (X11/20090323)
Status: RO
Content-Length: 7379

This is a multi-part message in MIME format.

--Boundary_(ID_j5wE0PXEQ18XN9bDHQWTXg)
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT

All,

Attached is the updated man page for this case.
I have put this in the case directory as well.

Thanks,

John

John Fischer wrote:
> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
> 	 virt-manager upgrade
>     1.2. Name of Document Author/Supplier:
> 	 Author:  Matt Keenan
>     1.3  Date of This Document:
> 	16 April, 2009
> 4. Technical Description
> The "Virtual Machine Manager" (virt-manager) is a desktop application 
> for managing virtual machines. The Xen team is planning on delivering libvirt 
> 0.6.0 into snv_116, and this project will coincide with them and upgrade
> from virt-manager 0.4.0 to virt-manager 0.6.1.  The project will be delivering 
> into a minor release of Solaris.
> 
> Besides various bug fixes, only the CLI and some new gconf keys are modified 
> within this new version of vert-manager.  The CLI additions are:
> 
>   --no-fork
>     0.4.0 always ran in the foreground, by default 0.6.1
>     runs in background, this option is provided for backwards compatibility
> 
>   --no-conn-autostart
>     0.4.0 always prompted for xen connection at startup, 0.6.1 has new
>     dom0 configuration option to auto connect to a given server on
>     startup, this option disables this, again backwards compatibility.
> 
>   --debug
>     output debug information
> 
> 
> The new gconf keys stored in virt-manager.schema which just allow for the
> customization of the GUI, and to save previous settings etc. and default
> values are (all prefessed by /apps/virt-manager/):
> 
>     stats/enable-disk-poll   boolean=0   Poll Disk I/O
>     stats/enable-net-poll    boolean=0   Poll Network I/O
>     stats/enable-mem-poll    boolean=1   Poll Memory I/O
>     stats/enable-cpu-poll    boolean=1   Poll CPU I/O
>     console/grab-notify      boolean=1   Show grab notification
>     details/show-toolbar     boolean=1   Show Toolbar
>     new-vm/local-sound       boolean=1   Install sound device for local VM's
>     new-vm/remote-sound      boolean=1   Install sound device for remote VM's
> 
> Thus, the changed interfaces are:
> 
>     Exported Interfaces        Stability      Comments
>     -------------------------  -------------  --------------------------------
>     /usr/bin/virt-manager      Volatile       Virtual manager GUI application,
>                                               CLI change
>     virt-manager.schema        Volatile       new gconf keys introduced
> 
> All imported interfaces and contracts remain the same.  See Virtual Machine 
> Manager (LSARC/2007/175) for details.
> 
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>    	6.4.1. Consolidation C-team Name:
> 		JDS - Desktop
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
> 

--Boundary_(ID_j5wE0PXEQ18XN9bDHQWTXg)
Content-type: text/plain; name=virt-manager.1.txt
Content-transfer-encoding: 7BIT
Content-disposition: inline; filename=virt-manager.1.txt

User Commands                                     virt-manager(1)



NAME
     virt-manager -  Desktop  application  for  managing  virtual
     machines

SYNOPSIS
     virt-manager  [-h,  --help]  [--profile=FILE]  [-c  URI,  --
     connect=URI]  [--debug]  [--no-dbus] [--no-fork] [--no-conn-
     autostart]      [--show-domain-creator]      [--show-domain-
     editor=UUID]    [--show-domain-performance=UUID]    [--show-
     domain-console=UUID] [--show-host-summary]

DESCRIPTION
     The "Virtual Machine Manager" (virt-manager)  is  a  desktop
     application for managing virtual machines.

     It presents a summary view of running domains and their live
     performance  &  resource  utilization statistics. A detailed
     view presents graphs showing performance & utilization  over
     time.  Ultimately it will allow creation of new domains, and
     configuration & adjustment of a domain's resource allocation
     & virtual hardware. An embedded VNC client viewer presents a
     full graphical console to the guest domain.

     You need root access to run virt-manager.

OPTIONS
     The following options are supported:

     --h, --help

         show this help message and exit.



     ---profile=FILE

         Generate runtime performance profile stats.



     --c URI, --connect=URI

         Connect to hypervisor at URI.



     ---debug

         Print debug output to stdout. Requires --no-fork option.






SunOS 5.10           Last change: 8 Oct 2007                    1






User Commands                                     virt-manager(1)



     ---no-dbus

         Disable DBus service for controlling UI.



     ---no-fork

         Don't fork into background on startup.



     ---no-conn-autostart

         Do not autostart connections.



     ---show-domain-creator

         Create a new virtual machine.



     ---show-domain-editor=UUID

         Edit a domain configuration.



     ---show-domain-performance=UUID

         Show a domain performance.



     ---show-domain-console=UUID

         Show a domain console.



     ---show-host-summary

         Show a host summary.



EXAMPLES
     Example 1: Launching virtual machine manager





SunOS 5.10           Last change: 8 Oct 2007                    2






User Commands                                     virt-manager(1)



     example% virt-manager

     Example 2: Show option information for virt-manager

     example% virt-manager -h

EXIT STATUS
     The following exit values are returned:

     0        Application exited successfully



     >0       Application exited with failure



FILES
     The following files are used by this application:

     /usr/bin/virt-manager           Executable for  the  virtual
                                     manager



     $HOME/.virt-manager/virt-manager.log
                                     Used to store  the  log  for
                                     virt-manager.



     /usr/share/virt-manager/*       virt-manager  Python  source
                                     code.



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWvirt-manager            |
    |_____________________________|_____________________________|
    | Interface stability         | Uncommitted                 |
    |_____________________________|_____________________________|


SEE ALSO
     virt-install(1M), virt-clone(1M),  virsh(1M),  vdiskadm(1M),
     xm(1M)



SunOS 5.10           Last change: 8 Oct 2007                    3






User Commands                                     virt-manager(1)



NOTES
     Written by Henry Zhang, Sun Microsystems Inc., 2007.

     Amended by Matt Keenan, Sun Microsystems Inc., 2009.



















































SunOS 5.10           Last change: 8 Oct 2007                    4




--Boundary_(ID_j5wE0PXEQ18XN9bDHQWTXg)--

From margot.miller@sun.com Tue Apr 21 11:04:15 2009
Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n3LI4EJc008428
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 21 Apr 2009 11:04:15 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n3LI47Ka017743;
	Wed, 22 Apr 2009 02:04:09 +0800 (SGT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KIG00N0LQ6V1900@nwk-avmta-2.sfbay.sun.com>; Tue,
 21 Apr 2009 11:04:07 -0700 (PDT)
Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KIG00IVWQ6TT560@nwk-avmta-2.sfbay.sun.com>; Tue,
 21 Apr 2009 11:04:05 -0700 (PDT)
Received: from [10.7.250.251]
 (punchin-client-10-7-250-251.SFBay.Sun.COM [10.7.250.251])
	by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3)
 with ESMTP id n3LI42SI191646; Tue, 21 Apr 2009 11:04:03 -0700 (PDT)
Date: Tue, 21 Apr 2009 10:59:05 -0700
From: Margot Miller <margot.miller@sun.com>
Subject: Re: virt-manager upgrade [LSARC/2009/243 FastTrack timeout 04/23/2009]
In-reply-to: <49E8CB9B.9070903@sun.com>
To: john.fischer@sun.com
Cc: John Fischer <johnf@paravon.sfbay.sun.com>, LSARC-ext@sun.com,
        Matt.Keenan@sun.com
Message-id: <49EE0969.6030503@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200904161554.n3GFsw2q004889@paravon.sfbay.sun.com>
 <49E8CB9B.9070903@sun.com>
User-Agent: Thunderbird 2.0b1 (X11/20070115)
Status: RO
Content-Length: 7561

+1

Margot


John Fischer wrote:
> All,
>
> Attached is the updated man page for this case.
> I have put this in the case directory as well.
>
> Thanks,
>
> John
>
> John Fischer wrote:
>> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
>> This information is Copyright 2009 Sun Microsystems
>> 1. Introduction
>>     1.1. Project/Component Working Name:
>>      virt-manager upgrade
>>     1.2. Name of Document Author/Supplier:
>>      Author:  Matt Keenan
>>     1.3  Date of This Document:
>>     16 April, 2009
>> 4. Technical Description
>> The "Virtual Machine Manager" (virt-manager) is a desktop application 
>> for managing virtual machines. The Xen team is planning on delivering 
>> libvirt 0.6.0 into snv_116, and this project will coincide with them 
>> and upgrade
>> from virt-manager 0.4.0 to virt-manager 0.6.1.  The project will be 
>> delivering into a minor release of Solaris.
>>
>> Besides various bug fixes, only the CLI and some new gconf keys are 
>> modified within this new version of vert-manager.  The CLI additions 
>> are:
>>
>>   --no-fork
>>     0.4.0 always ran in the foreground, by default 0.6.1
>>     runs in background, this option is provided for backwards 
>> compatibility
>>
>>   --no-conn-autostart
>>     0.4.0 always prompted for xen connection at startup, 0.6.1 has new
>>     dom0 configuration option to auto connect to a given server on
>>     startup, this option disables this, again backwards compatibility.
>>
>>   --debug
>>     output debug information
>>
>>
>> The new gconf keys stored in virt-manager.schema which just allow for 
>> the
>> customization of the GUI, and to save previous settings etc. and default
>> values are (all prefessed by /apps/virt-manager/):
>>
>>     stats/enable-disk-poll   boolean=0   Poll Disk I/O
>>     stats/enable-net-poll    boolean=0   Poll Network I/O
>>     stats/enable-mem-poll    boolean=1   Poll Memory I/O
>>     stats/enable-cpu-poll    boolean=1   Poll CPU I/O
>>     console/grab-notify      boolean=1   Show grab notification
>>     details/show-toolbar     boolean=1   Show Toolbar
>>     new-vm/local-sound       boolean=1   Install sound device for 
>> local VM's
>>     new-vm/remote-sound      boolean=1   Install sound device for 
>> remote VM's
>>
>> Thus, the changed interfaces are:
>>
>>     Exported Interfaces        Stability      Comments
>>     -------------------------  -------------  
>> --------------------------------
>>     /usr/bin/virt-manager      Volatile       Virtual manager GUI 
>> application,
>>                                               CLI change
>>     virt-manager.schema        Volatile       new gconf keys introduced
>>
>> All imported interfaces and contracts remain the same.  See Virtual 
>> Machine Manager (LSARC/2007/175) for details.
>>
>>
>> 6. Resources and Schedule
>>     6.4. Steering Committee requested information
>>        6.4.1. Consolidation C-team Name:
>>         JDS - Desktop
>>     6.5. ARC review type: FastTrack
>>     6.6. ARC Exposure: open
>>
> ------------------------------------------------------------------------
>
> User Commands                                     virt-manager(1)
>
>
>
> NAME
>      virt-manager -  Desktop  application  for  managing  virtual
>      machines
>
> SYNOPSIS
>      virt-manager  [-h,  --help]  [--profile=FILE]  [-c  URI,  --
>      connect=URI]  [--debug]  [--no-dbus] [--no-fork] [--no-conn-
>      autostart]      [--show-domain-creator]      [--show-domain-
>      editor=UUID]    [--show-domain-performance=UUID]    [--show-
>      domain-console=UUID] [--show-host-summary]
>
> DESCRIPTION
>      The "Virtual Machine Manager" (virt-manager)  is  a  desktop
>      application for managing virtual machines.
>
>      It presents a summary view of running domains and their live
>      performance  &  resource  utilization statistics. A detailed
>      view presents graphs showing performance & utilization  over
>      time.  Ultimately it will allow creation of new domains, and
>      configuration & adjustment of a domain's resource allocation
>      & virtual hardware. An embedded VNC client viewer presents a
>      full graphical console to the guest domain.
>
>      You need root access to run virt-manager.
>
> OPTIONS
>      The following options are supported:
>
>      --h, --help
>
>          show this help message and exit.
>
>
>
>      ---profile=FILE
>
>          Generate runtime performance profile stats.
>
>
>
>      --c URI, --connect=URI
>
>          Connect to hypervisor at URI.
>
>
>
>      ---debug
>
>          Print debug output to stdout. Requires --no-fork option.
>
>
>
>
>
>
> SunOS 5.10           Last change: 8 Oct 2007                    1
>
>
>
>
>
>
> User Commands                                     virt-manager(1)
>
>
>
>      ---no-dbus
>
>          Disable DBus service for controlling UI.
>
>
>
>      ---no-fork
>
>          Don't fork into background on startup.
>
>
>
>      ---no-conn-autostart
>
>          Do not autostart connections.
>
>
>
>      ---show-domain-creator
>
>          Create a new virtual machine.
>
>
>
>      ---show-domain-editor=UUID
>
>          Edit a domain configuration.
>
>
>
>      ---show-domain-performance=UUID
>
>          Show a domain performance.
>
>
>
>      ---show-domain-console=UUID
>
>          Show a domain console.
>
>
>
>      ---show-host-summary
>
>          Show a host summary.
>
>
>
> EXAMPLES
>      Example 1: Launching virtual machine manager
>
>
>
>
>
> SunOS 5.10           Last change: 8 Oct 2007                    2
>
>
>
>
>
>
> User Commands                                     virt-manager(1)
>
>
>
>      example% virt-manager
>
>      Example 2: Show option information for virt-manager
>
>      example% virt-manager -h
>
> EXIT STATUS
>      The following exit values are returned:
>
>      0        Application exited successfully
>
>
>
>      >0       Application exited with failure
>
>
>
> FILES
>      The following files are used by this application:
>
>      /usr/bin/virt-manager           Executable for  the  virtual
>                                      manager
>
>
>
>      $HOME/.virt-manager/virt-manager.log
>                                      Used to store  the  log  for
>                                      virt-manager.
>
>
>
>      /usr/share/virt-manager/*       virt-manager  Python  source
>                                      code.
>
>
>
> ATTRIBUTES
>      See attributes(5) for descriptions of the  following  attri-
>      butes:
>
>      ____________________________________________________________
>     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
>     |_____________________________|_____________________________|
>     | Availability                | SUNWvirt-manager            |
>     |_____________________________|_____________________________|
>     | Interface stability         | Uncommitted                 |
>     |_____________________________|_____________________________|
>
>
> SEE ALSO
>      virt-install(1M), virt-clone(1M),  virsh(1M),  vdiskadm(1M),
>      xm(1M)
>
>
>
> SunOS 5.10           Last change: 8 Oct 2007                    3
>
>
>
>
>
>
> User Commands                                     virt-manager(1)
>
>
>
> NOTES
>      Written by Henry Zhang, Sun Microsystems Inc., 2007.
>
>      Amended by Matt Keenan, Sun Microsystems Inc., 2009.
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
> SunOS 5.10           Last change: 8 Oct 2007                    4
>
>
>
>   


From John.Fischer@Sun.COM Thu Apr 23 16:23:49 2009
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n3NNNmvk025180
	for <LSARC-ext@sac.sfbay.sun.com>; Thu, 23 Apr 2009 16:23:48 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n3NNNmiY012514
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Thu, 23 Apr 2009 16:23:48 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KIK00505UBO4R00@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@sun.com); Thu, 23 Apr 2009 16:23:48 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KIK000N6UBNLV30@nwk-avmta-2.sfbay.sun.com> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Thu,
 23 Apr 2009 16:23:47 -0700 (PDT)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n3NNNlmJ022055	for
 <LSARC-ext@sun.com>; Thu, 23 Apr 2009 23:23:47 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009))
 id <0KIK00200U66ZK00@mail-amer.sun.com> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@sun.com); Thu, 23 Apr 2009 17:23:47 -0600 (MDT)
Received: from [192.168.10.4] ([unknown] [76.20.56.47])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-5.01 64bit
 (built Feb 19 2009)) with ESMTPSA id <0KIK003FTUBM4XF0@mail-amer.sun.com> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Thu,
 23 Apr 2009 17:23:46 -0600 (MDT)
Date: Thu, 23 Apr 2009 16:22:42 -0700
From: John Fischer <John.Fischer@Sun.COM>
Subject: Re: virt-manager upgrade [LSARC/2009/243 FastTrack timeout 04/23/2009]
In-reply-to: <49EE0969.6030503@sun.com>
Sender: John.Fischer@Sun.COM
To: LSARC-ext@Sun.COM
Cc: Matt.Keenan@Sun.COM
Reply-to: John.Fischer@Sun.COM
Message-id: <49F0F842.6020701@sun.com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200904161554.n3GFsw2q004889@paravon.sfbay.sun.com>
 <49E8CB9B.9070903@sun.com> <49EE0969.6030503@sun.com>
User-Agent: Thunderbird 2.0.0.21 (X11/20090323)
Status: RO
Content-Length: 8061

All,

The timer having expired and having received the required +1
I am closing this case as approved.

Thanks,

John

Margot Miller wrote:
> +1
> 
> Margot
> 
> 
> John Fischer wrote:
>> All,
>>
>> Attached is the updated man page for this case.
>> I have put this in the case directory as well.
>>
>> Thanks,
>>
>> John
>>
>> John Fischer wrote:
>>> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
>>> This information is Copyright 2009 Sun Microsystems
>>> 1. Introduction
>>>     1.1. Project/Component Working Name:
>>>      virt-manager upgrade
>>>     1.2. Name of Document Author/Supplier:
>>>      Author:  Matt Keenan
>>>     1.3  Date of This Document:
>>>     16 April, 2009
>>> 4. Technical Description
>>> The "Virtual Machine Manager" (virt-manager) is a desktop application 
>>> for managing virtual machines. The Xen team is planning on delivering 
>>> libvirt 0.6.0 into snv_116, and this project will coincide with them 
>>> and upgrade
>>> from virt-manager 0.4.0 to virt-manager 0.6.1.  The project will be 
>>> delivering into a minor release of Solaris.
>>>
>>> Besides various bug fixes, only the CLI and some new gconf keys are 
>>> modified within this new version of vert-manager.  The CLI additions 
>>> are:
>>>
>>>   --no-fork
>>>     0.4.0 always ran in the foreground, by default 0.6.1
>>>     runs in background, this option is provided for backwards 
>>> compatibility
>>>
>>>   --no-conn-autostart
>>>     0.4.0 always prompted for xen connection at startup, 0.6.1 has new
>>>     dom0 configuration option to auto connect to a given server on
>>>     startup, this option disables this, again backwards compatibility.
>>>
>>>   --debug
>>>     output debug information
>>>
>>>
>>> The new gconf keys stored in virt-manager.schema which just allow for 
>>> the
>>> customization of the GUI, and to save previous settings etc. and default
>>> values are (all prefessed by /apps/virt-manager/):
>>>
>>>     stats/enable-disk-poll   boolean=0   Poll Disk I/O
>>>     stats/enable-net-poll    boolean=0   Poll Network I/O
>>>     stats/enable-mem-poll    boolean=1   Poll Memory I/O
>>>     stats/enable-cpu-poll    boolean=1   Poll CPU I/O
>>>     console/grab-notify      boolean=1   Show grab notification
>>>     details/show-toolbar     boolean=1   Show Toolbar
>>>     new-vm/local-sound       boolean=1   Install sound device for 
>>> local VM's
>>>     new-vm/remote-sound      boolean=1   Install sound device for 
>>> remote VM's
>>>
>>> Thus, the changed interfaces are:
>>>
>>>     Exported Interfaces        Stability      Comments
>>>     -------------------------  -------------  
>>> --------------------------------
>>>     /usr/bin/virt-manager      Volatile       Virtual manager GUI 
>>> application,
>>>                                               CLI change
>>>     virt-manager.schema        Volatile       new gconf keys introduced
>>>
>>> All imported interfaces and contracts remain the same.  See Virtual 
>>> Machine Manager (LSARC/2007/175) for details.
>>>
>>>
>>> 6. Resources and Schedule
>>>     6.4. Steering Committee requested information
>>>        6.4.1. Consolidation C-team Name:
>>>         JDS - Desktop
>>>     6.5. ARC review type: FastTrack
>>>     6.6. ARC Exposure: open
>>>
>> ------------------------------------------------------------------------
>>
>> User Commands                                     virt-manager(1)
>>
>>
>>
>> NAME
>>      virt-manager -  Desktop  application  for  managing  virtual
>>      machines
>>
>> SYNOPSIS
>>      virt-manager  [-h,  --help]  [--profile=FILE]  [-c  URI,  --
>>      connect=URI]  [--debug]  [--no-dbus] [--no-fork] [--no-conn-
>>      autostart]      [--show-domain-creator]      [--show-domain-
>>      editor=UUID]    [--show-domain-performance=UUID]    [--show-
>>      domain-console=UUID] [--show-host-summary]
>>
>> DESCRIPTION
>>      The "Virtual Machine Manager" (virt-manager)  is  a  desktop
>>      application for managing virtual machines.
>>
>>      It presents a summary view of running domains and their live
>>      performance  &  resource  utilization statistics. A detailed
>>      view presents graphs showing performance & utilization  over
>>      time.  Ultimately it will allow creation of new domains, and
>>      configuration & adjustment of a domain's resource allocation
>>      & virtual hardware. An embedded VNC client viewer presents a
>>      full graphical console to the guest domain.
>>
>>      You need root access to run virt-manager.
>>
>> OPTIONS
>>      The following options are supported:
>>
>>      --h, --help
>>
>>          show this help message and exit.
>>
>>
>>
>>      ---profile=FILE
>>
>>          Generate runtime performance profile stats.
>>
>>
>>
>>      --c URI, --connect=URI
>>
>>          Connect to hypervisor at URI.
>>
>>
>>
>>      ---debug
>>
>>          Print debug output to stdout. Requires --no-fork option.
>>
>>
>>
>>
>>
>>
>> SunOS 5.10           Last change: 8 Oct 2007                    1
>>
>>
>>
>>
>>
>>
>> User Commands                                     virt-manager(1)
>>
>>
>>
>>      ---no-dbus
>>
>>          Disable DBus service for controlling UI.
>>
>>
>>
>>      ---no-fork
>>
>>          Don't fork into background on startup.
>>
>>
>>
>>      ---no-conn-autostart
>>
>>          Do not autostart connections.
>>
>>
>>
>>      ---show-domain-creator
>>
>>          Create a new virtual machine.
>>
>>
>>
>>      ---show-domain-editor=UUID
>>
>>          Edit a domain configuration.
>>
>>
>>
>>      ---show-domain-performance=UUID
>>
>>          Show a domain performance.
>>
>>
>>
>>      ---show-domain-console=UUID
>>
>>          Show a domain console.
>>
>>
>>
>>      ---show-host-summary
>>
>>          Show a host summary.
>>
>>
>>
>> EXAMPLES
>>      Example 1: Launching virtual machine manager
>>
>>
>>
>>
>>
>> SunOS 5.10           Last change: 8 Oct 2007                    2
>>
>>
>>
>>
>>
>>
>> User Commands                                     virt-manager(1)
>>
>>
>>
>>      example% virt-manager
>>
>>      Example 2: Show option information for virt-manager
>>
>>      example% virt-manager -h
>>
>> EXIT STATUS
>>      The following exit values are returned:
>>
>>      0        Application exited successfully
>>
>>
>>
>>      >0       Application exited with failure
>>
>>
>>
>> FILES
>>      The following files are used by this application:
>>
>>      /usr/bin/virt-manager           Executable for  the  virtual
>>                                      manager
>>
>>
>>
>>      $HOME/.virt-manager/virt-manager.log
>>                                      Used to store  the  log  for
>>                                      virt-manager.
>>
>>
>>
>>      /usr/share/virt-manager/*       virt-manager  Python  source
>>                                      code.
>>
>>
>>
>> ATTRIBUTES
>>      See attributes(5) for descriptions of the  following  attri-
>>      butes:
>>
>>      ____________________________________________________________
>>     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
>>     |_____________________________|_____________________________|
>>     | Availability                | SUNWvirt-manager            |
>>     |_____________________________|_____________________________|
>>     | Interface stability         | Uncommitted                 |
>>     |_____________________________|_____________________________|
>>
>>
>> SEE ALSO
>>      virt-install(1M), virt-clone(1M),  virsh(1M),  vdiskadm(1M),
>>      xm(1M)
>>
>>
>>
>> SunOS 5.10           Last change: 8 Oct 2007                    3
>>
>>
>>
>>
>>
>>
>> User Commands                                     virt-manager(1)
>>
>>
>>
>> NOTES
>>      Written by Henry Zhang, Sun Microsystems Inc., 2007.
>>
>>      Amended by Matt Keenan, Sun Microsystems Inc., 2009.
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>> SunOS 5.10           Last change: 8 Oct 2007                    4
>>
>>
>>
>>   
> 

