UltraScan III Troubleshooting Tips:

Known Problems:

I can't connect to my LIMS database from work, but it works from home
Your institution censors a public service offered by our UltraScan Science Gateway. There is absolutely no risk to the institution by you using our services, yet, some institutions blanket block any services running on ports higher than 1024. You will need to talk to your IT and networking group and request that your network rules allow outside access of port 3306 on the LIMS user you are using. The servers you use depends on your geographical location. If you are in the Americas, you will need to allow access to:
- uslims3.aucsolutions.com:3306
- alamo.uthscsa.edu:3306
If you are in Europe or Middle East, you will need to allow access to:
- uslims3.fz-juelich.de:3306

uslims3.mbu.iisc.ernet.in:3306

uslims3.latrobe.edu.au:3306

outbound

Macintosh OSX: Help system is not coming up.
This error may result from incompatible Qt library components. It can be fixed as follows:
1. close down UltraScan, if open.
2. open a terminal window and type the following:
```
cd /usr/lib
sudo rm libQtCLucene.4.dylib  libQtCLucene.dylib  (this will prompt for your admin password)
cd /Applications/ultrascan3/lib
sudo cp libQtCLu* /usr/lib/
```
After doing that, restart UltraScan and try any Help menu item from within US3.

Macintosh OSX: Database Connection Error when trying to load Project
This is related to a problem with shared memory not being large enough on some Macs. To fix this, follow these instructions:
- Open a Terminal window and type the following:
```
> cd /Applications/ultrascan3/etc
> sudo cat sysctl.conf >> /etc/sysctl.conf (this will prompt for your admin password)
```
- Reboot your Mac and retry the projects steps
Cannot complete Registration (due to Network Failure During Registration)
If you are subject to a corporate network firewall that may be blocking certain ports, you may want to try registering on an unblocked network (for example, a home broadband connection with the firewall disabled). UltraScan-III requires unhindered access to the ultrascan.aucsolutions.com port 80 http connection in order to complete the registration process.
If this doesn't help, read on: If the network is somehow blocked or unavailable during the registration process, there could be a mismatch between the information available on the license server (remote) and the information stored locally on your own computer. In this case, the easiest fix is to delete the local information and try again from another network connection that is not blocked by firewalls or lack of privilege. This situation most often occurs in corporate environments where firewall restrictions are extreme. In such a case, taking your laptop to an open network (say, at home) will often permit the registration to proceed unimpeded. The process required to reset the registration on your local system varies according to operating system:
- Linux:
  open a shell window and remove the UltraScan3 entry in your $HOME/.config directory:
```
rm -r $HOME/.config/UltraScan3
```
  and then re-register on a validated network
- Macintosh:
  The UltraScan-3 registration information is normally stored in your home directory under Library/Preferences/com.ultrascan3.UltraScan.plist. All you need to do is to remove this file. Open a Terminal window (located in Applications) and issue this command at the command line:
```
   rm ~/Library/Preferences/com.ultrascan3.UltraScan.plist
```
  If you installed UltraScan for all users, you may need to use 'sudo' to remove the entry from the system directory in /Library/Preferences:
```
   sudo rm /Library/Preferences/com.ultrascan3.UltraScan.plist
```
  Now reboot your computer and then you can try to re-register on a validated network.
- Windows:
  You will need to use the registry editor from Windows to remove the UltraScan-III entry. Open the regedit.exe application and find the UltraScan-III registration entry, delete it, and then re-register on a validated network.
  Specifically, open a Command Prompt window (from your Start menu) and type "regedit" in it.
  This will open a new window with the Registry Editor in it. Along the left side is a tree view of entries. You want to navigate to:
  If you click on the lowest level ("UltraScan"), you should see your present settings in the large pane on the right of the window. If you right-mouse-click on "UltraScan", you can release on the "Delete" menu item; and all your settings will be removed. You should be able to re-register then.
  Note: This fix also can be used if you forgot your master password.