From Artem.Kachitchkin@sun.com Fri Sep 19 15:57:09 2008
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 m8JMv81X005255
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 19 Sep 2008 15:57:09 -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 m8JMv3pd017063
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 19 Sep 2008 23:57:07 +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 <0K7G0010ZT372A00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 19 Sep 2008 16:57:07 -0600 (MDT)
Received: from sca-es-mail-1.sun.com ([192.18.43.132])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K7G00J9CT36Z020@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 19 Sep 2008 16:57:06 -0600 (MDT)
Received: from fe-sfbay-10.sun.com ([192.18.43.129])
	by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m8JMv680016766	for
 <PSARC-ext@sun.com>; Fri, 19 Sep 2008 15:57:06 -0700 (PDT)
Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K7G00301SZON100@fe-sfbay-10.sun.com>
 (original mail from Artem.Kachitchkin@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 19 Sep 2008 15:57:06 -0700 (PDT)
Received: from [129.146.104.83] by fe-sfbay-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K7G00F8DT33L6B0@fe-sfbay-10.sun.com>; Fri,
 19 Sep 2008 15:57:03 -0700 (PDT)
Date: Fri, 19 Sep 2008 15:57:18 -0700
From: Artem Kachitchkine <Artem.Kachitchkin@sun.com>
Subject: PSARC/2008/597 vdiskadm
Sender: Artem.Kachitchkin@sun.com
To: PSARC-ext@sun.com
Cc: Susan.Kamm-Worrell@sun.com, Mark.Johnson@sun.com
Message-id: <48D42E4E.2060408@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
User-Agent: Thunderbird 2.0.0.14 (X11/20080616)
Status: RO
Content-Length: 4078

I'm sponsoring this fasttrack for Susan Kamm-Worrell. In addition to 
this proposal, a draft vdiskadm(1m) man page is in the case directory. 
The timer is set for 09/26/2008.

-Artem

Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
     1.1. Project/Component Working Name:
	 vdiskadm
     1.2. Name of Document Author/Supplier:
	 Author:  Susan Kamm-Worrell
     1.3  Date of This Document:
	19 September, 2008
4. Technical Description

4.1.  Summary

This fast-track introduces vdiskadm, an administrative tool to
manage virtual disks.

Minor release binding is requested.


4.2.  Discussion

VMware and VirtualBox use virtual disk formats that allow the
creation of differencing images, sparse files and import of virtual
disks.  These capabilities give the users the ability to manage disk
space, rollback to a previous working disk image and to use previously
constructed disks from outside sources.

vdiskadm gives Solaris Xen users the ability to use the VMware (vmdk)
and VirtualBox (vdi) virtual disk formats when creating virtual disks
for use by domains.  This allows Solaris Xen users to leverage
functionality inherent in those disk formats such as sparse files
and snapshots.  vdiskadm also supports the raw format.
Support for the VHD (Microsoft) format is planned in the future.

A virtual disk is a collection of files that comprise the contents
and state information of the virtual disk.  This group of files
varies dependent upon the type of virtual disk created and actions
taken on the virtual disk (such as snapshot).  These files
are opaque to the administrator so all virtual disk actions are
based on the virtual disk name.

The vdiskadm commands are loosely modeled after the zfs commands, with
the exception of the property commands.  The property commands are
intentionally different so that the user doesn't make assumptions based
on the zfs property behavior.  The vdiskadm properties are very simple
and have no concept of inheritance or source.

Listed are the vdiskadm commands:

create          Creates a virtual disk
destroy         Destroys the virtual disk or a snapshot
snapshot        Creates a snapshot of the virtual disk
rollback        Reverts the virtual disk back to a snapshot
clone           Clones the virtual disk or a specific snapshot
move            Moves the virtual disk to a different directory
rename          Renames the virtual disk or a specific snapshot
import          Imports a file into a virtual disk
export          Exports a virtual disk into a file.
list            Prints the filenames associated with the virtual disk
verify          Verifies if the given path is a virtual disk
prop-get        Gets a property of the virtual disk
prop-set        Sets a property of the virtual disk
prop-add        Adds a user property to the virtual disk
prop-del        Deletes a user property from the virtual disk
help		Prints a general or command specific help message.

See vdiskadm(1m) man page in case directory for details.

The import and export commands are currently project private and will
be documented in a followup fast-track.

The clone command generates a new virtual disk independent of the
original virtual disk or snapshot.  The new virtual disk is a coalesced
copy of the original virtual disk or snapshot where any previous
snapshots were merged together in the clone.

Future work will allow a copy-on-write virtual disk clone to be created
from the original virtual disk or snapshot.  This would allow the
administrator to use a virtual disk based upon a specific snapshot of
the original virtual disk without incuring the space required of an
independent virtual disk.


4.3.  Interfaces

vdiskadm command is Uncommitted.


5.  References

PSARC/2006/260 Solaris on Xen
PSARC/2008/579 virt-convert
PSARC/2008/596 Block Tap Support for Solaris

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

From Artem.Kachitchkin@sun.com Thu Sep 25 10:31:06 2008
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 m8PHV6bo002214
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 25 Sep 2008 10:31:06 -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 m8PHV37r004000
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 25 Sep 2008 10:31:06 -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 <0K7R00D4THZTK100@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 25 Sep 2008 10:31:05 -0700 (PDT)
Received: from sca-es-mail-1.sun.com ([192.18.43.132])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K7R00DUEHZS8T00@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 25 Sep 2008 10:31:04 -0700 (PDT)
Received: from fe-sfbay-09.sun.com ([192.18.43.129])
	by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m8PHV4DS005992	for
 <PSARC-ext@sun.com>; Thu, 25 Sep 2008 10:31:04 -0700 (PDT)
Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K7R00001HSOD900@fe-sfbay-09.sun.com>
 (original mail from Artem.Kachitchkin@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 25 Sep 2008 10:31:04 -0700 (PDT)
Received: from [129.146.104.83] by fe-sfbay-09.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K7R00EGCHZEMDH0@fe-sfbay-09.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 25 Sep 2008 10:30:55 -0700 (PDT)
Date: Thu, 25 Sep 2008 10:31:18 -0700
From: Artem Kachitchkine <Artem.Kachitchkin@sun.com>
Subject: Re: PSARC/2008/597 vdiskadm
In-reply-to: <48D42E4E.2060408@sun.com>
Sender: Artem.Kachitchkin@sun.com
To: PSARC-ext@sun.com
Cc: Susan.Kamm-Worrell@sun.com, Mark.Johnson@sun.com
Message-id: <48DBCAE6.4020405@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: <48D42E4E.2060408@sun.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080616)
Status: RO
Content-Length: 244


Reminder: case times out this Friday. Before it can be approved, we need 
at least one email confirming that it was reviewed by a living person - 
if you qualify, looked at this case and liked what you saw, please speak up.

thank you,
-Artem

From Darren.Moffat@sun.com Thu Sep 25 10:42:27 2008
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m8PHgR0s002442
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 25 Sep 2008 10:42:27 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m8PHgP8B063915
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 25 Sep 2008 11:42:27 -0600 (MDT)
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 <0K7R0020LIIQ5I00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 25 Sep 2008 11:42:26 -0600 (MDT)
Received: from gmp-eb-inf-1.sun.com ([192.18.6.21])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K7R00CC5IIO5DE0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 25 Sep 2008 11:42:25 -0600 (MDT)
Received: from fe-emea-10.sun.com (gmp-eb-lb-1-fe3.eu.sun.com [192.18.6.10])
	by gmp-eb-inf-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m8PHgOao028472	for
 <PSARC-ext@sun.com>; Thu, 25 Sep 2008 17:42:24 +0000 (GMT)
Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K7R00601IGV8G00@fe-emea-10.sun.com>
 (original mail from Darren.Moffat@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 25 Sep 2008 18:42:24 +0100 (BST)
Received: from [192.168.1.219]
 (h-72-245-120-32.mclnva23.covad.net [72.245.120.32])
 by fe-emea-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0K7R003TUIIKML20@fe-emea-10.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 25 Sep 2008 18:42:22 +0100 (BST)
Date: Thu, 25 Sep 2008 18:42:20 +0100
From: Darren J Moffat <Darren.Moffat@sun.com>
Subject: Re: PSARC/2008/597 vdiskadm
In-reply-to: <48DBCAE6.4020405@sun.com>
Sender: Darren.Moffat@sun.com
To: Artem Kachitchkine <Artem.Kachitchkin@sun.com>
Cc: PSARC-ext@sun.com, Susan.Kamm-Worrell@sun.com, Mark.Johnson@sun.com
Message-id: <48DBCD7C.10700@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: <48D42E4E.2060408@sun.com> <48DBCAE6.4020405@sun.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080630)
Status: RO
Content-Length: 524

Artem Kachitchkine wrote:
> 
> Reminder: case times out this Friday. Before it can be approved, we need 
> at least one email confirming that it was reviewed by a living person - 
> if you qualify, looked at this case and liked what you saw, please speak 
> up.

I've looked at it and I'm happy with it.  Personally I didn't think it 
was necessary to make the property commands different from zfs/zpool but 
  I don't care enough given that svccfg uses setprop/getprop/lsprop and 
is already different.

--
Darren J Moffat

From Artem.Kachitchkin@sun.com Fri Sep 26 12:40:11 2008
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 m8QJeA5H014923
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 26 Sep 2008 12:40:11 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m8QJdxqE004833
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 26 Sep 2008 20:40:10 +0100 (BST)
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 <0K7T00A1FIMUBN00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 26 Sep 2008 12:40:06 -0700 (PDT)
Received: from sca-es-mail-1.sun.com ([192.18.43.132])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K7T004V9IMUEYA0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 26 Sep 2008 12:40:06 -0700 (PDT)
Received: from fe-sfbay-09.sun.com ([192.18.43.129])
	by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m8QJe6kW004042	for
 <PSARC-ext@sun.com>; Fri, 26 Sep 2008 12:40:06 -0700 (PDT)
Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K7T00C01IF3IH00@fe-sfbay-09.sun.com>
 (original mail from Artem.Kachitchkin@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 26 Sep 2008 12:40:06 -0700 (PDT)
Received: from [129.146.104.83] by fe-sfbay-09.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K7T00B3NIMUDX20@fe-sfbay-09.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 26 Sep 2008 12:40:06 -0700 (PDT)
Date: Fri, 26 Sep 2008 12:40:36 -0700
From: Artem Kachitchkine <Artem.Kachitchkin@sun.com>
Subject: Re: PSARC/2008/597 vdiskadm
In-reply-to: <48D42E4E.2060408@sun.com>
Sender: Artem.Kachitchkin@sun.com
To: psarc-ext@sun.com
Cc: Susan.Kamm-Worrell@sun.com, Mark.Johnson@sun.com
Message-id: <48DD3AB4.6090105@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: <48D42E4E.2060408@sun.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080616)
Status: RO
Content-Length: 36


This case is now approved.

-Artem

