CorvilNet Monitoring User Guide

Overview

The CorvilNet integration enables Geneos to connect with the CorvilNet Engine (CNE). This integration makes available the network monitoring data from the CorvilNet Engine to Geneos. This integration is performed through the API plug-in.

When set up, the integration and its associated API plug-in comprise the CorvilNet plug-in (CNPI).

When you set up the CNPI for the first time, it produces three basic dataviews:

• cnpiConfig — shows the general information and status of your CNPI.
• qosAlerts — shows any outstanding quality-of-service alerts.
• systemAlerts — shows any outstanding system alerts

The CorvilNet monitoring statistics views appear when you configure the respective configuration (.cfg) files on the API sampler. These views are the main feature of the CorvilNet monitoring integration, as these show the monitoring statistics coming from the CNE:

• getSummary — shows a summary of the CorvilNet monitoring statistics.
• getStats — shows historical statistics as monitored by the CNE.
• getLiveStats — shows live statistics as monitored by the CNE.

If you are using the Latency Management Centre (LMC) to monitor your CNE, then your integration includes three additional views:

• trapFODConfig — shows the configuration details of the trap fan-out daemon (trapFOD), including errors encountered when you run the trapFOD.
• fodCNEStatus — shows the status of the trap-forwarding process with respect to each known CNE.
• fodCNPIStatus — shows the status of the trap forwarding process with respect to each known CNPI instance.

The CNPI receives monitoring statistics from the CNE through the Corvil API. The CNE also sends system event information through the Simple Network Management Protocol (SNMP).

This guide discusses the steps to set up the CorvilNet plug-in from its source integration files. Once the integration is set up, the dataviews become available through the API plug-in.

Information related to setting up and administering to the CNE or LMC is out of scope of this guide.

Intended audience

This guide is directed towards experienced Geneos users who want to set up an integration between Geneos and the CorvilNet Engine (CNE). If the organisation uses the Corvil Latency Management Centre (LMC) to manage multiple instances of the CNE, then there are additional steps in the integration.

The CorvilNet monitoring integration requires a Linux machine. As a user, you should be familiar with general system administration on this platform.

Prerequisites

The following requirements must be met prior to the installation and setup of the template:

• A Linux machine where the CNPI and, if applicable, the trapFOD can run.
• The machine where the CNPI runs must be able to communicate with the CNE via HTTP or SNMP.
• We recommend that you set up the integration on the same machine as the Netprobe. Otherwise, ensure that the machines can communicate via SNMP.
• This requires an additional licence to use. Please contact your ITRS Account Manager for more information.

CorvilNet Engine credentials

When you configure the CorvilNet monitoring integration, you will need the following information from your CNE:

• Address or hostname
• Web services interface port number
• Web services interface username and password

If you are using SNMP to connect the CNE to the CNPI, then you will need the following:

• SNMP port number
• SNMP community string

Connection structure

Depending on your organisation, your CorvilNet monitoring integration could look like one of the following:

Integration steps — CorvilNet Engine monitoring

The CorvilNet integration involves the following tasks:

1. Download the integration files.
2. Set up the API sampler.
3. Associate the API plug-in with a managed entity.
4. Set up the CorvilNet start-up script.
5. Run the CorvilNet start-up script.

Download the integration files

1. On the ITRS Downloads page, download the CorvilNet integration files (geneos-cnpi-1.3.2032.tar.gz).
2. Save the files on the Linux machine where plan to run the CorvilNet integration.

The integration files include the following sub-folders:

• examples — contains the configuration templates and start-up script you need to set up the integration.
• Linux_x86_64 — contains the source files that run the CorvilNet integration.

Set up the CorvilNet start-up script

1. From the CorvilNet integration files you downloaded, go to the examples folder and locate the file named start_cnpi.
2. Open start_cnpi in a text editor.
3. Replace the values in brackets with the respective details from your system. For more information, see the CorvilNet plug-in start-up script variables.

Run the CorvilNet start-up script

1. Open the Terminal.
2. Enter the following command:

bash$ chmod u+x start_cnpi

Success: After you run the integration script, the basic dataviews appear under the managed entity that you configured for CorvilNet. For more information on the basic dataviews, see the Default metrics and dataviews.

If you set the start script to have the --verbose setting, then you will see some initial information in the log file. Otherwise, the log file is empty.

Additional steps — Latency Management Centre

If you are using the CNE through the LMC, then there are additional steps for you to perform:

1. Set up the trapFOD start-up script.
2. Run the trapfod start-up script.
3. Set the FOD parameters in the sampler.

Set the FOD parameters in the sampler

1. On the Gateway Setup Editor, open the sampler you set up in Set up the API sampler.
2. In the Basic tab, add the following parameters:
   • FOD_HOSTNAME — hostname of the trapFOD.
   • FOD_PORT — network port of the trapFOD.

