Difference between revisions of "Zebra Cloud Connect Setup Guide"

From 42Q
Jump to navigation Jump to search
Line 1: Line 1:
 +
 
== Prerequisites(Android): ==
 
== Prerequisites(Android): ==
  
 +
*Port 9443 must be open on the printer's network.
 +
*Install the Zebra Printer Setup Utilities app on your Android device.
 +
*Print queue must be set up by 42Q. In order for 42Q to create the print queue, 42Q must know the UUID (Serial Number) of the printer, as well as the desired print queue name.
 +
*[https://zprinters.42-q.com:9443/zebra/weblink/|https://zprinters.42-q.com:9443/zebra/weblink/] must be reachable from inside the customer's network, e.g. traffic to this address must be allowed through the customer's firewall.
 +
*A Bluetooth enabled Zebra printer
  
  
*  Port 9443 must be open on the printer's network.
+
=== Configuration: ===
*  Install the Zebra Printer Setup Utilities app on your Android device.
 
*  Print queue must be set up by 42Q. In order for 42Q to create the print queue, 42Q must know the UUID (Serial Number) of the printer, as well as the desired print queue name.
 
*  _[https://zprinters.42-q.com:9443/zebra/weblink](https://zprinters.42-q.com:9443/zebra/weblink) _must be reachable from inside the customer's network, e.g. traffic to this address must be allowed through the customer's firewall.
 
*  A Bluetooth enabled Zebra printer
 
 
 
**Configuration:**
 
 
 
  
  
1. Ensure Bluetooth is Open the Zebra Printer Setup Utilities app on the Android Device.  
+
1. Ensure Bluetooth is Open the Zebra Printer Setup Utilities app on the Android Device. 1. Select the printer from the list of nearby printers. 1. Select Connectivity Settings 1. Select Wireless and follow the steps to connect to the wireless network. 1. Select Available Files, then navigate to the configuration file on your Android device. 1. Select the file. The file will be sent to the printer.
1. Select the printer from the list of nearby printers.
 
1. Select Connectivity Settings
 
1. Select Wireless and follow the steps to connect to the wireless network.
 
1. Select Available Files, then navigate to the configuration file on your Android device.
 
1. Select the file. The file will be sent to the printer.
 
  
 
If successful, the printer should reboot and reconnect to the correct weblink address.
 
If successful, the printer should reboot and reconnect to the correct weblink address.
  
 +
 
  
 
== Prerequisites (Windows): ==
 
== Prerequisites (Windows): ==
  
 +
*Zebra Setup Utilities must be installed on a local computer( Windows) and the printer must have an established communication method for Zebra Setup Utilities, e.g. USB, Bluetooth, etc. For more information and using/downloading the Zebra Setup Utilities application, see the following link.
  
 +
    *  [https://www.zebra.com/us/en/products/software/barcode-printers/zebralink/zebra-setup-utility.html|https://www.zebra.com/us/en/products/software/barcode-printers/zebralink/zebra-setup-utility.html]
  
*  Zebra Setup Utilities must be installed on a local computer( Windows) and the printer must have an established communication method for Zebra Setup Utilities, e.g. USB, Bluetooth, etc. For more information and using/downloading the Zebra Setup Utilities application, see the following link.
 
    *  [https://www.zebra.com/us/en/products/software/barcode-printers/zebralink/zebra-setup-utility.html](https://www.zebra.com/us/en/products/software/barcode-printers/zebralink/zebra-setup-utility.html)
 
 
         1.  For information on how to configure communication with the printer, see the Software Tutorials section on the above web page.
 
         1.  For information on how to configure communication with the printer, see the Software Tutorials section on the above web page.
*  Print queue must be set up by 42Q. In order for 42Q to create the print queue, 42Q must know the UUID (Serial Number) of the printer, as well as the desired print queue name.
 
*  _[https://zprinters.42-q.com:9443/zebra/weblink](https://zprinters.42-q.com:9443/zebra/weblink) _must be reachable from inside the customer's network, e.g. traffic to this address must be allowed through the customer's firewall.
 
  
 +
*Print queue must be set up by 42Q. In order for 42Q to create the print queue, 42Q must know the UUID (Serial Number) of the printer, as well as the desired print queue name.
 +
*_[https://zprinters.42-q.com:9443/zebra/weblink [3]]([https://zprinters.42-q.com:9443/zebra/weblink https://zprinters.42-q.com:9443/zebra/weblink]) _must be reachable from inside the customer's network, e.g. traffic to this address must be allowed through the customer's firewall.
 +
 +
 
  
 
=== Configuration ===
 
=== Configuration ===
  
 +
1. Open Zebra Setup Utilities. 1. Select the desired printer. 1. Select Open Communication with Printer. If connection with the printer is open, the command editor will allow you to Send to the Printer. Depending on the printer configuration, commands can be sent by ZPL, CPCL, or Set Do Go (SDG) commands. 1. Send the following Set Do Go commands:
  
 
+
_! U1 setvar "weblink.ip.conn1.location" "[https://zprinters.42-q.com:9443/zebra/weblink/ https://zprinters.42-q.com:9443/zebra/weblink/]"_
1.  Open Zebra Setup Utilities.
 
1.  Select the desired printer.
 
1.  Select Open Communication with Printer. If connection with the printer is open, the command editor will allow you to Send to the Printer. Depending on the printer configuration, commands can be sent by ZPL, CPCL, or Set Do Go (SDG) commands.
 
1.  Send the following Set Do Go commands:
 
 
 
_! U1 setvar "weblink.ip.conn1.location" "https://zprinters.42-q.com:9443/zebra/weblink/" _
 
  
 
_! U1 setvar "weblink.enable" "on" _
 
_! U1 setvar "weblink.enable" "on" _
  
_! U1 setvar "device.unique_id" "**UUID of your printer**" _
+
_! U1 setvar "device.unique_id" "**UUID of your printer**" _
  
 
_! U1 setvar "device.languages" "hybrid_xml_zpl" _
 
_! U1 setvar "device.languages" "hybrid_xml_zpl" _
Line 55: Line 47:
 
If there are specific network needs, additional variable may be set.
 
If there are specific network needs, additional variable may be set.
  
For example, the followings commands demonstrate the settings needed for connection using the specified DNS servers: (_replace "8.8.8.8" and "domain_name.com" with the appropriate values for your network_)
+
For example, the followings commands demonstrate the settings needed for connection using the specified DNS servers: (_replace "8.8.8.8" and "domain_name.com" with the appropriate values for your network_)
  
 +
 
  
 
     _! U1 setvar "weblink.logging.max_entries" "50" _
 
     _! U1 setvar "weblink.logging.max_entries" "50" _
  
 +
 
  
 
     _! U1 setvar "ip.dhcp.enable" "on" _
 
     _! U1 setvar "ip.dhcp.enable" "on" _
  
 +
 
  
 
     _! U1 setvar "internal_wired.ip.protocol" "dhcp" _
 
     _! U1 setvar "internal_wired.ip.protocol" "dhcp" _
  
 +
 
  
 
     _! U1 setvar "internal_wired.ip.dns.servers" "8.8.8.8"_
 
     _! U1 setvar "internal_wired.ip.dns.servers" "8.8.8.8"_
  
 +
 
  
 
     _! U1 setvar "internal_wired.ip.dns.domain" "domain_name.com" _
 
     _! U1 setvar "internal_wired.ip.dns.domain" "domain_name.com" _
  
 +
 
  
     _! U1 setvar "weblink.ip.conn1.location" "https://zprinters.42-q.com:9443/zebra/weblink/" _
+
     _! U1 setvar "weblink.ip.conn1.location" "[https://zprinters.42-q.com:9443/zebra/weblink/ https://zprinters.42-q.com:9443/zebra/weblink/]" _
  
 +
 
  
 
     _! U1 setvar "device.reset" ""_
 
     _! U1 setvar "device.reset" ""_
  
 +
 
  
 
         **<span style="text-decoration:underline;">NOTE</span>: **The UUID is the SN of the printer.  
 
         **<span style="text-decoration:underline;">NOTE</span>: **The UUID is the SN of the printer.  
  
 +
&nbsp;
  
         **<span style="text-decoration:underline;">NOTE</span>: **There are many additional variables/commands than can be set/checked depending on a specific need or configuration. Please see, [Zebra Programming Guide](https://support.zebra.com/cpws/docs/zpl/zpl_manual.pdf) for a list of commands and their descriptions.
+
         **<span style="text-decoration:underline;">NOTE</span>: **There are many additional variables/commands than can be set/checked depending on a specific need or configuration. Please see, [Zebra Programming Guide]([https://support.zebra.com/cpws/docs/zpl/zpl_manual.pdf https://support.zebra.com/cpws/docs/zpl/zpl_manual.pdf]) for a list of commands and their descriptions.
  
If the commands were executed successfully, the printer will restart and automatically connect to the Zebra Web Service.  
+
If the commands were executed successfully, the printer will restart and automatically connect to the Zebra Web Service.
  
 +
&nbsp;
  
## Check Zebra Web Socket Configurations
+
#
 +
##Check Zebra Web Socket Configurations  
  
 +
&nbsp;
  
 
     _! U1 getvar "ip.dhcp.enable" _
 
     _! U1 getvar "ip.dhcp.enable" _
  
 +
&nbsp;
  
 
     _! U1 getvar "internal_wired.ip.protocol" _
 
     _! U1 getvar "internal_wired.ip.protocol" _
  
 +
&nbsp;
  
 
     _! U1 getvar "internal_wired.ip.dns.servers" _
 
     _! U1 getvar "internal_wired.ip.dns.servers" _
  
 +
&nbsp;
  
 
     _! U1 getvar "internal_wired.ip.dns.domain" _
 
     _! U1 getvar "internal_wired.ip.dns.domain" _
  
 +
&nbsp;
  
 
     _! U1 getvar "weblink.ip.conn1.location" _
 
     _! U1 getvar "weblink.ip.conn1.location" _
  
 +
&nbsp;
  
## Check the Network Connection
+
#
 
+
##Check the Network Connection  
To determine whether _[https://zprinters.42-q.com:9443/zebra/weblink](https://zprinters.42-q.com:9443/zebra/weblink) _is reachable from inside your network, execute the following tests.
 
 
 
  
 +
To determine whether _[https://zprinters.42-q.com:9443/zebra/weblink [4]]([https://zprinters.42-q.com:9443/zebra/weblink https://zprinters.42-q.com:9443/zebra/weblink]) _is reachable from inside your network, execute the following tests.
  
1.  **) Make sure that [zprinters.42-q.com](http://zprinters.42-q.com/) can be resolved.**
+
&nbsp;
  
From a linux terminal or windows command screen run the command :
+
1. **) Make sure that [zprinters.42-q.com]([http://zprinters.42-q.com/ http://zprinters.42-q.com/]) can be resolved.**
  
    _nslookup [zprinters.42-q.com](http://zprinters.42-q.com/)_
+
From a linux terminal or windows command screen run the command&nbsp;:
  
If executed successfully, you should see external output like the following example :
+
    _nslookup [zprinters.42-q.com]([http://zprinters.42-q.com/)_ http://zprinters.42-q.com/)_]
  
_      Server: 127.0.1.1_
+
If executed successfully, you should see external output like the following example&nbsp;:
  
_     Address: 127.0.1.1#53_
+
_ Server: 127.0.1.1_
  
_         [zprinters.42-q.com](http://zprinters.42-q.com/) canonical name = [42qmes1.42-q.com](http://42qmes1.42-q.com/)._
+
_ Address: 127.0.1.1#53_
  
_   Name:   [42qmes1.42-q.com](http://42qmes1.42-q.com/)_
+
_ [zprinters.42-q.com]([http://zprinters.42-q.com/ http://zprinters.42-q.com/]) canonical name = [42qmes1.42-q.com]([http://42qmes1.42-q.com/)._ http://42qmes1.42-q.com/)._]
  
_     Address: 52.22.186.27_
+
_ Name: [42qmes1.42-q.com]([http://42qmes1.42-q.com/)_ http://42qmes1.42-q.com/)_]
  
If this output is not seen, your DNS settings must be changed to resolve this host.
+
_ Address: 52.22.186.27_
  
 +
If this output is not seen, your DNS settings must be changed to resolve this host.
  
 +
&nbsp;
  
1. **) Check the egress access of your network.**
+
1. **) Check the egress access of your network.**
  
If a telnet utility is available then run the command :
+
If a telnet utility is available then run the command&nbsp;:
  
     _telnet [zprinters.42-q.com](http://zprinters.42-q.com/) 9443_
+
     _telnet [zprinters.42-q.com]([http://zprinters.42-q.com/ http://zprinters.42-q.com/]) 9443_
  
You should see a successful connection like the following example:
+
You should see a successful connection like the following example:
  
_       Trying 52.22.186.27..._
+
_ Trying 52.22.186.27..._
  
_       Connected to [42qmes1.42-q.com](http://42qmes1.42-q.com/)_
+
_ Connected to [42qmes1.42-q.com]([http://42qmes1.42-q.com/)_ http://42qmes1.42-q.com/)_]
  
_   Escape character is '^]'._
+
_ Escape character is '^]'._
  
_   Type "ctrl-]" and then "q" to exit_
+
_ Type "ctrl-]" and then "q" to exit_
  
 
   If telnet is not found on a windows system it can be made available with instructions from the
 
   If telnet is not found on a windows system it can be made available with instructions from the
Line 153: Line 163:
 
   following sites:
 
   following sites:
  
     [https://social.technet.microsoft.com/wiki/contents/articles/38433.windows-10-enabling-telnet-client.aspx](https://social.technet.microsoft.com/wiki/contents/articles/38433.windows-10-enabling-telnet-client.aspx)
+
     [https://social.technet.microsoft.com/wiki/contents/articles/38433.windows-10-enabling-telnet-client.aspx [5]]([https://social.technet.microsoft.com/wiki/contents/articles/38433.windows-10-enabling-telnet-client.aspx https://social.technet.microsoft.com/wiki/contents/articles/38433.windows-10-enabling-telnet-client.aspx])
  
 
               -or-
 
               -or-
  
     [https://www.wikihow.com/Activate-Telnet-in-Windows-7](https://www.wikihow.com/Activate-Telnet-in-Windows-7)
+
     [https://www.wikihow.com/Activate-Telnet-in-Windows-7 [6]]([https://www.wikihow.com/Activate-Telnet-in-Windows-7 https://www.wikihow.com/Activate-Telnet-in-Windows-7])
  
If external access cannot be achieved, the customer may need to modify their firewall configuration for egress access to the server.
+
If external access cannot be achieved, the customer may need to modify their firewall configuration for egress access to the server.

Revision as of 14:20, 15 November 2018

Prerequisites(Android):

  • Port 9443 must be open on the printer's network.
  • Install the Zebra Printer Setup Utilities app on your Android device.
  • Print queue must be set up by 42Q. In order for 42Q to create the print queue, 42Q must know the UUID (Serial Number) of the printer, as well as the desired print queue name.
  • [1] must be reachable from inside the customer's network, e.g. traffic to this address must be allowed through the customer's firewall.
  • A Bluetooth enabled Zebra printer


Configuration:

1. Ensure Bluetooth is Open the Zebra Printer Setup Utilities app on the Android Device. 1. Select the printer from the list of nearby printers. 1. Select Connectivity Settings 1. Select Wireless and follow the steps to connect to the wireless network. 1. Select Available Files, then navigate to the configuration file on your Android device. 1. Select the file. The file will be sent to the printer.

If successful, the printer should reboot and reconnect to the correct weblink address.

 

Prerequisites (Windows):

  • Zebra Setup Utilities must be installed on a local computer( Windows) and the printer must have an established communication method for Zebra Setup Utilities, e.g. USB, Bluetooth, etc. For more information and using/downloading the Zebra Setup Utilities application, see the following link.
   *   [2]
       1.  For information on how to configure communication with the printer, see the Software Tutorials section on the above web page.
  • Print queue must be set up by 42Q. In order for 42Q to create the print queue, 42Q must know the UUID (Serial Number) of the printer, as well as the desired print queue name.
  • _[3](https://zprinters.42-q.com:9443/zebra/weblink) _must be reachable from inside the customer's network, e.g. traffic to this address must be allowed through the customer's firewall.

 

Configuration

1. Open Zebra Setup Utilities. 1. Select the desired printer. 1. Select Open Communication with Printer. If connection with the printer is open, the command editor will allow you to Send to the Printer. Depending on the printer configuration, commands can be sent by ZPL, CPCL, or Set Do Go (SDG) commands. 1. Send the following Set Do Go commands:

_! U1 setvar "weblink.ip.conn1.location" "https://zprinters.42-q.com:9443/zebra/weblink/"_

_! U1 setvar "weblink.enable" "on" _

_! U1 setvar "device.unique_id" "**UUID of your printer**" _

_! U1 setvar "device.languages" "hybrid_xml_zpl" _

_! U1 setvar "device.reset" ""_

If there are specific network needs, additional variable may be set.

For example, the followings commands demonstrate the settings needed for connection using the specified DNS servers: (_replace "8.8.8.8" and "domain_name.com" with the appropriate values for your network_)

 

   _! U1 setvar "weblink.logging.max_entries" "50" _

 

   _! U1 setvar "ip.dhcp.enable" "on" _

 

   _! U1 setvar "internal_wired.ip.protocol" "dhcp" _

 

   _! U1 setvar "internal_wired.ip.dns.servers" "8.8.8.8"_

 

   _! U1 setvar "internal_wired.ip.dns.domain" "domain_name.com" _

 

   _! U1 setvar "weblink.ip.conn1.location" "https://zprinters.42-q.com:9443/zebra/weblink/" _

 

   _! U1 setvar "device.reset" ""_

 

       **NOTE: **The UUID is the SN of the printer. 

 

       **NOTE: **There are many additional variables/commands than can be set/checked depending on a specific need or configuration. Please see, [Zebra Programming Guide](https://support.zebra.com/cpws/docs/zpl/zpl_manual.pdf) for a list of commands and their descriptions.

If the commands were executed successfully, the printer will restart and automatically connect to the Zebra Web Service.

 

    1. Check Zebra Web Socket Configurations

 

   _! U1 getvar "ip.dhcp.enable" _

 

   _! U1 getvar "internal_wired.ip.protocol" _

 

   _! U1 getvar "internal_wired.ip.dns.servers" _

 

   _! U1 getvar "internal_wired.ip.dns.domain" _

 

   _! U1 getvar "weblink.ip.conn1.location" _

 

    1. Check the Network Connection

To determine whether _[4](https://zprinters.42-q.com:9443/zebra/weblink) _is reachable from inside your network, execute the following tests.

 

1. **) Make sure that [zprinters.42-q.com](http://zprinters.42-q.com/) can be resolved.**

From a linux terminal or windows command screen run the command :

   	_nslookup [zprinters.42-q.com](http://zprinters.42-q.com/)_

If executed successfully, you should see external output like the following example :

_ Server: 127.0.1.1_

_ Address: 127.0.1.1#53_

_ [zprinters.42-q.com](http://zprinters.42-q.com/) canonical name = [42qmes1.42-q.com](http://42qmes1.42-q.com/)._

_ Name: [42qmes1.42-q.com](http://42qmes1.42-q.com/)_

_ Address: 52.22.186.27_

If this output is not seen, your DNS settings must be changed to resolve this host.

 

1. **) Check the egress access of your network.**

If a telnet utility is available then run the command :

   	_telnet [zprinters.42-q.com](http://zprinters.42-q.com/) 9443_

You should see a successful connection like the following example:

_ Trying 52.22.186.27..._

_ Connected to [42qmes1.42-q.com](http://42qmes1.42-q.com/)_

_ Escape character is '^]'._

_ Type "ctrl-]" and then "q" to exit_

  If telnet is not found on a windows system it can be made available with instructions from the
  	following sites:
   [5](https://social.technet.microsoft.com/wiki/contents/articles/38433.windows-10-enabling-telnet-client.aspx)
             	-or-
   [6](https://www.wikihow.com/Activate-Telnet-in-Windows-7)

If external access cannot be achieved, the customer may need to modify their firewall configuration for egress access to the server.