version 2 showing authors affecting page license.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
upsset.cgi |
|
|
2 |
!!!upsset.cgi |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
NOTE |
|
|
6 |
DESCRIPTION |
|
|
7 |
CHANGING SETTINGS |
|
|
8 |
INSTANT COMMANDS |
|
|
9 |
ACCESS CONTROL |
|
|
10 |
SECURITY |
|
|
11 |
FILES |
|
|
12 |
SEE ALSO |
|
|
13 |
---- |
|
|
14 |
!!NAME |
|
|
15 |
|
|
|
16 |
|
|
|
17 |
upsset.cgi - Web-based UPS administration program |
|
|
18 |
!!SYNOPSIS |
|
|
19 |
|
|
|
20 |
|
|
|
21 |
__upsset.cgi__ |
|
|
22 |
!!NOTE |
|
|
23 |
|
|
|
24 |
|
|
|
25 |
As a CGI program, this should be invoked through your web |
|
|
26 |
server. If you run it from the command line, it will sit |
|
|
27 |
there until you give it input resembling a POST |
|
|
28 |
request. |
|
|
29 |
!!DESCRIPTION |
|
|
30 |
|
|
|
31 |
|
|
|
32 |
__upsset.cgi__ lets you access many administrative |
|
|
33 |
functions within the UPS software from your web browser. You |
|
|
34 |
can change settings and invoke instant commands where |
|
|
35 |
available. |
|
|
36 |
!!CHANGING SETTINGS |
|
|
37 |
|
|
|
38 |
|
|
|
39 |
Some UPS hardware allows you to change certain variables to |
|
|
40 |
other values. To see what's available, pick a UPS from the |
|
|
41 |
chooser and select |
|
|
42 |
|
|
|
43 |
|
|
|
44 |
You should see a list of items with the descriptions on the |
|
|
45 |
left side and the possible options or input spaces on the |
|
|
46 |
right. After changing something, be sure to |
|
|
47 |
|
|
|
48 |
|
|
|
49 |
If your UPS doesn't support any read/write variables, there |
|
|
50 |
will be nothing to do on this page. |
|
|
51 |
|
|
|
52 |
|
|
|
53 |
Setting values in read/write variables can also be done from |
|
|
54 |
the command line with upsct2(8). |
|
|
55 |
!!INSTANT COMMANDS |
|
|
56 |
|
|
|
57 |
|
|
|
58 |
Some UPS hardware also has provisions for performing certain |
|
|
59 |
actions at the user's command. These include battery tests, |
|
|
60 |
battery calibration, front panel tests (beep!) and more. To |
|
|
61 |
access this section, do as above, but pick |
|
|
62 |
|
|
|
63 |
|
|
|
64 |
If your UPS supports any instant commands, they will be |
|
|
65 |
listed in a chooser widget. Pick the one you like and |
|
|
66 |
|
|
|
67 |
|
|
|
68 |
Note - some dangerous commands like |
|
|
69 |
|
|
|
70 |
|
|
|
71 |
To actually turn off the load, you have to send the command |
|
|
72 |
once, then send it again after 3 seconds elapse but before |
|
|
73 |
15 seconds pass. If you do it too quickly or slowly, you |
|
|
74 |
have to wait at least 3 seconds but not 15 seconds |
|
|
75 |
again. |
|
|
76 |
|
|
|
77 |
|
|
|
78 |
You can also invoke instant commands from the command line |
|
|
79 |
with upscmd(8). |
|
|
80 |
!!ACCESS CONTROL |
|
|
81 |
|
|
|
82 |
|
|
|
83 |
upsset will only talk to upsd(8) servers that have |
|
|
84 |
been defined in your hosts.conf(8). If it complains |
|
|
85 |
about |
|
|
86 |
__ |
|
|
87 |
!!SECURITY |
|
|
88 |
|
|
|
89 |
|
|
|
90 |
upsset will not run until you convince it that your CGI |
|
|
91 |
directory has been secured. This is due to the possibility |
|
|
92 |
of someone using upsset to try password combinations against |
|
|
93 |
your upsd(8) server. |
|
|
94 |
|
|
|
95 |
|
|
|
96 |
See the example upsset.conf file for more information on how |
|
|
97 |
you do this. The short explanation is - if you can't lock it |
|
|
98 |
down, don't try to run it. |
|
|
99 |
!!FILES |
|
|
100 |
|
|
|
101 |
|
|
|
102 |
hosts.conf(5) |
|
|
103 |
!!SEE ALSO |
|
|
104 |
|
|
|
105 |
|
|
|
106 |
__Internet resources:__ |
|
|
107 |
|
|
|
108 |
|
|
|
109 |
The NUT (Network UPS Tools) home page: |
|
|
110 |
http://www.exploits.org/nut/ |
|
|
111 |
|
|
|
112 |
|
|
|
113 |
NUT mailing list archives and information: |
|
|
114 |
http://lists.exploits.org/ |
|
|
115 |
---- |