Page 2 - Proprietary Statement; Liability Disclaimer
© 2015 ZIH Corp. The copyrights in this manual and the software and/or firmware in the print engine described 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 yea...
Page 4 - Notes •
4 P1071336-002 1/20/15 Notes • ___________________________________________________________________ __________________________________________________________________________ __________________________________________________________________________ _____________________________________________...
Page 5 - Contents
1/20/15 P1071336-002 Contents About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 How This Document Is Organized . . ...
Page 7 - About This Document
1/20/15 P1071336-002 About This Document This section provides you with contact information, document structure and organization, and additional reference documents. Contents Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8How Thi...
Page 8 - Who Should Use This Document; The User Guide is set up as follows:; Section; Introduction
About This Document Who Should Use This Document 8 P1071336-002 1/20/15 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 problems with the SOTI MobiControl Connector software. How This Document ...
Page 9 - Document Conventions; Alternate Color; blue text; Command Line Examples; Courier; Files and Directories; Courier New; Icons Used; Important •
9 About This Document Document Conventions 1/20/15 P1071336-002 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 gu...
Page 12 - Overview
Introduction Overview 12 P1071336-002 1/20/15 Overview The Zebra SOTI MobiControl Connector partners with the SOTI MobiControl server to manage your Zebra Link-OS ™ printers. SOTI MobiControl Connector will: • Monitor printers and report issues to the SOTI system • Monitor printer alerts • Enable ad...
Page 13 - Installation
1/20/15 P1071336-002 Installation This section outlines the system requirements for installation and provides specific details for the installation of SOTI MobiControl Connector. Contents Installing in a Windows Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1...
Page 14 - Installing in a Windows Operating System; Minimum System Requirements; • Windows Server 2008 R2 (also known as Windows 7 Server); Note •; that does not already include Apache Tomcat
Installation Installing in a Windows Operating System 14 P1071336-002 1/20/15 Installing in a Windows Operating System Minimum System Requirements The SOTI MobiControl Connector supports the 64-bit version of the following: • Windows Server 2008 • Windows Server 2008 R2 (also known as Windows 7 Serv...
Page 15 - Installation Steps; Step 1: Install a MobiControl Server; or later; All Platforms; At the bottom of the screen, click on; Servers; and then click; Create PAS Interface
15 Installation Installation Steps 1/20/15 P1071336-002 Installation Steps Step 1: Install a MobiControl Server 1. Contact SOTI. a. Contact SOTI Customer Support to obtain an MobiControl version 12.0 or later installation. b. Visit https://www.soti.net/services/support/mobicontrol/ . 2. Log in to th...
Page 16 - Create
Installation Installation Steps 16 P1071336-002 1/20/15 6. Enter a name for the Printer Administration Server (PAS) Profile, and then click Create .
Page 17 - (highlighted in the red box below) to start generating the; Download; (highlighted in the orange box below) to start generating the; You may have to create the directory for the certificate.
17 Installation Installation Steps 1/20/15 P1071336-002 7. In Step 1a, click Download (highlighted in the red box below) to start generating the MobiControl Root Certificate. 8. When prompted, select Save As to save the certificate to the following directory: My Documents\zebra_certs\ 9. In Step 1b,...
Page 18 - Create a password to proceed with the download process.; Click; Finish
Installation Installation Steps 18 P1071336-002 1/20/15 10. Create a password to proceed with the download process. Be sure to note the password for future reference. 11. Click Download . 12. Download the PAS Client Certificate and save it in the following directory: My Documents\zebra_certs\ 13. Cl...
Page 19 - Step 2: Install Software; Download SOTI MobiControl Connector software.
19 Installation Installation Steps 1/20/15 P1071336-002 Step 2: Install Software 1. Download SOTI MobiControl Connector software. 2. Run install.exe .
Page 20 - Next; I Agree; to accept the terms of the License Agreement.
Installation Installation Steps 20 P1071336-002 1/20/15 3. Click Next . 4. Click I Agree to accept the terms of the License Agreement.
Page 21 - Fill in all of the open fields in this form.; after completing the form.; Example •; Listed below are examples of possible FQDN server names:
21 Installation Installation Steps 1/20/15 P1071336-002 5. Fill in all of the open fields in this form. a. The Server Name (FQDN) is the domain name of the computer where the software is being installed. b. Click Next after completing the form. Example • Listed below are examples of possible FQDN se...
Page 23 - Install; Wait for the installation process to complete, and then click; to close the Setup Wizard.
23 Installation Installation Steps 1/20/15 P1071336-002 7. Click Next . 8. Choose the location where you wish to install the SOTI MobiControl Connector software. 9. Click Install to proceed. 10. Wait for the installation process to complete, and then click Next . 11. Click Finish to close the Setup ...
Page 24 - Step 3: Test a Printer; Enable Printer Discovery; Printer
Installation Installation Steps 24 P1071336-002 1/20/15 Step 3: Test a Printer Enable Printer Discovery In this section, you must create a “rule” in the SOTI MobiControl Console in order to discover your printers. 1. Click on the Printer tab on the SOTI MobiControl Console. 2. Click Rules in the tas...
Page 25 - Enter the name of the rule.
25 Installation Installation Steps 1/20/15 P1071336-002 4. Enter the name of the rule. Important • A best practice is to create a default rule to enroll devices automatically. For example, you might choose “Discover Printers” or “Auto Enroll” as the rule name.
Page 26 - Select the top level Device Group.; on the Filter dialog box.
Installation Installation Steps 26 P1071336-002 1/20/15 5. Select the top level Device Group. 6. Click Next . 7. Click Next on the Blacklist/Whitelist dialog box. 8. Click Next on the Filter dialog box.
Page 27 - Device Serial Number
27 Installation Installation Steps 1/20/15 P1071336-002 9. To change the device name to show the serial number of the printer, click on the gear icon and select Device Serial Number . 10. Click Next .
Page 28 - Review the Create Add Devices Rule information, and click
Installation Installation Steps 28 P1071336-002 1/20/15 11. Review the Create Add Devices Rule information, and click Finish .
Page 29 - Step 4: Set Up Printers; Zebra Setup Utilities
29 Installation Installation Steps 1/20/15 P1071336-002 Step 4: Set Up Printers 1. Set up your printers to communicate with SOTI: a. Download the latest operating system for your printers from http://www.zebra.com . b. Using the ZDownloader Utility, install the firmware on your Zebra printers. (To...
Page 30 - Discover Your Printers; Click the; tab and; Devices; Select the top level; Device Group; Select one of the printers in the center pane.; Information
Installation Installation Steps 30 P1071336-002 1/20/15 Discover Your Printers 1. Click the Printer tab and Devices in the taskbar (at the bottom of the screen). 2. Select the top level Device Group in the left pane. 3. Select one of the printers in the center pane. 4. Click Information in the right...
Page 32 - Configuring Weblink; Basic Configuration; Difference Between Conn1; To configure the printer to connect to the remote server:; When a Proxy Server is Part of the Network Configuration
Configuring Printers with WebLink Configuring Weblink 32 P1071336-002 1/20/15 Configuring Weblink When any WebLink setting (with the exception of the logging settings) is adjusted either via SNMP, SGD, or JSON it is required that the printer be reset before the new value takes effect. The weblink.pr...
Page 33 - To specify an alternate port, configure the proxy as follows:; When HTTP Authentication is Necessary
33 Configuring Printers with WebLink Configuring Weblink 1/20/15 P1071336-002 • The proxy server port (optional) • The username and password for the proxy (optional) To supply the address of the proxy server (assuming a default port and no username/password), configure the proxy setting as follows: ...
Page 34 - Additional Firewall Configuration
Configuring Printers with WebLink Configuring Weblink 34 P1071336-002 1/20/15 Additional Firewall Configuration Some firewalls do not allow the first connection attempt for a device to be HTTPS, or they require newconnections to be made periodically in order to keep the initial connections intact. T...
Page 35 - Navigating the Log Output; SSL/TLS Certificate Errors
35 Configuring Printers with WebLink Configuring Weblink 1/20/15 P1071336-002 The logging settings are atypical to the Weblink settings as they do not require the printer to be reset before taking effect. This does not mean that previous logging messages that would have been logged will appear when ...
Page 37 - Troubleshooting
1/20/15 P1071336-002 Troubleshooting This section provides troubleshooting information about the SOTI MobiControl Connector. Contents Installation Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38SSL/TLS Certificate Errors . . . ....
Page 38 - Installation Errors; Issue; MobiControl
Troubleshooting Installation Errors 38 P1071336-002 1/20/15 Installation Errors Restarting the SOTI MobiControl Connector 1. Navigate to the Control Panel > Administrative Tools. 2. Start the Services application. 3. Click on the SOTI MobiControl Connector service. 4. In the left pane of the scre...
Page 39 - Error
39 Troubleshooting SSL/TLS Certificate Errors 1/20/15 P1071336-002 SSL/TLS Certificate Errors Secure connections to the remote server present the opportunity for several errors when attempting to connect. The errors typically involve the certificates used when connecting via SSL or TLS. This section...
Page 41 - Other Typical Errors; After 60 seconds of inactivity on the connection
41 Troubleshooting Other Typical Errors 1/20/15 P1071336-002 Other Typical Errors While SSL/TLS connection errors are the most common, there are issues that can arise that prevent a successful connection. This section highlights the most common issues. Error Cause / Solution "Read failed wit...
Page 43 - Does the value in; HTTP Messages; Message; This indicates that an
43 Troubleshooting HTTP Messages 1/20/15 P1071336-002 17. Does the value in weblink.ip.conn1.location match either the Common Name or one of the names listed in the Subject Alternate Name of the remote server’s certificate? 18. Is the proxy server configured correctly and does the respective proxy s...
Page 45 - Commands
1/20/15 P1071336-002 WebLink Set/Get/Do Commands This section describes the Set/Get/Do commands, parameters, and values that are available with SOTI MobiControl Connector. Contents Introduction to SGD Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46...
Page 46 - Introduction to SGD Commands; Zebra Programming
WebLink Set/Get/Do Commands Introduction to SGD Commands 46 P1071336-002 1/20/15 Introduction to SGD Commands For more specific information about SGD syntax and structure, see the Zebra Programming Guide section on Set/Get/Do Command Structure. To send SGD commands to a printer, use the Zebra Setup ...
Page 47 - Description; values are set, then this SGD will be set to; Type; if any of the .location values are set
47 WebLink Set/Get/Do Commands weblink.enable 1/20/15 P1071336-002 weblink.enable Description This command indicates if one or more of the weblink connections are active. If there is more than one connection under the weblink branch (for example, weblink.ip.conn1 ) and if any of the .location values...
Page 48 - triplet into the list of authentication entries.; do not have any affect on this; Supported Devices; This setting only be changed when
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].authentication.add 48 P1071336-002 1/20/15 weblink.ip.conn[1|2].authentication.add Description This command allows the user to add a single server/username/password triplet into the list of authentication entries. When the printer attempts to connect ...
Page 49 - In this example, a username and a password is supplied:; In this example, no password is supplied; In this example, no username is supplied (note the double space); In this example, no username or password is supplied
49 WebLink Set/Get/Do Commands weblink.ip.conn[1|2].authentication.add 1/20/15 P1071336-002 Commands Details setvar This command adds a single server/username/password triplet to the list of authentication entries. Format: • ! U1 setvar "weblink.ip.conn1.authentication.add" "serv...
Page 50 - so that each shows up on its own line.; This command lists the server names for the specified connection.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].authentication.entries 50 P1071336-002 1/20/15 weblink.ip.conn[1|2].authentication.entries Description This command lists the server names added to the authentication entries list. Only the server names will be shown. The username and passwords will n...
Page 51 - triplet from the list of authentication entries.; In this example, a username and a password is supplied
51 WebLink Set/Get/Do Commands weblink.ip.conn[1|2].authentication.remove 1/20/15 P1071336-002 weblink.ip.conn[1|2].authentication.remove Description This command allows the user to remove a single server/username/password triplet from the list of authentication entries. To remove an entry only the ...
Page 53 - • iMzTM series; This command sets the server URL for the specified connection.
53 SGD Wireless Commands weblink.ip.conn[1|2].location 1/20/15 P1071336-002 weblink.ip.conn[1|2].location Description This command assigns the URL of the server for this connection. The URL must follow the URL rules for the HTTP[S] protocol outlined in RFC2396 (http://www.ietf.org/rfc/rfc2396.t...
Page 54 - connections; that can be initiated by the printer.; This command sets the maximum number of connections.; This example sets the conn1 maximum connections to 3.
SGD Wireless Commands weblink.ip.conn[1|2].maximum_simultaneous_ connections 54 P1071336-002 1/20/15 weblink.ip.conn[1|2].maximum_simultaneous_ connections Description This command indicates the maximum number of simultaneous connections that can be initiated by the printer. Via the main conne...
Page 56 - This command assigns the URL of the connection proxy.; Any valid URL up to 2048 characters; Examples of how to connect to various proxy servers:
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].proxy 56 P1071336-002 1/20/15 do This command assigns the URL of the connection proxy. Format: • ! U1 do "weblink.ip.conn1.proxy" "url" • ! U1 do "weblink.ip.conn2.proxy" "url" Values: • Any valid URL up...
Page 57 - server URL provided in
57 WebLink Set/Get/Do Commands weblink.ip.conn[1|2].retry_interval 1/20/15 P1071336-002 weblink.ip.conn[1|2].retry_interval Description This command sets the number of seconds between attempts to connect to the server URL provided in weblink.ip.conn1.location . If an attempt is unsuccessful or the c...
Page 58 - This command sets the URL to hold for testing a connection.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].test.location 58 P1071336-002 1/20/15 weblink.ip.conn[1|2].test.location Description This command holds the URL for testing a connection to the internet. This is meant to assist users in debugging their printer's connection to remote servers when ther...
Page 60 - This command determines how often, in seconds, a connection to the; This command retrieves the retry interval.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].test.retry_interval 60 P1071336-002 1/20/15 weblink.ip.conn[1|2].test.retry_interval Description This command determines how often, in seconds, a connection to the test.location URL should be attempted. This setting is only applicable when the tes...
Page 61 - This command retrieves the test connection setting.
61 WebLink Set/Get/Do Commands weblink.ip.conn[1|2].test.test_on 1/20/15 P1071336-002 weblink.ip.conn[1|2].test.test_on Description This command determines when the test connection should be attempted. This assists in debugging the printer's connection to remote servers when there are issues with th...
Page 63 - This command clears the weblink log entires.
63 WebLink Set/Get/Do Commands weblink.logging.clear 1/20/15 P1071336-002 weblink.logging.clear Description This command clears the weblink log. Setting this value to anything will clear it, including an empty string. ^JUF, ^JUS, ^JUN, ^JUA , and device.restore_defaults do not have any affect ...
Page 64 - a maximum value that is set by; This command returns a lists of entries in the weblink log.; This example shows the result from
WebLink Set/Get/Do Commands weblink.logging.entries 64 P1071336-002 1/20/15 weblink.logging.entries Description This command returns the N number of entries in the weblink log, where N has a maximum value that is set by weblink.logging.max_entries . The weblink log is a collection of events related ...
Page 65 - will be stored in the; Setting the value to 0 disables logging.
65 WebLink Set/Get/Do Commands weblink.logging.max_entries 1/20/15 P1071336-002 weblink.logging.max_entries Description This command specifies the maximum number of individual log entries that will be stored in the weblink.logging.entries command. ^JUF, ^JUS, ^JUN, ^JUA , and device.restore_de...
Page 67 - This command retrives a
67 WebLink Set/Get/Do Commands weblink.printer_reset_required 1/20/15 P1071336-002 weblink.printer_reset_required Description This command retrives a "yes" or "no" value indicating whether any of the weblink settings have been modified. ^JUF, ^JUS, ^JUN, ^JUA , and device.res...
Page 68 - SGD will be; This command defaults the weblink branch settings.; These all default the branch:
WebLink Set/Get/Do Commands weblink.restore_defaults 68 P1071336-002 1/20/15 weblink.restore_defaults Description This command defaults, and saves, the weblink branch settings. Any value, including an empty string, will default the weblink branch settings. ^JUF, ^JUS, ^JUN, ^JUA , and device.r...
Page 70 - Zebra Technologies Corporation; Zebra Technologies Europe Limited; Dukes Meadow; Zebra Technologies Asia Pacific, LLC
Zebra Technologies Corporation Zebra Technologies Corporation 475 Half Day Road, Suite 500 Lincolnshire, IL 60069 USA T: +1 847 634 6700 Toll-free +1 866 230 9494 F: +1 847 913 8766 Zebra Technologies Europe Limited Dukes Meadow Millboard Road Bourne End Buckinghamshire, SL8 5XF, UK ...
