sys software block-device-image
sys software block-device-imagBIG-IP TMSH Masyslsoftware 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-14sys software block-device-image(1)