PrinterOn Enterprise Installation Guide Enterprise Installation Guide | 4 1. Introduction This guide...

PrinterOn Enterprise Installation Guide

Version 2.5 Doc Rev: 1.1

PrinterOn Enterprise Installation Guide | 2

1. Introduction .......................................................................................................................................................4

2. Before you begin ...............................................................................................................................................5 2.1. System requirements ....................................................................................................................................5 2.2. Recommended Applications .........................................................................................................................5 2.3. Email Print Support .......................................................................................................................................5

2.3.1. Microsoft Exchange using MAPI .............................................................................................................5 2.3.2. IMAP4 .....................................................................................................................................................6 2.3.3. IBM Domino Server using Notes API......................................................................................................6

2.4. Other requirements .......................................................................................................................................7

3. Setting up your PrinterOn Enterprise Server .................................................................................................8 3.1. Your PrinterOn account .................................................................................................................................8 3.2. Add printers ...................................................................................................................................................8 3.3. Retrieve your License file ..............................................................................................................................9

4. Installing and Configuring the PrinterOn Enterprise software .................................................................. 10 4.1. Install the PrinterOn Enterprise software ................................................................................................... 10 4.2. Map physical Printer Connections using Print Delivery Station ................................................................. 11

4.2.1. Connect/Map printers To Print Delivery Station .................................................................................. 12 4.3. Central Print Services (CPS) Administrative Console ............................................................................... 15

4.3.1. Default Login Information ..................................................................................................................... 15

5. Testing the configuration .............................................................................................................................. 17

6. Enterprise Server Configuration and Customization ................................................................................. 20 6.1. Configure Enterprise Authentication and User Lookup options ................................................................. 20

6.1.1. Configure LDAP/Active Directory Authentication in CPS .................................................................... 20 6.1.2. Configure Email Lookup Services........................................................................................................ 21

6.2. Configure Cloud Print Service Information ................................................................................................. 22 6.2.1. Configure the Print Service URL .......................................................................................................... 22 6.2.2. Configure Authentication Services (LDAP or Active Directory Authentication) ................................... 22

7. Print Delivery Gateway Configuration .......................................................................................................... 24 7.1. Deployment Overview ................................................................................................................................ 24 7.2. Enabling Printers for iOS Devices .............................................................................................................. 25

7.2.1. Authentication and Guest Printing ....................................................................................................... 25

8. Email Printing ................................................................................................................................................. 26 8.1. Prerequisites for Email Printing .................................................................................................................. 26

8.1.1. MAPI Prerequisites (with Outlook installed) ........................................................................................ 26 8.1.2. MAPI Prerequisites (without Outlook installed) ................................................................................... 27 8.1.3. IMAP4 Prerequisites ............................................................................................................................ 27 8.1.4. SMTP Prerequisites ............................................................................................................................. 27 8.1.5. IBM Domino Server Prerequisites ....................................................................................................... 27

8.2. Configuring Email Printing .......................................................................................................................... 28 8.2.1. MAPI Configuration .............................................................................................................................. 29 8.2.2. IMAP4 Configuration ............................................................................................................................ 29 8.2.3. Lotus Domino Configuration ................................................................................................................ 30 8.2.4. SMTP Configuration............................................................................................................................. 31

9. Appendix A – Additional Configuration Information .................................................................................. 32 9.1. Configuring Internet Explorer Enhanced Security ...................................................................................... 32 9.2. CPS API Keys and Access ........................................................................................................................ 32


10. Appendix B – Silent/Unattended Installation .............................................................................................. 33 10.1. Unattended Install Examples: ................................................................................................................... 33

Trademarks and Servicemarks ............................................................................................................................ 34

Copyright Notice .................................................................................................................................................... 34


1. Introduction

This guide explains how to install and configure the PrinterOn Enterprise Server.

PrinterOn Enterprise allows your users to print without installing drivers and without a difficult setup or

complicated configuration. Using the PrinterOn Enterprise web page, users submit print jobs to any printer that

you enable within your PrinterOn Enterprise Service.

The PrinterOn Enterprise software consists of several components that work together to enable web-based

printing from PCs and laptops with Internet access. Components installed with PrinterOn Enterprise include:

PrinterOn Central Print Services (CPS) web services – includes the CPS web printing pages, which you

host on your network to allow uploading of documents to the service, and the CPS Administration

Console

PrinterOn PrintAnywhere server – adds Internet and wireless printing into your web services or back-end

applications

PrinterOn Print Delivery Station – collects print jobs and provides privacy release capability

PrinterOn Print Delivery Gateway – provides support for printing from a variety of devices and systems

including iOS, Google Cloud Print compatible applications or traditional print queues.

The PrinterOn Enterprise Solution can be configured for several popular system integration models or customized

as needed using the available HTML and Java source code. PrinterOn Enterprise is easy to deploy and may be

hosted in multiple local or remote network scenarios. PrinterOn Enterprise has been designed for optional

integration with existing network infrastructures, including LDAP and Print Management Systems.


2. Before you begin

