HP ePrint Enterprise Setup and Install

HP ePrint Enterprise

Administration Guide

Release 4.0

Microsoft, Windows, Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, and Windows Server 2012 R2 are U.S. registered trademarks of Microsoft Corporation in the United States and/or other countries.

BlackBerry®, RIM®, Research In Motion®, SureType® and related trademarks, names and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. Used under license from Research In Motion Limited.

iPhone® and iPad® are registered trademarks of Apple Inc.

Android™ is a trademark of Google Inc.

Good, Good Technology, Good Dynamics, and Good for Enterprise are trademarks of Good Technology Corporation and its related entities.

January 2015

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and

12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Table of contents

1 Introduction .................................................................................................................................................. 1

1.1 Login ................................................................................................................................................................ 1

2 Home section ................................................................................................................................................ 2

2.1 Overview Screen .............................................................................................................................................. 2

2.1.1 Main menu .................................................................................................................................. 2

2.1.2 Core Services Condition ............................................................................................................. 3

2.1.3 Jobs currently being processed ................................................................................................. 3

2.1.4 Last hour’s failed, cancelled, or filtered (not printed) jobs ....................................................... 3

2.1.5 Messages being processed ........................................................................................................ 3

2.1.6 Failed messages ......................................................................................................................... 3

2.1.7 Metrics from yesterday: Jobs per printer .................................................................................. 3

3 Manage printers ............................................................................................................................................ 4

3.1 View and Manage Printers ............................................................................................................................... 4

3.1.1 Batch permission assignment ................................................................................................... 5

3.1.2 Batch host assignment .............................................................................................................. 5

3.1.3 Adding/editing printers .............................................................................................................. 5

3.1.3.1 Name ..................................................................................................................... 6

3.1.3.2 Model name .......................................................................................................... 6

3.1.3.3 External ID (edit mode only) ................................................................................. 6

3.1.3.4 HP ePrint Enterprise Host ..................................................................................... 7

3.1.3.5 Printer Account (edit mode only) ......................................................................... 7

3.1.3.6 Address type ......................................................................................................... 7

3.1.3.7 Network address .................................................................................................. 7

3.1.3.8 Active .................................................................................................................... 7

3.1.3.9 Status .................................................................................................................... 7

3.1.3.10 Family ................................................................................................................. 7

3.1.3.11 Paper size ........................................................................................................... 7

3.1.3.12 Personality ......................................................................................................... 8

3.1.3.13 Capabilities ......................................................................................................... 8

3.1.3.14 Job Retention ...................................................................................................... 8

3.1.3.15 Print .................................................................................................................... 8

3.1.3.16 Permission .......................................................................................................... 8

3.1.3.17 Location Details .................................................................................................. 8

3.1.4 Deleting printers ........................................................................................................................ 9

iii

3.2 Import Printers ................................................................................................................................................ 9

3.2.1 Controlling batch inserts and updates with ExternalID .......................................................... 10

3.2.2 Empty versus non-existent fields ........................................................................................... 10

3.3 Export Printers .............................................................................................................................................. 10

3.4 Manage Printer Properties ............................................................................................................................ 11

3.5 Adding Secure Pull Printing ........................................................................................................................... 12

3.5.1 Identifying users in a secure pull print scenario ..................................................................... 14

3.5.1.1 Controlling PJL attribute names ........................................................................ 15

3.6 Adding Job Retention feature ....................................................................................................................... 15

4 Manage Wi-Fi Printing .................................................................................................................................. 17

4.1 Add Wi-Fi Bridge user account ...................................................................................................................... 17

4.2 View and Manage Bridges ............................................................................................................................. 18

4.2.1 Bridge Details ........................................................................................................................... 18

4.2.1.1 Name ................................................................................................................... 18

4.2.1.2 Enabled ............................................................................................................... 18

4.2.1.3 User Account ....................................................................................................... 18

4.2.1.4 User Tag .............................................................................................................. 18

4.2.1.5 Create .................................................................................................................. 18

4.2.1.6 Update ................................................................................................................ 18

