Project

General

Profile

Installation » History » Version 4

Luke Murphey, 08/23/2016 03:40 AM

1 1 Luke Murphey
h1. Installation
2 1 Luke Murphey
3 3 Luke Murphey
The app contains a series of scripts that will:
4 2 Luke Murphey
5 3 Luke Murphey
# *Perform a S.M.A.R.T. self-test:* this is recommended monthly
6 3 Luke Murphey
# *Obtain S.M.A.R.T. data:* this is recommended hourly
7 1 Luke Murphey
8 3 Luke Murphey
Several versions of the scripts are included:
9 1 Luke Murphey
10 3 Luke Murphey
|_. Script |_. Purpose |_. Environment |_. Notes |
11 3 Luke Murphey
| smartmon_results.cmd | Obtain S.M.A.R.T. data and tests results | Windows | Enabled by default |
12 3 Luke Murphey
| smartmon_results.ps1 | Obtain S.M.A.R.T. data and tests results | Windows (Powershell version) | |
13 3 Luke Murphey
| smartmon_results.sh | Obtain S.M.A.R.T. data and tests results | *nix | |
14 3 Luke Murphey
| smartmon_short_test.cmd | Performs a short self-test | Windows | Enabled by default |
15 3 Luke Murphey
| smartmon_short_test.ps1 | Performs a short self-test  | Windows (Powershell version) | |
16 3 Luke Murphey
| smartmon_short_test.sh | Performs a short self-test  | *nix | |
17 1 Luke Murphey
18 3 Luke Murphey
smartctl binaries for Windows are included by default in order to make installation easier. For this reason, the CMD scripts are enabled by default.
19 1 Luke Murphey
20 3 Luke Murphey
h2. Windows
21 1 Luke Murphey
22 3 Luke Murphey
This app doesn't require Python and can be installed on a Universal Forwarder as well as a heavy forwarder. The input for performing hourly data gathering and monthly tests should work by default. No further changes should be necessary other than installing the app on a forwarder.
23 3 Luke Murphey
24 3 Luke Murphey
The app publishes views that will appear when the app is installed on a Search Head. It is recommended that you install the app on the Search Heads in order to monitor the Search Head disks and to use the analysis views.
25 3 Luke Murphey
26 3 Luke Murphey
h2. Non-Windows
27 3 Luke Murphey
28 3 Luke Murphey
h3. Install smartctl
29 3 Luke Murphey
30 4 Luke Murphey
The binaries are not included for non-Windows platforms. You will need to first install smartctl for your platform. See "smartmontools.org":http://smartmontools.org for more details. Note that native packages may be available for your platform. For example, apt-get can be used to install smartmontools on Ubuntu (e.g. "sudo apt-get install smartmontools"). Make sure smartctl is in the path so that Splunk can run it. smartctl will also need root access. Thus, make sure it runs with the proper permissions.
31 3 Luke Murphey
32 3 Luke Murphey
h3. Enable collection scripts
33 3 Luke Murphey
34 3 Luke Murphey
The collection scripts are not enabled by default since the smartctl binaries are not included with by default for non-Windows platforms. You will need to edit the inputs in order enable them. This can be done in the Splunk Manager by enabling the "smartmon_results.sh" and/or "smartmon_short_test.sh" script accordingly. You can also deploy a local version of inputs.conf to enable them:
35 3 Luke Murphey
36 3 Luke Murphey
<pre>
37 3 Luke Murphey
[script://./bin/smartmon_results.sh]
38 3 Luke Murphey
disabled = 0
39 3 Luke Murphey
40 3 Luke Murphey
[script://./bin/smartmon_short_test.sh]
41 3 Luke Murphey
disabled = 0
42 3 Luke Murphey
</pre>