Tripp Lite 0 Idades Manual

							121
Chapter 7: Alerts, Automated Response and Logging
• Check Disable Auto-Response at specific times and you will be able to \
periodically disable Auto-Responses between 
specified times of day  
To configure the condition that will trigger the Auto-Response:
• Click on the Check Condition type (e.g. Environmental, UPS Status or IC\
MP ping) to be configured as the trigger for this 
new Auto-Response in the Auto-Response Settings menu
7.1.1  Environmental Check
To configure Humidity or Temperature levels as the trigger event:
• Click on the Environmental as the Check Condition 
• In the Environmental Check menu, select the specific Environmental Sen\
sor to be checked for the trigger
• Specify the Trigger value (in °C / °F for Temp and % for Humidity) that the check measurement must exceed or drop \
below 
to trigger the AutoResponse 
• Select Comparison type as being Above Trigger Value or Below Trigger Value to trigger
• Specify any Hysteresis factor that is to be applied to environmental mea\
surements (e.g. if an Auto-Response was set up 
with a trigger event of a temp reading above 49°C with a Hysteresis o\
f 4 then the trigger condition would not be seen as 
having been resolved till the temp reading was below 45°C)   
• Check Save Auto-Response  
						

							122
Chapter 7: Alerts, Automated Response and Logging
Note: Before configuring Environmental Checks as the trigger in Auto-Respo\
nse you will need first to configure the Temp and/
or Humidity sensors on your attached EMD 
7.1.2 Alarms and Digital Inputs 
To set the status of any attached Smoke or Water sensors or digital inputs as the trigger event: 
• Click on Alarms/ Digital Inputs as the Check Condition 
• In the Alarms/ Digital Inputs Check menu, select the specific  Alarm/D\
igital IO Pin that will trigger the Auto-Response
• Select Trigger on Change to trigger when alarm signal changes, or select to trig\
ger when the alarm signal state changes to 
either a Trigger Value of Open (0) or Closed (1)
• Check Save Auto-Response
Note: Before configuring Alarms/ Digital Inputs checks in Auto-Response yo\
u first must configure the sensor/DIO that is to be 
attached to your EMD
7.1.3  UPS / Power Supply  
To use the properties of any attached UPS as the trigger event: 
• Click on UPS / Power Supply  as the Check Condition 
• Select UPS Power Device Property (Input Voltage, Battery Charge %, Load %, Input Frequency Hz or Temperature in °C) 
that will checked for the trigger
• Specify the Trigger value that the check measurement must exceed or drop below to tri\
gger the Auto-Response 
• Select Comparison type as being Above Trigger Value or Below Trigger Value to trigger
• Specify any Hysteresis factor that is to be applied to environmental mea\
surements (e.g. if an Auto-Response was set up 
with a trigger event of a battery charge below 20% with a Hysteresis of \
5 then the trigger condition would not be seen as 
having been resolved till the battery charge was above 25%) 
• Check Save Auto-Response
Note: Before configuring UPS checks in Auto-Response you first must confi\
gure the attached UPS
7.1.4  UPS Status  
To use the alert state of any attached UPS as the Auto-Response trigger e\
vent: 
• Click on UPS Status  as the Check Condition 
• Select the reported UPS State to trigger the Auto-Response (either On B\
attery or Low Battery). The Auto-Response will 
resolve when the UPS state returns to the “Online” state
• Select which connected UPS Device to monitor  and check Save Auto-Respon\
se
Note: Before configuring UPS state checks in Auto-Response you first mus\
t configure the attached UPS  
						

							123
Chapter 7: Alerts, Automated Response and Logging
7.1.5 Serial Login/Logout
To monitor serial ports and check for login/logout or pattern matches for\
 Auto-Response triggers events: 
• Click on Serial Login/Logout as the Check Condition. Then in the Serial \
Login/Logout Check menu select Trigger on Login 
(to trigger when any user logs into the serial port) or Trigger on Logout and specify Serial Port to perform check on, and/or
• Click on Serial Signal as the Check Condition. Then in the Serial Signal\
 Check menu select the Signal (CTS, DCD, DSR) 
to trigger on, the Trigger condition (either on serial signal change, or  check level) and\
 specify Serial Port to perform check 
on, and/or 
• Click on Serial Pattern as the Check Condition. Then in the Serial Pattern Check menu select the PCRE pattern to trigger 
on and the serial line (TX or  RX) and Serial Port to pattern check on 
• Check Save Auto-Response
Note: Before configuring serial port checks in Auto-Response you first m\
ust configure the serial port in Console Server mode. 
Also, most serial port checks are not resolvable so resolve actions will\
 not be run.
