Zebra Technologies P1071336-002 manuale d’uso

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.S.C.506[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 How This Document Is Organi zed . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Contents 6 P1071336-002 1/20/15 WebLink Set/Get/Do Com mands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Introduction to SGD Com mands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 weblink.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 How This Document Is Organized . . . . . . . . . [...]

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 . How This Document Is Organized The User Guide is set up as fo[...]

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. If you are vi ewing this guide on line in .pdf form at, you can click t[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 What SOTI MobiControl Connector Does . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

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. SOTI MobiControl Connector will: • Monitor printers and report issues to the SOTI system • Monitor printe r alerts • Enable administra tors to send files and operati[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Minimum System Requirements . . . . . . . [...]

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 t version of the following: • W indows Ser ver 2008 • W indows Server 2008 R2 (also known as Windows 7 Server) The PC must have direct access (no[...]

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.soti.net/servi ces/support/mobicontrol/ . 2. Log in to th e SOTI MobiControl Conso le using the us[...]

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. In S tep 1b, click Download (highl ighted in the oran[...]

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. Click Finish .[...]

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. Example • Listed below are examples of possible FQDN server names: mypasserver.com mypc.company.[...]

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. a. The MobiControl Server location is u sually going to ha ve the format of your MobiContro l Server DNS n ame followed by[...]

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 . 11 . Click Finish to close the Setup W izard.[...]

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. 2. Click Rules in the task bar o n the bottom of the scre e[...]

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. 8. Click Next on the Filter 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 . 10. Click Next .[...]

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.  (T o obtain a copy of t he ZDownloader U[...]

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. 4. Click Information in the right p ane to see more deta i led information ab[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Basic Configuration . . . . . [...]

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. The weblink.print er_reset_r equired setting will be se[...]

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 .i[...]

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. The weblink test branch was provide [...]

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. Th is does not mean that previo us loggin g messages that woul d have been logged will appear when the max_en tries  setting is changed[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 SSL/TLS Certificate 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. 4. In the left p ane of the screen, cli ck on Rest art the service . Loc[...]

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. This secti on highlights some of the most common issu e[...]

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. Check that the pr in ter ’ s date and ti[...]

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. Error Cause / Solution "Read  failed  with  an  unexpected  error&qu[...]

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. Does the printer have a valid IP address? 3. Can I ping the printer ?[...]

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. Is the proxy server configur ed correctly and does the re spective proxy server allow HTTPS connections via th e[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 weblink.enable . . . . . . . . . . . . . . . [...]

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.ip.c onn1 ) and if any of the .location values are set, then th is SGD will be set to &q[...]

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. When the printe r attempts to connect to the server (url specified in weblink.[...]

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. ip.conn1.auth entication .add"  "servernam e[  username][ [...]

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. The user name and passw ords will not be shown .The server names are separated[...]

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. T o remove an en try only the serv er name is supplied. If an inval[...]

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.enable will also be set to "on" . When this settin g is set to "off" , if the[...]

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 .ietf.org/rfc/rfc239 6.txt). The setting will not take ef fec[...]

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 . V ia the main connection (t he or igi na l co nnectio[...]

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 .ietf.or g/rfc/rfc2396.[...]

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.ip.conn2.pro xy"  "url" Va l u e s : • Any valid URL up to 2048 [...]

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.ip.conn1 .location . If an attempt is unsuccessfu l or the connection is lost, the printer will wa[...]

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. This is meant to assist use rs in debugging thei r printer's connection to remote servers wh en there are issues with the main webl i nk con[...]

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].lo cation ) conne c tion fails to connect th en the test.lo cation URL will b[...]

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. This set ting is on ly appl icable whe n the test.test_on SGD is set to "inter[...]

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. Th is assists in debugging t he printer's connect ion to remote ser ve rs when ther e are issues wit h the main weblink connection (c[...]

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].lo cation ) conne c tion fails to connect th en the test.lo cation URL will be used.[...]

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.restore _defaults do not have any af fect on th is setting. Supported [...]

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 . The weblink log is a collection of events relate d to connect ing to a remote Link-OS™ server .[...]

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. ^JUF,  ^JUS,  ^JUN,  ^J UA , and device.restore _defaults do not have any af fect [...]

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.66 0]  [conn1.1]  Clos[...]

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. ^JUF,  ^JUS,  ^JUN,  ^J UA , and device.restore _defaults do not have a[...]

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. ^JUF,  ^JUS,  ^JUN,  ^J UA , and device.restore _defaults do not have any af fe[...]

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 8766 Zebra T echnologies Europe Limited Dukes Meadow  Millboard Road  Bourne End  Buckinghamshire, SL8 5XF , UK T : +44 (0)1 62 8 55 6000 ?[...]