Success: After you set the FOD parameters, the API sampler begins to interact with the trapFOD.

Shutdown script

If you want to shut down the CNPI, follow these steps:

1. Locate the PID file in the {LogLocation} you specified in CorvilNet Monitoring User Guide .
2. Open the Terminal.
3. Enter the following command, specifying the {LogLocation} and the PID file on your system. For example:

bash$ kill $(cat /home/user/log/geneos-cnpi.pid )

Success: This command kills the process associated with the CNPI.

Appendix

#!/bin/bash
# Template start-up script for the Geneos CorvilNet plugin, geneos-cnpi.
# See the plug-in manual for a further explanation of this script.

# The location where the plug-in media was unpacked
export CNPI_UNPACK={UnpackLocation}

# The name of the subdirectory containing the executable and libraries appropriate to the host environment
# (eg Linux_x86_64, SunOS, etc)
export HOST_TYPE={HostType}

# The name of the directory in the unpack location containing the version of the plug-in to be used.
export CNPI_VERSION={PlugInVersion}

# The location to which the plug-in can write log files
export LOG_DIR={LogLocation}

# The relevant Geneos components
export MANAGED_ENTITY={ManagedEntity}
export NETPROBE_HOSTNAME={LocalHost}
export NETPROBE_PORT={Port}
export SAMPLER_NAME={SamplerName}

# The relevant Corvil components
export CNE_API_HOSTNAME={APIHostname}
export CNE_API_PORT={APIPort}
export CNE_USERNAME={Username}
export CNE_ENCRYPTED_PASSWORD={EncryptedPassword}
export CNE_SNMP_PORT={SNMPPort}
export CNE_COMMUNITY={CommunityString}

# The specification of how CNE traps will be received by geneos-cnpi
export TRAP_HOSTNAME={TrapHostname}
export TRAP_PORT={TrapPort}

# START THE PLUG-IN
export CNPI_DIR=$CNPI_UNPACK/$CNPI_VERSION/$HOST_TYPE
export LD_LIBRARY_PATH=$CNPI_DIR
$CNPI_DIR/geneos-cnpi $MANAGED_ENTITY $CNE_API_HOSTNAME \
--hostname=$NETPROBE_HOSTNAME \
--port=$NETPROBE_PORT \
--sampler=$SAMPLER_NAME \
--detach=$LOG_DIR \
--pid-file=$LOG_DIR/geneos-cnpi.pid \
--log-file=$LOG_DIR/geneos-cnpi.log \
--license=$CNPI_UNPACK/geneos-cnpi.lic \
--api-config=$CNPI_DIR/geneos-cnpi.cfg \
--cne-api-port=$CNE_API_PORT \
--cne-username=$CNE_USERNAME \
--cne-encrypted-password=$CNE_ENCRYPTED_PASSWORD \
--cne-snmp-port=$CNE_SNMP_PORT \
--cne-community="$CNE_COMMUNITY" \
--trap-hostname=$TRAP_HOSTNAME \
--trap-port=$TRAP_PORT \
--brief

# start_cnpi

#!/bin/bash
# Template start-up script for the Geneos CorvilNet plugin trap fan-out daemon, trapfod.
# See the plug-in manual for a further explanation of this script.

# The location where the plug-in media was unpacked
export FOD_UNPACK={UnpackLocation}

# The name of the subdirectory containing the executable and libraries appropriate to the host environment
# (eg Linux_x86_64, SunOS, etc)
export HOST_TYPE={HostType}

# The name of the directory in the unpack location containing the version of the plug-in to be used.
export CNPI_VERSION={PlugInVersion}

# The location to which the daemon should write log files
export LOG_DIR={LogLocation}

# The relevant Geneos components
export MANAGED_ENTITY={ManagedEntity}
export NETPROBE_HOSTNAME={LocalHost}
export NETPROBE_PORT={Port}
export SAMPLER_NAME={SamplerName}

# The specification of how CNE traps will be received by trapfod
export TRAP_HOSTNAME={TrapHostname}
export TRAP_PORT={TrapPort}

# START THE DAEMON
export FOD_DIR=$FOD_UNPACK/$CNPI_VERSION/$HOST_TYPE
export LD_LIBRARY_PATH=$FOD_DIR
$FOD_DIR/trapfod $MANAGED_ENTITY \
--hostname=$NETPROBE_HOSTNAME \
--port=$NETPROBE_PORT \
--sampler=$SAMPLER_NAME \
--detach=$LOG_DIR \
--pid-file=$LOG_DIR/trapfod.pid \
--log-file=$LOG_DIR/trapfod.log \
--license=$FOD_UNPACK/geneos-cnpi.lic \
--trap-hostname=$TRAP_HOSTNAME \
--trap-port=$TRAP_PORT \
--brief

# start_cnpi