Before configuring and using  Apache Web Server agents, you have to download the agent binary from Controller UI home page. To download agent, login to the Controller UI via (https://saas.managecat.com or your onpremise Controller URL), the download agent.



There are two types of agent, Linux and Windows. In this tutorial, we will go with Linux.


Agent Configuration

After downloading the agent, untar the agent (managecat-apache-agent-linux.tar.gz) to any usable folder and go to this folder.


Apache Web Server agent is configured via "managecat-agents.xml" file under "conf/" directory. There exist a different Apache Web Server configuration parameters for different operating systems. Please look at the sample configuration file located in "conf/managecat-agents.xml" file. Configuration parameters of the agent located in "managecat-agents.xml" file.

NOTICE : Please change your agent host address from "conf/server.xml" with "address" attribute of HTTP Connector before starting the agent. Example: Changing address to 192.168.1.23 <Connector address="192.168.1.23" ......./>
NOTICE : SaaS Controller must communicate with the agent. Your firewall allows connections to your agent HOSTNAME/IP:PORT from controller. Default agent port is 8090 and is configured in conf/server.xml file.


Configuration Parameters

There are two section in the managecat-agents.xml file


Global Configuration Parameters

These are the global configuration parameters.

  • <account-key>, ManageCat account key, this is your installation account key or SaaS account key.
  • <host>, Agent host name/ip address. SaaS controller connects to agent via this IP. Default is 8090 and defined in conf/server.xml file. Change this to your server public IP address in conf/server.xml.
  • <port>, Agent port number. SaaS controller connects to agent via this port. Default is 8090 and defined in conf/server.xml file.
  • <collector-url>, ManageCat collector URL address. Default is SaaS controller URL, https://saas.managecat.com/collector/
  • <group name>, Agent group name.



Agent Specific Configuration Parameters

These are the agent specific configuration parameters. In the example configuration file, there exist different configuration parameters for different operating systems.

  • <name>, User friendly agent name.
  • <desc>,Agent description.
  • <control-enabled>,Start/Stop enabled in UI. Default is true.
  • <management-enabled>,Management and monitoring enabled in UI. Default is true.
  • <context-name>,No need to change.
  • <server-root>,Apache server root folder.
  • <conf-dir>,Apache server configuration directory.
  • <logs-dir>,Apache server logs directory.
  • <modules-dir>,Apache server modules directory.
  • <bin-file>,Apache server control file.
  • <extended-status>,Apache extended module is enabled or not. on (Enable), off (Disable) . If extended status is off, only basic monitoring information is shown.
  • <status-url>, If extended-status is 'on', then this parameter provides server mod_status URL address, such as http://localhost/server-status.


How to Run Agent

Open run.sh or run.bat and change COLLECTOR_URL environment variable. For SaaS users, it must be https://collector.managecat.com/. Before running the agent, please configure the agent configuration. See above Agent Configuration parameters.

To run the agent, go to agent directory and run "sh run.sh" command in Linux os or "run.bat" in windows os.

For questions, please email to support@managecat.com