Frequently Asked Questions

1. What are the minimum system requirements for running OCHRE?

OCHRE is a Java application that requires the Java Runtime Environment (JRE) which comes preinstalled on most desktop and laptop computers. OCHRE requires a high-speed Internet connection, at least 1 GB of main memory, and a screen resolution of at least 1,024 x 768 pixels.

2. How do I get the latest version of Java?

On a Windows-based system you can check that your Java installation is up-to-date, or install the latest version, at http://java.com. On an updated Mac OS X system, go to the System Preferences, Java, Update tab. On older Macs, make sure your "Software Updates" are up-to-date and check out http://java.com/en/download/faq/java_mac.xml for more answers.

3. Why are there so many different links for starting OCHRE? Which one should I use?

OCHRE is a cross-platform application and can look very different depending on which operating system it is running on. A specific theme, or look-and-feel (LAF), can help make OCHRE feel more natural, or familiar, in one environment or another. Choosing which one to use is simply a matter of personal preference. They are all functionally equivalent. Note, however, that all of the links under the Cross-platform Themes heading require a minimum of 4 GB of RAM installed, and the 64-bit version of Java, in order to run.

4. Why am I asked to accept security certificates when I launch OCHRE?

You will be asked to accept two separate security certificates. The first certificate indicates that OCHRE is a valid program that you can trust, delivered securely from the University of Chicago's server. The second prompt requests that you accept the use of a software library needed by OCHRE and provided by Software AG, the company behind the Tamino database system that drives OCHRE. These are trustworthy libraries and should be accepted. You can tell your browser to "Always accept" these certificates so that you won't be asked again.

5. When I click the link to launch OCHRE it appears to download but then nothing happens. What now?

Sometimes your browser isn't set to recognize the file being activated from the OCHRE link. This file, a "Java Web Start" (.jnlp or .jsp) will normally be downloaded and will run automatically. It will also ensure that you are loading the very latest version of OCHRE. You may need to tell your browser what program to associate with this file. This can be a particular problem when running Firefox on a Mac OS system. You can adjust Firefox's "file association" settings under Preferences to indicate that Java Web Start files need to be opened using "Java Web Start."

Firefox assoc jnlp.jpg

Under Safari on the Mac, clicking any of the OCHRE launch links triggers a download that is listed under the Downloads button, normally located in the top-right corner of the Safari window. Click the Downloads button to view the list then double-click on the ochre jnlp or jsp file (which should be at the top of the list) to activate the download and start up OCHRE.

Safari download.jpg

6. OCHRE seems to download but then I get an error that says "Unable to launch the application." What now?

OCHRE keeps some temporary information, usually associated with a desktop shortcut, in a "cache" on your hard drive to speed up access. Sometimes the information in your local cache gets out-of-sync with the information being downloaded, or with the current Java version. To solve this problem you need to empty your cache and start fresh from the OCHRE link. To do this, go to the Java Control Panel. On the Mac this is under System Preferences, Java; on Windows systems the Java option is on the Control Panel. Find the Settings... button under Temporary Internet Files on the General tab. Go ahead and Delete Files; only temporary, Java-related files will be deleted. Once this is complete, please launch OCHRE fresh from this link or from a link for the look-and-feel of your choice on the sidebar.

7. Is my data secure in OCHRE?

All data entered in OCHRE is managed by the project to which it belongs. Access is restricted to users with usernames and passwords as controlled by the project administrator, unless the project has made some of its data available through a "public view." All data transfers to and from the server are made over a secure connection.

8. Is my data in OCHRE backed up?

Our database server is professionally managed by the Digital Library Development Center at the University of Chicago. Backups are made nightly (late night, Chicago time (CST)) and are managed under the strict policies of the DLDC.

9. Do I need to download and install special fonts to view OCHRE data?

Users do not need to install any of the special fonts used by OCHRE. When a project starts up, OCHRE dynamically loads into memory any fonts necessary to view that project, as determined by the project's "preferences" set in OCHRE. These fonts do not install locally on your computer. If a project uses a special cuneiform, hieroglyphic, or transliteration font, OCHRE derives what it needs from the font loaded into memory and displays any special characters properly to the end-user. In some cases where a user has a locally installed font that is an older version of a font being used by OCHRE, this local font can interfere with the display. If you find yourself in this situation, please contact us and we will provide the needed version of our font(s). See this wiki article for more information regarding OCHRE and fonts.

10. I am getting an "Access violation" message when working in OCHRE. How do I avoid this?

This error suggests that you have not been assigned sufficient user privileges to accomplish the type of work you are trying to do. For example, you may have "view-only" authority but you are trying to edit data. Please contact your project administrator (or contact us if necessary) to have your User privileges adjusted appropriately.

