Mac OS X Basics



OS X Versions 10.10, 10.9, 10.8, 10.7 and 10.6 Supported

10.5.8 ONLY with Java 6 Installed on Intel Based Mac

NOTE: OS X 10.6 and 10.5 are technically no longer supported by Apple

Java 6 is also no longer supported by Oracle


Mac OS X Versions Supported

Mac OS X versions supported:  10.10 Yosemite, 10.9 Mavericks, 10.8 Mountain Lion (use Java 8 from Oracle or our native installer) 10.7 Lion (which should use Java 7 from Oracle) and 10.6 Snow Leopard (which uses Java 6 installed in OS X, however 10.6 is technically no longer supported by Apple).  The latest Java version should be installed (Java 8 Update 25 or Java 7 Update 71 as of 10/28/14).  OS X 10.5.8 is only supported if Java 6 is installed, which is only on Mac systems with an Intel Core 2 Duo or higher Intel processor.  OS X 10.5.8 systems on Intel Core Duo processors should upgrade to OS X 10.6 (a $19.99 update from Apple), however older 10.5 and 10.4 systems on PowerPC (PPC) processors are no longer supported by Apple.


OS X Startup For First Time Users

OS 10.8 and higher:  Initial install of ROES should be done via our native installer, a launch.dmg file, via the base index page for a ROES lab Client ( should bring up the page, where roesname should be replaced with the specific lab name or ROES brand).  On a Mac the index page will show only OS X specific instructions and links.  The launch.dmg file should be downloaded and opened from Downloads, then double click on the .app file shown to begin the install (be sure to minimize any open apps at that time to make sure any prompts or download progress dialogs are shown).


For OS X 10.7 and 10.6:  From your lab’s web site you should see the base index page for a ROES Client ( should bring up the page, where roesname should be replaced with the specific lab name or ROES brand).  On a Mac the index page will show only OS X specific instructions and links.  There will be specific mentions for a 10.7 or 10.6 install using the launch.jnlp file.


Note: In June 2013, Apple released updates for OS X that increased security for Java applications, essentially preventing applets from executing normally.  The launch.jnlp file that starts ROES is not called due to the security changes, so the following steps should be done from the index page that appears in the browser.  Find the Direct launch link in the page, right click, two finger press/click or Control-click on it, choosing Download Linked File As... from the list that appears. In the dialog that opens at the top, select either Documents (should appear as the default) or Downloads if desired and save the launch.jnlp file there. Using Finder, open Documents (or Downloads) and right-click/two finger click/Control-click on the launch.jnlp, then choose Open.

In newer editions of OS X, especially 10.8.4 and higher, a new window will open to approve executing the file (doing so will start the ROES download and install). A video of this new startup procedure can be found here. Once this initial download and install occurs, you should receive a desktop icon to access ROES in the future.


Image Files Are Grayed Out In Folder Dialog


Image Files Are Grayed Out In Folder Dialog 

OS X differs from Windows slightly in choosing images to work with.  In ROES you should always choose a folder of images, however in Windows you can click on an image inside a folder and it will load all the images in that directory (and possibly sub-directories).  In practice one should always stop at the folder level and choose the folder, selecting it and filling that folder’s images into the thumbnail area.  A common mistake in OS X is to click too far and go into the folder, where the images are not available to select.  Simply go back up a level, highlight the folder and click Choose. 



Where is the .roescache folder in OS X?!?!

Where is the .roescache folder in OS X?

Folders starting with a period, like the .roescache folder, are hidden in OS X.  To access these hidden folders, you must do a direct go to via Finder.  Open Finder and choose Go from the top menu, then choose Go to folder from the list.  In the dialog that opens, enter:




Press Enter and the folder’s contents will appear in a Finder window.  You can select all and delete the contents to clear it if needed.  You can also access the ‘.labname’ folder the same way.  Each ROES Client launch will have its’ own ‘.labname’ folder for storage of preferences, old orders, auto-saved orders, packages, customer data and saved Pager templates.


OS X Java Settings/Cached Applications Viewer/Java Console

OS X Java Settings/Cached Application Viewer

OS X 10.8, 10.9 and 10.10 should use Java 8 from Oracle now (Java 7 in OS X 10.7), so the Java Control Panel is available from System Preferences by opening Java.  The General tab at the bottom will have a Temporary Internet Files section from which you can click View to see installed Java applications and a button for Settings, which will offer a new dialog where the Delete button will allow the Java cache to be cleared (be sure to check all boxes).  The Advanced tab will have various preference and security areas, including shortcut prompt settings and whether or not to run the Java console.  For better troubleshooting of startup issues, expand the console group via the plus sign and select Show Console, then OK out and try launching ROES.  The console text can be very helpful in resolving launch failures.


To access the Java Control Panel in OS X 10.6, open Finder and click Applications.  Click Utilities in the list, then find and run Java  The opening pane will show the Java versions installed, and list Java 6.  In newer editions of OS X the Network tab will have buttons for the Cache to view the settings and delete the Java temporary/cache files or view the cached applications (you can delete individual applications and create desktop shortcuts in the Cache Viewer).