- 10.10+: Install emergent_install_mac_deps-8.5.1.dmg (note: this release uses new 8.5.1 dependencies -- you must update!) and then:
emergent-8.5.2-11409-mac64.dmg. After downloading, right click and select open.
- optional long-term-support (LTS) emergent7 compatibility package for old sims: emergent-7.1.0-11409-mac64.dmg (depends on 8.5.2 install)
Opening unsigned packages
Hold down the control key when you click on the package file, then select Open from the popup menu, and then click on the Open option. If you don't do this, you get an opaque message about the package not being trusted..
TODO: is this needed??
Dependency Installer Script Issues
There are various issues that can arise from the
- You need to enter your password in the terminal that opens when you run it! You need to click in the terminal window after Password: and then type in the same password that you use when you login to your Mac after a restart. This is necessary to engage "root" or "superuser" permissions, which is required for installing the dependencies -- furthermore, your account on the computer must have Administrator permissions. You can check this by going to Users & Groups in System Preferences and seeing if you have Admin after the Current user account name. Google this if you don't know what this means, or if you get an error message like this:
'username' is not in the sudoers file. This incident will be reported.
As of version 8.5 the script relies extensively on Homebrew for installing dependencies -- carefully look at the terminal window output to see if there are errors at the end of the process -- unfortunately it outputs a lot of stuff and it does multiple passes to attempt to overcome various issues that might arise. One possible error:
Some /usr/local subdirectories need to be owned by user for brew link to work-- this indicates the same sudo / Administrator issue per above.
Library not loaded errors
If emergent doesn't run when you click on it in Applications, try to run from Terminal.app, so you can see the error message:
If you get this kind of error:
dyld: Library not loaded: @rpath/QtOpenGL.framework/Versions/5/QtOpenGL Referenced from: /usr/local/bin/emergent Reason: image not found Abort trap: 6
Then the Qt package did not install properly -- the most common cause of this is that the full Qt package failed to download properly (it is big) -- you can just manually re-download the package from here: https://grey.colorado.edu/emergent_ftp/ -- current one is
qt5931_mac64.dmg, but it is best to sort by the modification date and get the most recent such one in case we forget to update this page (likely). Then just open that package and install it like you would any such package. Then try re-running emergent per above. The other package that might have failed to install is coin: e.g.,
If emergent seems to have installed correctly, but you are unable to run it, the problem could be a permissions issue. Possible symptoms are:
- Getting an error message such as "You can't open the application emergent.app because it may be damaged or incomplete",
- A stop sign on top of software icon, which typically indicates it's not for this version of OS X,
- Getting this kind of response when trying to run emergent from the terminal:
$ emergent -bash: emergent: command not found $ which emergent $ ls /usr/local/bin ls: bin: Permission denied
This might happen if your account is not an administrator account. To fix, do this:
$ cd /usr/local $ sudo chmod -R +rX bin # Case sensitive!!
If you get an error such as this:
$ emergent dyld: Library not loaded: Inventor.framework/Versions/C/Inventor Referenced from: /usr/local/bin/emergent Reason: image not found Trace/BPT trap
The problem might be that you need to run the emergent_install_deps script to get the relevant dependencies.
If you can't start emergent from a Terminal window by typing emergent, it is probably because /usr/local/bin is not in your path. To check:
$ echo $PATH /sw/bin:/sw/sbin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/opt/X11/bin:/usr/X11/bin:/usr/X11R6/bin $ cat /etc/paths /usr/bin /bin /usr/sbin /sbin /usr/local/bin
If you don't see it when you type those commands, add it:
$ sudo bash -c 'echo /usr/local/bin >> /etc/paths'
Then restart your Terminal and emergent should be accessible from the command line. This will also allow you to compile plugins from within emergent, since maketa is also located in /usr/local/bin.
- Build Mac Homebrew -- uses the homebrew packaging system to handle all the dependency libraries. As of version 8.5 we now do this for all but Qt and Coin.
- 10.8 / 10.9, 10.10: Install emergent_install_mac_deps-7.0.0.dmg (note: this release uses same dependencies as 7.0.0 -- no need to re-install) and then either emergent-7.0.1-7737-mac64.dmg (10.9, 10.10) or emergent-7.0.1-7464-mac64-10.8.dmg (10.8). After downloading, right click and select open.
- 10.7: Only 6.3.2 is avail: Install emergent-6.3.2-6447-mac64-lion.dmg, qt-mac-opensource-4.8.2.dmg and Subversion-1.7.13_10.7.x.pkg.
- 10.6 32 bit: only 6.1.0 is avail: Install emergent-6.1.0-5751-mac32.dmg