sys software image
sys software image(1) BIG-IP TMSH Manual sys software image(1)
NAME
image - Manages F5 Networks software images.
MODULE
sys software
SYNTAX
Install, display information about, or delete a software image using the syntax in the following sections.
INSTALL
install
options:
create-volume
image [name]
reboot
volume [name]
DISPLAY
list image
list image [ [ [ name [/slot_id] ] | [glob] | [regex] ] ... ]
options:
build
build-date
checksum
file-size
last-modified
one-line
product
verified
version
DELETE
delete image [ [ [name] ... ] | [all] ]
DESCRIPTION
You can use the image component to install images onto a volume, view information about available images, or delete
unwanted images.
INSTALLING A SOFTWARE IMAGE
Before you begin installing an image, you must download the image file into the /shared/images directory. You can find new
software images at http://downloads.f5.com. We recommend downloading both the .iso file and the .md5 file. Download the
file (or files) to your local machine, then transfer it to the /shared/images directory on the BIG-IP(r). Use the Manager
(GUI) interface to make this transfer, or quit tmsh to the Unix command line and use scp or a similar Unix command.
If you downloaded the .md5 file, you can use the Unix md5sum command to check the MD5 hash of the .iso file, and you can
compare it to the contents of the .md5 file. They should match. If they do not, retry the download and/or transfer of the
.iso file.
From tmsh, you can use show sys software status to see all of the available disk volumes where you can install the .iso
file. You can install the .iso file in any volume that is not active.
Then use the install command with this component to install the .iso file 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 .iso file 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
image. You do not use the slot_id option when installing or deleting an image, because these commands operate on all blades
or the entire system.
CONFIRMING AN 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 image BIGIP-10.0.0.5376.0.iso volume HD1.1 reboot
Attempts to install the specified image, BIGIP-10.0.0.5376.0.iso, onto HD1.1. Note: If the installation is successful and
the version is permitted, the machine reboots into the newly installed image. If the version is not permitted, add forced
to the command to force the reboot.
list image BIGIP-10.0.0.5376.0.iso
Displays information about the specified image, build 5376.0 of BIG-IP version 10.0.0.
list image */1
Displays information about all of the images located on the first slot.
OPTIONS
build
Displays the build number of the image.
build-date
Displays the date on which the image was built.
checksum
Displays the checksum of the image. You can use this option to verify the integrity of the 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.
file-size
Displays the size of the 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 image that you want to install or delete.
product
Displays the F5 Networks product the image contains.
reboot
Specifies that the system reboots immediately after a successful installation.
forced
Forces a reboot if the version is not permitted by the license.
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.
verified
When set to yes, indicates that the image is authentic.
version
Displays the version number of the product this image contains.
volume
Specifies the name of the volume on which you want to install the image, or from which you want to delete the image.
Note: You cannot install software on the active volume.
SEE ALSO
delete, glob, install, list, reboot, regex, sys software hotfix, 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 2009-2013, 2016. All rights reserved.
BIG-IP 2019-05-02 sys software image(1)