Zebra Printer Profile Manager Enterprise Printer Profile Manager Enterprise V3.3 User Guide (en)
Printer Profile Manager
Enterprise
Version 3.3
User Guide
P1094865-07EN
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many
jurisdictions worldwide. All other trademarks are the property of their respective owners.
© 2022 Zebra Technologies Corporation and/or its affiliates. All rights reserved.
Information in this document is subject to change without notice. The software described in this document is
furnished under a license agreement or nondisclosure agreement. The software may be used or copied
only in accordance with the terms of those agreements.
For further information regarding legal and proprietary statements, please go to:
SOFTWARE:zebra.com/linkoslegal
COPYRIGHTS:zebra.com/copyright
WARRANTY:zebra.com/warranty
END USER LICENSE AGREEMENT: zebra.com/eula
Terms of Use
Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries
(“Zebra Technologies”). It is intended solely for the information and use of parties operating and maintaining
the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to
any other parties for any other purpose without the express, written permission of Zebra Technologies.
Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are
subject to change without notice.
Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are
correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.
Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the
accompanying product (including hardware and software) be liable for any damages whatsoever (including,
without limitation, consequential damages including loss of business profits, business interruption, or loss of
business information) arising out of the use of, the results of use of, or inability to use such product, even if
Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow
the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may
not apply to you.
- 2 -
CONTENTS
User Interface
The Navigation Bar 12
At-a-Glance Printer Status 12
User Menu 13
Listing View 13
Details Page 13
Account Roles and Permissions 14
Printers View
Listed below are the other actions available on this page. 21
What can I do? 21
View a Printer and Its Information 21
Listed below are the other actions available on this page: 22
Discover a Printer 22
Discover a Printer from the Printers Listing View 22
Discover Printers using a Multicast Search 22
Discover Printers on a Specified Subnet 23
Add a Printer from the Discovered Printers 23
Manually Add a Printer 23
Discover Printers Using a CSV File 23
Status Definitions 24
Add Printers Using a CSV File 25
Status Definitions 27
Troubleshooting 27
Search and Filter Printers 28
Use Search Box as a Filter for the Specific Categories 28
Search and Filter Changes the URL 29
Sort a List of Printers 29
Sort a List of Printers 29
Apply and Remove a Filter 29
Available Filters on the Printers Listing View 29
Apply/Remove a Filter 30
Search and Filter Tags 30
Use Search Box as a Filter for Tags 30
Quick Tag 31
Add and Apply a Tag to a Printer from the Home Page 31
Printer Listing Settings 31
Display or Hide Battery and Odometers from the Printer Listing Page 31
Remove Printers 32
Remove All Printers from the Printers Listing Page 32
Printer Details Page 33
Best Practice 33
From the More Menu, actions include: 33
Tabs on this page include: 34
12
21
- 3 -
Operation Log 34
Create Profile 34
Create a Profile from the Printer Details Page 34
View a Printer's Web Page 34
View a Printer's Web Page from the Printer Details Page 34
Export Printer Data 35
Export Printer Data from the Printer Listing Page 35
Force Reconnect 35
Force Reconnect a Printer from the Printer Details Page 35
Remove a Printer 35
Remove a Printer from Printer Details Page 35
Operation Log 36
What is an Operation Log? 36
Settings 36
What Settings are available? 36
Configure (Modify) the Settings from the Printer Details Page 36
Refresh the Settings View 37
Objects 37
What are objects? 37
Add an Object from the Printer Details Page 37
Odometer 38
Refresh the Odometer 38
Tags 38
View the Tag(s) Associated with a Specific Printer 38
Weblink 39
View the Weblink Info from the Printer Details Page 39
Change the Weblink Connection 39
Listed below are the other actions available on this page: 39
Batteries View
What can I do? 40
Battery Details Page 41
Tabs on this page include: 41
Remove a Battery 41
Remove a Battery from the Battery Details Page 41
Profiles View
What Settings are available? 42
What happens when you apply a profile? 42
Listed below are the other actions available on this page. 43
What can I do? 43
Create Profile 43
Create a Profile from a Printer 43
Slider Switch 44
Delete Existing Files in Printer Memory 45
Create Profile from Files 45
Important Considerations 45
- 4 -
40
42
General 45
Files to Store 46
Slider Switch 46
Delete Existing Files in Printer Memory 46
Printer File Path 47
Files to Process 47
Create a Profile from Files from the Profiles View 47
Sort a List of Profiles 49
Sort a List of Profiles 49
Profile Details Page 50
Best Practice 50
Is Everything in my Printer Captured when Creating a Profile? 50
Tabs on this page include: 50
Order of Operations 51
View Profile and Its Information 51
View a Profile Listing and Its Information 51
Settings 51
What Settings are available? 51
Configure (Modify) the Settings from the Profile Details Page 52
Edit a Network Configuration 52
Edit a Network Configuration from the Profile Details Page 52
Files to Store 53
Printer File Path 53
View the Files to Store in a Profile 53
Manually Add a File to Store to a Profile 54
Slider Switch 54
Delete Existing Files in Printer Memory 55
Files to Process 55
View the Files to Process in a Profile 55
Manually Add a File to Process to a Profile 55
Commands 56
Add Commands from the Profile Details Page 56
Add Firmware to a Profile 56
Manually Add a Firmware File to a Profile 56
Virtual Device 56
Add or Select a Virtual Device to this Profile 57
Send a Profile to a Printer 57
Send a Profile to a Printer from the Profile Details Page 57
Enable Settings 57
Enable Settings from the Profiles Details Page 57
Disable Settings 57
Disable Settings from the Profiles Details Page 57
Copy a Profile 58
Copy a Profile from the Profile Details Page 58
Delete a Profile 58
Delete a Profile from the Profile Details Page 58
- 5 -
Add a Network Configuration to a Profile 58
Add a Network Configuration to a Profile from the Profiles Detail Page 58
Remove a Network Configuration from a Profile 58
Remove a Network Configuration from a Profile from the Profiles Detail Page 58
Create a New Network Configuration from a Profile 59
Add a Network Configuration to a Profile from the Profiles Detail Page 59
Networks View
Certificates 60
EAP-TLS, WPA/WPA2 EAP-TLS: 60
EAP-FAST,WPA/WPA2 EAP-FAST: 60
EAP-TTLS, PEAP, WPA/WPA2 EAP-TTLS, WPA/WPA2 PEAP: 60
What can I do? 60
Listed below are the other actions available on this page. 61
Create a Network Configuration 61
Create a Network Configuration from the Networks Listing View 61
Security Username Field 61
Network Details Page 64
Best Practice 64
View a network configuration listing and its information 64
Tabs on this page include: 64
Apply To Printers 64
Apply a Network Configuration to a Printer from the Networks Details Page 64
Edit a Network Configuration 65
Edit a Network Configuration from the Network Details Page 65
Remove a Network Configuration 65
Remove a Network Configuration from the Network Details Page 65
Certificates View
Certificate Authorities View 67
Supported CA Servers 67
Listed below are the other actions available on this page. 67
What can I do? 67
Add Certificate Authority Server 67
Add a Certificate Authority (CA) Server from the CA Listing Page 67
Sort a List of Certificate Authorities 68
Sort a List of Certificate Authorities 68
Certificate Authority Details Page 68
View a CA Server listing and its information 68
From the More Menu, actions include: 68
Tabs on this page include: 68
Remove a Certificate Authority 69
Remove a CA from the CA Details Page 69
Certificate Management Item View 70
Listed below are the other actions available on this page. 70
What can I do? 70
Create a Certificate Management Item 70
60
66
- 6 -
Create a Certificate Management Item (CMI) from the CMI Listing Page 70
Sort a List of Certificate Management Items 71
Sort a List of CMI's 71
Certificate Management Item Details Page 71
View a CMI listing and its information 72
From the More Menu, actions include: 72
Tabs on this page include: 72
Apply CMI 72
Apply a CMI from the CMI Details Page 72
Edit a Certificate Management Item 72
Edit a Certificate Management Item (CMI) from the CMI Details Page 72
Remove a Certificate Management Item 73
Remove a CMI from the CMI Details Page 73
Provisioning View
Listed below are the other actions available on this page. 74
What can I do? 74
Create an Item 74
Create a Provisioning Item from the Provisioning Page 74
Suspend All 75
Suspend all Provisioning Events from the Provisioning Page 75
Resume All 75
Resume All Provisioning Events from the Provisioning Page 75
Provisioning Details Page 76
From the More Menu, actions include: 76
Tabs on this page include: 76
Provisioning Types 77
Power Up Provisioning 77
Scheduled Provisioning 77
Scheduled Recurring Provisioning 77
Suspend Provisioning Item 77
Suspend a Provisioning Item from the Provisioning Details Page 77
Resume Provisioning Item 77
Resume a Provisioning Item from the Provisioning Details Page 77
Delete Provisioning Item 78
Delete a Provisioning Item from the Provisioning Details Page 78
74
Tagging View
Overview of Tags, Auto-Tags, and Tagging Policies 79
Tags 79
Auto-Tags 79
Tagging Policies 79
Auto-Tag and Tagging Policy Comparison Table 80
Tags View 80
Listed below are the other actions available on this page. 81
What can I do? 81
+Add Tag 82
- 7 -
79
Add a tag from the Tags View 82
Add Auto-Tag 82
Add an Auto-Tag from the Tags View 82
Tag Details Page 84
Best Practice 84
Tabs on this page include: 84
Listed below are the other actions available on this page. 84
From the More Menu, actions include: 85
Tag Printers 85
Tag a Printer from the Tag Details Page 85
Untag Printers 85
Untag a Printer from the Tag Details Page 85
Convert to Auto-Tag 86
Convert a Tag to an Auto-Tag from the Tags View 86
Remove a Tag 87
Remove a Tag (in the System) from the Tags Tab 87
Edit a Tag 87
To Edit a Tag or an Auto-Tag from the Tags View: 87
Modify Auto-Tagging 88
Modify an Auto-Tag from the Tags Tab 88
Remove Auto-Tagging 89
Remove Auto-Tagging from the Tags Tab 89
Tagging Policies View 90
Listed below are the other actions available on this page. 90
What can I do? 90
+Add Policy 90
Notes 91
Add a Tag from the Tagging Policies Page 91
Auto-Tag Policy Details Page 93
Tabs on this page include: 93
From the More Menu, actions include: 93
Auto-Tag Policy Configuration 93
Auto-Tag Policy Tags 94
Edit a Tagging Policy 94
Edit a Tagging Policy from the Tagging Policy Details Page 94
Remove a Tagging Policy 95
Remove a Tagging Policy from the Tagging Policy Details Page 95
Resources View
View a Resource and Its Information 96
Listed below are the other actions available on this page. 96
What can I do? 96
Add a Resource 96
Add a Resource using the +Add Resource Button from the Resources Page 96
Drag and Drop a Resource 97
Sort a List of Resources 97
- 8 -
96
Sort a List of Resources 97
Apply and Remove a Filter 97
Apply/Remove a Filter 97
Available Filters on the Resources View 97
Resource Details Page 97
Resource Types: 98
From the More Menu, actions include: 98
Listed below are the other actions available on this page. 99
Send Resource 99
Send Resource to a Printer from the Resources Details Page 99
Store Resource 99
Store Resource on a Printer from the Resources Details Page 99
Delete Resource 100
Delete Resource from the Resources Details Page 100
Edit a Resource 100
Edit a Resource from the Resources Details Page 100
User Menu
Change Password 101
Change the Password from the User Menu 101
Manage Users View 102
Manage Users and Directories from the User Menu 102
Listed below are the other actions available on this page. 102
What can I do? 102
Configure LDAP Directories 102
Best Practice 102
Configure LDAP Directories 102
Invite Users 105
Invite Users from the User Listing Page 105
User Details Page 106
Navigate to the User Details Page 106
Definitions of Users' Status 106
From the More Menu, actions include: 106
Tabs on this page include: 106
Change User Role 107
Change the User Role 107
Invalidate Active Sessions 107
Invalidate Active Sessions 107
Change User Email 107
Change the User Email 108
Reset Password 108
Reset the User Password from the User Details Page 108
Deactivate User 108
Deactivate a User 109
Remove User 109
Remove a User 109
101
- 9 -
Activate User 109
Activate a User 110
Resend Invitation 110
Invite Users from the Users Details Page 110
Operation Log 110
Configuration 111
Configure Settings from the User Menu 111
What can I do? 111
Weblink for Printer Connections 111
Weblink for Printer Connections 112
Change Connections 112
All Connection Settings and Certificates 113
Backup all Connection Settings and Certificates 113
Restore all Connection Settings and Certificates 114
DNS Server List, DNS Domain Name, Proxy and Authentication 114
Add a DNS Server List, DNS Domain Name, Proxy and Authentication 114
UI SSL Settings 115
Change UI SSL Settings 115
Change the UI Certificate 116
SMTP Settings 116
Change SMTP Settings 116
Proxy Settings 117
Change Proxy Settings 117
Operation Log Retention Policy 118
Change Operation Log Retention Policy Settings 118
Date and Time Settings 118
Enable or Disable UTC 119
Analytics and Usage Settings 119
Application Analytics 119
Printer Analytics 120
To Change Analytics and Usage Settings 120
Beta Features 121
See the Battery Monitoring Tab and Statistics 121
Enable or Disable Tagging Policy 121
Provide Feedback 122
Static IP Addresses 123
Assign, View, and Delete Static IP Addresses 123
System Log 123
View the System Log 123
License 123
Standard Configuration 123
Best Practice 124
Setup 124
Enter a New License Code 124
Viewing a License 124
Effects of License Limits 125
- 10 -
Move an Installation of PPME 125
About 125
View the About Page 125
- 11 -
User Interface
User Interface
Printer Profile Manager Enterprise (PPME) has several tools available on every page.
The Navigation Bar
The Navigation Bar contains links to web pages and the help system, printer status boxes, and user
settings. The Navigation bar includes:
l
Tabs to each page:
Your navigation bar may look different depending on which features are enabled or disabled.
l
Status boxes:
Each colored box shows the number of printers in various states. Hover your cursor over the
numbers to see a tooltip.
l
Question mark icon : Opens the help system.
l
User menu :
Allows the administrator to change passwords; manage users; set up server configuration; set static
IP addresses; view the System Log, License, and About screens; and Logout.
l Information icon : Provides additional information about the specific tab page. (Click to show the
additional information and click again to close it.)
At-a-Glance Printer Status
The colored boxes in the Navigation bar identify the status of the printers. From left to right:
l
the green box shows the printers online.
l
the red box shows those printers in an error state.
l
the yellow box shows printers in a warning state.
- 12 -
User Interface
l
the gray box shows the number of printers offline.
l
the white TOTAL box shows the total printers.
User Menu
The User menu identifies the username at the far right of the Navigation bar.
Example • shows that this username is assigned as an admin.
Listing View
The Listing View contains a list of items that correspond with the tab.
Example • If you click on the Tags View, you will go to the Tags Listing View showing a list of tags in PPME.
Details Page
The Details Page shows the details and other associated information about a single item. Additional actions
may be performed from each details page.
Example • If you click on a tag labeled "Shipping", you will go to the Shipping Tag details page which shows
a description, creation date, its associated printers. You can delete this tag, and add and delete printers to/from this tag.
The Settings menu (on the secondary navigation bar for Printers and Profiles Details Pages) contains a
dropdown menu for the following:
l
Base Settings
l
CPCL commands
l
Tools
l
Sensors
l
Base Network
l
Wireless (not available on the Profiles Details Page)
l
Network Services
l
Bluetooth
l
Ports
- 13 -
User Interface
Account Roles and Permissions
The Admin manages the account roles and may:
l
Assign or change a user's role
l
Create an account role listing showing assigned users, permitted actions, and roles
The table below outlines the acceptable permissions for the following account roles:
l
User
l
Tech
l
Admin
Page Feature User Tech Admin
Change
Password
Manage Users
Change Your User Password X X X
View Users List X
Invite New Users X
Configure Directories X
Invalidate Active Sessions X
Deactivate User's Account X
Reset User's Passwords X
Update User Full Name &/or Email Address X
Add and Remove a User X
Change the LDAP Configuration X
View Activity Log X
Resend User Invite X
View Roles X
Update Role X
- 14 -
User Interface
Weblink for Printer Connections
Configure the Weblink URL X
View Server Configuration X
Edit Server Configuration X
Configure Printer Certificate X
Upload a Printer Certificate X
DownloadTroubleshooting Information X
UI SSL Settings
Update User Interface Certificate Details X
Generate UI Certificate X
Upload a UI Certificate X
SMTP Settings
Configuration
Change the SMTP Settings X
Proxy Settings
Configure Server Proxy X
Operation Log Retention Policy
Configure the Operation Log Retention Policy X
Date and Time Settings
Enable/Disable Coordinated Universal Time
(UTC)
Analytics and Usage Settings
Enable/Disable Application Analytics X
Enable/Disable Printer Analytics X
Beta Features
Enable/Disable Battery Monitoring X
Enable/Disable Tagging Policy X
Change Static IP Addresses X X
Static IP Addresses
System Log View System Log X
License
Create Network Config X X
Remove Static IP Addresses X X
Search Static IP Addresses X X
Release (Return Server License Code) X
View License Code X
X
- 15 -
Printer Listing
User Interface
View Printer List X X X
Add Printer X X
Reclaim a Printer X X
Sort Printer by Status, IP Address, Name X X X
Search for Printer X X X
Filter Printer by Tag X X X
More menu - Quick Tag X X
More menu - Printer Listing Settings X
More menu - Export All Printer Data X X X
More menu - Remove Printers X X
Discover Printers X X
Multicast Search X X
Add Printer Manually X X
Subnet Discovery X X
Add Printers from CSV X X
- 16 -
Printer Details
Batteries
User Interface
View Printer Details X X X
Edit Printer Name X X
Edit Printer Location X X
More menu - Print Configuration Label X X X
More menu - Calibrate Printer X X
More menu - Update Firmware X X
More menu - Create Profile X X
More menu - Restore Printer Defaults X X
More menu - Restore Network Defaults X X
More menu - Reset Network X X
More menu - Reset Printer X X
More menu - Printer Web Page X X
More menu - Force Reconnect X X
More menu - Remove Printer X X
More menu - Export Printer Data
+Add Tags
Refresh Settings
Edit Printer Settings
Refresh Objects
View Objects List
Add Object
Add Object via Drag-n-Drop
Preview Object on Printer
Remove Object from Printer
Clear Odometer Values
Download an Object from a Printer
Set Weblink Configuration X X
View Weblink Configuration X X X
Download Weblink Info X X X
Refresh (Weblink Info) X X X
View Op Log X X
View Batteries Tab X X
View Batteries Listing Page X X
View Battery Landing Page X X
Edit Friendly Name of the Battery X X
View Battery History X X
View Battery Data (Charge, Voltage, Tem-
perature, and by Date Range)
More Menu - Remove Battery X X
X
X
X X X
X
X X
X X
X X
X X
X X
X X
X X
X X
X X
X X
X X
X X
- 17 -
Profiles Listing
Profiles Details
Networks Listing
Networks Details
Certificate Author-
ities
User Interface
Create a Profile X X
Sort Profiles by Date or Name X
Search Profiles List X X
Edit a Profile X X
Apply a Profile X X
View a Profile X X
Export a Profile X X
Copy a Profile X X
Remove a Profile X X
Create Profile from Files X X
Change Settings (Base Settings, CPCL com-
mands, Tools, Sensors, Base Network, Network
Services, Bluetooth, Ports, RFID)
View Settings (Base Settings, CPCL commands,
Tools, Sensors, Base Network, Network Services,
Bluetooth, Ports, RFID)
Select, Add, Change, Delete Network Configurations
Change Profile Description X X
Enable/Disable Delete Existing File from Printer
Memory before Sending Profile
Add, Remove Files to Process X X
Apply Commands to the Profile X X
Add, Remove Firmware to the Profile X X
Add, Remove Virtual Device to the Profile X X
More menu - Send to Printers X X
More menu - Disable/Enable Settings X X
More menu - Copy Profile X X
More menu - Delete Profile X X
View Network Configuration X X
Add a Network Configuration X X
Sort a Network Configuration by Name or Date X X
Search for Printer X X
View Static IP Addresses X X
Apply to Printers X X
Edit a Network Configuration X X
Remove Network Configuration X X
Create Certificate Management Item X X
View Certificate Authorities (CA) List X X
Add CA Server X X
Sort CA X X
Search CA X X
Edit UI Certificate X X
More menu - Remove CA X X
X X
X X
X X
X X
- 18 -
Certificate
Management
Items
Provisioning
Listing
Provisioning
Details
Tags Listing
Tags Details
User Interface
View Certificate Management Items (CMI) List X X
Add CMI X X
Sort CMI X X
Search CMI X X
More menu - Apply CMI X X
More menu - Edit (CMI) X X
More menu - Remove (CM) X X
Create Item X X
Suspend All X
Resume All X
View Provisioning Item List X X
Sort Provisioning Items by Date or Name X X
Search Provisioning Items X X
Select Provisioning Item X X
View Operation Log X X
Add Tags X X
Schedule Provisioning Items X X
Update Provisioning Item X X
More Menu - Suspend Provisioning Items X X
More Menu - Resume Provisioning Items X X
More Menu - Delete Provisioning Items X X
View Tags List X X
Search Tags List X X
Add a Tag X X
Add Auto-Tag X X
More Menu - Reorder Tags by Name X
More Menu - Reorder Tags by Description X
More Menu - Reorder Tags by Creation Date X
More Menu - Reorder Tags by Number of Printers X
More Menu - Move to the Top of the Global Tag
Ranking
More Menu - Show Only Manual Tags X
More Menu - Show Only Auto-Tags X
More Menu - Show All Tags X
Edit Tag Order X
Tag Printers X X
Untag Printers X X
Edit Manual Tag Attributes (Name and Descrip-
tion)
More Menu - Convert to Auto-Tag X X
More Menu - Remove a Tag X X
X X
X
- 19 -
User Interface
Tagging Policies
Listing
Tagging Policies
Details
Resources
Listing
Resource Details
View Tagging Policies X X
Add a Tagging Policy X X
Search for a Tagging Policy X X
Enable/Disable Remove Printer from Tag on
Value Change
Enable/Disable Migrate Existing Tags X X
Edit a Tagging Policy X X
Remove a Tagging Policy X X
View Resources List X X
Search Resources X X
Filter Resources by Type X X
Add Resources X X
Sort Resources by Name, Description, Size or
Date
Send a Resource to a Printer X X
Store a Resource on a Printer X X
Edit Resource Attributes (Name, Description,
Printer File Path, and Card Printer File Path)
View Operation Log X X
Preview a Resource X X
More Menu - Download Original X X
More Menu - Download Dithered X X
More Menu - Download Prepared X X
More Menu - Delete Resource X X
X X
X X
X X
- 20 -
Printers View
Printers View
The Printers View shows a list of the configured printers pointing to this server. On this page, you can
manage all of your printers, and see the general overall "health" of the printers including things such as
printer status, error conditions, activity, and printer identification. Additionally, you may filter, search or sort
on the listed printers.
Listed below are the other actions available on this page.
l
Discover Printers: discovers configured and available printers, filters discovery by subnet, and manu-
ally adds a printer to the server.
l
Search and Filter Printers: allows you to search for and filter a list of printers. You may use an aster-
isk (*) as a wildcard in the Search box.
l
Sort By: sorts a list of printers.
l
Apply and Remove a Filter: click an item (status, models, tags, printer type, media type, DPI) to
select a filter in the right pane.
l
Search and Filter Tags: allows you to search and filter tags applied/associated with printers.
The following More menu items will perform the action described below:
l
Quick Tag: applies a tag to existing printer(s).
Note • Quick tags are not available for Auto-Tags.
l
Printer Listing Settings: controls the display of battery data and odometers in the Printer Listing Table
View Settings.
l
Export Printer Data: exports all printer data as a CSV file.
l
Remove Printers: removes the selected printer from the server.
What can I do?
If you wish to change a printer setting, click on the specific printer to go to the Printer Details Page.
View a Printer and Its Information
The printer cell contains information such as firmware version, model name (for example, ZT230), printer
name, serial number, location, tags, or IP Address.
To view a Printer and its information from the Printers Listing View, click on a specific view icon. There are
two views available:
- 21 -
Printers View
l
l
Grid View: shows all of the same details defined above. The printer cell is larger and includes
a picture of the printer.
List View: the printer cell is smaller, and does not include a picture of the printer, firmware ver-
sion, or model name.
Listed below are the other actions available on this page:
l
Search and Filter Printers: allows you to search for and filter a list of printers. You may use an aster-
isk (*) as a wildcard in the Search box.
l
Sort By: sorts a list of printers.
Discover a Printer
Zebra printers support a discovery process that utilizes UDP datagram on port 4201. If you find that you cannot discover printers during this process, please ensure that the network is enabled for UDP traffic from the
server to the printer. If you are unable to enable UDP, printers may be added manually from the server or
may be connected by configuring settings on the printer directly.
Discover a Printer from the Printers Listing View
1. Click Discover Printers.
A list of Link-OS printers will be shown based on a network discovery.
2. If you wish to search for printers from the Add Printer(s) page:
a. Enter a printer name, MAC address, or IP address in the Search box.
b. Enter the specific subnet in the Subnet box.
c. Click on Available Printers or Already Configured to display the list of associated printers.
Discover Printers using a Multicast Search
1. From the Printers Listing View, click the dropdown menu icon for Discover Printers.
2. Select Multicast Search.
The specify Multicast Hops for Printer Discovery dialog box opens.
3. Enter a number in the Number of Multicast Hops field.
Note • It is recommended that you enter either 2 or 3 in this field.
4. Click Discover Printers.
Click Cancel to discard changes, close the dialog box, and return to the Printers page.
A list of Link-OS printers will be shown based on a multicast discovery.
- 22 -
Printers View
5. To add a printer, see Add a Printer from the Discovered Printers or Manually Add a Printer
Discover Printers on a Specified Subnet
1. From the Printers Listing View, click the dropdown menu icon for Discover Printers.
2. Select Subnet Discovery.
3. Enter the specific subnet in the Subnet box.
Example • You may use wildcards and partial IP addresses as in 10.4.127*.
A list of Link-OS printers will be shown based on a specific subnet discovery.
Add a Printer from the Discovered Printers
1. Select the printers that you wish to configure for Printer Profile Manager Enterprise.
Note • You may only select printers that have not already been configured. Be sure you are displaying the Available Printers.
2. Click Add Printer(s) to add the printers.
Click Cancel to discard changes, close the dialog box, and return to the Printers page.
Note • If your printer is not listed under the Available Printers tab, you may find it under the
Already Configured tab. Printers already configured for the PPME server or two other servers can
be reclaimed by checking the selection box for the printer(s) and clicking the Add Printer(s) button.
Manually Add a Printer
1. From the Printers Listing View, click the dropdown menu icon for Add Printer Manually.
2. Enter the DNS/IP address of the printer in the field.
3. Click Apply to manually add a printer.
Click Cancel to discard changes, close the dialog box, and return to the Printers page.
Discover Printers Using a CSV File
You may provide PPME a list of subnets to search in a CSV file.
PPME will search the provided list of subnets and configure any available printers to connect to PPME.
The CSV file must be formatted as a single column with a header and may contain up to 7000 entries.
Entries may include wildcards (e.g. 10.80.4.* or 10.80.*.*), ranges (e.g. 10.80.4.1-100 or 10.80.1-100.*),
and cidr (e.g. 10.80.4.1/21) up to block /16 are acceptable.
Example:
- 23 -
Printers View
Subnets
192.168.1.*
192.168.2.1-100
192.168.8.1/21
1. From the Printers Listing View, click the Discover Printers dropdown menu and select Discover
Printers From CSV.
2. Browse and select your .csv file and click Open.
3. At the prompt, click Yes to proceed with discovery and adding printers from the CSV file or click
Cancel to abort the operation.
The list of subnets will be checked for errors prior to starting the operation. Errors may include improperly
formatted entries and duplicates. Any errors will result in the operation being aborted. Afterwards, you will
be prompted to fix the errors and retry the import.
If the import is successful, PPME will display "Searching nnn subnets" and begin configuring any available printers.
After the operation has started, you may cancel it by clicking the Discover Printers dropdown menu again
and selecting Cancel Discover Printers From CSV.
Note • The current status of the operation can be seen in the System Log.
Note • Any printers configured by the operation prior to selecting Cancel will remain configured.
After the operation is complete, two report files are generated in the %userprofile%\Documents\PPME
folder.
A configured printers report is created containing the following information for each printer IP address
found:
l
status: success, failed, skipped, cancelled. (See Status Definitions for more information.)
l
details of failure
l
date/time started
l
date/time completed
Status Definitions
• Success indicates PPME connected to the printer and sent the configuration. It does not imply the
printer has successfully connected to PPME.
- 24 -
Printers View
• Skipped indicates the printer is already configured to connect to this PPME server.
• Cancelled indicates the operation was cancelled by the user.
• Failed indicates either a connection could not be made to the printer (e.g., the printer may be offline) or
both of the weblink connections are already configured.
A subnet discovery report will be created containing the following information for each subnet searched.
Address of the subnet or range searched
Status: PENDING, ERROR, CANCELLED, SUCCESS, or FAILED.
Details the result of the search from: "Cancelled by user," "No printers found," "Error discovering printers"
or "{n} printers found."
Started indicates the date & time the subnet search started.
Completed indicates the date & time the subnet search completed.
Add Printers Using a CSV File
In situations where the discovery process cannot be used, you may add printers to PPME using a CSV file
containing a known list of printer IP addresses, hostnames, or a combination of both in the file. The CSV file
may contain up to 7000 entries.
The hostname is the combination of the Friendly Name and the Domain Name assigned to your printer. If
the Friendly Name is not set, the printer will substitute the serial number.
The printer Friendly Name is the value in the printer's device.friendly_name setting.
The Domain Name is the value in either the printer's wlan.ip.dns.domain or internal_wired.ip.dns.domain
setting.
Example: xxxx.ABCcompany.lan
where:
xxxx = printer friendly name or printer serial number
ABCcompany.lan = domain name
A hostname entry:
l
Must be 1-63 alphanumeric characters for each element.
l
May include hyphens
l
Must not exceed a total length of 255 characters.
- 25 -
Printers View
The CSV file must be formatted as a single column with a header.
Example:
zebra-printers
192.168.1.100
XXZKJ183000652.ABCcompany.lan
192.168.2.101
192.168.3.202
192.168.4.75
1. From the Printers Listing View, click the Discover Printers dropdown menu and select Add Print-
ers From CSV.
2. Browse and select your .csv file, and click Open.
3. At the prompt, click Yes to proceed with adding printers from the CSV file or click Cancel to abort the
operation.
The list of IP addresses and hostnames will be checked for errors prior to starting the operation to add printers. Errors may include improper formats and duplicates for IP addresses or hostnames. Any errors will result in the operation being aborted. Afterwards, you will be prompted to fix the errors and retry the import.
Note • Duplicate IP addresses or hostnames are not permitted in the file.
If the import is successful, PPME will display "Adding nnn printers" and begin attempting to connect to each
IP address and hostname to configure the printer.
After the operation has started, you may cancel it by clicking the Discover Printers dropdown menu again
and selecting Cancel Add Printers From CSV.
Note • The current status of the operation can be seen under the Configure Printers entry in the System
Log and will show a status of pending, processing, completed, cancelled or error.
Note • Any printers configured by the operation prior to selecting Cancel will remain configured.
After the operation is complete, a report file will be generated in the %userprofile%\Documents\PPME
folder containing the following information for each IP address and/or hostname:
• status: success, failed, skipped, cancelled. (See Status Definitions for more information.)
• details of the failure
• date/time started
- 26 -
Printers View
• date/time completed
Status Definitions
• Success indicates PPME connected to the printer and sent the configuration. It does not imply the
printer has successfully connected to PPME.
• Skipped indicates the printer is already configured to connect to this PPME server.
• Cancelled indicates the operation was cancelled by the user.
• Failed indicates either a connection could not be made to the printer (e.g., the printer may be offline) or
both of the weblink connections are already configured.
Troubleshooting
If the printer shows adding printer for more than 10 minutes (after adding the printer), please review the
information below for troubleshooting tips.
Note • See the Zebra Programming Guide for more up-to-date information on the operation, functionality,
and troubleshooting of Weblink.
The printer uses HTTPS in order to connect to the PPME server. Therefore, it performs hostname verification when connecting to ensure that the certificate that is presented by the server matches the hostname/DNS name to which the printer is attempting to connect. In order to make a successful connection to
PPME, several things must to be true:
l
The PPME server must be reachable from the printer's subnet (e.g., you can ping the PPME server
from the printer's subnet).
l
The port that printers use to connect to PPME (e.g., 8443) must be reachable from the printer's subnet (e.g., any firewalls or firewall rules that prevent access to the server port should be modified to
allow access).
l
The Fully Qualified Domain Name (FQDN) of the server (e.g., acme.internal.lan) must be in the DNS
server that the printer is configured to use, so that it can be properly resolved.
l
If the printer is assigned an IP address via a static method, the DNS server must be configured in the
printer's settings.
l
The server port that the printer connects to has a certificate associated with it. This certificate is
added during the installation process (and is supplied by Zebra). Only Zebra-supplied certificates will
be accepted by the printer.
l
Note • If you encounter an issue connecting to one of your printers, check the printer's "Allowlist" setting (ip.firewall.whitelist_in). The PPME server should appear on your Allowlist so that your printer
can connect. (To check or change the printer's ip.firewall.whitelist_in setting, refer to the Zebra
PrintSecure Administration Guide.)
- 27 -
Printers View
Search and Filter Printers
The Search box (in the upper right of the main pane) allows you to search for and filter a list of printers. The
search only applies to the following list of specific categories:
l
Firmware version
l
Model name (for example, ZT230)
l
Friendly name
l
Serial number
l
Location
l
MAC Address
l
IP address
l
*Odometer settings: User Labels, Total Labels, Total Length, Head Clean, and Head New
l
*Battery settings: Battery Voltage, Battery %, Battery Status,Battery Health, and Battery First Used
Note • Odometer and Battery settings must be enabled as part of your tenant features. When
enabled, these settings are visible on the Printers View and you may include them in the search and
filter feature.
Once you press Enter, the text you typed in the Search box moves over to the Selections box (top of the left
pane) and acts as a filter on the list of printers. To remove the search filter from Selection, click X to remove
the filter.
Use Search Box as a Filter for the Specific Categories
The specific categories are listed above.
1. Enter text in the Search box and press Enter.
Note • You may use an asterisk (*) as a wildcard in the Search box.
Notice that your text has moved over to the Selections box (left pane) and is shown as
"Search:<your text>"
The list of printers has been filtered to a smaller subset of the original list.
2. If you wish to add another filter, you can perform any of the following actions:
l
Enter a printer name, MAC address, or IP address or additional text in the Search box.
l
Enter multiple text searches separated by commas or spaces in the Search box. (This will perform a logical "OR" search.)
l
Enter separate text searches in the Search box. (This will perform a logical "AND" search.)
- 28 -
Printers View
Example • To filter both ZD and ZT printer models, enter either ZD,ZT or ZD ZT in the Search box
and press Enter. (Performs a logical "OR" search.)
To filter ZD printers with firmware version 84.20.19, enter ZD and press Enter, then enter V84.20.19
and press Enter. (Performs a logical "AND" search.)
3.
To remove individual filters, click X to remove the filter.
(Individual filters appear on a separate line from the search and filter in the Selections box.)
4.
To remove the search filter from Selections, click X to remove the filter.
For more detailed information on how a filter changes the URL and how to make it work for you, see Search
and Filter Changes the URL
Search and Filter Changes the URL
From the Printers View, if you select a filter or add a search in the Search box, the URL visible in the
address bar is updated with the current state of the filters and searches for you.
With this new URL, you may:
l
Bookmark the page and retain this search and filter for future use.
l
Press Back on the browser to remove the last added filter.
l
Navigate to another page, press Back (to return to the Printers View Page), and your saved URL
with the filter and search returns in the address bar.
Sort a List of Printers
Sort a List of Printers
1. Click on the arrowhead inside the Sort by box to display the sort orders.
2. Select the desired sort order.
Apply and Remove a Filter
Available Filters on the Printers Listing View
l
Status: online, offline, adding printers
l
Models: Zebra printer models
l
Tags: tagged, not tagged
l
Printhead Width
l
Printer type
- 29 -
Printers View
l
Media type
l
DPI (For browsers set to a Chinese language, DPI is displayed as DPM.)
l
Link-OS version
Apply/Remove a Filter
l
To apply a filter, click on the name of the filter under Filters or Related Tags in the left pane.
l
The filter will move up to the Selections list at the top of the left pane.
l
To remove a filter, click on the filter under Selections at the top of the left pane.
l
The filter will move down to the Filters or Related Tags list.
For more detailed information on how a filter changes the URL and how to make it work for you, see Search
and Filter Changes the URL
Search and Filter Tags
The Search box (in the left pane) allows you to search for and filter tags associated with printers. Tags,
which are not associated with a printer, are not available for the special search and filter functions.
Use Search Box as a Filter for Tags
From the Printers View under Related Tags, you will see the tag names, the total tag count, and a
button.
1.
Click to expand the list of tags.
In addition to the total tag count and complete list of printer related tags, you will see a highlighted
alphanumeric list of tags along the right side of Related Tags. The initial letter is highlighted when a
tag in the list begins with that letter.
Example • If you have a tag (associated with a printer on the Printers View) for Shipping, the "S" will
be highlighted in the alphanumeric list on the right side of the Related Tags column.
2. In the Search box at the top of the column, enter letters, numbers, words, or wildcards (* and ?) to nar-
row your search.
Note • Remember tags must be associated with a printer to show in the Related Tags list.
3. To select and filter on one or more tags, click on the tag name to move it to the Selections box at the
top of the pane.
The list of printers is filtered to only those printers that match the tag selection.
4. To remove the search filter from Selections, click on the tag to remove the filter.
- 30 -
Loading...