Device Engines

Device Engines are components that deliver notifications to different types of Devices and, where applicable, receive and process two-way replies and relay them to AlarmPoint.

Each Device Engine implements a different protocol, and each protocol requires a dedicated Device Engine. When the Device Engine is started, the protocol will be passed as a parameter and the Device Engine runs in that protocol mode.

To view and manage Device Engines:
  1. Click the Administration tab.
  2. In the Administration menu, click Nodes & Device Engines.
  3. In the All Nodes table, click the Device Engines link in the View Components column for the Node you want to modify.
    1. The Node Components page displays a list of any Device Engines assigned to that Node.
  1. In the All Components for Node list, do any of the following:
    1. To modify an existing Device Engine, click the name of the Device Engine in the list to view its details. For more information about editing Device Engine details, see the following section, Device Engines.
    2. To remove a Device Engine from the list, select the check box next to the Device Engine you want to remove, and then click Remove Selected.
    3. To add a new Device Engine, click the Add New link, and then select the type of Device Engine you want to add from the drop-down list. Click Continue to specify the details for the new Device Engine. For more information about the types of Device Engine, and the specific details for each type, see the tables in the following section, Device Engines.

Starting and stopping Device Engines

You can start or stop a Device Engine at any time.

To start or stop a Device Engine:
  1. On the Nodes & Device Engines page, in the All Nodes table, click the Device Engines link for the Node you want to modify.
  2. In the All Components for Node table, select the check boxes beside the components you want to stop or start.
    1. You can see the current status of each component in the Activity State column.
  3. Do one of the following:
    1. Click Start Selected Components.
    2. Click Stop Selected Components.

Enabling Device Engine logging

Device Engines in AlarmPoint can create separate log files with details of all their transactions and communications.

You can specify the logging settings for each Device Engine independently, and set the logging details when you add a Device Engine or modify the details for an existing Device Engine. The settings explained in the following table are available on the Details page for each Device Engine:

Device Engine Logging Settings

Detail

Description

Generate Separate Log File

Generates a separate log file for the current Device Engine.

Log Level

Level of detail required for the log files.

Note that more detailed log levels produce log files that cover a smaller window of time.

Expanded MAPI Logging

To assist in troubleshooting MAPI issues, additional logging has been added for the library file used by MAPI Device Engines. Any activity that occurs in alarmpoint_mapi.dll is written to a log file located at:

<AlarmPoint>/logs/mapi_dll_log.txt
 

The maximum size for this log file is 10MB, after which it is rolled over into a single backup file named mapi_dll_log1.txt.

Configuring Concurrent Threads

You can optimize the throughput of your AlarmPoint Node Deployment by configuring the Concurrent Threads settings of the Device Engines. By distributing threads based on the amount of notification traffic each protocol receives, you can balance the workload across the Device Engines that handle the most notifications. For example, if email is the most common notification method, allocate the most threads to your email Device Engines.

Note that if you want to increase the number of concurrent threads to more than 40, you must edit the configuration file, as described in the following section.

Note: Your Active Licenses control the maximum number of threads allowed.