MarkVision™ Professional User’s Guide August 2003 Lexmark and Lexmark with diamond design are trademarks of Lexmark International, Inc., registered in the United States and/or other countries. © 2003 Lexmark International, Inc. 740 West New Circle Road Lexington, Kentucky 40550 www.lexmark.
Edition: August 2003 The following paragraph does not apply to any country where such provisions are inconsistent with local law: LEXMARK INTERNATIONAL, INC., PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you.
Contents Chapter 1: Introduction to MarkVision Professional .................. 6 Introduction..................................................................................................... 6 MarkVision components ................................................................................. 7 Terms used in this document ..................................................................... 8 System requirements .....................................................................................
Changing printer settings ............................................................................. 58 Printer statistics ............................................................................................ 58 Checking printer status................................................................................. 59 Organizing devices ...................................................................................... 59 Viewing a print server's embedded web page...............................
What is MarkVision Messenger?................................................................ 104 How do you create actions? ....................................................................... 105 Where is the README file? ....................................................................... 106 How do I change the MarkVision Web Server port? ..................................
1 Introduction to MarkVision Professional Introduction MarkVisionTM Professional (MVP) is a Web-enabled device management utility designed for IT staff. MarkVision works as a client-server application. The server component is responsible for discovering and communicating with devices on the network and providing information about them to a client. The client is then responsible for displaying information about the devices to a user and providing them with an interface to manage those devices.
• • • • Display devices that meet predefined criteria (such as Toner Low) so you can fix problems before they affect user productivity. Schedule time-intensive activities, such as company-wide device discovery, gathering printer inventory data, or updating print server firmware when network use is at a minimum. Prevent unauthorized access to devices on the network. Download plug-ins for additional device support at runtime. Note: This book is written for administrators.
MarkVision Messenger MarkVision Messenger works with MarkVision Professional to provide technicians with e-mail notification or command line execution when a network printer triggers a pre-defined event (such as Paper Tray Missing, Toner Low, and many more). The heart of MarkVision Messenger is a “service” that runs inside the MarkVision Server. To use this service, the user creates “actions” using a browser-based interface.
MarkVision Server refers to a server that collects data from network-attached printers and provides information to MarkVision clients. Note: Within this document, printers and print servers are in some instances referred to as "devices." System requirements The following are minimum requirements for installing and running MarkVision Professional on your network. These requirements are for both the server and the client, and should be in place before you install MarkVision.
MarkVision Professional for UNIX systems MarkVision Professional for UNIX systems is available for all supported UNIX platforms that provide Java Runtime Environment 1.4 (Java 1.1.x and 1.2.2 are not supported). Supported UNIX systems Operating system Version numbers Hardware IBM-AIX 4.3.3, 5.1, 5.2 IBM RISC System/6000 HP-UX 11.0 Hewlett-Packard 9000/700 and 9000/800 Red Hat Linux 7.1, 7.2, 7.3, 8.0 Intel (IA32) SuSE Linux 7.1, 7.2, 7.3, 8.0 Intel (IA32) Sun Solaris SPARC 2.
Lexmark printers Lexmark E321 Lexmark Optra Se plus Lexmark E322 Lexmark Optra T Lexmark E323 Lexmark Optra W810 Lexmark Optra Lexmark T420 Lexmark Optra C Lexmark T520 Lexmark Optra C710 Lexmark T520 SBE Lexmark Optra Color 40 Lexmark T522 Lexmark Optra Color 45 Lexmark T620 Lexmark Optra Color 1200 Lexmark T622 Lexmark Optra E Lexmark T63X Lexmark Optra Ep Lexmark W812 Lexmark Optra K 1220 Lexmark W820 Lexmark print servers MarkNet™ S MarkNet N2004fl-MTRJ MarkNet Pro 1 MarkNet N
Universal Printer Support (UPS) Brother HL-1470N Series NEC SuperScript 1800 Brother HL-1650 / 1670N Series QMS Magicolor 2 Brother HL-1870N Series QMS Magicolor 6100 Brother HL-2460 Series Ricoh Aficio 180 Canon GP 200D Ricoh Aficio 270 Canon ImageCLASS C2100 Ricoh Aficio 350/355 Canon ImageRunner 330 Ricoh Aficio 450/455 Canon ImageRunner 400 Ricoh Aficio 550 Canon ImageRunner 500 Ricoh Aficio 650 Canon ImageRunner 600 Ricoh Aficio 750 Canon ImageRunner 2800 Ricoh Aficio 850 Canon Im
Universal Printer Support (UPS) HP LaserJet 9000 Series Xerox DocuPrint N2025 HP Mopier 320 Xerox DocuPrint N2125 IBM InfoPrint 20 Xerox DocuPrint N24 IBM InfoPrint 21 Xerox DocuPrint N2825 IBM InfoPrint Color 8 Xerox DocuPrint N32 IBM Network Printer 12 Xerox DocuPrint N3225 IBM Network Printer 17 Xerox DocuPrint N40 Konica KL-3015 Xerox DocuPrint N4025 Kyocera FS-1700 Xerox DocuPrint N4525DX Kyocera FS-1750 Xerox DocuPrint NC60 Kyocera FS-1800 Xerox Phaser 790 Kyocera FS-3750 Xerox
2 Using MarkVision Professional Installing MarkVision Professional Before you install Before you install the MarkVision Server: 1 Make sure you have 70MB of hard disk space available for a complete installation. 2 Decide where to install the MarkVision Server. You must install one MarkVision Server on the network. Note: You may install any of the other packages on the same workstation running the MarkVision Server, although this is not necessary.
• • • Windows Web package Mac OS X Web package UNIX Web package (Java runtime environment is required) When you are installing the MarkVision components, a dialog box will appear that shows the hierarchy in which the different components can be installed. You can install the MarkVision application and the MarkVision Server separately; the application only requires that one instance of the MarkVision Server be installed somewhere on the network, not necessarily on the same machine.
• Web site installation If you chose the Web Installation Package option, the MarkVision Professional Web Installation Package is downloaded to your server. For a successful Web site installation • • The operating system must be supported by MarkVision Professional. You must use a supported web browser. To uninstall MarkVision Professional To remove MVP from a Windows system, select MarkVision Professional in the Add/Remove Programs application.
4 Click Install Software to Local Host. The SD Install-Software Selection screen and Specify Source dialog appear. If these dialog boxes do not appear, go to the Actions menu and click Change Source to open the Specify Source dialog. 5 Make sure that the hostname of the computer that you are installing on appears in the Host Name text box. If it does not, enter the hostname or select it from the list.
15 Click File, and then click Exit to return to the Software Management screen. 16 Enter the following in the command line and answer any questions that may appear: /opt/lexmark/setup.mvjserver This file will set up the MarkVision Server users for use with the MarkVision Professional server. AIX 1 Download the MVP package file from the Lexmark Web site and place the package file in the /tmp directory.
5 Install either all or individual MarkVision components: • To install all MarkVision components, issue the command: rpm -irh *.rpm • To install individual MarkVision Professional components, specify the file name of the MarkVision Professional component that you want to install. For example, to install just the MarkVision Professional Server, issue the command: rpm -irh markvision-pro-MVJserver-*.i386.
MarkVision Server /usr/mv_pro/bin (executable files) /usr/mv_pro/etc (configurable files) /usr/mv_pro/lib (archive/library (JAR) files) Setting up the MarkVision Professional UNIX Server Once the MarkVision Professional package is installed on a system, a setup script must run to complete the installation process. This script is installed at: /setup.mjserver The MarkVision Server must be run as a standard system daemon.
Therefore, the link can be created as follows: # /bin/ln -s /usr/local/java /usr/mvp_java MvService The /usr/mv_pro/bin/MvService command is used to start and stop the MarkVision Professional Server as a Unix daemon. $ man MvService MvWebService The /usr/mv_pro/bin/MvWebService command is used to start and stop the Tomcat Web server. Tomcat is the official reference implementation of the Java Servlet 2.2 and JavaServer Pages 1.1 technologies.
c Export the directory where you installed the MarkVIsion Professional UNIX Client. For example: /opt/lexmark/ or /usr/local/lexmark/ 2 Configure MarkVIsion Professional on the local workstation. a Make sure you’re logged on with root user authority. b NFS mount the MarkVision Professional directory from the server (Refer to your operating system documentation for mounting instructions). c Run the install script in the mounted MarkVision Professional directory.
After removing all the previously mentioned MarkVision packages (if one or more were installed), some directories may need to be removed manually. To see if any directories remain after removing all the MVP packages, check the directory where you installed MarkVision. By default, MVP installs in either /opt/lexmark/ or /usr/local/lexmark/. Installing MarkVision Professional into CDE You can integrate MVP into the Common Desktop Environment (CDE). Integrating installs CDE icons, actions, and online Help.
Removing the MarkVision Professional KDE: When removing the MarkVision Professional client package, you must manually remove the KDE snap-in. To uninstall the KDE snap-in, as root, type the following in the command line: # /usr/bin/mark2kde -d Note: MarkVision Professional is currently not supported under KDE 2 environments due to a reported bug in Sun’s Java Virtual Machine 1.3.x. However, the supported Linux platforms under KDE 1 have been found to function correctly.
For example, to appear to install MarkVision Professional in /disk2/lexmark, do the following: 1 Create a directory in the location where you want the packages to be installed. For example, to install the /disk2 file system: mkdir /disk2/lexmark 2 Create a symbolic link pointing to the directory you created. For example: ln -s /disk2/lexmark /opt/lexmark Upgrading from previous versions of MarkVision Prior versions of MarkVision for Windows are easily upgraded by running the installation program.
• • • Configure MarkVision Professional to your specific needs Locate and organize devices across your network Establish a device management strategy that lets you quickly begin working with MarkVision Note: To prevent MarkVision Professional from opening the setup screen at startup, check the Do not show me this setup window again box.
Accessing the MarkVision Web Client Since the MarkVision Web Client is browser-based, you will need to open your browser and point it to the MarkVision URL: http:///markvision In this URL is the IP address or hostname of the machine that is running the MarkVision Server. Note: If during installation you did not make MarkVision Professional the default server on your machine, you must use the non-standard port number (9180) in the URL: http://:9180/markvision.
For example, to start a MarkVision web client on a web server whose IP address is 190.168.112.21, point your browser to the following URL: http://190.168.112.21:9180/markvision To manage your devices with MarkVision Professional After you have configured MarkVision to suit your needs, you can begin exploring the powerful management features that MarkVision has to offer. • Using filters. Use the Filters task to create criteria filters that can be saved and applied to folders. • Using device policies.
Layout The left pane of the MarkVision Professional window is typically used to select one or more devices. You can find the devices you want by using the Quick Find feature or Folders. (See Creating folders for help setting up and populating folders.) Task information for the selected device(s) appears in the right pane. Multi-select capability When you are presented with a list of items, such as printers, you can multi-select them using the Control or Shift key.
All Tasks list The following table briefly describes the tasks available from the All Tasks list. Task Function About View the version information of MarkVision. Add Devices Search networks and add devices to MarkVision Professional. Administrative Settings Change settings regarding how MarkVision Professional obtains information from the server. AppleTalk View or modify the AppleTalk network settings. Application Links Configure external applications to launch from MarkVision.
Task Function Drivers and Utilities (On the Web) Open the Lexmark driver and utilities Web page. E-mail Destinations Create and manage e-mail destinations for selected devices. Emulators View emulator (printer language interpreters) settings for selected printers. Fax (Printer) View or modify a printer's fax settings. Fax Destinations Create and manage fax destinations for selected devices. Fax Settings View or modify the fax settings for a specified device.
Task Function Job Timeout (Print Server) View or modify a device's job timeouts. LexLink View or modify the LexLink network settings. Map Place device icons on a graphical representation of your organization to illustrate the distribution of your printers. MarkVision Messenger Launch Open the MarkVision Messenger application. MFP - Backup Configuration Information Create a backup copy of all configuration settings on MFP device(s).
Task Function PCL View or modify a printer's PCL™ settings. Personal Settings Personalize MarkVision to fit the way you work. Picture of Printer Display a picture of a selected printer. Ports View or modify a device's ports. PostScript View or modify a printer's PostScript™ settings. PPDS View or modify a printer's PPDS settings. Printer Inventory Gather and store information about your printers. Printer Statistics Display statistical data for selected printers in a table format.
Task Function User's Guide Opens the MarkVision Professional User's Guide. User Accounts and User Groups Create or edit individual accounts or account groups to restrict access to certain tasks. Web Page (Print Server) Open a Web page displaying settings for a selected device.
3 Configuring MarkVision Professional Adding and removing devices MarkVision Professional lets you search your network for devices, such as printers and print servers. You can then schedule and configure discoveries to suit your needs. Once devices are "discovered," their locations are stored on the MarkVision Server, and, by default, populate the All Devices folder. To discover devices, you must first create a profile (or profiles) for the devices you want to discover.
value (public), enter the new community names in the appropriate field. The community names are case-sensitive. Note: This changes the MarkVision community name, not the print server community name. To change the print server name, refer to your print server documentation. • • click Include to add the addresses or hostname to the Devices to Include on the Server box. TCP/IP address range Enter the TCP/IP address range, beginning with the From: box and ending with the To: box, and then click Include.
4 MVP communicates with the devices included in the selected profile. To stop a discovery at any time, click Stop Discovery. Note: Performing a discovery with the Full Discovery profile, or any profile that includes all of the devices on your network, requires a large amount of CPU usage. Running a full discovery can render the MarkVision Server virtually unusable while the discovery is executing.
• Number of retries to perform when a device does not respond: This specifies the number of attempted retries before an address is ignored. Setting this value beyond 1 does not normally provide greater accuracy. Setting this value to zero (0) disables retries, which may substantially increase speed with little impact on accuracy. Note: Each Discovery Profile can have its own advanced settings. Import / Export buttons You can use the Import and Export buttons to import or export profiles for discovery.
Adding devices In some situations you may want to discover some devices without creating a profile. In these situations you can use the Add Devices task to discover individual or small groups of devices. To use the Add Devices task: 1 Select Add Devices from the All Tasks menu, or select MarkVision →Device Discovery → Add Devices on the MVP Home screen. 2 Select a specific device or devices from the list of existing devices on the screen, or click Add to enter a new device address, and then click OK.
Creating folders Folders are a way of grouping devices by particular conditions, such as low toner, or by particular options, such as duplexing. By grouping devices in this manner, it is much easier to find the devices you want. MarkVision Professional is shipped with a pre-existing root folder, All Devices, which cannot be deleted. All additional folders you create are listed below this root folder. However, you do not have to create additional folders to use MarkVision.
observe the effected devices. The effort needed by the MarkVision Server to continuously update and repopulate folders can dramatically slow your system. As a result, populating folders based on static criteria saves network resources on larger printer networks. You can also use the Load and Save buttons to import or export a filter set. The Save button saves the filter criteria you have selected as a file which can later be retrieved using the Load button.
When multiple conditions are selected • Clicking the All conditions must be met radio button means that every device must meet every criterion displayed by the filter. • Clicking the At least one condition must be met radio button means that devices must meet only one condition displayed by the filter. Device Type • You can choose to have your filter include printers, print servers, or both. Specify this in the Device Type list box.
3 She clicks New to create another filter criterion, and then selects the following from the Parameter and Operation list boxes. She must manually type in the firmware code (1.10.17). Parameter Operation Value Printer Firmware Code Equal To 1.10.17 4 Since Mary's printers need to meet both conditions, she clicks the All conditions must be met radio button. 5 To save the filter, Mary clicks Save Filter As.
Create a new user account 1 In the Accounts section of the users table, click Add. 2 Enter the account name and password. 3 Confirm the password that you entered. The indicator light to the right of the field turns green and enables the Next button when the password confirmation is entered correctly. 4 Click Next. 5 Select the privileges that will be available to the account from the Available Privileges window. 6 Click the (>) buttons to add or remove the selected privileges to and from the user account.
Create a user group 1 In the Groups section of the users table, click Add. 2 Enter the group name. 3 Select the user accounts that will be assigned to this group. 4 Click Next. 5 Select the privileges that will be available to the user group from the Available Privileges window. 6 Click the (>) buttons to add or remove the selected privileges to and from the user group. 7 Click Next. 8 Select all the devices that the user group will have access to. 9 Click Finish.
Administrator privileges If you decide to create accounts in MarkVision, you are required to create an administrator account. This administrator account is authorized to perform all MarkVision tasks on all devices. Note: If no accounts (administrator or otherwise) are created, all MarkVision users have authorization to perform all tasks.
4 Managing devices Creating custom views With the Custom Views task, you can create multiple views that let you view only the printer attributes you would like to see. To create a custom view 1 Select Custom Views - Create/Manage from the All Tasks menu. 2 Click New. 3 Give the custom view a name. 4 Choose the printer attributes you would like to add to this view by clicking the New Component icon (next to the Name field).
Creating custom tables Custom Tables provide an easy interface with which to view device information. After it has been configured, a custom table can be exported as a comma-separated variable (.csv) file, which can be opened by spreadsheet or word processing software. Creating a custom table 1 Select Custom Tables - Create/Manage from the All Tasks menu. 2 Click New. (To edit an existing custom table, click the table's name.) 3 Give your table a descriptive name.
• Right-click the table to save your changes or reset to the default column and sort order. Note: These changes do not change the table settings as defined in the Custom Tables task; they are unique to each user account. To change the default column and sort order, you must use the Custom Tables task. Using device policies A device policy contains saved printer or print server settings. When a policy is created, it can then be applied to one or more devices.
Apply the device policy Select the Device Policies - Apply task. Select the printers you want to update with the new policy from the device list. If the printers you want to update do not show up in the list, you can search for them. (See Finding the devices you want for help.) Select the device policy you created ("Company Printer Settings") from the Device Policies list and click Apply Policy.
• Remove Devices To schedule a task: When you access the Scheduling task, the scheduling screen appears with a list and calendar showing all presently scheduled events. 1 Select Scheduling from the All Tasks menu or click Actions →Scheduling. 2 Click Add. 3 Select the event you want to schedule and type a description of the event. Click Next. 4 Select the date and time you want the event to take place. You can schedule an event to occur on a daily, weekly, or monthly basis.
• What is the toner level in the printer(s)? Note: The statistical information derived from the Job Statistics task provides you with a reasonable estimate of your printers’ operational status. It is not intended for generating billing statements based on printer performance. Enable Job Statistics 1 Select Job Statistics: Trend Analysis from the All Tasks menu. 2 Select the database you want to use. 3 Enter the username, password, and connection path (URL) for the database you plan to use.
Database Description Access, : SQL Server For example: jdbc:odbc:yourdsn DSN is a Data Source Name, which must be created prior to using Job Statistics or Printer Inventory. Use your ODBC configuration in Windows' Control Panel to create a DSN. Note: Exporting this information through an ODBC interface is only supported in a Windows environment. CSV CSV format provides you the option to export your printer data into a text file formatted to accommodate database fields.
The following table shows the path styles used for each type of database. Database Description Oracle The default is the path to the MarkVision Server. If the database is installed on a different server, change the URL field appropriately, using the path style below: @:: For example: jdbc:oracle:thin:@117.124.46.
• Install New When you click Install New, a dialog box appears that lets you select a plug-in from the directory to be installed on the server. Once a plug-in file has been selected, a confirmation screen appears, containing more specific information about the plug-in(s) that you have selected, and provides you with the option to proceed with installation.
Destination management MarkVision Professional’s destination management tasks provide the ability to more accurately manage the destinations to which the devices on your network send information. MVP provides a destination management task with which you can easily add or edit specific destinations for each protocol that your network devices use to transmit information.
Editing destinations 1 Select one of the four destination management tasks from the All Tasks menu, or select Settings →Destinations from the MVP Home screen. 2 Using either Quick Find, or by choosing a specific device (or devices) from existing folders, select the devices that have the destination types you want to manage. A table will appear in the right side of the screen displaying the existing destinations. If the selected devices have no current destinations, the table will be empty.
Changing printer settings The easiest method of changing printer settings is by selecting the item you want to change from the Settings menu or the All Tasks list. Select one or more printers and change the settings appropriately. You can create a device policy to coordinate multiple settings and save them as a unit. A policy can then be applied to one or more devices at a time, or saved for future use. See Using device policies for more information.
Checking printer status To check printer status, you can select one of the following options from the View menu: • Status of Printer • Toner / Ink Levels • MFP Status • Picture of Printer • Page Counts • Operator Panel LCD • Map • Custom Tables • Custom Views Organizing devices MarkVision lets you organize your devices using folders. When you create or edit folders, you can specify certain criteria to limit which devices are in a folder.
All Devices Subnets 157.175.84.0 (13) 157.175.85.0 (24) 157.175.86.0 (4) 157.175.87.0 (16) Location (46) Building (21) Floor (8) Printer Type(57) Color (12) Mono (45) Duplex (25) Department (37) I/S (9) Accounting (4) Engineering (18) Marketing (6) In this example, one folder groups printers by subnet. Other folders group printers by their location, printer type, or department. Using the built-in filtering feature, the folders show you only the printers matching the criteria you specify.
3 Your browser opens with an information page for that print server. You see a real-time view of the selected printer status. Note: Not all print servers have Web pages. Viewing all printers MarkVision gives you several ways to see all the printers available to you at a glance. Create folders and filters Use the Folder Configuration task to create custom folders to organize your printers. If your printers are on a small network, you may only need one folder.
located. Within that folder, you might create a sub folder for the city. Additional subfolders could contain printers grouped by the building or floor number. Create a corresponding map for each folder. Create maps using any graphics application that saves in JPEG or GIF format. You can create an original image or develop your graphic using a scanned image like an area map or building plan. Save the image in JPEG or GIF format. You can then select the graphic from the Map task in MarkVision.
Moving the MarkVision Server As newer hardware becomes available, it may become necessary to move the MarkVision Professional Server to another machine. Since MarkVision Professional is extremely customizable, you may not want to repeat the process of creating folders, filters, and rediscovering devices. The following steps describe a method of creating a backup of MarkVision Professional's customized data, and integrating that data onto a new machine. 1 Stop the MarkVision Server.
For Windows XP and Windows 2003 Server: 1 Go to Control Panel →Performance and Maintenance →Administrative Tools → Services and select the MarkVision Server. 2 Click Start/Stop. Note: You can use the same process to start or stop the MarkVision Web service.
Finding the devices you want There are numerous ways to find devices using MarkVision. You can search for one device using specific criteria, or multiple devices using a variety of methods. Note: MarkVision only recognizes devices that have been discovered using the Device Discovery task (see Adding and removing devices), or Quick Find by Address.
Flashing print servers Periodically, you may need to rewrite the flash memory inside one or more of your print servers. For example, let's say Customer Support recommends you upgrade to a newer or different version of firmware to solve a network printer problem. You can also flash your print servers to take advantage of new functions available in the latest version of firmware. Use MarkVision Professional to flash multiple print servers simultaneously. Note: Not all print servers are supported.
5 MarkVision Messenger MarkVision Messenger is a utility that lets you create Actions. An Action defines a command to execute whenever an event occurs across a set of devices. Device Status Events are conditions signaled by messages like Paper Tray Missing or Toner Low. Folder Events are signaled when devices enter and/or exit a particular folder. During the installation of MarkVision Professional, you are asked to select the components to install.
• The type of event your Action will monitor • The devices your Action will monitor • The type of command your Action will execute With MarkVision Messenger, you can create Actions to automate many printer administration tasks.
Devices in a Specified Folder If your Action will monitor only a specific folder, choose this option. For example, if you were in charge of devices on the third floor, and had configured a folder on the MarkVision Server that included these devices, you could limit the number of devices your Action monitors by choosing this folder. Selected Devices If your Action will monitor only specific devices, choose this option.
specify that your Action only respond when Tray 3 is removed from monitored printers. See Custom filters for more information. Send device status alerts to a Tivoli event server 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.
• Distribute Conditions: • And (Condition_1...Condition_n) • Or (Condition_1...Condition_n) • EventDataIs (key, value) • SourceDataIs (key, value) • TimeIsAfter As an example, let's look at the script representation of the built-in Trigger on Active filter: IfThen (EventDataIs("state", "ACTIVE")) Distribute The effect of the EventDataIs condition is to ask the event for the value of the event.state keyword. This is the same keyword you can insert into command lines and e-mail messages.
IfThen(EventDataIs("state", "ACTIVE")) Distribute } In this example, And was used to build a compound condition. The While loop is only entered or repeated if the event is active for Tray 3. The code within the loop is the same as the code for the Trigger on Active filter, except the TimeIsAfter condition is set to wait 1200 seconds (20 minutes).
How do I use MarkVision Messenger? Use MarkVision Messenger to create Actions that automatically perform printer administration tasks in response to printer events.
From the Description Information screen: 1 Enter a unique name for you Action in the Name: field. 2 Enter a more detailed description about your action and what it does in the Description: field. 3 Enter instructions associated with your Action in the Notes: field. For example, "Please clear the paper jam." 4 Click when you're ready to continue. Notes: The Name: field is limited to 80 characters. The Description: field is limited to 255 characters. The Notes: field is limited to 255 characters.
Step 5: Select specific events or folder Depending on the Event Type you have chosen, you must now tell MarkVision Messenger either the Device Status Alerts your Action will monitor, or the folder whose events your Action will monitor. If your Action is triggered by a Printer Folder Alert 1 Select a folder. 2 Click when you're ready to continue.
• Select All Devices on the MarkVision Server to monitor all devices, even ones added to the server later. • Select Devices in a Specified Folder to monitor all devices in a specified folder, even ones added to the folder later. • Select Selected Devices to specify which devices to monitor. If you choose Selected Devices, you can: • Click the name of a specific device in the Selected Devices list to select it. • Click Select All to select all devices currently in the Selected Devices list.
Step 8: Compose the command Keywords represent information about your Action, a device, or an event. You can pass this information to your command on the MarkVision Server or a remote host, or choose to embed it in an e-mail message. To send an e-mail message 1 Enter the recipient's e-mail address in the To: field. Make sure you separate multiple e-mail addresses with a comma. 2 Enter optional e-mail addresses in the Cc: field. Make sure you separate multiple e-mail addresses with a comma.
To setup a Tivoli event server To execute this command, see Setting up the Tivoli event adapter. Step 9: Select a filter A filter lets you control commands that execute when events occur. Your filter options depend on the Event Type. If your Action is triggered by Device Status Alerts: • Choose Trigger on Active to set the command to execute only when a condition becomes Active. You can also choose to delay execution of the command until the condition has been active for a specified amount of time.
Notes: • • Click Tips for more information and sample scripts. When you upload a script file, all information in the text field is erased. Make sure you upload the script file first, and then make changes or enter additional information. Step 11: Verify Action information When you're finished, you should verify all Action information for technical accuracy. Carefully review the detailed summary provided in the text field. When you're ready to continue: • Click Yes to enable your Action.
Enabling an Action 1 From the MarkVision Messenger Home screen, select the Action you want to enable by clicking the box to the left of the Action name. 2 Click Enable Selected. The status of the selected Action changes to Enabled. Note: You cannot enable an Action that another user has selected. Disabling an Action 1 From the MarkVision Messenger Home screen, select the Action you want to disable by clicking the box to the left of the Action name. 2 Click Disable Selected.
Setting or changing user data User data identifies and provides more information about a specific device or set of devices. It is associated with the action.sourcedata keyword string that can be inserted into the Command Line Parameters: list. You can associate the same data with one or more devices. To set or change user data: 1 From the MarkVision Messenger Home screen, click Set User Data. A list of all available devices and current user data is displayed.
Keeping a log of paper jams You can create an Action to keep a log of specific device events. For example, you may want to keep a log of paper jams to determine the average time it takes for them to be cleared. To set up an Action to log paper jams: 1 From the MarkVision Messenger Home screen, click Create New. 2 Enter your Action information in the setup screens that follow, and then click . 3 From the Event Type screen, select Printer Device Status Alerts, and then click .
Let's say you created an Action to send an e-mail notification when a Load Paper or Envelope condition occurs. But after a week, the e-mail recipient is receiving too many notifications, and often when he goes to a device, someone else has already loaded more paper. By using the Delay Time option, you can create a filter that will only send a notification if the Load Paper or Envelope condition has been active for an amount of time that you specify.
5 In the text field, enter a script that only executes the command when the parameter is the paper tray you want to monitor. For example: IfThen (EventDataIs("location", "Tray2")) Distribute 6 Click , and then complete the remaining steps. Sending an e-mail You can create an Action to automatically send an e-mail to someone when a specific event occurs. For example, your network administrator must be notified each time an Operator Intervention Alert occurs, but he is rarely at his desk.
automated ordering system to order toner for the printer, and allows time for the new toner to arrive and be installed before more Supply Low and Supply Empty messages are logged. To create an Action to order supplies: 1 From the MarkVision Messenger Home screen, click Create New. 2 Enter your Action information in the setup screens that follow, and then click . 3 From the Event Type screen, choose Printer Device Status Alerts, and then click .
Setting up the Tivoli event adapter The Tivoli event adapter lets administrators monitor printer events accross a range of devices in real time. In order to send device status alerts to Tivoli, you must create an action in MarkVision Messenger. 1 Click Create New on the MarkVision Messenger Home screen. 2 Enter a name for the adapter, and if desired, input a description and any notes. Click . 3 Select the type of alert that you want to send an event to the Tivoli event server, and then click .
6 Troubleshooting Problems with user accounts and account groups Error reading account When you log in, MarkVision validates your account by requiring a user name and password. At login, if you see: A message that indicates there was an error reading accounts Possible causes • • • • The user name or password you entered is invalid. See Error reading password. You have logged in to the wrong MarkVision Server. The MarkVision Server is not running. The file containing your account information is corrupt.
Error reading password When you log in, MarkVision validates your account by requiring a user name and password. At login, if you see: A message that indicates there was an error reading the password. Possible causes • • • The MarkVision Server is not running on the Web server. The file containing your password is corrupt. You have incorrectly typed in your password. Passwords are case sensitive. User actions Ask your administrator to reset your password.
Problems with network devices MarkVision is unable to find a network device 1 Make sure the printer is turned on and is ready. 2 Make sure the LAN cable is plugged into both the print server and into the LAN, and is working properly. 3 If you are using an INA: • • Make sure the print server is properly installed and enabled. Print a setup page for the printer. See your print server documentation for instructions. The print server should appear in the list of attachments on the setup page.
3 If you are using an INA: • • Make sure the print server is properly installed and enabled. Print a setup page for the printer. Refer to your print server documentation for instructions. The print server should appear in the list of attachments on the setup page. Make sure TCP/IP is activated on the print server. The protocol must be active for the print server and MarkVision to work. You can do this from the printer operator panel. Refer to your print server documentation for instructions.
No printer icon(s) appear When you log in to MarkVision and see: A message that indicates there was an error reading printers. Possible causes • • The MarkVision Service is not running on the server. The file that stores your printers has been corrupted. User actions Contact your administrator. Administrator actions From the Services control panel, verify that the MarkVision Server is running on the Web server. If it is not running, stop and restart service.
Administrator actions: • Verify that the user is using the correct URL address. • Restart the MarkVision Web Server service to verify that it is running correctly. No e-mail notification Possible causes: • The e-mail address you entered is incorrect. • The MarkVision Web Server service is not running correctly. User actions: • Verify that the e-mail address in the To: field of the Compose SMTP E-mail screen is correct. • Verify that the SMTP mail server and mail path are correct.
Cannot enable an action Possible cause: Another user has selected the action. User action: Try again later, or contact the user who has selected the action. Cannot disable an action Possible cause: Another user has selected the action. User action: Try again later, or contact the user who has selected the action. Cannot modify an action Possible causes: • The action is enabled by another user. • Another user has selected the action.
• The wrong device is selected. • The wrong event is selected. • The selected device is not operating. • The MarkVision Web Server service is not running correctly. User actions: • Click the action name to review a detailed summary and verify its accuracy. • Contact your administrator. Administrator actions: • Verify that the selected device is operating correctly. • Review the system log. • Restart the MarkVision Web Server service to verify that it is running correctly.
User action: Contact your administrator. Administrator action: Restart the MarkVision Web Server service to verify that it is running correctly. No private actions listed Private actions are associated with individual usernames. Therefore, you can only see those associated with your username. Possible causes: • No private actions are associated with the username you used to log into MarkVision Messenger. • The MarkVision Web Server service is not running correctly.
Administrator actions: • From the services control panel, verify that the MarkVision Server is running on the web server. If it is not running, stop and restart service. If the service is running, ask the user to recreate their folders (Folder Configuration task - Add). All folders are missing (no login error messages) Possible causes: The file that stores your folders has been corrupted. User actions: Recreate the folders (Folder Configuration task - Add).
7 Frequently Asked Questions How do I get to the server after installing? Accessing the MarkVision Professional Server with the MarkVision Application In application form, the client is installed locally so it can be launched just like any other program installed on the machine. For example, in Windows environments, you can double-click the MarkVision Professional icon on the desktop. This version of the client does not use a Web browser.
plug-in is provided and you are automatically prompted to install it the first time you run the MarkVision Web Client. How do I discover printers? Device Discovery task The Device Discovery task can be selected from either the All Tasks list or by clicking Actions → Device Discovery from the menus. 1 Select to search by: • • • TCP/IP Address, Subnet or Hostname TCP/IP Address Range IPX Address 2 Enter the address information. 3 Click Include to add it to your search list. 4 Click Full Discovery.
Is IPX supported? IPX management support IPX management support is only available for a MarkVision Server running on a Windows NT, Windows 2000, Windows XP, or Windows 2003 Server workstation. UNIX clients can connect to a Windows-based MarkVision Server to manage printers with the IPX protocol. IPX protocol support must be installed on the Windows NT, Windows 2000, Windows XP, or Windows 2003 Server workstation. If IPX protocol support is not installed, the IPX option is disabled.
• What is the lifetime page count of our printers? Enable printer inventory 1 Select Printer Inventory from the All Tasks menu. 2 Select the database you want to use. 3 Enter the username, password, and connection path (URL) for the database you plan to use. Note: The URL is the path to the database used to monitor this server. MarkVision currently supports the following databases: Access, Oracle, and SQL Server, as well as CSV format (Comma Separated Variables).
How do I set up Job Statistics? Enabling Job Statistics tells MarkVision Professional to collect information about each print job sent to a specific printer. This includes information such as job size, job duration, output bins used, and so on. Enable Job Statistics 1 Select Job Statistics: Trend Analysis from the All Tasks menu. 2 Select the database you want to use. 3 Enter the username, password, and connection path (URL) for the database you plan to use.
Database Description Oracle The default is the path to the MarkVision Server. If the database is installed on a different server, change the URL field appropriately, using the path style below: @:: For example: jdbc:oracle:thin:@117.124.46.
• When multiple devices are selected, and one or more of them do not support the current task, either of the following occurs: – – For read-only tasks (such as status and toner levels), MarkVision Professional displays the Device Incapable of Task message in place of the task information for that device. All supported devices have their appropriate information displayed.
3 From the value box, type in 90. Note: Some values (such as the 90 seconds in the previous example) must be manually typed. As in the Basic filter configuration, if All is selected, a device must meet all conditions. If Any is selected, a device must meet at least one condition to be included in the folder. If only one condition is specified, the Any and All radio buttons will be grayed out. For a more in-depth look at filters, see Using filters.
How do you create actions? The following steps are an example of how to create an Action in MarkVision Messenger. This sample Action sends an e-mail message to a fictional address, (paper@jam.com) whenever a printer monitored by the MarkVision Server enters a Paper Jam state. 1 After logging in to MarkVision Messenger, click Create New. • • • Type in the name of the Action (required). Type in a description of the Action (optional). Type in notes about your Action (optional). 2 Click the Next arrow icon.
Messenger, and a description of each is in the Keyword Detail box, directly under the Keywords list. 11 Select the type of filter for your action: • • • Trigger on Active sends an e-mail whenever a printer enters a Paper Jam state. Trigger on Either Active or Clear sends an e-mail whenever a printer enters or exits a Paper Jam state. Custom lets you create your own filter script. For this example, click Trigger on Active, and then click the Next arrow icon. 12 You will now see a summary of your action.
How do I change the MarkVision Web Server port? The port upon which the MarkVision Web Server responds to web requests is also configurable. It may become necessary to do this if you want to simplify the Web Client URL to make requests on port 80, the standard port for web browsers, eliminating the need to specify 9180 in the MarkVision URL. For Windows-based machines, the MarkVision Web Server port may be changed by editing the server.