Difference between revisions of "Printer Installation"

From TMS Support Wiki
Jump to navigation Jump to search
 
(137 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Overview==
PTS prints to label printers to produce prescription barcodes and tickets and other documents. As PTS is web based software there are additional steps and considerations when connecting the application to a label printer.
PTS prints to label printers to produce prescription barcodes and tickets and other documents. As PTS is web based software there are additional steps and considerations when connecting the application to a label printer.
==Network Printing==
 
Read the instructions carefully before beginning work. Don't assume or make guesses; PTS printing does not work in a typical way and there are many ways that network printing can fail.
=Network Printing=
Network printing is by far the most popular way of setting up label printing in PTS.
Network printing is by far the most popular way of setting up label printing in PTS.
===Pros of network printing===
==Pros of network printing==
<ul>
<ul>
<li>Less interaction is required by the pharmacist for each print (compared to Browser Printing) as there is no mandatory print preview via the web browser.</li>
<li>Less interaction is required by the pharmacist for each print (compared to Browser Printing) as there is no mandatory print preview via the web browser.</li>
<li>Can print to any printer from any PC.</li>
<li>Handled centrally by PTS; any printer can be used from any PC.</li>
</ul>
</ul>


===Cons of network printing===
==Cons of network printing==
<ul>
<ul>
<li>Network printing is setup per PC and per printer, so has to be repeated for each printer, and has to be redone if the printer is replaced.</li>
<li>The setup process is long winded and has to be repeated for each printer, and has to be redone if the PC or printer are replaced.</li>
<li>Requires remote admin access to the PTS application server to setup and maintain.</li>
<li>Requires remote admin access to the PTS application server to setup and maintain. Random members of IT may not have the level of access necessary to do it.</li>
<li>Vulnerable to server and network congestion.</li>
<li>Vulnerable to server and network congestion.</li>
<li>Any problems or interruptions usually occur on the server, meaning the printer can go down without warning and can't be fixed without tracking down a server admin.</li>
<li>Any problems or interruptions usually occur on the server, meaning the printer can go down without warning and can't be fixed without tracking down a server admin.</li>
<li>Configuring the various situations that should change the default printer can get complicated.</li>
</ul>
</ul>


===Installation instructions===
==Installation instructions==
===Installing the printer on the PC and sharing it===
<i>This is unnecessary if using a TCP/IP printer.</i>
<ol>
<ol>
<li>Download the “Seagull Drivers for Zebra Printers” file from the [https://tmsinsight.com/Downloads.aspx Downloads & Updates section] at tmsinsight.com. Run it on the PC you will connect your printer to but don’t connect the printer just yet.</li>
<li>Download the [[Media:Seagull-drivers-for-zebra-printers.zip|Seagull Drivers for Zebra Printers]] installer. Run it on the PC you will connect your printer to but don’t connect the printer just yet.</li>
<li>During installation leave the install path as C:\Seagull\ and untick the “run driver wizard” and the “read installation instructions” options then click finish.</li>
<li>During installation leave the install path as C:\Seagull\ and untick the “run driver wizard” and the “read installation instructions” options then click finish.</li>
<li>Connect your printer via USB. When Windows detects the printer it will begin the installation wizard which will work differently depending on your version of Windows. You should have the opportunity to specify a source directory for your drivers, set this to C:\Seagull\ and complete the installation.</li>
<li>Connect your printer via USB. When Windows detects the printer it will begin the installation wizard which will work differently depending on your version of Windows. You should have the opportunity to specify a source directory for your drivers, set this to C:\Seagull\ and complete the installation. When choosing the printer model you might find it hard to determine whether you have an EPL or ZPL printer; ZPL is the much more common variant.</li>
<li>Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.</li>
<li>Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.</li>
<li>Under the General tab, click Preferences and then create a new label size for PTS (normally 76mm by 38mm). Make sure you select the new label size and click OK.</li>
<li>Under the General tab, click Preferences and then create/select the correct label size (normally 76mm by 38mm).</li>
<li>Go to the Advanced tab, click Printing Defaults and then choose the new label size again if it appears in the list. If not, create it anew.</li>
<li>Go to the Graphics tab, select None under the Dithering options and then click OK.</li>
<li>Go to the Advanced tab, click Printing Defaults and then select the correct page size and dithering options again.</li>
<li>Go to the Ports tab and untick Bidirectional Support.</li>
<li>Go to the Ports tab and untick Bidirectional Support.</li>
<li>Next go to the Sharing tab and share the printer.</li>
<li>Next go to the Sharing tab and share the printer.</li>
<li>Remote Desktop into the PTS web server and then run the Seagull Drivers on there. Again, untick the “run driver wizard” and the “read installation instructions” options then click finish.</li>
</ol>
 
===Mapping the printer onto the PTS server===
<ol>
<li>Remote Desktop into the PTS web server.</li>
<li>Ensure the Print Spooler service is running, and is set to automatically start.</li>
<li>Install the Seagull drivers on the server using the same installer as before. Again, untick the “run driver wizard” and the “read installation instructions” options then click finish.</li>
<li>
<li>
<ol type="a">
<ol type="a">
<li><strong>Windows Server 2016 and newer</strong><br/>
<li><strong>Shared Printer</strong><br/>
Open Print Management, expand Print Servers, then expand the server menu, right-click Printers and then choose Add a Printer. Choose Add a Local Printer, then choose Create a New Port and select Local Port. When it asks you to give it a name, enter the path to the shared printer e.g. \\ComputerName\ShareName.</li>
Open Devices and Printers and then choose Add a Printer. Choose Add a Local Printer, then choose Create a New Port and select Local Port. When it asks you to give the port a name, enter the path to the shared printer e.g. \\ComputerName\ShareName.</li>
<li><strong>Windows Server 2012 and older</strong><br/>
<li><strong>TCP/IP Printers</strong><br/>
Open Devices and Printers and then choose Add a Printer. Choose Add a Local Printer, then choose Create a New Port and select Local Port. When it asks you to give it a name, enter the path to the shared printer e.g. \\ComputerName\ShareName.</li>
Open Devices and Printers and then choose Add a Printer. Choose Add a Printer using TCP/IP address or hostname, then fill in the details for the remote printer.</li>
</ol>
</ol>
</li>
</li>
<li>Click OK and then Next and then select the correct printer model if prompted. If your model doesn’t appear in the list, choose Have Disk and then select the drivers you unpacked to C:\Seagull. Select your printer and click Next. You will be asked to enter a name for the printer, give it a short but descriptive name with no spaces, e.g. BookingIn. <strong>Do not</strong> set it as your default printer and <strong>do not</strong> share this instance of the printer. Click Next and then click Finish. Verify you can print a test page.</li>
<li>Click OK and then Next and then select the correct printer model if prompted. If your model doesn’t appear in the list, choose Have Disk and then select the drivers you unpacked to C:\Seagull. Select your printer and click Next. You will be asked to enter a name for the printer, give it a short but descriptive name with no spaces, e.g. BookingIn. <strong>Do not</strong> set it as your default printer and <strong>do not</strong> share this instance of the printer. Click Next and then click Finish.</li>
<li>Repeat steps <strong>5 through 7</strong> on this printer.</li>
<li>Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.</li>
<li>Log in to PTS as an administrator. Go to Setup > Printers > [open Actions Menu] > New Printer. Choose the relevant dispensary. In the Name on Server field enter the name you gave the printer in <strong>step 11</strong>.</li>
<li>Under the General tab, click Preferences and then create/select the correct label size (normally 76mm by 38mm).</li>
<li>Go to the Graphics tab, select None under the Dithering options and then click OK.</li>
<li>Go to the Advanced tab, click Printing Defaults and then select the correct page size and dithering options again.</li>
<li>Go to the Ports tab and untick Bidirectional Support.</li>
<li>Verify that you can print a test page.</li>
<li>Log in to PTS as an administrator. Go to Setup > Printers > [open Actions Menu] > New Printer. Choose the relevant dispensary. In the Name on Server field enter the name you gave the printer in <strong>step 5</strong>. See the [[Printers]] page for more details.</li>
<li>Test the printer with a PTS label. Reprinting an Activity barcode is an easy way of doing this.</li>
<li>Test the printer with a PTS label. Reprinting an Activity barcode is an easy way of doing this.</li>
<li>Consider installing the "Print Queue Monitor Service" from the [https://tmsinsight.com/Downloads.aspx Downloads & Updates section] at tmsinsight.com. This prevents errored documents getting stuck in the spooler and prevents the printer from randomly stopping.</li>
<li>Only once the printer is confirmed working, consider installing the [[Media:Print-queue-monitor-service.zip|Print Queue Monitor Service]] on the server. This automatically deletes errored documents from the spooler and prevents the printer from randomly stopping, but isn't designed to address any actual printer issues.</li>
</ol>
</ol>


===Troubleshooting===
===Troubleshooting===
<ol>
See the [[Printer Troubleshooting]] page in the event that the printer does not work on the first try.
<li><strong>I cannot print a test page from the client PC.</strong><br/>
The printer is not correctly installed. Delete the printer and try again, making sure to select the correct printer model when given the choice. If you cannot get this to work please consult with your IT department; general printer issues are outside the scope of this document.</li>
<li><strong>During installation on the server I get a “bad username/password” or similar "access denied" error.</strong><br/>
The user account you’re currently logged into the server with does not have permission to install a printer on the server. Note that if you are logged in as a local admin you may need to switch to a domain admin account to activate the appropriate group policy.</li>
<li><strong>The server cannot find the shared printer even though I’m certain I’ve typed it correctly.</strong><br/>
Check that Windows Explorer can find the PC via "\\PCName\" and that the shared printer is listed in there. If not, you have fundamental networking issues that need to be resolved first. You may have more success using the client PC’s IP address instead of its name, e.g. \\192.168.2.7\Name, but this won’t work with dynamic IP addresses.</li>
<li><strong>I can print test pages from both the client and server PCs but nothing happens when I print from PTS.</strong><br/>
Verify that you entered the Name on Server value correctly in Setup > Printers.</li>
<li><strong>The print spooler receives the document but it errors and doesn’t print.</strong><br/>
When this starts happening always bear in mind that an errored document in the spooler will prevent any further documents from printing until it is deleted. You'll need to get into the routine of deleting the document at every step while troubleshooting this problem.<br/>
If this is happening with test pages this indicates a networking issue of some kind. Ensure the printer is still online, is still shared, the PC is turned on and that the server and the PC can see each other. Searching for the client PC in an Explorer window on the server is a good way to test the network and that the printer is accessible.<br/>
When the problem is affecting PTS documents exclusively this is usually a permissions issue. Make sure that “Everyone” has permission to print, manage the printer and manage documents on the printer on both the server and the client (you can do this under the Security tab). Failing that, you may need to alter the “account” that the PTS application runs under. To do this open up IIS, click Application Pools, choose the application pool that PTS runs under and then choose Advanced Settings. Next find the Identity setting and change the setting from ApplicationPoolIdentity to NetworkService and click OK.</li>
<li><strong>That didn’t help, the document still errors in the spooler.</strong><br/>
Again note that you must delete the previous errored document from the spooler before trying again. If there is still an issue you can configure the application pool to run under a specific account and if you set this to an administrator account this should bypass any security issues. However, be aware there may be various reasons why you cannot do this, in particular if your passwords are set to expire. Nevertheless, follow the instructions above but instead of choosing NetworkService, choose Custom Account and enter the account details.</li>
<li><strong>The document prints but it prints off-centre or prints over several labels.</strong><br/>
Ensure that you completed steps 5 and 6 on both the client and the server. Note that makes a total of four places where you specify the label sizes for each printer – please understand that we don’t have any control over this odd procedure.</li>
<li><strong>During testing the Print button doesn’t seem to respond or takes a very long time to react.</strong><br/>
Check that Bidirectional Support is turned off on both the server and client PCs. You do not lose anything noteworthy by disabling this setting.</li>
<li><strong>Since installing the printer, booking in prescriptions takes a lot longer.</strong><br/>
Again, check that Bidirectional Support is turned off on both the server and client PCs.</li>
<li>[[File:Screenshot_2022-02-16_at_11.37.42.png|thumb|The "Disable network features" dialog. Simply click Disable.]]<strong>I’ve turned off Bidirectional Support on both the client and the server yet it still seems to print rather slowly.</strong><br/>
Make sure you have used the Seagull Drivers for Zebra Printers from the Downloads & Updates section at tmsinsight.com on both the client and the server, as any sort of mismatch between two drivers can result in slow printing. We do not generally recommend the first-party Zebra drivers for any reason. You could also try connecting to the shared printer by the host’s IP address as opposed to its name (see troubleshooting point 3). If you cannot resolve this to your satisfaction, consider Browser Printing.</li>
<li><strong>While configuring the printer on the server I’m getting an extremely slow response from the property pages and then I’m eventually prompted to disable network features. What is this?</strong><br/>
This is an extremely common error that can have weird consequences if not dealt with properly, including being unable to access the printer properties page to finish configuring the printer. Simply click Disable, and then ensure that Bidirectional Support is turned off in Printer Properties > Ports. This is an essential step. This error is actually a good indicator that the server has found and is connected to the printer.</li>
<li><strong>I can print a test page from the client PC but not the server, despite completing all the troubleshooting steps.</strong><br/>
Consider deleting the printer and ports and starting again from scratch. If you cannot get this to work please consult with your IT department; general printer issues are outside the scope of this document.</li>
</ol>


==Browser Printing==
=Browser Printing=
[[File:PrintPreview.png|thumb|250px|An example of the print preview you will encounter when using browser based printing. Unfortunately it is unavoidable, but can be optimised so you only have to hit the Enter key.]]
Browser printing uses the web browser to produce the document, in a similar way to how a "normal" web page is printed such as via File > Print.
Browser printing uses the web browser to produce the document, in a similar way to how a "normal" web page is printed such as via File > Print.
===Pros of browser printing===
==Pros of browser printing==
<ul>
<ul>
<li>Immune to performance, permissions, and myriad other configuration issues that can affect networked printing.</li>
<li>Immune to performance, permissions, and myriad other configuration issues that can affect networked printing.</li>
<li>Doesn't stop working if the printer is moved or replaced. As long as a printer is connected to the PC, this will be able to print to it.</li>
<li>Doesn't stop working if the printer is moved or replaced. As long as a printer is connected to the PC, this will be able to print to it.</li>
<li>Less maintenance.</li>
<li>Less maintenance, and significantly easier for IT to wrap their head around.</li>
<li>Conforms to the installed printers and default printer set in Windows.</li>
</ul>
</ul>


===Cons of browser printing===
==Cons of browser printing==
<ul>
<ul>
<li>Requires more user interaction with each print. The web browser will, by design, display a print preview that the user has to confirm. This means a minimum of one extra keystroke or mouse click with each print and that assumes the printer is set as the Windows default. It's impossible to change this behaviour as far as we know; it's a fundamental security feature of every web browser.</li>
<li>Requires more user interaction with each print. The web browser will, by design, display a print preview that the user has to confirm. This means a minimum of one extra keystroke or mouse click with each print and that assumes the printer is set as the Windows default. It's impossible to change this behaviour as far as we know; it's a fundamental security feature of every web browser.</li>
<li>Older web browsers may not render the document properly, but support is fairly high amongst newer web browsers.</li>
<li>Conforms to the installed printers and default printer set in Windows. Indeed this is both a pro and a con. The other printing options are handled centrally by PTS, meaning you can print to any mapped printer no matter which PC you're using with no further configuration.</li>
<li>The web browser will probably try to add inappropriate margins, headers and footers to the label. This can be reconfigured (described below) but is a consideration.</li>
</ul>
</ul>


===Installation instructions===
==Installation instructions==
===Installing the printer on the PC===
<i>If the label printer you intend to use is already connected to the PC and working, skip to the next section.</i>
<ol>
<ol>
<li><i>Later versions of PTS have this step implemented out-of-the-box</i>. Log in to PTS as an administrator. Go to Setup > Printers > [open Actions Menu] > New Printer. Choose the relevant dispensaries (selecting all of them may be appropriate). In the Name on Server field enter "LOCAL" and then click Save. In the next popup, enter "Browser Printing" as the Printer's name.</li>
<li>Download the [[Media:Seagull-drivers-for-zebra-printers.zip|Seagull Drivers for Zebra Printers]] installer. Run it on the PC you will connect your printer to but don’t connect the printer just yet.</li>
<li>If the label printer you intend to use is already connected to the PC and working, skip to step 6. Otherwise, download the “Seagull Drivers for Zebra Printers” file from the [https://tmsinsight.com/Downloads.aspx Downloads & Updates section] at tmsinsight.com. Run it on the PC you will connect your printer to but don’t connect the printer just yet.</li>
<li>During installation leave the install path as C:\Seagull\ and untick the “run driver wizard” and the “read installation instructions” options then click finish.</li>
<li>During installation leave the install path as C:\Seagull\ and untick the “run driver wizard” and the “read installation instructions” options then click finish.</li>
<li>Connect your printer via USB. When Windows detects the printer it will begin the installation wizard which will work differently depending on your version of Windows. You should have the opportunity to specify a source directory for your drivers, set this to C:\Seagull\ and complete the installation.</li>
<li>Connect your printer via USB. When Windows detects the printer it will begin the installation wizard which will work differently depending on your version of Windows. You should have the opportunity to specify a source directory for your drivers, set this to C:\Seagull\ and complete the installation. When choosing the printer model you might find it hard to determine whether you have an EPL or ZPL printer; ZPL is the much more common variant.</li>
<li>[[File:Screenshot_2022-02-16_at_11.38.04.png|thumb|How to find page setup in Internet Explorer.]]Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.</li>
<li>Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.</li>
<li>Under the General tab, click Preferences and then create a new label size for PTS (normally 76mm by 38mm). Make sure you select the new label size and click OK.</li>
</ol>
<li>Go to the Advanced tab, click Printing Defaults and then choose the new label size again if it appears in the list. If not, create it anew.</li>
===Configuring the printer to work with PTS labels===
<li>Test the printer with a PTS label. Reprinting an Activity barcode is an easy way of doing this.</li>
[[File:Screenshot_2022-02-16_at_11.38.04.png|thumb|How to find page setup in Internet Explorer.]]
<ol>
<li>In Printer Properties, under the General tab, click Preferences and then create/select the correct label size (normally 76mm by 38mm).</li>
<li>Go to the Graphics tab, select None under the Dithering options and then click OK.</li>
<li>Go to the Advanced tab, click Printing Defaults and then select the correct page size and dithering options again.</li>
<li>Log in to PTS as an administrator. Go to Setup > Printers and verify that there is a printer with the Name on Server field set to "LOCAL". Make a note of the printer's name; this is what you need to select to use it.</li>
<li>If no such printer exists, open the Actions Menu and click New Printer. Choose the relevant dispensaries (selecting all of them may be appropriate). In the Name on Server field enter "LOCAL" and then click Save. In the next popup, enter "Browser Printing" as the Printer's name. See the [[Printers]] page for more details.</li>
<li>Test the printer with a PTS label; simply select Browser Printing (or whatever the printer was called) from the printer drop down. Reprinting an Activity barcode is an easy way of doing this.</li>
<li>If you are accustomed to Network Printing, notice that you now see an additional print preview dialog where you have to select the physical printer and click OK. This will happen with every print job and is a characteristic of browser printing. You could optionally speed this process up by designating the label printer as the default printer in Windows, and from then on use the enter key instead of the OK button.</li>
<li>If you are accustomed to Network Printing, notice that you now see an additional print preview dialog where you have to select the physical printer and click OK. This will happen with every print job and is a characteristic of browser printing. You could optionally speed this process up by designating the label printer as the default printer in Windows, and from then on use the enter key instead of the OK button.</li>
<li>If the label is printed with unwanted information (e.g. the URL, or “Page 1/1” in the footer), or an excessive margin, you should be able to modify your web browser settings so that it doesn’t do that.
<li>Browser printing works with pop-ups, so you may have to turn off the browser's pop-up blocker. If nothing prints or if you find yourself able to print just the barcode label but there is no sign of the subsequent ticket, look in the address bar for the "pop-up blocked" icon. Click on it to allow pop-ups. We suggest enabling all pop-ups for PTS if you can.</li>
<li>If the label is printed with unwanted information (e.g. the URL, or “Page 1/1” in the footer, etc.), or an excessive margin (which may even cause the label to be cut in half and spread across two labels), you can modify your web browser settings so that it doesn’t do that any more.
<ul>
<ul>
<li>In Internet Explorer you can find these options in Settings > Print > Page Setup. Consider setting all of the header and footer options to “empty”, and adjust the margin sizes as appropriate.</li>
<li>In Internet Explorer you can find these options in Settings > Print > Page Setup. Set all of the header and footer options to “empty”, and adjust the margin sizes to zero.</li>
<li>In Chrome, they're in File > Print. Expand "More Settings". Set margins to "None", and untick "Headers and Footers".</li>
<li>In Chrome and Edge, from the Print Preview, expand "More Settings" then set margins to "None", and untick "Headers and Footers". The browser should remember this adjustment going forward.</li>
<li>As of PTS 5.0.6.7 this is done automatically on up-to-date versions of Chrome and Edge.</li>
</ul>
</ul>
</li>
</li>
</ol>
</ol>


==Frequently Asked Questions==
=A4 Printers=
Normally A4 printers are used to print reports or occasionally with browser based printing (see above) and will work "out-of-the-box". However as of PTS v5.0.3.0 you can now use A4 printers as network printers to facilitate the automated printing of A4 requisition forms for [[Ward Ordering]].
 
It's an understatement to say that unlike the label printers there are a wide variety of A4 printers that could be used in this way, so the information here is a little bit more generic but we will cover the important details. Much of the same [[Printer_Installation#Troubleshooting|network label printer troubleshooting]] tips will apply.
 
==Installation instructions==
===Installing the printer on the PC and sharing it===
<i>This is unnecessary if using a TCP/IP printer.</i>
<ol>
<li>Install the printer on the PC in accordance with the printer manufacturers instructions. Verify that it can print a test page.</li>
<li>Go to the Ports tab and untick Bidirectional Support.</li>
<li>Next go to the Sharing tab and share the printer.</li>
</ol>
 
===Mapping the printer onto the PTS server===
<ol>
<li>Remote Desktop into the PTS web server.</li>
<li>Ensure the Print Spooler service is running, and is set to automatically start.</li>
<li>
<ol type="a">
<li><strong>Shared Printer</strong><br/>
Open Devices and Printers and then choose Add a Printer. Choose Add a Local Printer, then choose Create a New Port and select Local Port. When it asks you to give the port a name, enter the path to the shared printer e.g. \\ComputerName\ShareName.</li>
<li><strong>TCP/IP Printers</strong><br/>
Open Devices and Printers and then choose Add a Printer. Choose Add a Printer using TCP/IP address or hostname, then fill in the details for the remote printer.</li>
</ol>
</li>
<li>Click OK and then Next and then select the correct printer model if prompted. If your model doesn’t appear in the list, choose Have Disk and then select the drivers for your printer (you may have to manually install them). Select your printer model and click Next. You will be asked to enter a name for the printer, give it a short but descriptive name with no spaces, e.g. A4Req. <strong>Do not</strong> set it as your default printer and <strong>do not</strong> share this instance of the printer. Click Next and then click Finish.</li>
<li>Go to the Ports tab and untick Bidirectional Support.</li>
<li>Verify that you can print a test page.</li>
<li>Log in to PTS as an administrator. Go to Setup > Printers > [open Actions Menu] > New Printer. Choose the relevant dispensary. In the Name on Server field enter the name you gave the printer in <strong>step 4</strong>. See the [[Printers]] page for more details.</li>
<li>Test the printer with a PTS label. Reprinting an Activity barcode is an easy way of doing this.</li>
<li>Now that the printer is set up, see the [[Ward Ordering]] page for information on how to configure this printer as the automated requisition form printer.</li>
</ol>
 
===Troubleshooting===
See the [[Printer Troubleshooting]] page in the event that the printer does not work on the first try. The troubleshooting page primarily covers label printers but the vast majority of the information will apply equally here.
 
=Frequently Asked Questions=
===What’s the difference between Browser Printing and Network Printing?===
Browser Printing uses the client’s web browser to send a print job to a connected printer via a print preview dialog box, like printing any other document from the web or other locally installed software. Network Printing sends a print document over the network from the PTS web server to the printer eliminating the need for the print dialog. Browser Printing is easy to setup and needs less maintenance, but requires at the very least one additional keystroke to confirm the print job in the dialog box, and may not work in all web browsers. Network Printing doesn’t require a print dialog box, but can sometimes be difficult to setup and maintain and is occasionally slower depending on network and server conditions.
 
If network printing is causing you persistent issues, don't lose sight of the fact that it only saves users one or two keystrokes.
===Why does Network Printing involve so much troubleshooting?===
Ultimately all you are doing is sharing a printer on one PC and then mapping to the shared printer from another PC (the PTS server). The associated troubleshooting is simply typical of printer sharing in a complicated Windows network. TCP/IP printers are generally more stable, and browser printing avoids printing over the network altogether. If network printing causes you too much grief, switch to browser printing to have PTS operate the printer locally like any other software.
 
===Can I use "Printers and Scanners" instead of Control Panel in Windows 10 and up?===
===Can I use "Printers and Scanners" instead of Control Panel in Windows 10 and up?===
You can, but it's often a chore to find the various necessary settings and options, plus it tries to get you to use the automatic tools first, which don't work. You will ultimately end up using the classic Control Panel controls anyway.
The instructions are written to use Control Panel so that they have the broadest compatibility with different versions of Windows. If you can reinterpret the instructions for use with Printer and Scanners, then feel free. Most of our users seem to feel more comfortable using Control Panel though.
===What’s the difference between Browser Printing and Network Printing?===
 
Browser Printing uses the client’s web browser to send a print job to a connected printer via a print dialog box, like printing any other document from the web. Network Printing sends a print document over the network from the PTS web server to the printer eliminating the need for the print dialog. Browser Printing is easy to setup and needs less maintenance, but requires at the very least one additional keystroke to confirm the print job in the dialog box, and may not work in all web browsers. Network Printing doesn’t require a print dialog box, but can sometimes be difficult to setup and maintain and is occasionally slower depending on network and server conditions.
===With Network Printing, shouldn’t it be enough to simply provide the fully qualified path to the printer in PTS?===
===With Network Printing, shouldn’t it be enough to simply provide the fully qualified path to the printer in PTS?===
Strictly speaking this is true, and PTS will indeed try to operate the printer this way if you just add the path to the Name on Server field so you are well within reason to try this out. That being said we see a very low success rate when the printer is not mapped first, and even if it works, it will more than likely print very slowly. Most importantly if printing does fail you will have little or no feedback as to why, making troubleshooting difficult.
Strictly speaking this is true, and you can get PTS to try to operate the printer this way by entering the fully qualified path in the Name on Server field. That being said we see a very low success rate when the printer is not mapped first, and even if it works, it will more than likely print very slowly (possibly because the default behaviour is to enable bi-directional support). Importantly if printing does fail you will have little to no feedback as to why.
 
[[File: PrintSpoolerDisabled.png |thumb|450px|In this example the Print Spooler service is disabled.]]
===How do I check whether the Print Spooler service is running?===
On the PTS server, go to Administrative Tools and then open Services. In the list, locate Print Spooler. The Status should be Running, and the Startup Type should be Automatic. If the service is stopped or disabled, right-click it, go to Properties and address the issue/s in there. You will need very elevated permissions to fix this, if anything is greyed out you will need to contact IT. Indeed even if you can fix the problem there and then you should talk to IT about preventing the issue from reoccurring.


===Despite following the advice above our printer still prints very slowly, but it works fine from other applications.===
===Despite following the advice above our printer still prints very slowly, but it works fine from other applications.===
The reason it seems only PTS may be affected by slow printing is that it’s a good bet that PTS is the only software in use that prints across your network from a web server to a label printer. If the printer will not print satisfactorily over the network, you should switch to Browser Printing.
The reason it seems only PTS may be affected by slow printing is that it’s a good bet that PTS is the only software in use that prints across your network from a web server to a label printer. If the printer will not print satisfactorily over the network, and you really have explored all the options on this page and on the [[Printer Troubleshooting]] page, you should switch to Browser Printing.
===Why must I use Print Management on Windows Server 2016 and newer?===
 
There seems to be an issue in the new Windows 10-based Windows Server operating systems (2016+) where mapping printers in Control Panel never completes correctly and the printer remains in the Unspecified section, where it cannot be configured nor used. The Print Management app does not seem to have the same issue. You can find the Print Management app by searching for it, in administrative tools, or by running “printmanagement.msc” from a command window.
===Just what is bi-directional support and why does it cause so many problems?===
===What is bi-directional support and why does it cause so many problems?===
It cannot be overstated how many reported issues boil down to this part of the setup being skipped.
It cannot be overstated how many reported issues boil down to this part of the setup being skipped.


Bi-directional support refers to two computers communicating with each other about the various properties of a shared printer, such as ink and paper stock levels, so a remote user can be informed about what's going on with the printer. It's completely unnecessary for our purposes as the remote computer is the PTS server, which nobody will be monitoring for this sort of thing, and crucially there seems to be a huge performance penalty with the setting turned on.  
Bi-directional support refers to two computers communicating with each other about the various properties of a shared printer, such as ink and paper stock levels, so a remote user can be informed about what's going on with the printer. It's completely unnecessary in this context since the remote computer is the PTS server, which nobody will be monitoring for this sort of thing.
 
Crucially, <strong>there is a huge performance penalty associated with this setting</strong>.
 
It's important to note that a single printer having this setting enabled can and will slow down printing for all PTS printers, as the poor performance impacts the server's print spooler as a whole. It's a good idea to check every single installed printer for this setting regardless of the printer you're having trouble with.
 
We do not yet know why our setup is so vulnerable to this setting. It may be related to latency due to the client/server nature of PTS, but the effects are perhaps too consistent and extreme for this to be the only explanation. It's possible that Zebra label printers are simply not well designed in this regard.
 
It's not uncommon for reports of general PTS performance issues to turn out to be caused by this setting.


The impact can be so massive that it is sometimes not obviously related to printers as all server functions are affected equally, so to other affected users there is no obvious correlation between the poor performance and the printing of a label. It's unfortunate that the default Windows behaviour is to turn the setting on even on a server OS, but it can be overcome by turning it off manually under the Ports tab.
It's deeply unfortunate that the default Windows behaviour is to turn the setting on, even on a server OS, but it bears repeating that it can be overcome by simply turning it off manually in the Ports tab.

Latest revision as of 10:04, 2 July 2024

PTS prints to label printers to produce prescription barcodes and tickets and other documents. As PTS is web based software there are additional steps and considerations when connecting the application to a label printer.

Read the instructions carefully before beginning work. Don't assume or make guesses; PTS printing does not work in a typical way and there are many ways that network printing can fail.

Network Printing

Network printing is by far the most popular way of setting up label printing in PTS.

Pros of network printing

  • Less interaction is required by the pharmacist for each print (compared to Browser Printing) as there is no mandatory print preview via the web browser.
  • Handled centrally by PTS; any printer can be used from any PC.

Cons of network printing

  • The setup process is long winded and has to be repeated for each printer, and has to be redone if the PC or printer are replaced.
  • Requires remote admin access to the PTS application server to setup and maintain. Random members of IT may not have the level of access necessary to do it.
  • Vulnerable to server and network congestion.
  • Any problems or interruptions usually occur on the server, meaning the printer can go down without warning and can't be fixed without tracking down a server admin.
  • Configuring the various situations that should change the default printer can get complicated.

Installation instructions

Installing the printer on the PC and sharing it

This is unnecessary if using a TCP/IP printer.

  1. Download the Seagull Drivers for Zebra Printers installer. Run it on the PC you will connect your printer to but don’t connect the printer just yet.
  2. During installation leave the install path as C:\Seagull\ and untick the “run driver wizard” and the “read installation instructions” options then click finish.
  3. Connect your printer via USB. When Windows detects the printer it will begin the installation wizard which will work differently depending on your version of Windows. You should have the opportunity to specify a source directory for your drivers, set this to C:\Seagull\ and complete the installation. When choosing the printer model you might find it hard to determine whether you have an EPL or ZPL printer; ZPL is the much more common variant.
  4. Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.
  5. Under the General tab, click Preferences and then create/select the correct label size (normally 76mm by 38mm).
  6. Go to the Graphics tab, select None under the Dithering options and then click OK.
  7. Go to the Advanced tab, click Printing Defaults and then select the correct page size and dithering options again.
  8. Go to the Ports tab and untick Bidirectional Support.
  9. Next go to the Sharing tab and share the printer.

Mapping the printer onto the PTS server

  1. Remote Desktop into the PTS web server.
  2. Ensure the Print Spooler service is running, and is set to automatically start.
  3. Install the Seagull drivers on the server using the same installer as before. Again, untick the “run driver wizard” and the “read installation instructions” options then click finish.
    1. Shared Printer
      Open Devices and Printers and then choose Add a Printer. Choose Add a Local Printer, then choose Create a New Port and select Local Port. When it asks you to give the port a name, enter the path to the shared printer e.g. \\ComputerName\ShareName.
    2. TCP/IP Printers
      Open Devices and Printers and then choose Add a Printer. Choose Add a Printer using TCP/IP address or hostname, then fill in the details for the remote printer.
  4. Click OK and then Next and then select the correct printer model if prompted. If your model doesn’t appear in the list, choose Have Disk and then select the drivers you unpacked to C:\Seagull. Select your printer and click Next. You will be asked to enter a name for the printer, give it a short but descriptive name with no spaces, e.g. BookingIn. Do not set it as your default printer and do not share this instance of the printer. Click Next and then click Finish.
  5. Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.
  6. Under the General tab, click Preferences and then create/select the correct label size (normally 76mm by 38mm).
  7. Go to the Graphics tab, select None under the Dithering options and then click OK.
  8. Go to the Advanced tab, click Printing Defaults and then select the correct page size and dithering options again.
  9. Go to the Ports tab and untick Bidirectional Support.
  10. Verify that you can print a test page.
  11. Log in to PTS as an administrator. Go to Setup > Printers > [open Actions Menu] > New Printer. Choose the relevant dispensary. In the Name on Server field enter the name you gave the printer in step 5. See the Printers page for more details.
  12. Test the printer with a PTS label. Reprinting an Activity barcode is an easy way of doing this.
  13. Only once the printer is confirmed working, consider installing the Print Queue Monitor Service on the server. This automatically deletes errored documents from the spooler and prevents the printer from randomly stopping, but isn't designed to address any actual printer issues.

Troubleshooting

See the Printer Troubleshooting page in the event that the printer does not work on the first try.

Browser Printing

An example of the print preview you will encounter when using browser based printing. Unfortunately it is unavoidable, but can be optimised so you only have to hit the Enter key.

Browser printing uses the web browser to produce the document, in a similar way to how a "normal" web page is printed such as via File > Print.

Pros of browser printing

  • Immune to performance, permissions, and myriad other configuration issues that can affect networked printing.
  • Doesn't stop working if the printer is moved or replaced. As long as a printer is connected to the PC, this will be able to print to it.
  • Less maintenance, and significantly easier for IT to wrap their head around.
  • Conforms to the installed printers and default printer set in Windows.

Cons of browser printing

  • Requires more user interaction with each print. The web browser will, by design, display a print preview that the user has to confirm. This means a minimum of one extra keystroke or mouse click with each print and that assumes the printer is set as the Windows default. It's impossible to change this behaviour as far as we know; it's a fundamental security feature of every web browser.
  • Conforms to the installed printers and default printer set in Windows. Indeed this is both a pro and a con. The other printing options are handled centrally by PTS, meaning you can print to any mapped printer no matter which PC you're using with no further configuration.

Installation instructions

Installing the printer on the PC

If the label printer you intend to use is already connected to the PC and working, skip to the next section.

  1. Download the Seagull Drivers for Zebra Printers installer. Run it on the PC you will connect your printer to but don’t connect the printer just yet.
  2. During installation leave the install path as C:\Seagull\ and untick the “run driver wizard” and the “read installation instructions” options then click finish.
  3. Connect your printer via USB. When Windows detects the printer it will begin the installation wizard which will work differently depending on your version of Windows. You should have the opportunity to specify a source directory for your drivers, set this to C:\Seagull\ and complete the installation. When choosing the printer model you might find it hard to determine whether you have an EPL or ZPL printer; ZPL is the much more common variant.
  4. Find the printer in Control Panel > Devices and Printers, right click it and go to Printer Properties. Verify that it can print a test page.

Configuring the printer to work with PTS labels

How to find page setup in Internet Explorer.
  1. In Printer Properties, under the General tab, click Preferences and then create/select the correct label size (normally 76mm by 38mm).
  2. Go to the Graphics tab, select None under the Dithering options and then click OK.
  3. Go to the Advanced tab, click Printing Defaults and then select the correct page size and dithering options again.
  4. Log in to PTS as an administrator. Go to Setup > Printers and verify that there is a printer with the Name on Server field set to "LOCAL". Make a note of the printer's name; this is what you need to select to use it.
  5. If no such printer exists, open the Actions Menu and click New Printer. Choose the relevant dispensaries (selecting all of them may be appropriate). In the Name on Server field enter "LOCAL" and then click Save. In the next popup, enter "Browser Printing" as the Printer's name. See the Printers page for more details.
  6. Test the printer with a PTS label; simply select Browser Printing (or whatever the printer was called) from the printer drop down. Reprinting an Activity barcode is an easy way of doing this.
  7. If you are accustomed to Network Printing, notice that you now see an additional print preview dialog where you have to select the physical printer and click OK. This will happen with every print job and is a characteristic of browser printing. You could optionally speed this process up by designating the label printer as the default printer in Windows, and from then on use the enter key instead of the OK button.
  8. Browser printing works with pop-ups, so you may have to turn off the browser's pop-up blocker. If nothing prints or if you find yourself able to print just the barcode label but there is no sign of the subsequent ticket, look in the address bar for the "pop-up blocked" icon. Click on it to allow pop-ups. We suggest enabling all pop-ups for PTS if you can.
  9. If the label is printed with unwanted information (e.g. the URL, or “Page 1/1” in the footer, etc.), or an excessive margin (which may even cause the label to be cut in half and spread across two labels), you can modify your web browser settings so that it doesn’t do that any more.
    • In Internet Explorer you can find these options in Settings > Print > Page Setup. Set all of the header and footer options to “empty”, and adjust the margin sizes to zero.
    • In Chrome and Edge, from the Print Preview, expand "More Settings" then set margins to "None", and untick "Headers and Footers". The browser should remember this adjustment going forward.
    • As of PTS 5.0.6.7 this is done automatically on up-to-date versions of Chrome and Edge.

A4 Printers

Normally A4 printers are used to print reports or occasionally with browser based printing (see above) and will work "out-of-the-box". However as of PTS v5.0.3.0 you can now use A4 printers as network printers to facilitate the automated printing of A4 requisition forms for Ward Ordering.

It's an understatement to say that unlike the label printers there are a wide variety of A4 printers that could be used in this way, so the information here is a little bit more generic but we will cover the important details. Much of the same network label printer troubleshooting tips will apply.

Installation instructions

Installing the printer on the PC and sharing it

This is unnecessary if using a TCP/IP printer.

  1. Install the printer on the PC in accordance with the printer manufacturers instructions. Verify that it can print a test page.
  2. Go to the Ports tab and untick Bidirectional Support.
  3. Next go to the Sharing tab and share the printer.

Mapping the printer onto the PTS server

  1. Remote Desktop into the PTS web server.
  2. Ensure the Print Spooler service is running, and is set to automatically start.
    1. Shared Printer
      Open Devices and Printers and then choose Add a Printer. Choose Add a Local Printer, then choose Create a New Port and select Local Port. When it asks you to give the port a name, enter the path to the shared printer e.g. \\ComputerName\ShareName.
    2. TCP/IP Printers
      Open Devices and Printers and then choose Add a Printer. Choose Add a Printer using TCP/IP address or hostname, then fill in the details for the remote printer.
  3. Click OK and then Next and then select the correct printer model if prompted. If your model doesn’t appear in the list, choose Have Disk and then select the drivers for your printer (you may have to manually install them). Select your printer model and click Next. You will be asked to enter a name for the printer, give it a short but descriptive name with no spaces, e.g. A4Req. Do not set it as your default printer and do not share this instance of the printer. Click Next and then click Finish.
  4. Go to the Ports tab and untick Bidirectional Support.
  5. Verify that you can print a test page.
  6. Log in to PTS as an administrator. Go to Setup > Printers > [open Actions Menu] > New Printer. Choose the relevant dispensary. In the Name on Server field enter the name you gave the printer in step 4. See the Printers page for more details.
  7. Test the printer with a PTS label. Reprinting an Activity barcode is an easy way of doing this.
  8. Now that the printer is set up, see the Ward Ordering page for information on how to configure this printer as the automated requisition form printer.

Troubleshooting

See the Printer Troubleshooting page in the event that the printer does not work on the first try. The troubleshooting page primarily covers label printers but the vast majority of the information will apply equally here.

Frequently Asked Questions

What’s the difference between Browser Printing and Network Printing?

Browser Printing uses the client’s web browser to send a print job to a connected printer via a print preview dialog box, like printing any other document from the web or other locally installed software. Network Printing sends a print document over the network from the PTS web server to the printer eliminating the need for the print dialog. Browser Printing is easy to setup and needs less maintenance, but requires at the very least one additional keystroke to confirm the print job in the dialog box, and may not work in all web browsers. Network Printing doesn’t require a print dialog box, but can sometimes be difficult to setup and maintain and is occasionally slower depending on network and server conditions.

If network printing is causing you persistent issues, don't lose sight of the fact that it only saves users one or two keystrokes.

Why does Network Printing involve so much troubleshooting?

Ultimately all you are doing is sharing a printer on one PC and then mapping to the shared printer from another PC (the PTS server). The associated troubleshooting is simply typical of printer sharing in a complicated Windows network. TCP/IP printers are generally more stable, and browser printing avoids printing over the network altogether. If network printing causes you too much grief, switch to browser printing to have PTS operate the printer locally like any other software.

Can I use "Printers and Scanners" instead of Control Panel in Windows 10 and up?

The instructions are written to use Control Panel so that they have the broadest compatibility with different versions of Windows. If you can reinterpret the instructions for use with Printer and Scanners, then feel free. Most of our users seem to feel more comfortable using Control Panel though.

With Network Printing, shouldn’t it be enough to simply provide the fully qualified path to the printer in PTS?

Strictly speaking this is true, and you can get PTS to try to operate the printer this way by entering the fully qualified path in the Name on Server field. That being said we see a very low success rate when the printer is not mapped first, and even if it works, it will more than likely print very slowly (possibly because the default behaviour is to enable bi-directional support). Importantly if printing does fail you will have little to no feedback as to why.

In this example the Print Spooler service is disabled.

How do I check whether the Print Spooler service is running?

On the PTS server, go to Administrative Tools and then open Services. In the list, locate Print Spooler. The Status should be Running, and the Startup Type should be Automatic. If the service is stopped or disabled, right-click it, go to Properties and address the issue/s in there. You will need very elevated permissions to fix this, if anything is greyed out you will need to contact IT. Indeed even if you can fix the problem there and then you should talk to IT about preventing the issue from reoccurring.

Despite following the advice above our printer still prints very slowly, but it works fine from other applications.

The reason it seems only PTS may be affected by slow printing is that it’s a good bet that PTS is the only software in use that prints across your network from a web server to a label printer. If the printer will not print satisfactorily over the network, and you really have explored all the options on this page and on the Printer Troubleshooting page, you should switch to Browser Printing.

Just what is bi-directional support and why does it cause so many problems?

It cannot be overstated how many reported issues boil down to this part of the setup being skipped.

Bi-directional support refers to two computers communicating with each other about the various properties of a shared printer, such as ink and paper stock levels, so a remote user can be informed about what's going on with the printer. It's completely unnecessary in this context since the remote computer is the PTS server, which nobody will be monitoring for this sort of thing.

Crucially, there is a huge performance penalty associated with this setting.

It's important to note that a single printer having this setting enabled can and will slow down printing for all PTS printers, as the poor performance impacts the server's print spooler as a whole. It's a good idea to check every single installed printer for this setting regardless of the printer you're having trouble with.

We do not yet know why our setup is so vulnerable to this setting. It may be related to latency due to the client/server nature of PTS, but the effects are perhaps too consistent and extreme for this to be the only explanation. It's possible that Zebra label printers are simply not well designed in this regard.

It's not uncommon for reports of general PTS performance issues to turn out to be caused by this setting.

It's deeply unfortunate that the default Windows behaviour is to turn the setting on, even on a server OS, but it bears repeating that it can be overcome by simply turning it off manually in the Ports tab.