7.1.6  ICMP Ping
To use a ping result as the Auto-Response trigger event: 
• Click on ICMP Ping as the Check Condition 
• Specify which Address to Ping (i.e. IP address or DNS name to send ICMP\
 Ping to) and which Interface to send ICMP Ping 
from (e.g. Management LAN or Wireless network)
• Set the Check Frequency (i.e. the time in seconds between checks) and the Number of I\
CMP Ping packets to send 
• Check Save Auto-Response
7.1.7  Cellular Data
This check monitors the aggregate data traffic inbound and outbound th\
rough the cellular modem as an Auto-Response trigger event.
• Click on Cellular Data as the Check Condition
Note: Before configuring cellular data checks in Auto-Response the interna\
l or external USB cellular modem must be 
configured and detected by the console server.  
						

							124
Chapter 7: Alerts, Automated Response and Logging
7.1.8 Custom Check 
This check allows users to run a nominated custom script with nominated \
arguments whose return value is used as an Auto-Response 
trigger event: 
• Click on Custom Check as the Check Condition 
• Create an executable trigger check script file e.g. /etc/config/test\
.sh
#!/bin/sh
logger “A test script”
logger Argument1 = $1
logger Argument2 = $2
logger Argument3 = $3
logger Argument4 = $4
if [ -f /etc/config/customscript.0 ]; then
 rm /etc/config/customscript.0
 exit 7
fi
touch /etc/config/customscript.0
exit 1
• Enter the Script Executable file name (e.g. /etc/config/test.sh)
• Set the Check Frequency (i.e. the time in seconds between re-running the script) and \
the Script Timeout (i.e. the 
maximum run-time for the script) 
• Specify the Successful Return Code. An Auto-Response is triggered if the\
 return code from the script is not this value
• Enter Arguments that are to be passed to the script (e.g. with a web pa\
ge html check script, these Arguments might 
specify the web page address/DNS and user logins)
• Check Save Auto-Response
7.1.9  SMS Command 
An incoming SMS command from a nominated caller can trigger an Auto-Resp\
onse: 
• Click on SMS Command as the Check Condition 
• Specify which Phone Number (in international format) of the phone send\
ing the SMS message 
• Set the Incoming Message Pattern (PCRE regular expression) to match to create trigger event
Note: The SMS command trigger condition can only be set if there is an exter\
nal USB cellular modem detected  
						

							125
Chapter 7: Alerts, Automated Response and Logging
7.1.10 Log In/Out Check 
To configure Web Log In/Out as the trigger event:
• Click on the Web UI Authentication as the Check Condition 
• Check Trigger on Login (Logout) to trigger when a user logs into (or out of) the Web UI 
• Check Trigger on Authentication Error to trigger when a user fails to authenticate to the Web UI 
Note: This check is not resolvable and Resolve actions will not run
7.1.11  Network Interface Event 
You may wish to configure a change in the network status as the trigger\
 event (e.g., to send an alert or restart a VPN tunnel 
connection):
• Click on Network Interface as the Check Condition
• Select the Interface (Ethernet /Failover OOB Interface or Modem or VPN) to monitor 
• Check what type of network interface Event to trigger on (interface Down, Starting, Up or Stopping) 
Note: This check is not resolvable and Resolve actions will not run  
						

							126
Chapter 7: Alerts, Automated Response and Logging
7.1.12 Routed data usage check 
This check monitors the specified input interface for data usage that \
is being routed through the appliance and out another 
interface such as the Internal Cellular Modem.
It is particularly useful in IP Passthrough mode, to detect when the downstream router has failed over an\
d is now routing via 
the appliance’s modem as a backup connection.
This check may be configured with these parameters:
• The appliance’s incoming Interface to monitor
• An optional Source MAC/IP Address, to monitor traffic from a specific host (e.g. the downstream rout\
er)
• A Data Limit threshold, the Auto-Response will trigger when this is hit in the specifi\
ed Time Period
• The Auto-Response will resolve if no matching data is routed for the Resolve Period  
						

							127
Chapter 7: Alerts, Automated Response and Logging
7.2 Trigger and Resolve Actions 
To configure the sequence of actions taken in the event of the trigger \
condition:
• For a nominated Auto-Response - with a defined Check Condition - click \
on Add Trigger Action (e.g. Send Email or Run 
Custom Script) to select the action type to be taken. Then configure \
the selected action (as detailed in the following 
sections)
• Each action is configured with a nominated Action Delay Time which spe\
cifies how long (in seconds) after the Auto-
Response trigger event to wait before performing the action. So you can \
add follow-on actions to create a sequence of 
actions that will be taken in the event of the one trigger condition
• To edit (or delete) an existing action, click the Modify (or Delete) \
icon in the Scheduled Trigger Action table 
 
