Sensorsoft Sensorsoft Alert™ The Standalone Network Appliance for Environmental Monitoring User Manual For models SSA7001, SSA7004 and SSA7008 With Image Build Number 13 or Higher Manual P/N 071-0084 Rev 21 January 2, 2015 Copyright © 2004-2015 Sensorsoft Corporation, All rights reserved. Sensorsoft, Remote Watchman and Alert are trademarks of Sensorsoft Corporation.
Warning: This manual should only be used for Sensorsoft Alert running image build 13 or higher. To upgrade your appliance’s image to the latest version, please follow the link below: http://www.sensorsoft.com/ssalert_images.
Table of Contents About This Manual............................................................................................................................7 Glossary of Acronyms ......................................................................................................................8 Overview...........................................................................................................................................9 Software specifications and features.........................
Setting up Alerting Limits for Device Variables.......................................................................32 Setting up Email Alerts ...........................................................................................................33 SMTP Settings ...................................................................................................................... 33 Setting up Email Alerts for Device Variables ........................................................................
Returns ...................................................................................................................................79 Appendix A - Using Dollar Variables in Messages .........................................................................80 Appendix B - Controlling the SR6171J Sensorsoft Relay using Command Lines .........................81 Appendix C - Pager Tutorial ...........................................................................................................
Sensorsoft Alert User Manual About This Manual This document contains information about the initial setup, routine configuration, usage and troubleshooting of Sensorsoft Alert appliance. When other sections of this manual are referenced, Italics are used. The term Sensorsoft device and its acronym SSD refer to devices that use the Sensorsoft Device Protocol. When the phrase “the appliance” is used, it refers to Sensorsoft Alert appliance.
Sensorsoft Alert User Manual Glossary of Acronyms CRC – Cyclic Redundancy Check – an algorithm for finding errors in data packets IANA – Internet Assigned Numbers Authority ISP – Internet Service Provider MIB – Management Information Base – a file that describes the objects contained in an SNMP Agent NFS – Network File System NMS – Network Management Software NTP – Network Time Protocol PSP – Paging Service Provider RWME – Remote Watchman Enterprise software RWMC – Remote Watchman Client software SMS – Sho
Sensorsoft Alert User Manual Overview Sensorsoft Alert is a line of standalone, network-ready appliances that allow you to monitor remote environments through a web browser or an SNMP Network Management Station. The Sensorsoft Alert product line is available in 1, 4 and 8 port models. Serial ports on the Alert product accept the full line of Sensorsoft devices (except SS6420J/E and SS8002) that allow monitoring of temperature, humidity, flooding, power-loss and dry contacts.
Sensorsoft Alert User Manual Software specifications and features SSA7001 Max Number of Sensors or Devices 1 Supported Protocols Operating System Linux 2.2.
Sensorsoft Alert User Manual SSA7004 and SSA7008 Max Number of Sensors or Devices 4 for SSA7004 8 for SSA7008 Supported Protocols Operating System Linux 2.2.
Sensorsoft Alert User Manual Hardware specifications SSA7001 CPU Memory Interfaces Power Operating Temperature Storage Temperature Humidity Dimensions Cover Certification 50 MHz MPC855T (PowerPC Dual-CPU) 32 MB RAM / 4 MB Flash 1 Ethernet 10/100BT on RJ45 1 RS232 Serial Port on DB-9M External Universal AC, 100-240VAC, 50/60 Hz, 5 VDC, 3 W max 50°F to 112°F (10°C to 44°C) -40°F to 185°F (-40°C to 85°C) 5% to 90% non-condensing 2.8 x 3.4 x 1.2 in (7.0 x 8.5 x 3.
Sensorsoft Alert User Manual Safety Instructions Read the following safety guideline to protect yourself and your Sensorsoft Alert Appliance. DANGER! - Do not operate your Sensorsoft Alert appliance with the cover removed. DANGER! - In order to avoid shorting out your Sensorsoft Alert appliance when disconnecting the network cable, first unplug the cable from the equipment and then from the network jack.
Sensorsoft Alert User Manual FCC & DOC Notice FCC Warning Statement This equipment generates, uses, and can radiate radio-frequency energy, and if not installed and used properly, that is, in strict accordance with the manufacturer's instructions, may cause interference to radio communication.
Sensorsoft Alert User Manual Alert Quick Start This section will show you how to bring your Alert appliance up on the network. There are two different methods for accessing the Alert appliance. The easiest method for accessing the Alert appliance is using DHCP. A new Alert appliance, from the factory, has DHCP enabled by default. This method is covered in the section, Accessing the Alert appliance using DHCP.
Sensorsoft Alert User Manual Connecting to the Alert serial port console The Alert console port (DB-9M connector) is an RS232 serial interface that can be used to access the Linux shell of the Alert appliance. It is used for the purpose of configuration or recovery if you lose contact with the Alert appliance. Since this same DB-9M port is also used as the sensor port, you must carefully follow the procedure below to use it as the console port.
Sensorsoft Alert User Manual Models SSA7004 and SSA7008 To connect to your SSA7004 or SSA7008 appliance through its console port, you first need the following items: A computer with a spare serial port. The P/N C4003 adaptor or the P/N C4004 adaptor. Both of these adaptors came with your Alert appliance, and are gray colored. The P/N C4003 adaptor has a DB-9F connector. The P/N C4004 adaptor has DB-25F connector. Choose the one that fits the spare serial port of your computer.
Sensorsoft Alert User Manual a. When prompted with the question “Set to defaults ? (y/n)”, type N and press the Enter key. b. You can now configure the following network settings. Ask your network administrator if you do not have this information. Hostname DHCP enabled / disabled System IP ( DHCP disabled ) Domain Name Primary DNS Server Gateway IP Network Mask ( DHCP disabled ) c.
Sensorsoft Alert User Manual 9M port. If the Sensorsoft device is the J-Type (i.e. ST6105J, ST6154J, SM6204J, SS6610J, SP6400J, SS6402J, SS6201J), then it has an RJ45 connector. In this case, you need to use the P/N C2000 cable (RJ-45 to DB-9F). Connect the RJ45 end to the Sensorsoft device, and the DB9F end to the Alert appliance’s DB9M port. 3. Now proceed to the next step in the Alert Quick Start procedure above (i.e. Login to the Alert web interface ).
Sensorsoft Alert User Manual Alert web interface Accounts and passwords The Sensorsoft Alert web interface uses two accounts for access rights. The first account’s username is admin and while you are logged in with this account, you will have full rights to change all settings. The second account’s username is ruser (read-only user) and while you are logged in with this account, you will only be able to view the “View Monitor List” page along with a limited number of other informational pages.
Sensorsoft Alert User Manual Changing web login passwords: 1. Login to the Alert web interface as admin. 2. Click on the Change Passwords hyperlink located on the left side of the page. This will bring up the Change Web Passwords page: Figure 2: Change Web Passwords page 3. Enter your current admin password in the Authorization text field. 4. Enter the new admin password and/or new ruser password in the appropriate fields. 5. Click the Save Changes button.
Sensorsoft Alert User Manual 6. After your Alert appliance has rebooted, you will be able to login to its web interface with username: admin and password: begin. Please note that the read-only user (ruser) account password has also been reset to begin. Setting date and time 1. Login to the Alert appliance’s web interface as admin. 2. Click on the Set Date/Time hyperlink located on the left side of the View Monitor List page. 3. This will bring up the Date and Time Settings page.
Sensorsoft Alert User Manual Shutting down or rebooting the Alert Appliance IMPORTANT - It is highly recommended that you use the web interface to safely reboot or shutdown the Alert appliance. Failing to do so may cause recently saved changes to be lost. 1. Login to the Alert Appliance through the web interface as admin. 2. Click on the Reboot/Shutdown hyperlink located on the left side of the View Monitor List page. 3.
Sensorsoft Alert User Manual Figure 5: Configuring port settings 4. In the Data Log Interval field, enter the data logging interval in minutes. This defines how often the Alert appliance will record this Sensorsoft device’s readings to log file. 5. In the Device Type dropdown list, select Sensorsoft Device. 6. Click on the Save Changes button for the change to take affect. 7. The readings from the Sensorsoft device should appear in the View Monitor List in a few seconds.
Sensorsoft Alert User Manual The View Monitor List Page To access the View Monitor List page, click on the hyperlink View Monitor List on the left side of the Alert web interface. Figure 6: View Monitor List This page consists of a large table that shows the overall view of all currently monitored devices connected to the Sensorsoft Alert Appliance. It serves as a system overview of all the current readings. Each row in the table displays information about a device variable that is being monitored.
Sensorsoft Alert User Manual Monitor List Auto-Refresh Interval The Monitor List page (see Figure 6) auto-refreshes at a regular interval to continuously display the latest sensor readings. This interval can be configured by following the steps below: 1. Login to the Alert web interface as admin. 2. Click on the Administration hyperlink located on the left side of the View Monitor List. 3.
Sensorsoft Alert User Manual Figure 7: Device Configuration Page 3. Figure 7 above shows the Device Configuration page for a SS6610J Sensorsoft Temperature Humidity Meter. It has a total of 5 variables. You can select which ones you would like to display on the View Monitor List by checking the Display on Monitor List checkbox for that particular variable. In Figure 7, we have selected one humidity variable (HUMIDITY 0.1% RESOLUTION) as well as one temperature variable (TEMPERATURE 0.
Sensorsoft Alert User Manual entries for each variable; the SSA7008 model can store the most recent 200 log entries for each variable. You can also configure Alert to record log files on a remote server using NFS (Network File System). By recording log files on an NFS server, there will be no limit on the number of entries stored in the log files. To learn more about NFS logging, please see the section Logging Data on a NFS Server. In Alert Firmware Image build 12 (Software Version 1.0.
Sensorsoft Alert User Manual Figure 8: Enabling logging of variable readings 5. Click on the Save Changes button. Logging Data Sensorsoft Alert records two types of log files. Data files contain readings collected from Sensorsoft devices. This information is suitable for graphing and viewing in textual format. Status and error logs contain information collect about the status of Sensorsoft Alert and errors encountered. This information is only suitable for viewing in textual format and cannot be graphed.
Sensorsoft Alert User Manual _Port01_Var1.log _Port08_Var4.log Graphing data files The data logged by Sensorsoft Alert can be graphed using the integrated Sensorsoft Graphing Tool (SGT) applet software. There are two methods to graph data files: a) The easiest way to graph a data file is to click on the variable’s reading (hyperlink) in the Monitor List page. This will launch SGT in a separate browser window and offer a series that can be graphed.
Sensorsoft Alert User Manual allow the Alert appliance read/write privileges to this directory The following example shows how to modify the /etc/exports file on a UNIX or Linux NFS server. This example allows the Alert appliance (172.17.2.100) to have read and write privileges (rw) to a directory named (/mnt/alert) on the NFS server: /mnt/alert 172.17.2.
Sensorsoft Alert User Manual Setting up Alerts Your Alert appliance has the ability to alert you when a variable reading is in a warning or critical state. There are two parts to setting up alerts for a particular variable. The first part is to specify at what values is a particular variable in warning or critical state. The second part is to specify what alert actions should be taken when a particular variable is in those states.
Sensorsoft Alert User Manual Figure 8b: Setting alerting limits for a scalar variable If the variable is Boolean, you can be alerted when its value is equal to the Boolean Critical Value. Set the Boolean Critical Value by selecting it from the Boolean Critical State list-box shown below. Figure 8c: Setting Boolean Critical State for a Boolean Variable 4. Click the Save Changes button. You are now ready to setup the individual alerting methods (e.g. Email, SMS Page, SNMP Trap and Command Lines).
Sensorsoft Alert User Manual Figure 10: SMTP Settings on the Administration Page You must enter at least one valid SMTP server address to be used for sending emails. When sending out an Email alert, your Alert appliance will attempt to use the Primary SMTP Server first. If this attempt fails, it would then try the Secondary SMTP Server. The Sender Address will indicate to the recipient(s) who the Email is from.
Sensorsoft Alert User Manual Figure 11: Configuring Email Alerts for a Scalar Variable Notice that for a scalar variable, you can configure email alerts to be sent in the following alert states: Email on Scalar Critical – The email that will be sent when the variable reading is less than the scalar critical low limit or greater than the scalar critical high limit.
Sensorsoft Alert User Manual 6. In each Message field, specify the email message to be sent for the corresponding alert condition. You may want to use dollar variables (e.g. $L, $R) to bind live information such as the current reading into your message. This is described in Appendix A. 7. In each Interval field, specify the email interval for the corresponding breach condition.
Sensorsoft Alert User Manual Figure 12: Paging Settings on the Administration Page 3. Select the port where the modem connected. 4. Select the correct modem type. 5. Make sure this port is NOT being monitored, by clearing the Enable Monitoring checkbox in the Port Settings table located at the top of the page. 6. Click the Save Changes button. Setting up Pager Alerts for Device Variables 1. Go to the Device Configuration page for the monitored device of interest.
Sensorsoft Alert User Manual Figure 14: Configuring pager alerts for a scalar variable Notice that for a scalar variable, you can configure pager alerts to be sent in the following alert states: Page on Scalar Critical – The page that will be sent when the variable reading breaches the scalar critical low limit or the scalar critical high limit. Page on Scalar Warning – The page that will be sent when the variable reading breaches the scalar warning low limit or the scalar warning high limit.
Sensorsoft Alert User Manual Setting up SNMP Trap Alerts SNMP trap alerts are suitable for users who need to manage their Alert appliance through SNMP. To receive SNMP trap alerts, you must have one or more NMS (Network Management Station) with the ability to receive traps. SNMP Trap Destinations To allow your Alert appliance to send SNMP trap alerts, you must set the SNMP trap destination IP addresses and SNMP trap destination commapplianceies.
Sensorsoft Alert User Manual 2. From the Device Configuration page, click on the Setup SNMP Traps for this variable hyperlink for the device variable of interest. This will take you to the Trap Setup page of the variable for which to setup SNMP Trap alerts. 3. If the selected device variable is a scalar variable (e.g.
Sensorsoft Alert User Manual Setting up command line alert to control a Sensorsoft Relay A Sensorsoft Relay can be controlled to turn ON or OFF when a variable reading breaches a user-defined limit. One potential application is to have a relay turn on an air conditioning appliance or audio alarm. A relay can be controlled through the use of command line alert as described below: 1. Connect a SR6171J Sensorsoft Relay to a spare serial port on the back of the Alert appliance using a C2016 cable.
Sensorsoft Alert User Manual Figure 17: Configuring Command Line Alerts for a Scalar Variable In the example shown in Figure 17, above, the Alert appliance will turn ON a relay connected to port 4 when the reading exceeds the Scalar Critical High Limit, and will turn OFF the relay when the reading returns to normal. 4. In order to turn a relay on, you will need to enter the following command in the Command field: scom -Q /bin/SR6171_ON.
Sensorsoft Alert User Manual In the command lines above, ttyS4 is the name used to access serial port 4. The relay can be connected to any serial port on the back of the Alert appliance. As an example, if the relay was connected on serial port 8, use ttyS8 in the command line. 5. For each command line alert that you would like to enable, check the corresponding Enable checkbox. 6. Click on the Save Changes button. 7.
Sensorsoft Alert User Manual Upgrading the firmware on your Alert Appliance Sensorsoft recommends that you keep your Alert appliance’s firmware up-to-date. This way you can take advantage of the latest enhancements and bug fixes. To check for new a firmware release, go to the following URL: http://www.sensorsoft.com/ssalert_images.
Sensorsoft Alert User Manual Root User The root username is used to login to Alert’s Linux shell. The default root password is sensorsoft. It is recommended that you change the root password on the Sensorsoft Alert appliance as soon as possible. The following procedure outlines how to do this. Changing the root password 1. Connect to the Sensorsoft Alert appliance through Secure Shell or through the serial console.
Sensorsoft Alert User Manual The P/N C2013 cable that came with your Alert appliance. This is a blue RJ-45 straightthrough cable. 1. If the Alert appliance is currently running, then shut it down using the web interface (Refer to section Appliance Shutdown and Reboot for how to do this). If you have lost the Alert appliance’s web password then simply skip this step. 2. Power off the Alert appliance using the ON/OFF switch located on the back of the Alert Appliance. 3.
Sensorsoft Alert User Manual Backup files on Alert appliance to a remote host There are several circumstances where you may want to backup files on your Alert appliance to a remote host. We provide example methods below for doing this using scp and tftp. The scp (secure copy) command lines assume you have a Unix or Linux host that has a ssh/sftp server installed and running. The tftp (trivial ftp) command lines assume you have a Windows or Unix/Linux host that has a tftp1 server installed and running.
Sensorsoft Alert User Manual Restore known good script backup file to Alert appliance from a remote host If you are experiencing problems accessing the Alert web interface you may have a corrupt script file. Try starting the alertd process from the command line as follows: # /bin/alertd If you get the error message “unsupported platform” you have a corrupt script file.
Sensorsoft Alert User Manual SNMP Interface Sensorsoft Alert SNMP Agent Specifications SNMP Version supported 1 Commappliancey Names Multiple commapplianceies with read and write permissions Max number of Boolean or Scalar class variables supported per SSD 8 Device Access Method Indexed Variable Access Method Indexed Number of Sensorsoft MIB Objects 73 Starting MIB OID .1.3.6.1.4.1.15848.1.1.
Sensorsoft Alert User Manual Sensorsoft Alert Indexed MIB Usage Readings from device variables are accessed through the ssVarReading MIB object. Although your Alert appliance could be monitoring multiple devices, and each device could contain multiple variables, the Sensorsoft SNMP Agent allows access to one variable on one device at a time. The variable that is currently being accessed is controlled by the variable index stored in ssVarIndex, and the device index stored in ssDeviceIndex.
Sensorsoft Alert User Manual To enable a specific alert action for a particular alert state, the corresponding ssXXXXXXEnable MIB object must be set to 1.
Sensorsoft Alert User Manual To enable a specific alert action for a particular alert state, the corresponding ssXXXXXXEnable MIB object must be set to 1.
Sensorsoft Alert User Manual by setting the ssTrapOnBooleanCriticalEnable to 1. By default, traps will be repeatedly sent at 5 minute intervals as long as the variable is in breach state. You can change this alerting interval by specifying a new value (in minutes) in ssTrapOnBooleanCriticalInterval. 7. Setting up the return to normal traps: Now that you have setup the traps to be sent in the breach conditions, you may also want a trap sent when the variable’s reading returns back to normal.
Sensorsoft Alert User Manual This is done by setting the ssDeviceIndex MIB object to the index of the serial port where the monitored device is connected. For instance, if you would like to send a trap when a temperature is too high, and you have a SS6610J sensor connected to port 2, set ssDeviceIndex to 2. 3. Selecting the variable for which alerts will be setup: This is done by setting the ssVarIndex MIB object to the index of the variable to be alerted on.
Sensorsoft Alert User Manual This is done by setting the ssDeviceIndex MIB object to the index of the serial port where the device is connected. For instance, if you would like to execute a command line when a temperature is too high, and you have a SS6610J sensor connected to port 2, set ssDeviceIndex to 2. 2. Selecting the variable for which alerts will be setup: This is done by setting the ssVarIndex MIB object to the index of the variable to be alerted on.
Sensorsoft Alert User Manual Type The object type describes the variable type of the object. Typical variable types include IPAddress, Integer, and String. Attempting to enter an invalid value (for example, the string “hello” for a variable that requires a number) will usually result in an error message being returned to the NMS. When changing a value, always verify that the change actually occurred, by doing an SNMP Get. Access Specifies the read and write access granted for the object.
Sensorsoft Alert User Manual OID .1.3.6.1.4.1.15848.1.4.0 ssTrapDestination1 DESCRIPTION: The destination IP address for sending traps to the first NMS. TYPE: IP address, of the form xxx.xxx.xxx.xxx ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.5.0 Non-volatile ssTrapDestination2 DESCRIPTION: The destination IP address for sending traps to the second NMS. TYPE: IP address, of the form xxx.xxx.xxx.xxx ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.6.
Sensorsoft Alert User Manual Non-volatile ssDeviceIndex DESCRIPTION: The user-defined index to select a particular device. The device on the first port is 1, the device on the second port is 2 and so on. This index will affect the contents of all objects below. TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.10.0 ssDeviceModel DESCRIPTION: The model number of the currently indexed device. TYPE: String ACCESS: Read Only OID .1.3.6.1.4.1.15848.1.11.
Sensorsoft Alert User Manual ssNumVariables DESCRIPTION: The total number of variables supported by the currently indexed device. TYPE: Integer ACCESS: Read Only OID .1.3.6.1.4.1.15848.1.15.0 ssVarIndex DESCRIPTION: The user-defined index to select a particular variable in the currently indexed device. This index should not be less than 1 or greater than ssNumVariables above. This index will affect the contents of all objects below. TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.16.
Sensorsoft Alert User Manual ACCESS: Read Only OID .1.3.6.1.4.1.15848.1.20.0 ssVarStatus DESCRIPTION: The status of the currently indexed variable. The status can be: Normal, Breach of Boolean Critical Limit, Breach of Critical High Limit, Breach of Critical Low Limit, Breach of Warning Low Limit, Breach of Warning High Limit and Returned to Normal status. TYPE: String ACCESS: Read Only OID .1.3.6.1.4.1.15848.1.21.
Sensorsoft Alert User Manual ACCESS: Read-Write OID .1.3.6.1.4.1.15848.1.25.0 Non-volatile ssScalarWarningLowLimit DESCRIPTION: If the currently indexed variable is of scalar class, then this represents the limit that the scalar data must reach, or fall below, before this variable enters Breach of Warning Low status. TYPE: Integer ACCESS: Read-Write OID .1.3.6.1.4.1.15848.1.26.
Sensorsoft Alert User Manual TYPE: String ACCESS: Read only OID .1.3.6.1.4.1.15848.1.30.0 ssBooleanCriticalState DESCRIPTION: The user-definable state string, if the currently indexed variable is of the Boolean class. (This string must be the value of either ssBooleanOneStateString or ssBooleanZeroStateString, depending on which state you would like to be alerted on). TYPE: String ACCESS: Read only OID .1.3.6.1.4.1.15848.1.31.0 ssTrapOnScalarCriticalEnable DESCRIPTION: A zero value disables this trap.
Sensorsoft Alert User Manual ssTrapOnScalarWarningInterval DESCRIPTION: The time interval in minutes between traps when the agent detects that the currently indexed variable on the currently indexed device enters a Breach of Warning High Limit status or Breach of Warning Low Limit status. TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.35.0 Non-volatile ssTrapOnBooleanCriticalEnable DESCRIPTION: A zero value disables this trap. A value of one enables this trap.
Sensorsoft Alert User Manual Critical Low Limit status. The subject line can also contain the dollar variables: $L, $U, $R, and $T. The dollar variable $L, will be expanded to the currently indexed device’s location. The dollar variable $U, will be expanded to the location of the Alert appliance. The dollar variable $R, will be expanded into the reading of the currently indexed variable on the currently indexed device. The dollar variable $T, will be expanded into the current date and time.
Sensorsoft Alert User Manual Non-volatile ssEmailOnScalarCriticalInterval DESCRIPTION: The time interval in minutes between emails when the currently indexed variable on the currently indexed device enters Breach of Critical High Limit status or Breach of Critical Low Limit status. TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.43.
Sensorsoft Alert User Manual TYPE: String ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.46.0 Non-volatile ssEmailOnScalarWarningEnable DESCRIPTION: A zero value disables this email alert. A value of one enables this email alert. When enabled, this email is sent when the currently indexed variable on the currently indexed device enters Breach of Warning High Limit status or Breach of Warning Low Limit status.
Sensorsoft Alert User Manual will be expanded to the currently indexed device’s location. The dollar variable $U, will be expanded to the location of the Alert appliance. The dollar variable $R, will be expanded into the currently indexed variable on the currently indexed device's current reading. The dollar variable $T, will be expanded into the current date and time.
Sensorsoft Alert User Manual currently indexed device’s location. The dollar variable $U, will be expanded to the location of the Alert appliance. The dollar variable $R, will be expanded into the currently indexed variable on the currently indexed device's current reading. The dollar variable $T, will be expanded into the current date and time. TYPE: String ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.54.
Sensorsoft Alert User Manual ssCommandOnScalarCriticalHigh DESCRIPTION: This is the command-line string that will be executed by the shell when the currently indexed variable on the currently indexed device enters Breach of Critical High Limit status. TYPE: String ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.58.0 Non-volatile ssCommandOnScalarCriticalHighEnable DESCRIPTION: A zero value disables this command line alert. A value of one enables this command line alert.
Sensorsoft Alert User Manual TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.62.0 Non-volatile ssCommandOnScalarWarningHighInterval DESCRIPTION: The time interval in minutes between command line execution when the currently indexed variable enters Breach of Warning High Limit status. TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.63.
Sensorsoft Alert User Manual ssCommandOnScalarCriticalLow DESCRIPTION: This is the command-line string that will be executed by the shell when the currently indexed variable on the currently indexed device enters Breach of Critical Low Limit status. TYPE: String ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.67.0 Non-volatile ssCommandOnScalarCriticalLowEnable DESCRIPTION: A zero value disables this command line alert. A value of one enables this command line alert.
Sensorsoft Alert User Manual ssCommandOnBooleanCriticalEnable DESCRIPTION: A zero value disables this command line alert. A value of one enables this command line alert. When enabled, this command line is executed when the currently indexed variable on the currently indexed device enters Breach of Boolean Critical Limit status. It will be sent periodically using the time interval in minutes specified by ssCommandOnBooleanCriticalInterval. TYPE: Integer ACCESS: Read/Write OID .1.3.6.1.4.1.15848.1.71.
Sensorsoft Alert User Manual Security Considerations IMPORTANT - If you are planning to expose your Alert appliance to the Internet, Sensorsoft recommends that you do so through a separate firewall device that is capable of protecting your network from various hacker attacks, including SYN flooding, Ping of Death, IP Spoofing, etc. These types of attacks may cause Sensorsoft Alert to respond unexpectedly, or cause it to fail.
Sensorsoft Alert User Manual Trouble Shooting General Problems Cannot access the web interface anymore If you cannot access the Alert appliance web interface, but still have IP access using ping and ssh, you likely have a corrupt script (settings) file. Login to the root account using ssh and run the ps command. You should be able to see many (7) alertd processes running.
Sensorsoft Alert User Manual Sensorsoft device readings have erroneous values This can occur if your Sensorsoft device has EEPROM failure or if it experiences large amounts of electromagnetic interference. To check if EEPROM failure is the cause, go to the Device Configuration page of the Sensorsoft device by clicking on the device’s Description hyperlink in the Main List View. On the bottom of the Device Configuration page you will see the event error counter for EEPROM Failures.
Sensorsoft Alert User Manual 2. The monitored device is not properly connected or is damaged. First, make sure the device is properly connected to the port (Refer to the section Connecting Sensorsoft Devices to the Alert Appliance). If you are certain the device is properly connected, and yet the error message still appears, then the device or the serial cable may be physically damaged. EEPROM FAILURE The EEPROM on the device is malfunctioning due to physical damage and needs to be repaired.
Sensorsoft Alert User Manual Paging Problems Please note that the paging feature is not available on the SSA7001 model appliance. If you are using SMS paging, it is important to note that most SMS providers impose a maximum limit on the number of characters that a message may contain, and will truncate the message to fit the maximum length. You should therefore find out from your SMS provider what the maximum message length is.
Sensorsoft Alert User Manual Timeout, modem did not connect The modem dialed but did not connect to another modem at the destination phone number. You should verify the modem phone number with your paging service provider. If you still receive this error message after trying the above, you should contact your paging service provider to report a problem.
Sensorsoft Alert User Manual Getting Help Limited Warranty Sensorsoft Corporation warranties this Sensorsoft product to be free from manufacturing defects for a period of one year. This includes parts and labor. All shipping and brokerage fees are your responsibility when returning a Sensorsoft product for warranty claims.
Sensorsoft Alert User Manual Appendix A - Using Dollar Variables in Messages You will notice that the Email Subject Line, Email message line and Pager Message Line contain dollar variables (e.g $R, $U, $T, $L and $N). When the messages are sent, these dollar variables will be substituted with dynamic data. Below is list of dollar variables that can be used.
Sensorsoft Alert User Manual Appendix B - Controlling the SR6171J Sensorsoft Relay using Command Lines The SR6171J Sensorsoft Relay can be turned on or off using a command line alert. An example command line to turn ON a SR6171J Sensorsoft Relay connected to serial port 4 of the Sensorsoft Alert appliance is: scom –Q /bin/SR6171_ON.
Sensorsoft Alert User Manual Appendix C - Pager Tutorial Sensorsoft Alert supports three methods that can be used to issue alerts to your paging device. The following section will help you determine what method of delivery you can use. What type of paging device do you have? There are four main types of paging devices: 1. 2. 3. 4. Digital cell phones with text messaging service Alphanumeric pagers Numeric pagers Two-way Email Pagers (e.g.
Sensorsoft Alert User Manual SMS Paging Sensorsoft Alert can use the TAP protocol to send SMS messages to your paging device using your computer’s modem. In order to setup SMS paging in your Alert appliance, you will need to call your paging service provider and ask them for: Their modem pool phone number. Your pager ID and any special formatting that is required. The formatting of the pager ID varies from provider to provider.
Sensorsoft Alert User Manual Appendix D - Modem DIP Switch Settings Modem DIP switch settings required for use with Sensorsoft Alert Paging If you have a 3Com or U.S. Robotics modem with DIP switches, please make sure they reflect the required settings shown below.
Sensorsoft Alert User Manual Appendix E – Alert Serial Port Pin-outs The following table specifies the serial port pin-outs for SSA7001, SSA7004 and SSA7008. This information can be used to build your own cables to interface with Alert serial ports.
Sensorsoft Alert User Manual Appendix F – Using XML Output to Move Data to other Applications Accessing the XML page This section describes how to use the XML output capability of Sensorsoft Alert to move live data to other software applications. To view the XML page, login to Alert’s web interface as ruser or admin. From the Monitor List page, click the hyperlink View in XML at the top right corner. This will open a new web browser window containing the XML page.
Sensorsoft Alert User Manual XML data organization This following tree diagram illustrates how data is organized in the XML page: Root Default About itemList Item Item Item variableList Variable Variable Variable Data pertaining to each monitored item is located in a separate Item sub-tree under \Root\Default Group\Items List\. Each Item sub-tree has a variableList sub-tree that contains the item’s variable information.
Sensorsoft Alert User Manual Appendix G – Setting up a Routine Email Notification within the Linux shell The following Linux shell script allows your Alert appliance to email a periodic sensor reading to reassure you that the appliance is working as expected. If the alertd or scomd processes are not running this shell script will also email a critical alert informing you that appropriate action is required.
Sensorsoft Alert User Manual -h mailserver sleep 60 # prevents server bind address not available issue /usr/bin/scomd -F /etc/scomd_port1.ini ttyS1 fi # end of routine notification shell script 3. Run the following command to add execute privilege to the shell script: # chmod +x 4. /home/routine_notify.sh Using vi create a setup file /home/scomsetup2.