4.2.1.7 Delete .................................................................................................................. 18

4.2.1.8 Clear .................................................................................................................... 19

4.3 View and manage groups .............................................................................................................................. 19

4.3.1 Group Details ............................................................................................................................ 19

4.3.1.1 Name ................................................................................................................... 19

4.3.1.2 Enabled ............................................................................................................... 19

4.3.1.3 Guest Username and Password ......................................................................... 19

4.3.1.4 Show Username .................................................................................................. 19

4.3.1.5 Update ................................................................................................................ 19

4.3.1.6 Clear .................................................................................................................... 19

4.3.1.7 Delete .................................................................................................................. 20

4.3.2 Associate Groups to Bridges .................................................................................................... 20

4.3.3 Associate Printers to Groups ................................................................................................... 20

4.3.3.1 Printers Associated ............................................................................................ 21

4.3.3.2 Printers available for Association ...................................................................... 21

4.4 View and Manage Printers ............................................................................................................................. 21

5 Manage hosts .............................................................................................................................................. 22

5.1 View and Manage Hosts ................................................................................................................................ 22

5.1.1 Host details .............................................................................................................................. 23

5.1.1.1 Hostname ........................................................................................................... 23

5.1.1.2 Port number ........................................................................................................ 23

5.1.1.3 SMTP account ..................................................................................................... 23

5.1.1.4 Version ................................................................................................................ 23

5.1.1.5 Notes ................................................................................................................... 23

5.1.2 Host cleanup ............................................................................................................................ 23

5.1.3 Deleting hosts .......................................................................................................................... 23

6 Managing users ........................................................................................................................................... 24

6.1 View and Manage Users ................................................................................................................................. 24

6.1.1 User Account details ................................................................................................................ 24

6.1.1.1 Email Account ..................................................................................................... 24

6.1.1.2 NT User Account (edit mode only) ...................................................................... 24

6.1.1.3 User Group .......................................................................................................... 24

6.1.1.4 PIN ....................................................................................................................... 25

6.1.1.5 Locale .................................................................................................................. 25

6.1.1.6 Password ............................................................................................................ 25

6.1.1.7 Password Tip ...................................................................................................... 25

6.1.1.8 Active .................................................................................................................. 25

6.1.1.9 Auto-suspend ..................................................................................................... 25

6.1.1.10 Active On ........................................................................................................... 25

6.1.1.11 Suspend On ....................................................................................................... 26

6.1.2 Deleting users .......................................................................................................................... 26

6.1.3 Import Users ............................................................................................................................. 26

6.1.4 Provision settings .................................................................................................................... 27

6.1.4.1 Auto provision .................................................................................................... 27

6.1.4.2 Synchronize user accounts ................................................................................ 27

7 Manage services and data ............................................................................................................................ 29

7.1 Service Settings ............................................................................................................................................. 29

7.1.1 Load configuration file ............................................................................................................. 29

7.2 Security Realm ............................................................................................................................................... 29

7.3 LDAP Configuration setting ........................................................................................................................... 30

7.3.1 Server settings ......................................................................................................................... 31

7.3.1.1 Host name ........................................................................................................... 31

7.3.1.2 Port ..................................................................................................................... 31

7.3.1.3 Using Secure Connection (SSL) ........................................................................... 31

7.3.1.4 Protocol Version ................................................................................................. 32

7.3.1.5 Authentication .................................................................................................... 32

7.3.1.6 Verify connection ................................................................................................ 32

7.3.2 Server attributes ...................................................................................................................... 32

7.3.2.1 User Object Classes ............................................................................................ 32

7.3.2.2 User Principal Name attribute ............................................................................ 32

7.3.2.3 User Email attribute ........................................................................................... 32

7.3.2.4 Group Member attribute ..................................................................................... 32

7.3.2.5 User Locale attribute .......................................................................................... 32

7.3.3 Search rules .............................................................................................................................. 32

7.3.3.1 User root Distinguished Name ........................................................................... 32

