User Tools

Site Tools


admin:workstations:hatch

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
circ:workstations:hatch [2018/06/07 18:19] – [3. Configure Hatch] tmccannaadmin:workstations:hatch [2023/11/07 21:16] (current) – [Troubleshooting] tmccanna
Line 1: Line 1:
 ====== Hatch ====== ====== 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) and store local settings (such as column configurations and custom print templates).+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). 
  
-<note important>At this time**Hatch will only work with the Chrome browser**. The instructions here are specifically for Windows machinesbut it is also available for Linux machines.</note>+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 cookiesthe dropdown list of registered workstations will no longer disappear.  
 + 
 +<note warning>Hatch is only currently supported on 64-bit Windows machines.</note>
  
  
Line 9: Line 11:
 ===== 1. Update Java ===== ===== 1. Update Java =====
  
-Hatch requires the Java Runtime Environment (JRE) version 1.8 or higher. If you are unsure which version you have, view your computer's list of programs. You can download the latest version at:+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]] [[https://www.java.com/en/download/help/windows_manual_download.xml|https://www.java.com/en/download/help/windows_manual_download.xml]]
Line 17: Line 19:
 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." 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."
  
-[[https://evergreen-ils.org/downloads/Hatch-Installer-0.1.5.exe|Hatch Native Messaging Application Installer Version 0.1.5]]+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 installedIf 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]] 
  
-When you open Chrome, it should recognize that you have the new Hatch Extension installed and prompt you to enable it, but if it does not, you may need to manually enable it: 
  
-  - Go to: the Menu > More Tools > Extensions 
-  - Click on the checkbox next to Hatch Native Messenger to enable it. 
  
-When Hatch is enabled, you will see a small yellow icon in the top-right corner of the browser. 
  
-{{ :circ:workstations:hatch-icon.png?200 |}} 
  
  
Line 34: Line 38:
   - Log in with your staff account.   - Log in with your staff account.
   - Click on Administration > Workstation > Print/Storage Service ("Hatch").   - Click on Administration > Workstation > Print/Storage Service ("Hatch").
-  - Check the "Use Hatch for Printing" box. (At this time, we do not recommend storing local settings in 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).   - Return to the Home Page (you may need to re-set up your workstation and log in again).
  
-{{  :circ:workstations:hatch-settings.jpg?direct&600  |hatch-settings.jpg}} +{{:admin:workstations:pasted:20230105-111119.png}}
 ===== 4. Configure Printers ===== ===== 4. Configure Printers =====
  
-Go to Administration > Workstation > Printer Settings+Go to Administration > Workstation > Printer Settings
  
 **Default Tab** **Default Tab**
Line 69: Line 72:
   - Set Paper Source appropriately (ie, if using envelopes in a laser printer, choose Manual).   - Set Paper Source appropriately (ie, if using envelopes in a laser printer, choose Manual).
   - Set the Paper Type appropriately.   - Set the Paper Type appropriately.
-  - Set the Page Orientation appropriately (relevant if printing to something such as an envelope.+  - Set the Page Orientation appropriately (relevant if printing to something such as an envelope).
   - Click Apply Changes.   - Click Apply Changes.
  
Line 91: Line 94:
 If you export your print templates, the export will contain these printer context settings as well. If you export your print templates, the export will contain these printer context settings as well.
  
-====== How to Reconnect Hatch if You Clear Your Cookies ======+====== How to Reconnect if You Clear Your Cookies ======
  
-If you clear your browser cookies without having Hatch installedall of your local settings will be lost. However, if you have Hatch installed and are storing your settings locally with Hatch, you can reconnect to Hatch using these steps and retrieve your settings.+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.   - Log in with a LibraryManager or LocalAdmin account.
-  - Create a workstation and click Use Now to log in again.+  - 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").   - Navigate to Administration > Workstation > Print/Storage Service ("Hatch").
-  - Check all three boxes.+  - Check **only** the 'Use Hatch for Printing' box.
   - Click on the Home icon.   - Click on the Home icon.
   - You will be returned to the workstation registration screen again - click Use Now to log in again.   - You will be returned to the workstation registration screen again - click Use Now to log in again.
-  - Your local settings should now be restored.+  - Your local settings and print configuration should now be restored.
  
-====== Hatch Console Errors ======+====== 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.  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. 
  
-  * [[circ:workstations:troubleshooting|Troubleshooting]]+  * [[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. 
  
admin/workstations/hatch.1528395562.txt.gz · Last modified: 2018/10/11 20:15 (external edit)