Pandora FMSRaven DB Plugin

Administrator Manual

Index1. INTRODUCTION............................................................................................................................22. COMPATIBILITY MATRIX............................................................................................................33. MODULES GENERATED BY THE PLUGIN...............................................................................34. PREREQUISITES............................................................................................................................45. Plugin Configuration........................................................................................................................46. Plugin Execution..............................................................................................................................5

Page 2

1. INTRODUCTION

This document's main objective is the description of the RavenDB monitoring procedures onWindows-based systems.To extract information this plugin uses:• Specif system commands with no need to install libraries or third party tools.• Visual basic scripting language

2. COMPATIBILITY MATRIX

The compatibility matrix for RavenDB monitoring plugin is:

Systems where it has been tested • RavenDB 2.5.2874

Systems where it should work • RavenDB 2.5.2874 or above

3. MODULES GENERATED BY THE PLUGIN

This plugin returns 12 modules. All of them display valuable status information. You can fixthresholds manually to determine whether something is in a warning/critical or operative condition.

• RavenDB_Server_Process_Running: Informs if the process is active• RavenDB_Server_Process_PID: Shows the PID of the process• RavenDB_Server_Process_Memory_Usage: Shows the memory usage for the process .• RavenDB_Server_Process_CPU_Usage_Percentage: Shows the porcentage of cpu use for

the process.

Page 3

• RavenDB_Server_Process_Sessions: Returns the number of Sessions for the Process• RavenDB_Server_Process_Session_Name: Returns the specific session name for the

process• RavenDB_Database_Number: Returns the number of Databases created in Raven DB• RavenDB_Database_Size: Shows the Database size.• RavenDB_Uptime: Returns the uptime for the Raven DB• <Database>_Documents: Returns the amount of documents in the database where:• <Database> is the name for every single one of them.• <Database>_Requests_Per_Second: Returns the number of request per second for the

databases• <Database>_Concurrent_Requests: Returns the number of concurrent requests for the

database.

4. PREREQUISITES

The Raven DB plugin uses Windows commands to obtain data.The prerequisites for this monitoring to work correctly are the following:• RavenDB must be installed• A Pandora FMS agent must be installed• In order to use RavenDB management studio Microsoft Silverlight must be installed.

5. PLUGIN CONFIGURATION

This plugin is prepared to function with the latest version of RavenDB (2.5.2874). This version can be downloaded from the following link: http://hibernatingrhinos.com/downloads/RavenDB/2874.

Once the download is complete the files must be extracted in the following folder: c:\RavenDB-Build-2874. Once done you need to access that folder and execute Start.cmd

To install the plugin in Pandora, you need to copy it to the following folder: C:\Program Files(x86)\pandora_agent\util. Once done edit the pandora agent configuration file located in:C:\Program Files (x86)\pandora_agent\pandora_agent.conf and add the following line:module_plugin cscript.exe //B "%ProgramFiles%\Pandora_Agent\util\RavenDB_Plugin.vbs

Page 4

6. PLUGIN EXECUTION

If everything is working fine you should be able to see the following image with all the modules created.

Page 5