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.

BIG-IP 2016-03-14 sys software block-device-image(1)