7.3.3.2 Additional filter ................................................................................................... 33

7.3.3.3 Search scope ....................................................................................................... 33

7.4 Usage Data Cleanup ...................................................................................................................................... 33

7.5 Job submission test ....................................................................................................................................... 33

7.6 Manage License ............................................................................................................................................. 34

7.6.1 Encrypted ID ............................................................................................................................. 35

7.6.2 Add License .............................................................................................................................. 35

7.6.3 License Summary ..................................................................................................................... 35

8 Manage mobile clients ................................................................................................................................. 36

8.1 Push Configurations (Blackberry specific) .................................................................................................... 36

8.1.1 Search recipients ...................................................................................................................... 36

8.1.2 Select recipients (users) .......................................................................................................... 36

8.1.3 Type recipients (groups) .......................................................................................................... 36

8.1.4 Push configurations ................................................................................................................. 36

9 Email printing ............................................................................................................................................. 37

10 Events and Tracking ................................................................................................................................... 38

10.1 Track jobs .................................................................................................................................................... 38

10.2 Track messages ........................................................................................................................................... 38

10.3 Track events ................................................................................................................................................ 39

11 Reports ..................................................................................................................................................... 41

11.1 Metrics Report ............................................................................................................................................. 41

12 New API configuration ................................................................................................................................ 42

12.1 Introduction ................................................................................................................................................. 42

12.2 API configuration ......................................................................................................................................... 42

12.2.1 DirectoryInformation (cloudprint.settings.xml) ................................................................... 42

12.2.1.1 DirectoryId ........................................................................................................ 42

12.2.1.2 DirectoryName ................................................................................................. 42

12.2.1.3 SelectableAttachments .................................................................................... 42

12.2.1.4 PrintEmailBody ................................................................................................. 42

12.2.1.5 BrandName ....................................................................................................... 42

12.2.1.6 DisclaimerDisplay ............................................................................................. 43

12.2.1.7 SecureConnections ........................................................................................... 43

12.2.2 Web application Configuration (web.config) ......................................................................... 43

12.2.2.1 httpRuntime ..................................................................................................... 43

12.2.2.2 system.serviceModel ....................................................................................... 43

12.3 Secure communications .............................................................................................................................. 43

12.3.1 HP ePrint Enterprise — Service Settings .............................................................................. 43

12.3.2 HP ePrint Enterprise — Host Details ..................................................................................... 44

12.3.3 HP ePrint Enterprise — web.config ....................................................................................... 45

12.3.4 HP ePrint Enterprise client configuration ............................................................................. 45

12.4 Disclaimers .................................................................................................................................................. 45

12.5 Messages ..................................................................................................................................................... 46

vii

List of figures

Figure 1-1 Login screen ........................................................................................................................................................ 1

Figure 2-1 Overview Screen .................................................................................................................................................. 2

Figure 3-1 View and Manage Printers screen ....................................................................................................................... 4

Figure 3-2 Add new printer ................................................................................................................................................... 6

Figure 3-3 Import Printers tool .......................................................................................................................................... 10

Figure 3-4 Export Printers tool .......................................................................................................................................... 11

Figure 3-5 Manage Printer Properties ................................................................................................................................ 12

Figure 3-6 Secure Pull Print settings, example ................................................................................................................. 13

Figure 3-7 Manually providing user NT account ................................................................................................................ 14

Figure 3-8 Job Retention, example .................................................................................................................................... 16

Figure 4-1 Add new user ..................................................................................................................................................... 17

Figure 4-2 Wi-Fi Bridge configuration ................................................................................................................................ 18

Figure 4-3 Wi-Fi group configuration ................................................................................................................................. 19

Figure 4-4 Associate groups to bridges ............................................................................................................................. 20

Figure 4-5 Associate printers to groups ............................................................................................................................ 20

Figure 4-6 View and manage printers ................................................................................................................................ 21

Figure 5-1 Host search and editing screen ........................................................................................................................ 22

Figure 6-1 User search and editing screen ......................................................................................................................... 24

