Using the SBGrid Environment
Support for Site Administrators
Hardware Support Notes
Support for Developers
SBGrid software is compatible with macOS 10.15 Catalina and macOS 11 Big Sur, with the exception of 32-bit software. Initial activation of an SBGrid installation requires a reboot after account activation to accomodate macOS filesystem controls in the / partition. This step is only needed after the initial account activation.
The latest versions for the SBGrid Installation manager (GUI and CLI) will handle the creation of the required /etc/synthetic.conf file automatically on activation.
For users that have upgraded to Catalina or newer, the /etc/synthetic.conf file needs to be created manually.. See below.
A reboot is required for /etc/synthetic.conf to take effect.
Once the activation process is completed and the system has been rebooted, the manager can be used normally.
Notes on recent macOS changes :
Users who have upgraded to Catalina or newer from a previous macOS release will need to create the /etc/synthetic.conf file manually.
SBGrid requires the
/programs path to run software. The lastest MacOS does not allow symlinks to be created in the root partition ( under / ), but provides the option to create links in the root partion via the /etc/synthetic.conf file.
This file has the following format:
Note that the whitespace MUST be a tab character. Spaces will not work. Here is a file for reference : synthetic.conf. Thanks to Ron Rock at University of Chicago for pointing this out.
You can download this file to the proper location on your machine with these two commands:
sudo /usr/bin/curl -k https://sbgrid.org/wiki/downloads/synthetic.conf -o /etc/synthetic.conf
Then you MUST REBOOT the computer for the changes to take effect. You should then see this in your root partition (/) :
$ ls -l /programs lrwxr-xr-x 1 root wheel 11 Jun 4 14:49 /programs -> /opt/sbgrid
From there, you can continue to install software with the installation manager, or use the GUI. They are not mutually exclusive.
In rare cases, it may be desirable to disable Apple's System Integrity Protection. For reference, we have included the process to do that here.
If SIP is disabled, it is possible to remount the filesystem as read/write. This is not required to use SBGrid, but for reference we have included the instructions here.
sudo mount -uw /
It is possible to turn off the nagging pop ups.
sudo softwareupdate --ignore "macOS Catalina"
You will see :
Ignored updates: ( "macOS Catalina" )
You can reverse this later by running :
sudo softwareupdate --reset-ignored