Install UCT-V OVS Agent for OVS Mirroring

This is applicable only if you are using UCT-V OVS agent as the source of acquiring traffic. You must have sudo/root access to edit the UCT-V OVS agent configuration file. Before installing the UCT-V OVS agents, you must have launched the GigaVUE‑FM instance. UCT-V OVS agent supports a maximum of 255 source interfaces per OpenStack node.

Note:  After rebooting your workload VM, you must redeploy the respective Monitoring Sessions to restore the mirror traffic on the respective workload VM interfaces.

You can install theUCT-V OVS agents either from Debian or RPM packages as follows:

Install the UCT-V OVS Agent from Ubuntu/Debian Package

To install from a Debian package:

  1. Download the latest version of UCT-V OVS Agent Debian (.deb) package from the Gigamon Customer Portal.
  2. Copy this package to OpenStack compute nodes. Install the package with root privileges, for example:

    $ ls gigamon-gigavue-uctv-ovs-agent_6.9.00_amd64.deb

    $ sudo dpkg -i gigamon-gigavue-uctv-ovs-agent_6.9.00_amd64.deb

  3. Once the UCT-V OVS agent package is installed, modify the file /etc/uctv/uctv.conf to configure and grant permission to monitor ingress and egress traffic and to transmit the mirrored packets.

    Note:  When you have an active, successful monitoring session deployed, any changes to the UCT-V config file made after the initial setup require an UCT-V restart and an inventory refresh or sync from GigaVUE-FM to pick up the new changes and re-initiate the traffic mirroring. GigaVUE-FM does a periodic sync on its own every 15 minutes.


    br-int mirror-dst

     

    # Changes for OVS Mirroring

    # This Value will be used as local Ip in OVS Mirror Config

    tunnel-src 172.20.20.11

    # This Value will be used as Next Hop for Tunneled Packets

    tunnel-gw 172.20.20.1

    This Value will be used as local Ipv6 in OVS Mirror Config

    tunnel-src-v6 2001::161

    This Value will be used as Next Hop ipv6 addr for Tunneled Packets

    tunnel-gw-v6 2001::1

    # OVS Agent Mode, Values: auto|standard|dpdk|hw-offload

    ovs-agent-mode auto

    # VLAN Tag value (valid: 0-4094)

    ovs-vlan-tag 2020

    # Egress Interface for OVS Mirrored Traffic

    ovs-egress-if vlan2020

  4. After modifying the UCT-V OVS config file, start the agent service.

    $ sudo service uctv start

  5. The UCT-V OVS agent status will be displayed as running. Check the status using the following command:

    $ sudo service uctv status

    UCT-V is running

Install the UCT-V OVS Agent from RPM package

To install from an RPM (.rpm) package on a Redhat, CentOS, or other RPM-based system:

  1. Download the UCT-V OVS Agent RPM (.rpm) package from the Gigamon Customer Portal.
  2. Copy this package to OpenStack compute nodes. Install the package with root privileges, for example:

    $ ls gigamon-gigavue-uctv-ovs-agent_6.9.00_x86_64.rpm

    $ sudo rpm -ivh gigamon-gigavue-uctv-ovs-agent_6.9.00_x86_64.rpm

  3. Once the OVS agent package is installed, modify the file /etc/uctv/uctv.conf to configure and grant permission to monitor ingress and egress traffic and transmit the mirrored packets.

    Note:  When you have an active, successful monitoring session deployed, any changes to the UCT-V config file made after the initial setup require an UCT-V restart and an inventory refresh or sync from GigaVUE-FM to pick up the new changes and re-initiate the traffic mirroring. GigaVUE-FM does a periodic sync on its own every 15 minutes.


    # br-int mirror-dst

     

    # Changes for OVS Mirroring

    # This Value will be used as local Ip in OVS Mirror Config

    tunnel-src 172.20.20.11

    # This Value will be used as Next Hop for Tunneled Packets

    tunnel-gw 172.20.20.1

    This Value will be used as local Ipv6 in OVS Mirror Config

    tunnel-src-v6 2001::161

    This Value will be used as Next Hop ipv6 addr for Tunneled Packets

    tunnel-gw-v6 2001::1

    # OVS Agent Mode, Values: auto|standard|dpdk|hw-offload

    ovs-agent-mode auto

    # VLAN Tag value (valid: 0-4094)

    ovs-vlan-tag 2020

    # Egress Interface for OVS Mirrored Traffic

    ovs-egress-if vlan2020

  4. After modifying the UCT-V OVS config file, start the agent service and verify its status.

    $ systemctl start uctv.service

    $ sudo service uctv status

    UCT-V is running

  • UCT-V OVS Agent is supported for OpenStack with container-based deployment.
    # Docker name to run the OVS Commands
    docker-name openvswitch_vswitchd
  • When you are installing a self-signed RPM package, you must execute the following command to import the signing key into the RPM db.
    sudo rpm --import /path/to/YOUR-RPM-GPG-KEY

To upgrade UCT-V OVS agent:

  • You must backup the /etc/uctv/uctv.conf configuration file before upgrading the UCT-V OVS Agent and uninstall the old OVS agents.
  • Follow the same installation procedure to upgrade the UCT-V OVS agents.
  • After upgrading the UCT-V OVS Agent, copy and modify the uctv.conf file, stop the agent, and start the agent. Redeploy the Monitoring Session if required.
    service uctv stop
    service uctv start