Note:  A message text can be sent with Email, SMS and Nagios actions. This c\
onfigurable message can include selected values:  
$AR_TRIGGER_VAL = the trigger value for the check e.g. for UPS Status, it could be on\
batt or battlow
$AR_VAL = the value returned by the check e.g. for ups status, it could be on\
line/onbatt/battlow
$AR_CHECK_DEV = the device name of the device being checked e.g. for Ala\
rm, the alarm name 
$TIMESTAMP = the current timestamp
$HOSTNAME = the hostname of the console server 
The default message text is: $TIMESTAMP: This action was run - Check details: value $AR_VAL vs trigger value $AR_TRIGGER_VAL
7.2.1  Send Email on Trigger
• Click on Send Email as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time \
 
• Specify the Recipient Email Address to send this email to and the Subjec\
t of the email. For multiple recipients you can 
enter comma separated addresses 
• Edit the Email Text message to send and click Save New Action
Note: An SMS alert can also be sent via an SMTP (email) gateway. You will need to specify the Recipient Email Address in the 
format specified by the gateway provider (e.g. for T-Mobile it is phonenumber @tmomail.net) 
7.2.2  Send SMS on Trigger
• Click on Send SMS as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time \
 
• Specify the Phone number that the SMS will be sent to in international f\
ormat (without the +)
• Edit the Message Text to send and click Save New Action
Note: The SMS alert can only be sent if there is an internal or external USB\
 cellular modem attached. However an SMS alert 
can also be sent via a SMTP SMS gateway as described above.    
7.2.3 Perform RPC Action on Trigger
• Click on Perform RPC Action as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time \
 
• Select a power Outlet and specify the Action to be performed (power On,\
 OFF or Cycle) 
• Click Save New Action     
						

							128
Chapter 7: Alerts, Automated Response and Logging
7.2.4 Run Custom Script on Trigger
• Click on Run Custom Script as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time \
 
• Create a script file to execute when this action is triggered and ente\
r the Script Executable file name e.g. /etc/config/action.sh 
• Set the Script Timeout (i.e. the maximum run-time for the script). Lea\
ve as 0 for unlimited. 
• Enter any Arguments that are to be passed to the script  and click Save \
New Action    
7.2.5 Send SNMP Trap on Trigger
• Click on Send SNMP Trap as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time \
Note: The SNMP Trap actions are valid for Serial, Environmental, UPS and Cellular data t\
riggers only 
7.2.6  Send Nagios Event on Trigger
• Click on Send Nagios Event as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time \
   
• Edit the Nagios Event Message text to display on the Nagios status scree\
n for the service
• Specify the Nagios Event State (OK, Warning, Critical or Unknown)  to return to Nagios for this service 
• Click Save New Action
Note: To notify the central Nagios server of Alerts, NSCA must be enabled under\
 System: Nagios and Nagios must be enabled 
for each applicable host or port   
7.2.7 Perform Interface Action 
• Click on Perform Interface Action as the Add Trigger Action. Enter a unique Action Name and set the Action Delay 
Time
• Select the Interface (Modem or VPN service) and the Action (Start or Stop Interface) to be taken
Note: If any IPsec service or OpenVPN tunnel is to be controlled by the Networ\
k Interface Event Action, you will need to have 
checked the Control by Auto-Response box when configuring that service (if selected, the default state fo\
r the VPN tunnel / 
service will be Down).  
						

							129
Chapter 7: Alerts, Automated Response and Logging
7.2.8 Resolve Actions 
Actions can also be scheduled to be taken when a trigger condition has b\
een resolved:
• For a nominated Auto-Response - with a defined trigger Check Condition \
- click on Add Resolve Action (e.g. Send Email or 
Run Custom Script) to select the action type to be taken
Note: Resolve Actions are configured exactly the same as Trigger Actions except the designated Resolve Actions are all 
executed on resolution of the trigger condition and there are no Action \
Delay Times set
Configure SMTP, SMS, SNMP and/or Nagios service for alert notifications. The Auto-Re\
sponse facility enables remote alerts to be sent 
as Trigger and Resolve Actions. Before such alert notifications can be sen\
t, you must configure the nominated alert service. 
7.2.9  Send Email alerts on Resolution
The console server uses SMTP (Simple Mail Transfer Protocol) for sending the email alert notifications. To use SMTP, the Administrator 
must configure a valid SMTP server for sending the email: 
• Select Alerts & Logging: SMTP & SMS 
• In the SMTP Server field enter the IP address of the outgoing mail Ser\
ver
• If this mail server uses a Secure Connection, specify its type. You may also specify the IP port to use for SMTP. The default 
SMTP Port is 25. 
• You may enter a Sender email address which will appear as the “from”\
 address in all email notifications sent from this 
