Cacti (home)ForumsDocumentation

satabeast

type:
user_template_host
usertemplate:
satabeast
author:
eschoeller
description:
Nexsan SATABeast Storage Arrays
Cacti:
0.8.8b
homepage:
http://forums.cacti.net/viewtopic.php?f=12&t=51161
date:
11/05/2013
includes:
yes
script:
Perl Script Server
templates:
nexsan,
satabeast

Download

VersionFile
0.8.8bnexsan_stats_1-0.zip

Information

Sorry this documentation will be lacking an appropriate amount of detail for now. The Nexsan devices (many classes) have some “secret” webpages that dump a whole bunch of data about the device. This really depends on age, and firmware version. Your mileage will certainly vary. The dump files are a mess, and nearly impossible to parse. Any small thing that goes wrong could potentially render this all useless. That being said, I was able to craft this to work relatively well against Nexsan devices spanning 7 years, all with different out-of-date firmware versions =)

On some units, there are tons of graphs to create. Others, not so many. Make sure you set names on all your Arrays and Volumes. Nexsan Advanced requires that you hard-code your ADMIN password into the script. This was the only way to get that data. I felt it was better to hard-code it in the script. This way there is no run-time snooping or database intrustions that can expose it. Just make sure the permissions are set well.

I highly encourage the use of caching. The idea is to fetch the HTML page once per polling cycle. If you disable caching, you will be fetching the HTML page potentially hundreds of times per polling cycle. Your poller runtime will crater. When caching is on, the script should intelligently poll the cache if it is recent enough.

Installation

  1. Place all of the query-nexsan-*.xml files in path_cacti/resource/script_queries.
  2. Place all of the .pl files in path_cacti/scripts/
  3. Import cacti_host_template_nexsan_storage.xml into cacti via the normal methods.
  4. edit query_nexsan_adv.pl and enter in USER and PASS variables! (beware, this requires ADMIN. If you don't like it, don't use it)
  5. Make sure your cache directory is correct in both perl scripts.
  6. create a host using the host template. Select SNMP … 'not in use'
  7. set host down method to ICMP Ping.
  8. I *highly* recommend using 6 threads (just as long as you are using caching)

This is what you end up importing:

CDEF
[success] Celsius to Fahrenheit [update]

GPRINT Preset
[success] Normal [update]
[success] Exact Numbers [update]

Data Input Method
[success] Get Script Data (Indexed) [update]

Data Template
[success] Nexsan - Fan Speed [new]
[success] Nexsan - Temperature [new]
[success] Nexsan - Voltage [new]
[success] Nexsan - Disk [new]
[success] Nexsan - Array Space [new]
[success] Nexsan - Array Operations [new]
[success] Nexsan - Interface Packets [new]
[success] Nexsan - Interface Errors [new]
[success] Nexsan - HBA IO [new]
[success] Nexsan - HBA Resets [new]
[success] Nexsan Advanced - Controller CPU [new]
[success] Nexsan Advanced - Controller Memory [new]
[success] Nexsan Advanced - Array Load [new]
[success] Nexsan Advanced - Volume Operations [new]
[success] Nexsan Advanced - Volume Blocks [new]

Graph Template
[success] Nexsan - Fan Speed [new]
[success] Nexsan - Temperature [new]
[success] Nexsan - Voltage [new]
[success] Nexsan - Disk [new]
[success] Nexsan - Array Space [new]
[success] Nexsan - Array Operations [new]
[success] Nexsan - Interface Packets [new]
[success] Nexsan - Interface Errors [new]
[success] Nexsan - HBA IOs [new]
[success] Nexsan - HBA Resets [new]
[success] Nexsan Advanced - Controller CPU [new]
[success] Nexsan Advanced - Controller Memory [new]
[success] Nexsan Advanced - Array Load [new]
[success] Nexsan Advanced - Volume Operations [new]
[success] Nexsan Advanced - Volume Blocks [new]

Data Query
[success] Nexsan - Fan Speeds [new]
[success] Nexsan - Temperatures [new]
[success] Nexsan - Voltages [new]
[success] Nexsan - Disk Statistics [new]
[success] Nexsan - Array [new]
[success] Nexsan - Interfaces [new]
[success] Nexsan - HBA Statistics [new]
[success] Nexsan Advanced - Controller [new]
[success] Nexsan Advanced - Array [new]
[success] Nexsan Advanced - Volume [new]

Host Template
[success] Nexsan Storage [new]

Getting Help

Screenshots






Personal Tools