sys software block-device-image
sys software block-device-image(1) BIG-IP TMSH Manual sys software block-device-image(1)
NAME
block-device-image - Manages F5 Networks block device software images.
MODULE
sys software
SYNTAX
Install or display information about a block-device-image using the syntax in the following sections.
INSTALL
install
options:
create-volume
image [name]
reboot
volume [name]
DISPLAY
list block-device-image
list block-device-image [ [ [ name [/slot_id] ] | [glob] | [regex] ] ... ]
options:
build
build-date
checksum
device-agent
file-size
last-modified
one-line
product
resource-id
verified
version
DESCRIPTION
You can use the block-device-image component to install images from block devices onto a volume, or view
information about available block-device-images.
INSTALLING A SOFTWARE BLOCK-DEVICE-IMAGE
Before you begin installing a block-device-image, the image must be be made available to the system. As of
this writing, block device images are only available from within a VCMP guest via a virtual cdrom service. A
VCMP host administrator must have provided the images for use by the guest as part of there administration of
the VCMP host.
From tmsh, you can use show sys software status to see all of the available disk volumes where you can install
the image. You can install the image file in any volume that is not active.
Then use the install command with this component to install the image to an unused volume. You can use the
create-volume option if you want to create a new volume. The installation takes some time; you can use show
sys software status repetitively to watch the progress of the installation. To put the newly installed
software into active service, use the reboot option in the install command, or use the reboot volume vol-name
command after the install command completes.
Note: You use the slot_id option only for chassis systems and only when displaying the values for the options
of a specific block-device-image. You do not use the slot_id option when installing or deleting an block-
device-image, because these commands operate on all blades or the entire system.
CONFIRMING AN BLOCK-DEVICE-IMAGE INSTALLATION
You can use show sys version to confirm that the system is running the new software version. If this is a new
module for the current system, you may need to use show sys license and/or install sys license to update your
license. For a new module, you may also need to provision CPU, memory, and disk space for the module with the
sys provision component.
EXAMPLES
install block-device-image BIGIP-11.4.1.608.0.iso volume HD1.1 reboot
Attempts to install the specified block-device-image, BIGIP-11.4.1.608.0.iso, onto HD1.1. Note: If the
installation is successful, the machine reboots into the newly installed block-device-image.
list block-device-image BIGIP-11.4.1.608.0.iso
Displays information about the specified block-device-image, build 608.0 of BIG-IP version 11.4.1.
list block-device-image */1
Displays information about all of the block-device-images located on the first slot.
OPTIONS
build
Displays the build number of the block-device-image.
build-date
Displays the date on which the block-device-image was built.
checksum
Displays the checksum of the block-device-image. You can use this option to verify the integrity of the
block-device-image.
create-volume
Creates a new volume using the name specified with the volume option. Mirrored volume names must begin
with the prefix MD1.. Mirrored volumes are available only on systems that support RAID, see sys raid.
device-agent
Displays the name of the service which is responsible for managing the type of block device on which a
give image is available. vcmp-virtual-cdrom is the device-agent which allows VCMP guests to install
images that reside in the host system, via a virtual cdrom device.
file-size
Displays the size of the block-device-image file in megabytes.
glob Displays the items that match the glob expression. See help glob for a description of glob expression
syntax.
last-modified
Displays the date the file was last modified.
name Specifies the name of the block-device-image that you want to install or delete.
product
Displays the F5 Networks product the block-device-image contains.
reboot
Specifies that the system reboots immediately after a successful installation.
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.
resource-id
Displays the resource-id string corresponding to software image in question. This string is used to
identify the image for use in interacting with the device agent that is responsible for management of the
resource. In the case of the vcmp-virtual-cdrom device-agent the resource-id is used by the live
installation daemon when requesting that the hypervisor make images available, before the installation
can proceed.
verified
When set to yes, indicates that the block-device-image is authentic.
version
Displays the version number of the product this block-device-image contains.
volume
Specifies the name of the volume on which you want to install the block-device-image, or from which you
want to delete the block-device-image.
Note: You cannot install software on the active volume.
SEE ALSO
delete, glob, install, list, reboot, regex, sys software block-device-hotfix, sys software hotfix, sys
software image, tmsh, show, sys software status, sys version, sys license, sys provision
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 2013-2016. All rights reserved.
BIG-IP 2016-03-14 sys software block-device-image(1)