User Tools

Site Tools


admin:workstations:troubleshooting

Troubleshooting

Follow the steps on this page to verify that your software is up to date and configured correctly, and to collect console messages that support staff will ask for if you need to submit a Helpdesk ticket.

If you click on any of the screenshots below, it will show you the screenshot in full size.
If you have used the Offline Circulation module and have transactions that you are unable to upload from the workstation they are on, make sure you export the transactions before clearing cookies/cache.

Refresh Screen / Restart Browser

Some issues, such as slow page load times while checking in a large stack of items, may be resolved by simply refreshing the screen using the browser's refresh/reload button.

Other issues, such as a login screen appearing in an embedded frame, may be caused by timeouts and can most easily be resolved by closing and reopening the browser.

If neither of these actions correct the problem you are seeing, continue to the next section.

Check Browser Configuration

1. Make sure your browser is up to date.

In Chrome:

  1. Go to Menu (3 vertical dots in upper-right corner of browser window).
  2. Select Help.
  3. Select About Google Chrome.
  4. You should see a message saying “Google Chrome is up to date.”
About Chrome

In Firefox:

  1. Go to Menu (3 horizontal lines in upper-right corner of browser window.)
  2. Select Help.
  3. Select About Firefox.
  4. You should see a messaging saying “Firefox is up to date.”
About Firefox

2. Make sure pop-ups are enabled.