console server. Many SMTP servers check the sender’s email address with the host do\
main name to verify the address as 
authentic. So it may be useful to assign an email address for the consol\
e  server such as [email protected] 
• You may also enter a Username and Password if the SMTP server requires authentication
• You can also specify the specific Subject Line that will be sent with t\
he email
• Click Apply to activate SMTP 
7.2.10  Send SMS alerts on Resolution
With any model console server you can use email-to-SMS services to send S\
MS alert notifications to mobile devices.  Almost all 
mobile phone carriers provide an SMS gateway service that forwards email\
 to mobile phones on their networks. There’s also a wide 
selection of SMS gateway aggregators who provide email to SMS forwarding\
 to phones on many carriers. 
Alternately, if your console server has an embedded or externally attached cellular\
 modem you will be given the option to send the 
SMS directly over the carrier connection.   
						

							130
Chapter 7: Alerts, Automated Response and Logging
SMS via Email Gateway
To use SMTP SMS, the Administrator must configure a valid SMTP server f\
or sending the email:
• In the SMTP Settings field in the Alerts & Logging: SMTP & SMS menu se\
lect SMS Gateway. An SMS via Email Gateway 
field will appear
• Enter the IP address of the outgoing mail Server SMS gateway
• Select a Secure Connection (if applicable) and specify the SMTP port t\
o be used (if other than the default port 25)
• You may also enter a Sender email address which will appear as the “fr\
om” address in all email notifications sent from this 
console server. Some SMS gateway service providers only forward email to SMS when the \
email has been received from 
authorized senders. So you may need to assign a specific authorized em\
ail address for the console server
• You may also enter a Username and Password as some SMS gateway service providers use SMTP servers which req\
uire 
authentication
• Similarly you can specify the specific Subject Line that will be sent \
with the email. Generally the email subject will contain a 
truncated version of the alert notification message (which is contain\
ed in full in the body of the email). However some SMS 
gateway service providers require blank subjects or require specific a\
uthentication headers to be included in the subject line
• Click Apply Settings to activate SMS-SMTP connection. 
SMS via Cellular Modem
To use an attached or internal cellular modem for SMS the Administrator m\
ust enable SMS:
• Select Cellular Modem In the SMS Settings field 
• Check Receive Messages to enable incoming SMS messages to be received. A\
 custom script will be called on receipt of 
incoming SMS messages
• You may need to enter the phone number of the carrier’s SMS Message Ce\
ntre (only if advised by your carrier or Support)
• Click Apply Settings to activate SMS-SMTP connection
7.2.11   Send SNMP Trap alerts on Resolution
The Administrator can configure the Simple Network Management Protocol\
 (SNMP) agent that resides on the console server to send 
SNMP trap alerts to an NMS management application:
• Select Alerts & Logging: SNMP
• Select Primary SNMP Manager tab. The Primary and Secondary SNMP Manager \
tabs are used to configure where and 
how outgoing SNMP alerts and notifications are sent. If you require yo\
ur console server to send alerts via SNMP then, at a 
minimum, a Primary SNMP Manager must be configured. Optionally, a second SNMP Network Manager with its own SNMP 
settings can be specified on the Secondary SNMP Manager tab
Note: Console Servers can be configured to provide status information on d\
emand using snmpd. This SNMP agent is 
configured using the SNMP Service Detail on Alerts & Logging: SNMP - a\
s described in Chapter 15.
• Select the Manager Protocol. SNMP is generally a UDP-based protocol, though it infrequently uses TCP instead.
• Enter the host address of the SNMP Network Manager into the Manager Addr\
ess field.
• Enter the TCP/IP port number into the Manager Trap Port field (default =162).
• Select the Version to be used. The console server SNMP agent supports SNMP v1, v2 an\
d v3
• Enter the Community name for SNMP v1 or SNMP v2c. At a minimum, a commun\
ity needs to be set for either SNMP v1 
or v2c traps to work. An SNMP community is the group to which devices an\
d management stations running SNMP belong. 
It helps define where information is sent.  SNMP default communities a\
re private for Write and public for Read.