PrinterOn Enterprise Installation Guide

Transcription

1 PrinterOn Enterprise Installation Guide Version 2.5 Doc Rev: 1.1

2 1. Introduction Before you begin System requirements Recommended Applications Print Support Microsoft Exchange using MAPI IMAP IBM Domino Server using Notes API Other requirements Setting up your PrinterOn Enterprise Server Your PrinterOn account Add printers Retrieve your License file Installing and Configuring the PrinterOn Enterprise software Install the PrinterOn Enterprise software Map physical Printer Connections using Print Delivery Station Connect/Map printers To Print Delivery Station Central Print Services (CPS) Administrative Console Default Login Information Testing the configuration Enterprise Server Configuration and Customization Configure Enterprise Authentication and User Lookup options Configure LDAP/Active Directory Authentication in CPS Configure Lookup Services Configure Cloud Print Service Information Configure the Print Service URL Configure Authentication Services (LDAP or Active Directory Authentication) Print Delivery Gateway Configuration Deployment Overview Enabling Printers for ios Devices Authentication and Guest Printing Printing Prerequisites for Printing MAPI Prerequisites (with Outlook installed) MAPI Prerequisites (without Outlook installed) IMAP4 Prerequisites SMTP Prerequisites IBM Domino Server Prerequisites Configuring Printing MAPI Configuration IMAP4 Configuration Lotus Domino Configuration SMTP Configuration Appendix A Additional Configuration Information Configuring Internet Explorer Enhanced Security CPS API Keys and Access PrinterOn Enterprise Installation Guide 2

3 10. Appendix B Silent/Unattended Installation Unattended Install Examples: Trademarks and Servicemarks Copyright Notice PrinterOn Enterprise Installation Guide 3

4 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. PrinterOn Enterprise Installation Guide 4

5 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 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 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 Print Support PrinterOn Enterprise supports three protocols; select the option that best fits your environment Microsoft Exchange using MAPI MAPI is Microsoft s proprietary messaging API. Use this if your server does not support the IMAP4 protocol. PrinterOn Enterprise Installation Guide 5

6 PrinterOn Enterprise uses a printer s SMTP 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 printing as well, Exchange 2007 or later is required. If using a separate Exchange server strictly for 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 IMAP4 IMAP4 is a commonly used protocol for Internet ; the PrinterOn Enterprise server may connect to your mail server using IMAP4. Most modern 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 printing, a mail server must be available and a dedicated print mailbox should be created. To fully support PrinterOn Enterprise printing addresses must be configured in one of 4 ways: An catchall configuration should be applied to the mail server. This will allow users to forward messages to the mail server and all print jobs will be directed to the pre-configured print mailbox. Multiple addresses configured for a single mailbox on your mail server. This is feasible when the number of 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 address, and one central mailbox. For each printer mailbox, automatic 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 ( is a free, Windows-based server that is both simple to install and configure. It may be used to enable printing on your PrinterOn Enterprise Server 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 s. PrinterOn Enterprise Installation Guide 6

7 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 PrinterOn Enterprise Installation Guide 7

8 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. 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 PrinterOn will create an initial administrator account for you. These details will be ed to the main contact person. As an administrator, you can grant others admin privileges using their address 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 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 Printing, in the PrinterOn Name field, enter something similar to the Descriptive Printer Label. This will become part of the printer s 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. PrinterOn Enterprise Installation Guide 8

9 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 Retrieve your License file After your PrinterOn account has been created, you will receive an 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. PrinterOn Enterprise Installation Guide 9

10 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 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. PrinterOn Enterprise Installation Guide 10

11 You now need to set several options in the Print Delivery Station (PDS), PrintAnywhere Server and the Central Print Services (CPS) software 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/ 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. PrinterOn Enterprise Installation Guide 11

12 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 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. PrinterOn Enterprise Installation Guide 12

13 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. PrinterOn Enterprise Installation Guide 13

14 Once PDS is running (the logo graphic is animated), you can close the console. PrinterOn Enterprise Installation Guide 14

15 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 2. On the Login Page, enter your Login Name and Password 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. PrinterOn Enterprise Installation Guide 15

16 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. PrinterOn Enterprise Installation Guide 16

17 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 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. PrinterOn Enterprise Installation Guide 17

18 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. PrinterOn Enterprise Installation Guide 18

19 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, 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. PrinterOn Enterprise Installation Guide 19

20 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 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 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 . e. Enter User 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 printing. Using this authentication type will simplify adding services such as printing in the future. PrinterOn Enterprise Installation Guide 20

21 Configure 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 printing additional steps must be taken to locate and link the user s account information with their address. The PrinterOn Central Print Services provides the necessary services to allow the PrintAnywhere Server (that is responsible for processing print jobs) to request user information from the 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: 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 print jobs PrinterOn Enterprise Installation Guide 21

22 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 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. 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. 1. Log in at 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 if you have configured an SSL certificate 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 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. PrinterOn Enterprise Installation Guide 22

23 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: 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. PrinterOn Enterprise Installation Guide 23

24 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 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. PrinterOn Enterprise Installation Guide 24

25 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, 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. PrinterOn Enterprise Installation Guide 25

26 8. Printing 8.1. Prerequisites for Printing To configure your server to accept 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 s for both IMAP4 and MAPI installations. 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 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. 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. 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 profile, and then click OK. 5. In the Accounts dialog box, click Add a new account, and then click Next. 6. Click the appropriate server type for your new 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 to the mailbox and confirm using Outlook that the arrived at the mail server. PrinterOn Enterprise Installation Guide 26

27 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. 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. 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 IMAP4 Prerequisites To use PrinterOn s IMAP4 connector for 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) SMTP Prerequisites The PrinterOn Enterprise server uses the SMTP protocol to respond to users after processing 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 s from the SMTP server (if required) IBM Domino Server Prerequisites To use PrinterOn s Domino connector for printing the following information is required to configure the server: PrinterOn Enterprise Installation Guide 27

