Install G-vTAP Agents

You must have sudo/root access to edit the G-vTAP agent configuration file.

For dual or multiple NIC configuration, you may need to modify the network configuration files to make sure that the extra NIC will initialize at boot time.

You can install the G-vTAP agents either from Debian or RPM packages as follows:

Install G-vTAP from Ubuntu/Debian Package

To install from a Debian package:

  1. Download the G-vTAP Agent Debian (.deb) package.
  2. Copy this package to your instance. Install the package with root privileges, for example:

    ubuntu@ip-10-0-0-246:~$ ls gvtap-agent_1.7-1_amd64.deb

    ubuntu@ip-10-0-0-246:~$ sudo dpkg -i    gvtap-agent_1.7-1_amd64.deb

  3. Once the G-vTAP package is installed, modify the file /etc/gvtap-agent/gvtap-agent.conf to configure and register the source and destination interfaces.The following examples registers eth0 as the mirror source for both ingress and egress traffic and eth1 as the destination for this traffic:

    Example 1—Configuration example to monitor ingress and egress traffic at interface eth0 and use the same interface to send out the mirrored packets

    # eth0   mirror-src-ingress mirror-src-egress mirror-dst

    Example 2—Configuration example to monitor ingress and egress traffic at interface eth0 and use the interface eth1 to send out the mirrored packets

    # eth0   mirror-src-ingress mirror-src-egress

    # eth1   mirror-dst

    Example 3—Configuration example to monitor ingress and egress traffic at interface eth0 and eth 1; use the interface eth1 to send out the mirrored packets

    # eth0   mirror-src-ingress mirror-src-egress

    # eth1   mirror-src-ingress mirror-src-egress mirror-dst

  4. Save the file.
  5. Reboot the instance.

The G-vTAP agent status will be displayed as running. Check the status using the following command:

ubuntu@ip-10-0-0-246:~$ sudo /etc/init.d/gvtap-agent status
G-vTAP Agent is running

Install G-vTAP from RPM package

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

  1. Download the G-vTAP Agent RPM (.rpm) package.
  2. Copy this package to your instance. Install the package with root privileges, for example:

    [user@ip-10-0-0-214 ~]$ ls
    gvtap-agent_1.7-1_x86_64.rpm
    [user@ip-10-0-0-214 ~]$ sudo rpm -i

    gvtap-agent_1.7-1_x86_64.rpm

  3. Modify the file /etc/gvtap-agent/gvtap-agent.conf to configure and register the source and destination interfaces.The following example registers the eth0 as the mirror source for both ingress and egress traffic and registers eth1 as the destination for this traffic as follows:

    Example 1—Configuration example to monitor ingress and egress traffic at interface eth0 and use the same interface to send out the mirrored packets

    # eth0   mirror-src-ingress mirror-src-egress mirror-dst

    Example 2—Configuration example to monitor ingress and egress traffic at interface eth0 and use the interface eth1 to send out the mirrored packets

    # eth0   mirror-src-ingress mirror-src-egress
    # eth1   mirror-dst

    Example 3—Configuration example to monitor ingress and egress traffic at interface eth0 and eth 1; use the interface eth1 to send out the mirrored packets

    # eth0   mirror-src-ingress mirror-src-egress
    # eth1   mirror-src-ingress mirror-src-egress mirror-dst

  4. Save the file.
  5. Reboot the instance.

Check the status with the following command:

[user@ip-10-0-0-214 ~]$ sudo service gvtap-agent status
G-vTAP Agent is running