Prior to starting the setup of your PrinterOn Enterprise Server, please review all of the system requirements,

recommended applications to install and other installation requirements.

2.1. System requirements

You must have local administrator access on the computer which will run the PrinterOn Enterprise software. The

administrator account must have a password (blank password is not allowed). It is suggested that you create a

dedicated PrinterOn Service user account.

PrinterOn recommends the following minimum system requirements for the computer running the PrinterOn

Enterprise software:

A dedicated physical server or virtual machine

Intel compatible processor with 2GHz multi-core processor

2 GB RAM minimum (4 GB recommended)

2 GB of free disk space for PrinterOn Enterprise software and third party applications

Windows Server 2008 including 2008R2 (32 or and 64-bit) with current patches installed

‒ All Editions supported except HPC

Windows Server 2012 including 2012R2 (with current patches installed)

‒ All Editions supported

Internet Explorer 9 or greater, with current patches installed

Internet access is available at all times

NOTEL: IIS (Internet Information Services) must be disabled if installed; otherwise the Apache/Tomcat Web

Server must be configured to run on a port other than 80

2.2. Recommended Applications

To ensure compatibility and highest quality print output, installing the following applications on the PrinterOn

Enterprise server is highly recommended:

Microsoft Office, with current patches installed (Word, Excel, PowerPoint, Visio).

LibreOffice 4 or OpenOffice 4 later (PrinterOn recommends using LibreOffice for improved document

quality)

‒ If you require OpenOffice, you must install OpenOffice v4.0 or later.

‒ Please note: PrinterOn Enterprise is capable of printing Microsoft Office documents with

OpenOffice or LibreOffice

Ensure that each application is fully installed and activated using the PrinterOn Service user account before

installing the PrinterOn Enterprise software.

2.3. Email Print Support

PrinterOn Enterprise supports three email protocols; select the option that best fits your environment.

2.3.1. Microsoft Exchange using MAPI

MAPI is Microsoft’s proprietary messaging API. Use this if your server does not support the IMAP4

protocol.


PrinterOn Enterprise uses a printer’s SMTP email address to determine the destination printer name,

therefore if using Exchange servers prior to 2007 ensure that SMTP services are enabled and the server

is capable of using SMTP addressing. X.400 addressing is not supported.

If using an existing corporate Exchange server for email printing as well, Exchange 2007 or later is

required. If using a separate Exchange server strictly for email printing, Exchange 2003 is supported.

PrinterOn Enterprise must be on the same Windows domain as the Exchange server to connect to the

server.

The PrinterOn Enterprise PasPort Windows service must be configured with user credentials that have

read and write access to the mailbox configured on the Exchange server.

2.3.2. IMAP4

IMAP4 is a commonly used protocol for Internet email; the PrinterOn Enterprise server may connect to

your mail server using IMAP4.

Most modern email servers support IMAP4 including Microsoft Exchange.

PrinterOn Enterprise will only respond to users using the SMTP, which must be enabled on your mail

server.

When supporting email printing, a mail server must be available and a dedicated email print mailbox should be

created. To fully support PrinterOn Enterprise email printing email addresses must be configured in one of 4

ways:

An email catchall configuration should be applied to the mail server. This will allow users to forward

messages to the mail server and all email print jobs will be directed to the pre-configured print mailbox.

Multiple email addresses configured for a single mailbox on your mail server. This is feasible when the

number of email addresses required is minimal.

If using Microsoft’s ActiveSync to enable mobile devices to connect to your Exchange server: Configure

individual mailboxes for each printer email address, and one central mailbox. For each printer mailbox,

“automatic e-mail forwarding” must be configured to automatically copy messages from the printer’s

mailbox to the central PrinterOn mailbox.

If using Lotus Notes Client integration, the Domino server must be configured to leverage the ‘Domino

Group’ feature. The Domino Group can be configured to function as a mailing list.

As part of the deployment, a dedicated mail server may be installed and deployed on the PrinterOn Enterprise

server. The hMailServer (www.hmailserver.com) is a free, Windows-based email server that is both simple to

install and configure. It may be used to enable email printing on your PrinterOn Enterprise Server.

2.3.3. IBM Domino Server using Notes API

Notes API is IBM’s proprietary access protocol that encompasses a set of subroutines and data

structures to grant third-party applications authorized access to Domino Server and Lotus Notes Client

databases.

In order to support Notes API integration, you must ensure that IBM Lotus Notes Client software is

installed on the PrintAnywhere Server and configured to do the following.

Establish communication with the IBM Domino Server.

Notes Client mailbox configured to receive emails.

http://www.hmailserver.com/


2.4. Other requirements

Printer manufacturers and model numbers for each device to be configured with CPS

You need to have all of the access information, such as print server pathnames (i.e. \\server\sharename)

and printer IP addresses, for the printers connected to your network


3. Setting up your PrinterOn Enterprise Server

Before you set up the PrinterOn Enterprise Server, please review all of the system requirements in the previous

section. This guide will walk through a common PrinterOn Enterprise deployment and assist in configuring a

recommended configuration.