Figure 6-2 Add User Account for Regular user ................................................................................................................... 25

Figure 6-3 Import Users ...................................................................................................................................................... 26

Figure 6-4 Provision settings ............................................................................................................................................. 27

Figure 7-1 Security Realm .................................................................................................................................................. 30

Figure 7-2 Validation of Administrator user account ........................................................................................................ 30

Figure 7-3 LDAP Configuration setting .............................................................................................................................. 31

Figure 7-4 Usage data cleanup ........................................................................................................................................... 33

Figure 7-5 Job submission test .......................................................................................................................................... 34

Figure 7-6 License Information .......................................................................................................................................... 34

Figure 8-1 Push configurations tool with port ................................................................................................................... 36

Figure 9-1 Edit a printer screen .......................................................................................................................................... 37

Figure 10-1 Track jobs screen ............................................................................................................................................ 38

Figure 10-2 Track messages screen .................................................................................................................................. 39

Figure 10-3 Track events screen ........................................................................................................................................ 40

Figure 11-1 Metrics Report ................................................................................................................................................. 41

Figure 12-1 Service Settings .............................................................................................................................................. 44

Figure 12-2 Host details ..................................................................................................................................................... 45

Figure 12-3 Binding configuration ..................................................................................................................................... 45

viii

Figure 12-4 Default disclaimers ......................................................................................................................................... 46

Figure 12-5 Adding messages ............................................................................................................................................ 46

1Introduction

This guide provides an overview of the tasks that can be performed using the HP ePrint Enterprise Administration tool. The HP ePrint Enterprise Administration tool is accessed as follows:

●

1.1 Login

This is the main access point for the Administration UI. After entering the default URL in web browser, the system redirects the user to the Login screen.

Default Login name is "admin@hp.com" and Password is "admin". If password is forgotten, a password tip is available by clicking Forgot Password.

Figure 1-1 Login screen

If Enhanced security was selected during installation, use

If Backward compatibility with low security was selected during installation, use

cloudprintadmin/

https://<hostserver>/cloudprintadmin/

http://<hostserver>/

NOTE: If upgrading from HP ePrint Enterprise 3.0 or earlier, log in with the admin credentials used during

data export. Make sure to manually change the credentials of other administrators.

Section 1.1 Login 1

2Home section

2.1 Overview Screen

The Overview Screen shows how HP ePrint Enterprise is performing its functions. It also contains links to other administration tasks such as adding users, printers, service settings, etc.

Figure 2-1 Overview Screen

The sections which follow provide a brief description of the Overview Screen components.

2.1.1 Main menu

The Main menu contains options to perform maintenance tasks on system tables such as Add and View, and also includes some reports. Each menu entry is discussed later in this document.

2 Chapter 2 Home section

2.1.2 Core Services Condition

The Core Services Condition panel provides an overview of the current state of HP ePrint Enterprise services. A red mark next to a service name indicates that the service is unavailable or has been suspended. Note that if any of the Core Services are suspended, print requests will fail.

The following list of Windows services are mapped to the Services listed in the Core Services Condition window.

Windows services Core Services Condition window

SQL Server Database

PrinterSpooler WindowSpooler

HP CloudPrint Service Host JobDispatcherService

HP CloudPrint Content Service ContentService

Simple Mail Transfer Protocol SMTPService

HP CloudPrint License Service LicenseService

HP CloudPrint Control Service ControlService

2.1.3 Jobs currently being processed

Displays current jobs submitted to HP ePrint Enterprise. The user can refresh this window to see an updated status.

2.1.4 Last hour’s failed, cancelled, or filtered (not printed) jobs

Any print submission that fails will display in this window.

2.1.5 Messages being processed

Displays messages submitted during the last 15 minutes.

2.1.6 Failed messages

Displays messages that failed during the last 15 minutes.

2.1.7 Metrics from yesterday: Jobs per printer

Displays a consolidated report of jobs submitted to a specific printer.

Section 2.1 Overview Screen 3

3 Manage printers

3.1 View and Manage Printers

