NetBotz® Appliance User’s Guide NBRK0550 NBRK0450 NBWL0455 NBWL0456 NBWL0355 NBWL0356
Contents Preface ............................................................................. 1 U.S. Government Restricted Rights . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Misuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Improper Use of Audio/Video Recording Capabilities. . . . . . . . . . . . 1 Availability of Open Source Technologies . . . . . . . . . . . . . . . . . . . . . 1 Introduction ...........................................
Basic View: Setup.......................................................... 12 Appliance setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Sensor setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Camera pod setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Advanced View: Getting Started .................................. 13 System Requirements. . . . . . . . . . . . . . . . . . . . . .
Viewing Maps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Viewing Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Advanced View: Pod/Sensor Settings ......................... 28 Alert Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 Pre-configured alert actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Available alert notification methods . . . .
Sensor Pods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61 Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 External ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Advanced View: Configuring Appliances.................... 67 Creating and Editing Maps .
Proxy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86 Region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86 Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87 Serial Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87 SMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
BotzWare Macros ........................................................ 115 Appliance Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Location Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Alert Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 HTTP Post/FTP Data Delivery Parameters ................ 119 Common Parameter Definitions . . . . . . . . . . . . . . . . . . . . . .
Preface U.S. Government Restricted Rights Restricted rights legend. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of the Commercial Computer SoftwareRestricted Rights clause at CFR 52.227-19, as applicable. Misuse Use your appliance ONLY in the manner specified.
Introduction The American Power Conversion (APC®) NetBotz® Basic View and Advanced View each provide a software interface for monitoring and controlling your NetBotz security and environmental monitoring system. Basic View and Advanced View are used in conjunction with the following NetBotz appliances: NetBotz Rack Monitor 450, NetBotz Rack Monitor 550, NetBotz Room Monitor 455, and NetBotz Room Monitor 355. Basic View is a Web-based software interface used primarily for monitoring the environment.
SSL Support By default, Secure Sockets Layer (SSL) is enabled on your NetBotz appliance. All browser/appliance interaction can be carried out using SSL by connecting to the appliance using a URL beginning with https (for example, https://IP_address). Your appliance can also use SSL when posting alert notification and sensor data to Web servers, and Advanced View can be configured to use SSL when communicating with your appliance.
Basic View: Getting Started Basic View is an HTML-based interface that allows you to view data about objects monitored by your appliance. You can use a supported Web browser to view sensor readings reported by any camera pods, sensor pods, external sensors connected to sensor pods, and devices being monitored using scanners. View a list of active and resolved alert conditions, and view images being captured by camera pods connected to your appliance.
Choosing a Language Basic View supports the following languages. Configure your browser or operating system for any of the supported languages. • Chinese (simplified) • English • Japanese • Russian Accessing Basic View To access an appliance using Basic View, enter the hostname or IP address of the appliance in a supported Web browser.
Interface Navigation The Basic View interface is divided into three regions: • The Navigation pane: Located in the upper-left corner of the interface, the Navigation pane is used to select a device for which to view sensor data in the Sensor Data pane. The devices are typically an appliance and camera pods and sensor pods connected to the appliance but may include other devices, such as third-party cameras.
Simplified Basic View on Your PDA NetBotz appliances support a simplified version of Basic View for that can be viewed using a Personal Digital Assistant (PDA). Accessing the simplified Basic View To use the simplified Basic View, enter the hostname or IP address of the appliance in a supported PDA Web browser. • If the Guest account of the appliance is configured with a Sensor (No Camera), Sensor, Application, or Administrator privilege set, you are automatically granted access to the appliance.
Configuring your appliance. From the Navigation pane, select the appliance, pod, or other device to configure. In the Sensor Data pane for that device, select Setup. The configurable settings are displayed in the Configuration pane.
Basic View: Monitoring Your Environment Basic View provides an appliance monitoring interface that does not require the Advanced View application and Java Runtime Environment. Use Basic View to view sensor readings, view camera images, graph collected sensor data, and view active and resolved alert conditions. Viewing sensor readings and status in Basic View Basic View provides readings and the alert status for all sensors that are part of your NetBotz security and environmental system.
Viewing alerts To view alert conditions reported by an appliance, pods, or sensors: 1. Click the Alerts button from the Action/Information pane. 2. Select the appliance, pod, or other device from the Pods drop-down list to check for active alert conditions. The appliance is selected by default. – To view active alert conditions for the appliance and all connected pods, select All from the Pods drop-down list. – To view resolved alert conditions, select Include Resolved Alerts.
Viewing maps Use the Map View to view user-created maps that show the location of your NetBotz appliances, pods, and sensors. The status of all devices shown on the Map view is indicated by a red background for an alert status and a green background for a status of OK. Note: You can use Basic View to view existing maps. Use Advanced View to create, edit, or delete a map. To view a map using Basic View, click the Maps button in the Action/Information pane.
Basic View: Setup Basic View displays sensor data, camera images, and alert conditions reported by an appliance and by pods or sensors connected to the appliance. Most appliance, pod, and sensor configuration is performed using the Advanced View interface. Basic View provides limited setup capabilities using the Setup button in the Actions/Information pane. Appliance setup 1. Click the Setup button from the Actions/Information pane. 2. Select an appliance from the Pods drop-down list. 3.
Advanced View: Getting Started Advanced View is a stand-alone Java application that you can use to monitor and configure your appliance and any camera pods, sensor pods, CCTV adapter pods, output relay pods, 4-20 mA sensor pods, external sensors, or supported serial-based sensors connected to the appliance. Note: Your monitor must be set to at least 1024x768 for Advanced View to display properly.
System Requirements To run the Advanced View software application, your personal computer must meet these system requirements: • 1 GHz or greater, AMD® or Intel® processor • Microsoft® Windows® XP Service Pack (SP) 1 or SP2, Windows 2000, Windows Vista® Business, Windows Vista Enterprise, Red Hat® Enterprise Linux ® 4 with X Windows installed, or Fedora Core™ 4 or later with X Windows installed • A minimum of 512 MB RAM Software Installation Follow the procedures in this section to install the following ap
Adding Appliances Before using Advanced View to manage an appliance, you must first add the appliance 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. In the IP Address or Hostname field, type the IP address or hostname of the appliance. 3. In the Port field, type the TCP port through which you will communicate with this appliance. The default value is 80. 4.
Accessing an Appliance Using Advanced View Select an appliance from the Appliance list. • If the appliance Guest account is configured with a Sensor (No Camera), Sensor, Application, or Administrator privilege set, you are automatically granted access to the appliance and can view Advanced View panes permitted by the privilege set.
Interface Navigation The Advanced View interface is divided into the Navigation pane, the Sensor Data pane, and the Action/ Information pane. Navigation pane Located in the upper-left corner of the interface, the Navigation pane displays: • An appliance and camera pods and sensor pods connected to the appliance • Serial-based sensors being monitored using scanners • Alerting sensors • Shared devices, such as shared IP cameras.
Locking a Navigation pane selection You can lock the Navigation pane so that only a specific device is selected. Once the Navigation pane is locked, Advanced View automatically starts with the pane in the locked state. To lock the pane to a specific device: 1. Select a device. 2. Right-click on the device and select Lock selection. 3. To unlock the pane, right-click on any device in the Navigation pane and clear the check box for the Lock selection option.
Advanced View Menus Advanced View features the following menu bar: • File: Use this menu to add appliances to or remove appliances from the Appliance selection drop-down list and to exit the Advanced View application. • Edit: Use this menu to cut, copy, paste, and delete text, and to configure Preferences. See “Editing Preferences” on page 21. • Tools: Use this menu to complete the following tasks: – View Messages (information generated by Advanced View for logging and debugging purposes).
Using View Post-only Mode If you use InfraStruXure Central to monitor and manage a NetBotz appliance that is located behind a firewall, InfraStruXure Central may not be able to communicate directly with the appliance. Placing the appliance in View Post-Only Mode causes the appliance to post all monitoring data to a specified InfraStruXure Central appliance at a user-specified interval. SSL encryption can be used for secure data posting. To use View Post-Only Mode: 1.
Editing Preferences With Advanced View you can configure preferences that apply to the appearance and functionality of the Advanced View user interface. These settings are saved on your client system, not on your appliance. Select Preferences from the Edit menu. Choose from the following preference categories: • Appearance • General • Network • Video Clip Player Appearance preferences To edit your client Appearance settings, open the Client Preferences window and select Appearance from the Category list.
Advanced View: Monitoring Your Environment Use Advanced View to view sensor readings, view camera images, graph collected sensor data, and view active and resolved alert conditions. You can also create, view, and delete maps for use in the Map view. Viewing Sensor Readings and Status in Advanced View To view sensor readings, select a device that includes sensors from the Navigation pane. The Sensor Data pane automatically updates with sensor information for the device you selected.
Standard camera controls Control Description Mode To change the size of the image, from the Mode drop-down list, choose dimensions (resolution) for the image. The dimensions 640x480, for example, mean 640 pixels wide by 480 pixels high. NOTE: As the image dimensions increase, the maximum image rate available will decrease. For more information, see “Camera Usage Considerations” on page 142.
Pelco PTZ camera controls The following are additional camera controls for the supported Pelco PTZ (pan, tilt, zoom) cameras. Control Name Description Pan Left Click and hold to pan the camera left and right. You can also use the left and right arrow keys on your keyboard. Pan Right Tilt Up Click and hold to tilt the camera up and down. You can also use the up and down arrow keys on your keyboard. Tilt Down Zoom In Click and hold to zoom in.
Recording Camera Images Use Advanced View to record camera images and save them to a user-specified directory. By default, recorded camera images are saved to a subdirectory with the same name as the camera pod, located within a directory named camera in your Home directory. For example, a user account named NetBotz on a Windows XP system recording images from a camera pod labeled My Camera would store recorded images in the directory C:\Documents and Settings\NetBotz\My Camera.
If additional alert-specific data such as graphs, maps, or captured images is available, it appears on the Alert Details view as entries in additional tabs. Double-click entries on tabs to view additional data. Note: When viewing video that was captured for an alert for a camera motion sensor, the IP Address displayed is that of the appliance selected from the Appliance field, even if the camera pictures are from a shared IP camera.
Viewing Graphs To view a graph of the data collected by a sensor connected to your appliance: 1. Click the Graph View button in the Action/Information pane. 2. Select the pod from the Pods drop-down list that either includes the sensor you need to view or to which the external sensor that you need to view is connected. 3. From the Sensors drop-down list, select a sensor for which data will be graphed.
Advanced View: Pod/Sensor Settings Use the icons in the Pod/Sensors Settings area of the Configuration view to configure the pods and sensors connected to your appliance and configure the alert actions and policies that are used when alerts are reported by sensors. Note: The icons that appear in the Pod/Sensor Settings area depend on how your system is configured. It is possible that not all icons discussed in this chapter will appear in your Pod/ Sensor Settings area.
• Send HTTP Post: Sends an HTTP post to a specified HTTP server with information about the alert. The alert notification post can include images captured by a camera pod, a graph, and a map of the sensor-specific data associated with the alert. Note: The appliance posts all data according to “HTTP Post/FTP Data Delivery Parameters” on page 119. You must configure the target HTTP server appropriately to receive the posted data.
Alert Profile Use the Alert Profile icon to customize your appliance default alert notification policy, or to create additional alert notification policies. Alert policies define the notification actions taken by the appliance in response to alerts. Each Alert Profile consists of one or more Alert Sequences.
Creating an alert profile To create a new alert profile or modify an existing alert profile: 1. Double-click the Alert Profile icon. 2. Click Add.... Select an alert action from the Add Alert Actions window and click OK. 3. Type an Alert Action Name and configure the Severities, Alert Action Parameters, and Advanced Scheduling. Click OK. 4. If you are modifying an existing alert profile, select the alert profile from the Profile table and click Edit.... When you finish making your changes, click OK.
Suppressing alert notifications You can temporarily suppress all alert notifications associated with a selected alert profile globally. Note: Disabling alert notifications prevents your appliance from automatically notifying you of conditions that may be hazardous to your critical assets and spaces. Use this feature only for scheduled maintenance or downtime. When alert notifications are disabled, sensors in the Sensor Readings pane continue to turn red to indicate that a threshold has been violated.
Camera Pods To configure a camera: Note: From the Navigation pane, you can right-click a Pelco camera and select Connect to... to launch the Pelco Web interface for the camera. This will allow access to additional configuration settings. 1. For integrated cameras or cameras connected to the appliance, double-click the Camera Pods icon. The Camera Pod Configuration window appears with a list of cameras. 2. For IP cameras that are shared, double-click the Shared Cameras icon.
Field Description Speaker Label An additional label for the speaker on this pod (camera pods and CCTV adapter pods only). Unplugged Alert Severity The severity of alerts generated if this device is unplugged. Unplugged Alert Profile The actions taken if the camera pod is unplugged. By default, the default alert profile is used for all thresholds. If you create additional alert profiles, you can specify an alert profile other than default.
To associate a relay or switch with a camera, and include buttons in the Camera View for the associated relays: 1. Double-click the Camera Pods icon. 2. A list of integrated cameras and cameras connected to the appliance appears. Select the camera you want to configure. 3. Click Settings. Select the Associated Sensors tab. 4. Select one or more relays from Available Sensors to associate with the selected camera. Click -> (right arrow) to move the selected relays to Selected Sensors.
Capture settings Select a camera from the Camera Pods window and click Capture to open the Camera Capture Settings window. From this window you can configure the following settings: Note: Fields displayed may vary depending on the features of the camera selected. Field Description Brightness The brightness of the image captured by the camera, from 0 to 255. Gamma correction Adjust the overall brightness of the camera image. Images not properly corrected can look either bleached out or too dark.
Field Image Quality Description The amount of compression applied to captured images. As compression increases, file sizes decrease but the quality of the image decreases as well. For Pelco cameras, this field does not apply. Default is shown in this field and it cannot be changed. Note: The image quality and the mode setting specified in the Camera view affect the maximum frame rate available.
Field Description Audio Volume The volume at which audio is captured. Capture Data Summary Shows information about the files generated by the pod using the Capture settings. This information updates automatically as new settings are specified. Type the values in the appropriate fields. To see an example of an image capture using the updated settings, click Apply. The sample image in the Capture window is updated using the new values. When you are finished, click OK.
Mask settings Select a camera from the Camera Pods window and click Masking. Masking is available only on the NetBotz Rack Monitor 550 or on appliances for which the Advanced Software Pack has been purchased. For more information, contact your NetBotz authorized reseller or the NetBotz support team. Camera-based motion sensing compares concurrent image captures and determines whether any detected changes are significant enough to generate an alert.
Motion mask tab. The following controls are available: Field Description Enable Camera Motion Check to enable the camera motion sensor. Sensitivity Specifies how much change in a portion of the image capture is tolerated before the change is considered movement. Lower values indicate higher sensitivity and less tolerance for change between images. Show outline of detected motion When enabled, any region of an image that indicates motion is surrounded by a dotted-line outline.
Visual mode settings Use Visual Modes to select the camera imager mode and to select the window of interest used when Pan and Scan mode is active. This window is not available for Pelco PTZ cameras. The camera pod imager can capture images at resolutions up to 1280x1024, and supports Wide Screen mode and Pan and Scan mode. Wide Screen mode captures images using the entire 1280x1024 frame, while Pan and Scan mode captures a selected portion of the total 1280x1024 field of view.
Sensor configuration Select a camera from the Camera Pods window and click Sensors. The Sensor Configuration window displays a Sensors list and a Thresholds list. Select a sensor from the Sensors list to display thresholds defined for the sensor in the Thresholds list. To modify a sensor: 1. Select the sensor to modify from the Sensors list and click Modify. 2. Enter a label in the Label field.
Scanned Devices Note: The Scanned Devices icon is only available with the purchase of the 5-node Scanner/ IPMI Pack. For more information, contact your NetBotz authorized reseller or the NetBotz support team. Scanned devices are SNMP targets that are monitored by Advanced View. You can monitor status information for up to five remote SNMP targets such as servers, routers, and switches as well as APC devices such as APC UPSs and APC Rack Power Distribution Units (PDUs).
Scanners gather 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 description value (does not support threshold configuration). • IF MAC Address: Displays the interface MAC address (does not support threshold configuration). • IF Type: State sensor that reports the interface type value.
Adding, editing, and removing SNMP targets 1. Double-click the Scanned Devices icon. The SNMP Target window appears. 2. To remove SNMP targets from the SNMP Targets list, select SNMP target entries and click Remove. 3. To add a new SNMP target, click Add. To edit a target, select the target from the SNMP Targets list and click Edit. 4. The Add SNMP Device window or Edit SNMP Device window appears. Configure the SNMP target using the item descriptions for both windows shown below. When finished, click OK.
Specifying global SNMP settings Click Global SNMP Settings to configure SNMP settings for scanned devices for all SNMP target communications. The Global SNMP Settings window contains the following fields: Item Description Scan interval The number of minutes between scanned target queries. Maximum route hops The maximum number of hops recorded and saved by scanners providing route tracing support. Number of Device Scanners in use The number of device scanners being used.
Sensor settings Select an SNMP target from the SNMP Targets view and click Sensors to open the Sensor Configuration window. Monitored values available from the SNMP target are listed in the Sensors list. Select a sensor from the Sensors list to display thresholds defined for that sensor in the Thresholds selection list. Note: If the selected sensor does not support threshold configuration, a message advising you of this appears in the Thresholds area of the interface. To modify a sensor: 1.
IPMI Devices Note: The IPMI Devices icon is only available with the purchase of the 5-node Scanner/ IPMI Pack. For more information, contact your NetBotz authorized reseller or the NetBotz support team. The IPMI standard defines a hardware and software management interface and implementation that provide different hardware platforms with compatible server management and control functions.
Sensor settings Select an IPMI-enabled device from the IPMI Devices view and click Sensors to open the Sensor Configuration window. Once you select a sensor from the Sensors list, thresholds defined for the selected sensor appear in the Thresholds selection list. Note: If the selected sensor does not support threshold configuration, a message advising you of this appears in the Thresholds area of the interface. To modify a sensor: 1. Select a sensor from the Sensors list. 2.
Output Control Note: The Output Control icon appears only when a supported Sealevel I/O device or APC Switched Rack PDU has been connected to the appliance and configured using the Serial Devices icon. For more information on configuring serial devices, see “Serial Devices” on page 87. For more information about supported Sealevel I/O devices and APC Switched Rack PDUs and how they connect to the appliance, see the installation and quick configuration manual included with your appliance.
Output control external port settings Select a device from the Output Control Configuration window and click External Ports. To modify devices connected to your output control devices: 1. Select the output control action to assign to the corresponding port from Relay Output Type. Note: Output control actions do not apply for devices wired between the NO and NC terminals. These devices have an always open state.
The following output control actions are available when the output control device is wired between the NC (Normally Closed) and COM terminals on the appliance: Action Description None No output action is associated with this port. One-Second Button (NC) When activated, a normally closed (NC) relay is switched to a closed state for 1 second, and then switched back to open.
Defining custom output action types. You can add custom output action types by clicking Add Custom... Once created, custom output action types are available from the Relay Output Type list. Note: Custom output actions can only be added or removed. They cannot be edited. View the custom settings for selected output actions by clicking View Custom. To create a custom output action type, click Add Custom...
• Switch Relay actions cause the relay device to switch from its current state (On or Off) to its alternate state. Once switched, the relay remains in the new state until another switch action changes its state again. To create a Switch Relay action: a. Select Switch Relay and click OK. b. The Add Switch Relay Output window features the following fields and controls: Field Description Relay output type The name of the custom output action definition.
Output control sensor settings After you select an output control device from the Output Control Configuration window and click Sensors, the Sensor Configuration window opens. Select a relay from the Sensors list to display thresholds defined for the selected sensor in the Thresholds list. Sensor settings. To modify a sensor: 1. Select a relay to modify from the Sensors list. Click Modify. 2. Type a label in the Label field.
Periodic Reports Configure your appliance to generate sensor reading reports and deliver them on a user-specified schedule. These reports contain readings for all sensors connected to your appliance. Double-click the Periodic Reports icon to open the Periodic Reports Configuration window.
Field Description Graph priority Limit the amount of sensor data included with the periodic report. Select one of the following settings: High: Only sensor data associated with physical sensors that are integrated with or connected to the appliance is included in the report. Sensor data associated with remote devices is not included in the report. Medium: Sensor data associated with physical sensors and with Advanced Data sensor sets from remote devices is included in the report.
Configuring periodic FTP reports To configure your appliance to periodically generate and deliver sensor reports to a specified FTP server: 1. Select Periodic FTP Report from the Periodic Reports Configuration window and click Edit. 2. The Edit Periodic FTP Report window opens. This window contains the following fields: Field Description Enabled Enable periodic FTP reporting. Include camera pictures Include image captures by camera pods connected to the appliance in the FTP post.
Field Target directory Description The relative directory path 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 are created automatically. The Target Directory field accepts BotzWare macros. For more information on macros supported by BotzWare see “BotzWare Macros” on page 115.
Configuring periodic HTTP reports To configure your appliance to periodically generate and post sensor reports to a specified HTTP server: 1. Select Periodic HTTP Report from the Periodic Reports Configuration window and click Edit. 2. The Edit Periodic HTTP Report window opens. This window contains the following fields: Field Description Enabled Enable periodic HTTP reporting. Include camera pictures Include image captures by camera pods connected to the appliance in the HTTP post.
Sensor Pods Use the information in this section to configure integrated sensor pods, NetBotz sensor pods, NMEA-compliant GPS receiver, Rack Access PX-HID, and any other non-camera device associated with the appliance. 1. For integrated sensor pods and NetBotz sensor pods, double-click the Sensor Pods icon. The Sensor Pod Configuration window appears with a list of integrated sensor pods and NetBotz sensor pods. 2. For non-camera shared IP devices, double-click the Shared Sensors icon.
Sensors Select a device from the Sensor Pods window and click Sensors. Select a sensor from the Sensors list to display thresholds defined for that sensor in the Thresholds list. To modify a sensor: 1. Select a sensor from the Sensors list. 2. Click Modify to open the Modify Sensor window. 3. Type a label in the Label field. This label can be up to 64 characters in length, and identifies the sensor in the Sensor Data pane, Advanced View interfaces, and in alert notifications. 4.
External ports Select a sensor pod from the Sensor Pods window and click External Ports. If the device does not include external ports, the External Ports button will be unavailable. Note: For shared devices, a dialog box appears asking if you would like to connect to the remote device. You must connect to the device to configure external ports. Clicking the Connect to button causes Advanced View to switch the IP address in the Appliance field to that of the remote device.
• Define the custom analog sensor a. Select Analog (0-3.3V) or Analog (0-5.0V), click OK to open the Add Analog Sensor window. This window features the following fields and controls: Field Description Sensor type The name of the custom sensor definition. Once defined, the Sensor type label appears only in the Sensor Type Installed drop-down list when specifying Sensor Pod external port settings.
• Define the custom dry contact sensor a. Select Dry Contact and click OK to display the Add Dry Contact Sensor window. This window features the following fields and controls: Field Description Sensor type label The name of the custom sensor definition. Once defined, the Sensor type label appears only in the Sensor Type Installed drop-down list when specifying Sensor Pod external port settings.
• Define the custom 4-20mA sensor a. Select 4-20mA sensor and click OK to open the Add Custom 4-20mA Sensor window. This window features the following fields and controls: Field Description Sensor type label The name of the custom sensor definition. Once defined, the Sensor Type Label appears only in the Sensor Type Installed drop-down list when specifying Sensor Pod external port settings. Default sensor label The label used, by default, for any new sensors added using this custom sensor definition.
Advanced View: Configuring Appliances The icons in the Appliance Settings area of the Configuration view enable you to configure your appliance. Creating and Editing Maps To create a new map for use in the Map View or to edit a map: 1. Click the Maps View button in the Action/Information pane. 2. To create a new map, click Add. To edit a map, select the map from the Maps drop-down list and click Edit. The Map Configuration window opens.
Backup Use the Backup icon to save your appliance configuration to a password-protected, encrypted file. This backup file includes all of the configuration settings for your appliance, including user account settings, pod configurations, alert actions, and profiles. Once your appliance configuration is saved, you can use the Restore icon to restore this configuration to your appliance at a later date. To save your appliance configuration: 1. Double-click the Backup icon. 2.
Custom Audio Clips Use the Custom Audio Clips icon to upload custom audio clips (in WAV or OGG format) to your appliance or to delete clips from the appliance. For more information about the Play Custom Audio alert action, see “Creating a play custom audio alert action” on page 101. Adding custom audio clips To upload a custom audio clip to your appliance: 1. Double-click the Custom Audio Clips icon. 2. Click Add custom audio clip. 3. Select a sound file.
DNS Use the Domain Name Server (DNS) icon to view or change the domain name server settings and to enable and configure Dynamic DNS functionality. Double-click the DNS icon to open the DNS Settings window. This window consists of the DNS pane and the Dynamic DNS pane. Configuring DNS settings To change the DNS settings, configure the following fields in the DNS pane: Field Description DNS Domain The DNS domain name to which this appliance belongs.
E-mail Server Double-click the E-mail Server icon to open the E-Mail Server Configuration window. Configure the following fields and click OK. Click Test E-mail Server to test your e-mail server settings. All settings except From address to appear in appliance e-mails are available for both a primary e-mail server and a secondary backup e-mail server. Field Description From address to appear in appliance e-mails The e-mail address that appears in the From field of e-mail generated by the appliance.
Using an extended storage system Note: You cannot select the USB Drive option if no USB port is connected to your appliance. To configure your appliance to use an Extended Storage System: 1. Click the External Storage icon to open the External Storage window. 2. Click Add... to open the External Storage Configuration window. 3. Select USB Drive and click Next. 4.
Using a Windows share Use the Backup icon to back up your appliance configuration before using External Storage to configure the appliance to use a Windows Share. To configure your appliance to use a Windows Share: 1. Click the External Storage icon to open the External Storage window. 2. Click Add... to open the External Storage Configuration window. 3. Select Windows Share and click Next. 4.
Using an NFS mount To configure your appliance to use network-attached storage for extended storage purposes: 1. Use the Backup icon to back up your appliance configuration before using External Storage to configure the appliance to use a network file system (NFS) mount. 2. Click the External Storage icon to open the External Storage window. 3. Click Add... to open the External Storage Configuration window. 4. Select NFS Mount and click Next. 5.
Removing external storage To remove external storage from your appliance: 1. Double-click the External Storage icon. Then click Stop Using. A confirmation message notifies you that this action will cause the appliance to reboot. 2. Click Stop Using. A prompt to reboot the appliance appears. 3. Click Reboot. The appliance automatically reboots. This may take a few minutes, during which time Advanced View will be unavailable. 4.
Location Use the Location icon to configure additional sensor-specific location information to include 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. Location settings for pods and sensors can be inherited from their parent pods and sensors. Double-click the Location icon to open the Location Configuration window. To change the Location settings, select an appliance, pod, or sensor.
The following controls and fields are displayed in the Edit Network Interface window: Field Enable Interface Description Select to enable this network interface. Configure automatically via DHCP Configure the network interface to use a DHCP server on the network to obtain its IP address, subnet mask, and gateway address. Configure using these settings Manually specify the IP address, subnet mask, and gateway address for the network interface.
PPP/Modem Note: The PPP/Modem icon appears only when a supported modem has been connected to the appliance and configured using the Serial Devices icon. For more information on configuring serial devices, see “Serial Devices” on page 87. For more information about supported modems and how they connect to the appliance, see the installation and quick configuration manual included with your appliance.
Field Description Dial-out response to alerts/reports Select the PPP dial-up action taken by the appliance when alerts or periodic reports are generated. Select from the following list: • Disabled—No dial-up action is taken when alerts or reports are generated. • Enabled—Use PPP to connect to the network whenever an alert or report is generated. • Delivery Failure—Use PPP to connect to the network only if network-based alert notification (for example, e-mail, FTP, HTTP posting) or report delivery fails.
Managing your appliance using a dial-In PPP connection When dial-in support is enabled, the appliance places the external modem in auto-answer mode. This allows you to initiate a dial-in connection to the appliance through the external modem. To authenticate a PPP connection, you must provide a user ID and password for a user account with Administrator access. Once the PPP connection is established, you can access the appliance using the IP address 192.168.254.1.
Data to FTP Server notification method. If too many notifications are delayed, some will not be sent. • Sensor Data Fails to Load: If the appliance is transmitting a large amount of data, attempts to load sensor data may fail. Once the load on the appliance is reduced, the sensor data re-appears. Using SIM security If your SIM requires a PIN and you enter the PIN incorrectly, the SIM can become blocked. If your SIM is blocked, you will require a Pin Unblocking Key (PUK) from your service provider.
Pod Sharing Pod Sharing lets you select a single appliance to monitor remote devices distributed throughout your network. With pod sharing, the appliance connects with and receives data—including sensor data and camera images—directly from remote devices.
Item Description 1 IP network 2 Data center 3 Network closet 4 NetBotz Rack Monitor 550 5 NetBotz Room Monitor 455 6 Pelco IP camera 7 Network switch Any remote devices that are shared appear in the Navigation pane. Pod sharing allows you to monitor your system without having to change the selected appliance in Advanced View or having to switch to another application. In Advanced View, remote devices are subdivided into one or more pods to share.
. To designate shared sensor pods: 1. From the Appliance Settings area of the Configuration view, double-click the Rack Access PX-HID Pod Sharing icon. The Rack Access PX-HID & Pod Sharing Configuration window opens. 2. Click Add Remote Device. The Configure Remote Device dialog box opens. 3. Enter information. Descriptions for each field follow: Field Description Host/IP address The hostname or IP address of the remote device. Port TCP port over which pod sharing communications occur.
6. For each pod that you want to centrally manage, select the pod from the Available Pods list (ignore any instances of Base Enclosure in the list) and then click Share Remote Pod. To designate shared IP camera pods: 1. From the Appliance Settings area of the Configuration view, double-click the Rack Access PX-HID Pod Sharing icon. The Rack Access PX-HID & Pod Sharing Configuration window opens. 2. Click Add Remote Camera. The Configure Remote Device dialog box opens. 3.
Proxy Use the Proxy icon to allow the appliance to use an HTTP, Socks V4, or V5 Proxy Server. When configured, the appliance uses the proxy server for all e-mail and HTTP Post communications, allowing these communications to cross the firewall. These settings apply only to communications from the appliance. To use an HTTP, Socks V4, or V5 Proxy Server, double-click the Proxy icon to open the Proxy Settings window.
Restore Use the Restore icon to restore your appliance configuration using a configuration file created using the Backup icon. For more information, see “Backup” on page 68. To restore your appliance configuration: 1. Double-click the Restore icon. 2. In the Backup file field, enter the name and fully qualified path to the backup file or click Browse to navigate to the drive and directory in which the backup file is stored. Select the file then click OK. 3.
SMS Use the SMS (Short Messaging Service) icon to view or change the SMS settings used by your appliance. For more information, see “Creating a send short message e-mail alert action” on page 110. Note: This icon is available only if a modem that supports SMS messaging is installed in and configured for use with your appliance. The SMS Configuration window consists of Basic, Advanced, and Status tabs. The Status tab displays the level and quality of the SMS signal.
The following controls and data appear in the Advanced tab: Field Send debug messages to syslog Description When checked, debug messages are forwarded to the syslog host specified in the Configure Log Settings window. For more information see “Log” on page 76. Use default SMS settings Check to use the default SMS values for your SMS-capable modem. To use custom settings, uncheck this checkbox, check Use protocol descriptor unit, and enter Character set and Initialization commands.
SNMP Use the SNMP icon to view or change the appliance SNMP settings. Caution: For Advanced Users Only! This is an advanced feature of NetBotz appliances. It is for use only by technically experienced users, such as network administrators or network systems management coordinators. Please refer questions about how to use SNMP to your network administration and IT staff. Double-click the SNMP icon to open the SNMP Configuration window.
Upgrade Use the Upgrade icon to check or upgrade Advanced View and BotzWare version installed on your appliance. Double-click the Upgrade icon to open the Appliance Upgrade window. The Current Version of BotzWare is displayed. Click Check APC-MGE Website to check for an updated version of Advanced View or BotzWare. The BotzWare and User Interface versions are displayed, as well as the most current versions available from the Web site. Check the components you want to upgrade and click OK.
Users Use the Users icon to configure user accounts for personnel that are permitted access to your appliance. Each user account has a specific User name and Password, as well as an account-specific Privilege Set. The Privilege Set determines what appliance features the account can access. The available Privilege Sets are as follows: Privilege Set Description Administrator Gives user access to all information and configuration icons.
By default, your appliance comes pre-configured with two User accounts: • Guest: Available to users that do not provide a User name and Password at login. By default, a Guest has an access Privilege Set of None. • Administrator: Accessed by providing the default User name and Password at login. This user account has an unchangeable Privilege Set of Administrator.
Lost password recovery To recover from a lost password: 1. Locate the reset switch on the appliance. 2. Using a thin wire such as a paperclip, press and hold down the reset switch for ten seconds. This will cause the system to reboot. 3. Once the system reboots, you have two minutes to log in using the following default login values: a. For Advanced View • User ID: apc • Password: apc b. For the console • User ID: root • Password: apc 4.
Advanced View: Defining Thresholds The appliance uses analog sensors and state sensors. Analog sensors report sensor readings as a value within a range of potential values defined by a minimum and maximum value, such as temperature or humidity readings. If the value reported by a sensor exceeds the specified threshold, an alert condition is reported. State sensors report sensor readings as one of two mutually exclusive states, such as a door being open or closed.
If you 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”).
Defining State Thresholds To define a threshold: 1. Double-click the Camera Pods, Sensor Pods, or Scanned Devices icon. 2. Click Sensors... to open the Sensor Configuration window. 3. To define a threshold, select a sensor from the Sensors list. Defined thresholds for the sensor, if any, appear in the Thresholds list. 4. Click Add... to open the Select Threshold Type window. 5. Select the threshold to define and click OK. The Add Threshold window opens. 6. Type a name for the threshold in Threshold name. 7.
Advanced Threshold Settings All Advanced threshold settings are optional. From the Advanced tab in the Add Threshold window: 1. In Return To Normal Delay, specify the number of seconds that must pass after this threshold returns to normal before the threshold state is considered normal. The default value is 0 indicating that the state is considered normal immediately after the measured value is no longer violating the threshold. 2. Set an Advanced Schedule for this threshold (optional).
Advanced View: Creating Alert Actions The information that must be provided for an Alert Action depends on which alert notification method you have selected.
Creating a call web services alert receiver alert action The Call Web Services Alert Receiver alert action is an advanced functionality alert action that is specifically designed for use with the BotzWare Web Services Interfaces. BotzWare Web Interfaces are intended to provide a set of common, programmer-friendly APIs to third-party product and solution developers, as well as customers. For more information on the BotzWare Web Services Interfaces, see the BotzWare V3.
Creating a play custom audio alert action To create an Alert Action to use Play Custom Audio alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Play Custom Audio Alert and click OK. 4. Enter a name for this alert action in Alert action name. 5. Specify Advanced Scheduling (optional). By default, all Alert Actions are active 24 hours a day, 7 days a week.
Creating a send custom HTTP GET alert action To create an Alert Action to use Send Custom HTTP GET alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send Custom HTTP GET and click OK. 4. Enter a name for this alert action in the Alert action name field. 5. Select the language and territory using the Locales drop-down list. 6. Specify Advanced Scheduling (optional). By default, all Alert Actions are active 24 hours a day, 7 days a week.
Example target URLs. When creating a Send Custom HTTP GET alert action, a data handling application such as CGI script, ASP script, or servlet, for example, must be invoked on the Web host invoked in the Target URL, and data must be passed to the application in the proper format. The content of the Target URL field depends on the configuration of the target server which processes the HTTP GET. The following examples demonstrate two possible ways in which this alert action could be configured. Example #1.
Creating a send custom text file to FTP server alert action To create an Alert Action to use Send Custom Text File to FTP Server alert notification method: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send Custom Text File to FTP Server and click OK. 4. Enter a name for this alert action in the Alert action name field. 5. Select the language and territory using the Locales drop-down list. 6. Specify Advanced Scheduling (optional).
Creating a send-data-to-FTP-server alert action To create an Alert Action to use the Send Data to FTP Server alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send Data to FTP Server and click OK. 4. Enter a name for this alert action in the Alert action name field. 5. Select the language and territory using the Locales drop-down list. 6.
files with this name, followed by the .n.jpg file extension, where n is the picture number (for example: 1, 2, 3). The Target Directory and Base Filename fields accept BotzWare macros. For more information on macros supported by BotzWare see “BotzWare Macros” on page 115. 13. Use the Advanced tab to provide information for delivering the data to a backup FTP server. This backup server is used only if attempts to deliver the alert data to the primary FTP server fail. 14.
Creating a send e-mail alert action To create an Alert Action to use Send E-Mail alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send E-mail and click OK. 4. Enter a name for this alert action in the Alert action name field. 5. In Maximum Camera Pictures, enter the maximum number of available images included with the generated data.
the Advanced tab and check Minimize Header Usage. 15. To specify the format in which captured images are sent, select the Advanced tab and select the format from Picture Export Format. Send images captured by the appliance cameras as JPEGs, M-JPEG AVI Files, or Signed M-JPEG AVI files. M-JPEG AVI files are motion picture files played using standard media player software such as Windows Media Player.
Creating a send HTTP post alert action To create an Alert Action to use Send HTTP Post alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send HTTP Post and click OK. 4. Enter a name for this alert action in the Alert action name field. 5. Select the language and territory using the Locales drop-down list. 6. In Maximum Camera Pictures, enter the maximum number of available images included with the generated data.
Creating a send short message e-mail alert action To create an Alert Action to use Send Short Message E-Mail alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send Short Message E-Mail and click OK. 4. Enter a name for this alert action in the Alert action name field. 5. Specify Advanced Scheduling (optional). By default, all Alert Actions are active 24 hours a day, 7 days a week.
8. In the Advanced tab: a. If you do not want e-mail notifications sent when sensor readings return to a normal state, check Do Not Send Return-To-Normal Messages. b. To include only the header information necessary to ensure delivery of the e-mail message, check Minimize Header Usage. c. Specify a Message Size Limit (bytes) for e-mail messages generated by this alert action. d. Click to Send Both HTML and Plain Text Message. 9. Click OK to save this Alert Action.
Creating a send SNMP v3 inform alert action To create an Alert Action to use Send SNMP v3 Inform alert notification: 1. Double-click the Alert Actions icon. 2. Click Add... to open the Add Alert Action window. 3. Select Send SNMP v3 Inform and click OK. 4. Enter a name for this alert action in Alert action name. 5. Specify Advanced Scheduling (optional). By default, all Alert Actions are active 24 hours a day, 7 days a week.
6. Check the alert Severities that apply to buttons to be activated. 7. Select a switch relay device generated by this alert action from Beacon Output Device. All switch relay devices defined for use with this appliance appear in this selection list. 8. Select the state of the beacon when an alert occurs from Switch Beacon on Alert. 9. In New Beacon State on Return-to-Normal, select the state of the beacon when the violated threshold returns to a normal state. 10. Click OK to save this Alert Action.
Creating a set switch output state alert action To create an Alert Action to use the Set Switch Output State alert notification: 1. Double-click the Alert Actions icon to open the Alert Action window. 2. Click Add to open the Select Notification Method window. 3. Select Set Switch Output State and click OK. 4. Enter a name for this alert action in Alert action name. 5. Specify Advanced Scheduling (optional). By default, all Alert Actions are active 24 hours a day, 7 days a week.
BotzWare Macros This appendix defines the macros supported by BotzWare. Note: Macros are case-sensitive and must be entered exactly as shown. Appliance Macros The following macros are supported for attributes that support Appliance macros: Macro Definition Example ${SERIAL} The serial number of the appliance. 5A0806V0014 ${IP} The dotted-decimal IP address of the appliance. 192.168.2.23 ${HOSTNAME} The hostname of the appliance. testbot.netbotz.com ${MODEL} The model of the appliance.
Macro Definition Example ${ROOM} The room (specified in the Location settings) for the appliance. ${ROOMROW} The row within the room (specified in the Location AA settings) for the appliance. ${ROOMCOL} The column within the room (specified in the Location settings) for the appliance. 25 ${HEIGHT} The height above the floor (specified in the Location settings) for the appliance. 60 ${BLDG} The building (specified in the Location settings) for the appliance.
Alert Macros Alert macros access attributes particular to the alert being processed at the time the macros are resolved. The following macros are supported for attributes that support Alert macros: Macro Definition Example ${SENSORLUID} The locally unique ID of the sensor generating the alert. TEMP1 ${SENSORGUID} The globally unique ID of the sensor generating the alert. B000113_TEMP1 ${ALERTTYPE} The type of alert. HIGHERR ${SENSORTYPE} The type of sensor generating the alert.
Macro Definition Example ${ALERT_LEVEL} The name of the specific alert First Alert Level, sequence that caused the alert to be Second Alert Level generated. Corresponds with the Label value of the alert sequence. ${CURRENT_ALERT_NUM} The number of times the alert 0, 1, 2 sequence repeated, from 0 up to the Repeats value for the alert sequence. ${ISACTIVE?yes?no} Specifies custom active vs. return to normal active and cleared text. The strings yes and no can be replaced with user-specified strings.
HTTP Post/FTP Data Delivery Parameters Common Parameter Definitions HTTP posts and FTP data files generated by NetBotz devices include a common set of parameters. These parameters identify the specific device generating the alert or sensor notification. The common parameter definitions include: Parameter Name Parameter Definition BOTZSERIAL The serial number of the NetBotz device (i.e. 00:02:DF:00:00:1C) BOTZIP The IP address of the NetBotz device, in dotted decimal format (i.e. 192.168.1.
Parameter Name Parameter Definition BOTZLOC_SLOTLOCATION Slot ID within enclosure where NetBotz device is located, if any. BOTZLOC_ROOM Room number where NetBotz device is located, if any. BOTZLOC_ROOMROW Row within room where NetBotz device is located, if any. BOTZLOC_ROOMCOLUMN Column within room where NetBotz device is located, if any. BOTZLOC_HEIGHTABOVEFLOOR Height above floor of NetBotz device, if known. BOTZLOC_BUILDING Name of building containing the NetBotz device.
Parameter Name ALERTTYPE Parameter Definition The general type of condition being reported through the alert. Currently defined types include: • ERROR - general error • HIGHERR - value too high error • LOWERR - value too low error • RTN - value returned to normal • UNPLUGGED - sensor unplugged • REPLUGGED - sensor plugged in • OFFLINE - device offline • ONLINE - device online Future values will be restricted to 16 characters.
Parameter Name ALERTSENSORVALUEUNITS Parameter Definition The units used for the sensor value. Currently defined units include: • NONE - None • DEGREESC - Degrees C • DEGREESF - Degrees F • PERCENT - Percent • FT_MIN - Feet/Minute • M_MIN - Meters/Minute • AMPS - Amps Future units values are limited to 8 characters. ALERTSENSORLABEL The label associated with the specific sensor. This field is limited to 64 characters. AGENTIP The dotted decimal IP address of the device being monitored.
Parameter Name Parameter Definition ALERTSENSORLOC_ROOMROW Row within room where the alarming sensor is located, if different than the NetBotz device. ALERTSENSORLOC_ROOMCOLUMN Column within room where alarming sensor is located, if different than the NetBotz device. ALERTSENSORLOC_HEIGHTABOVEFLOOR Height above floor of alarming sensor, if different than the NetBotz device. ALERTSENSORLOC_BUILDING Name of building containing the alarming sensor, if different than the NetBotz device.
Picture Alert Parameter Definitions HTTP posts and FTP data files generated by NetBotz devices for alert notifications that include pictures include additional parameters for encoding the pictures. If the picture alert notification is an HTTP post, the encoding of the post is multipart/form-data (as defined by RFC 2388), as opposed to application/x-www-form-urlencoded.
Parameter Name Parameter Definition NOTIFYEMAILS A comma-separated list of e-mail addresses typically notified by the NetBotz device. Value corresponds to the Primary E-mails field, and must be less than 256 characters total. BOTZWAREVER The version and build of the BotzWare application running on the NetBotz device. Must be 32 characters or less. NUMSENSORS The number of sensor attributes to be included in the sensor data notification.
Parameter Name SENSORVALUEUNITS_n Parameter Definition The units used for the sensor value. Currently defined units include: • NONE - None • DEGREESC - Degrees C • DEGREESF - Degrees F • PERCENT - Percent • FT_MIN - Feet/Minute • M_MIN - Meters/Minute • AMPS - Amps Future units values are limited to 8 characters. SENSORLABEL_n The label associated with the specific sensor. This field is limited to 64 characters. SENSORTHRESHSTATE_n The state of the threshold associated with the specified sensor.
Parameter Name Parameter Definition SENSORLOC_ROOMCOLUMN_n Column within room where specified sensor is located, if different than the NetBotz device. SENSORLOC_HEIGHTABOVEFLOOR_n Height above floor of specified sensor, if different than the NetBotz device. SENSORLOC_BUILDING_n Name of building containing the specified sensor, if different than the NetBotz device. SENSORLOC_FLOOR_n Floor number where the specified sensor is located, if different than the NetBotz device.
Example Data From HTTP Posts Alert post (no pictures) The following text is representative of a typical alert post (in this case, for a high temperature alert). The Alert Post URL setting was http://192.168.1.218:81/sensoralert, and no user ID or password was provided. POST /sensoralert HTTP/1.1 Host: 192.168.1.218:81 User-Agent: NetBotz/1.1.
This post has the following corresponding attribute values: BOTZSERIAL=00:02:D3:12:34:56 BOTZIP=192.168.1.233 BOTZHOSTNAME=mikebot.netbotz.
192.168.1.233 ------------------------------000000193AAD31E8 Content-Disposition: form-data; name=“BOTZHOSTNAME” mikesbot.netbotz.
------------------------------000000193AAD31E8 Content-Disposition: form-data; name=“NUMBEROFPICS” 2 ------------------------------000000193AAD31E8 Content-Disposition: form-data; name=“ALERTPPIC_0”; filename=“campic1.jpg” Content-Type: image/jpeg {binary data for picture} ------------------------------000000193AAD31E8 Content-Disposition: form-data; name=“ALERTPICTIME_0” 984450623 ------------------------------000000193AAD31E8 Content-Disposition: form-data; name=“ALERTPPIC_1”;filename=“campic2.
This post has the corresponding attribute values: BOTZSERIAL=00:02:D3:00:01:01 BOTZIP=192.168.1.233 BOTZHOSTNAME=mikesbot.netbotz.com BOTZLOCATION= BOTZMODEL=RackBotz303 BOTZTIME=984450632 ALERTTIME=984450620 ALERTTYPE=HIGHERR ALERTSENSORGUID=00:02:D3:00:01:01/DOOR ALERTSENSORTYPE=DOOR ALERTSENSORVALUE=OPEN ALERTSENSORVALUEUNITS=NONE ALERTSENSORLABEL=Door NUMBEROFPICS=2 ALERTPPIC_0=JPEG file named campic1.jpg with provided binary data ALERTPICTIME_0=984450623 ALERTPPIC_1=JPEG file named campic2.
Periodic sensor data post The following is an example of a periodic sensor data post. The configured URL was http:// 192.168.1.218:81/sensordata?userparm=mydata, with no provided user-ID or password. Note that this post includes a custom parameter provided by the user (userparm=mydata), which could be used by the end-user to provide additional attributes to the Web server. Also, the periodic sensor data post was configured to execute once per minute. POST /sensordata HTTP/1.1 Host: 192.168.1.
The corresponding parameters for this post are: userparm=mydata BOTZSERIAL=00:02:D3:00:01:01 BOTZIP=192.168.1.
SENSORTYPE_4=DOOR SENSORVALUE_4=OPEN SENSORVALUEUNITS_4=NONE SENSORLABEL_4=Door NUMSENSORS=5 Example Data From FTP Data Delivery Files Alert notification (including pictures) The following text is representative of the contents of a typical FTP alert notification file (in this case, for a door sensor alert). The name of the file is determined by the Base Filename value specified in the Edit FTP Periodic Report window, with a filetype of .nbalert (for example, RackBotz1.nbalert).
ALERTPPIC_1=campic2.jpg ALERTPICTIME_1=1001374737 ALERTPPIC_2=campic3.jpg ALERTPICTIME_2=1001374740 ALERTPPIC_3=campic4.jpg ALERTPICTIME_3=1001374743 ALERTPPIC_4=campic5.jpg ALERTPICTIME_4=1001374746 ALERTPPIC_5=campic6.jpg ALERTPICTIME_5=1001374749 ALERTPPIC_6=campic7.jpg ALERTPICTIME_6=1001374752 ALERTPPIC_7=campic8.jpg ALERTPICTIME_7=1001374755 ALERTPPIC_8=campic9.jpg ALERTPICTIME_8=1001374757 ALERTPPIC_9=campic10.
Periodic sensor data notification The following text is representative of the contents of a typical FTP sensor data notification file. The name of the file is determined by the Base Filename value specified in the Edit FTP Periodic Report window, with a filetype of .nbsensor (for example, RackBotz1.nbsensor). Also, the periodic sensor data notification was configured to execute once every 15 minutes. For more information on the Base Filename value, see “Configuring periodic FTP reports” on page 58.
SENSORVALUEUNITS_2=FT_MIN SENSORLABEL_2=Airflow SENSORTHRESHSTATE_2=DISABLED SENSORGUID_3=B00011D_AUDI SENSORTYPE_3=AUDI SENSORVALUE_3=0 SENSORVALUEUNITS_3=NONE SENSORLABEL_3=Audio SENSORTHRESHSTATE_3=DISABLED SENSORGUID_4=B00011D_DOOR SENSORTYPE_4=DOOR SENSORVALUE_4=Open SENSORVALUEUNITS_4=NONE SENSORLABEL_4=Door Switch SENSORTHRESHSTATE_4=DISABLED SENSORGUID_5=B00011D_CMOT SENSORTYPE_5=CMOT NetBotz Appliance User’s Guide 138
Overloaded Appliances: Symptoms and Solutions Symptoms Some symptoms of an overloaded or busy appliance include: • HTTP time-out errors that occur while submitting configuration updates in Advanced View. • A significant delay between the time at which the alert condition occurred and the time at which the alert notification was delivered, based on the time of the alert noted in the notification. • Audio clips and/or camera clips associated with an alert notification are missing.
Solutions If your appliance has become overloaded, the following configuration adjustments will help alleviate the load on the appliance: • If you are using the Scanned Devices functionality, increase the scan interval. For information on the Scanned Devices functionality, see “Scanned Devices” on page 43. For details on increasing the scan interval, see “Adding, editing, and removing SNMP targets” on page 45. • If you are using Scanners, disable MIB2 scanning on devices.
the appliance is configured to generate alert states and send alert notifications as efficiently as possible. • When viewing alerts in Advanced View, setting the refresh interval to None or to a high refresh interval allows a heavily-alerting appliance to load its list of alerts more efficiently. • Do not leave Advanced View and/or Basic View up and running with the Cameras view selected when it is not being used. Streaming of interactive camera pictures from appliances consumes appliance resources.
Camera Usage Considerations Use the table below to help you choose camera settings. Note that actual image file size is dependent on the amount of detail in a given image. Images with a lot of activity and detail have larger file sizes than images with low light, few details, or little activity. Resolution Maximum Frame Rate at Normal Quality Maximum Frame Rate at High Quality Approximate Image File Size 160x120 30 frames per second 30 frames per second 1.
Verifying Signed M-JPEG AVI Files NetBotz has included a simple command line utility that lets you 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. In Windows installations, AVIVRFY.BAT appears as avivrfy.bat and in Linux installations, as avi-vrfy.
Radio Frequency Interference Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the user’s authority to operate this equipment. USA — FCC 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. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment.
APC Worldwide Customer Support Customer support for this or any other APC product is available at no charge in any of the following ways: • Visit the APC Web site to access documents in the APC Knowledge Base and to submit customer support requests. – www.apc.com (Corporate Headquarters) Connect to localized APC Web sites for specific countries, each of which provides customer support information. – www.apc.com/support/ Global support searching APC Knowledge Base and using e-support.
