client_downloads.md
... ...
@@ -4,37 +4,38 @@
4 4
5 5
- [SBGrid Installation Manager - Downloads](#sbgrid-installation-manager---downloads)
6 6
- [Requirements](#requirements)
7
- - [SBGrid Installation Manager for MacOS and Linux, v2.5.11](#sbgrid-installation-manager-for-macos-and-linux-v2511)
8
- - [SBGrid Command-line Installation Manager for MacOS and Linux, v2.5.11](#sbgrid-command-line-installation-manager-for-macos-and-linux-v2511)
7
+ - [SBGrid Installation Manager for MacOS and Linux, v2.5.12](#sbgrid-installation-manager-for-macos-and-linux-v2512)
8
+ - [SBGrid Command-line Installation Manager for MacOS and Linux, v2.5.12](#sbgrid-command-line-installation-manager-for-macos-and-linux-v2512)
9 9
10 10
<!-- /TOC -->
11 11
12 12
### Requirements
13 13
14
-SBGrid can be installed on computers running Linux or macOS operating systems. [CentOS/RHEL 7 or 8 is recommended for linux, or MacOSX v10.13 - macOS 11.0 for Macs.](operatingsystems). CentOS 6 has reached "End-of-Life" and is no longer supported. macOS 10.15 "Catalina" and macOS 11.0 "Big Sur" can be used, but an `/etc/syntetic.conf` file is required to create the `/programs` path. The GUI Installation Manager will create this for you. See [here for more info :](catalina)
14
+SBGrid can be installed on computers running Linux or macOS operating systems. [CentOS/RHEL 7 or 8 is recommended for linux, or MacOSX v10.13 - macOS 12 for Macs.](operatingsystems).
15
+On macOS 10.15+ an `/etc/syntetic.conf` file is required to create the root level `/programs` symlink on the read-only filesystem. The GUI Installation Manager will create this automatically. See [here for more info :](macos)
15 16
16 17
The SBGrid installation manager requires an account. Set up an account by registering here : [SBGrid registration](https://sbgrid.org/registration/register/)
17 18
18
-### SBGrid Installation Manager for MacOS and Linux, v2.5.11
19
+### SBGrid Installation Manager for MacOS and Linux, v2.5.12
19 20
20
-- [Linux : SBGrid-installation-manager-2.5.11.AppImage ](https://sbgrid.org/downloads/2.5.11/SBGrid-installation-manager-2.5.11.AppImage)
21
+- [Linux : SBGrid-installation-manager-2.5.12.AppImage ](https://sbgrid.org/downloads/2.5.12/SBGrid-installation-manager-2.5.12.AppImage)
21 22
22
-- [macOS : SBGrid-installation-manager-2.5.11.dmg ](https://sbgrid.org/downloads/2.5.11/SBGrid-installation-manager-2.5.11.dmg)
23
+- [macOS : SBGrid-installation-manager-2.5.12.dmg ](https://sbgrid.org/downloads/2.5.12/SBGrid-installation-manager-2.5.12.dmg)
23 24
24 25
See [this page](client_usage) for usage info.
25 26
26
-### SBGrid Command-line Installation Manager for MacOS and Linux, v2.5.11
27
+### SBGrid Command-line Installation Manager for MacOS and Linux, v2.5.12
27 28
28
-- [Linux : sbgrid-cli_2.5.11-linux.tar.gz ](https://sbgrid.org/downloads/2.5.11/sbgrid-cli_2.5.11-linux.tar.gz)
29
+- [Linux : sbgrid-cli_2.5.12-linux.tar.gz ](https://sbgrid.org/downloads/2.5.12/sbgrid-cli_2.5.12-linux.tar.gz)
29 30
30
-- [macOS : sbgrid-cli_2.5.11-macos.tar.gz ](https://sbgrid.org/downloads/2.5.11/sbgrid-cli_2.5.11-macos.tar.gz)
31
+- [macOS : sbgrid-cli_2.5.12-macos.tar.gz ](https://sbgrid.org/downloads/2.5.12/sbgrid-cli_2.5.12-macos.tar.gz)
31 32
32 33
You can download this tar.gz file from the command line with this command in the Terminal:
33 34
34 35
```
35
-curl -k -LO https://sbgrid.org/downloads/2.5.11/sbgrid-cli_2.5.11-macos.tar.gz
36
+curl -k -LO https://sbgrid.org/downloads/2.5.12/sbgrid-cli_2.5.12-macos.tar.gz
36 37
```
37 38
38
-This will prevent the need to [remove the com.apple.quarantine attribute.](https://sbgrid.org//wiki/catalina#download-the-installation-manager-sbgrid-cli)
39
+This will prevent the need to [remove the com.apple.quarantine attribute.](https://sbgrid.org//wiki/macos#download-the-installation-manager-sbgrid-cli)
39 40
40
-See [this page](cli_v2) for usage info.
41
+For usage info, continue to [this page](cli_v2).
macos.md
... ...
@@ -1,10 +1,8 @@
1 1
## Using SBGrid with MacOS 10.15 and later (Catalina, Big Sur and Monterey)
2 2
3
-SBGrid software is compatible with macOS 10.15 *Catalina*, macOS 11 *Big Sur* and macOS 12 *Monterey* 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 root partition (/) of the apple filesystem.
3
+SBGrid software is compatible with macOS 10.15 *Catalina*, macOS 11 *Big Sur* and macOS 12 *Monterey* with the exception of 32-bit software. Initial activation of an SBGrid installation requires a reboot after account activation to accomodate macOS controls in the root partition (/) of the apple filesystem. This additional reboot is only needed after the initial account activation and creation of the _/etc/synthetic.conf_ configuration file. The latest versions for the SBGrid Installation manager (GUI) will handle the creation of the required _/etc/synthetic.conf_ file automatically.
4 4
5
-This additional reboot step is only needed after the initial account activation and is handled by our installation manager in most cases. The latest versions for the SBGrid Installation manager (GUI and CLI) will handle the creation of the required _/etc/synthetic.conf_ file automatically.
6
-
7
-For users that have upgraded to Catalina or newer from an older version of macOS that did not require this, [the _/etc/synthetic.conf_ file needs to be created manually.](#manual-creation-of-the-programs-path). See below.
5
+For users that have upgraded to Catalina or later from an older version of macOS that did not require this, [the _/etc/synthetic.conf_ file can be created manually.](#manual-creation-of-the-programs-path). See below.
8 6
9 7
**A reboot is required for /etc/synthetic.conf to take effect.**
10 8
... ...
@@ -16,15 +14,15 @@ Once the activation process is completed and the system has been rebooted, the m
16 14
17 15
### Manual creation of the programs path ( after macOS upgrade )
18 16
19
-Users who have upgraded to Catalina or newer from a previous macOS release will need to create the _/etc/synthetic.conf_ file manually.
20
-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.
17
+SBGrid requires the `/programs` path to run software. Users who have upgraded to Catalina or newer from a previous macOS release will need to create the _/etc/synthetic.conf_ file manually. 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.
18
+
21 19
This file has the following format:
22 20
23 21
```
24 22
programs /opt/sbgrid
25 23
```
26 24
27
-Note that the whitespace MUST be a tab character. Spaces will not work.
25
+Note that the **whitespace MUST be a tab character**. Spaces will not work.
28 26
Here is a file for reference : [synthetic.conf](downloads/synthetic.conf).
29 27
Thanks to Ron Rock at University of Chicago for pointing this out.
30 28
... ...
@@ -46,20 +44,9 @@ lrwxr-xr-x 1 root wheel 11 Jun 4 14:49 /programs -> /opt/sbgrid
46 44
From there, you can continue to install software with the installation manager, or use the [GUI](https://sbgrid.org/wiki/client_install).
47 45
They are not mutually exclusive.
48 46
49
-## SBGrid on Apple M1 Silicon
50
-
51
-ARM64 compatibility
52
-
53
-Apple released the first of its new ARM64 "apple silicon" macs with the "M1" CPU. We are testing the SBGrid software stack on the M1 chip and, so far, compatibility and performance look very good. Most of the SBGrid applications work on the new M1 CPU with macOS 11 and Apple's Rosetta compatibility environment. Standards like COOT, PyMOL, Chimera, CCP4, and PHENIX work seamlessly, but there are exceptions (CCPEM, RELION, Schrodinger). We expect to support most titles on BigSur with the new M1 hardware early in 2021.
54
-
55
-## SBGrid on macOS 11 "Big Sur"
56
-
57
-Apple has released MacOS 11.0 "Big Sur" which provides compatibilty for Apple's new 'Apple Silicon' ARM-based computers as well as numerous changes and security enhancements. Because this is a major update, we reccommend waiting to upgrade any system required for scientific data processing. MacOS 10.14 "Mojave" or 10.15 "Catalina" are currently supported by SBGrid.
58
-
59
-Installation of SBGrid on Big Sur is basically the same as on Catalina. Due to Apple's filesystem protections and our current requirement of a symlink at `/programs`, a `/etc/synthetic.conf` file is necessary. See above for more info.
47
+## SBGrid on Apple M1 Silicon ARM64
60 48
61
-## SBGrid on macOS 12 "Monterey"
62
-We are not aware of any issues specific to macOS 12 at this time. The "Monterey" beta release appears to be very similar to Big Sur, SBGrid installation managers work, PyMOL and COOT are known to work. This appears to be a safe upgrade from macOS 11, at least in the macOS 12 beta.
49
+Apple has released ARM64 "apple silicon" macs with the "M1" class CPU. Compatibility and performance of the SBGrid software collection looks good and most applications work with Apple's "Rosetta" compatibility environment. Standards like COOT, PyMOL, Chimera, CCP4, and PHENIX work seamlessly, but there are exceptions (CCPEM, RELION, Schrodinger).
63 50
64 51
## Known macOS issues
65 52