PINES Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Hatch ======

Hatch is an optional installable program that works with your browser to manage complex printing needs (such as printing to different printers under different circumstances). Hatch was originally designed to store local settings (such as visible column settings and customized print templates), but those settings are now stored on the server (under the workstation name). 

As of Evergreen 3.4 (which PINES upgraded to January 2020), Hatch now stores a list of the workstations that have been registered on the current computer as well, so if you need to clear the browser cookies, the dropdown list of registered workstations will no longer disappear. 

<note warning>Hatch is only currently supported on 64-bit Windows machines.</note>



===== 1. Update Java =====

Hatch requires the current Java Runtime Environment (JRE). If you are unsure which version you have, view your computer's list of programs. You can download the latest version at:

[[https://www.java.com/en/download/help/windows_manual_download.xml|https://www.java.com/en/download/help/windows_manual_download.xml]]

===== 2. Download and Install Hatch =====

If you had an earlier version of Hatch installed, you may want to uninstall it first. If so, look for the program called "Evergreen ILS - Hatch - Java based Print Service and Local Storage System."

First, install the Hatch program:
  * [[https://evergreen-ils.org/documentation/install/INSTALL_Hatch.html|Installation Instructions]]
  * [[https://evergreen-ils.org/egdownloads/|Download Windows Hatch Installer]]

Verify that the browser extension was installed when the Hatch program installed. If it did not, manually install and enable it:  
  * [[https://addons.mozilla.org/en-US/firefox/addon/hatch-native-messenger/|Firefox Add-on]]
  * [[https://chrome.google.com/webstore/detail/hatch-native-messenger/ppooibdipmklfichpmkcgplfgdplgahl?hl=en-US|Chrome Extension]]







===== 3. Configure Hatch =====

  - Navigate to the web client site: [[https://gapines.org/eg/staff|https://gapines.org/eg/staff]] (or [[https://next.gapines.org/eg/staff|https://next.gapines.org/eg/staff]] for the PINES test server).
  - Log in with your staff account.
  - Click on Administration > Workstation > Print/Storage Service ("Hatch").
  - Check the "Use Hatch for Printing" box. (**Do not** store local settings in Hatch.)
  - Return to the Home Page (you may need to re-set up your workstation and log in again).

{{:admin:workstations:pasted:20230105-111119.png}}
===== 4. Configure Printers =====

Go to Administration > Workstation > Printer Settings

**Default Tab**

  - Set Printer to go to your laser printer.
  - Ensure that Paper Type is set correctly.
  - Adjust any other settings as you wish.
  - Click Apply Changes.

**Receipt Tab**

  - Set Printer to go to your receipt printer.
  - Ensure that your Paper Type is set to Roll Paper 80 x 297 mm (or whichever roll size your receipt printer uses).
  - Set Automatic Margins to HARDWARE_MINIMUM.
  - Click Apply Changes.

**Label Tab** \\ (Most staff will not have a label printer, so this step can be skipped.)

  - Set Printer to go to your label printer.
  - Ensure that your Paper Type is set to the appropriate type.
  - Set Automatic Margins to HARDWARE MINIMUM.
  - Click Apply Changes.

**Mail Tab**

  - Set Printer to go to whichever printer you wish to print mailing addresses to (this may be a laser printer, label printer, or receipt printer, depending on your local configuration).
  - Set Paper Source appropriately (ie, if using envelopes in a laser printer, choose Manual).
  - Set the Paper Type appropriately.
  - Set the Page Orientation appropriately (relevant if printing to something such as an envelope).
  - Click Apply Changes.

**Offline Tab**

  - Set Printer to go to your receipt printer.
  - Ensure that your Paper Type is set to Roll Paper 80 x 297 mm (or whichever roll size your receipt printer uses).
  - Set Automatic Margins to HARDWARE_MINIMUM.
  - Click Apply Changes.

===== 5. Force Printer Context =====

If your receipts appear to be printing to the default printer even though you have the receipt printer configured, you may need to do this step as well.

  - Go to Administration > Workstation > Print Templates.
  - Select the first template type.
  - Choose the desired printer from the Force Printer Context (ie, Default or Receipt) dropdown.
  - Click Save Locally.
  - Repeat for each of the other templates.

If you export your print templates, the export will contain these printer context settings as well.

====== How to Reconnect if You Clear Your Cookies ======

If you clear your browser cookies, you will lose your workstation name. However, if you register a workstation with the same name, you can restore your settings from the server as well as reconnect Hatch.

  - Log in with a LibraryManager or LocalAdmin account.
  - Create a workstation with the same name that was used before clearing cookies.
  - Click Use Now to log in again.
  - Navigate to Administration > Workstation > Print/Storage Service ("Hatch").
  - Check **only** the 'Use Hatch for Printing' box.
  - Click on the Home icon.
  - You will be returned to the workstation registration screen again - click Use Now to log in again.
  - Your local settings and print configuration should now be restored.

====== Troubleshooting ======

If you are seeing unusual Hatch problems that you are unable to resolve, please go through the Troubleshooting steps first to ensure that all versions and settings are correct, and to gather console error information to submit to the Help Desk for assistance. 

  * [[admin:workstations:troubleshooting|Troubleshooting]]
  * [[admin:workstations:troubleshooting#retrieve_console_messages|Retrieve Console Messages]]

**Reinstalling Hatch**

If you need to reinstall Hatch, be sure to completely uninstall the previous version first. For best results, we recommend that you also delete the C:\Users\<username>\AppData\Local\Google folder if it is present.

**Chrome Browser Setting for Preload Pages**

If your Chrome browser begins loading white pages, you may be encountering a problem with the "Preload pages" browser setting. To disable this setting, go into Chrome settings -> Performance -> Turn off Preload pages.