catalina.md
... ...
@@ -1,38 +1,38 @@
1
-# 1. Using SBGrid with MacOS 10.15+ 'Catalina', 'Big Sur'
1
+# Using SBGrid with MacOS 10.15+ 'Catalina', 'Big Sur'
2 2
3
-SBGrid software is largely compatible with MacOS Catalina and later, but the installation process requires a work-around to handle new filesystem controls. These controls impact the 'activation' process of our installation manager and also the ability to install the software.
3
+SBGrid software is largely compatible with MacOS *Catalina* and *Big Sur*, but the installation process requires a work-around to handle new filesystem controls. These controls impact the 'activation' process of our installation manager and also the ability to install the software. [More details about compatibility with the latest macOS and Apple hardware can be found here](big-sur.md)
4 4
5 5
<!-- TOC -->
6 6
7
-- [1. Using SBGrid with MacOS 10.15+ 'Catalina', 'Big Sur'](#1-using-sbgrid-with-macos-1015-catalina-big-sur)
8
- - [1.1. Activation changes](#11-activation-changes)
9
- - [1.2. Installation : the easy way with the latest command line application sbgrid-cli.](#12-installation--the-easy-way-with-the-latest-command-line-application-sbgrid-cli)
10
- - [1.2.1. Download the installation manager, sbgrid-cli :](#121-download-the-installation-manager-sbgrid-cli-)
11
- - [1.2.2. Activate your installation :](#122-activate-your-installation-)
12
- - [1.2.3. Create link at /programs :](#123-create-link-at-programs-)
13
- - [3.1. Reboot](#31-reboot)
14
- - [1.2. Method 2, SBGrid graphical installation manager, activate by disabling SIP. Requires a few reboots.](#12-method-2-sbgrid-graphical-installation-manager-activate-by-disabling-sip-requires-a-few-reboots)
15
- - [1.2.1. Disable SIP from Recovery mode](#121-disable-sip-from-recovery-mode)
16
- - [1.2.2. Remount root filesystem as read/write to create /programs](#122-remount-root-filesystem-as-readwrite-to-create-programs)
17
- - [1.2.3. Re-enable SIP (optional)](#123-re-enable-sip-optional)
18
- - [1.2. How to stop nagging macOS update alerts](#12-how-to-stop-nagging-macos-update-alerts)
19
- - [1.3. How to ignore macOS Catalina update on your mac](#13-how-to-ignore-macos-catalina-update-on-your-mac)
7
+- [Using SBGrid with MacOS 10.15+ 'Catalina', 'Big Sur'](#using-sbgrid-with-macos-1015-catalina-big-sur)
8
+ - [Activation changes](#activation-changes)
9
+ - [Installation : the easy way with the latest command line application sbgrid-cli.](#installation--the-easy-way-with-the-latest-command-line-application-sbgrid-cli)
10
+ - [Download the installation manager, sbgrid-cli :](#download-the-installation-manager-sbgrid-cli-)
11
+ - [Activate your installation :](#activate-your-installation-)
12
+ - [Create link at /programs :](#create-link-at-programs-)
13
+ - [Reboot](#reboot)
14
+ - [Method 2, SBGrid graphical installation manager, activate by disabling SIP. Requires a few reboots.](#method-2-sbgrid-graphical-installation-manager-activate-by-disabling-sip-requires-a-few-reboots)
15
+ - [Disable SIP from Recovery mode](#disable-sip-from-recovery-mode)
16
+ - [Remount root filesystem as read/write to create /programs](#remount-root-filesystem-as-readwrite-to-create-programs)
17
+ - [Re-enable SIP (optional)](#re-enable-sip-optional)
18
+ - [How to stop nagging macOS update alerts](#how-to-stop-nagging-macos-update-alerts)
19
+ - [How to ignore macOS Catalina update on your mac](#how-to-ignore-macos-catalina-update-on-your-mac)
20 20
21 21
<!-- /TOC -->
22 22
23
-## 1.1. Activation changes
23
+## Activation changes
24 24
25 25
Once the activation process is completed following the procedure below, the manager can be used normally. The SBGrid software is then functional, though [32-bit applications](https://docs.google.com/spreadsheets/d/e/2PACX-1vSZEEdZhYIdRq0BoY-Aq8XFO1QSR6idkO72N2UeACWSG8-84gLlPqE_v9NrFO9na66gZ3_6PCSDUXGI/pubhtml?gid=1974952972&single=true) are not supported on 10.15 Catalina.
26 26
27
-Note that macOS now uses the z-shell (zsh) by default. This shell is also supported in SBGrid using the standard sbgrid.shrc file. More info regarding managing your shell on macOS [can be found here](https://support.apple.com/en-us/HT208050)
27
+Note that macOS now uses the z-shell (zsh) by default. This shell is also supported in SBGrid using the standard sbgrid.shrc file. More info regarding managing your shell on macOS [can be found here](https://support.apple.com/en-us/HT208050)
28 28
29
-Also note the XQuartz is required for many applications. If you have upgraded to Catalina from an 10.14 or earlier, you will need to reinstall XQuartz. See [https://www.xquartz.org/](https://www.xquartz.org/) for downloads and more info.
29
+Also note the XQuartz is required for many applications. If you have upgraded to Catalina from an 10.14 or earlier, you will need to reinstall XQuartz. See [https://www.xquartz.org/](https://www.xquartz.org/) for downloads and more info.
30 30
31
-## 1.2. Installation : the easy way with the latest command line application sbgrid-cli.
31
+## Installation : the easy way with the latest command line application sbgrid-cli.
32 32
33 33
Activation with our latest command-line installation manager is possible in 3 steps, but a reboot is required to add the '/programs' path.
34 34
35
-### 1.2.1. Download the installation manager, sbgrid-cli :
35
+### Download the installation manager, sbgrid-cli :
36 36
37 37
First, download the latest installation manager from here
38 38
... ...
@@ -69,7 +69,7 @@ xattr -d com.apple.quarantine sbgrid-cli
69 69
70 70
You should then be able to run the application normally.
71 71
72
-### 1.2.2. Activate your installation :
72
+### Activate your installation :
73 73
74 74
To activate, use the credentials provided by email after [registration](https://sbgrid.org/registration/register/).
75 75
... ...
@@ -77,7 +77,7 @@ To activate, use the credentials provided by email after [registration](https://
77 77
./sbgrid-cli activate <your site> <your username> <your key>
78 78
```
79 79
80
-### 1.2.3. Create link at /programs :
80
+### Create link at /programs :
81 81
82 82
The lastest MacOS provides the option to create links in the root partion via the _/etc/synthetic.conf_ file.
83 83
This file has the following format:
... ...
@@ -100,7 +100,7 @@ sudo /usr/bin/curl -k https://sbgrid.org/wiki/downloads/synthetic.conf -o synthe
100 100
101 101
Then you MUST REBOOT the computer for the changes to take effect.
102 102
103
-### 3.1. Reboot
103
+### Reboot
104 104
105 105
You should then see this in your root partition (/) :
106 106
... ...
@@ -113,14 +113,14 @@ lrwxr-xr-x 1 root wheel 11 Jun 4 14:49 /programs -> /opt/sbgrid
113 113
From there, you can continue to install software with the installation manager, or use the [GUI](https://sbgrid.org/wiki/client_install).
114 114
They are not mutually exclusive.
115 115
116
-## 1.2. Method 2, SBGrid graphical installation manager, activate by disabling SIP. Requires a few reboots.
116
+## Method 2, SBGrid graphical installation manager, activate by disabling SIP. Requires a few reboots.
117 117
118 118
Activation with our graphical installation manager is not compatible with MacOS 10.15 "Catalina" without temporarily disabling System Integrity Protection (SIP). While the approach above is easier and recommended, it is possible to activate with the GUI by following the process below.
119 119
120 120
To create the /programs symlink in Catalina without using the /etc/synthetic.conf file, the system filesystem must be remounted as read/write.
121 121
To do that in Catalina, system integrity protection (SIP) must be disabled.
122 122
123
-### 1.2.1. Disable SIP from Recovery mode
123
+### Disable SIP from Recovery mode
124 124
125 125
- Restart your Mac.
126 126
- Before macOS starts up, hold down Command-R and keep it held down until you see an Apple icon and a progress bar. Release. This boots you into Recovery.
... ...
@@ -134,7 +134,7 @@ csrutil disable
134 134
- Terminal should display a message that SIP was disabled.
135 135
- From the  menu, select Restart.
136 136
137
-### 1.2.2. Remount root filesystem as read/write to create /programs
137
+### Remount root filesystem as read/write to create /programs
138 138
139 139
To remount the disk as read/write, run :
140 140
... ...
@@ -150,7 +150,7 @@ sudo ln -s /opt/sbgrid /programs
150 150
151 151
To install the software, you can use the installation manager normally. It will create the required paths and install the software. After the initial installation, you can use the installation manager as in previous MacOS releases, even after the steps below.
152 152
153
-### 1.2.3. Re-enable SIP (optional)
153
+### Re-enable SIP (optional)
154 154
155 155
- Restart your Mac.
156 156
- Before macOS starts up, hold down Command-R and keep it held down until you see an Apple icon and a progress bar. Release. This boots you into Recovery.
... ...
@@ -164,7 +164,7 @@ csrutil enable
164 164
- Terminal should display a message that SIP was enabled.
165 165
- From the  menu, select Restart.
166 166
167
-## 1.2. How to stop nagging macOS update alerts
167
+## How to stop nagging macOS update alerts
168 168
169 169
It is possible to turn off the nagging pop ups.
170 170
... ...
@@ -172,7 +172,7 @@ It is possible to turn off the nagging pop ups.
172 172
- Click on Software Update.
173 173
- Deselect Automatically keep my Mac up to date
174 174
175
-## 1.3. How to ignore macOS Catalina update on your mac
175
+## How to ignore macOS Catalina update on your mac
176 176
177 177
```
178 178
sudo softwareupdate --ignore "macOS Catalina"