28 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 First Name Middle Name Short Name SMTP Address <PrinterOn Printer Object Name> Ex: Print2Lobby, IBM-Printer-45 <Leave it blank> <Leave it blank> <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. <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 Please ensure that this SMTP address is unique in your directory. If the SMTP address, thus formed using the format 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 printing to multiple 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 Configuring Printing To configure your server to accept print jobs, you will need to modify some details in PrintAnywhere. Choose Start > All Programs > PrinterOn Corporation > PrintAnywhere > Configuration Tool Select the Plugins section and enable either Use Microsoft Exchange (for MAPI integrations) or Use IMAP4 PrinterOn Enterprise Installation Guide 28

29 NOTE: When configuring the mailbox for your print account, it is recommended that the primary or default address for the mailbox is set to an address such as The PrintAnywhere Server will respond using this address. If any requests are submitted to this 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 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 print jobs sent to this address. 4. Leave Accept request to response address unchecked. 5. Save your settings 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. PrinterOn Enterprise Installation Guide 29

30 3. Enter the username and password associated with the mailbox created on the mail server. 4. Enter the default address associated with the mailbox. 5. Save your settings. 6. Click Test to confirm the configuration settings 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 s. 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 address that will be used by the mail server when responding to job requests. 4. You may choose to specify the destination PrinterOn printer name that will be used for all incoming 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. 7. Save your settings. PrinterOn Enterprise Installation Guide 30

31 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 s using the SMTP server (if required). 4. Enter the Name you wish to appear on s sent from the PrinterOn Enterprise Server. 5. Enter the Address you wish to appear on s sent from the PrinterOn Enterprise Server. 6. Enter the Reply-To Address you wish to appear on s sent from the PrinterOn Enterprise Server. 7. Save your settings. 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 address associated with the inbound mailbox. This will assist in ensuring that unwanted s are not processed by the server. PrinterOn Enterprise Installation Guide 31

32 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 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. PrinterOn Enterprise Installation Guide 32

33 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. 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 Argument Mode InstallType Description Used to indicate that the installation should be performed automatically. The value must be set to Auto 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 Indicates the Local Administrator user account that will be used to run the Enterprise UserName services. This account will be used to configure and run Window Services Indicates the password associated with Local Administrator user account that will be Password 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) 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" PrinterOn Enterprise Installation Guide 33

34 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. PrinterOn Enterprise Installation Guide 34