Upgrade or Reinstall UCT-V

You can upgrade UCT-V in your virtual machine in two ways.

■

Upgrade UCT-V manually on Virtual Machine

■

Upgrade UCT-V through GigaVUE‑FM

Refer to the following sections for more detailed information and step-by-step instructions on how to upgrade UCT-V:

Upgrade UCT-V manually on Virtual Machine

To upgrade UCT-V manually on a virtual machine, delete the existing UCT-V and install the new version of UCT-V.

Note:  Before deleting the UCT-V, take a backup copy of the /etc/uctv/uctv.conf configuration file. This step avoids reconfiguring the source and destination interfaces.

1. Uninstall the existing UCT-V. Refer to the Uninstall UCT-V section in the respective GigaVUE Cloud Suite Deployment Guide.
2. Install the latest version of the new UCT-V. Refer to the Linux UCT-V Installation and the Windows UCT-V Installation topics in the respective GigaVUE Cloud Suite Deployment Guides.
3. Restart the UCT-V service.
   • Linux platform:

     $ sudo service uctv restart

   • Windows platform: Restart from the Task Manager.
     

Upgrade UCT-V through GigaVUE‑FM

Upgrading UCT-V manually involves a series of steps to uninstall, install, and restart the service again. This method can be complicated when you need to upgrade UCT-Vs for a large number of VMs.

However, you can upgrade UCT-V in the workload VM without any hands-on involvement through GigaVUE‑FM. Refer to the sections below for more details and step-by-step process:

1. Upload the UCT-V Images

2. Upgrade the UCT-V

Rules and Notes:

■

Currently, upgrades are only allowed to versions 6.9.00 or later. Ensure that the UCT-V Controller version is compatible with the version to which you are upgrading.

■

You should have Infrastructure Management permission to upgrade the UCT-Vs.

■

Currently, you can upgrade the UCT-Vs to n+2 versions and any number of patch releases through GigaVUE‑FM.

■

Before you proceed with the upgrade, ensure that the UCT-Vs are in a healthy state.

■

A UCT-V can only be associated with one active job at a time. If the selected UCT-V is part of another job, you cannot trigger the immediate job using the same UCT-V.

■

You must upload a compatible image type to upgrade the UCT-V; otherwise, the UCT-V will be rejected for the upgrade job.

■

Upgrade through GigaVUE‑FM is not applicable for OVS agents. For OVS tapping, you should upgrade the UCT-Vs manually.

Upload the UCT-V Images

Follow the below-listed steps to upload UCT-V image files in GigaVUE‑FM:

1. Go to Inventory > Virtual and select your cloud platform. The Monitoring Domain page appears.
2. Click the UCT-V Upgrade drop-down menu and select Images.
3. In the Images page, click Upload. The Upload Internal Image Files wizard appears.

4. Click Choose File, upload the UCT-V files from your local, and click Ok.

   Notes:

   • You can download the UCT-V image files from Gigamon software portal.
   • You can upload a maximum of 15 UCT-V files at a time.
   • The supported file formats are .deb, .rpm, and .msi.
   • Ensure that you do not change the file names. GigaVUE‑FM will not accept the image files with modified names.
   • When the upload is in process, GigaVUE‑FM will not allow to upload a file with similar type and version.
5. Once completed, the uploaded UCT-V images will be listed in the Images page.

In the Images page, click Filter to filter the images based on Image Name, Version, and Image Type. You can delete one or multiple images. Select the required images and click Delete or Delete All from the Actions drop-down menu. You can only delete those image files that are not associated with any tasks created for the upgrade process.

Upgrade the UCT-V

Follow the steps below to upgrade UCT-V in GigaVUE‑FM:

1. In the UCT-V Upgrade drop-down menu, click Dashboard to view the UCT-V upgrade landing page.
2. In the Dashboard page, you can view the upgrade status of individual UCT-Vs and the stages of the upgrade process (Fetch, Install, Verify). The page also displays the overall progress of the upgrade.
3. Select the required UCT-Vs and click Upgrade from the Actions drop-down menu. UCT-V Upgrade task page appears.
4. Enter the task name.
5. In the Image Version drop-down menu, select the required version you want to upgrade to from the list of available image versions.

6. You can choose to upgrade immediately or schedule a time for the upgrade to happen. Select the required option in the Time Selection field. If you prefer to schedule the upgrade, enter the choice of your date and time in the respective fields.

   Note:  The upgrade should not be scheduled for a time in the past.

7. Click Create. The image upgrade task is now created.

   Note:

   ■

   You cannot edit the upgrade task once it is created.

   ■

   You can only reschedule the scheduled task but cannot edit the UCT-V selected for the particular task.

   ■

   In the event of the errors listed below, GigaVUE‑FM will display a pop-up message with the list of UCT-Vs that are not compatible for upgrade. Click Proceed to ignore the unsupported UCT-Vs and upgrade the compatible ones, or click "Edit" to modify your changes. The errors include:

   o

   Controller version is not compatible with the upgrade version.

   o

   Inconsistency between the uploaded image file type and the selected UCT-V.

You can view the created task details (both immediate and scheduled) in the UCT-V Upgrade > Jobs section.

You can view the different stages of the upgrade process in UCT-V Upgrade Dashboard page. Each stage will be marked with if it is successful and in case of failure. If the upgrade is successful, GigaVUE‑FM will update the upgrade status as Success for the selected UCT-V.