Upgrade GigaVUE-FM from the GigaVUE-FM CLI

The following steps describe how to upgrade an existing GigaVUE-FM deployment to the current release.

1.   Verify that only three images are present on the GigaVUE-FM server.
2. Download the new image into GigaVUE-FM using either HTTP, HTTPS, FTP, TFTP, SCP, or SFTP.
3. Install the new image.
4. Change boot partition.
5. Upgrade GigaVUE-VM (Optional).

Notes:

■   It is important that you must be a user with fm_super_admin role when upgrading the image on the existing GigaVUE-FM.
■   GigaVUE-FM backup and restore files use a text based format; binary backups or restore on physical nodes are not supported. For binary backups, you must use the CLI commands rather than GigaVUE-FM. For more information about the CLI commands, refer to the GigaVUE-OS CLI Reference Guide.
■   In your commands use the actual file names of the image(s) you are fetching, managing, or deploying.

Step 1: Verify that only three images are present on GigaVUE-FM server

1.   To begin an upgrade, open a SSH session and log into GigaVUE-FM.
2. Check the number of images currently available for installation with the following command from the GigaVUE-FM CLI:

$ fmctl image list

Important: If there are three images listed in the Images available to be installed section of the fmctl image list output, Gigamon recommends you to delete existing older images. GigaVUE-FM will display a warning if you attempt to fetch a fourth image.

3. To delete an existing image from the server use the following command:

$ fmctl image delete <Filename>

4. Go to Step 2: Fetch the latest release of GigaVUE-FM.

Step 2: Fetch the latest release of GigaVUE-FM

Gigamon provides an FTP site where the new release image file resides. To fetch the latest release, do the following:

1.   Locate the image file for the new release.
2. Copy the image to your file server.
3. Use the fmctl image fetch command to retrieve the software image from your file server. The CLI shows you the progress of the image fetch with a series of hash marks, returning you to the system prompt when complete.

Note:  The image fetch command supports the use of HTTP, HTTPS, FTP, TFTP, SCP, or SFTP for the transfer of images. The examples are provided to show the syntax only. In your commands, use your actual login credentials and the actual name of the image file you wish to fetch.

a. The following command uses SCP to retrieve the gigamon-gigavue-fm-6.0 image image from the image server with the IP address using login and password.

fmctl image fetch <download URI> [<filename>]

$ fmctl image fetch scp://user:password@<IP address>/gigamon-gigavue-fm-6.0.img

b. The following command uses FTP to retrieve the same image using login and password.

$ fmctl image fetch ftp://user:password@<IP address>/gigamon-gigavue-fm-6.0.img

c. The following command uses TFTP to retrieve the same image without using a password but using a DNS server instead of an IP address for the download server.

$ fmctl image fetch tftp://myserver.gigamon.com/tftpboot/gigamon-gigavue-fm-6.0.img

Specify the base directory when using TFTP.

Note:  Fetching the image using TFTP is time consuming, due to the size of the image and the inherent slowness of TFTP. For better performance, use SCP or HTTP to fetch the image.

4. Go to Step 3: Install the latest release of the GigaVUE-FM.

Step 3: Install the latest release of the GigaVUE-FM

Use the image install command to install the downloaded image file. When running the following command, the process will first verify that the filename used for the image is suitable for installation prior to installing the image. For example, to install the image downloaded in the previous step and provide the location for boot location for installation.

To check current boot location:

$ fmctl image show

This command lists the current boot partition, which can be 1 or 2. Use 2 if the current partition is 1 and vice e versa.

$fmctl image install <Filename> <Boot location>

Step 4: Change the boot partition

Set the image you just installed to boot next with the following command. This ensures that at the next boot the latest image will be picked up.

$ fmctl image boot next

GigaVUE-FM will reboot with the next boot image and GigaVUE-FM will be upgraded.

Step 5: Upgrade GigaVUE-VM (Optional)

After upgrading GigaVUE-FM, you must also upgrade any deployed GigaVUE-VM. Otherwise, maps may not work and the GigaVUE-VM will be unreachable. For information about upgrading GigaVUE-VM, refer to the “Bulk Upgrading GigaVUE-VM Nodes” section in the GigaVUE Cloud Suite for VMware—GigaVUE V Series Guide.