Lexmark Print Management - Mobile - V2 5 0 0

Print Management
Mobile Guide

www.lexmark.com
CONTENTS
Overview ...................................................................................................................................................................... 4
Requirements ............................................................................................................................................................... 5
Server System Requirements ................................................................................................................................... 5
License ...................................................................................................................................................................... 6
Mail Server ............................................................................................................................................................... 6
Supported Printers ................................................................................................................................................... 6
Supported File Formats ............................................................................................................................................ 6
Mobile Print Solution Installation and Configuration ................................................................................................... 8
Solution Settings ....................................................................................................................................................... 9
Software Solution Group ........................................................................................................................................ 13
Conversion Software Installation ............................................................................................................................... 15
.NET Framework ..................................................................................................................................................... 15
Install OpenOffice, LibreOffice, or MS Office ......................................................................................................... 15
Add Lexmark Print Management System to a Lexmark Mobile Printing Application ................................................. 16
How To Test if Mobile Print Software is Active Without a Mobile Device ............................................................. 17
Configuring the Email Watcher .................................................................................................................................. 18
Example Email Watcher config_EmailWatcher.properties Configurations ......................................... 20
Gmail Example .................................................................................................................................................... 20
FastMail Example ................................................................................................................................................ 20
Configuring Printer Mappings .................................................................................................................................... 20
User Email Print Options ............................................................................................................................................ 25
Configuring the Server for AirPrint ............................................................................................................................. 25
Configuration Portal ............................................................................................................................................... 26
Discovery ................................................................................................................................................................ 26
Unicast ................................................................................................................................................................ 26
Multicast ............................................................................................................................................................. 26
Lexmark & Lexmark Partner Internal Use Only

Page 2
Print Management Portal ....................................................................................................................................... 26

Troubleshooting ......................................................................................................................................................... 27
Active MQ Console ................................................................................................................................................. 27
Important Log Files ................................................................................................................................................. 27
Log Files from AirPrint Jobs ................................................................................................................................ 27
Tomcat Server Mobile Proxy Service Log File ..................................................................................................... 27
Tomcat Server Lexmark Solutions Application Server Service Log File .............................................................. 28
Load Balancer Email Watcher Log File ................................................................................................................ 28
Lexmark Management Console (LMC) Job and Logs .......................................................................................... 28
Some Documents Are Not Converting .................................................................................................................... 28
Increase or Decrease Number of Documents That Can Be Concurrently Converted On Servers ........................... 28
User Cannot Add an LPM System to a Lexmark Mobile Printing Application ......................................................... 29
User Cannot Authenticate From Lexmark Mobile Printing Application ................................................................. 29
Mobile Proxy Service is Not Accessing the Print Release Database ....................................................................... 29
Mobile Devices Cannot Release Documents .......................................................................................................... 30
Only Body Text Prints When Releasing an Email Submitted Job With Attachments Using a Mobile Device ......... 30
Only 1 Attachment Is Printed When Releasing an Email Submitted Job Using a Mobile Device ........................... 31
ActiveMQ Service will not Start .............................................................................................................................. 31
Exception in OpenOfficetpPdfClass. openOffice Manager is not initialized ........................................................... 31
Word hangs while converting mobile Submitted jobs ........................................................................................... 31
Notices ........................................................................................................................................................................ 33
Edition notice ......................................................................................................................................................... 33
Trademarks ............................................................................................................................................................. 33


Page 3
OVERVIEW
Mobile Print adds additional user functionality to an existing Lexmark Print Management (LPM) System:
1.
2.
3.
Lexmark Mobile Printing application support on iOS and Android mobile devices
o View/print/delete documents and print jobs in a users queue on Lexmark Print Management.
o View quota in a users queue on Lexmark Print Management.
o Allow delegate printing from a users queue on Lexmark Print Management.
o Send documents to Lexmark Print Management for conversion and future printing.
See Supported File Formats in this document.
Email document submissions
o Allows a user to send an email to an account monitored by the Lexmark Email Watcher. When a
new email arrives, it is sent to Lexmark Print Management where it is converted to a printable
document based on the predefined conversion settings and any user-specified settings. It can
then be printed immediately to the printer specified by the user or it can be integrated with
Lexmark Print Management and printed by the user at a later time.
TM
AirPrint document submissions
o Allows a user with Mac OS X (10.7 or later) or Apple iOS (6.1 or later) to send documents to
Lexmark Print Management. iPad, iPhone, iPod Touch, and Mac users can send documents
wirelessly to Lexmark Print Management to be printed by the user at a later time.
This document details the configuration of the Lexmark Print Management Mobile Print Software.
For more details about other parts of Lexmark Print Management and Mobile Print, see the following
documentation.
Available via WhitePaper Zip
Lexmark Print Management Installation Guide
Lexmark Print Management Configuration Guide
Lexmark Print Management - Deployment White
Paper
Lexmark Print Management - Mobile
Lexmark Print Management - RFIDeas Print Release
White Paper
Lexmark Print Management - DNS White Paper
Lexmark Print Management - Configuration Portal
White Paper
Print Release Device Support
Available via support.lexmark.com

Mobile Printing Users Guide
Lexmark Print Management - Administrators Guide
Lexmark Print Management - Users Guide
Lexmark Document Distributor (LDD) Administrators
Guide
Description
Details how to install LPM
Details the configuration of LPM
Details eSF and other printer deployment steps
Details mobile configuration.
Details using RFIDeas badge release
Details configuring DNS to use with AirPrint
advertisement and service discovery
Details the configuration portal
Lists the models supported by LPM
Details Lexmark Mobile Printing applications
Details LPM administration
Details user print release at printers
Details LDD administration

Page 4
REQUIREMENTS
SERVER SYSTEM REQUIREMENTS
The tomcat/application servers that are expected to handle document conversions are all of the
tomcat/application servers behind a Lexmark Print Management Load Balancer that get document conversion
jobs. In the following illustration (Figure 1), the document conversion tomcat/application servers are noted in red
dashed outlines.

Figure 1: Examples of Lexmark Print Management System configurations
The first Lexmark Print Management System on the left in Figure 1 is a small to medium system that handles
document conversion on the same tomcat/application servers that also handle print saves and releases. This type
of system configuration should be used if there are low to medium-low volumes of document conversions. If a
customer will have a medium to large number of conversions, the Lexmark Print Management System
configuration on the right in Figure 1 should be used. This type of system can be specifically scaled for document
conversions without impacting the performance of print saves and releases.

