Zebra Technologies P1065697-002 User Manual

P1065697-002

Link-OS™

Profile Manager

Installation Guide

Copyright and Liability Disclaimer

2

therein are owned by ZIH Corp. and Zebra’s licensors. Unauthorized reproduction of this manual or the software and/ or firmware in the printer 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.

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 Corporation.

Product Improvements Continuous improvement of products is a policy of Zebra Technologies Corporation.

All specifications and designs are subject to change without notice.

Liability Disclaimer Zebra Technologies Corporation takes steps to ensure that its published Engineering

specifications and manuals are correct; however, errors do occur. Zebra Technologies Corporation reserves the right to correct any such errors and disclaims liability resulting therefrom.

Limitation of Liability In no event shall Zebra T echnologies Corporation 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 Corporation 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.

P1065697-002 10/27/14

About This Document

This section provides you with contact information, document structure, and organization.

Contents

Who Should Use This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

10/27/14 Profile Manager P1065697-002

About This Document

6

Who Should Use This Document

This is intended for use by any person who needs to perform routine maintenance, upgrade, or troubleshoot problems with the printer.

How This Document Is Organized

The is set up as follows:

Section Description

Installation on page 9 This chapter includes the procedure to install

Profile Manager.

Adding the Zebra Certificate Authority on page 63

Changing Permissions on page 93 This chapter includes the procedure to change

Getting Started Using Profile Manager on page 97

This chapter includes the procedure to add the Zebra Certificate Authority to the Trusted Root Certifications Authorities Store.

permissions to allow the Zebra Certificate Authority (CA) successfully.

This chapter provides an overview and description of the steps necessary to set up and begin to use Profile Manager. For additional details, please see the help system contained within the Profile Manager application.

P1065697-002 10/27/14

About This Document

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.pdf 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

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

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

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

Icons Used

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

7

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/27/14 P1065697-002

About This Document

8

Document Conventions

Notes • ___________________________________________________________________

__________________________________________________________________________

P1065697-002 10/27/14

Installation

This chapter includes the procedure to install Profile Manager.

Contents

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Supported Operating Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Installation for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Installation for Red Hat Enterprise Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

10/27/14 P1065697-002

Installation

10

System Requirements

Supported Operating Systems

Windows:

• 64-bit Windows 7 or Windows Server 2008 R2

• Tomcat version 7.0.42 64-bit for Windows:

http://www.us.apache.org/dist/tomcat/tomcat-7/v7.0.42/bin/apache-tomcat-

7.0.42-windows-x64.zip

• Java Virtual Machine (JVM) Version 6.0.43 Download:

http://www.oracle.com/technetwork/java/javasebusiness/downloads/javaarchive-downloads-javase6-419409.html#jre-6u43-oth-JPR

- You must accept the license agreement.

- For Windows 64-bit, choose: Windows x64 (11MB) jre-6u43-windows-x64.exe

Linux:

• 64-bit Red Hat Enterprise Linux version 6.4 and higher

Browsers

• Tomcat version 7.0.42 Core for Linux:

http://www.us.apache.org/dist/tomcat/tomcat-7/v7.0.42/bin/apache-tomcat-

7.0.42.zip

• Java Virtual Machine (JVM) Version 6.0.43 Download:

http://www.oracle.com/technetwork/java/javasebusiness/downloads/javaarchive-downloads-javase6-419409.html#jre-6u43-oth-JPR

- You must accept the license agreement.

- For Linux 64-bit choose: Linux x64 (19.82 MB) jre-6u43-linux-x64-rpm.bin

• Chrome browser version 29 and higher

• Internet Explorer version 10 and higher

P1065697-002 10/27/14

Before You Begin

1. Which operating system are you installing?

If you are installing... Then

Windows OS Continue with Installation for Windows. Linux OS Go to Installation for Red Hat Enterprise Linux

Installation for Windows

1. Install Java JRE version 6. For more details about how to install Java for Windows, go to

http://www.java.com/en/download/help/download_options.xml#windows

on page 37.

Installation

Before Y ou Begin

11

10/27/14 P1065697-002

Installation

12

Installation for Windows

2. Once Java is installed, the JRE_HOME environment variable needs to be set.

Note • The CATALINA_OPTS environment variable change listed here is recommended

based upon a 50 user, 500 printer configuration. As more printers or users are required the individual memory values may need to be adjusted. Please contact your Reseller for details on how to do this.

Note • A 64-bit Java Virtual Machine (JVM) is required to support the

CATALINA_OPTS parameters.

a. Open the Control Panel. b. Select System. c. See Figure 1. Click on Advanced system settings.

Figure 1 • Control Panel > System

P1065697-002 10/27/14

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

Figure 2 • Advanced Tab

Installation

Installation for Windows

13

10/27/14 P1065697-002

Installation

14

Installation for Windows

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

New....

Figure 3 • Environment Variables Dialog

P1065697-002 10/27/14

Installation

Installation for Windows

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

appropriate boxes.

Note • When entering the variable name and variable value, do not enter surrounding

quotes.

Figure 4 • New System Variable

15

10/27/14 P1065697-002

Installation

16

Installation for Windows

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

New....

i. See Figure 5. Enter the Variable name and Variable value in the appropriate boxes.

Variable value should be set to:

-XX:MaxPermSize=512M -Xms512m -Xmx4096m

Note • When entering the variable name and variable value, do not enter surrounding

quotes.

Figure 5 • Setting the CATALINA_OPTS Environment Variable

3. Download the Zebra Link-OS Application Server zip file:

www.zebra.com/profilemanager

4. Extract the Zebra Link-OS Application Server zip file contents to: C:\zebra\linkos

5. Download the Tomcat zip file:

