Upgrade or Reinstall UCT-V

You can upgrade UCT-V in your virtual machine using the following options:

■   Upgrade or Reinstall UCT-V
■   Upgrade or Reinstall UCT-V

Refer to the below sections for detailed information and instructions.

Upgrade UCT-V through GigaVUE‑FM (Recommended Method)

Upgrading UCT-V manually involves a series of steps to uninstall, install, and restart the service again. This upgrade method is applicable to both GigaVUE‑FM Orchestration and Third Party orchestration. For a list of supported platforms, refer to Install UCT-V.

Note:  This method is complicated if 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 details and instructions:

  1. Upgrade or Reinstall UCT-V

  2. Upgrade or Reinstall UCT-V

Rules and Notes:

■   Upgrade is allowed only 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.
■   Make sure that a UCT-V is performing only 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 is rejected for the upgrade job.
■   Upgrade through GigaVUE‑FM is not applicable to OVS Modules. For OVS tapping, you should upgrade the UCT-Vs manually.

Upload the UCT-V Images

Perform the following 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. Select 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. Select Choose File, upload the UCT-V files from your local, and select 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‑FMdoes not accept the image files with modified names.
    • When the upload is in process, GigaVUE‑FM does not allow uploading a file with similar type and version.
  5. Verify if the uploaded UCT-V images is listed in the Images page.

Delete the file\

You can delete one or multiple images.

  1. In the Images page, select Filter to find the images based on Image Name, Version, and Image Type.

  2. Select the required images.

  3. From the Actions drop-down menu, select Delete or Delete All.

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, select Dashboard to view the UCT-V upgrade landing page.
    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.
  2. Select the required UCT-Vs, and from the Actions drop-down menu, select Upgrade.
    The UCT-V Upgrade task page appears.
  3. Enter the task name.
  4. In the Image Version drop-down menu, select the required version you want to upgrade to from the list of available image versions. You can choose to upgrade immediately or schedule a time for the upgrade to happen.
  5. 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.
    Do not schedule the upgrade for a time in the past.

  6. Select 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 displays a pop-up message with the list of UCT-Vs that are not compatible for upgrade. Select Proceed to ignore the unsupported UCT-Vs and upgrade the compatible ones, or sekect "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.

Notes:
■   For better progress monitoring, it is recommended to split the upgrade task to a limited number, such as 50 or 100 UCT-Vs.
■   When you create a new upgrade task for the same UCT-V, the status of any existing UCT-V changes to 'In Progress' until the latest task is completed. Once the upgrade for the existing tasks is successfully finished, you can create another task for that same UCT-V.

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

Notes:
■   The default wait time for the Upgrade Status to get updated is 15 minutes.
■   The default wait time for the Image Version to get updated is 5 minutes.
■   In case of failure, you can upgrade the failed instance manually.

Upgrade UCT-V manually

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.