Page 5
Print save and release servers can be scaled without impacting document conversion performance. This document
does not cover how to shape network traffic. Please refer to your hardware / software load balancer
documentation on how to direct all of the:
/mobile/*
HTTPS/HTTP traffic to specific Lexmark Print Management Load Balancers. The system on the right in Figure 1 has
a drawback that the Lexmark Print Management sub-systems are independent of each other. Each of the sub-
systems has their own LMC and system configurations. Do not access the LMC through the hardware / software
load balancer because you will be unsure of which sub-system your browser is routed. Use the address of each
sub-systems load balancer for LMC steps later in this document, if this type of system configuration is used.
By default, a document conversion server only handles three documents at a time. See Troubleshooting in this
document for information about how to change this default. Any documents other than PDF and TIFF images are
converted to a printable format, PDF-A. PDF and TIFF documents are not converted, so very little server
processing power is used for these file types. For a list of supported document types, see Supported File Formats
in this document.
LICENSE
The Lexmark Print Management System must have a Software Client license. This can be checked in the Lexmark
Management Console (LMC) -> System tab -> Licenses.

If the BSS.LDD.Client license is not present or has expired, please contact Lexmark.
MAIL SERVER
If the email submission functionality is used, the email server that hosts the account to be monitored by Lexmark
Print Management must support one of the following protocols:
IMAP4
POP3
SUPPORTED PRINTERS
Any network, PostScript-capable printer is supported as an output device. In addition, any Lexmark printer that
supports PDF will produce the best and fastest output.
Advanced finishing options such as staple and hole punch will only work on Lexmark printers. Due to vendor-
specific implementation, duplexing options may not work on non-Lexmark printers.
SUPPORTED FILE FORMATS


Page 6
The following file formats are supported for document conversion that can be printed later:
Lexmark Mobile Printing Application File Support
Email Submission File Support
Adobe PDF (*.pdf)

ASCII Text (*.txt)

GIF (*.gif)
HTML (*.htm, *.html)
JPEG (*.jpg, *.jpeg)
2
Microsoft Excel 97-2003, 2007, 2010, 2013 (*.xls, *.xlsx)
Microsoft PowerPoint 97-2003, 2007, 2010, 2013 (*.ppt,
2
*.pptx)
2
Microsoft Word 97-2003, 2007, 2010, 2013 (*.doc, *.docx)
2
OpenDocument Spreadsheet (*.ods)
2
OpenDocument Presentation (*.odp)
2
OpenDocument Text/Writer (*.odt)

1
TIFF (*.tif, *.tiff)
Adobe PDF (*.pdf)

ASCII Text (*.txt)
CSV Files (*.csv)
GIF (*.gif)
HTML (*.htm, *.html)
JPEG (*.jpg, *.jpeg)
2
Microsoft Excel 97-2003, 2007, 2010, 2013 (*.xls, *.xlsx)
Microsoft PowerPoint 97-2003, 2007, 2010, 2013 (*.ppt,
2
*.pptx)
2
Microsoft Word 97-2003, 2007, 2010, 2013 (*.doc, *.docx)
2
OpenDocument Spreadsheet (*.ods)
2
OpenDocument Presentation (*.odp)
2
OpenDocument Text/Writer (*.odt)
PNG (*.png)
Rich Text Format (*.rtf)
1
TIFF (*.tif, *.tiff)
1
2
Documents are not converted.
Documents with SmartArt or external image/content references may not convert at all or may partially convert.
See Some Documents are not Converting in this document.

Page 7
MOBILE PRINT SOLUTION INSTALLATION AND CONFIGURATION

To add the solution and related components, select the mobile submission options desired during the LPM
installation process. Refer to the LPM Installation Guide for more information about installing LPM and Mobile
Print.
Before installing LPM, it is recommend that you install document conversion software on each tomcat/application
server that is expected to handle document conversion so that the installer can configure LPM to use it
automatically. You may add it later and configure the property files manually.
The following table details supported document conversion applications and versions thereof:
Application
Microsoft Office
Apache OpenOffice
LibreOffice
Supported Versions
2007, 2010, 2013
3.4.x, 4.0.x, 4.1.x
3.4.x, 4.x

Page 8
SOLUTION SETTINGS

Once the solution is
installed, select the
mobileprint solution
from the Solutions list and
the select Configuration
in the Tasks list. This is
where the various
settings for controlling
the processing of the
mobile application and
email submissions are
configured.

Page 9
Setting Name Mobile App /

Email Setting
Mode
Email
Valid Values
Notes
Standard (default)
Print Release (Internal Users Only)
Print Release (Guest Support)
Print Release (Guest Support 2)

Device To
Printer IP
Lookup
Email
Lexmark Database (default)

Direct IP Printing
Device ID
Email
First Word of Subject (default)

Last Word of Subject
First Word of Message Body
Direct IP
Printer Type
Email
PostScript
TIFF (default)
Allowed
Sender
Domains
Email
Print Body
Email
Always (User cannot change)

Yes (User can change) (default)
No (User can change)
Never (User cannot change)
Standard Mode requires the printer to be

specified as defined in the Device ID field.

All Print Release options require the LDAP
and Print Release settings to be
configured. If set to Internal Users Only,
only users existing in LDAP will be allowed
to print.

If set to Guest Support and the user is not
found in LDAP, the solution will function as
if in Standard Mode for that email.

If set to Guest Support 2, the Device ID is
first checked to see if it corresponds to a
printer nickname. If so, the print job is
sent directly to that printer. If not, this
operates as if in Internal Users Only mode.
(This requires Device to Printer IP Lookup
be set to Lexmark Database.)
If using printer nicknames, select Lexmark
Database. If the user will just use the
IP/Hostname of the printer, select Direct
IP Printing.
This is the where the printer nickname or
IP address will be located in the subject of
the email that is sent by the user. Print
options can only be used when the device
id is the first word of the subject or
message body.
If using Direct IP Printing, select the format
that will be accepted by ALL printers that
can be used with this solution.
If emails should only be processed if sent
from certain domains, enter the comma-
separated list. If none are specified, all
emails will be processed. If one or more
are specified, any email that comes from a
domain not listed will be discarded.
This controls the default operation of
printing the message body. The user can
modify this setting when sending the
email if Yes or No is selected.

NOTE: When releasing email submitted
jobs using the mobile device, this setting
should be set to No or Never in order to
print the first attachment, otherwise only
the body will be printed and not the
attachment.

Page 10

Email Setting
Print
Email
Attachments
Valid Values
Notes

This controls the default operation of

printing all attachments in the email. The
user can modify this setting when sending
the email if Yes or No is selected.
This controls if all emails (message body
and attachments) are printed in duplex (if
supported by the printer). The user can
modify this setting when sending the
email if Yes or No is selected.
By default, one copy of the message body
and/or attachments is printed. The user
can specify the number of copies when
sending the email. This is the maximum
number of copies that can be printed of
one email. Setting to 1 allows only 1 copy
to ever be printed.
Controls if a confirmation is sent to the
user informing job has been successfully
sent to the printer. If Disabled, no email is
sent; if To All Users, it will be sent to
everyone; if To Users in Specified
Domains, it is only sent to users whose
email address is from one of the domains
specified in Confirmation Email Domains.
Controls if a confirmation is sent to the
user informing job encountered an error
and could not be processed. If Disabled,
no email is sent; if To All Users, it will be
sent to everyone; if To Users in Specified
Domains, it is only sent to users whose
email address is from one of the domains
specified in Confirmation Email Domains.
If any of the confirmation emails should
only be sent to users from certain
domains, enter the comma-separated list.
From: address that will appear in the
confirmation emails.
Print in
Duplex
Email
Print Max
Copies
Email
1 (default)
Confirmation
Success Email
Email
Disabled (default)
To All Users
To Users in Specified Domains

Confirmation
Error Email
Email
Disabled (default)
To All Users
To Users in Specified Domains

Confirmation
Email
Domains
Confirmation
Email From
Address
Confirmation
Email Subject
Confirmation
Email
Disclaimer
Confirmation
Print Release
Name
LDAP Server
Email
Email
name@company.com
Email
The subject used for any confirmation

emails that are sent.
This is appended to the end of any
confirmation that is sent.
Email
Mobile Print Confirmation

(default)
NOTE: Do NOT reply to this email.
Please contact the HelpDesk for
further assistance. (default)
Lexmark Print Release (default)
Email
IP Address or Hostname of the LDAP

Server to use for looking up email
addresses / userid.
Email

Print release system name that the email

was released.
Page 11

Email Setting
LDAP Port
Email
Valid Values
Notes
Use SSL for

LDAP
Email
Yes
* No
LDAP Login
Username
LDAP Login
Password
LDAP Search
Base
Email
Email
Email
LDAP Userid
Attribute
LDAP Mail
Attribute
LDAP Follow
Referrals
Email
Samaccountname (default), uid
Email
mail (default)
Email
Yes (default)
No
LDAP User
Object
Print Release
Directory
Email
User (default)
Both
C:\lexmark\printrelease (default)
Port used for communicating with LDAP

Server (typically 389).
Determines if the solution will use SSL
when querying LDAP. One of the SSL ports
above would also have to be chosen to
ensure SSL (typically 636).
Account used for accessing the LDAP
Server.
Password used for accessing the LDAP
Server.
Search base used for looking up email
accounts; this needs to be broad enough
to look up all possible user accounts.
LDAP Attribute that corresponds to the
users Windows User ID
LDAP Attribute that corresponds to the
users email address.
Specifies whether referrals to other LDAP
servers should be processed. If No, only
responses from the LDAP Server specified
above are used.
The objectclass in LDAP used by user
accounts.
Enter the file share information that is
used in the Lexmark Print Management
solution. If this is a workgroup installation
of LPM (i.e. everything is installed on one
server) and a local file system on the
server is used to hold print release
documents, then the Print Release
username and password fields can be left
blank. If a common file share is used (as
required for an Enterprise install), enter
the credentials of an administrator or user
who has write access to the file share.

Note: This should be the same value as
the Print Release Solution setting.

If the directory is on a file share, then
enter a UNC path; for example; \\[server
name]\[share name].

Note: If the server is not a member of a
domain, then the hostname of the server
with the file share on its local file system
should be used as the domain name.

Page 12

Email Setting
Print Release Both
Username
Valid Values
Notes
This is the userid necessary to save files to

the print release directory. This should
be the same value as the Print

Release Solution setting.
Print Release
Password
Both
This is the password necessary to save files

to the print release directory. This
should be the same value as the

Print Release Solution setting.
Conversion
Method
Both
MS Office and Open Office

Open Office Only (default)
Conversion
Format
Release Jobs
Directly
Both
PDF
PostScript

Print File
Operations
Both
Both
* Use Standard Method

Use Alternate Method
Specifies the method used to convert

attachments. If Open Office Only is
selected, all file types will be converted
using Open Office or LibreOffice. If MS
Office and Open Office is selected, MS
Office will be used to convert MS Office
file types and Open Office or LibreOffice
will be used to convert all other file types.

NOTE: Print fidelity of MS Office
documents is better using the MS Office
and Open Office setting as the Conversion
Method.
Specifies the document format used for
conversions.
If checked, jobs will be released directly to
the printer from the server. Otherwise,
jobs will be downloaded to and released
from the mobile device.

NOTE: Disabling the Release Jobs Directly
checkbox will result in slower performance
when releasing jobs using a mobile device.
Allows for an alternate way for saving files
in the event the standard method has
issues in the customer's environment.
Standard = FileClass (jcifs)
Alternate = TISFile
Note: The LDAP and Print Release Settings are only used if one of the Print Release integration methods is
selected; otherwise, they can be left blank.
SOFTWARE SOLUTION GROUP

NOTE: A Software Client License is required.
The last step of the Mobile Print Solution installation is configuring the software solution group that allows
Lexmark Mobile Printing Applications (iOS and Android) and Email Watcher to submit jobs to Lexmark Print
Management.

Page 13
1.
2.
3.
4.
Select the Software Client Groups tab in the LMC and select the Mobile Print software client group.
The Mobile Print software client group was automatically created when the Mobile Print Solution
was installed.
Select Client Profiles in the Tasks list.
Enter the IP address (e.g. 10.186.65.121) or subnet (e.g. 10.186.*.*) of the mobile devices and/or email
watcher servers that will be submitting jobs to Lexmark Print Management.
A .csv file of IP addresses and/or subnets can be imported too. The .csv file format is one IP
address or subnet per line. See the Lexmark Document Distributor Administrator Guide for more
information.
Click Add.
This step is not needed if a list of addresses is imported.

Page 14
CONVERSION SOFTWARE INSTALLATION

To enable the conversion of the supported document types, the following must be done on each of the Lexmark
Print Management tomcat/application servers that are expected to handle document conversions. See Server
System Requirements for document conversion server information.
.NET FRAMEWORK
Starting from Mobile Print 2.5.2 and when using Microsoft Office for document conversion, .NET Framework 4 is
part of mobile installation to allow the interaction between Lexmark Print Management and any of the conversion
applications.
1.
For Windows 2003 Server, the Windows Imaging Component (WIC) must be installed before .NET
Framework 4 can be installed and document conversion requires .NET Framework 4 to work properly.
a. If .NET Framework 3.5 SP1 is already installed on the machine, WIC is not required for installing
.NET Framework 4.
INSTALL OPENOFFICE, LIBREOFFICE, OR MS OFFICE

A supported Office application must be installed so that Document conversion can be performed. See Server
System Requirements for details on supported Office applications and versions thereof. These steps are required
and must be performed on all of the document conversion tomcat/application servers.
If using OpenOffice or LibreOffice:
1.
2.
3.
4.
Download Apache Open Office (http://www.openoffice.org/download/) or LibreOffice.

During the Install Wizard, be sure to select Install this Application for Anyone who uses this computer (all
users).
Choose the typical install to accept the default install path and to install all the applications. If you choose
the custom install path, all main office applications should be installed; the optional components can be
installed at your discretion.
If Open Office or LibreOffice is installed after installing Mobile Print Software
a. Stop Lexmark Solutions Application Server service.
b. Set the officeToPDF.defaultOfficeHomeDirectory property in
%SOLUTIONS_INSTALL_DIR%\apps\wf-ldss\WEB-INF\classes\OpenOfficeToPDFClass.properties
to the location where Open Office or LibreOffice is installed. For a typical LibreOffice 4.0 install
this would normally be C:\Program Files (x86)\LibreOffice 4. Please make sure that there is no
trailing slash. Also, all backslashes in the path should be replaced with forward slashes.
c. Restart Lexmark Solutions Application Server service.
d. Update the Conversion Method setting in mobileprint solution to use the appropriate converter.


Page 15
If using MS Office:
1.
2.
3.
4.
5.
6.
Follow the appropriate instructions for obtaining and installing MS Office. During installation, be sure to
select Install this Application for Anyone who uses this computer (all users).
Choose the typical install to accept the default install path and to install all the applications. If you choose
the custom install path, all main office applications should be installed; the optional components can be
installed at your discretion.
Create a directory named Desktop under C:\WINDOWS\system32\config\systemprofile\. If you are
using a 64 bit O/S, you also have to create a Desktop folder under
C:\Windows\SysWOW64\config\systemprofile\.
If you are using Microsoft Office 2007, install the Microsoft Save as PDF or XPS add-in.
If you are going to use MS Office, then additional configuration is needed to successfully convert Excel
documents (*.xls and .xlsx).
a. Run the createLsasUser.bat file in the %SOLUTIONS_INSTALL_DIR%\lpm\msoffice folder. You
have to pass in a username and password when calling this batch file. This creates a User account
with administrative privileges that is required in the next step. Also, make sure that the
command prompt session is run as administrator.
b. Log into the newly created account to get Windows to create the necessary folders for that user
profile. While you are logged into this account, open one of the Office components (Word or
Excel) and complete the Office setup process. This usually involves setting Privacy and Update
options.
c. Change the Lexmark Solution Application Server service to run as this user and restart the
service.
If you install MS Office after installing Mobile Print, then
a. Follow steps 1 through 5.
b. Stop Lexmark Solutions Application Server service.
c. Set the officeConv.execName property in %SOLUTIONS_INSTALL_DIR%\apps\wf-ldss\WEB-
INF\classes\ MsOfficeDocConvClass.properties to use the right executable. If using MS Office
2007 set it to MsOffice2007DocConverter.exe. If using MS Office 2010, then set it to
MsOffice2010DocConverter.exe. If using MS Office 2013, then set it to
MsOffice2013DocConverter.exe.
d. Restart Lexmark Solutions Application Server service.
e. Update the Conversion Method setting in mobileprint solution to use the appropriate converter.

You must install the same document conversion application on each tomcat/application server; you may not use
different document conversion applications on different servers.
NOTE: Refer to the Trouble Shooting section of this document for more information related to sing Microsoft
Office.
ADD LEXMARK PRINT MANAGEMENT SYSTEM TO A LEXMARK MOBILE PRINTING

APPLICATION
Once the mobile print software is installed on all of the document conversion servers (see Server System
Requirements), the mobile solution is loaded and configured in the LMC, mobile IP addresses or subnets have been

Page 16
added to the Mobile Print groups Client Profiles in the LMC Software Client Groups tab, and the servers are all set
Online, then the Lexmark Print Management System can be added to the Lexmark Mobile Printing Application on
mobile devices.
1.
2.
3.
4.
Start the Lexmark Mobile Printing Application on a mobile device.

Add [address_of_load_balancer]/mobile.

If Lexmark Print Management has a hardware/software load balancer in front of several Lexmark Print
Management sub-systems, enter the hardware/software load balancer address. See Server System
Requirements.

Login with your LDAP or Active Directory username and pw depending on the LDAP configuration used in
Mobile Print Software Installation.
You can view and release jobs in your Lexmark Print Management queue and start submitting documents
into Lexmark Print Management for conversion and release.

HOW TO TEST IF MOBILE PRINT SOFTWARE IS ACTIVE WITHOUT A MOBILE DEVICE

Part of the Mobile Print Software install is the Mobile Proxy Service. The service is used by the Lexmark Mobile
Printing application on mobile devices to communicate with Lexmark Print Management. Its default install
directory is %ProgramFiles%\Lexmark\Solutions\apps\mobile.
1.
2.
3.
4.
Open a browser.
Enter https://[ address_of_load_balancer]/mobile/rest/info.
Accept the self-signed certificate from the Lexmark Print Management System.
You should see something like the following in your browser view if the service is running successfully:

{
"printQueueName": "Lexmark Print Management",
"version": {
"printReleaseApiVersion": "1.3.5",
"documentAccountingApiVersion": "1.3.5",
"printSubmissionApiVersion": "1.3.5"
},
"capabilities": {
"printSettings": {
"copies": "unavailable",
"duplex": "unavailable",
"nup": "unavailable",
"color": "unavailable",
"collation": "unavailable",
"title": "submitView",
"description": "unavailable"
}
},
"api": {
"currentVersion": "1.1",

Page 17
"supportedVersions": "1.0,1.1"
}
}
CONFIGURING THE EMAIL WATCHER

The Lexmark Email Watcher is installed on the Load Balancer during Lexmark Print Management installation if the
email component was checked.
Lexmark Email Watcher is a Windows service that can be seen in the Windows Services Control Panel Applet.
Lexmark Email Watcher is not started during the Lexmark Print Management Load Balancer installation process
since the service needs to be configured before it is started. Any time a configuration change is made to this
service; it must be restarted for the change to take effect. Also, set the services Startup Type to Automatic, so the
service will start after reboots.

The Email Watcher is installed to the base Lexmark Solutions folder chosen when the Load Balancer was installed;
by default, this location is %ProgramFiles%\Lexmark\Solutions\EmailWatcher. The configuration
file is called config_EmailWatcher.properties and is located in a subfolder called conf. An
example properties is installed and contains example properties. Some of the properties are commented out and
some are not in the file yet. Add the necessary properties needed for your email server. The available settings are
as follows:
Setting Name
ldd.server
ldd.profile
mail.type
Valid Values
Notes
http://<address_of_load_balancer>:9780 Insert the hostname or IP Address of the LPM
Load Balancer where indicated, e.g.
http://my-lpm-server:9780
mobileprint
The name of the profile when the job is submitted
to LPM; this should not be changed.
imap
The type of email server on which the email
pop3
account is located. IMAP is the preferred.
notes (not supported any more)

Page 18
Setting Name
mail.server
Valid Values

mail.port
mail.tls
143 (imap), 993 (imap over ssl), 110

(pop3), 995 (pop3 over ssl)

0 (no tls), 1 (use tls)
mail.ssl
0 (no ssl), 1 (use ssl)
mail.folder
INBOX
mail.allowNTLM 0 (do not allow); 1 (allow)
mail.domain
mail.user
mail.pw
mail.allowIdle
0 (do not allow); 1 (allow)
mail.poll
60
Debug
0 (off), 1 (on)
Notes
For IMAP or POP3, this is the IP Address or
hostname of the mail server.
For IMAP or POP3, the common ports are listed;
another value can be used if needed.
For IMAP or POP3, indicates if TLS should be used
when communicating with the mail server. Only
TLS or SSL can be used, not both. If TLS is enabled,
the SSL setting is ignored.
For IMAP or POP3, indicates if SSL should be used
when communicating with the mail server. Only
TLS or SSL can be used, not both. If TLS is enabled,
the SSL setting is ignored.
For IMAP or POP3, this is the folder where new
mail appears; in most cases, this should not be
changed.
For IMAP or POP3, this enables or disables the
user of NTLM authentication. In most cases, this
should be set to not allow.
For IMAP or POP3, this is the domain of the user
account.
For IMAP or POP3, this is the username for the
account being monitored.
For IMAP or POP3, this is the password for the
account being monitored.
If the mail server supports auto-notification of
new mail (usually only IMAP servers support this),
this specifies whether to enable or disable this
feature. If disabled, set the poll value in the next
setting.
The time in seconds that is waited before checking
for new email. Some IMAP servers support auto-
notification of new mail so no polling is needed.
The default is 60 seconds.
Specifies if extra logging should be written to the
log file. Only use if troubleshooting an issue as the
amount of data being logged can slow down the
processing.
NOTE: The Lexmark Email Watcher must be restarted if any changes are made to the configuration file. The
changes do not take effect until the service is restarted.
NOTE: When troubleshooting, the log files are located in .\EmailWatcher\logs. The
emailwatcher.log will have the most useful information. This is where the extra logging appears when the
configuration file sets debug on.
NOTE: To enable even more logging, open the .\EmailWatcher\conf\l4j_EmailWatcher.xml file.
Go to the bottom of the file and change the level value for com.lexmark.tis.tools.emailwatcher
and javax.mail to debug. This requires a restart of the Lexmark Email Watcher Service to take effect. Be
sure to set back to info once the issue has been resolved.

Page 19
NOTE: To change the username or password, edit the property file in a text editor and replace the encrypted
entries with the new credentials. Restart the email watcher service to read and re-encrypt the password.

EXAMPLE EMAIL WATCHER CONFIG_EMAILWATCHER.PROPERTIES CONFIGURATIONS

GMAIL EXAMPLE
# Mandatory Properties
ldd.server=http://[ldd-lb-addr]:9780
ldd.profile=mobileprint
mail.server=imap.gmail.com
mail.user=test@company.com
mail.pw=notTheRealPassword
# Optional Properties.
mail.type=imap
mail.ssl=1
mail.tls=0
mail.port=993
mail.folder=INBOX
mail.allowIdle=1
debug=1

FASTMAIL EXAMPLE
ldd.server=http://[ldd-lb-addr]:9780
ldd.profile=mobileprint
mail.type=imap
mail.server=imaps-proxy.messagingengine.com
mail.ssl=1
mail.port=443
mail.user=user1@fastmail.fm
mail.pw=user1pw
mail.folder=INBOX
CONFIGURING PRINTER MAPPINGS
Printer Nicknames map between a user friendly nickname entered by the admin and a devices IP address. When
configured, they allow users to use the nickname instead of the IP address when submitting jobs. If Printer
Nicknames are not being used, this section can be skipped. If Printer Nicknames are being used, a web-based
utility is provided to do the mappings. When the Print Management Client was installed, a link was created on the
desktop. It can be reached from any desktop using Internet Explorer by entering the following:
http://<address_of_load_balancer>:9780/printrelease
Log in using the same userid and password as used for the LMC.

Page 20
Once logged in, you need to enable the Printer Nicknames tab in the Configuration options dialog.

Page 21
Once you have enabled the tab, follow the instructions to log out and back in and then navigate to the Printer
Nicknames tab:

This shows all the printer mappings that have been created. The list can be filtered by printer name, IP address, or
printer type. Each column can also be sorted.


Page 22
To create a new mapping, click the Add Printer Nickname button in the upper right corner.

Enter the Printer Nickame (this is what is entered by the user in the subject of the email). Enter the corresponding
IP Address. Select the Printer Type PostScript or TIFF this indicates the format of the file that can accepted by
the printer; TIFF provides the best performance.


Page 23
Once a printer has been added, it appears in the list.

It can be deleted by selecting the
same line.
on the same line as the printer. It can be edited by clicking the
on the
When finished, click the Logout link in the upper right corner.


Page 24
USER EMAIL PRINT OPTIONS

When the user submits an email, there are several options that can be sent along with the printer address or
nickname that controls the output. The print options can only be used if Device ID is to First Word of Subject;
the options would be specified after the device id. The following options are available:
Option Name
Copies
Option Value
/c#
Duplex
/d
Hole Punch
/h
No Attachments
/na
No Body
/nb
No Duplex
/nd
Print Attachments
/pa
Print Body
/pb
Staple
/s
Notes
The # indicates the number of copies; if the user
specifies a value greater than the Print Max Copies
specified in the solution settings, the max value will
be used instead.
This forces the document to be printed in duplex.
This option may not work with some non-Lexmark
printers.
This enables hole punch feature to be used if the
printer has a finisher that can do hole punching;
otherwise, it has no effect. This option will not work
with non-Lexmark printers.
This only prints the message body; all attachments
will be ignored. This setting has no effect if the
solution setting Print Attachments is set to Always.
This skips the message body and only prints the
attachments in the email. This setting has no effect
if the solution setting Print Body is set to Always.
This forces the document to be printed single-sided.
This setting has no effect if the solution setting Print
Duplex is set to Always.
This enables the printing of the attachments in the
email. This setting has no effect if the solution
setting Print Attachments is set to Never.
This enables the printing of the message body in the
email. This setting has no effect if the solution
setting Print Body is set to Never.
This enables the staple feature to be used if the
printer has a finisher that can do stapling; otherwise,
it has no effect. This option will not work with non-
Lexmark printers.
Here are some examples:

Subject
printerid /c2 /d
printerid /nb
printerid /d /s
printerid /na
Resulting Print Out

Prints 2 duplexed copies
Does not print the message body; only prints the
each attachment
Staples and duplexes the message body and each
attachment
Prints only the message body
CONFIGURING THE SERVER FOR AIRPRINT


Page 25
AirPrint functionality is enabled during Lexmark Print Management installation if the AirPrint component was
checked.
CONFIGURATION PORTAL
The configuration portal can be reached at the following URL:
http://<address_of_load_balancer>:9780/lpm/config
Log in using the same userid and password as used for the LMC.
See the Lexmark Print Management Configuration Portal whitepaper for details about the configuration portal.
DISCOVERY
UNICAST
See the Lexmark Print Management DNS Whitepaper for details about the configuration of a Microsoft DNS
server, or Bind for Windows DNS Server, to perform AirPrint advertisement and service discovery for the Lexmark
Print Management solution.
MULTICAST
Bonjour service is installed and started by default. To begin advertising LPM via Bonjour service, it needs to be
registered by checking the Enable Bonjour discovery on the General tab of the Configuration Portal.
PRINT MANAGEMENT PORTAL

Jobs submitted via AirPrint will be listed as IPP Print in the Site column in the Print Management portal on the Print
Queue tab.


Page 26
TROUBLESHOOTING
ACTIVE MQ CONSOLE
The ActiveMQ console is a web interface to view the state of the ActiveMQ queue for jobs submitted via AirPrint,
and can be useful for troubleshooting print jobs that dont make it to the Print Release queue (e.g. unsuccessful
file conversion during job processing). The ActiveMQ console can be accessed at the following URL:
http://<address_of_load_balancer>:8161/admin/
If no login ID has been configured, the following credentials are enabled by default:
username:
password:
admin
admin
Note: The console may be disabled by default. Below are the steps to enable the web console:
1.
2.
3.
4.
Open activemq.xml (<installed_server_path>\ActiveMQ\conf) in a text editor.

Uncomment the line, toward the end of the file, about "import resource". For example, change it from
 to <import resource="jetty.xml"/>
Restart the ActiveQ service.
Restart lpm-portal webapp (via tomcat management console) or restart the tomcat service.
IMPORTANT LOG FILES

If an issue occurs with mobile device submissions or email job issues, the following log files are valuable for
troubleshooting. The log files exist on each of the document conversion servers except for the Email Watcher log
file. The logging level is set to WARN by default. You can change it to DEBUG by updating the log4j-config.groovy
in apps\lpm\WEB-INF\classes and apps\idm\WEB-INF\classes.
LOG FILES FROM AIRPRINT JOBS

These log files contain processing information from jobs submitted via AirPrint. idm.log and lpm.log reside on
the Tomcat servers. activemq.log resides on the load balancer.
.\Lexmark\Solutions\tomcat\logs\idm.log
.\Lexmark\Solutions\tomcat\logs\lpm.log
.\Lexmark\Solutions\ActiveMQ\data\activemq.log
You may also look into the database. For jobs in the pending status, you can connect to the QUEUED_PRINT_JOB
table in the solutionInfo database and look for the Job_State_Reason column.
TOMCAT SERVER MOBILE PROXY SERVICE LOG FILE


Page 27
This log file contains processing information from the Mobile Proxy service that handles communication with
mobile devices running the Lexmark Mobile Printing application.
.\Lexmark\Solutions\tomcat\logs\mobile.log
TOMCAT SERVER LEXMARK SOLUTIONS APPLICATION SERVER SERVICE LOG FILE

This log file contains processing information from the core Lexmark Print Management application/tomcat service.
.\Lexmark\Solutions\tomcat\logs\lsas.log
LOAD BALANCER EMAIL WATCHER LOG FILE

These log files contain processing information from the Email Watcher service that runs in the Lexmark Print
Management load balancer. See Configuring the Email Watcher for more information.
.\Lexmark\Solutions\EmailWatcher\logs\*.log
LEXMARK MANAGEMENT CONSOLE (LMC) JOB AND LOGS

LMC -> System tab -> Jobs and/or Log
SOME DOCUMENTS ARE NOT CONVERTING

The supported office applications (OpenOffice, LibreOffice and MS Office) do not convert some documents at all,
or only partially convert some of the original documents content into a PDF file. Documents with SmartArt or
external image/content references may experience these issues. For mobile users who submit documents directly
(not using email) to Lexmark Print Management, there is no feedback that the document did not convert, except
that the document does not appear in the users mobile queue view or the Print Release Admin Portal.
To determine whether this is a limitation of the office application you are using, open the originally submitted
document directly in the appropriate office application and export it to type PDF-A. If a document conversion error
occurs, please submit a field escalation with the original document file and the log files noted in Important Log
files, so the issue can be investigated.
INCREASE OR DECREASE NUMBER OF DOCUMENTS THAT CAN BE CONCURRENTLY

CONVERTED ON SERVERS
By default, a document conversion server only handles three documents at a time. Using a higher number of
concurrent conversions may make conversions unstable. This is a limitation of the third party software that is used
for conversions, but here are the steps to modify this server property.
On each of the document conversion servers:
1.
Open the %ProgramFiles%\Lexmark\Solutions\apps\wf-ldss\WEB-

INF\classes\OpenOfficeToPDFClass.properties file in a text editor with Administrator privileges.
The path above may be different for your installation.

Page 28
2.
Change the officeToPDF.maxInstances value and save your changes.
3.
4.
Values of 1 - 5 seem OK. Going above 5 is risky.

Save your changes.
Stop and restart the Lexmark Solutions Applications Server service.
USER CANNOT ADD AN LPM SYSTEM TO A LEXMARK MOBILE PRINTING APPLICATION

This is usually caused by one or more of the following configurations not being correct:
1.
2.
3.
4.
Make sure you are entering the LPM System address in the Mobile Printing Application in the right
format.
a. See Add Lexmark Print Management System to a Lexmark Mobile Printing Application.
Make sure the Lexmark Print Management Servers are Online.
a. LMC -> System tab -> select System Status in the System list -> check all of the servers -> select
the Set Online button.
b. See Mobile Print Software Installation.
Make sure you have installed the Mobile Print .solution file.
a. See Mobile Print .Solution Installation and Configuration.
Make sure you have added all IP addresses and subnets to the Mobile Print Software Client Group in
the LMC.
a. See Software Solution Group.
USER CANNOT AUTHENTICATE FROM LEXMARK MOBILE PRINTING APPLICATION

Usually this happens if the LDAP or Active Directory information was entered incorrectly in the Mobile Print
installer UI.
Prior to LPM v2.4, LDAP information was in a property file. LPM v2.4 and higher uses this information from the
mobile solution. Select the mobile solution from the Solutions tab in the LMC. Verify the LDAP settings are
correct.
NOTE: Solution settings are cached for performance reasons so changes to the settings may not be available
immediately. Caching intervals are 2 - 5 minutes and are not configurable.
MOBILE PROXY SERVICE IS NOT ACCESSING THE PRINT RELEASE DATABASE

This can be fixed by editing the mobile proxy services LDDMobilePrintReleaseproduction.properties file. The service can be configured to use either a SOLUTIONINFO database in the
built-in Firebird database or in a MS SQL database.
On each of the document conversion servers:
1.
2.
Open the %ProgramFiles%\Lexmark\Solutions\apps\mobile\WEB-INF\classes\LDDMobilePrintRelease-

production.properties file in a text editor with Administrator privileges.
The path above may be different for your installation.
Correct the following properties in this file according the customers LDAP or Active Directory:
lddMobile.db.url

Page 29
i. Firebird example;
jdbc:firebirdsql:10.163.9.217/3050:SOLUTIONINFO (without the
double quotes)
ii. MS SQL example;
jdbc:sqlserver://10.163.9.217;databaseName=PRDATABASE;
(without the double quotes)
lddMobile.db.driver
i. Firebird example; org.firebirdsql.jdbc.FBDriver
ii. MS SQL example; com.microsoft.sqlserver.jdbc.SQLServerDriver
lddMobile.db.user
i. Firebird example; framework
ii. MS SQL example; sql. Check with DBA about the correct name to use
lddMobile.db.password
i. Firebird example; rivet
ii. MS SQL example; Apr1c0t. Check with DBA about the correct password to use
Save your changes.
Stop and restart the Lexmark Solutions Applications Server service.
3.
4.
MOBILE DEVICES CANNOT RELEASE DOCUMENTS

NOTE: Solution settings are cached for performance reasons so changes to the settings may not be available
immediately. Caching intervals are 2 - 5 minutes and are not configurable.
The print release directory needs to be configured the same in the:
1.
2.
PrintReleasev2 solutions settings

a. LMC -> Solutions tab -> select PrintReleasev2 in Solutions list -> select Configuration in the Tasks
list -> edit Directory for Print Jobs, Username for Print Job Directory, and Password for Print
Job Directory -> click Apply.
b. See solution settings in the Print Release Administrators Guide.
Mobileprint solutions settings
a. Print Release Directory, Print Release Username, and Print Release Password
b. See Solution Settings.
ONLY BODY TEXT PRINTS WHEN RELEASING AN EMAIL SUBMITTED JOB WITH
ATTACHMENTS USING A MOBILE DEVICE
This may be caused when the Mobile Solution is configured to print the body of the email. When releasing email
submitted jobs using the Mobile Device you may observe that only the body of the email is printed (or no pages at
all in the case of an empty body). To disable email body processing, set the Print Body property in the Mobile
Solution Settings to No or Never. This will allow you to release the first attachment in the email submitted job.
This is a limitation unique to Mobile devices and all pages (including the body of the email) can be printed when
releasing the job using the eSF app.
1.
Mobileprint solutions settings

Page 30
a.
b.
Set Print Body to No or Never.

See Solution Settings.
ONLY 1 ATTACHMENT IS PRINTED WHEN RELEASING AN EMAIL SUBMITTED JOB USING A

MOBILE DEVICE
Only the first attachment in the email will be printed when releasing the job using a Mobile device and requires
setting the Mobile Print solution setting "Print Body" to No or Never. This is a limitation unique to Mobile devices
and all pages (including the body of the email) can be printed when releasing the job using the eSF app.
ACTIVEMQ SERVICE WILL NOT START

ActiveMQ may not start or remain started if another application on the load balancer server also uses any of the
ports listed below. Identify what software is using that port and remove it or change the port.
Port used by ActiveMQ:
-
-
8161 (web portal)

61616 (queue port and the port jms broker listens on)
EXCEPTION IN OPENOFFICETPPDFCLASS. OPENOFFICE MANAGER IS NOT INITIALIZED

When submitting an email to LPM mobile printing, it does not work and you see the following error message in the
LMC:
Exception In Openofficetppdfclass. Openoffice Manager Is Not Initialized
You may see that in the task manager the Openoffice Process is running.
This often occurs if the document conversion software was added after LPM was installed. You will need to
configure the properties files manually.
WORD HANGS WHILE CONVERTING MOBILE SUBMITTED JOBS

If you install Microsoft Office 32 bit on Windows Server 64 bit, you may notice that Word hangs and must be
stopped via task manager. Below are the steps that should address this issue.
Run Component Services for 32 bit (mmc comexp.msc /32)
Console Root --> Component Services --> Computers --> My Computer --> DCOM Config
This allows you to choose each application you are interested in
Microsoft Excel Application

Microsoft PowerPoint Slide (and/or Application. May vary depending on version you have installed.)
Microsoft Word 97 - 2003 Document

Page 31
For each one of those apps, Right Click --> Properties

Choose the Identity tab
Select The interactive user or This user and provide the account/password as you did for running LSAS services as a
user.
All 3 formats should come through as expected with these set.
PowerPoint we have yet to see a problem with, but for consistency it is recommended to set it the same as the
others.
If there is a need to run LSAS as a user, then the same steps can be applied just choose This user and provide the
info. The interactive user likely works in this case also.


Page 32
NOTICES

EDITION NOTICE
August 2015
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.

This publication could include technical inaccuracies or typographical errors. Changes are periodically made to the
information herein; these changes will be incorporated in later editions. Improvements or changes in the products
or the programs described may be made at any time.

References in this publication to products, programs, or services do not imply that the manufacturer intends to
make these available in all countries in which it operates. Any reference to a product, program, or service is not
intended to state or imply that only that product, program, or service may be used. Any functionally equivalent
product, program,or service that does not infringe any existing intellectual property right may be used instead.
Evaluation and verification of operation in conjunction with other products, programs, or services, except those
expressly designated by the manufacturer, are the users responsibility.

For Lexmark technical support, visit http://support.lexmark.com.

For information on supplies and downloads, visit www.lexmark.com.

2014, 2015 Lexmark International, Inc.
All rights reserved.

TRADEMARKS

Lexmark, the Lexmark logo, MarkNet, and MarkVision are trademarks of Lexmark International, Inc., registered in
the United States and/or other countries.

iPad, iPhone, iPod, and iPod touch are trademarks of Apple Inc., registered in the U.S. and other countries. AirPrint
and the AirPrint logo are trademarks of Apple Inc.

All other trademarks are the property of their respective owners.


Page 33

Lexmark Print Management - Mobile - V2 5 0 0

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Lexmark Print Management - Mobile - V2 5 0 0

Caricato da

Copyright:

Formati disponibili

Print Management

Print Management Portal ....................................................................................................................................... 26

Lexmark & Lexmark Partner Internal Use Only

Lexmark & Lexmark Partner Internal Use Only

Lexmark & Lexmark Partner Internal Use Only

SUPPORTED FILE FORMATS

Email Submission File Support

Adobe PDF (*.pdf)

Adobe PDF (*.pdf)

Documents are not converted.

Lexmark & Lexmark Partner Internal Use Only

MOBILE PRINT SOLUTION INSTALLATION AND CONFIGURATION

Lexmark & Lexmark Partner Internal Use Only

Lexmark & Lexmark Partner Internal Use Only

Setting Name Mobile App /

Lexmark Database (default)

First Word of Subject (default)

Always (User cannot change)

Standard Mode requires the printer to be

Lexmark & Lexmark Partner Internal Use Only

Setting Name Mobile App /

Always (User cannot change)

This controls the default operation of

The subject used for any confirmation

Mobile Print Confirmation

IP Address or Hostname of the LDAP

Lexmark & Lexmark Partner Internal Use Only

Print release system name that the email

Setting Name Mobile App /

Use SSL for

Samaccountname (default), uid

Port used for communicating with LDAP

Lexmark & Lexmark Partner Internal Use Only

Setting Name Mobile App /

This is the userid necessary to save files to

be the same value as the Print

This is the password necessary to save files

should be the same value as the

MS Office and Open Office

* Use Standard Method

Specifies the method used to convert

SOFTWARE SOLUTION GROUP

Lexmark & Lexmark Partner Internal Use Only

CONVERSION SOFTWARE INSTALLATION

INSTALL OPENOFFICE, LIBREOFFICE, OR MS OFFICE

Download Apache Open Office (http://www.openoffice.org/download/) or LibreOffice.

Lexmark & Lexmark Partner Internal Use Only

ADD LEXMARK PRINT MANAGEMENT SYSTEM TO A LEXMARK MOBILE PRINTING

Start the Lexmark Mobile Printing Application on a mobile device.

HOW TO TEST IF MOBILE PRINT SOFTWARE IS ACTIVE WITHOUT A MOBILE DEVICE

Lexmark & Lexmark Partner Internal Use Only

CONFIGURING THE EMAIL WATCHER

Lexmark & Lexmark Partner Internal Use Only

143 (imap), 993 (imap over ssl), 110

0 (no ssl), 1 (use ssl)

mail.allowNTLM 0 (do not allow); 1 (allow)

0 (do not allow); 1 (allow)

EXAMPLE EMAIL WATCHER CONFIG_EMAILWATCHER.PROPERTIES CONFIGURATIONS

CONFIGURING PRINTER MAPPINGS

Lexmark & Lexmark Partner Internal Use Only

Lexmark & Lexmark Partner Internal Use Only

Lexmark & Lexmark Partner Internal Use Only

Once a printer has been added, it appears in the list.

on the same line as the printer. It can be edited by clicking the