To set up a PrinterOn Enterprise Server, you need to:

1. Obtain your license file

2. Add printers

3. Install the PrinterOn Enterprise software

4. Configure a common PrinterOn Enterprise setup including

a. LDAP/Active Directory authentication

b. Email Printing (including user lookup via your LDAP/AD server)

5. Test your PrinterOn Enterprise system

3.1. Your PrinterOn account

Before you can set up the PrinterOn Enterprise Server, you must have an active PrinterOn account at

www.printeron.com. PrinterOn will create an initial administrator account for you. These details will be emailed to

the main contact person. As an administrator, you can grant others admin privileges using their email address.

3.2. Add printers

This procedure explains only the most common options you need to set when adding a printer. After you verify

that your printing service is working correctly, you can further modify the printer settings to suit your needs.

To add a printer to your printing service:

1. Log in at www.printeron.com/administrators and click the Printers icon

2. On Your Campus/Enterprise Printers page, click Add a printer to your PrintSpot.

3. Under Required Settings, fill out the Printer Configuration settings. NOTE: If you do not see your printer

model listed, choose a Generic emulation driver that your printer supports. For example, PostScript or

PCL.

4. Under “Descriptive Printer Label”, enter a description for where the printer is physically located. This will

be displayed to users.

5. Under Using your printer with Web, PrintWhere and Email Printing, in the “PrinterOn Name” field,

enter something similar to the Descriptive Printer Label. This will become part of the printer’s email

address.

6. Go into the Optional Settings tab now and ensure the Releasing Print Jobs section is set to an

appropriate selection:

a. Automatically when they arrive: If print release is handled through a print management system or if there is no print release.

NOTE: If using a third party print management solution to provide additional job tracking or auditing

services, select “Automatically when they arrive”. This will deliver jobs directly to the managed print queue

without requiring a user to release the print jobs.

http://www.printeron.com/administrators


b. Using a PrinterOn solution or HotSpot printer: If jobs are to be released securely through

PrinterOn, via the PrintValet keypad or a Remote Queue Monitor.

7. Ensure the Advanced Integration Options section is configured as required.

a. 3rd Party Integration: If the print management system you use is available, select it from the

Print Management Server dropdown.

b. Enable Advance Integration Features: If advanced integration is being used, enable this option.

Do not enable if you are unsure whether advanced integration is being used. Contact your Print

Management company to verify.

c. Enable Printer Based authorization integration: This is available if integrating with Konica-

Minolta SecurePrint for secure release on the KM MFP.

8. Under Print Delivery Station, set “Use an alternate/local Print Delivery Hub” to host print jobs and enter

the internal IP address or DNS name of the server where PDS will be installed.

9. Click Save at the bottom of the screen.

You can repeat the above steps to create your other printers.

Next, you must obtain your PrinterOn license file.

3.3. Retrieve your License file

After your PrinterOn account has been created, you will receive an email message with your license file attached.

Save the text file attachment in a location that is accessible to the computer where you will install the PrinterOn

software.


4. Installing and Configuring the PrinterOn Enterprise software

4.1. Install the PrinterOn Enterprise software

If you have not received the information about obtaining the software install files, please contact PrinterOn

Customer Support at [email protected].

Before you begin, verify:

You have your PrinterOn license file in a location that is accessible to the computer where you are

installing your server

Your Windows User Account is set to log on as local administrator and uses a non-blank password

‒ You have logged in as this user prior to starting the installation

Microsoft Office and/or LibreOffice/OpenOffice is installed on this computer, if required (see

Recommended Applications)

‒ Microsoft Office and/or LibreOffice/OpenOffice should be installed using the same Windows User

Account used to install PrinterOn Enterprise.

‒ Each application included with Microsoft Office and/or LibreOffice/OpenOffice should be started

once to ensure all startup processes are complete.

IIS (Internet Information Services), if installed, is disabled

The Windows Print Spooler service is set to start automatically

Internet access is available from the server

Ports 80, 443 are open through any proxies or firewalls

To install the software:

1. Using the link sent to you, download and save the installation file, EnterpriseInstall_xx.exe

2. Run EnterpriseInstall_xx.exe

3. Click Next.

4. Review the important messages and verify you are ready to proceed. Click Next to continue the

installation or Cancel to end the installation.

5. Click Yes to accept the License Agreement. You must accept the License Agreement to proceed with the

installation.

6. In the “Setup Files Installation Directory” window, click Next.

a. NOTE: If you choose a new directory, this is only where the setup files will be placed. It is not

the installation directory.

7. In the “License Summary File” window, browse to your PrinterOn license file and select it. Click Next.

8. Under “Setup Type”, choose Typical and click Next.

9. If there are any notes or warnings on your installation, they are displayed. Click Next.

10. Select an install directory for Apache Tomcat and click Next.

a. NOTE: This will choose the installation directory for Apache Tomcat only; all other components

are installed on the C: drive.

11. In the “Account Information” window, enter the local administrator’s account information. This is the user

PrintAnywhere will run as.

