Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Installing and Configuring Cloud Analytics Engine Compute Agent

 

Cloud Analytics Engine Compute Agent (Compute Agent) runs on a server running CentOS 6.5. Compute Agent can run on a CentOS native server or on a KVM hypervisor. Install Compute Agent on each application server that you want to monitor with Cloud Analytics Engine.

The Compute Agent must have network connectivity to all networking devices that it will monitor. Network port 8080 on the Compute Agent server must be accessible by all devices to be monitored. If you change that port number from the default 8080, ensure that the new port number you specify is accessible.

Compute Agent is delivered as an RPM file. You install it using the operating system’s standard package installation procedure.

Note

Compute Agent does not support prelinking. Compute Agent related binaries are ignored during prelinking. This configuration is stored as a new file /etc/prelink.conf.d/cagent.conf, which is created during Compute Agent RPM installation. Compute Agent requires prelink version 0.4.0-1 or higher for this configuration to work correctly.

Compute Agent requires some configuration. To configure it, you have these options:

  • After installing Compute Agent, run the interactive setup program and enter configuration parameters.

  • Create a configuration file in a specified location on the server, then install Compute Agent. The Compute Agent installer will detect the configuration file and use the configuration defined in it instead of running the interactive setup program.

The methods of configuring Compute Agent are described in these sections:

Configuring Compute Agent by Running the Interactive Setup Program

To configure Compute Agent by running the interactive setup program:

  1. Enter the command cagent configure to start the setup program.
  2. Enter the type of environment in which the Compute Agent is installed:
  3. If you entered a hypervisor CA environment type, Enter the type of tunnelling used in the network that the Compute Agent will monitor. If you enter nothing, the default value is None.
  4. Enter a Compute Agent server name. If the server is registered in DNS, the DNS server name is provided as the default value:
  5. Enter a Compute Agent server IP address. If the server is registered in DNS, the DNS IP address is provided as the default value:
  6. Enter the physical interfaces on the server that are connected to the network, separated by commas. Do not include spaces between the port names:
  7. (Optional) Enter the web server IP address:
  8. (Optional) Enter the web server IP interface name:
  9. (Optional) Enter the web server port:
  10. (Optional) Enter the Compute Agent interface name:
  11. (Optional) Enter the Compute Agent log directory. If you enter nothing, the default log directory is /var/log/cagent/.

Configuring Compute Agent Initial Configuration by Using a Configuration File

Rather than running the interactive setup program after installing Compute Agent, you can create a configuration file that the Compute Agent installer will use to configure Compute Agent during installation.

To configure Compute Agent by using a configuration file:

  1. Create a Compute Agent configuration file named cagent.conf.

    See Creating a Compute Agent Configuration File for more information about creating this file.

  2. Put the Compute Agent configuration file in this location on the Compute Agent server: /etc/cagent/cagent.conf.
  3. Install the Compute Agent using the operating system’s standard package installation procedure.

    The Compute Agent installer will detect the configuration file and use the configuration defined in it instead of running the interactive setup program.

Creating a Compute Agent Configuration File

Compute Agent reads a configuration file at startup, which contains configuration settings for Compute Agent to use. The Compute Agent configuration file is a text file in JSON format. The syntax of the file is described in Table 1.

Table 1: Compute Agent Configuration File JSON Format

Variable

Values

Description

Mandatory?

Section: Environment

CA Mode

Native, Hypervisor_KVM

The type of environment in which the Compute Agent is installed.

Enter Native if you are installing Compute Agent on a native server (not a virtual machine).

Enter Hypervisor_KVM if you are installing Compute Agent on a KVM hypervisor.

Yes

CA Server IP Address

IP address

IP address of the Compute Agent server.

No

CA Server Name

Server name

Compute Agent server name.

No

Tunnel Mode

None, VXLAN

The type of tunnelling used in the network that the Compute Agent will monitor.

No

Default value: None

Section: Network Ports

Interface Name

Names of server physical interfaces connected to the network.

Examples: eth0, br0.

The physical interfaces on the server that are connected to the network. Compute Agent monitors these to create a database of active flows.

Yes

IPv4 address

IPv4 address

IPv4 address of a network port.

No

IPv6 address

IPv6 address

IPv6 address of a network port.

No

Mac address

Mac address

Mac address of a network port.

No

Section: CA interface

This configuration section is optional and will be used only if the Tunnel Mode variable is set to None.

The CA interface is the network interface the Compute Agent uses for receiving probe responses from devices.

Interface Name

Names of server physical interfaces.

Examples: eth0, br0.

Interface name

No

IP Address Mode

Static, DHCP

How the CA interface gets a an IP address, either by static configuration or DHCP. If you enter Static, you must assign an IP address using the IP Address variable in this section.

If an interface name is specified, this field is mandatory.

IP Address

IPv4 address

Static IPv4 Address for the CA interface

If the IP Address Mode variable is set to Static then this field is mandatory.

Netmask

IPv4 network mask

IPv4 network mask for the CA interface IP address

If the IP Address Mode variable is set to Static then this field is mandatory.

Section: CA Web Interface

This section is optional.

The CA web interface is the interface for the Compute Agent API.

Interface Name

Names of server physical interfaces.

Examples: eth0, br0.

Interface name

No

IP Address

IPv4 address

Static IPv4 Address for the CA web interface

No

Port

Valid TCP port

TCP port on which Compute Agent listens for web services

No

Default value: 8080

Section: CA Logging

.This section is optional.

Log Directory

Complete path to the directory where logs will be saved in the file cagent.log.

Optional

Optional

Default value: /var/log/cagent/cagent.log

This is an example of a Compute Agent configuration file: