Instruction/ maintenance manual of the product P1071336-002 Zebra Technologies
Go to page of 70
P1071336-002 SOTI ® MobiControl ™ Connector ™ User Guide.
© 2015 ZIH Corp. The copyrights in this manual and th e software and/or firmware in the print engine described therein are owned by ZIH Corp. and Zebra’ s licensors. Unaut horized reproduction of this manual or th e software and/or firmware in the print engine may result in impris onment of up to one year and fines of up to $10,000 (17 U.
3 1/20/15 P1071336-002 Ap ache T omcat Copyright © 1999-2014, The Ap ache Software Foundation Sun, Sun Microsystems, Sola ris, Java and JavaServer Pages are trademarks or registere d trademar ks of Oracle Corporation. UNIX is a registered trademark in the United St ates and other countri es, exclusively licensed through 'The Open Group'.
4 P1071336-002 1/20/15 Notes • ___________ ______________ _______________ ________________ ___________ ___________ ______________ ________________ _______________ ______________ ____ _______.
1/20/15 P1071336-002 Contents About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 6 P1071336-002 1/20/15 WebLink Set/Get/Do Com mands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Introduction to SGD Com mands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1/20/15 P1071336-002 About This Document This section provides yo u wit h cont act information, document structure and or ganization, an d additional re ference documents. Content s Who Should Use This Document . . . . . . . . . . . . . . . . . . . . .
About This Document Who Shoul d Us e 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 in stall, perform routine maintenance, upgrade, or troublesho ot problems with the SOTI Mo bi Control Connector software .
9 About This Document Document Conventions 1/20/15 P1071336-002 Document Conventions The following co nventions are used throughout this do cument to convey certain information. Alternate Color (online only) C ross-references cont ain hot links to othe r sections in this guide.
About This Document Document Conventions 10 P1071336-002 1/20/15 Notes • ___________ ______________ _______________ ________________ ___________ ___________ ______________ ________________ _____.
1/20/15 P1071336-002 Introduction This section provides general i nformation about the SOTI Mo bi Control Connector. Content s Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Introduction Overview 12 P1071336-002 1/20/15 Overview The Zebra SOTI MobiCo ntrol Connector partners with the SOTI MobiContr ol server to manage your Zebra Link-OS ™ printers.
1/20/15 P1071336-002 Installation This section outl ines the system requirements fo r installation and provid es specific details for the installati on of SOTI MobiContro l Connector. Content s Installing in a Windows Operating System . . . . . . . . .
Inst allation Installing in a Windows Operating System 14 P1071336-002 1/20/15 Inst alling in a Windows Operating System Minimum System Requirement s The SOTI MobiControl Co nnector supports the 64-bi.
15 Installation Installation S teps 1/20/15 P1071336-002 Inst allation S tep s S tep 1: Inst all a MobiControl Server 1. Contact SOTI. a. Contact SOTI Customer Support to obtain an M obiControl version 12.0 or later installation. b. V isit https://www.
Inst allation Installation S teps 16 P1071336-002 1/20/15 6. Enter a name for the Printe r Admini stration Server (P AS) Profile, and then click Create .
17 Installation Installation S teps 1/20/15 P1071336-002 7. In S tep 1a, click Download (highlighted in the red box belo w) to start gen erating th e MobiControl Roo t Certificate. 8. When prompted, selec t Save As to save the certific ate to the following directory: My Documentszebra_certs 9.
Inst allation Installation S teps 18 P1071336-002 1/20/15 10. Create a password to proceed with the download process. Be sure to note the passw ord for future reference. 11 . Click Download . 12. Download th e P AS Cl ient Certifi cate and sa ve it in the fo ll owing direc tory: My Documentszebra_certs 13.
19 Installation Installation S teps 1/20/15 P1071336-002 S tep 2: Inst all Sof tware 1. Download SOTI MobiControl C onnector software. 2. Run install.exe .
Inst allation Installation S teps 20 P1071336-002 1/20/15 3. Click Next . 4. Click I Agree to accept the terms of the License Agreement..
21 Installation Installation S teps 1/20/15 P1071336-002 5. Fill in all of th e open fields in t his form. a. The Server Name (FQDN) is the domain name of th e comput er wh ere the software is being installed . b. Click Next after completing the form.
Inst allation Installation S teps 22 P1071336-002 1/20/15 6. Fill in all of th e open fields in t his form. The MobiControl Server Location is the Deployment Server En d Point to which SOT I MobiControl Connector is connecte d.
23 Installation Installation S teps 1/20/15 P1071336-002 7. Click Next . 8. Choose the l ocation where you wish t o install the SOTI Mobi Control Connector softwa re. 9. Click Inst all to proceed. 10. W ait for the instal lation process to compl ete, and then click Next .
Inst allation Installation S teps 24 P1071336-002 1/20/15 S tep 3: T est a Printer Enable Printer Discovery In this section, you must c reate a “rule ” in the SOTI M obiControl Console i n order to disc over your print ers. 1. Click on the Pri nter tab on the SOTI Mobi Control Console.
25 Installation Installation S teps 1/20/15 P1071336-002 4. Enter the name of the rule. Import ant • A best p ractice is to create a d efault rule to enroll devices automatically . For example, you might choose “D iscover Printers” or “Auto Enroll” as the rule name.
Inst allation Installation S teps 26 P1071336-002 1/20/15 5. Select the top level Devi ce Group. 6. Click Next . 7. Click Next on the Blackl ist/Whitelist dialog box.
27 Installation Installation S teps 1/20/15 P1071336-002 9. T o change the device name to show th e serial number of the printe r , click on th e gear icon and select Device Serial Number .
Inst allation Installation S teps 28 P1071336-002 1/20/15 11 . Review the Create Add De vices Rule information, and click Finish ..
29 Installation Installation S teps 1/20/15 P1071336-002 S tep 4: Set Up Printers 1. Set up your printers t o communicate with SOTI: a. Download th e l atest operatin g system for your pr inters from http://www .zebra.com . b. Using the ZDownloader Uti lity , install the firmware on y our Zebra printers.
Inst allation Installation S teps 30 P1071336-002 1/20/15 Discover Y our Printers 1. Click the Printer tab and Devices in th e taskbar (at the bottom of the screen). 2. Select the top level Device Group in the left pane. 3. Select one of the printe rs in th e center pane.
1/20/15 P1071336-002 Configuring Printers with WebLink This section describ es basic, network, and firewa ll configurations for prin ters connected to SOTI MobiControl Conn ect or. Content s Configuring Weblink . . . . . . . . . . . . . . . . . . . . .
Configuring Printers with WebLink Configuring Weblink 32 P1071336-002 1/20/15 Configuring W eblink When any W ebLink setting (with the exception of th e logging settings) is ad justed either via SNMP , SGD, or JSON it is required that the p r inter be reset befor e the new val ue takes effect.
33 Configuring Printers with WebLi nk Configuring Weblink 1/20/15 P1071336-002 • The proxy se rver port (optional ) • The username and password for the proxy (optional) T o supply the address of the pr oxy server (assuming a default port and no username/p assword), configure the proxy setting as follows: ! U1 setvar "weblink .
Configuring Printers with WebLink Configuring Weblink 34 P1071336-002 1/20/15 Additional Firewall Configuration Some firewalls d o no t allow the f ir st connection at tempt for a devi ce to be HTTPS, or they require newc on ne ctions to be made p erio dic all y in order to ke ep the initial connectio ns intact.
35 Configuring Printers with WebLi nk Configuring Weblink 1/20/15 P1071336-002 The logging set tings are atypi cal to the W eblink settings a s they do not require the prin ter to be reset before taking ef fect.
Configuring Printers with WebLink Configuring Weblink 36 P1071336-002 1/20/15 Notes • __________ _____________ ________________ ________________ _____________ ___________ ______________ ________.
1/20/15 P1071336-002 Troubleshooting This section provid es troubleshooting i nformation about the SOTI Mo biControl Connector. Content s Installation Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
T roubleshooting Installation Errors 38 P1071336-002 1/20/15 Inst allation Errors Rest arting the SOTI MobiControl Connector 1. Navigate to the Control Panel > Administrative T ools. 2. Sta r t t h e Services application. 3. Click on the SO TI MobiControl Connector service.
39 T rou bleshooting SSL/TLS Certif icate Errors 1/20/15 P1071336-002 SSL/TLS Certificate Errors Secure connections to the remote server pres ent the opportunit y for several errors when attempting to connect. The errors typically invo lve the certificates us ed when connecting via SSL or TLS.
T roubleshooting SSL/TLS Certificate Errors 40 P1071336-002 1/20/15 "SSL certificate problem : certificate is not yet va lid" This error indicat es that the remote server’ s certificate was incorrectly issued or that the pri nter ’ s date and/or time are incorrect.
41 T rou bleshooting Other T ypical Errors 1/20/15 P1071336-002 Other T ypical Errors While SSL/TLS connection errors are the most co mmon, ther e a re issues that can arise that prevent a successfu l connection. This sectio n highlights the most common issues.
T roubleshooting T roubleshooti ng 42 P1071336-002 1/20/15 T roubleshooting Whenever trou bleshooting a co nnection issue, th e following qu estions should be answ er ed to ensure the configuration is corre ct. 1. Is the printer connec ted correctly via W ireless or Ethernet? 2.
43 T rou bleshooting HTTP Messages 1/20/15 P1071336-002 17. Does the value in weblink.ip.co nn1.locati on match either the Common Name or one of the names listed in the Subject Alternate Name o f the remote server ’ s certific ate? 18.
T roubleshooting HTTP Messages 44 P1071336-002 1/20/15 Notes • __________ _____________ ________________ ________________ _____________ ___________ ______________ ________________ ______________.
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. Content s Introduction to SGD Commands . . . . . . . . . . . . . . . . . .
WebLink Set/Get/Do Commands Introduction to SGD Commands 46 P1071336-002 1/20/15 Introduction to SGD Commands For more specific informatio n about SGD syntax an d st ructure, see the Zebra Prog ramming Guide section on Set/Get/Do Command S tructure. T o send SGD commands to a printer , use the Zebra Setup Utilit ies .
47 WebL i nk Se t/ Ge t/Do Commands weblink.enable 1/20/15 P1071336-002 weblink.enable Description This comma nd indicates if one or more of the weblink connections are active. If there is more than one connection under t he weblink branch (for example, weblink.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2] .a uthentication.add 48 P1071336-002 1/20/15 weblink.ip.conn[1|2].authentication.add Description This command allows th e user to ad d a single server /us ername/password triplet in to the lis t of authen tication entries.
49 WebL i nk Se t/ Ge t/Do Commands weblink.ip.conn[1|2].authentication .add 1/20/15 P1071336-002 Commands Details setvar This command adds a single server/u sername/password tripl et to the list of authent ication entries. Format: • ! U1 setv ar "weblink.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].a uthentication.entries 50 P1071336-002 1/20/15 weblink.ip.conn[1|2].authentication.entries Description This command lists the server names ad ded to the authentica tion entrie s list. Only the server nam es will be shown.
51 WebL i nk Se t/ Ge t/Do Commands weblink.ip.conn[1|2] .a uthentication.remove 1/20/15 P1071336-002 weblink.ip.conn[1|2].authentication.remove Description This command allows th e user to remo ve a single server /username/password triplet from the li st of authentication entries.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].enabl e 52 P1071336-002 1/20/15 weblink.ip.conn[1|2].enable Description This comma nd enables or disables the weblink IP conn ection #1. A side ef fect of setting this SGD t o "on", the weblink.
53 SGD Wireless Commands weblink.ip.conn[1|2].location 1/20/15 P1071336-002 weblink.ip.conn[1|2].location Description This comma nd assigns the URL of the server for this connection. The URL must follow the URL ru les for the HTTP[S] protoco l outlined in RFC2396 (http://www .
SGD Wireless Commands weblink.ip.conn[1|2].maxim u m_ s imultaneous_ conn ections 54 P1071336-002 1/20/15 weblink.ip.conn[1|2].maximum_simultaneous_ connections Description This comma nd indicates the maximum nu mber of simultaneous connections that can be i nitiated by the printe r .
55 WebL i nk Se t/ Ge t/Do Commands weblink.ip.conn[1|2].proxy 1/20/15 P1071336-002 weblink.ip.conn[1|2].proxy Description This comma nd assigns the URL of the proxy for the connection. The proxy server protocol, port, do main, username, and password are all encoded into the URL via the format outlined in RFC2396 (http://www .
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].pro xy 56 P1071336-002 1/20/15 do This command assig ns the URL of the connectio n proxy . Format: • ! U1 do "weblink.ip.conn1.pro xy" "url" • ! U1 do "weblink.
57 WebL i nk Se t/ Ge t/Do Commands weblink.ip.conn[1| 2].retry_interval 1/20/15 P1071336-002 weblink.ip.conn[1|2].retry_interval Description This comma nd sets the number of second s between at tempts to connect to the server URL provided in web link.
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 co mmand holds the URL for te sting a connection to the internet.
59 WebL i nk Se t/ Ge t/Do Commands weblink.ip.conn[1|2 ].test.location 1/20/15 P1071336-002 Example • The test connection can assist the user in several ways/scen arios: 1. If the test.test_on value is set to "failure" , any time the main web link ( conn[1|2].
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].test.retry_i nterval 60 P1071336-002 1/20/15 weblink.ip.conn[1|2].test.retry_interval Description This command determines how often, in seconds, a connectio n t o th e test.location URL sh ould b e attempte d.
61 WebL i nk Se t/ Ge t/Do Commands weblink.ip.conn[1|2].test.te st_on 1/20/15 P1071336-002 weblink.ip.conn[1|2].test.test_on Description This comman d determines wh en the test connecti on should b e attempted.
WebLink Set/Get/Do Commands weblink.ip.conn[1|2].test.test_on 62 P1071336-002 1/20/15 Example • The test connection can assist th e user is several ways/scenarios: 1. If the test.test_on value is set to "failure" , any time the main web link ( conn[1|2].
63 WebL i nk Se t/ Ge t/Do Commands weblink.logging.clear 1/20/15 P1071336-002 weblink.logging.clear Description Thi s co mmand c lears the weblink lo g. Setting this value to an y thing will clear it, including an empt y string . ^JUF, ^JUS, ^JUN, ^J UA , and device.
WebLink Set/Get/Do Commands weblink.logging.entries 64 P1071336-002 1/20/15 weblink.logging.entries Description This co mmand returns the N number of entries in the weblink log, where N has a maximum value that is set by webl ink.logging.m ax_entries .
65 WebL i nk Se t/ Ge t/Do Commands weblink.logging.max_entries 1/20/15 P1071336-002 weblink.logging.max_entries Description This command specifies t he maximum numb er of individua l l og entries th at will be stored in the weblink.logging. entries command.
WebLink Set/Get/Do Commands weblink.logging.max_ entries 66 P1071336-002 1/20/15 Example 1 • In this example, weblink.logging.m ax_entries is set to 3: [01 ‐ 04 ‐ 2013 08:40:45.65 9] [conn1.1] Recei ved HTTP code 404 from proxy afte r CONNECT [01 ‐ 04 ‐ 2013 08:40:45.
67 WebL i nk Se t/ Ge t/Do Commands weblink.printer_reset_requi red 1/20/15 P1071336-002 weblink.printer_reset_required Description This comma nd retrives a "yes" or "no" value indicating w hether any of th e weblink settings have been modified.
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 bran ch sett ings. Any value, including a n empty string, will d efault the weblink bran ch settings.
69 1/20/15 P1071336-002.
Zebra T echnologies Corporation Zebra Technolo gies Corporation 475 Half Day Road, Suite 500 Lincolnshire, IL 6006 9 USA T: +1 847 63 4 6700 Toll-free +1 866 230 9494 F: +1 847 913.
An important point after buying a device Zebra Technologies P1071336-002 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Zebra Technologies P1071336-002 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Zebra Technologies P1071336-002 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Zebra Technologies P1071336-002 you will learn all the available features of the product, as well as information on its operation. The information that you get Zebra Technologies P1071336-002 will certainly help you make a decision on the purchase.
If you already are a holder of Zebra Technologies P1071336-002, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Zebra Technologies P1071336-002.
However, one of the most important roles played by the user manual is to help in solving problems with Zebra Technologies P1071336-002. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Zebra Technologies P1071336-002 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