12. If the “Serial Number” window opens, select the serial number for the PrintAnywhere Server to be

installed. Click Next.

13. The setup begins to install components.

14. At the end of the installation, you must reboot the computer.

mailto:[email protected]?subject=Request%20CPS%20FTP%20information


You now need to set several options in the Print Delivery Station (PDS), PrintAnywhere Server and the Central

Print Services (CPS) software.

4.2. Map physical Printer Connections using Print Delivery Station

The Print Delivery Station (PDS) collects the print jobs and releases them to your printers. You must configure

PDS and map your printer paths.

To configure PDS for Enterprise printing:

1. To open the Print Delivery Station console, double-click the PDS icon in your system tray.

If PDS does not appear in your system tray, open the Print Delivery Station from your Start menu (Start >

Programs > Print Delivery Station)

2. Click Settings.

3. On the “Import Settings” tab, click Import Customization File.

4. Enter your PrinterOn username/email address and password – these are the same as your login for our

website.

If you only have a single printing service configured with PrinterOn, this dialog will not be displayed.


If you have more than one printing service, PDS will display the names and serial numbers for all of your

services and allow you to choose which file to import. Select the required file and click OK.

4.2.1. Connect/Map printers To Print Delivery Station

1. To correctly configure your printers in Print Delivery Station, you must enter the local port or network

printer paths.

2. On the “Printers” tab, select a printer and click Edit.

3. In the Local Name field, first choose a protocol if it is known.


4. Then, enter the local port or network printer path for the printer (such as HP LaserJet P3015, or

\\server\sharename). Alternately, browse for a print queue using the “…” button.

NOTE: Hold shift while pressing this button to deselect Local or Network searching. This can speed up

the search process.

5. Click OK.

6. Click OK in the PDS Settings window to save your Printer changes.

7. If required, enter your PrinterOn account credentials and click OK.

You can repeat the above steps to configure each printer. PrinterOn recommends configuring one printer

and fully testing before configuring the rest of your printers.

8. In the PDS console window, click Start.


Once PDS is running (the logo graphic is animated), you can close the console.


4.3. Central Print Services (CPS) Administrative Console

This section provides an overview of the available options in the CPS Administration Console. The CPS

Administration Console allows you to configure all CPS settings, administer and synchronize printer settings and

change your admin password.

To open the CPS Administration Console pages:

1. Choose Start > All Programs > PrinterOn Corporation > Central Print Services > CPS Admin Page

a. Or go to http://127.0.0.1/cps/admin

2. On the Login Page, enter your Login Name and Password.

4.3.1. Default Login Information

The first time you log in, your Login Name is:

Login Name: cpsadmin

Password: cps.

The default API credentials are:

CPS API User Name: apiuser

CPS API Password: apipassword

3. You will be prompted to change your Login Name and Password the first time you log in.

http://127.0.0.1/cps/admin


4. Save your settings

5. Select the Printers Tab to review your printer configuration and confirm your license information has been

validated correctly.

NOTE: Whenever you make changes to any of your printer listings at printeron.com, you should always

open the CPS Admin page and click Synchronize with PrinterOn in the Printers tab.

If your license has been successfully imported, you should see one or more printers in the list.


5. Testing the configuration

Now that your software is set up, you can send your first print job to ensure that everything is working properly.

1. Choose Start > All Programs > Central Print Services > CPS Home Page

a. or visit http://localhost/cps.

2. On the CPS Home Page, click the Print button.

3. Enter your Login ID and password for the local network if LDAP is enabled, and click Log In. If LDAP is

not enabled, enter any username and password.

4. On the Choose a Printer page, click on the printer you want to submit a print job to.

5. Select a document on your local computer or enter a web page to print.

http://localhost/cps


6. Specify the number of copies, page range and release code, if required.

7. Click Continue.

8. Select the desired page settings (paper size, duplex, orientation) and click Continue.

9. Wait while CPS submits your job. When you are asked to approve the job, click Submit Job to Printer.

10. Open PDS by double-clicking on the PDS icon in the system tray.


11. In the Print Delivery Station console, click Monitor.

The Queue Monitor opens and the job that you just submitted should appear in the list.

12. Verify your job printed correctly to the selected printer.

You have successfully completed the PrinterOn Enterprise Installation. Review the remaining sections of

the document to configure other print services such as authentication, email printing.

The PrinterOn Enterprise server provides a broad range of configuration options and scenarios. Review the

companion manuals and component documentation for more information about how to integrate PrinterOn

Enterprise into your environment.


6. Enterprise Server Configuration and Customization

6.1. Configure Enterprise Authentication and User Lookup options

For complete details on CPS options, see the guide titled CPS Administrator Guide.

6.1.1. Configure LDAP/Active Directory Authentication in CPS

To configure LDAP or Active Directory authentication for use with your PrinterOn Enterprise server, some specific

information will be required regarding your local LDAP/AD configuration.

1. Ensure you are logged into CPS.

2. Click on the Authentication tab to access the LDAP Authentication Configuration

a. Give your LDAP configuration a Name. This is helpful when configuring authentication across

