Using Your Appliance BotzWare 2.
Preface Copyright © Copyright NetBotz Inc. 2000 - 2005 Trademarks BotzWare, NetBotz, and the NetBotz symbol are registered trademarks of NetBotz, Inc. Other brand and product names are registered trademarks or trademarks of their respective holders. Federal Communications Commission (FCC) Declaration of Conformity Statement Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC rules.
Preface VCCI Cleaning Use only a dry cloth to clean the appliance. To clean your appliance, gently wipe the surface of the appliance with a dry cloth. Misuse Use your appliance ONLY in the manner specified. If the equipment is used in a manner not specified, the protection provided by the equipment may be impaired. NetBotz is not responsible for misuse.
Contents Preface............................................................................... i What’s New? .................................................................... 1 BotzWare Version 2.5 Features.................................................................................. 1 BotzWare Version 2.41 Features................................................................................ 1 BotzWare Version 2.4 Features..........................................................................
Basic View: Configuring Appliances ........................... 23 Configuring the Appliance ................................................................................... 23 Configuring Camera Pod 120s and Integrated Cameras .................................... 23 Configuring CCTV Adapter Pod 120s.................................................................. 23 Configuring Sensor Pod 120s..............................................................................
Advanced View: Configuring Pods and Alerts........... 59 Alert Actions ............................................................................................................. 59 Pre-configured Alert Actions ............................................................................... 59 Available Alert Notification Methods.................................................................... 60 Creating Alert Actions .....................................................................................
Configuring DNS Settings.................................................................................. 107 Configuring Dynamic DNS Settings................................................................... 108 E-mail Server .......................................................................................................... 108 External Storage .....................................................................................................
Alert State Threshold ........................................................................................ 154 Alert State for Time Threshold .......................................................................... 155 State Mismatch Threshold ................................................................................ 157 State Mismatch For Time Threshold ................................................................. 159 Advanced View: Creating Alert Actions....................
BotzWare Macros......................................................... 187 Appliance Macros ................................................................................................... 187 Location Macros...................................................................................................... 188 Alert Macros............................................................................................................ 189 Overloaded Appliances: Symptoms & Solutions .....
What’s New? Users who are familiar with the core features delivered in BotzWare version 2.0 can use this version history to quickly identify new or improved features, as well as information about features that were introduced in previous BotzWare releases. BotzWare Version 2.5 Features In addition to additional hardware support and performance improvements, BotzWare 2.
What’s New? integrated with or connected to NetBotz 320, 420 or 500s in your network. Once a pod has been shared with the NetBotz 500, it functions as though it were connected directly to the appliance. • NAS Support Added to External Storage Task: NetBotz 500 appliances that have the BotzWare Premium Software Module 2.4 installed can now use a network attached storage device (a Windows share or an NFS mount) for External Storage functionality.
What’s New? BotzWare Version 2.2.2 Features In addition to additional hardware support and performance improvements, BotzWare 2.2.2 introduced the following new features and enhancements: • 4-20mA Sensor Pod Support: Support for the 4-20mA Sensor Pod, which enables you to connect up to four 4-20mA sensors to your NetBotz 420 or NetBotz 500 appliance. For more information see “Configuring 4-20mA Sensor Pods” on page 24 and “Sensor Pods” on page 97.
What’s New? encoded to enable those that can't easily handle “multi-part/form-data” encoded POSTS to get the XML for the alert. • BotzWare OIDs Have Been Enhanced: A 1000x and a 1000000x column have been added a to the OtherNumericSensor table, enabling customers to more easily gather RTT Ping data from devices that have a RTT Ping time of less than 1 second.
What’s New? supported appliances. Designed as a “building block” system, the MultiRAE can be configured from a simple, inexpensive Oxygen/LEL monitor all the way to an affordable five gas monitor for total protection in toxic environments. • Send Custom HTTP GET Alert Action: New alert action that enables you deliver alert notifications as custom HTTP GET commands. The URL generated as a result of the alert action is completely user definable, and can include BotzWare macro values.
What’s New? on all appliances), directly to a USB port, or through a number of supported USB-to-Serial adapter cables. For more information see “Serial Devices” on page 133. • PPP Support: Provides support for point-to-point protocol network connectivity using supported wired or GSM/GPRS modems. For more information see “PPP/Modem” on page 122.
About the Interfaces NetBotz appliances support two interfaces for the purposes of monitoring sensor data, viewing camera images, triggering relay outputs, and appliance configuration: The Basic View and the Advanced View. Brief descriptions of each of these interfaces follow. The Basic View The Basic View enables authorized users to use a supported web browser to view the current sensor data, image capture, and other appliance data in a simple HTML-based interface.
About the Interfaces Advanced View System Requirements To run the Advanced View application, your system must meet these system requirements: • Minimum Configuration: – Either a PC with an IntelTM PentiumTM II 450 processor (or equivalent) running Microsoft Windows (2000 or XP SP1), Red Hat EL 3, Fedora Core 3, or Debian GNU 3 or a Sparc workstation running Solaris 9 with all patch bundles recommended by Sun installed – 128MB RAM – Sun’s Java Runtime Environment v 1.4.
About the Interfaces The SSL certificate that is needed for SSL communications is self-generated by the appliance (“selfsigned”) at first power-up and requires no user-interaction. If the hostname or domain of the appliance is changed the certificate is automatically regenerated, as the certificate includes the fully-qualified DNS name of the appliance. Alternately, you can request and install a signed SSL certificate from a certification authority if desired.
About the Interfaces 10 Using Your Appliance
About the Basic View The Basic View is an HTML-based interface that enables you to view data about all objects that are currently being monitored by your appliance.
About the Basic View Basic View Panes Accessible by Privilege Set The Basic View panes that are accessible, depending on the privilege set of the account that is logged in and using the Basic View, are: Privilege Set Accessible Panes Administrator Cameras, Graphs, Alerts, Setup, and About panes. Application Cameras, Graphs, Alerts, and About panes. Sensor Cameras, Graphs, and About panes. Sensor (No Camera) Graphs and About panes. None Does not permit access to any appliance features.
About the Basic View Crawlers. Alerts that have occurred in the past 24 hours, but which have been resolved, can be shown as well. – Maps: Select this tab to view any Advanced View maps that have been configured for use with this appliance. The Map View, available for use only on appliances for which the BotzWare Premium Software Module 2.4 has been purchased, enables you to view user-created maps that show the location of your NetBotz appliances, pods, and sensors.
About the Basic View Using the Simplified Basic View Due to the limited screen space and resolution available on PDAs, you will note a number of significant differences in the Basic View with accessed with your PDA. The most significant difference is that unlike the standard Basic View, which shows the Navigation, Sensor Data, and Action/Information panes simultaneously, the simplified Basic View shows only a single region of the Basic View interface at any time.
About the Basic View Select Back to return to the Sensor Data view from the Setup view.
About the Basic View 16 Using Your Appliance
Basic View: Monitoring Appliances The Basic View is primarily designed to provide you with a simple-to-use appliance monitoring interface that does not requiring the presence of the Advanced View application and Java Runtime Environment. The monitoring tasks that are available when using the Basic View are viewing sensor readings, viewing camera images, graphing collected sensor data, and viewing currently active and resolved alert conditions.
Basic View: Monitoring Appliances Viewing Camera Images To view images being captured by any integrated camera or Camera Pod 120s or CCTV Adapter Pod 120s connected to the appliance, click on the Cameras tab in the Action/Information pane. Images for all integrated or connected cameras are displayed in the Cameras panel, with one camera image displayed in a larger, timestamped format. To switch the large format view to a different camera image, select the thumbnail image that you wish to view.
Basic View: Monitoring Appliances Alerts that are currently active or that were previously resolved for the item that is selected from the Pods drop box are displayed in a table on the Alerts panel. Alert-specific data for previously resolved alerts is shown in italics. The following information is available for each previously resolved or currently active alert condition: – Time: The time at which the alert occurred.
Basic View: Monitoring Appliances You can use the Basic View to view only previously created maps. To create, edit, or delete a map you must use the Advanced View. Note To view a map using the Basic View, select the Maps tab in the Action/Information pane. The first available map that is stored on the appliance is automatically loaded in to the Action/Information pane. If there is more than one map stored on the appliance you can select additional map views from the Maps drop box.
Basic View: Monitoring Appliances currently selected sensor Set (if applicable) will be listed in the Sensors drop box. 5. Select from the Graph Time drop box the period of time prior to the present for which data from the selected sensor will be graphed. By default, all data available from the past 60 minutes will be graphed. Up to 24 hours of data can be graphed, depending on sensor configuration.
Basic View: Monitoring Appliances 22 Using Your Appliance
Basic View: Configuring Appliances The Basic View is designed primarily for viewing the sensor data, camera images, and alert conditions that are currently being reported by the appliance and the pods or sensors that are connected to the appliance. The vast majority of appliance, pod, and sensor configuration must be performed using the Advanced View interface.
Basic View: Configuring Appliances To specify a label for the Sensor Pod 120, select the Sensor Pod 120 from the Pods drop box in the Setup panel. Then, type in the Pods Label field the label that will be used to uniquely identify the Sensor Pod 120. When you have finished typing in the label value, click Update to save the label value for your Sensor Pod 120.
Basic View: Configuring Appliances Configuring Output Relay Pod 120s Before continuing, be sure that you have correctly connected the Output Relay Pod 120 to your appliance. Note The only configuration tasks that can be performed on a Output Relay Pod 120 using the Basic View are specifying a unique identification label for the Output Relay Pod 120, specifying the output type that will be used for each relay, and providing a unique identification label for each relay.
Basic View: Configuring Appliances Control Pod model (110, 115, 230, or 235) that is connected to that port. 4. Click Update to save your serial device settings. To specify the output type that will be assigned to each outlet on your Power Control Pod and to specify a unique label for each outlet: 1. Click on the Setup button. 2. Select the Power Control Pod you wish to configure from the Pods drop-box.
Basic View: Configuring Appliances To test the device’s power-on behavior, simply plug it directly into a standard power outlet. If the device power on fully without requiring additional interaction it can be used properly with the Power Control Pod.
Basic View: Configuring Appliances 28 Using Your Appliance
About the Advanced View The Advanced View is a stand-alone Java application that enables you to monitor and configure your appliance and any Camera Pod 120s, Sensor Pod 120s, CCTV Adapter Pod 120s, Output Relay Pod 120s, 4-20mA Sensor Pods, external sensors, or supported RS232-based sensors that are connected to the appliance.
About the Advanced View Adding Appliances Before you can use the Advanced View to manage an appliance you must first add the appliance’s IP address or hostname to the Appliance list. To add an appliance to the Appliance list: 1. Click Add Appliance. The Add Appliance window opens. 2. Type in the IP Address or Hostname field the IP address or hostname of the appliance. The Add Appliance window. 3. Type in the Port field the TCP port through which you will communicate with this appliance. 4.
About the Advanced View Advanced View Panes Accessible by Privilege Set The Advanced View panes that are accessible, depending on the privilege set of the account that is logged in and using the Advanced View, are: Privilege Set Accessible Panes Administrator Cameras View, Graphs View, Alerts View, Configuration, and About panes. Application Cameras View, Graphs View, Alerts View, and About panes. Sensor Cameras View, Graphs View, and About panes. Sensor (No Cameras) Graphs View and About panes.
About the Advanced View Using Folders If desired, you can create folders in the Navigation Pane. Folders enable you to create virtual groups of pods and devices that can be used to simplify organization of your various pods and devices for management purposes. By default, the Navigation Pane does not feature any folders. Instead, the Navigation Pane presents a selectable list of all pods and devices that are associated with the appliance.
About the Advanced View If the selected item features a large number of sensors, the sensors may also be divided into sensor sets. Sensor sets enable you to filter the contents of the Sensor Data pane to display only sensors that are associated with a specific interface or portion of the selected device. To display all of the sensors included in the selected device select All Sensors from the Set drop-box.
About the Advanced View Advanced View Menus The Advanced View features the following pull-down menus, located at the top of the interface: • File: Use the selections available from the File pull-down menu to Add appliances to or Remove appliances from the Appliance selection pull-down and to Exit the Advanced View application. • Edit: Use the selections available from the Edit pull-down menu to Cut, Copy, Paste, and Delete text (when possible), and to configure Client Preferences.
About the Advanced View data to the specified NetBotz Central appliance. 4. Specify the NetBotz Central IP Address/Hostname. This is the IP address or hostname of the NetBotz Central appliance to which data will be posted. 5. Specify the Port on which the NetBotz Central appliance is configured to receive HTTP post data. Default value is 80. 6. If desired, select an SSL Option.
About the Advanced View Field Description Toolbar Controls that specify the look and feel of the buttons in the Action/Information pane. You can: • Specify the button content: – If you want the buttons to include text, check the Text check box. – If you want the buttons to include icons, check the Icons check box. – To include both text and icons, check both check boxes • Specify icon size: – If icons are selected, specify whether the icons should be Small or Large.
About the Advanced View Network Preferences To edit your client’s General settings, open the Client Preferences interface and then select General from the Categories selection list. You can configure the following general settings: Field Description Connection Timeout Type in this field the amount of time that the Advanced View should wait when attempting to connect to an appliance before giving up.
About the Advanced View operational difficulties are noted on a monitored target the appliance can generate an alert notification, enabling you to quickly address the problem. Advanced Device Crawlers (a license key-based add-on application, available for purchase separately) extends the capabilities of Basic Device Crawlers to provide far more detailed device-specific information and to enable OIDspecific monitoring and alerting.
About the Advanced View For detailed descriptions of all of the configuration tasks available from the Pod/Sensors Settings portion of the configuration panel, see “Advanced View: Configuring Pods and Alerts” on page 59. The Configuration View.
About the Advanced View Appliance Settings Tasks The tasks available from the Appliance Settings portion of the panel enable you to configure your appliance. The following tasks are available from the Appliance Settings portion of the Configuration panel: • Backup: Use the Backup task to save your appliance configuration to a password-protected, encrypted file.
About the Advanced View appliance and you have used the Serial Devices task to specify the modem that is associated with the appropriate serial port. • Proxy: Use the Proxy task to provide the necessary settings to allow the appliance to utilize an HTTP, Socks V4, or V5 Proxy Server. • Region: Use the Region task to specify the region in which the appliance is being used, to specify the time zone, and to configure the appliance clock to report time using a 12- or 24-hour clock.
About the Advanced View 42 Using Your Appliance
Advanced View: Monitoring Appliances The Advanced View enables you to easily view sensor readings, view camera images, graph collected sensor data, and view currently active and resolved alert conditions. If you have purchased NetBotz Extended Warranty Coverage and have added the BotzWare Premium Software Module 2.4 license key to your appliance you can also create, view, and delete maps for use in the Map view.
Advanced View: Monitoring Appliances The Camera View. You can also use the Camera View panel controls to specify the mode and dimensions of the large format camera view, as well as the frequency with which the image is updated. • To specify the dimensions of the image, select from the Mode drop box the desired mode (640x480 VGA is selected by default; other available modes are 160x120, 320x240, 800x600, 1024x768, and 1280x1024).
Advanced View: Monitoring Appliances • CCTV Adapter Pod 120s support only 160x120, 320x240, and 640x480. Resolutions higher than 640x480 are available only from Camera Pod 120s. Note • Actual frame rate available from image processor depends on the resolution and image quality of generated images. Maximum framerate of 30 frames per second is available only at Normal Quality or lower and only at resolutions up to 640x480.
Advanced View: Monitoring Appliances From this window you can configure the following camera image recording settings: Field 46 Description Directory The directory in which recorded camera images will be stored. You can click Browse to select a specific target directory. You can also use selected BotzWare macros to determine the storage location. To select a macro, right-click inside the Directory field, click Macros, and then select the macro that you want to insert in the Directory field.
Advanced View: Monitoring Appliances Field Total size (KB) Description The maximum amount of disk space, in KBs, that will be used to store recorded camera images on the system. By default, the Unlimited check box is checked, permitting an unlimited amount of disk space to be used to store images.
Advanced View: Monitoring Appliances available on the appliance is configured using the Advanced View. The Alerts View. Alerts that are currently active or that were previously resolved for the sensor that is selected from the Pods drop box are displayed in a table on the Alerts panel. Alert-specific data for previously resolved alerts is shown in italics. The following information is available for each previously resolved or currently active alert condition: • Time: The time at which the alert occurred.
Advanced View: Monitoring Appliances In addition to the previously mentioned details, alert-specific data — including graphs of the sensor values and camera images if appropriate — is preserved on the appliance to aid in evaluating the cause and resolution of alert conditions as long as space is available on the appliance. If additional alert-specific data (such as graphs or captured images) is available they will appear on the Alert Details view as entries in additional tabs.
Advanced View: Monitoring Appliances Viewing Maps The Map View, available for use only on appliances for which the BotzWare Premium Software Module 2.4 has been purchased, enables you to create, edit, and delete user-created maps that show the location of your NetBotz appliances, pods, and sensors.
Advanced View: Monitoring Appliances To view sensor readings for any device displayed in the Map view, simply select the device from the Map view. The Sensor Data pane is automatically updated to display the current reading being reported by any sensors that are associated with the selected item, as well as the current alert status for each sensor. If the selected item features a large number of sensors, the sensors may be divided into sensor sets.
Advanced View: Monitoring Appliances the external sensor that you wish to view is connected. – Camera Pod 120s and CCTV Adapter Pod 120s include camera motion, door switch, speaker plug, and microphone plug sensors. – Sensor Pod 120s include temperature, humidity, dew point, air flow, and audio sensors, as well as up to 4 additional external sensors.
Advanced View: Monitoring Appliances be updated. By default, all data available from the past 60 minutes will be graphed (default Start Time value is 60 minutes, default End Time value is Present). Start Time selections are determined by the History setting for the selected sensor. The History setting specifies how much data is stored on the appliance for a given sensor, and is configured using the Sensor Configuration portion of the camera Pod or Sensor Po configuration task.
Advanced View: Monitoring Appliances 54 Using Your Appliance
Advanced View: Configuring the Appliance The Configuration panel is divided into two areas: Pod/Sensors Settings, and Appliance Settings. Each area features a number of icons that represent the configuration tasks that you can perform. To perform a specific configuration task you simply double-click on the appropriate icon.
Advanced View: Configuring the Appliance available only if one or more Output Relay Pod 120s or Power Control Pods are connected to your appliance. • Sensor Pods: Use the Sensor Pods task to configure any Sensor Pod 120s that are connected to your appliance or Sensor Pods that are integrated with your appliance (NetBotz 320 and 420 models only).
Advanced View: Configuring the Appliance Appliance Settings Tasks The tasks available from the Appliance Settings portion of the panel enable you to configure your appliance. The following tasks are available from the Appliance Settings portion of the Configuration panel: • Backup: Use the Backup task to save your appliance configuration to a password-protected, encrypted file.
Advanced View: Configuring the Appliance connected pods on a NetBotz 320, 420, or 500. Pod Sharing enables you to use a single NetBotz 500 as a facility “host” to manage alerts from many other NetBotz appliances distributed throughout your network. • Restore: Use the Restore task to restore your NetBotz 500 configuration using a configuration file created using the Backup task.
Advanced View: Configuring Pods and Alerts The tasks available from the Pod/Sensors Settings portion of the Configuration panel enable you to configure the pods and sensors that are connected to your appliance and to configure the alert actions and policies that will be used when alerts are reported by your sensors. Detailed information about the tasks available from the Pod and Alert Settings portion of the Configuration panel follows.
Advanced View: Configuring Pods and Alerts Note To use the pre-configured Alert Actions you will need to provide additional information, typically by editing the Alert Action to provide recipient information.
Advanced View: Configuring Pods and Alerts in which data files will be stored and the base filename that will be used for FTP data files. For more information on macros supported by BotzWare see “BotzWare Macros” on page 187. • Send E-mail: Sends an alert notification e-mail that contains information about the nature of the alert to one or more e-mail recipients.
Advanced View: Configuring Pods and Alerts Once you have saved your Alert Action it will appear in the list of defined Alert Actions, and will be available for use in your Alert Profile. Alert Profile Use the Alert Profile Task to customize your appliance’s Default alert notification policy, or to create additional alert notification policies to simplify alert management. Alert policies define the notification actions that are taken by the appliance in response to alert conditions.
Advanced View: Configuring Pods and Alerts The Default Alert Profile Your appliance comes pre-configured with a Default Alert Profile. This Default policy features the following 4 pre-configured Alert Sequences, all of which are scheduled to be active 24 hours a day, 7 days a week: • Alert Level 1: Begins immediately after an alert condition occurs (Start Value of 0), repeats 2 times at a 5 minute interval.
Advanced View: Configuring Pods and Alerts Creating an Alert Sequence To create a new Alert Sequence (or modify a previously created Alert Sequence): 1. Double-click on the Alert Profile icon. 2. Select the Alert Profile to which you would like to add a new Alert Sequence and then click Edit. 3. Click Add.... If you are modifying a previously created Alert Sequence, select from the Sequence table the desired Alert Sequence and then click Edit.... 4. Type in the Label field a name for the Alert Sequence. 5.
Advanced View: Configuring Pods and Alerts Maximum Camera Pictures and Include a Graph with the Alert settings for the individual alert actions are not set to capture this data. While this data will not be included with the alert notifications associated with your alert actions, the images and graphs associated with the alerts will be available for use via the Alerts View.
Advanced View: Configuring Pods and Alerts Camera Pods Use the Camera Pods task to configure any integrated cameras and Camera Pod 120s or CCTV Adapter Pods 120s that are connected to your appliance.
Advanced View: Configuring Pods and Alerts Settings After you have selected a camera from the Camera Pods window and clicked Settings, the Camera Pods Settings window opens. From this window you can configure the following camera settings: Field Description Pod Label The label that will be used to uniquely identify the pod.
Advanced View: Configuring Pods and Alerts Field Description Interactive Mode Limit Specifies the maximum image resolution that will be made available to users that are using the appliance interactively (such as viewing images from the Cameras View in the Advanced View). This can be used to limit the performance impact that can be caused by multiple clients with high image resolution settings accessing your appliances interactively.
Advanced View: Configuring Pods and Alerts Capture Settings After you have selected a camera from the Camera Pods window and clicked Capture, the Camera Capture Settings window opens. Use the Camera Capture Settings window to configure various camera and image capture settings. From this window you can configure the following camera and image capture settings: Field Description Brightness Specifies the brightness of the image captured by the camera.
Advanced View: Configuring Pods and Alerts Field 70 Description Color Balance / Type of Lighting / Red Balance / Blue Balance Use this control to specify the color balance settings that will be used by the camera. The four pre-configured Color Balance selections are: • Fluorescent: Best color balance settings for locations with fluorescent lighting. • Incandescent: Best color balance settings for locations with incandescent lighting.
Advanced View: Configuring Pods and Alerts Field Description Post-Alert Capture Time Specifies the total number of seconds after the alert triggering event for which images will be included in alert notifications. The number of post-alert images that are captured is equal to the Post-Alert Capture Time multiplied by the Rate value. Note that the individual Alert Actions may specify a Maximum Camera Pictures setting that is less than the total number of images captured in response to an alert.
Advanced View: Configuring Pods and Alerts The Camera Capture Settings window. Type the new values in the appropriate fields. To see an example of an image capture using the currently selected Brightness, Color Balance and Image Quality settings click Apply and the sample image in the Capture window will be updated using the new values. When you are finished, click OK and any changes you have made will be saved to the appliance.
Advanced View: Configuring Pods and Alerts Camera-based motion sensing is accomplished by comparing concurrent image captures, determining if there are any differences between the images, and then determining whether any detected changes are significant enough to indicate motion and generate an alert. An alert is generated only if observed changes meet the criteria specified by both the Sensitivity and Area of Motion settings. The Mask Settings window.
Advanced View: Configuring Pods and Alerts The Motion Mask Tab The following controls are available on the Motion Mask tab: Field Description Sensitivity The Sensitivity setting specifies how much change in a portion of the image capture will be tolerated before the changed image data is considered movement. Lower values indicate less tolerance for change between images and therefore higher sensitivity.
Advanced View: Configuring Pods and Alerts To mask a portion of the image, click and drag in the image to draw a box around the region you want to ignore. Then right-click and select Mask Selection to mask the selected region. A blue block will appear in the region of the image to be blocked. To unmask a portion of a previously masked region, click and drag in the image to draw a box around the region you want to unmask. Then, click Unmask Selection to remove the mask from the selected region.
Advanced View: Configuring Pods and Alerts Sensor Settings After you have selected a camera from the Camera Pods window and clicked Sensors, the Sensor Configuration window opens. Use the Sensor Configuration window specify a unique identification label for a sensor, to specify the total amount of data from the selected sensor that will be preserved on the appliance, and create or modify thresholds for each sensor which, if violated, will result in an alert condition being reported to the appliance.
Advanced View: Configuring Pods and Alerts Click OK to save your new threshold settings. Click Cancel to close the Edit Threshold window without saving any changes. Note The controls that are available in the Edit Threshold window are determined by the type of threshold that you are creating or editing. For detailed instructions on how to create or edit thresholds, see “Advanced View: Defining Thresholds” on page 141.
Advanced View: Configuring Pods and Alerts In addition, Device Crawlers will also gather and present the following information about the network interfaces of all configured SNMP targets in individual sensor sets: • Admin Status: State sensor that reports the admin status of the interface. • IF Description: Displays the interface’s description value (does not support configuration of thresholds). • IF MAC Address: Displays the interface’s MAC address (does not support configuration of thresholds).
Advanced View: Configuring Pods and Alerts Adding, Editing, and Removing SNMP Targets To add an SNMP target to the list of devices monitored by Device Crawlers (or to edit a previously created SNMP target entry): 1. Start the Device Crawlers task. The SNMP Target view is displayed. If you have installed the Advanced Device Crawlers license key-based upgrade, additional views (Device Definition Files, Supplemental OIDs) will be available as well.
Advanced View: Configuring Pods and Alerts Item Description Delete SNMP Sensors if When checked, automatically removes previously defined Not Found on Crawled SNMP-based sensors on a target when, after a successful scan, the Device sensors are found to no longer be present (no longer defined, unavailable, and so forth). If the sensors are not deleted, they will be displayed with sensor reading values of “N/A” or “null.
Advanced View: Configuring Pods and Alerts Item Update Device Descriptions button Description Device Crawlers uses a device descriptions data file to identify the System Model, Type, and Vendor value for SNMP targets. NetBotz periodically updates the contents of the device descriptions file to include new or previously unidentified target types as they become available.
Advanced View: Configuring Pods and Alerts To configure a threshold, select the sensor for which you will create a threshold from the Sensors selection list. Any previously configured thresholds for the selected sensor appear in the Thresholds selection list. If the selected sensor does not support configuration of thresholds a message advising you of this appears in the Thresholds area of the interface.
Advanced View: Configuring Pods and Alerts As you add IPMI-enabled devices, each device appears in the Navigation pane of both the Basic and the Advanced View. Once added, you can set thresholds, monitor alerts, and graph data reported by the IPMIenabled devices device's IPMI interface (such as system temperatures, voltages, fans, power supplies, bus errors, system physical security, and so forth), just as with pods and other sensors.
Advanced View: Configuring Pods and Alerts Item Scan Interval Description Specify how frequently the appliance should query IPMI device for data. Note: You can force the appliance to do a scan at any time by click Scan Now in the IPMI Device Configuration window. the appropriate values in the fields, and then click OK to save the settings for this IPMI-enabled device.
Advanced View: Configuring Pods and Alerts To configure a threshold, select the sensor for which you will create a threshold from the Sensors selection list. Any previously configured thresholds for the selected sensor appear in the Thresholds selection list. If the selected sensor does not support configuration of thresholds a message advising you of this appears in the Thresholds area of the interface.
Advanced View: Configuring Pods and Alerts Output Control Use the Output Control task to configure any output control devices (such as Output Relay Pod 120s and Power Control Pods) that are connected to your appliance. You can use the Output Control task to perform the following configuration tasks: • Specify the label used to uniquely identify each output control device connected to your appliance.
Advanced View: Configuring Pods and Alerts Output Control Label Settings After you have selected a device from the Output Control Configuration window and clicked Label, the Output Control Settings window opens. From this window you can specify the label that will be used to uniquely identify the output control device. Type in the Label field the label that will be used for this device, and then click OK to save this label to the appliance. Click Cancel to close this window without saving any changes.
Advanced View: Configuring Pods and Alerts Defining Custom Output Action Types If the predefined output action types do not meet your needs, you can create custom output action types. Once defined and saved, the new output action type will be available for selection from the Relay Output Installed selection list when specifying output control external port settings (see “Output Control External Port Settings” on page 87). Note Once a custom output action type is added, it cannot be edited.
Advanced View: Configuring Pods and Alerts Field Button Contact Type Description Specifies whether the relay is in an “on” state when pressed or in an “off” state when pressed. a. Type in or select the appropriate values for the Button Relay action. b. When you have finished, click OK to add this output action to the list of available output actions. • Switch Relays Switch Relay actions cause the state of the relay device to switch from its current state (“On” or “Off”) to its alternate state.
Advanced View: Configuring Pods and Alerts Field Switch Initial State Description The state (“On” or “Off”) in which the relay is assumed to be at the time the output action is assigned. Note: This is also the state to which the switch will be set when the appliance is powered up, regardless of what state the switch was in when the appliance was powered down.
Advanced View: Configuring Pods and Alerts account to the Authorized Accounts selection list. To remove a previously authorized account, select the user account name from the Authorized Accounts selection list, and then click <- (left arrow) to move the selected account to the Available Users selection list. 7. Specify an Automation Schedule. If you want to automatically trigger the output action assigned to this relay on a user-specified schedule, select the Automation Schedule tab.
Advanced View: Configuring Pods and Alerts Periodic Reports Use the Periodic Reports task to configure your appliance to generate sensor reading reports and deliver them to e-mail recipients, HTTP servers, or FTP servers on a user-specified schedule. These reports contains the current readings for all sensors that are connected to your appliance. To start this task, double-click on the Periodic Reports icon to open the Periodic Reports Configuration window.
Advanced View: Configuring Pods and Alerts Edit. 2. The Edit Periodic E-mail Report window opens. This window contains the following fields: Field Description Enabled Check this check box to enable periodic e-mail reporting. Include camera pictures Check this check box to include current image captures by Camera Pod 120s connected to the appliance in the e-mailed report. Include Maps Check this check box to include any maps that are stored on the appliance in the e-mailed report.
Advanced View: Configuring Pods and Alerts c. When you have finished creating your Advanced Schedule, click OK to save the schedule and return to the Periodic Report task. 5. When you are finished, click OK to save any changes to the appliance. Click Cancel to close this window without saving any changes. Configuring Periodic FTP Reports To configure your appliance to periodically generate and deliver sensor reports to a specified FTP server: 1.
Advanced View: Configuring Pods and Alerts Field Description Target Directory The relative directory path to be used for storing the data on the FTP server. This should always be a path relative to the default directory associated with the user ID used to log on to the FTP server. If the directories on the path do not exist they will be created automatically. The Target Directory field accepts BotzWare macros. For more information on macros supported by BotzWare see “BotzWare Macros” on page 187.
Advanced View: Configuring Pods and Alerts Field Description Include camera pictures Check this check box to include current image captures by Camera Pod 120s connected to the appliance in the HTTP post. Interval The frequency with which HTTP reports will be generated. Sensor Priority Acts as a filter that can be used to limit the amount of sensor data that is included with the periodic report.
Advanced View: Configuring Pods and Alerts c. When you have finished creating your Advanced Schedule, click OK to save the schedule and return to the Periodic Report task. 5. When you are finished, click OK to save any changes to the appliance. Click Cancel to close this window without saving any changes.
Advanced View: Configuring Pods and Alerts Sensors After you have selected a device from the Sensor Pods window and clicked Sensors, the Sensor Configuration window opens. Use the Sensor Configuration window specify a unique identification label for a sensor, to specify the total amount of data from the selected sensor that will be preserved on the appliance, and to create or modify thresholds for each sensor which, if violated, will result in an alert condition being reported to the appliance.
Advanced View: Configuring Pods and Alerts To configure a threshold, select the sensor for which you will create a threshold from the Sensors selection list. Any previously configured thresholds for the selected sensor appear in the Thresholds selection list. All sensors have a default, pre-configured threshold that will be generated automatically by the Advanced View. This predefined threshold provides the most typical threshold that would be used for the specific sensor type.
Advanced View: Configuring Pods and Alerts Defining Custom Dry Contact or Analog Sensors For Advanced Users Only! This is an advanced appliance feature. It is intended for use only by technically experienced users, such as network administrators or network systems management coordinators. To configure a custom dry contact or analog sensor you must have extensive knowledge of the sensor hardware for which you are creating a definition and of how sensors work in general.
Advanced View: Configuring Pods and Alerts This window features the following fields and controls: Field Description Sensor Type Label The label represents the name of the custom sensor definition. For example, if you are creating a custom sensor definition for use with temperature sensor Model 42 from MyCo, Inc., you might want to use “MyCo Model 42 Temperature Sensor” as the Sensor Type Label.
Advanced View: Configuring Pods and Alerts a. After you select Dry Contact and click OK, the Add Dry Contact Sensor window opens. The Add Dry Contact window. This window features the following fields and controls: Field 102 Description Sensor Type Label The label represents the name of the custom sensor definition. For example, if you are creating a custom sensor definition for use with a normally closed (NC) motion temperature sensor Model 42 from MyCo, Inc.
Advanced View: Configuring Pods and Alerts Field Description Close-Open Switch Time (ms) The amount of time that must pass (in milliseconds) when the dry contact sensor goes from Closed state to Open state before the state change is reported. Dry Contact Type Specifies whether the dry contact sensor is a normally open (NO) or normally closed (NC) dry contact sensor. b. Type in the appropriate values for the dry contact sensor hardware. c.
Advanced View: Configuring Pods and Alerts Wireless Sensor Discovery Use the Wireless Sensor Discovery task to specify the discovery settings that will be used when detecting the presence of THS-100 Wireless Temperature/Humidity Sensors. Note Wireless sensors can be used only in conjunction with a Wireless Receiver 120.
Advanced View: Configuring Appliances The tasks available from the Appliance Settings portion of the Configuration panel enable you to configure your appliance. Detailed information about the tasks available from the Appliance Settings portion of the Configuration panel follows. Backup Use the Backup task to save your appliance configuration to a password-protected, encrypted file.
Advanced View: Configuring Appliances Clock Use the Clock task to view or change the date and time that are configured on the appliance internal clock, or to configure your appliance to obtain and synchronize its clock settings from an NTP server. To start this task, double-click on the Clock icon to open the Clock Settings window. The following controls are available from the Clock task: Field Description Enable NTP check box Check this check box to enable the NTP functionality.
Advanced View: Configuring Appliances Custom Audio Clips Use the Custom Audio Clips task to upload custom audio clips (in WAV or OGG format) to your NetBotz 500 appliance, or to delete previously uploaded clips from the NetBotz 500 appliance. Once uploaded, audio clips can be used with the Play Custom Audio alert action. For more information about the Play Custom Audio alert action see “Creating a Play Custom Audio Alert Action” on page 163. This task is available for use only with NetBotz 500 appliances.
Advanced View: Configuring Appliances To change the NetBotz appliance DNS settings, type the new values in the appropriate fields. When you are finished, click OK to save any changes to the appliance. Click Cancel to close this window without saving any changes. Configuring Dynamic DNS Settings The Dynamic DNS service, hosted by DynamicDNS.
Advanced View: Configuring Appliances Field Description Requires Logon check box Check this check box if the server requires you to log in to send e-mail. User ID Provide a User ID that will be accepted by the SMTP server when sending e-mail. Password Provide a Password that will be accepted by the SMTP server when sending e-mail. Confirm Type the password again to confirm.
Advanced View: Configuring Appliances External Storage Use the External Storage task to configure your appliance to store data on the optional Extended Storage System (sold separately, for use only with NetBotz 500 appliances) or a network attached storage device (a Windows share or an NFS mount). A maximum of 5000 objects (such as alerts and picture clips) can be stored using External Storage. Sensor readings do not count against the maximum number of sobject stored.
Advanced View: Configuring Appliances you purchased the Extended Storage System and the USB drive has been connected to the appliance. • Windows Share: Configures the appliance to use a Windows file system share on a NAS as extended storage. • NFS Mount: Configures the appliance to use an NFS Mount on a NAS as extended storage. Refer to the subsections below for specific instructions on adding each type of extended storage to your appliance.
Advanced View: Configuring Appliances To configure your appliance you use network attached storage for extended storage purposes: 1. Select Windows Share from the Select Storage Type pane and then click Next. 2. The Windows Share Settings pane appears. This pane features the following fields and controls: Field Description Remote Hostname/IP The hostname or IP address of the NAS. Remote Share Name The name of the Windows share on the NAS.
Advanced View: Configuring Appliances To configure your appliance you use network attached storage for extended storage purposes: 1. Select NFS Mount from the Select Storage Type pane and then click Next. 2. The NFS Settings pane appears. This pane features the following fields and controls: Field Description Remote Hostname/IP The hostname or IP address of the NAS. Remote Mount The name of the NFS mount on the NAS.
Advanced View: Configuring Appliances To specify IP Filter criteria, click Add and then specify an IP that will be permitted access. You can also use wildcards to specify a range of addresses. For example, providing an address of 192.168.1.* would permit connections only from clients with an IP address of 192.168.1.0 through 192.168.1.255. After you have typed in the IP address, click OK to add the address value to the list of IP Filter criteria.
Advanced View: Configuring Appliances Location Use the Location task to configure additional sensor-specific location information that will also be included in alert notifications generated by the appliance. Location values can be assigned to the appliance and to all pods and external sensors connected to the appliance.
Advanced View: Configuring Appliances To change the Location settings, select the appliance, pod, or sensor for which you wish to specify Location values from the Pods/Sensors selection tree. Then, select the desired Location Data Type and click Edit to open the Edit Location Attribute window. Type in the new Location value and click OK to the Edit Location Attribute window. When you have finished specifying Location values, click OK save any changes to the appliance.
Advanced View: Configuring Appliances The log level values are: • 1 - Emergency • 2 - Alert • 3 - Critical • 4 - Error • 5 - Warning • 6 - Notice • 7 - Information • 8 - Trace Note NetBotz strongly recommends a minimum Log Level of 6 - Notice. This will ensure that log messages that are associated with alerts are recorded in the Audit Trail. You can also configure the appliance to post log data to a remote syslog server.
Advanced View: Configuring Appliances Network Interfaces Use the Network Interface task to view or change the NetBotz appliance network settings for you appliance’s network interfaces. By default there is a single network interface: the Ethernet Interface for the appliance’s built-in Ethernet connection. If you have not installed additional network interfaces to your appliance and you start this task the Edit Network Interface window will open.
Advanced View: Configuring Appliances Field Description IP The IP address assigned to the selected network interface. This field is available only if you have selected the Configure using these settings radio button. Subnet Mask The subnet mask for the network that will be used by the selected network interface. This field is available only if you have selected the Configure using these settings radio button.
Advanced View: Configuring Appliances Wireless Network Interface If you are editing a wireless network interface configuration, the following controls and fields appear in the Network and Wireless tabs of the Edit Network Interface window: Field 120 Description Enable Interface Check this check box to enable this network interface.
Advanced View: Configuring Appliances Field Description Mode Determines the wireless communication method to use within your wireless network. If your wireless network uses Wireless Access Points (WAPs), select Managed. If your wireless network does not use WAPs, select Ad-Hoc. If you are unsure of whether wireless access points are in use in your network, select Automatic and the adapter will attempt to determine if WAPs are present and self-determine its mode.
Advanced View: Configuring Appliances PPP/Modem Use the PPP/Modem task to configure your appliance to establish a Point-to-Point Protocol (PPP) connection with your TCP/IP network using a supported USB or PC Card modem and a standard analog telephone connection. For a list of supported modems, see the About Your Appliance booklet included with your appliance.
Advanced View: Configuring Appliances Field Description Country (if supported by modem) Some modems support country-specific communications parameters to ensure that the modem adheres to communications standards and requirements in use in the country. If your modem supports these strings the Country drop-box will be available. Select from the Country drop box the country in which the appliance will be dialing out.
Advanced View: Configuring Appliances The following controls appear in the Advanced pane: Field Description LCP - Send LCP echo requests to peer When this check box is checked, your appliance will send LCP echo requests, allowing PPP to know that the PPP link is active even when there is no network traffic. Exclusive route - Route all data through PPP when dialed-out If this check box is checked, all data will be routed via the PPP interface during PPP dial out sessions.
Advanced View: Configuring Appliances Field Description DHCP Shows whether DHCP is in use for this connection. Connect Speed Shows the speed of the current PPP connection. Dial-Out Due to Schedule (Yes or No) If Yes, indicates that the current PPP connection was initiated as a result of a user-specified dial-out schedule. Dial-Out Due To Alert/Report (Yes If Yes, indicates that the current PPP connection was or No) initiates as a result of an alert or report being generated by the appliance.
Advanced View: Configuring Appliances When monitoring or managing an appliance that is connected to your network using only a PPP/Modem connection, some functions may be unavailable and some performance limitations will be apparent. These limitations can become far worse if the PPP connection is slow (lower than 25000 V42bis) or the appliance is configured in a manner that causes it to send a lot of images, audio, or other data.
Advanced View: Configuring Appliances Using SIM Security If you will be using the Advanced SIM PIN features, be sure to enter the PIN correctly. If your SIM requires a PIN and you enter the PIN incorrectly the appliance attempts to use the wrong PIN repeatedly, which could cause the SIM to become “blocked.” If your SIM is blocked, you will require a Pin Unblocking Key (PUK) from your service provider.
Advanced View: Configuring Appliances Proxy Use the Proxy task to provide the necessary settings to allow the appliance to utilize an HTTP, Socks V4, or V5 Proxy Server. When configured, the appliance will use the proxy server for all e-mail and HTTP Post communications, allowing these communications to cross the firewall. These settings do not apply to communications to the appliance: only communications from the appliance. The Proxy task.
Advanced View: Configuring Appliances Region Use the Region task to specify the region in which the appliance is being used and to configure the appliance clock to report time using a 12- or 24-hour clock. Note Region settings affect only the date and time stamp displayed in the image captures and the format of sensor readings and dates or times specified in alert notifications generated by the appliance itself.
Advanced View: Configuring Appliances Pod Sharing Use the Pod Sharing task to configure your NetBotz 500 series appliance to host “virtual pods.” Pod Sharing, available for use only on NetBotz 500 appliances for which the BotzWare Premium Software Module 2.4 has been purchased, enables your NetBotz 500 to connect with and receive data directly from devices integrated with or connected to NetBotz 320, 420 or 500s in your network.
Advanced View: Configuring Appliances Some settings (such as camera capture settings) can be set directly from the NetBotz 500 using these tasks. However, other settings (such as motion masking, block-out, and adding external sensors) require the Advanced View to communicate directly with the appliance to which the pod is physically connected.
Advanced View: Configuring Appliances contains the following fields: Field Description Host/IP Address The hostname or IP address of the remote appliance that the device to be hosted is either integrated with or connected to. Port TCP port over which pod sharing communications will occur. Default is 80 for HTTP, and 443 for HTTPS. SSL Options Select from this drop-box the SSL options that will be used for pod sharing communications.
Advanced View: Configuring Appliances To use the Restore task: 1. Start the task by double-clicking on the Restore icon. 2. Type in the Backup Filename field the name and fully qualified path to the backup file or click Browse and then use the file navigation window to navigate to the drive and directory in which the backup file is stored, then select the file and click OK to return to the Backup task window. 3. Type in the Password field the password that you used to protect the backup file.
Advanced View: Configuring Appliances The SMS Configuration task consists of Basic, Advanced, and Status panes. The following controls and data appear in the Basic pane: Field Description SIM PIN / Confirm SIM PIN For modems that use a SIM (subscriber identification module), specify the PIN that is used to unlock the SIM. Note: A SIM may or may not require a PIN in order to function. For modems that do not have a SIM this field must be blank.
Advanced View: Configuring Appliances Field Description Use protocol descriptor unit (PDU) Specifies whether the appliance should use Protocol Descriptor Unit (PDU) mode or “mode” when communicating with the modem to send the SMS message. PDU mode is preferred because it is more versatile than text mode. Some modems do not support both modes. Character set Specifies the character set used when communicating with the modem to send the SMS message.
Advanced View: Configuring Appliances To start this task, double-click on the SNMP icon to open the SNMP Settings window. This window contains the following fields: Field Description Enable SNMP Agent check box Check this check box to enable the SNMP agent on your appliance. SNMP Read-Only Community The SNMP Read-Only Community name is the read-only community name for SNMP read requests.
Advanced View: Configuring Appliances Upgrade Use the Upgrade task to check the BotzWare version installed on your appliance or to upgrade the BotzWare on your appliance. To start this task, double-click on the Upgrade icon to open the Upgrade Appliance window. The current BotzWare version is displayed at the top of the window. The Upgrade task. To check the NetBotz web site for an updated version of BotzWare click Check NetBotz Website.
Advanced View: Configuring Appliances Privilege Set 138 Description Sensor Gives user access to only the Navigation, Sensor Data and selected portions of the Information/Action panes. User accounts configured with the Sensor Privilege Set can view the Cameras, Graphs, and About panes. However, this Privilege Set does not permit access to the Alerts pane, Configuration pane, or to the Appliance Log, Change Root Password, and Reboot Appliance Tool menu selections.
Advanced View: Configuring Appliances By default, your appliance comes pre-configured with two User accounts: • Guest: Available to users that do not provide a User ID or Password at login. By default has access a Privilege Set of None. • Administrator: Accessed by providing the default User ID/Password at login. By definition has an unchangeable Privilege Set of Administrator.
Advanced View: Configuring Appliances Web Server Use the Web Server task to view or change the IP ports through which the appliance web server performs HTTP and HTTPS web server communications. To start this task, double-click on the Web Server icon to open the Web Server Settings window. This window contains the following fields: Field Description HTTP Port The IP port through which HTTP communications are performed. HTTPS Port The IP port through which HTTPS communications are performed.
Advanced View: Defining Thresholds The sensors used by the appliance fall into two categories: Analog sensors and state sensors. Analog sensors report sensor readings as a current value within a broad range of potential values defined by a minimum and maximum value, such as temperature or humidity readings. State sensors, on the other hand, report sensor readings as one of two mutually exclusive states, such as a door being “open” or “closed” or motion being “detected” or “not detected.
Advanced View: Defining Thresholds Maximum Value Threshold A maximum value threshold is defined by specifying a maximum acceptable value for the sensor. If the value reported by the sensor exceeds the specified value an alert condition is reported. To define a maximum value threshold: 1. Start the Camera Pods, Sensor Pods, or Device Crawlers task by double-clicking on the appropriate icon. 2. Click Sensors... to open the Sensor Configuration window. 3.
Advanced View: Defining Thresholds b.By default, all time periods in the schedule are set to Enabled. To disable the threshold for a currently enabled period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Disable. To enable the threshold for a currently disabled period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Enable. c.
Advanced View: Defining Thresholds b. Check the Enabled check box to enable the threshold. If this check box is not checked, the alert threshold will be saved but will not be active. c. Add to the Threshold-Specific Addresses list the e-mail addresses of any personnel to whom email alert notifications should be sent if this threshold triggers an alert condition. Click Add..., type in the e-mail address to which the alert notification will be sent, and then click OK.
Advanced View: Defining Thresholds However, if you have created additional Alert Profiles you can specify that a threshold use an Alert Profile other than Default. Note The Alert Profile drop box will appear in the Advanced tab only if additional Alert Profiles have been created. For more information see “Creating an Alert Profile” on page 63. – Select Cameras to Trigger in response to the alert.
Advanced View: Defining Thresholds where sms_device_address is the telephone number or e-mail address associated with the SMSenabled device (for example, “sms:5123334444” or “sms:user@mycorp.com”). Note These threshold-specific notifications are sent only if your appliance has one or more Alert Actions defined that use the Send E-Mail Message alert notification method and that have the Include Addresses from Thresholds check box checked.
Advanced View: Defining Thresholds Above Value for Time Threshold An above value for time threshold is defined by specifying a maximum acceptable value for the sensor and a maximum period of time value. If the value reported by the sensor exceeds the specified value for more than the specified period of time an alert condition is reported. To define an above value for time threshold: 1. Start the Camera Pods, Sensor Pods, or Device Crawlers task by double-clicking on the appropriate icon. 2. Click Sensors.
Advanced View: Defining Thresholds returned to normal. Default value is 0 (state returns to normal immediately after the measured value is no longer violating the threshold). – Set an Advanced Schedule for this threshold (optional). By default, all thresholds are assumed to be enabled 24 hours a day, 7 days a week. However, you can specify that a threshold will be enabled only during specific time ranges. To set an Advanced Schedule: a. Click Advanced Schedule.... The Schedule Threshold window opens. b.
Advanced View: Defining Thresholds Thresholds selection list. 4. Click Add... to open the Select Threshold window. Select Below Value for Time Threshold and then click OK to close the Select Threshold window. 5. Type in the Threshold Name field a name for this threshold. 6. Specify Basic threshold settings. From the Basic tab in the Thresholds pane: a. Type in the Minimum field (or use the arrows in the field to specify) the highest acceptable value for the selected sensor.
Advanced View: Defining Thresholds c. When you have finished creating your Advanced Threshold, click OK to save the schedule and return to the Thresholds task. – Select an Alert Severity value for this threshold. Available Alert Severities are, in order of escalating severity: Information, Warning, Error, Critical, or Failure. By default, the Alert Severity generated by this threshold will be “Error.
Advanced View: Defining Thresholds more than the Maximum Decrease value in a period of time that is equal to or less than the Time Period value an alert condition is generated. c. Check the Enabled check box to enable the threshold. If this check box is not checked, the alert threshold will be saved but will not be active. d. Add to the Threshold-Specific Addresses list the e-mail addresses of any personnel to whom email alert notifications should be sent if this threshold triggers an alert condition.
Advanced View: Defining Thresholds However, if you have created additional Alert Profiles you can specify that a threshold use an Alert Profile other than Default. Note The Alert Profile drop box will appear in the Advanced tab only if additional Alert Profiles have been created. For more information see “Creating an Alert Profile” on page 63. – Select Cameras to Trigger in response to the alert.
Advanced View: Defining Thresholds If you’ve installed an SMS-capable modem you can deliver alert notification to SMS-enabled devices by entering threshold-specific addresses for them in the following format: sms:sms_device_address where sms_device_address is the telephone number or e-mail address associated with the SMSenabled device (for example, “sms:5123334444” or “sms:user@mycorp.com”).
Advanced View: Defining Thresholds your appliance. To include images from one or more connected Camera Pod 120s, check the check boxes that correspond to the desired pods. – Specify a User-specified URL and User-specified Description. You can use these fields to include additional user-specific information with any alert notifications that are generated using this threshold. 8. Click OK to save this threshold.
Advanced View: Defining Thresholds the Advanced tab in the Thresholds pane: – Specify a Return To Normal Delay value. Use the controls to specify the number of seconds that must pass after this threshold has returned to normal before the threshold state is considered returned to normal. Default value is 0 (state returns to normal immediately after the measured value is no longer violating the threshold). – Set an Advanced Schedule for this threshold (optional).
Advanced View: Defining Thresholds icon. 2. Click Sensors... to open the Sensor Configuration window. 3. Select from the Sensors selection list the sensor for which you will define a threshold. A list of thresholds that have been previously defined for the selected sensor, if any, appears in the Thresholds selection list. 4. Click Add... to open the Select Threshold window. Select Alert State for Time Threshold and then click OK to close the Select Threshold window. 5.
Advanced View: Defining Thresholds period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Enable. c. When you have finished creating your Advanced Threshold, click OK to save the schedule and return to the Thresholds task. – Select an Alert Severity value for this threshold. Available Alert Severities are, in order of escalating severity: Information, Warning, Error, Critical, or Failure.
Advanced View: Defining Thresholds c. Add to the Threshold-Specific Addresses list the e-mail addresses of any personnel to whom email alert notifications should be sent if this threshold triggers an alert condition. Click Add..., type in the e-mail address to which the alert notification will be sent, and then click OK.
Advanced View: Defining Thresholds your appliance. To include images from one or more connected Camera Pod 120s, check the check boxes that correspond to the desired pods. – Specify a User-specified URL and User-specified Description. You can use these fields to include additional user-specific information with any alert notifications that are generated using this threshold. 8. Click OK to save this threshold.
Advanced View: Defining Thresholds where sms_device_address is the telephone number or e-mail address associated with the SMSenabled device (for example, “sms:5123334444” or “sms:user@mycorp.com”). Note These threshold-specific notifications are sent only if your appliance has one or more Alert Actions defined that use the Send E-Mail Message alert notification method and that have the Include Addresses from Thresholds check box checked.
Advanced View: Creating Alert Actions The information that must be provided for an Alert Action depends on which alert notification method you have selected.
Advanced View: Creating Alert Actions c. When you have finished creating your Advanced Schedule, click OK to save the schedule and return to the Alert Action task. 6. Check the check boxes in the Severities check box group that correspond to the alert severities for which buttons will be activated. 7. Select from the Button Output Device drop box the Button Relay device that will be triggered by this alert action.
Advanced View: Creating Alert Actions period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Enable. c. When you have finished creating your Advanced Schedule, click OK to save the schedule and return to the Alert Action task. 6. Check the check boxes in the Severities check box group that correspond to the alert severities for which audio alerts will be played. 7.
Advanced View: Creating Alert Actions when the alert condition no longer exists. 11. Click OK to save this Alert Action. Note Before an audio clip is available for use in the Play Custom Audio alert action it must first be uploaded to the NetBotz appliance. Audio clips are uploaded to the appliance using the Custom Audio Clip task. For information about the Custom Audio Clips task see “Custom Audio Clips” on page 107.
Advanced View: Creating Alert Actions delivering the custom HTTP GET command to an alternate web host. This backup URL would be used only if attempts to deliver the alert data to the primary Target Host failed. You can also check the following check boxes: – Use POST instead of GET: Uses the POST command instead of the GET command. – Include XML-encoded Alert Parameter (xmlalert): Appends the parameter “xmlalert=” to the provided URL for the action.
Advanced View: Creating Alert Actions a. Click Advanced Scheduling.... The Advanced Scheduling window opens. b. By default, all time periods in the schedule are set to Enabled. To disable the Alert Action for a currently enabled period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Disable.
Advanced View: Creating Alert Actions click OK to open the Add Alert Action window. 4. Type in the Alert Action Name field a name for this alert action. 5. Type in the Maximum Camera Pictures field (or use the arrow buttons in the field to select) the maximum number of available images that will be included with the generated data. Note that, depending on the Total Number of Pictures setting (located in the camera configuration task), additional images may be captured by the appliance.
Advanced View: Creating Alert Actions extension. Pictures from alerts will be stored in files with this name, followed by the “.n.jpg” file extension, where n is the picture number (1, 2, 3, etc.). Note The Target Directory and Base Filename fields accept BotzWare macros. For more information on macros supported by BotzWare see “BotzWare Macros” on page 187. 12. If desired, click the Advanced tab and provide information for use in delivering the data to a backup FTP server.
Advanced View: Creating Alert Actions Scheduling: a. Click Advanced Scheduling.... The Advanced Scheduling window opens. b. By default, all time periods in the schedule are set to Enabled. To disable the Alert Action for a currently enabled period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Disable.
Advanced View: Creating Alert Actions Creating a Send HTTP Post Alert Action If you are creating an Alert Action that will use the Send HTTP Post alert notification method: 1. Double click on the Alert Actions icon to start the Alert Actions task. 2. Click Add to open the Select Notification Method window. 3. Select Send HTTP Post from the Select Notification Method pop-up window and then click OK to open the Add Alert Action window. 4. Type in the Alert Action Name field a name for this alert action. 5.
Advanced View: Creating Alert Actions If desired, click the Advanced tab and fill type the appropriate information in the following fields: – Type in the Backup Target URL field the URL (including host, port, and any of the common parameters supported by the appliance) of a system to which HTTP post data will be posted if posting to the primary Target URL fails.
Advanced View: Creating Alert Actions e-mail recipients. • If the E-mail Addresses field is left blank and you uncheck the Include Addresses from Thresholds check box then no e-mail notifications will be sent Note • If the E-mail Addresses field is left blank and you check the Include Addresses from Thresholds check box then e-mail notifications will be sent only if the threshold that is exceeded has a Threshold-Specific Address List.
Advanced View: Creating Alert Actions desired time range, and then click Disable. To enable the Alert Action for a currently disabled period of time, highlight the period of time by clicking-and-dragging over the desired time range, and then click Enable. c. When you have finished creating your Advanced Schedule, click OK to save the schedule and return to the Alert Action task. 6.
Advanced View: Creating Alert Actions notification will be sent. 8. Type in the Message field the text that will be used for the body of the short-format e-mail message. The Message field accepts BotzWare macros. For more information on macros supported by BotzWare see “BotzWare Macros” on page 187. Note 9. Set Advanced Alert Action settings, if desired.
Advanced View: Creating Alert Actions normal state. 10. Click OK to save this Alert Action.
Advanced View: Creating Alert Actions 176 Using Your Appliance
Add-Ons: Advanced Device Crawlers Advanced Device Crawlers is a license key-enabled enhancement to Device Crawlers that greatly extends your ability to monitor the operational status of your SNMP targets. Advanced Device Crawlers extends the capabilities of Basic Device Crawlers to provide far more detailed devicespecific information and to enable OID-specific monitoring and alerting.
Add-Ons: Advanced Device Crawlers you should see Advanced Device Crawlers listed in the list of available applications. 2. Select Advanced Device Crawlers from the list and then click Edit. 3. Type in the License Key field the Advanced Device Crawlers license key. 4. Click OK to add the license key to your appliance. The appliance will need to restart, after which Advanced Device Crawlers will be enabled for use on your appliance.
Add-Ons: Advanced Device Crawlers one or more DDFs that you want to install and use with Advanced Device Crawlers and then click Next. 4. A list of the DDFs you have selected appears. Click next to download and install the selected DDFs. After you have installed a Device Definition File any previously added targets that are defined by the contents of the DDF will now have the Advanced Data sensor set available.
Add-Ons: Advanced Device Crawlers 180 Using Your Appliance
Add-Ons: RAE Systems Sensors Option RAE Systems Sensors Option is a license key-enabled BotzWare enhancement that enables you to use a variety of RAE Systems toxic vapor and gas sensors with your appliances. The following devices are supported: • MultiRAE Plus • ppbRAE • miniRAE • AreaRAE • RAELink For more information on RAE Systems complete line of innovative gas detection products see http:// www.raesystems.com.
Add-Ons: RAE Systems Sensors Option To add your RAE Systems Sensors Option license key to your appliance: 1. Use the Advanced View to start the License Key task on your appliance. When the task starts, you should see RAE Systems Sensors Option listed in the list of available applications. 2. Select RAE Systems Sensors Option from the list and then click Edit. 3. Type in the License Key field the RAE Systems Sensors Option license key. 4. Click OK to add the license key to your appliance.
Add-Ons: RAE Systems Sensors Option The RAE Systems task is used to: • Configure communications settings for use with any RAE Systems devices that are connected to your appliance (via either a USB-to-serial port cable or a RAELink wireless communication upgrade package) • Specify Remote RAE Client settings (which enable you to share RAE Systems device data with a Remote RAE Server) • Enable and configure Remote RAE Server settings, which enable you to configure your appliance to receive RAE Systems device
Add-Ons: RAE Systems Sensors Option The following controls are available from the RAE Systems Devices tab of the RAE Systems task: Field Description Retry Interval Specify the number of seconds that the appliance will wait for a response from any RAE Systems device before the appliance either retries communications or considers the target to be unresponsive.
Add-Ons: RAE Systems Sensors Option Use the settings available in the RAE Remote Server tab to enable or disable the RAE Remote Server functionality on this appliance (enabling other licensed appliances to forward RAE Systems device data to this appliance), to specify the network settings that will be used for Remote RAE Client/Server communications, and to specify which detected RAE Remote Clients will be allowed to report data to this Remote RAE Server.
Add-Ons: RAE Systems Sensors Option Field Available/Allowed Remote RAE Clients Description Any appliance that attempts to forward RAE Systems device data to this appliance will be automatically added to the Available Remote RAE Clients selection list. However, only data from clients that are in the Allowed Remote RAE Clients selection list will be collated and displayed in the interfaces.
BotzWare Macros This appendix defines the various macros supported by BotzWare. Macros are case-sensitive and must be entered exactly as shown. Note Appliance Macros The following macros are supported for use in the settings for attributes that support Appliance macros: Macro Definition Example ${SERIAL} The serial number of the appliance. 00_02_D3_00_01_13 ${IP} The dotted-decimal IP address of the appliance. 192.168.2.23 ${HOSTNAME} The hostname of the appliance. testbot.netbotz.
BotzWare Macros Location Macros The following macros are supported for use in the settings for attributes that support Location macros: Macro 188 Definition Example ${LOCATION} The location attribute of the appliance. Test Lab ${ENCLOSURE} The current enclosure ID (specified in the Location task settings) for the appliance. RACK1234 ${SLOT} The slot in the enclosure (specified in the Location task settings) for the appliance.
BotzWare Macros Macro Definition Example ${NOTES} The Notes value (specified in the Location task settings) for the appliance. IT Closet, Server Room ${LATITUDE} The Latitude value (specified in the Location 30° 18’ N task settings) for the appliance. ${LONGITUDE} The Longitude value (specified in the Location task settings) for the appliance. ${GPSLOC} Reports the current longitude and latitude 30° 18’ N / 97° 42’ W data at alert time (units to which a GPS pod is connected only).
BotzWare Macros Macro 190 Definition Example ${ALERTSEV} ERR, WARN-RTN The severity value reported by the sensor that is generating the alert (such as ERR, WARN, INFO). If the alert state has returned to normal, the severity value will be followed by “RTN” (for example WARN-RTN). ${ALERTPOD} My Pod The label of value of the pod that either contains the sensor that reported the alert or to which the sensor is connected.
BotzWare Macros Macro Definition Example ${RESOLVEUSERID} The user ID that is responsible for joeuser manually resolving an alert (when this option applies). ${RESOLVECOMMENT} “Turned on the A/C”; The text entered into the “Userresolution comment” field whenever “Fixed the leak” an alert needs to be manually returned to normal (an option which can be selected whenever a threshold is configured). ${START_TIME} The time at which the alert condition was initially detected.
BotzWare Macros 192 Using Your Appliance
Overloaded Appliances: Symptoms & Solutions Like any computing device, your appliance has limited resources available at any point in time to perform tasks. If your appliance is configured to perform too many tasks simultaneously – or to perform resource-demanding tasks such as image processing and recording more often than is needed – its performance will be adversely affected.
Overloaded Appliances: Symptoms & Solutions scanning all MIB2 interfaces on these devices can cause significant delays on Device Crawlers performance. To avoid these impacts, disable MIB2 scanning on these devices. • Lower the Interactive Frame Rate Limit on some or all cameras connected to the appliance (start the cameras task, select a camera, and then click Settings).
Overloaded Appliances: Symptoms & Solutions important that you verify that the appliance is configured to generate alert states and send alert notifications as efficiently as possible. • When viewing alerts in the Advanced View, setting the refresh interval to None or to a large refresh interval may allow a heavily-alerting appliance to load its complete list of resolved and unresolved alerts more efficiently.
Overloaded Appliances: Symptoms & Solutions 196 Using Your Appliance
Camera Usage Considerations Depending on image resolution and frame rate settings, Camera Pod 120s can consume significant network bandwidth. Of course, the impact that network bandwidth consumption will have depends greatly on how much bandwidth is available for use. Because of this, there is no way to definitively state what the “right” or “best” Camera Pod settings are when trying to ensure that the data generated by your Camera Pods does not negatively affect the performance of your network.
Camera Usage Considerations 198 Using Your Appliance
Verifying Signed M-JPEG AVI Files NetBotz has included a simple command line utility that enables you to verify that digitally signed M-JPEG files have not been tampered with since they were generated by your NetBotz appliance. This command line utility, AVIVRFY.BAT, is automatically installed along with the Advanced View and can be accessed from the Advanced View installation directory. To use this utility, open a command line session and change directories to the Advanced View installation directory.
Verifying Signed M-JPEG AVI Files 200 Using Your Appliance
www.netbotz.
