Posted on Wednesday, May 07, 2014 at 05:49PM by David Eby
In a previous blog post we gave some limited instructions for using GenePattern with Mac OS X 10.9 Mavericks. While accessing the public server via web browser is not an issue, installing and running your own GenePattern server is a different matter. Issues with the installer, server launcher, and general responsiveness prevent us from officially supporting this platform right now. We are actively working to address these problems and expect to have a fix in a future version of GenePattern, as soon as is feasibly possible. This is very important to us and is on our immediate agenda.
In the meanwhile, however, we have some new workaround recommendations which should improve your current experience running the GenePattern server on Mavericks.
I'll start off by explaining how to launch GenePattern server for the benefit of those folks who had it installed and working on an earlier version of OS X but then upgraded to Mavericks and ran into the responsiveness issues. We recommend the installer workaround for only advanced - and highly dedicated - users, so I'll set that aside for the moment; those instructions follow afterward.
We have found that the GenePattern server is much more responsive on Mavericks when launched from a Terminal.app command line. We have not done extensive testing but our general impression is that the GenePattern server performs at least as well as it did on previous versions of OS X when launched this way. While doing so is not as simple as using the Start/Stop icons, it is still reasonably easy if you already have Java 6 installed (see below for Java 7 instructions). Just open Terminal.app (found in Applications>Utilities) and issue the following commands:
nohup bin/catalina.sh run &
After this, you should be able to start and stop GenePattern from the Terminal.app command line as described above.
The instructions above assumed that you already had GenePattern installed on your laptop and then went through a Mavericks upgrade. We wanted to help those users who had already gotten stuck in that situation and are willing to employ the workaround (starting/stopping the GenePattern server from the Terminal.app's command line) in order to keep running GenePattern. For Mavericks users who have not yet installed a local server, we recommend that you use our public server instead. As with Java 7, using GenePattern with Mavericks is not yet officially supported and we'd prefer not to encourage other users to reach a point where they need to follow difficult instructions for daily use. Again, we plan to address this in a future release as soon as is feasibly possible.
Having said all of that, however, it is possible to install GenePattern on Mavericks if you would really must. Please, just review the previous instructions first and be sure that you are actually willing to take those steps. Then browse the instructions given below to see if you're comfortable with the process. If any of this looks too difficult or scary, remember that our public server awaits.
Still with me? OK, then here we go...
The first thing to know is that our current installer requires Java 6 (available here). If you are not willing or able to install Java 6, then stop here. We have future plans to release GenePattern with a new installer that does not have the Java 6 dependency.
After downloading the installer from our website, if you decompress and try to run it on Mavericks you will get a popup error claiming that the file is damaged:
The file is not actually damaged; this is a Mavericks security measure. To work around this:
At the end of the installion prcoess, the GenePattern server will be automatically started behind the scenes. Note that this may be painfully slow as it is being started by the same mechanism as the StartGenePattern.app icons and suffers the same problems. I suggest that you go get a coffee, tea, or other beverage of your choice at this point while allowing this to complete. Hopefully when you return the server will be running. My recommendation is that you immediately shut down the server before proceeding. You can use the StopGenePatternServer.app icon but this will also be painfully slow for the same reason. You can instead stop it from the command line or by using the usual Quit or Force Quit commands.
Restart the server using the instructions in the previous section. Now it should perform much better, starting up and changing pages far more responsively.
After you have finished installing a Registration screen will appear. This may not succeed:
If that happens to you, add the following line to your <GP_HOME>/resources/genepattern.properties file:
Then stop and restart the server as before. This will skip the registration process when you load the GenePattern main page. You will need to register a new user before logging in.
From this point on, the server should function normally.
Again, remember that Mavericks is not yet a supported platform for installing GenePattern and has not yet been well tested. If you have any doubts or concerns then perhaps it would be better to wait for an official release; we are actively working on this. If you decide to try and run into any problems, please let us know and we will do our best to address them.