Using the Zebra Printer with MSP
Using the Zebra Printer with MSP 72E-137921-03 Revision B July 2011
© 2011 by Motorola Solutions, Inc. All rights reserved. No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means, without permission in writing from Motorola Solutions. This includes electronic or mechanical means, such as photocopying, recording, or information storage and retrieval systems. The material in this manual is subject to change without notice.
Table of Contents About This Guide ................................................................................................ 1 Related Documents ........................................................................................................................................ 1 Service Information ......................................................................................................................................... 1 Chapter 1 - Introduction ..................................
vi -- Using the Zebra Printer with MSP Manifest File ..........................................................................................................................................13 Settings File...........................................................................................................................................14 Print Command Files .............................................................................................................................
About This Guide TheUsing the Zebra Printer with MSP document provides guidance for pre-installation planning, application set up, and the information for successfully using the Zebra Printer MSP Proxy PlugIn. Newer versions of this document may be available at http://support.symbol.com/support/product/softwaredownloads.do. Related Documents MSP 3.3.1 Release Notes, p/n 72E-100160 Understanding Mobility Services Platform 3.3.1, p/n 72E-128712 Using Mobility Services Platform 3.3.1, p/n 72E-128802 MSP 3.3.
2 Using the Zebra Printer with MSP Software license information Motorola responds to contacts by email, telephone, or fax within the time limits set forth in support agreements. If you purchased your Enterprise Mobility business product from a Motorola business partner, contact that business partner for support.
Chapter 1 - Introduction Important: The Zebra Printer MSP Proxy Plug-In can be used with the following Supported Printers: QL, QL Plus, RW, MZ, or P4T models with the 802.11 radio. Please note that it is strongly recommended to obtain the latest software from www.zebra.com to ensure proper functionality when the MSP Zebra Proxy Plug-in manages the Zebra printers.
4 -- Using the Zebra Printer with MSP where: This is the version of the primary component of the Add-On. This is a version number that is used to indicate that something has changed in the Add-On other than the primary component. This needs to be reset when the Core Version changes. format). indicates the release date of the Add-On Kit .ZIP File (represented in YYYYDDMM Each Add-On Kit .
Chapter 1 - Introduction -- 5 Release Notes Issue Information Minimum Windows PC Client version 07.03.58 Manifest file restrictions specific to Zebra Printer Proxy version 1.10.20.0 There must not be any spaces after a file name entry in the manifest file. Failure to do this will cause improper function of the Zebra Printer Proxy. AND The name of the firmware image that is entered in a manifest file must match the case of the name of the file as it is retrieved from the Zebra Website.
6 -- Using the Zebra Printer with MSP
Chapter 2 – Getting Ready to Manage Zebra Printers Device Classes and Proxies MSP has a concept called a Device Class, which is important to understand when dealing with devices that are managed via an MSP Windows PC Client. A Device Class is a type or category that is used to differentiate devices managed by MSP. This is useful when devices have different capabilities and/or need to be managed independently of other devices.
8 -- Using the Zebra Printer with MSP The Device Attributes “identity.proxyserver” and “identity.uuid” are guaranteed to be unique and are internally used by MSP to associate a device and the Windows PC that is acting as a proxy for that device. But while this value is guaranteed to be unique, it is generally not very friendly and hence is often not convenient for users managing proxied devices via the MSP Console UI. The Device Attributes “identity.proxyserverdnsname” and “identity.
Chapter 2 – Getting Ready to Manage Zebra Printers -- 9 Planning for Zebra Printer Management The MSP Windows PC Client and the Zebra Printer MSP Proxy Plug-In installed on a PC is capable of enabling the management of multiple Zebra Printers via native communications over WLAN. Each PC on which the MSP Windows PC Client and the Zebra Printer MSP Proxy Plug-In are installed must have: TCP/IP connectivity to an MSP Relay Server through which it will send and receive data .NET version 2.
10 -- Using the Zebra Printer with MSP
Chapter 3 – Managing Zebra Printers with MSP A Zebra Printer MSP Proxy Plug-In Settings object must be created and provisioned with the Zebra Printer MSP Proxy Plug-In components package in order to discover printers for a given environment with Zebra Printers. The steps below describe how to do this so Zebra Printers can be discovered and later managed. 1. Log into the MSP Console UI. 2. Go to Library>Settings and create a Zebra Printer MSP Proxy Plug-In settings profile.
12 -- Using the Zebra Printer with MSP Note: This value has to be the same as all the printers to be managed by the same Zebra Printer MSP Proxy Plug-In. 8. In the UDP port field, enter the UDP port through which the ZebraAPI DLL will communicate with the printers via UDP. Note: This value has to be the same as all the printers to be managed by the same Zebra Printer MSP Proxy Plug-In. 9. Select Finish to save these Zebra Printer MSP Proxy Plug-In Settings. 10.
Chapter 3 – Managing Zebra Printers with MSP -- 13 Table 1 13. In the MSP Console UI, go to Control > Collection Requests and create a Collection Request for the appropriate *DCC.xml file (Data Collection Category) which will collect data from the Zebra Printer for the appropriate *DCM.xml files (Data Collection Metric). Creating Packages for the Zebra Printer Overview In the past, the act of configuring a Zebra Printer required the use of a separate Zebra application like Label Vista and a serial cable.
14 -- Using the Zebra Printer with MSP Examples: The first example will download a firmware image to a supported printer. The name of the file could be FWDownload.manifest. The contents if the file could be: SHSTG10z.hex The second example will configure a supported printer. It could be named configure.manifest and will list only: PrinterSettings.settings The third example will download a Printer command which includes a font file. For this example the font file will have a “.
Chapter 3 – Managing Zebra Printers with MSP -- 15 3. In the Product Type field, select Printer and click Submit. 4. Select the appropriate printer and Programming Guide for the manual type and click Submit. 5. Download or open the document that has CPCL in its title. Note: The navigation instructions to this document are for the Zebra web site at the time this document was released. The Zebra web site may change along with the navigation path to the CPCL document.
16 -- Using the Zebra Printer with MSP Example: ! 0 200 200 210 1 TEXT 4 0 30 40 Hello World PRINT Important: Each line of the file must end with a carriage return and line feed (Enter). Firmware Files Files with the .hex extension are recognized as firmware images. These firmware images will be sent to a Zebra printer and will be programmed by a Zebra printer. The name of a firmware file would be included in a manifest file.
Chapter 3 – Managing Zebra Printers with MSP -- 17 The first step to configure one or more supported Zebra printers with a WLAN setting is to create a manifest file and a settings file. The settings file must include the corresponding Zebra CPCL do and setvar commands in the MSP format. The file name for this setting file must have a “.settings” file extension. For this example, the settings file name will be “ZebraTkip.settings”. The file should include: do:device.restore_defaults=wlan set:wlan.wpa.
18 -- Using the Zebra Printer with MSP The ZebraTkipPolicy needs to be activated. Once activated, the Zebra Printers will receive the ZebraTkipPkg package and the TKIP WLAN setting will be applied via the Windows PC Client and the Zebra Printer MSP Proxy Plug-In.Chapter 5 – Using Zebra Printer Management Support How to use the Zebra Printer Management Support A Zebra Printer is managed via a Windows PC on which the MSP Windows PC Client and Zebra Printer MSP Proxy Plug-In are installed.
Chapter 3 – Managing Zebra Printers with MSP -- 19 identity.deviceid This Device Attribute indicates the Zebra printer’s identification; this is the printer’s serial number. identity.oemversion This Device Attribute is the OEM version of the Zebra printer. identity.uuid This Device Attribute provides the unique hardware identifier of the managed Zebra Printer. identity.devicemodel This Device Attribute provides the Zebra Printer model name of the managed Zebra Printer. identity.
20 -- Using the Zebra Printer with MSP Memory Load This metric represents the percentages of memory usage at the time the metric was sampled. Total Physical Memory Metric This metric represents the total physical memory on an Zebra printer. The unit and value can be found when viewing the collected data for a given Zebra printer Available Physical Memory Metric This metric represents the available physical memory on a Zebra printer.
Chapter 4 – Uninstalling and Troubleshooting Uninstalling The following instructions describe how to uninstall the Proxy Plug-in. 1. Log in to the MSP Console UI. 2. Go to Library > Bundles and create an uninstall bundle which includes the Zebra Printer MSP Proxy Plug-In uninstall package and the Zebra Printer MSP Proxy Plug-In settings uninstall package. 3.
22 -- Using the Zebra Printer with MSP Win32 event log Errors related to installing, starting, stopping, or removing the Windows PC Client service are written to the Win32 Application event log. To view this log, click Start > Administrative Tools > Event Viewer > Application.
Motorola Solutions, Inc. One Motorola Plaza Holtsville, New York 11742, USA 1-800-927-9626 http://www.motorolasolutions.com © Motorola Solutions, Inc.
