e7d645066f9100f97ba27c1dc2d8cbcc630aa6a4
catalina.md
... | ... | @@ -1,10 +1,12 @@ |
1 | 1 | # Using SBGrid with MacOS 10.15 and later |
2 | 2 | |
3 | -SBGrid software is largely compatible with macOS 10.15 *Catalina* and macOS 11 *Big Sur*. |
|
4 | -Initial activation of an installation requires a reboot after account activation. This is necessary to accomodate macOS filesystem controls in the / partition. |
|
5 | -This is only needed after the initial account activation. |
|
3 | +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. |
|
6 | 4 | |
7 | -**The latest versions for the SBGrid Installation manager (GUI and CLI) will handle the creation of the required '/etc/synthetic.conf' file automatically. A reboot is required after the activation step, but no other action should be required.** Previously, the step was a manual operaion. |
|
5 | +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. |
|
6 | + |
|
7 | +For users that have upgraded to Catalina or newer, [the _/etc/synthetic.conf_ file needs to be created manually.](#manual-creation-of-the-programs-path). See below. |
|
8 | + |
|
9 | +**A reboot is required for /etc/synthetic.conf to take effect.** |
|
8 | 10 | |
9 | 11 | For Activation instructions, see: |
10 | 12 | [Command line : https://sbgrid.org/wiki/sbgrid-cli](https://sbgrid.org/wiki/sbgrid-cli) |
... | ... | @@ -19,18 +21,10 @@ Notes on recent macOS changes : |
19 | 21 | - [More details about compatibility with the latest macOS and Apple hardware can be found here](big-sur) |
20 | 22 | |
21 | 23 | |
22 | ------ |
|
23 | -** |
|
24 | -The steps outlined below are not typically required but are included for reference.** |
|
25 | - |
|
26 | -- [Using SBGrid with MacOS 10.15 and later](#using-sbgrid-with-macos-1015-and-later) |
|
27 | - - [Manual creation of the programs path](#manual-creation-of-the-programs-path) |
|
28 | - |
|
29 | -### Manual creation of the programs path |
|
24 | +### Manual creation of the programs path ( after macOS upgrade ) |
|
30 | 25 | |
31 | -This process is not typically required with the latest versions of the SBGrid Installation manager, but we have provided the instructions here for reference. |
|
32 | - |
|
33 | -The lastest MacOS provides the option to create links in the root partion via the _/etc/synthetic.conf_ file. |
|
26 | +Users who have upgraded to Catalina or newer from a previous macOS release will need to create the _/etc/synthetic.conf_ file manually. |
|
27 | +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. |
|
34 | 28 | This file has the following format: |
35 | 29 | |
36 | 30 | ``` |
... | ... | @@ -43,12 +37,11 @@ Thanks to Ron Rock at University of Chicago for pointing this out. |
43 | 37 | |
44 | 38 | You can download this file to the proper location on your machine with these two commands: |
45 | 39 | |
46 | -`` |
|
40 | +``` |
|
47 | 41 | sudo /usr/bin/curl -k https://sbgrid.org/wiki/downloads/synthetic.conf -o /etc/synthetic.conf |
48 | 42 | ``` |
49 | 43 | |
50 | 44 | Then you MUST REBOOT the computer for the changes to take effect. |
51 | - |
|
52 | 45 | You should then see this in your root partition (/) : |
53 | 46 | |
54 | 47 | ``` |
... | ... | @@ -96,7 +89,7 @@ csrutil enable |
96 | 89 | ``` |
97 | 90 | |
98 | 91 | - Terminal should display a message that SIP was enabled. |
99 | -- From the menu, select Restart. |
|
92 | +- From the apple menu, select Restart. |
|
100 | 93 | |
101 | 94 | ### How to stop nagging macOS update alerts |
102 | 95 |