Configuring Printers with WebLink
Configuring Weblink
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 the max_entries setting is changed from zero (0) to a greater value. It means that any new logging messages will be logged from that point forward.
Issue the following command to clear any log entries currently in the weblink.logging.entries buffer.
! U1 do "weblink.logging.clear" ""
Navigating the Log Output
The log will contain useful information, even in the scenario where the printer successfully connects to the remote server. This section explains how to read the log and highlights some of the key entries that will help to determine if the connection was successful.
A typical log entry looks as follows:
[12‐04‐2012 14:57:10.625] [conn1.1] Attempting connection to https://www.examplecorpinc.com/zebra/weblink/
The first column is the date and time that the event occurred. The format of the date and time matches the format of rtc.date and rtc.time. The time, however, also includes the milliseconds to aid in troubleshooting network latency concerns.
Note • For printers that do not have a battery to store the Real Time Clock (RTC) value, the date will be restored to the default value upon a power cycle. The default value depends upon how the rtc.date Set/Get/Do (SGD) is managed. If it has never been set, then it will default to the firmware build date (the value in appl.date). Otherwise, the value in rtc.date will default to the value that it was last set to. This does not mean the value of the rtc.date when it was power cycled – it means that when a user sets rtc.date, that value becomes the new default value. If the printer has a battery, then the rtc.date never defaults and continues to track the date as expected.
The second column indicates the connection name and channel that the entries are associated with. The connection name will match the weblink branch that was configured with the respective URL (for example, conn1 or conn2). The channel number indicates which channel on the respective connection that the entries corresponds to.
Note • Channels are additional connections that are requested by the server when the server needs to perform a specific operation that cannot be done on the channel(s) currently open. Typically only the RAW channel is open, which operates similar to the RAW TCP port. It is typical to see two channels
The third column is the actual message, which contains information about what occurred in the printer at the corresponding time in column one. In the above example, the printer was initiating the connection to the URL specified in weblink.ip.conn1.location.
Review the section titled SSL/TLS Certificate Errors on page 39 to understand what it means when certain logging messages/errors appear in the log.
35
1/20/15 |