Prerequisites

Agent is a simple tar archive, ready to be deployed on a filesystem.

Select a filesystem with 500M of free space. This will be the hpa directory, referenced as hpa_agent_dir
calypso_user, the user who launches Calypso processes, should have access in read, write and execution to this directory.

The below steps have to be done at least in one host per new install or upgrade of the agent. Once finalized, the hpa_agent_dir can be tar and copied/pasted on the other hosts where Calypso is deployed.

Installation and update steps

Each agent install/upgrade consists in unzipping the agent zip file directly into the hpa_agent_dir folder. This folder will contain two entries that are specific to the client setup:

hpa_agent_config.sh that contains the reference to the HPA portal this agent must send metrics to
override_config folder that contains all the client agent specific configuration

Unzipping a new agent zip in a context of an agent upgrade won’t replace those elements.

Download and send agent binary on server to download_dir : hpa-agent-calypso-x.xx.zip
Create a directory in a filesystem with 500Mo of free space for hpa_agent_dir : example /opt/hpa/uniqueagent

Actions for first install or upgrades

Log into calypso_user and run (can be one-lined):

unzip {{download_dir}}/hpa-agent-calypso-x.xx.zip -d {{hpa_agent_dir}} ;   
chmod 755 {{hpa_agent_dir}}/*.sh
bash {{hpa_agent_dir}}/deploy.sh 1.xx

Configuration on first installation

Create the first config file:

cd {{hpa_agent_dir}}
cp hpa_agent_config.sh.template hpa_agent_config.sh

Complete the configuration file:

export HPA_EM_HOST=<em host>:5443
export HPA_CALYPSO_ENV=v15-hex1-perf

See Portal environment config file to find the right values.

Deploy the agent

Required for:

the first install
any upgrade
each time hpa_agent_config.sh is modified

bash {{hpa_agent_dir}}/deploy.sh x.xx

where x.xx is the version of the last agent installed/to deploy

Update de Calypso startup scripts

Modify the Calypso startups scripts, a wizard is available in the portal to help you :

Infrastructure monitoring

See APMIA/Infrastructure Agent.

Oracle monitoring

See Infrastructure Oracle extension.

Other information

Agent log files can be found here : {{hpa_agent_dir}}/wily/logs

Two files are created by monitored component :

Autoprobe-.log : this file is erased each time a component starts. Size is around 1MB.
IntroscopeAgent-.log : this file is updated at each component startup. It contains the live logs of the agent. It is rotated.

Other sections specific to each component provides more details about agent install and configuration.

HPA installation and deployment HPA agent Calypso Agent installation