11. What do I do if the Java Virtual Machine Launcher reports that it "could not create the Java Virtual Machine"?

This usually means that you have a java version installed that is not compatible with the version of the operating system that you are running. Please go to http://java.com and reinstall java. Contact us if you need additional help. See also this trouble-shooting information.

12. I have lost the desktop shortcut for OCHRE. How do I get a new one?

If you are running under Windows, go to the Java Control Panel, accessed via the Java icon on the Control Panel (under "Programs" on Windows 8). From the "General" tab of the Java Control Panel click the "View..." button (under "Temporary Internet Files"). This will display the Java Cache Viewer which lists the installed Java applications. Select the OCHRE application then click the "Install shortcuts" menu button. This will place a shortcut to OCHRE on your desktop. (Go ahead and close the control panels.) If the shortcut does not display the OCHRE icon, right-click on the shortcut and view its Properties. Click the "Change Icon..." button and select the OCHRE icon from the list. You may need to run OCHRE from the shortcut (double-click it) in order for the icon to update.

FAQ, Java install shortcut, small.jpg

Note: If there are multiple instances of the OCHRE application listed, delete those first using the X option, otherwise a rogue out-of-date (cached) shortcut might prevent the creation of a new one. If you don't know which is the current, correct version of the application, delete them all then get a fresh download from one of the startup links on the OCHRE home page.

13. My Mac won't open OCHRE "because it is from an unidentified developer." How do I tell it to trust OCHRE?

The Mac OS X "Gatekeeper" is protecting your Mac more aggressively from applications downloaded from the Internet and is encouraging all applications to be delivered via the Mac App Store. OCHRE is not yet available through the Mac App Store so it is not "trusted" by default. You will need to change your security preferences to allow applications downloaded from "Anywhere" to run on your computer. Alternatively, if you Control-click (or right-click) on the OCHRE launch link (depending on your Mac OS version) you may be prompted to confirm that you want to Open the application anyway. Otherwise, go to System Preferences and choose the Security & Privacy option. On the General tab you should have the option to "Open Anyway" the OCHRE application. For more details, see Apple's instructions at: http://support.apple.com/kb/HT5290.

14. What does the "Application Blocked" message mean?

If you see the following message "Application Blocked by Security Settings" it means that your version of Java is out-of-date or that you are using an older version of OCHRE. Oracle, which delivers Java, has recently tightened security requirements for running Java applications, and as of January 14, 2014, Oracle/Java is enforcing this additional level of security and requiring all applications to be compliant. To run compliant applications such as OCHRE you need to upgrade at least to Java version 7_51. See FAQ #2 above if you need help installing the latest version of Java. You should also delete all desktop icons or menu shortcuts associated with previous versions of OCHRE, and download OCHRE fresh from one of the launch links on our website. If you have trouble upgrading you may also need to clear out old versions of java as described in FAQ #6.

FAQ, Java 7 blocked_0.jpg

15. Do I need to add OCHRE to the list of site exceptions in Java?

A recent Java update may require you to add OCHRE to the list of site exceptions in Java. Open the Java configuration panel (from the Control Panel or System Preferences) to the Security tab and add the OCHRE web address https://ochre.lib.uchicago.edu to the list, as follows:

Add_Java_Exception_1.PNG

16. What is Tamino and should I trust it?

Tamino is a high-end database system provided by Software AG that underlies the OCHRE application. It was "the industry's first native XML server" and "an ideal platform for efficiently managing both structured and unstructured data" (from their website). When OCHRE first starts up you will be asked to "accept the risk" of enabling Tamino. Check the box to agree to do so. Better yet, also check the box requesting that the security warning not be shown again.

Website FAQ Tamino security.JPG

17. Which fonts does OCHRE support?

OCHRE supports the use of any Unicode font. Each project can decide which font it prefers, based on characters needed for the project. The OCHRE Data Service can advise which fonts might best serve your project. We have extensive experience working with transliteration of various languages. For the transliteration of ancient languages, we tend to use a modified version of the Gentium font.

18. Can I take advantage of extra RAM on my computer?

Yes, currently up to 4 GB, but you need to make sure that you are running the 64-bit version of Java. On an up-to-date Mac you probably are -- make sure your Software Updates are current (on an older Mac you probably can't anyway). Under Windows, go to your System Settings, Add or remove Programs app (or Control Panel, Programs and Features) and look for a "Java ..." program. Make sure it is labeled as "64-bit." If not, Uninstall/Remove it and install a 64-bit version instead. (Note that subsequent automatic updates pushed by Java will correctly install an appropriate 64-bit version.) Then use any of the High Memory Allocation links from the Launch panel of the OCHRE home page. These high memory allocation links will not work if you do not have at least 4 GB of RAM and a 64-bit version of Java.

Install a 64-bit version of Java

64-bit version.JPG