One Agent Installer for All Cavisson Agents

This page provides pre-requisites and SOPs for installing Cavisson agents (machine agent, Java agent, and PHP agent) for PHP & Java programming framework using One Agent Installer.

Prerequisites

1. Need to run by the root user.
2. Installation of PHP 5.4 or later and any Server (Apache/Nginx) on the machine.
3. Storage requirement – 1 GB.

Supported Platforms

It can run on below Linux environments:

• Ubuntu
• Fedora
• OpenSuse
• Redhat Enterprise
• Suse Enterprise
• CentOS
• CoreOS
• Amazon Linux
• Alpine Linux
• Oracle Linux

Installation Steps

1. Download the CavissonAgent Installer from the Build Hub.

Path: http://10.10.30.16:8992/others/AGENTS-INSTALLER
Sample Installer file name: CavissonAgentInstaller-4.3.0.93.sh

2. Store the file on your machine.
3. Execute the installer file.

Syntax

./CavissonAgentsInstaller.sh –param-basedir=”<base directory>” –param-user=<user name> –param-controller=”<ndcHost:ndcPort>” –param-tier=”<tier name>” –param-server=”<server name>” –param-protocol=”<protocol>” –param-php=”<php version>” –param-proxy-ip=”<proxy IP>” –param-proxy-port=”<proxy port>”

Example    

./CavissonAgentsInstaller.sh –param-basedir=”/opt” –param-user=cavisson –param-controller=”x.x.x.x:xxxx” –param-tier=”Cavisson.QA-Monitor-NS_East” –param-server=”CC-NCMON”  –param-protocol=”TCP” –param-php=”7.0″ –param-proxy-ip=”x.x.x.x” –param-proxy-port=”xxxx” 

Note

To know more about the installer and various parameters, run the command:
./CavissonAgentsInstaller.sh –help

Verification of Installation

Once you execute the installer, you can see the messages that show that agents are successfully installed.

Directory Structure

For Machine Agent: $Base_DIR/cavisson/monitors
For PHP Agent: $Base_DIR/cavisson/netdiagnostics
For Java Agent: $Base_DIR/cavisson/netdiagnostics

Files to check for PHP Agent

Check that the Proxy Control file and PHP Agent .so file is present at the below-mentioned paths.

Proxy Control File

Path: $Base_DIR/cavisson/netdiagnostics “proxyControl.<release>.<version>”
Example:  /opt/cavisson/netdiagnostics File- proxyControl.4.3.0.93.so

PHP Agent .so File
In Ubuntu: Path – /usr/lib/php/<version>   File- cavPHP<version>Agent.<release>.<version>.so

Example: /usr/lib/php/20131226 File- cavPHP5.6Agent.4.3.0.93.so

In CentOS/RHEL: Path – /usr/lib64/php/ File- cavPHP<version>Agent.<release>.<version>.so

Example: /usr/lib64/php/ File- cavPHP5.6Agent.4.3.0.93.so

Files to check for Java Agent

At ND_home, check for lib directory. Below mentioned files should be present.

To enable Java Agent in any Java-based server, add the below command to the startup shell/Env setup file.

-javaagent:$ND_HOME/lib/ndmain.jar=time,ndAgentJar=$ND_HOME/lib/ndagent-with-dep.jar,ndHome=$ND_HOME

Uninstallation Steps

• In $Base_DIR/cavisson, uninstall.sh file should be present after completion of installation.
• To uninstall, just run ./uninstall.sh
• It clears all the files and processes, which are initiated and created by the Installer.

Appendix

Keywords and their Values

Excluding Agents from Installation

To exclude any agent in the installation process, refer to the below section:

Example: To exclude the NF Agent from the installation:

./CavissonAgentsInstaller.sh –param-basedir=”<base directory>” –param-user=<user name> –param-controller=”<ndcHost:ndcPort>” –param-tier=”<tier name>” –param-server=”<server name>” –param-protocol=”<protocol>” –param-php=”<php version>” –param-proxy-ip=”<proxy IP>” –param-proxy-port=”<proxy port>” –no-log-agent