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, the machine reboots
       into the newly installed image.

       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.

       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				  2016-03-14		 sys software image(1)