multiple domains.

b. Choose Advanced – Enabling this option will provide user account validation capabilities as well

as additional services such as locating user identities using a supplied email address.

c. Provide the necessary information such as the Bind DN (and password if required).

d. Supply the Search DN values. This DN will be used to locate user information such as the user’s

account name if printing via email.

e. Enter User Email Attribute, User ID Attribute and Domain Name.

f. Save Settings using a link to the right, or at the top of the page.

3. If you are integrating with a third party print management service, ensure that “Include user network login

with jobs” is enabled on the Advanced tab. This option will associate print jobs with the authenticated

user and allow for job tracking with most print management services.

NOTE: Using the Advanced LDAP functionality provides the greatest flexibility when enabling other

services such as email printing. Using this authentication type will simplify adding services such as email

printing in the future.


6.1.2. Configure Email Lookup Services

When the PrinterOn Enterprise Server is integrated with a 3rd party print management solution it is important to

associate user information with the print job to ensure proper tracking of print jobs. When also supporting email

printing additional steps must be taken to locate and link the user’s account information with their email address.

The PrinterOn Central Print Services provides the necessary services to allow the PrintAnywhere Server (that is

responsible for processing email print jobs) to request user information from the email address of a received print

job.

To configure the PrintAnywhere server you must configure it to communicate and access information from the

CPS server.

The following configuration will provide the most commonly used configuration mode. Additional details that may

pertain to your configuration are available in the PrintAnywhere Administrator Guide.

1. Choose Start > All Programs > PrinterOn Corporation > PrintAnywhere > Configuration Tool

2. Select the “Advanced” section and choose the “Integration” tab

3. Under the “Integration Type” drop down select “User Lookup”

4. Enter the IP address or domain name of your CPS Server and append /cps/cpsapi

a. Example: http://print.company.com/cps/cpsapi

5. Enter the username, password and API key created previously in CPS to the supplied fields

6. Click Test and populate the supplied fields to confirm whether PrintAnywhere can successfully locate

user information for email print jobs

http://print.company.com/cps/cpsapi


6.2. Configure Cloud Print Service Information

To minimize the configuration process and simplify the discovery of printers and their capabilities it is important to

configure some information in the PrinterOn Directory. The PrinterOn Directory is used to push basic integration

information to print clients and destinations and initiates further automated integration.

6.2.1. Configure the Print Service URL

The Print Service URL is the IP address or domain associated with your Central Print Services. It will be used to

provide search, authentication of web printing services and mobile printing services. When configuring this URL

ensure that it can be accessed by all clients who may use your printing service including web browsers or mobile

applications both internal and external to your network.

1. Log in at www.printeron.com/administrators and click the Service Details icon .

2. Scroll to the “Account Profile” section.

3. Enter the IP address or domain name of your CPS server.

4. Select https:// if you have configured an SSL certificate.

6.2.2. Configure Authentication Services (LDAP or Active Directory Authentication)

To leverage the CPS Server’s built in authentication services for all printing clients, some information must first be

configured in the PrinterOn Directory to publish the information. Before continuing, ensure you have access to

the CPS Server’s Service URL.

1. Log in at www.printeron.com/administrators and click the Printers icon .

2. Identify your desired printer and select the “Payment and Authorization” section.

3. Locate the Authorizing users section and enable “Redirect to authorize user, track pages or bill

customer.” Enabling this option will provide additional configuration options.

NOTE: By default a self-signed certificate is included with your Enterprise server to ensure its security It

is strongly recommended that you create and install a valid SSL certificate on your CPS Server. When

configuring the Service URL you will be able to configure whether the service supports SSL or not.




4. Enable the “User Authentication URL” - in the provided field enter the IP address or domain name for

your CPS server along with “/cps/aaaLogin.jsp”

a. Example: http://cps.server.com/cps/aaaLogin.jsp

5. Save your settings.

NOTE: These settings inform print clients such as the PrintWhere driver where to locate authentication

services. For simple Web or mobile print jobs this informs CPS that the authentication services are local

and hosted by CPS itself.

If you require custom authentication services, PrinterOn enables you to develop your own authentication

module and direct CPS to your custom authentication module using this same method.

http://cps.server.com/cps/aaaLogin.jsp


7. Print Delivery Gateway Configuration

The Print Delivery Gateway is an extension of the PrinterOn Enterprise server that enables iOS devices to submit

print jobs directly to PrinterOn Enterprise.

The Print Delivery Gateway advertises selected PrinterOn Enterprise printers on the network.

7.1. Deployment Overview

The Print Delivery Gateway creates a bridge to your PrinterOn Enterprise printers. Printers are configured and

enabled in the Central Print Services (CPS) administrative dashboard on the Enterprise server. From there you

may enable individual or multiple printers and configure whether authentication is required for the printers.

The Print Delivery Gateway acts as a relay for print jobs and securely delivers print jobs to the Enterprise server.

This module approach extends advanced capabilities to the solution including:

LDAP/Active Directory authentication – including multiple concurrent authentication services

User-based access control

Print management integrations

