Installation Notes

 
Intallation on Macintosh

Q: Is it possible to run Open ModelSphere on Macintosh?
A: Yes, Open ModelSphere can run on a Macintosh computer, as illustrated below:


Open ModelSphere on Macintosh, credits: Cathy Berthouzoz


Q: How can I do to run Open ModelSphere on Macintosh?

1) As Open ModelSphere runs in Java, make sure you have installed a JRE (Java runtime environment) on your machine. 

2) Do not download "Open ModelSphere" with Windows installer, but rather the zipped version (.zip). Unzip the archive.

3) You will have to write a shell script for Mac OS. A shell script is a text file that executes OS commands, in our case launches the JVM (Java virtual machine). Here is an example of a script that launches Open ModelSphere:

openModelSphere.bat_term:

cd /Applications/Open_ModelSphere_971 && java -ms32m -mx1024m -ss16m -classpath "./modelsphere.jar:./resources.zip:./resources;./targets:./lib/jakarta-regexp-1.5/jakarta-regexp-1.5.jar:./lib/velocity-1.6.1/velocity-1.6.1.jar:./lib/jazzy-core/jazzy-core.jar:./lib/jgrapht-all/jgrapht-all.jar:./lib/jython-2.2.1/jython.jar:./lib/velocity-1.6.1/lib/commons-collections-3.2.1.jar:./lib/velocity-1.6.1/lib/commons-lang-2.4.jar:./lib/lablib-checkboxtree-3.0.2.jar:./lib/antlr-3.3-complete.jar:./plugins/bin/repository_functions.jar" org.modelsphere.sms.Application
  
If it does not work, make sure:
  • The script knows where to find the JVM (where the java program is located). 
  • The memory required (-msXX, -mxXX parameters) by the JVM is sufficient.
  • All required archives (.jar) are included in the classpath..
  • Verify the Windows .bat file to make sure all the memory parameters are defined, and all the required archives are listed in the classpath parameter.
  • Use the Unix/MacOS folder separator for "/") (instead of "\" fow Windows) and resource separator ":" (instead of  ";" for Windows).
  • Look at the "Installation on Linux" notes for troubleshooting.

A shell script that launches Open ModelSphere on Macintosh, credits: Cathy Berthouzoz

4) Associate the OMS .ico file to the openModelSphere.bat_term script file (optional).

a) Create an application by using Automator
b) Copy the script command, and save it.
c) Associate the Open ModelSphere icon to the application.
    (In French: http://www.commentquoi.com/comment-changer-icone-dossier-ou-fichier-sous-mac-8675389.html).
d) In the pop-up menu of the application, select "Informations".
e) Select the existing icon and paste the new one.


5) Look at the "Installation on Linux" notes for troubleshooting.

Credits: Luc Poulin, Cathy Berthouzoz