-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
58 lines (39 loc) · 2.88 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
NAME
HypericCheck - resource checker for Hyperic resources
SYNOPSIS
HypericCheck.sh [-d] [-h] [-p defaults-file] [-s AEID] [-r RID]
DESCRIPTION
HypericCheck is a java wrapper for Hyperic measurement plugins specifically intended to perform on-demand checks of netservices plugin resources. The wrapper uses several classes and methods from Hyperic to call the actual code that the Hyperic agent uses to collect metrics on a resource in a consistent and reproducable manner. Multiple AEID's and RID's can be specified on the command line to check multiple resources with one invokation. Binary packages can be downloaded at http://hyperic.allrightname.com/HypericCheck-latest.tar.bz2
OPTIONS
-d Enable DEBUG logging
-h This help message
-p defaults-file
Use an alternate properties file as the configuration source. Defaults to ~/.hq/client.properties
-s AEID
Specify a resource to collect metrics on via AEID. AEID's can be found as the last 5 digits on a resource's URL within the Hyperic GUI
-r RID
Specify a resource to collect metrics on via RID. RID's can be found using the hqapi.
FILES
~/.hq/client.properties
The default configuration file. Expects the file to conform to Java's syntax for properties files and takes values in the <key>=<value> form.
Sample config:
host=monitor.mynetwork.com
port=7443
secure=true
user=hqadmin
password=hqadmin
Aside from the default options for hqapi in the client.properties file, the following HypericCheck specific options are expected:
hc.pdkDir Full path to the lib/pdk directory that came with this utility
hc.pluginDir Full path to the lib/plugins directory that came with this utility
The following options are optional and apply to the usage of the PasswordBouncer utility so that no passwords need to be on your filesystem. If you use these options, the password key need not have a value.
hc.password.source Only accepts \"pb\".
hc.password.port Port that PasswordBouncer is listening on. Defaults to 10127.
hc.password.host Address that PasswordBouncer is listening on. Defaults to localhost.
hc.password.string String that PasswordBouncer expects prior to returning a password. Defaults to MYPASSWORD.
hc.metricsetSet this to "all", "availability", "throughput", or "utilization" to see metrics of a different category.
BUGS
None found yet :)
WARRANTY
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. THIS SOFTWARE IS NOT SUPPORTED BY VMWARE/HYPERIC.
AUTHOR
Greg Walters <allrightname at gmail>