http://www.us.apache.org/dist/tomcat/tomcat-7/v7.0.42/bin/apache-tomcat-

7.0.42-windows-x64.zip

6. Extract the Tomcat zip to C:\zebra\linkos\tomcat

7. See Figure 6. Open a command prompt.

Figure 6 • Command Prompt

P1065697-002 10/27/14

Installation for Windows

8. See Figure 7. Change the current directory to the C:\zebra\linkos

Figure 7 • Change Directory from Command Line

Installation

17

10/27/14 P1065697-002

Installation

18

Installation for Windows

9. See Figure 8 and Figure 9. The JVM Certificate Authority keystore must be updated in

order to trust the Zebra Weblink Certificate Authority and the GeoTrust™ Subordinate CA.

Note • Omitting or incorrectly performing this step could lead to several issues.

• If the GeoTrust certificate is not added, it will not be possible to successfully register

the product and will prevent printers from being connected.

• If the ZebraCAChain certificate is not added correctly, the printer will not be able to

connect successfully.

To update the keystore, execute the following keytool command (running command prompt as admin).

"%JRE_HOME%\bin\keytool.exe" -importcert -file ZebraCAChain.cer ^

-keystore "%JRE_HOME%\lib\security\cacerts" -alias "ZebraCAChain"

Note • The default keytool password is changeit

Figure 8 • Add ZebraCAChain to Keystore

P1065697-002 10/27/14

Figure 9 • Confirm Certificate

Installation

Installation for Windows

19

a. See Figure 10. To update the keystore, execute the following keytool command

(running command prompt as admin).

"%JRE_HOME%\bin\keytool.exe" -importcert -file ^ GeoTrustSSLCA.cer -keystore ^ "%JRE_HOME%\lib\security\cacerts" -alias "GeoTrustSSLCA"

Note • The default keytool password is changeit

Figure 11 shows the results after the keystore is updated.

Figure 10 • Add GeoTrustSSLCA to Keystore

10/27/14 P1065697-002

Installation

20

Installation for Windows

Figure 11 • Successful Addition to Keystore

P1065697-002 10/27/14

Installation

Installation for Windows

10. See Figure 12. Verify the certificates were correctly installed by entering the following

command:

"%JRE_HOME%\bin\keytool.exe" ^

-keystore "%JRE_HOME%\lib\security\cacerts" ^

-alias "ZebraCAChain" -list

a. Enter keystore password (default password is changeit).

The console will show the following:

ZebraCAChain, Feb 18, 2013, trustedCertEntry,

Certificate fingerprint (MD5): ED:D2:75:F3:84:5E:32:E7:82:5A:3C:4D:1A:B4:73:2C

b. Enter the following command:

"%JRE_HOME%\bin\keytool.exe" ^

-keystore "%JRE_HOME%\lib\security\cacerts" ^

-alias "GeoTrustSSLCA" -list

c. Enter keystore password (default password is changeit).

The console will show the following:

GeoTrustSSLCA, Aug 5, 2013, trustedCertEntry, Certificate fingerprint (MD5):

DF:F1:B7:6B:25:8D:BE:73:48:E3:76:68:97:A9:38:71

21

Figure 12 • Verifying the Certificate Installation

10/27/14 P1065697-002

Installation

22

Installation for Windows

11. See Figure 13. Copy the zebra.war and linkos.war files from the into the

C:\zebra\linkos\tomcat\webapps directory.

Figure 13 • Webapps Directory for Tomcat

P1065697-002 10/27/14

Installation for Windows

12. See Figure 14. Navigate to the C:\zebra\linkos\tomcat\bin\ folder.

Figure 14 • C:\Tomcat\bin Directory

Installation

23

10/27/14 P1065697-002

Installation

24

Installation for Windows

a. See Figure 15. Start the Tomcat server by double-clicking on startup.bat.

Figure 15 • Startup.bat File for Tomcat

P1065697-002 10/27/14

13. See Figure 16. Verify that Tomcat started correctly. a. Look for the line that starts:

INFO: Server startup in xxxxx ms

Figure 16 • Tomcat Server Start

Installation

Installation for Windows

25

14. See Figure 17. Open a web browser to: http://localhost:8080/linkos/register.

10/27/14 P1065697-002

Installation

26

Installation for Windows

15. See Figure 17. Fill in the registration form completely.

Note • The entry in the Company Street Address field must be limited to 30 characters.

a. Read and check the box to accept the End User License Agreement.

Note • The port specified will be the SSL port used by printers and browsers to securely

connect to your server. Confirm that it is not currently in use (by your server) or ask your IT department to confirm.

Figure 17 • Registration Form

b. Click Register.

P1065697-002 10/27/14

Installation

Installation for Windows

See Figure 18. The registration is successfully completed and your SSL certificate has been created.

Figure 18 • Registration Successful

27

10/27/14 P1065697-002

Installation

28

Installation for Windows

16. See Figure 19 and Figure 20. Using a text editor, like Notepad, open the specified

.readme instructions file in the C:\zebra\linkos\tomcat\conf\ directory.

Figure 19 • Directory for Readme File

Figure 20 • Readme File Contents

P1065697-002 10/27/14

Installation for Windows

17. Copy line 4 (highlighted in Figure 20).

The auto-generated connector is the configuration for the HTTPS port that printers and browsers will use to connect to your server.

18. See Figure 21. Open the server.xml file located in

C:\zebra\linkos\tomcat\conf\.

Installation

29

10/27/14 P1065697-002

Installation

30

Installation for Windows

19. See Figure 21. Locate the Connector xml element that looks as follows:

Figure 21 • Locate the Connector Element in the server.xml File

P1065697-002 10/27/14