In order to enable printing of guest badges from the onVisit Online web interface, the onVisit PrintService is needed. This is an application that needs to be installed locally on a machine/server that is available to the client machines needing web print functionality.
There are a number of possible configurations available depending on a variety of factors and this document will attempt to cover the most common scenarios to help decide on which setup is best for you.
How it works
The PrintService software is set up as a webservice that accepts print requests via a secure https web URL and routes the request to the appropriate printer on the network. When a user initiates a print request from the onVisit Online website, onVisit finds the local URL for the PrintService and redirects the browser to the appropriate address. As such, printing from the web will only work when user is on the same network as the PrintService. The diagram below illustrates this.
The machine running the onVisit PrintService must have the following software installed:
- Microsoft Net Framework 4.6.2 (or newer)
- Internet Information Server 7.x (or newer)
- Drivers and client software for the printer (DYMO or Brother)
PrintService and SSL certificates
The PrintService requires a secure https connection and an SSL certificate must be installed for the machine hosting the service, and must be trusted by the clients being used for printing from web.
onVisit provides a tool for generating a selfsigned certificate for the machine hosting the PrintService that won’t expire until January 1st 2040 which can be used for secure connections to the PrintService. As the certificate is selfsigned it must under no circumstances be used for any other purpose.
onVisit also has a tool for adding the CA to the trusted certificate store on the client machines.
If you do not wish to use the selfsigned certificate, you must provide your own certificate and make sure that it is added to the trusted certificate store on the client machines. You will also be required to make sure that the certificate is valid and renewed when needed.
To ensure a stable printing environment we strongly recommend using network printing as opposed to windows printer sharing. The Brother printers has built in network capabilities but if you’re going to use DYMO printers you will need a DYMO Print Server adapter in order to get the printers on the network. The printers will also need to have a static IP-address and be available to the machine hosting the PrintService.
PrintService on the Selfregistration terminal
We recommend running the PrintService on the Selfregistration terminal, if possible, as it gives the advantage of having all the local onVisit software in one place and removes the need for additional hardware.
This requires that the Selfregistration terminal is available on the same network as the client machines (must be able to reach the machine via https from the client browser) and the printer(s).
This also allows printing from the web to the same printer used by the Selfregistration application.
PrintService on the client machine
If the Selfregistration terminal needs to be isolated on a separate network, another option is installing the PrintService directly on the client machine that needs to have access to printing from web.
This scenario is only recommended if there is only one client machine that needs to be able to print from web. Also note that it requires a separate printer from the one used by the Selfregistration application.
PrintService on a dedicated (virtual) server
If more than one client machine needs to be able to print from web and the Selfregistration terminal is isolated on a separate network, the PrintService should be installed on dedicated Windows server that is available to all the client machines in question.
This scenario also requires a separate printer from the one used by the Selfregistration app
Before we can install the printservice on your system, we will need to know:
* Whether you will be using your own SSL certificate or not
* Whether you will be using a separate printer for printing labels from the web (recommended) or if you will be using the same printer as the selfregistration terminal.
* Whether there are network restrictions between the client machine(s) and the selfregistration terminal.
* If there will be a need to print labels from more than one client machine.
This will determine where best to install the print, how the printer(s) needs to be connected (directly via USB or on the network) and which machines we will need access to when performing the installation.