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