AutoNOC 2.5 User Guide
Preface
Acknowledgements
System Requirements
Legal

Part 1 - Introduction
1.1 The Ideal Difference
1.2 Automated Operations
1.3 Services & Scaler
1.4 Acquisition Stacks
1.5 Portal Deployment
1.6 Discovery and Crawler
1.7 Monitoring Agents
1.8 Recoiling Database
1.9 Multiple Languages
1.10 Security

Part 2 - NOC Views
2.1 Investigate
2.2 Observe
2.3 Visualize
2.4 Alarms
2.5 Analyze
2.6 Design
2.7 Configure

Part 3 - Model Design
3.1 Object Model
3.2 Devices
3.3 Sets
3.4 Set Criteria
3.5 Probes
3.6 Logs & Events
3.7 Alarms
3.8 Actions
3.9 Reports
3.10 Users
3.11 Polling
3.12 Service Levels
3.13 Dependencies
3.14 Performance

Part 4 - Developer Features
4.1 Adding SNMP MIBs
4.2 Variables
4.3 OSP API
4.4 Probe Template
4.5 Log Template
4.6 Device Template
4.7 Interface Template
4.8 Rebranding

Part 5 - Troubleshooting
5.1 General Issues
5.2 Linux
5.3 Windows

Appendix
A.1 OSP API Functions
A.2 Variables
A.3 Object Reference

3.8 Actions
Alarms in AutoNOC can be setup to execute user actions when certain conditions are met. When an alarm is triggered an action object is spawned and processed. When you open the alarm dialog, you should see a screen that resembles the following.

To create an action, select the desired action and click on the icon to create it. When the conditions for the alarm to fire are met, all actions will be fired.

3.8.1 Send E-Mail Action
A commonly used alarm action is AutoNOC's ability to author and send custom e-mail messages when alarms turn on and off. The settings for the e-mail action are shown below:

Every User Account which is set up under Users on the Configuration page can have an e-mail address specified for it. Create a Set of users and then pick this set in the To User Set drop down box and AutoNOC will send a custom e-mail to each user in the set. The user set field can be left empty.

Additionally, an e-mail can be sent to e-mail addresses directly by specifying the e-mail address in the To field, such as "support@autonoc.com".

The Message Body field is actually an expression that is processed by AutoNOC's interpreter and can contain sophisticated information. The interpreter can even process and solve mathematical expressions! For complete information on the interpreter see 4.3 - Interpreter.

3.8.2 Send Pager Message Action
On some systems with modems installed, AutoNOC is able to use the industry standard TAP protocol to solve and send alphanumeric pager messages directly to pagers and cellphones. To make this work the user will need a pager gateway and pin number. As with e-mail, these settings can also be done on a user set basis as shown in the following action dialog box.

An alternative method that some customers have used on the Linux platform to generate alphanumeric pager messages is to configure the Application Launch Action described below and spawn the public domain QuickPage application. This application can be downloaded at http://www.qpage.org.

3.8.3 Play Sound Action
AutoNOC can also play sound files when alarms turn on and off. These are easily setup as an action by specifying a Wave Audio File as shown in the following dialog box:

3.8.4 Launch Application Action
A useful and powerful alarm action is the application launch action. The user needs to provide a custom executable, execution directory, and desired argument expression to set this up as shown in the following dialog.

When firing this action, AutoNOC will switch to the specified directory, solve the arguments as an AutoNOC expression within the scope of the object that triggered the alarm, and launch the executable (or script) with the arguments.

Many different actions are possible using the application launch capability.

3.8.5 Results Page
Every action has a results page. This page contains the script or console output from the last attempted launch of the action. This page is helpful for debugging problems such as e-mail server issues. The following screenshot shows an example of an e-mail action session:

pic_actions_results.png (58288 bytes)

Note that this screen is refreshed when the dialog box for the object is opened. To refresh the display, close the dialog and then click on the action object again to reopen it.

3.8.6 Manual Launch
Every action includes the ability to perform a test launch of the action. The test launch can be performed on the Menu tab of the action. When a manual launch is performed AutoNOC will fire the object off for testing purposes as if the alarm had just fired.

This is a helpful feature in debugging alarm action launch situations.

(C) 2007 - All Rights Reserved - AutoNOC LLC
      Call me!