My Oracle Support Banner

How to connect a RUEI collector to a GRE Ethernet Tunnel (Doc ID 1615788.1)

Last updated on JANUARY 03, 2020

Applies to:

APM - Application Performance Management - Version 12.1.0.6.0 and later
Information in this document applies to any platform.

Purpose

1 Introduction

This document describes how to set up a GRE Ethernet (Layer 2) tunnel to a RUEI Collector Engine. Where the Collector Engine is running does not matter as long as the tunnel endpoints can reach each other through the network. Note however that the network throughput can decrease when using tunnels, as there is space (network throughput) overhead caused by additional headers added to the packets and time (CPU) overhead because of encapsulation/decapsulation of those packets in the Linux kernel.

This setup is supported for RUEI as of version 12.1.0.5. The release notes state:

Support for virtualized collectors

RUEI now supports virtualized collectors. GRE tunnels, rather than tap or span ports, make the traffic available to the RUEI collector. Information on how to set up GRE tunnels and specific limitations of such a configuration will be made available via a knowledge base article shortly after the release

1.1 Note of warning to the reader

Configuring a network needs to be done very carefully, as a wrong command can take a network offline, possibly severing any connection you have to the server currently being configured along with it. In that case console access is needed to 'fix' the situation. You should be prepared for this situation by setting up or obtaining console access to the system you are configuring. That having been stated, the steps in the following chapters should be reasonably safe. 

1.2 Coverage

GRE Ethernet tunneling has been supported in Linux since kernel version 2.6.28, and requires an up to date version of the iproute package containing the utilities (specifically the IP utility) to set up and configure GRE Ethernet tunnel (gretap) interfaces.

This document uses Oracle Linux (OL) 6.4 as a base for setting up the GRE Ethernet tunnels, as OL6 provides a UEK kernel (Linux version 2.6.39-400.109.1.el6uek at time of writing) capable of setting up GRE Ethernet tunnels, as well as the correct version of the iproute package (iproute-2.6.32-23.el6.x86_64 for OL6.4) needed to add/delete/change GRE Ethernet tunnels. 

OEL5 could support GRE Ethernet tunnels in its UEK kernel (Linux version 2.6.39-400.21.1.el5uek for OEL5.9) but needs a newer version (2.6.28 or higher) of the iproute package capable of setting up GRE Ethernet tunnels. Such a version of the iproute package is currently not officially supported and as such it is not covered by this document. 

Installing and configuring a RUEI 12.1.0.5 collector on OL6 is specifically not covered by this document. Please refer to the following document to locate the latest installation guide:
Oracle Real User Experience Insight (RUEI) - software and documentation download location <Document 579348.1>

Scope

This method implements standard GRE. Variations on GRE like ERSPAN are currently not working using this procedure. An Enhancement Request to have ERSPAN also included in this procedure is under consideration.

Details

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!


In this Document
Purpose
 1 Introduction
 1.1 Note of warning to the reader
 1.2 Coverage
Scope
Details
References

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.