This screen shows all printers that have been added to the system. The list can be filtered by using the

Search box. Searches are performed on all displayed columns.

Figure 3-1 View and Manage Printers screen

Click on the table row to edit a specific printer. You can point the mouse over the Address and HP ePrint Enterprise Host column to see the Fully Qualified Domain Name (FQDN).

The status icon reflects the printer’s current state.

Table 3-1 Printer statuses

Icon Status Description

4 Chapter 3 Manage printers

Ready Printer is ready to accept jobs.

Busy Printer is processing a job.

User Intervention Printer needs user assistance due to an error condition (paper

jam, out of paper, out of toner, etc.).

Table 3-1 Printer statuses (continued)

Unavailable Printer is not ready to accept jobs.

Unknown Printer status cannot be determined at this time.

3.1.1 Batch permission assignment

This tool assists in assigning permissions to one or more selected printers. Permissions (or access policies) are assigned to user groups or user accounts. Current access policies are subjected to allow/deny access to a printer. Select the required permissions to be assigned against each of the user groups/accounts and then click the Assign button.

3.1.2 Batch host assignment

This tool assists in assigning a group of printers to a specific HP ePrint Enterprise Host. Printers are assigned against a primary or secondary instance to manage load balance. Select the printers to be assigned and then click the Assign button.

3.1.3 Adding/editing printers

Click a row on the View and Manage Printers screen to redirect to the printer editing form, or select Add New Printer on the Main menu to add a new printer.

Section 3.1 View and Manage Printers 5

Figure 3-2 Add new printer

3.1.3.1 Name

The name used to identify this printer on the system. A friendly description is recommended. Use an easily identifiable name.

3.1.3.2 Model name

The model name of the printer.

3.1.3.3 External ID (edit mode only)

This field is used by Import/Export routines to update printer information. The system automatically generates this identification in the form ep + printer identifier (e.g., ep1). For more information on how to use and manage the external ID field, see the Import Printers section of this guide.

NOTE: External ID must be unique.

6 Chapter 3 Manage printers

3.1.3.4 HP ePrint Enterprise Host

The HP ePrint Enterprise host to which the job will be sent. Jobs are processed by the assigned primary or secondary instance.

3.1.3.5 Printer Account (edit mode only)

This information is used by the email printing mechanism to identify the printer in the directory. The system automatically generates this information based on the PrinterAccountPrefix setting (set in the settings configuration file) + printer identifier. For more information, see the Email printing section of this guide. The Printer Account value can modified to a more appropriate / friendly value when editing the printer account.

NOTE: Printer Account value must be unique.

3.1.3.6 Address type

Represents the printer address type, which can be a network node (IPv4) or a print queue/secure pull print queue. It is important to note that a printer queue also has an IPv4 address, representing the server where the queue is located.

3.1.3.7 Network address

Represents the network address where this printer is located.

●

Queue Name (print queue and secure pull print type only) - The queue name that identifies the printer on the print server.

●

3.1.3.8 Active

Only printers marked as active can have submit jobs. To temporarily disable a printer, unmark this option. Suspended or inactive printers are not listed in search results on mobile devices.

3.1.3.9 Status

Status information is automatically updated by the HP ePrint Enterprise Printer Monitor service. If a printer is down, it gets suspended and won’t be listed in printer search.

Optionally, printer status can be manually set to “Unavailable” so that it won’t be listed in search results.

3.1.3.10 Family

This field represents the printer family type, and enhances printer search capabilities. A printer family association strengthens rendering capabilities to the driver family to which they belong.

3.1.3.11 Paper size

Use Domain Credentials (print queue and secure pull print type only) - Mark this option to use the

Domain User/Password credentials for network authentication.

Domain User (print queue and secure pull type print only) - The user in DOMAIN\user format used to access the print queue resource.

Domain Password (print queue and secure pull print type only) - The domain password used by the user to access the print queue.

This field represents the paper size used by this printer, assisting printer search / printing capabilities.

Section 3.1 View and Manage Printers 7

+ 39 hidden pages