sys software volume

sys software volume(1)	      BIG-IP TMSH Manual	sys software volume(1)



NAME
       volume - Manages software volumes on the BIG-IP(r) system.

MODULE
       sys software

SYNTAX
       Delete, reboot into, or display information about a hard drive volume
       using the syntax in the following sections.

   REBOOT
	reboot volume [name]

   DISPLAY
	list volume
	list volume [ [ [name].[slot_id] ] | [glob] | [regex] ] ... ]
	show running-config
	show running-config [ [ [name].[slot_id] ] | [glob] | [regex] ] ... ]
	  options:
	    active
	    active-requested
	    all-properties
	    basebuild
	    build
	    edition
	    media [media] [size] [default-boot-location]
	    one-line
	    product
	    status
	    version

   DELETE
	delete volume [name]

DESCRIPTION
       You can use the volume component to view information about configured
       volumes, delete unwanted volumes, and reboot the device to a specific
       volume.

       Volumes are created using the install command. See help sys software
       image and the option create-volume.

       Deleting or rebooting into a volume on a VIPRION system affects the
       entire chassis; therefore, you do not need to specify the slot number.

EXAMPLES
       list volume */1

       Displays the details of all the volumes located on the first slot in a
       chassis.

       delete volume HD1.5

       Deletes the volume named HD1.5.

       reboot volume HD1.1

       Boots into volume HD1.1 if that volume is not already active. If the
       volume has an image actively being installed on it, the reboot occurs
       when the installation is complete.

OPTIONS
       active
	    Specifies if this volume is being run.

       active-requested
	    Specifies if this volume should be active once its status is
	    complete. The system associates this setting with either the
	    active volume or the volume that is going to become active when
	    its status is complete. If active-requested is set on a volume
	    that is not presently active, the system reboots into the volume
	    when the volume status is complete. As an example, install sys
	    software image BIGIP-10.1.0.3341.0.iso volume HD1.2 reboot will
	    cause active-requested to be set on volume HD1.2, and the system
	    will reboot into volume HD1.2 when the installation is complete.
	    This value is read-only.

       basebuild
	    Displays the build number of either the hotfix presently applied
	    to the system or the original build.

       build
	    Displays the original build number (before any hotfixes).

       edition
	    Displays a textual description of the image. You can use this
	    option to specify the hotfix you want to install.

       media
	    Displays a description of the physical media on which the volume
	    exists. The options are:

	    media
		 The type of physical device on which the volume exists, for
		 example, hard drive (hd) or compact flash (cf).

	    size The space on the slot reserved for the volume.

	    default-boot-location
		 Specifies the volume into which the system boots if the slot
		 resets.

       name Specifies the name of the volume you are configuring. Volume names
	    are in the format HDX.Y, CFX.Y, or MDX.Y, where X is the hard
	    drive index (HDX), compact flash index (CFX), or RAID index (MDX)
	    (on systems that support RAID), and Y is the volume number on that
	    drive.

       product
	    Displays the F5 Networks product that is installed on the volume.

       reboot
	    Reboots the system into the specified volume.

       regex
	    Displays the items that match the regular expression. The regular
	    expression must be preceded by an at sign (@[regular expression])
	    to indicate that the identifier is a regular expression. See help
	    regex for a description of regular expression syntax.

       status
	    Displays the installation status of the volume. The options are
	    complete or installing.

       version
	    Displays the version number of the software installed on the
	    volume.

SEE ALSO
       delete, glob, install, list, reboot, regex, sys software hotfix, sys
       software image, sys raid, tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or
       by any means, electronic or mechanical, including photocopying,
       recording, or information storage and retrieval systems, for any
       purpose other than the purchaser's personal use, without the express
       written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2009-2013. All rights reserved.



BIG-IP				  2013-03-21		sys software volume(1)