Guest print workflows

In addition to providing the capabilities above, PDG and the Enterprise extends a network to reach printers in

different networks and even different countries by leveraging the flexible print delivery infrastructure included in

PrinterOn Enterprise.


7.2. Enabling Printers for iOS Devices

Support for printers is managed in CPS, under the Printers Tab. Enabling a printer for iOS device printing is as

easy as selecting the “Discover” checkox for the intended printer.

The Print Delivery Gateway will automatically update its configuration during its next scheduled synchronization

automatically. No additional configuration is required,

7.2.1. Authentication and Guest Printing

Authentication for printers is controlled along with all authentication services. If either LDAP/AD or PrinterOn ACL

authentication is enabled on the Enterprise server, users will be prompted for their authentication credentials.

Authentication may be disabled for any printer by also enabling Guest printing for the printer.

NOTE: PrinterOn Enterprise only supports LDAP/AD or PrinterOn ACL authentication. Single Sign On and

PrinterOn Job Accounting API are not supported.


8. Email Printing

8.1. Prerequisites for Email Printing

To configure your server to accept email print jobs, you will need to configure some details in PrintAnywhere.

When configuring your mail service it is important to know prior to configuring what method your service will use

to connect to the mail server. Options include Microsoft’s Messaging APIs (MAPI), IMAP4 mail protocol and

Notes API. The PrinterOn Enterprise Server uses the standard SMTP protocol for sending emails for both IMAP4

and MAPI installations.

8.1.1. MAPI Prerequisites (with Outlook installed)

If you have installed Microsoft Office with Outlook on the PrinterOn Enterprise server, Microsoft Outlook may be

used to assist configuring and testing the Exchange mail profile to be used by the Enterprise server. When

communicating with MAPI, the PrinterOn Enterprise Server will use a pre-configured Microsoft Mail Profile to

communicate with the Exchange Server.

1. Start the “Mail” Windows Control Panel.

2. In the “Mail Setup” dialog box, click Show Profiles.

3. On the “General tab”, under “When starting Microsoft Office Outlook, use this profile”, click Prompt for a

profile to be used, and then click Add.

4. In the “Profile Name” box, type the name that you want to use for the new email profile, and then click

OK.

5. In the “E-mail Accounts” dialog box, click Add a new e-mail account, and then click Next.

6. Click the appropriate server type for your new email account, this should be Microsoft Exchange, and

then click Next.

7. Type your account information in the required boxes, and then click Next.

8. Click Finish, and then click OK.

Test the Mail Profile

The PrinterOn Enterprise Server will use this newly created mail profile to communicate with the Exchange

Server. The simplest way to test the profile is to launch Microsoft Outlook, select the newly created profile and

confirm that Outlook can successfully communicate with the Exchange Server.

From another source you may send an email to the mailbox and confirm using Outlook that the email arrived at

the mail server.

NOTE: Microsoft Exchange supports both MAPI and IMAP4 protocols, if your Exchange server is located

on a separate domain than the PrinterOn Enterprise Server or you encounter other difficulties configuring

your mail server, enabling IMAP4 may assist.

NOTE: When creating the Mail profile with the steps below, you must be logged into the server as the

user who will be running the PrintAnywhere services. This user should be both a local admin, and an

admin of the mailbox you’ll be using with the mail profile.


8.1.2. MAPI Prerequisites (without Outlook installed)

In order to support MAPI communication, you must ensure that MAPI is installed on the PrintAnywhere Server.

MAPI is not included with a Microsoft Windows installation and must be installed separately.

When communicating with MAPI, the PrinterOn Enterprise Server will use a pre-configured Microsoft Mail Profile

to communicate with the Exchange Server.

If you are installing PrintAnywhere without Outlook installed you must download Microsoft’s MAPI installer

from Microsoft’s website.

‒ http://www.microsoft.com/download/en/details.aspx?id=1004

When communicating with MAPI, the PrinterOn Enterprise Server will use a pre-configured Microsoft Mail Profile

to communicate with the Exchange Server. When Microsoft Outlook is not installed, PrinterOn has supplied a

small utility to assist in creating the required mail profile.

1. Browse to the PrinterOn PrintAnywhere Server installation Directory

a. i.e. C:\Program File\PrinterOn Corporation\PrintAnywhere

2. Locate and launch the “CreateProfile” application

a. NOTE: The “CreateProfile” application is a small utility that launches Microsoft’s built in mail

profile wizard. When Outlook is not installed this application may be used to launch the wizard.

3. Follow the steps provided by the wizard to create a new mail profile.

8.1.3. IMAP4 Prerequisites

To use PrinterOn’s IMAP4 connector for email printing the following information is required to configure the

server:

A mailbox and account created on the IMAP4 server.

Username and password associated with the mailbox created on the mail server.

The IMAP4 server name or IP address and communication port (if not the default).

8.1.4. SMTP Prerequisites

The PrinterOn Enterprise server uses the SMTP protocol to respond to users after processing email print jobs.

SMTP is used to respond to users for both MAPI and IMAP4 implementations. To successfully respond to users

