MarkVision Messenger can be configured to send SMTP e-mails when an action is triggered, execute command lines on a remote host or the MarkVision Server, or send status alerts to a Tivoli event server. You must set up the SMTP mail server and Tivoli event adapter before MarkVision Messenger can be configured to send SMTP e-mails or Tivoli status alerts.
When an action is triggered, MarkVision Messenger sends an e-mail to specified addresses. The e-mails are highly customizable from within MarkVision Messenger. For example, an action triggered by a Folder Alert event, can send an e-mail to an administrator when monitored printers enter a Low Toner folder. Configure the e-mail message to list attributes such as: the printer model, IP address, and the time when it entered the Low Toner folder.
From the MarkVision Messenger Home screen, click SMTP Setup.
Enter the mail server information in the SMTP Mail Server box.
Enter the e-mail information in the From box.
If SMTP authentication is required, select My server requires me to login to send e-mail, and then type your SMTP user credentials in the Login and Password fields.
Click Done to return to the MarkVision Messenger Home screen.
| Note: Messenger can only communicate with SMTP servers that are running on the default TCP 25 port. |
When an action is triggered, it executes a command line on a remote host server. In order to execute command lines on a remote host server, the Remote Execution (REXEC) client must connect to a REXEC server on the remote host server. You can specify whether to perform commands conditionally or repeatedly, and how to execute them.
The action can execute its command.
Only after a specified delay period:
For example, if the action sends an e-mail message when a printer goes offline, you can delay the execution of the command for a specified amount of time. Then, if the printer returns online during the delay period, the e-mail will not be sent.
After additional conditions have been met.
For example, if the action is triggered by a Paper Tray Missing event, but you only want to execute the command when the event occurs for Tray 3, you can write a custom filter to specify that the action only respond when Tray 3 is removed from monitored printers.
MarkVision Messenger contains a custom event adapter that integrates with Tivoli's event management console. This event adapter lets administrators use the Tivoli event console to monitor printer events across a range of devices in real time. In order for Tivoli to display printer events, you must first set up the Tivoli event adapter by creating an action in MarkVision Messenger.
The Tivoli event adapter lets administrators monitor printer events across a range of devices in real time. In order to send device status alerts to Tivoli, create an action in MarkVision Messenger.
From the MarkVision Messenger Home screen, click Create New.
Type a name and description for the adapter, and then click the right arrow.
Select Device Status Alerts as the alert type, and then click the right arrow.
Select the type of event that will trigger the action from the Event list, and then use the arrow buttons to move the event to the Selected Events box.
Click the right arrow.
Choose the method of device selection, and then click the right arrow.
Select Send Device Status Alerts to a Tivoli Event Server from the dialog, and then click the right arrow.
Type the Tivoli configuration settings, and then click the right arrow.
Specify the filter settings, and then click the right arrow.
A summary of the action is displayed. If you are satisfied with the action, click Yes, and then click the right arrow to enable the Tivoli event adapter.
| Note: After a Tivoli event adapter is created in MarkVision Messenger, configure the Tivoli server for MarkVision Messenger alerts. Refer to the Tivoli documentation for information about configuring the Tivoli server. |
When triggered, an action executes a command line. For example, to keep a log of offline devices, configure an action to respond to the "Offline" Device Status Alert. Each time a monitored device goes offline, the specified information is written to a text file. The information MarkVision Messenger writes to this text file is highly customizable. For example, you can specify that the text file lists the device model, page count, and the time at which it went offline.
An action causes a command to execute when an event occurs. MarkVision Messenger prompts for several types of information during action creation.
From the MarkVision Messenger Home screen, click Create New.
Complete the following steps in the Configure Action dialog:
Name and describe the action.
Set user access.
Select the type of events that will trigger the action.
Select the events or folders that will trigger the action.
Select which devices to monitor.
Select the type of command to execute.
Compose the command and any parameters for the event(s).
Select or create a filter for the events.
Review the action information.
| Note: To stop previewing the choices, select Do not display this screen again. |
Click the right arrow to continue.
When an action is named, the name appears in the Action list on the MarkVision Messenger Home screen.
From the Description Information screen, type a unique name for the action in the Name box.
Enter a more detailed description about the action and what it does in the Description field.
Enter additional information associated with the action in the Notes field.
Click the right arrow at the bottom of the screen to continue.
Notes:
This screen only appears if user accounts have been created in MVP
Select Public to make the action available to all users.
Select Private to associate the action only with your account.
| Note: A private action does not require a special access password from within MarkVision Messenger. However, since it is associated with the user name used to create it, the action is only accessible to that specific user. |
Click the right arrow to continue.
Specify which type of event the action will monitor:
From the Event Type dialog, choose Device Status Alerts or Device Folder Alerts.
Click the right arrow at the bottom of the screen to continue.
Depending on the selected event type, specify which folders or Device Status Alerts the action will monitor. If the action is triggered by a Device Status Alert, add or remove events from the Selected Events list. If the action is triggered by a Printer Folder Alert, select a folder and then continue to the next step.
From the Events dialog, add an event to the Selected Events list:
From the Events dialog, choose whether to sort the events by Type or Severity.
Select a category from the Categories list.
Select the event and then use the arrows to add or delete events to the Selected Events list:
Click the left arrow to delete the events from the list.
Click the right arrow to add events to the list.
Click the right arrow set to add all events to the list.
Click the left arrow set to delete all events from the list.
Click the right arrow at the bottom of the screen to continue.
Select a folder.
Click the right arrow at the bottom of the screen to continue.
Specify which devices to monitor. MarkVision Messenger provides a list of all available devices capable of producing the selected events.
From the Event Sources dialog, select one of the following settings:
Monitor All Devices on the MarkVision Server
Monitor Devices in a Specified Folder
Monitor Selected Devices
If Monitor Selected Devices is specified, select devices to monitor:
Click Select All to select all devices currently in the Selected Devices list.
Click Deselect All to remove all devices selections from the Selected Devices list.
Click the right arrow at the bottom of the screen to continue.
Specify in MarkVision Messenger which type of command the action will execute.
From the Command Type dialog, make one of the following choices:
Send SMTP E-mail
Execute a command line on a remote host
| Note: This option requires the presence of a REXEC server on the remote host. |
Execute a command line on the MarkVision Server
| Note: You must be logged in as the MarkVision administrator to select this option. |
Send Device Status Alerts to a Tivoli Event Server
| Note: This option is only available if the Device Status Alert option is selected. |
Click the right arrow at the bottom of the screen to continue.
Follow the appropriate instructions below according to the command type you selected in the previous step.
If the SMTP mail server information is not set up, MarkVision Messenger will prompt for the mail server and mail path information. Type the requested information, and then click the right arrow to continue.
Type the recipient's e-mail address in the To box. Separate multiple e-mail addresses with commas.
Type optional e-mail addresses in the Cc box. Separate multiple e-mail addresses with commas.
Type the purpose of the e-mail in the Subject box.
Type an e-mail message in the Body box.
Add keyword(s) to any text box by:
Selecting a keyword from the Keywords list, and then clicking right arrow next to the appropriate text box.
Typing the parameters directly into the text box
Click the right arrow at the bottom of the screen to continue.
Type the remote host information in the Hostname, Username, and Password boxes.
Type the name of an executable command in the Command Path box.
Add keyword(s) to the Command Line Parameters box by:
Selecting a keyword from the Keywords list, and then clicking right arrow beside the command line box.
Typing the parameters directly into the text box.
Click the right arrow at the bottom of the screen to continue.
Type the name of an executable command in the Command Path field.
Add keyword(s) to the Command Line Parameters field by:
Selecting a keyword from the Keywords list, and then clicking the right arrow beside the command line box.
Typing the keyword directly into the text box.
Click the right arrow at the bottom of the screen to continue.
If you have not previously entered the Tivoli configuration settings:
Type the Tivoli server location.
Type the server port.
Type the path of your event buffer file.
Click the right arrow at the bottom of the screen to continue.
| Note: If you have already entered Tivoli server settings, you will be directed to the next step. |
Select a filter.
If the action is triggered by a Device Status Alert:
Choose Trigger on Active to set the command to execute only when a condition becomes active.
| Note: The execution of the command can be delayed until the condition has been active for a specified amount of time. |
Choose Trigger on Either Active or Clear to set the command to execute each time a condition becomes active or clear.
Choose Custom to customize and define when the command executes, and then upload an existing script file or write a new one.
If the action triggered by a Printer Folder Alert:
Choose Simple Filter to set the action to execute when a device is added to the folder, removed from the folder, or both.
| Note: The execution of the command can be delayed until the condition has been active for a specified amount of time. |
Choose Custom to define when the command executes, and then upload an existing script file or write a new one.
| Note: If you selected Custom, click Next, to set up a custom filter. |
Click the right arrow at the bottom of the screen to continue.
Verify all action information.
Review the summary in the text box.
| Note: Information cannot be altered from the text box. To make changes, click the left arrow, and change the information from the appropriate dialog. |
Click Yes to enable the action or No to disable the action.
| Note: To cancel the creation of an action, click the up arrow to return to the MarkVision Messenger Home screen without creating an action. |