Skip Navigation

Support

 

Install / Configure FileCatalyst Monitoring Agent

Note: In order to use this software you need to have Java 1.4.2 or higher installed and FileCatalyst Server running on a server.

Windows

  1. Download the FileCatalyst MonitoringAgent installer (install_fc_monitoringagent.exe).
  2. Launch installer.
  3. Step through Wizard, chose the installation directory and the shortcut options.
  4. The application will automatically install and start as a service.

Linux

  1. Create directory at /opt/utechsoft/monitoringagent
  2. Download tarball (fc_monitoring_agent.tar.gz) to the above directory.
  3. Unpack the tarball:
    • > cd /opt/utechsoft/monitoringagent
    • > gunzip fc_monitoring_agent.tar.gz
    • > tar -xvf fc_monitoring_agent.tar
    • > cd /opt/utechsoft/monitoringagent
    • > chmod u+x *.sh
  4. You can start and stop the service with these commands:
    • > /opt/utechsoft/monitoringagent/fc_monitor_start.sh -b
    • > /opt/utechsoft/monitoringagent/fc_monitor_stop.sh
  5. You will more than likely want to install this as a service.
    • > cd /opt/utechsoft/monitoringagent/service_wrapper/
    • > chmod u+x *.sh
    • >./install.sh

Configuring MonitoringAgent

The initial installation of MonitoringAgent assumes that FileCatalyst Server is installed on the same server. If it is not you will need to update the maconf.conf file located in the install path of FileCatalyst MonitoringAgent.

In the maconf.conf file look for the following lines:

FCMonitoringAgent.config.service.1.address=127.0.0.1
FCMonitoringAgent.config.service.1.port=12500
FCMonitoringAgent.config.service.1.alias=FC Server
FCMonitoringAgent.config.service.1.monitoruser=monitor
FCMonitoringAgent.config.service.1.monitorpass=12345
FCMonitoringAgent.config.service.1.manager=true

You can change these to the appropriate values. If you are running the FileCatalyst Server on the same server you can leave the address as 127.0.0.1, if not update this to the appropriate IP address. If you are monitoring multiple servers just increment the number in the lines above. IE:

FCMonitoringAgent.config.service.2.address=192.168.1.100
FCMonitoringAgent.config.service.2.port=12500
FCMonitoringAgent.config.service.2.alias=FC Server2
FCMonitoringAgent.config.service.2.monitoruser=monitor
FCMonitoringAgent.config.service.2.monitorpass=12345
FCMonitoringAgent.config.service.2.manager=true

Once changes are made to the maconf.conf file the service needs to be restarted for these changes to take effect.

  • In Windows you can do this through the Services mmc.
  • Linux can be done with this command: > /etc/init.d/fcmonitor restart

Once this is configured, you will configure FileCatalyst Server to enable Monitoring under the "Alarm Monitor" panel.

Configuring FileCatalyst Server

  • Open FileCatalyst Server Admin.
  • Select the Alarm Monitor Panel.
  • Check "Enable remote monitoring of service".
  • Enter login credentials used in the maconf.conf file.
  • Click Apply.
  • Restart FileCatalyst Server for changes to take effect.

You can test this out by attempting to login 5 times. Once the 60 second poling interval is hit you will see the alarm appear in the Active Alarm List.

Configuring Dispatchers

Alarms can be dispatched using SMTP or SNMP.

Email Dispatcher

  1. In the MonitoringAgent installation directory, open the file maconf.conf.
  2. File the "Dispatcher Definition" section and locate the EMAIL subheading.
  3. Set the following values:

    FCMonitoringAgent.config.email.enable=true
    FCMonitoringAgent.config.email.from=FCMonitoringAgent@mycompany.com
    FCMonitoringAgent.config.email.to=administrator@mycompany.com
    FCMonitoringAgent.config.email.cc=
    FCMonitoringAgent.config.email.smtp.host=mailhost.mycompany.com
    FCMonitoringAgent.config.email.smtp.port=25
    FCMonitoringAgent.config.email.smtp.auth=false
    FCMonitoringAgent.config.email.smtp.user=username
    FCMonitoringAgent.config.email.smtp.pass=password

  4. Save the maconf.conf file.
  5. Restart the MonitoringAgent service.

SNMP Dispatcher

This should only be used for advanced users that have prior knowledge on how SNMP works.

  1. In the MonitoringAgent installation directory, open the file named maconf.conf.
  2. Fine the "Dispatcher Definition" section and locate the SNMTP subheading.
  3. Set the following values:

    FCMonitoringAgent.config.snmp.enable=true
    FCMonitoringAgent.config.snmp.manager=192.168.1.100
    FCMonitoringAgent.config.snmp.port=162
    FCMonitoringAgent.config.snmp.community=public
    FCMonitoringAgent.config.snmp.version=v2c

  4. Value SNMP versions are: "v1" and "v2c"
  5. Multiple SNMP managers may be defined.
  6. Save the maconf.conf file.
  7. Restart the MonitoringAgent service.