the following information is required:

The SMTP server name or IP address and communication port (if not the default)

Username and password required to deliver emails from the SMTP server (if required).

8.1.5. IBM Domino Server Prerequisites

To use PrinterOn’s Domino connector for email printing the following information is required to configure the

server:

NOTE: Do NOT install MAPI if you have installed Microsoft Outlook. PrinterOn does not recommend or

support installing the PrinterOn Enterprise server on a server that is also running as an Exchange Server.

http://www.microsoft.com/download/en/details.aspx?id=1004


A mailbox created on the Domino server.

Password information associated with the mailbox created on the mail server.

The Domino server name or IP address (For Domino Address Book LookUp feature).

The following are the guidelines recommended by PrinterOn for Domino Server Mailbox creation.

Last Name <PrinterOn Printer Object Name> Ex: Print2Lobby, IBM-Printer-45

First Name <Leave it blank>

Middle Name <Leave it blank>

Short Name

<Do not modify>

The Domino server admin application is expected to set it to match the ‘Last Name’

entered. If it does not, please consider changing the ‘Last Name’ or ‘PrinterOn Printer

Object Name’.

SMTP Address

<Do not modify>

The Domino server admin application is expected to make use of the ‘Last Name’

information entered. The SMTP Address format will most likely match

‘LastName@Domain’. Please ensure that this SMTP address is unique in your

directory. If the SMTP address, thus formed using the format ‘LastName@Domain’ is

already taken up or the Domino server suggests a different SMTP address, please

consider changing the ‘Last Name’ and the ‘PrinterOn Printer Object Name’.

If the mailbox account is created using the recommendations made above and the PrintAnywhere server

application is configured to leverage the ‘Domino Address Book LookUp‘ feature, it will help avoid problems

pertaining to printer name resolution.

To fully support PrinterOn Enterprise email printing to multiple email addresses, the Domino server must be

configured to leverage the ‘Domino Group’ feature. Creating a Group in the Domino world involves launching

the Domino Server Administrator application and creating a new Group Document in the Domino Directory. After

the Group document is created, modify the ‘Group Type’ property value to ‘Mail Only’. This will allow the group

to function as a mailing list. There is no limit to the number of Domino user accounts that you can attach to a

group.

8.2. Configuring Email Printing

To configure your server to accept email print jobs, you will need to modify some details in PrintAnywhere.

Choose Start > All Programs > PrinterOn Corporation > PrintAnywhere > Configuration Tool

Select the “Email Plugins” section and enable either Use Microsoft Exchange (for MAPI integrations) or

Use IMAP4


8.2.1. MAPI Configuration

1. Select the Mail Profile created for the PrinterOn Enterprise Server

2. The Configuration Utility will attempt to determine the default address configured for the mailbox

associated with the mail profile. If one cannot be determined the “Response Address” field will be left

blank.

3. You may manually enter the response address by selecting the “Override default” option. This will ensure

that the server does not respond to email print jobs sent to this address.

4. Leave “Accept request to response address” unchecked.


8.2.2. IMAP4 Configuration

1. Enter the IP address or host name of your IMAP4 server.

2. The configuration tool will automatically set the default IMAP4 port; supply an alternate if this does not

match your server configuration.

NOTE: When configuring the mailbox for your email print account, it is recommended that the primary or

default address for the mailbox is set to an email address such as [email protected]. The

PrintAnywhere Server will respond using this email address. If any requests are submitted to this email

address the server will ignore them and automatically delete them. This ensures that incorrectly

configured mail clients that mail automatic responses to the mailbox do not receive additional responses

from the server.

mailto:[email protected]


3. Enter the username and password associated with the mailbox created on the mail server.

4. Enter the default email address associated with the mailbox.


6. Click Test to confirm the configuration settings.

8.2.3. Lotus Domino Configuration

In order to configure the PrintAnywhere server to start retrieving jobs from the Domino Server, you must first

ensure that IBM Lotus Notes Client application is installed on the same machine and the client mailbox is

configured to receive emails.

Lotus Notes MUST be installed and configured as a “Single-User” installation. This type of installation would

allow both the Notes executable files and the Domino User Account data files to be stored in directory locations

that are accessible to the PrinterOn Service

The “Multi-User” installation mode is NOT supported

1. Enter the IP address or host name of your Domino server. This information is used by the Domino

Address Book Look-up feature to retrieve the SMTP address of the recipient.

2. Enter the mailbox account password information that will be used to connect to the Domino server and

monitor the incoming mailbox.

3. Enter the email address that will be used by the mail server when responding to email job requests.

4. You may choose to specify the destination PrinterOn printer name that will be used for all incoming email

job requests.

5. Specify the Lotus Notes (Notes.ini) configuration file path. This file is usually found inside “C:\Program

Files(x86)\IBM\Lotus\Notes”

6. Click Synchronize to confirm and apply the configuration settings.



8.2.4. SMTP Configuration

1. Enter the IP address or host name of your SMTP server.

2. The configuration tool will automatically set the default SMTP port; supply an alternate if this does not

