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