Install SNMP support

To enable optional SNMP monitoring support for the FileCap Server the following steps need to be carried out.

Note: SNMP support is an optional step for if you run your own monitoring system

Install SNMP

  • Login with SSH to the FileCap server console
  • In the Console Menu choose option 3 (Admin Prompt)
  • Execute the following two commands to install SNMP support:
    sudo apt-get update
    sudo apt-get install snmpd
  • When asked “Do you want to continue? [Y/n]” type Y and wait for the installation to complete.

Please continue with the following steps to configure SNMP

Configure SNMPv2c

  • Backup default SNMP config file:
    sudo mv /etc/snmp/snmpd.conf /etc/snmp/snmpd.bak
  • Create a new file in your favourite text editor (in this example vi)
    sudo vi /etc/snmp/snmpd.conf
  • Insert the following (in vi; press i and paste the following text):
    #Monitor filecap processes
    proc apache2
    proc mysqld
    proc java#Disk Monitoring
    disk /
    #System Load
    load   12 10 5

    #User and IP that can query SNMP
    rocommunity <PASSWORD> <IP ADDRESS>

Note: Please change “<PASSWORD>” to a password of your choice to use for monitoring the FileCap SNMP and change “<IP ADDRESS>” to the IP address of the monitoring device. If you have multiple monitoring servers which need to query the FileCap server you can create multiple lines with different IP’s.
For example: rocommunity FileCap123 192.168.1.100

  • Save and Quit the file (in vi; Press the ESC-button and type: “:wq” (without quotes))
  • Restart SNMP with the following command:
    sudo systemctl restart snmpd.service

OID examples

To monitor the FileCap server with SNMP the default Debian SNMP OID’s are possible to use. Here are a few example OID’s:

Processes

1.3.6.1.4.1.2021.2.1.5.1 = Number of apache2 processes running
1.3.6.1.4.1.2021.2.1.5.2 = Number of mysqld processes running
1.3.6.1.4.1.2021.2.1.5.3 = Number of java processes running

 

Memory

1.3.6.1.4.1.2021.4.3.0 = Total Swap size
1.3.6.1.4.1.2021.4.4.0 = Available Swap Space
1.3.6.1.4.1.2021.4.5.0 = Total RAM in machine
1.3.6.1.4.1.2021.4.6.0 = Total RAM used
1.3.6.1.4.1.2021.4.11.0 = Total RAM free

 

Diskspace

1.3.6.1.4.1.2021.9.1.2.1 = Path where the disk is mounted
1.3.6.1.4.1.2021.9.1.3.1 = Path of the device for the partition
1.3.6.1.4.1.2021.9.1.6.1 = Total size of the disk/partion (kBytes)
1.3.6.1.4.1.2021.9.1.7.1 = Available space on the disk
1.3.6.1.4.1.2021.9.1.8.1 = Used space on the disk
1.3.6.1.4.1.2021.9.1.9.1 = Percentage of space used on disk

 

System Load

1.3.6.1.4.1.2021.10.1.3.1 = Load 1 minute
1.3.6.1.4.1.2021.10.1.3.2 = Load 5 minutes
1.3.6.1.4.1.2021.10.1.3.3 = Load 15 minutes

 

System uptime

1.3.6.1.2.1.1.3.0 = System uptime