match your server configuration.

3. Enter the username and password required to deliver emails using the SMTP server (if required).

4. Enter the Name you wish to appear on emails sent from the PrinterOn Enterprise Server.

5. Enter the Email Address you wish to appear on emails sent from the PrinterOn Enterprise Server.

6. Enter the Reply-To Email Address you wish to appear on emails sent from the PrinterOn Enterprise

Server.


8. Click Test to confirm the configuration settings.

NOTE: The Reply-To is generally the same as the SMTP Sender Address. It should also match the

default email address associated with the inbound mailbox. This will assist in ensuring that unwanted

emails are not processed by the server.


9. Appendix A – Additional Configuration Information

9.1. Configuring Internet Explorer Enhanced Security

In order to print web pages that are submitted through CPS, Internet Explorer’s Enhanced Security must be

disabled. The server will need to be able to connect to and open the URL a user submits.

9.2. CPS API Keys and Access

To communicate with CPS, PrintAnywhere and the Print Delivery Gateway must be given access rights and

credentials to request user information. The following section will describe the steps necessary to create the API

credentials to be configured in PrintAnywhere or PDG.

1. Ensure you are logged into CPS.

2. Click on the Admin tab and scroll to the “CPS API Management” section.

3. Under the “API Users” section click Add User.

4. Enter a new username and password for the CPS API user. This information will later be set in the

PrintAnywhere Configuration tool. (This will be described in detail further in this documentation.)

5. Under the “API Access Keys” click Generate.

NOTE: The username, password and API key will be configured in the PrintAnywhere server. In order to

request user information, PrintAnywhere must first authenticate itself using these credentials. Please note

that PrintAnywhere does not transfer the password directly to CPS to authenticate. It will instead use the

API key to generate an encrypted token used to verify the API credentials. Changing or removing any of

the three values will disallow API access.


10. Appendix B – Silent/Unattended Installation

It is possible to automate the Enterprise server installation process. This may be done using the following

command line arguments.

Argument Description

Mode

Used to indicate that the installation should be performed automatically. The value

must be set to

Auto

InstallType

Indicates the type of installation being performed. Accepted values:

Install

Upgrade

Uninstall

Note: Modifying the installation is not supported

ConfigFile Indicated the fully qualified path to the PrinterOn License Configuration file

UserName Indicates the Local Administrator user account that will be used to run the Enterprise

services. This account will be used to configure and run Window Services

Password

Indicates the password associated with Local Administrator user account that will be

used to run the Enterprise services. This account will be used to configure and run

Window Services.

NOTE: Arguments are separated by vertical lines (pipes)

10.1. Unattended Install Examples:

Install/Repair/Upgrade/Downgrade

EnterpriseInstall.exe "Mode:Auto|InstallType:Install|ConfigFile:\\server\folder\Config.txt|UserName:WIN-

PEIFB69833B\Administrator|Password:password"

EnterpriseInstall.exe "Mode:Auto|InstallType:Install|ConfigFile:C:\Config-Test.txt|UserName:WIN-

EIFB69833B\Administrator|Password:password"

Uninstall (Remove All)

EnterpriseInstall.exe "Mode:Auto|InstallType:Uninstall"

NOTES:

The installation process MUST be performed with Local Administrator rights when launching the

installer from the command line.

The server must be restarted after the installation is completed


Trademarks and Servicemarks

The following are trademarks or registered trademarks of PrinterOn Corporation in Canada and other countries:

PrinterOn, PrintSpots, PrintWhere, PrintAnywhere, “Print Simply Anywhere”, the PrinterOn “bird”, the PrinterOn

Logotype and the PrinterOn Signature.

The following are trademarks or registered trademarks of other companies:

Windows, Internet Explorer, Microsoft Word, Microsoft Excel, Microsoft PowerPoint, and Microsoft Visio are

trademarks or registered trademarks of Microsoft Corporation.

iPad, iPhone and AirPrint and OS X are trademarks or registered trademarks of Apple.

iOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used by Apple under

license.

Android, Chrome OS and Chromebook are trademarks or registered trademarks of Google Inc.

BlackBerry is a registered trademark of Research in Motion Limited.

Other brands and their products are trademarks or registered trademarks of their respective holders.

Copyright Notice

© Copyright 2015 by PrinterOn Inc.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in

any form or by any means, electronic, mechanical, photocopy, recording, or otherwise, without the prior written

permission of PrinterOn Inc.

Disclaimer:

PrinterOn Inc. makes no warranty with respect to the adequacy of this documentation, programs, or hardware,

which it describes for any particular purpose, or with respect to the adequacy to produce any particular result. In

no event shall PrinterOn Inc. be held liable for special, direct, indirect, or consequential damages, losses, costs,

charges, claims, demands, or claim for lost profits, fees, or expenses of any nature or kind.

Date post:	09-Mar-2018
Category:	Documents
Upload:	trannhan
View:	223 times
Download:	2 times

PrinterOn Enterprise Installation Guide Enterprise Installation Guide | 4 1. Introduction This guide...

Documents