In Chrome:

  1. Go to Menu (3 dots on upper-right).
  2. Select Settings.
  3. Click on Privacy and Security.
  4. Click on Site Settings.
  5. Click on Pop-ups and Redirects. (You can also get to this screen by entering chrome://settings/content/popups in your address bar.)
  6. The default Popups setting should be “Don't allow sites to send pop-ups or use redirects.”
  7. Click the Add button next to “Allowed to send pop-ups and use redirects.”
  8. Type in: [*.]gapines.org
  9. Click Enter.
Pop-ups in Chrome

In Firefox:

  1. Go to Menu (3 lines on upper-right).
  2. Select Settings.
  3. Click Privacy & Security. (You can also get to this screen by entering about:preferences#privacy in your address bar.)
  4. Scroll down to the Permissions section.
  5. “Block pop-up widows” should be checked.
  6. Click the Exceptions button.
  7. Click Save Changes.
Pop-ups in Firefox

3. Make sure cookies are allowed.

In Chrome:

  1. Go to Menu.
  2. Select Settings.
  3. Scroll down to the bottom and click Advanced.
  4. In the Privacy and Security section, click Content Settings.
  5. Click Cookies. (You can also get to this screen by entering chrome://settings/content/cookies in your address bar.)
  6. “Allow sites to save and read cookie data” should be on.
  7. “Keep local data only until you quit your browser” should be off.
  8. Click ADD next to Allow.
  9. Type in: gapines.org
  10. Click Enter.
Cookies in Chrome

In Firefox:

  1. Go to Menu.
  2. Select Options.
  3. Click Privacy & Security. (You can also get to this screen by entering about:preferences#privacy in your address bar.)
  4. In the History section, choose the option for “Firefox will… Use custom settings for history.”
  5. “Remember my browsing and download history” should be checked.
  6. “Accept cookies from websites” should be checked.
    1. Alternatively: If you uncheck “Accept cookies from websites” then you must click Exceptions and add https://gapines.org
Cookies in Firefox

Security Software and Cookies

If you have cookies enabled in your browser, but they are disappearing, check your computer's security / antivirus software to see if it may be deleting your cookies on a regular basis.

Verify Software Versions

This section is only relevant if you are using Hatch.

1. Operating System

Hatch is only supported on 64-bit Windows 10 at this time. Windows 7 is no longer being supported by Microsoft. To find your version:

  1. Click on the Windows Start button.
  2. Right-click on Computer.
  3. Click on Properties.
Example of Windows Properties

2. Java

Verify that the Java Runtime Environment (JRE) is up to date. If you are unsure which version you have, view your computer's list of programs or simply download and install the latest version from:

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

Example list of computer programs

You can also check to be sure that your operating system is able to find the path to Java:

  1. Open up a command window (Start Menu, type in cmd).
  2. Type in: java -version
  3. You should see the Java version number listed. If there is a problem, you will see an error message. (The solution to this is usually to uninstall whatever version of Java you have, and then install the correct version.)
Check Java path

3. Hatch Program

Verify that you are running the current version of Hatch. You can see this from your computer's list of programs (Control Panel > Uninstall or change a program).

4. Hatch Extension

Verify that you are running the correct version of the Hatch Chrome Extension (in Chrome) or Add-On (in Firefox). The current version is available for download at: https://evergreen-ils.org/egdownloads/

In Chrome:

  1. Go to the Menu.
  2. Select More Tools.
  3. Select Extensions.
  4. Scroll down to Hatch Native Messenger.
  5. Verify that the version is current.

In Firefox:

When the Hatch Extension is installed and enabled, a small icon should appear in the top-right corner of the browser:

Hatch Icon

5. Verify that Hatch is communicating with Java

  • Open up a command window (Start Menu, type in cmd).
  • First, enter this (followed by pressing Enter):
cd %ProgramFiles(x86)%\Hatch
  • Then, enter this (followed by pressing Enter):
hatch.bat test

The response will tell you if it tested successfully or if Hatch is having a problem communicating with Java on your system.

Clear Cache

Follow these directions to clear your browser cache:

In Chrome:

You can copy and paste this into the address bar of your browser:

chrome://settings/clearBrowserData

Or…

  1. Go to Menu.
  2. Select History (on main menu).
  3. Select History (on flyout menu).
  4. Click on Clear Browsing Data.
  5. Set Time Range to All Time.
  6. Check the box next to “Cached images and files” (other boxes can be left unchecked).
  7. Click Clear Data.
Clearing Cache in Chrome

In Firefox:

You can copy and paste this into the address bar of your browser:

about:preferences#privacy

Or…

  1. Go to Menu.
  2. Select Options.
  3. Click on Privacy & Security.
  4. Scroll down to the section for Cookies and Site Data.
  5. Click the Clear Data button.
  6. UNCHECK the Cookies and Site Data option, and check the Cached Web Content option.
  7. Click Clear.
Clearing Cache in Firefox

Clear Site Cookies

If you log in and see a blank page with the green bar across the top (aka, the “white screen of death”), but nothing else will load, you may need to clear your browser's cache and selected site-specific cookies.

Before you clear cookies, be aware that doing so will cause you to lose your registered workstations and the settings associated with those workstations. If you register a new workstation with the same name as the previous workstation, most of your settings will be retrieved.

In Chrome:

To clear cookies for a specific site:

  1. Go to the site you want to clear cookies for (eg, gapines.org).
  2. Click the lock icon to the left of the URL.
  3. Click Cookies and site data.
  4. Click Manage on-device site data.
  5. Click the trash can icon next to the site you'd like to clear cookies for, and then click Done.
  6. You will be prompted to register a workstation when you next log in. Workstation registration is limited to LocalAdmin, LibraryManager, and CatCoord accounts. If you register it using the same workstation name that was previously used, then most settings will be restored.

In Firefox:

To clear cookies for a specific site:

  1. Go to the site you want to clear cookies for (eg, gapines.org).
  2. Click the lock icon to the left of the URL.
  3. Click the option under Site information.
  4. Click on More information.
  5. Under Security > Privacy & History, click Clear Cookies and Site Data.
  6. You will be prompted to register a workstation when you next log in. Workstation registration is limited to LocalAdmin, LibraryManager, and CatCoord accounts. If you register it using the same workstation name that was previously used, then most settings will be restored.

If you are using Hatch:

You may need to reconnect Hatch after clearing cookies.

Retrieve Console Messages

If you are having problems, please include screenshots and error messages from the console(s).

Chrome Console Messages:

  1. Go to Menu.
  2. Select More Tools.
  3. Select Developer Tools. (This will open a pane on the right side of your browser.)
  4. Select the Console tab.
  5. Change the “Default” dropdown to be sure that Verbose is checked.
  6. Either take a screenshot or copy and paste the text that appears in the console when you see the errors occurring. Be sure to include any of the errors that display in red.
Console Messages in Chrome

Hatch Extension Console Messages:

  1. In Chrome, go to Menu.
  2. Select More Tools.
  3. Select Extensions.
  4. Check the box at the top of the screen that says Developer Mode.
  5. Scroll down to Hatch Native Messenger.
  6. Click on the link that says “background page.” (This will open a new window.)
  7. Select the Console tab.
  8. Change the “Default” dropdown to be sure that Verbose is checked.
  9. Either take a screenshot or copy and paste the text that appears in the console when you see the errors occurring. Be sure to include any of the errors that display in red.
Hatch Console Messages

Firefox Console Messages:

  1. Go to Menu.
  2. Select Web Developer.
  3. Select Web Console. (This will open a pane across the bottom of your browser.)
  4. Click on the Console tab.
  5. Either take a screenshot or copy and paste the text that appears in the console when you see the errors occurring. Be sure to include any of the errors that display in red.
Firefox Console Messages

Console Error: Database Connection

If you still have a white screen after clearing cookies and cache, and the browser console is giving an offline database connection error, it is possible that the local database has become corrupted. You can delete this database and the system will rebuild it the next time you log in.

In Chrome:

  1. Click Ctrl+Shift+I (alternatively, click on Menu > More Tools > Developer Tools).
  2. Switch to the Application tab.
  3. Expand the Indexed DB section.
  4. Click on the “offline - https://gapines.org” section.
  5. Click the Delete database button.
  6. Click the X in the upper-right corner of the section to close the tool frame.
Clearing database in Chrome

In Firefox:

  1. Click Shift+F9 (alternatively, click on Menu > Web Developer > Storage Inspector).
  2. Expand the Indexed DB section.
  3. Expand the https://gapines.org section.
  4. Right-click on “offline (default)” and click the Delete option.
  5. Click the X in the upper-right corner of the section to close the storage inspector frame.
Clearing database in Firefox
admin/workstations/troubleshooting.txt · Last modified: 2024/09/04 19:57 by smorrison