Client-side Connections

Configuring Connections to the Web Listener (i-push)

 

Note: The following steps detail your connection and configuring Printers on the Listener (Client) Side.

1.  Press Start | Programs | Loftware Labeling | Print Server | Internet Clients |  
Web Listener – Interactive
and press Start to login.

If you are starting the Web Listener for the first time, the following is displayed:

Figure 3-V: General Configuration Dialog Box

2.  Enter a URL, such as http://152.22.0.58/ or http://www.yourcompany.com/ (Port default=80).  If your servlet engine is configured to use a port other than 80, enter that number.

Important Note: The URL is the LPS Web Server address!

3.  Enter a valid User Name from the LPS Users list.

4.  Press the Password button and type the LPS User’s Password, then re-type it in the space below to confirm; click OK.

5.  Press the Proxy Info button ONLY if you are connecting through a Proxy Server.

If you are NOT connecting through a Proxy Server, go to Step 6.

What is a Proxy? 

A Proxy is a way to connect to the Internet in a secure fashion.  A Proxy is similar to a firewall, and in Loftware’s case, all clients going through the proxy share this extra security measure.  It is generally placed between a client application and the Internet.  Proxy servers are able to improve performance for groups of users, as it saves (caches) the results of all requests for a certain amount of time, therefore recalling the information is a much faster operation.  Proxy servers can also be used to filter requests, for example, a proxy server could be used to prevent employees from accessing specific Web sites.

The following is displayed:

Figure 3-W: Proxy Information

a.   Click in the check box to enable the use of a Proxy Server to connect.

b.   Enter Proxy Server IP Address and Port.

c.   Click OK.

You are returned to the General Configuration dialog box.

6.  Press the Security Info button.

The Web Security Configuration Utility is displayed:

 

Figure 3-X: Web Security Configuration

Sections of the Web Security Configuration Utility

Allow Untrusted Certificates – This gives the option of accepting certificates that are not on the system’s “trusted source” list.  When the Web Listener is running as a service, the security alert message that informs you that the site’s security certificate is not on the list is unavailable. 

7.  Choose Proxy User and/or Website User, and complete the Security Information.

When would you choose both? – If you are connecting through a Proxy Server AND your website has security access, you must configure both Proxy User and Web Server.

When would you choose just one? – If you are NOT connecting through a Proxy Server, but your website has security access, configure just the Website User utility.  If you are only connecting through a Proxy Server, and your Website does NOT require security access, then configure only the Proxy User utility.

Figure 3-Y: Proxy User Configuration

Sections of the Proxy User Configuration Utility

Proxy Username - The name of the Proxy User connecting to the Web Listener.

Proxy Password - The password of the Proxy User connecting to the Web Listener.

Confirm Password - Confirm the Proxy User Password by re-typing it.

Domain Name - The name of the domain the Web Listener is connecting to.

Authentication Types Section

NoneThis is the default authentication type and should be used if your Proxy Server does NOT require authentication (password, etc.) to access the Internet.

Basic This is Basic (64-bit) Authentication and should be used if your Proxy Server does require the use of Basic Authentication to access the Internet.

Digest This is Digest (128-bit, MD-5) Authentication and should be used if your Proxy Server requires the use of Digest Authentication to access the Internet.

Note: Information about Authentication Types may be found on the Internet in numerous locations, including:  http://www.ietf.org/

Figure 3-Z: Web Site User Configuration

Sections of the Web Site User Configuration Utility

Website Username - The name of the Website User connecting to the Web Listener.

Website Password - The password of the Website User connecting to the Web Listener.

Confirm Password - Confirm the Website User Password by re-typing.

Domain Name - The name of the domain the Web Listener is connecting to.

Authentication Type Section

None – This is the default authentication type and should be used if your Website does not require authentication (password, etc.) to access the Internet.

Basic – This is Basic (64-bit) Authentication and should be used if your Website does require the use of Basic Authentication to access the Internet.

Digest – This is Digest (128-bit, MD-5) Authentication and should be used if your Website requires the use of Digest Authentication to access the Internet.

Web Server – This hypertext link provides you with a quick way to see if the Web Server is running by opening the Web Server in your default browser.  If this cannot be opened, then the Web Server is not connected.

Loftware Push Servlet – This hypertext link is also a quick way to see if the Web Servlet is operational.  If it is, the page is displayed in your default web browser.  If this page does not open, the servlet is not turned on, and this page does not display.  If the servlet is turned on, but it is not connected to the Loftware Print Server, the page displays with a “not connected” message.

8.  When the Server Configuration information is complete, click Next.

The following is displayed:

Figure 3-AA: Web Listener (i-push) Status Screen

If the connections are completed without error, the Web Listener Configuration Utility is displayed.  If the connection fails, view the error message displayed in the Errors Encountered: section, and correct the errors.  A common error might be failure to connect through the Proxy Server or typing in the wrong IP Address, either of which produces an error message.

Another common error is not having any printers configured on the Loftware Server.  Information on adding printers to the Loftware Print Server is found earlier in this chapter.

Note: If the Web Listener is not available when a request to print a label is made, the XML file for the job is stored in the \spooled folder.  When the Web Listener becomes available, the job will then be printed.