Zebra Technologies P1058563-003 User Manual

P1058563-003

Zebra

AirWatch™ Connector

User Guide

therein are owned by ZIH Corp. and Zebra’s licensors. Unauthorized reproduction of this manual or the software and/or firmware in the print engine may result in imprisonment of up to one year and fines of up to $10,000 (17 U.S.C.506). Copyright violators may be subject to civil liability.

This product may contain ZPL

, ZPL II®, and Link-OS™ programs; Element Energy Equalizer® Circuit; E3®; and

Energy Equalizer Circuit, and E

All other brand names, product names, or trademarks belong to their respective holders. For additional trademark information, please see “Trademarks” on the product CD.

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.

(the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING

BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

libCurl Library COPYRIGHT AND PERMISSION NOTICE Copyright © 1996 - 2012, Daniel Stenberg, <daniel@haxx.se>. All rights reserved. Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A P AR TICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

is a registered trademark in the United States and other countries, exclusively licensed through 'The Open Group'. Microsoft, Windows, WindowsNT, and Win32 are registered trademarks of Microsoft Corporation. Linux is a registered trademark of Linus Torvalds. All other product names mentioned herein and throughout the entire web site are trademarks of their respective owners.

"Apache Tomcat" and "Tomcat" are trademarks of the Apache Soft ware Foundation. Use of these trademarks is subject to the terms of section 6 of Apache License, Version 2.0 (current)

10/31/13 P1058563-003

Notes • ____________________________________________________________________

__________________________________________________________________________

P1058563-003 10/31/13

About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

What the AirWatch Connector Does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Supported Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Installing in a Windows Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Configuring Printers with WebLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Configuring Weblink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Using AirWatch Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Printer Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Organizing Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Updating Printer Firmware and Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Checking Printer Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

10/31/13 P1058563-003

Contents

T roubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

SSL/TLS Certificate Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Other Typical Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

HTTP Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

WebLink Set/Get/Do Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Introduction to SGD Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

weblink.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

weblink.ip.conn[1|2].authentication.add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

weblink.ip.conn[1|2].authentication.entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

weblink.ip.conn[1|2].authentication.remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

weblink.ip.conn[1|2].enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

weblink.ip.conn[1|2].location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

weblink.ip.conn[1|2].maximum_simultaneous_connections . . . . . . . . . . . . . . . . . . . . 74

weblink.ip.conn[1|2].proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

weblink.ip.conn[1|2].retry_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

weblink.ip.conn[1|2].test.location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

weblink.ip.conn[1|2].test.retry_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

weblink.ip.conn[1|2].test.test_on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

weblink.logging.clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

weblink.logging.entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

weblink.logging.max_entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

weblink.printer_reset_required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

weblink.restore_defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

P1058563-003 10/31/13

About This Document

This section provides you with contact information, documen t struc ture and organization, and additional reference documents.

Contents

Who Should Use This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

10/31/13 P1058563-003

About This Document

Who Should Use This Document

This User Guide is intended for use by any person who needs to install, perform routine maintenance, upgrade, or troubleshoot proble ms with the Zebra Airwatch Connector software.

How This Document Is Organized

The User Guide is set up as follows:

Section Description

Introduction This section provides general information about

Installation This section outlines the system requirements for

Configuring Printers with WebLink This section describes basic, network, and firewall

the Zebra AirWatch Connector.

installation and provides specific details for the installation of Zebra AirWatch Connector.

configurations for printers connected to Zebra AirWatch Connector.

Using AirWatch Connector This section provides specific information about

organizing and managing printers via Zebra AirWatch Connector.

Troubleshooting This section provides troubleshooting information

about the Zebra AirWatch Connector.

WebLink Set/Get/Do Commands This section describes the Set/Get/Do commands,

parameters, and values that are available with Zebra AirWatch Connector.

P1058563-003 10/31/13

Document Conventions

The following conventions are used throughout this document to convey certain information.

Alternate Color (online only) Cross-references contain hot links to other sections in this guide. If you are viewing this guide online in .p df format, you can click the cross-reference (blue text) to jump directly to its location.

Command Line Examples Command line examples appear in Courier New font. For example, type

Files and Directories File names and directories appear in Courier New font. For example, the

Icons Used

Important • Advises you of informatio n that is essential to complete a task.

ZTools to get to the Post-Install scripts in the bin directory.

Zebra<version number>.tar file and the /root directory.

About This Document

Document Conventions

Note • Indicates neutral or positive information that emphasizes or supplements important

points of the main text.

Example • Provides an example, often a scenario, to better clarify a section of text.

10/31/13 P1058563-003

About This Document

Notes • ___________________________________________________________________

__________________________________________________________________________

Document Conventions

P1058563-003 10/31/13

Introduction

This section provides general information about the Zebra AirWatch Connector.

Contents

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

What the AirWatch Connector Does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Supported Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Supported Operating Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

10/31/13 P1058563-003

Introduction

Overview

The Zebra AirWatch Connector partners with the AirWatch server to manage your Zebra Link-OS

Zebra AirWatch Connector will:

™ printers.

• Monitor printers and report issues to the AirWatch system

• Monitor printer alerts

• Enable administrators to send files and operating system updates to the printer via the AirWatch server console

What the AirWatch Connector Does

Zebra AirW atch Connector sends alert s to AirWatch, watches printers coming online, monitors the status of the printers, and sends files and set tings to the printers.

Supported Printers

•QLn320™ Ethernet and Wi-Fi

•QLn220™ Ethernet and Wi-Fi

•QLn420

•iMZ320™ Wi-Fi

•iMZ220™ Wi-Fi

• ZT200

•ZD500R™ Ethernet and Wi-Fi

™

Ethernet and Wi-Fi

™

Series Ethernet and Wi-Fi

Supported Operating Systems

The Zebra AirWatch Connector supports the 32-bit or 64-bit versions of the following:

•Windows

• Windows Server 2008 R2 (also known as Windows 7 Server)

Server 2008

P1058563-003 10/31/13

Installation

This section outlines the system requirements for installation and provides specific details for the installation of Zebra AirWatch Connector.

Contents

Installing in a Windows Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Minimum System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Step 1: Install an AirWatch Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Step 2: Install Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Step 3: Set Up Zebra AirWatch Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Step 4: Create a Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Step 5: Set Up Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Step 6: Test a Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

10/31/13 P1058563-003

Installation

Installing in a Windows Operating System

Minimum System Requirements

The Zebra AirWatch Connector supports the 32-bit or 64-bit versions of the following:

• Windows Server 2008

• Windows Server 2008 R2 (also known as Windows 7 Server)

Note • This system should be installed on a “clean” Windows Server. A clean system is one

that does not already include Apache Tomcat Tomcat will be installed as part of this installation procedure and must be the only Tomcat

version resident on this system. Multiple versions of Tomcat will encounter conflicts.

™

or any other server software installation.

P1058563-003 10/31/13

Installation Steps

Step 1: Install an AirWatch Server

1. Contact AirWatch. a. Contact AirWatch Customer Support to obtain an AirWatch version 6.3 or later

installation.

b. Obtain the AirWatch Endpoint URL from your AirWatch support representative.

Note • The URL you will be searching for usually starts with the deviceservices

server. Ask for the Zebra printer management URL.

Example • https://airwatchportals.com/deviceservices/peripheralservice/v1/register

Step 2: Install Software

1. Install Zebra AirWatch Connector software. a. Open a web browser. b. Download and install Java Runtime version 7 or greater:

http://www.java.com/en/download/index.jsp

c. Download and install the Java Cryptography Extension:

http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-

432124.html

d. Download and install the latest version of Open SSL:

http://slproweb.com/products/Win32OpenSSL.html

Installation

Installation Steps

10/31/13 P1058563-003

Installation

Installation Steps

2. Once Java is installed, the JAVA_HOME environment variable needs to be set. a. Open the Control Panel. b. Select System. c. See Figure 1. Click on Advanced system settings.

Figure 1 • Control Panel > System

P1058563-003 10/31/13

d. See Figure 2. Click on the Advanced tab. e. Click on Environment Variables.

Figure 2 • Advanced Tab

Installation

Installation Steps

10/31/13 P1058563-003

Installation

Installation Steps

f. See Figure 3. To create a new environment variable under System variables, click on

New....

Figure 3 • Environment Variables Dialog

P1058563-003 10/31/13

Installation

Installation Steps

g. See Figure 4. Enter the Variable name and Variable value shown below in the

appropriate boxes.

Figure 4 • New System Variable

h. Click OK to save the new system variable and value.

10/31/13 P1058563-003

Installation

Installation Steps

i. See Figure 5. To edit the path variable under System variables, click on Edit....

Figure 5 • Environment Variables Dialog

P1058563-003 10/31/13

Installation

Installation Steps

j. See Figure 6. Add the following lines to the end of the Variable value:

C:\Program Files (x86)\Java\jre7\bin; C:\openssl\bin;

Figure 6 • New System Variable

k. Click OK to save the system variable and value. l. Navigate to www.zebra.com/linkos and download the Zebra AirWatch Connector.

3. Run install.exe. a. You must accept the terms of the License Agreement to continue. b. Click Next.

10/31/13 P1058563-003

Installation

Installation Steps

4. Determine the location to install the Zebra AirWatch Connector.

5. Click Next.

6. The installer will fill in the Zebra Endpoint URL.

Note • If the URL does not match your DNS server name, change the DNS name to your

server name.

Example • http://zserver.abccompanyinc.com/zebra_airwatch_connector/zebra/wakeup

7. Enter the AirWatch Endpoint URL (obtained during the AirWatch server installation).

Note • The URL starts with the deviceservices server. Ask for the Zebra printer

management URL.

Example • https://airwatchportals.com/deviceservices/peripheralservice/v1/register

P1058563-003 10/31/13

Installation Steps

8. Enter the string XXXX-XXXX-XXXX-XXXX for the AirWatch Server token.

9. Enter the base Group ID for your company from your AirWatch installation.

Installation

10. Click Next.

10/31/13 P1058563-003

Installation

Installation Steps

11. Verify that the wizard summary file locations are correct as shown.

P1058563-003 10/31/13

12. Click Install.

Installation

Installation Steps

13. Click Done.

10/31/13 P1058563-003

Installation

Installation Steps

Step 3: Set Up Zebra AirWatch Connector

1. Set up the Zebra AirWatch Connector within the AirWatch console. a. Open a web browser. b. Log into the AirWatch console.

2. Under Menu, select Peripherals > Printer Management (shown in red).

P1058563-003 10/31/13

3. Under System Settings, select Print Server.

Installation

Installation Steps

4. Select Add Zebra Print Server (see the preceding graphic and area in red).

Note the HMAC token. (You will need the token later in this procedure.)

5. Enter your user information.

6. Enter the Zebra ServiceUID in the UID section.

10/31/13 P1058563-003

+ 63 hidden pages