_Sidebar.md
... ...
@@ -1,5 +1,4 @@
1
-![BioGrids](images/BioGrids_small_logo.gif) **[BioGrids Wiki](Home)**
2
-
1
+![BioGrids](images/BioGrids_small_logo.png) **[BioGrids Wiki](Home)**
3 2
4 3
Installing Software
5 4
* [Installation: Overview](installation_overview)
... ...
@@ -8,8 +7,8 @@ Installing Software
8 7
* [Installation: MacOS GUI](client_install)
9 8
* [Installation: Package Manager](client_CLI_install)
10 9
11
-Using the SBGrid Environment
12
-* [Getting Started with SBGrid](getting_started)
10
+Using the BIOGrids Environment
11
+* [Getting Started with BioGrids](getting_started)
13 12
* [Overriding Software Versions](versions)
14 13
* [BioGrids environment: Capsules](capsules)
15 14
* [BioGrids environment: Legacy](monolithic)
... ...
@@ -25,45 +24,5 @@ Support for Site Administrators
25 24
* [Administrator Software Version Overrides](admin_overrides)
26 25
* [Admins Mailing List](mailinglist)
27 26
28
-Support for Developers
29
-* [Resources for Developers](developers)
30
-* [Build and Test Network](resources)
31
-
32
-Hardware Support Notes
33
-* [BioGrids Recommended Hardware](recommended)
34
-
35
-
36
-
37
-
38
-<!---
39
-
40
-Support for Users
41
-* [Getting Started with BioGrids](getting_started)
42
-* [Software Help and Requests](help)
43
-* [Supported Operating Systems](operatingsystems)
44
-* [Overriding Software Versions](versions)
45
-* [Install BioGrids: MacOS GUI](client_install)
46
-* [Install BioGrids: CLI](client_CLI_install)
47
-
48
-Support for Site Administrators
49
-* [Software Installation](installation_admin)
50
-* [Preparing Workstations to run the Software](workstation_setup)
51
-* [Managing your Installation](managing_install)
52
-* [Administrator Software Version Overrides](admin_overrides)
53
-* [Admins Mailing List](mailinglist)
54
-
55
-Support for Developers
56
-* [Resources for Developers](developers)
57
-* [Build and Test Network](resources)
58
-
59 27
Hardware Support Notes
60
-* [GPU computing](gpu)
61 28
* [BioGrids Recommended Hardware](recommended)
62
-* [Setup Stereo 3D](stereo)
63
-
64
--->
65
-
66
-
67
-
68
-
69
-
client_CLI_install.md
... ...
@@ -1,8 +1,8 @@
1
-## SBGrid installation client CLI
1
+## BioGrids installation client CLI
2 2
3
-This page is for the SBGrid CLI (command line interface) software installation client for computers running Linux (CentOS/RHEL 6 or 7 recommended) or Apple OSX computers running MacOSX v10.9 - 10.12.
3
+This page is for the BioGrids CLI (command line interface) software installation client for computers running Linux (CentOS/RHEL 6 or 7 recommended) or Apple OSX computers running MacOSX v10.9 - 10.12.
4 4
5
-Looking to get started with the SBGrid installation client? First, set up an account by registering here : [SBGrid registration](https://sbgrid.org/registration/register/)
5
+Looking to get started with the BioGrids installation client? First, set up an account by registering here : [BioGrids registration](https://sbgrid.org/registration/register/)
6 6
7 7
A GUI version is also available for MacOS / OSX - [installation instructions can be found here](client_install).
8 8
[GUI usage info is here](client_usage).
... ...
@@ -10,10 +10,10 @@ A GUI version is also available for MacOS / OSX - [installation instructions can
10 10
### Pre-installation requirements
11 11
12 12
**Admin access required on your computer.**
13
- The SBGrid installation client will install the software tree to /opt/sbgrid and create a symlink from this directory to /programs. While admin privileges are not required to run the application, you will need admin privileges to create /opt/sbgrid and /programs .
13
+ The BioGrids installation client will install the software tree to /opt/sbgrid and create a symlink from this directory to /programs. While admin privileges are not required to run the application, you will need admin privileges to create /opt/sbgrid and /programs .
14 14
15
-**Existing SBGrid installations must be renamed or removed.**
16
- If you have previously installed SBGrid software on your computer at /programs or at /opt/sbgrid, these directories should be removed or renamed. The client will create these on first run.
15
+**Existing BioGrids installations must be renamed or removed.**
16
+ If you have previously installed BioGrids software on your computer at /programs or at /opt/sbgrid, these directories should be removed or renamed. The client will create these on first run.
17 17
18 18
**Hard Drive Space**
19 19
Depending on what you install, ensure you have enough free hard drive space on your machine.
... ...
@@ -35,29 +35,29 @@ A GUI version is also available for MacOS / OSX - [installation instructions can
35 35
On CentOS6, you can install pip from the EPEL repository (yum -y install python-pip) or as [per these directions](https://pip.pypa.io/en/stable/installing/)
36 36
37 37
## CLI client - Installation and activation
38
-**1. Download the latest SBGrid installation client from here.**
38
+**1. Download the latest BioGrids installation client from here.**
39 39
40
-[Latest build : 1.0.471, 2017-02-17](downloads/SBGrid_Installer-1.0.471-py2-none-any.whl)
40
+[Latest build : 1.0.471, 2017-02-17](downloads/BioGrids_Installer-1.0.471-py2-none-any.whl)
41 41
42 42
**2. Install / Upgrade with pip**
43 43
44
- $ sudo pip install SBGrid_Installer-1.0.461-py2-none-any.whl
44
+ $ sudo pip install BioGrids_Installer-1.0.461-py2-none-any.whl
45 45
46 46
Which should produce output similar to :
47 47
48 48
```
49
-Unpacking ./SBGrid_Installer-1.0.448-py2-none-any.whl
50
-Requirement already satisfied (use --upgrade to upgrade): pyasn1 in /nfs/programs-dev/i386-mac/python/2.7.5/lib/python2.7/site-packages (from SBGrid-Installer==1.0.488)
51
-Downloading/unpacking requests (from SBGrid-Installer==1.0b2.dev412)
49
+Unpacking ./BioGrids_Installer-1.0.448-py2-none-any.whl
50
+Requirement already satisfied (use --upgrade to upgrade): pyasn1 in /nfs/programs-dev/i386-mac/python/2.7.5/lib/python2.7/site-packages (from BioGrids-Installer==1.0.488)
51
+Downloading/unpacking requests (from BioGrids-Installer==1.0b2.dev412)
52 52
Downloading requests-2.11.1.tar.gz (485kB): 485kB downloaded
53 53
Running setup.py egg_info for package requests
54 54
55 55
warning: no files found matching 'test_requests.py'
56
-Installing collected packages: SBGrid-Installer, requests
56
+Installing collected packages: BioGrids-Installer, requests
57 57
Running setup.py install for requests
58 58
59 59
warning: no files found matching 'test_requests.py'
60
-Successfully installed SBGrid-Installer requests
60
+Successfully installed BioGrids-Installer requests
61 61
Cleaning up...
62 62
```
63 63
... ...
@@ -97,18 +97,18 @@ You may be prompted for your sudo password to create /programs and /opt/sbgrid.
97 97
98 98
$ sbgrid list
99 99
100
- If activation continues to fail, you may have an old SBGrid installation at /programs or /opt/sbgrid. These should be removed.
100
+ If activation continues to fail, you may have an old BioGrids installation at /programs or /opt/sbgrid. These should be removed.
101 101
102
-You may also be blocked from accessing SBGrid servers on port 873 and port 8080 by your institution's firewall. You can check if you can access [port 873 here](http://portquiz.net:873) and [port 8080 here](http://portquiz.net:8080)
102
+You may also be blocked from accessing BioGrids servers on port 873 and port 8080 by your institution's firewall. You can check if you can access [port 873 here](http://portquiz.net:873) and [port 8080 here](http://portquiz.net:8080)
103 103
104 104
For help, email *bugs@sbgrid.org.*
105 105
106 106
### Installation on an external drive or USB key
107
-Currently the installer application installs the software tree in /opt/sbgrid and uses a symlink at /programs. This link is required for the software to work, but in principle the software can be located anywhere and linked to /opt/sbgrid. This functionality is not yet included in the SBGrid application, but can be set up manually with a symlink.
107
+Currently the installer application installs the software tree in /opt/sbgrid and uses a symlink at /programs. This link is required for the software to work, but in principle the software can be located anywhere and linked to /opt/sbgrid. This functionality is not yet included in the BioGrids application, but can be set up manually with a symlink.
108 108
109 109
An installation can be made on an external drive if you first do an install (into /opt/sbgrid), then move it and symlink to the new location.
110 110
111
-**Example:** 128Gb USB 'key' drives are available on Amazon for 30$ or less and are a nice way to supplement the SSDs that come in Mac laptops. To install on an external drive like this, mount it on your computer. For this example, the mount is */Volumes/sbgrid_client_install*. Then, using the SBGrid installer, do an initial installation on the hard drive. To make life easy, just do one application. Then close the installer application.
111
+**Example:** 128Gb USB 'key' drives are available on Amazon for 30$ or less and are a nice way to supplement the SSDs that come in Mac laptops. To install on an external drive like this, mount it on your computer. For this example, the mount is */Volumes/sbgrid_client_install*. Then, using the BioGrids installer, do an initial installation on the hard drive. To make life easy, just do one application. Then close the installer application.
112 112
113 113
Next move */opt/sbgrid* to the USB key at */Volumes/sbgrid_client_install*. You will likely need sudo for this.
114 114
... ...
@@ -120,7 +120,7 @@ Now we have */Volumes/sbgrid_client_install/sbgrid*. Create a symlink from */opt
120 120
121 121
The symlink at */programs* still points to */opt/sbgrid*, and that is a link that points to the external location. Open the installer and add the desired applications. These will now install to the external drive.
122 122
123
-[SBGrid install client -- Usage info](client_usage)
123
+[BioGrids install client -- Usage info](client_usage)
124 124
125 125
### Known issues
126 126
client_install.md
... ...
@@ -1,10 +1,10 @@
1
-## SBGrid installation client
1
+## BioGrids installation client
2 2
3
-This page is for the SBGrid GUI installation client for Apple OSX computers running MacOSX v10.9 - 10.12 .
3
+This page is for the BioGrids GUI installation client for Apple OSX computers running MacOSX v10.9 - 10.12 .
4 4
5 5
![](images/client_all.png)
6 6
7
-Looking to get started with the SBGrid installation client? First, set up an account by registering here : [SBGrid registration](https://sbgrid.org/registration/register/)
7
+Looking to get started with the BioGrids installation client? First, set up an account by registering here : [BioGrids registration](https://sbgrid.org/registration/register/)
8 8
9 9
A command line version is also available for mac and linux - installation instuctions can be found here : [CLI installation](client_CLI_install).
10 10
... ...
@@ -13,10 +13,10 @@ Usage info for the GUI and command line clients can be found here : [GUI Usage](
13 13
### Pre-installation
14 14
15 15
**1. Admin access required.**
16
- The SBGrid installation client will install the software tree to */opt/sbgrid* and create a symlink from this directory to */programs*. While admin privileges are not required to run the application, you will need admin privileges to create */opt/sbgrid* and */programs* .
16
+ The BioGrids installation client will install the software tree to */opt/sbgrid* and create a symlink from this directory to */programs*. While admin privileges are not required to run the application, you will need admin privileges to create */opt/sbgrid* and */programs* .
17 17
18 18
**2. Existing installations must be renamed or removed.**
19
- If you have previously installed SBGrid software on your computer at */programs* or at */opt/sbgrid*, these directories should be removed or renamed. The client will create these on first run.
19
+ If you have previously installed BioGrids software on your computer at */programs* or at */opt/sbgrid*, these directories should be removed or renamed. The client will create these on first run.
20 20
21 21
**3. Hard Drive Space**
22 22
Depending on what you install, ensure that you have enough free hard drive space on your machine.
... ...
@@ -26,11 +26,11 @@ Usage info for the GUI and command line clients can be found here : [GUI Usage](
26 26
27 27
### Installation and activation
28 28
29
-**1. Download the latest SBGrid installation client from here.**
29
+**1. Download the latest BioGrids installation client from here.**
30 30
31
- [Latest build : 1.0.471, 2017-02-17](downloads/SBGrid_Installer-1.0.471.dmg)
31
+ [Latest build : 1.0.471, 2017-02-17](downloads/BioGrids_Installer-1.0.471.dmg)
32 32
33
-**2. Mount the .dmg disk image on your Mac.** Copy the 'SBGrid installer.app' to a convenient location - it does not need to be in /Applications. The .app bundle can be run directly from the mounted dmg image with no installation if desired.
33
+**2. Mount the .dmg disk image on your Mac.** Copy the 'BioGrids installer.app' to a convenient location - it does not need to be in /Applications. The .app bundle can be run directly from the mounted dmg image with no installation if desired.
34 34
35 35
**3. Enter your site, user name, and key.** You should have received these by email.
36 36
... ...
@@ -40,13 +40,13 @@ On activation you will be prompted to provide admin credentials for your mac. Th
40 40
41 41
![activation](images/client_permissions.png)
42 42
43
-**4. On successful activation, you should see the client populate with software titles.** If not, please close the application and try again. If activation continues to fail, you may have an old SBGrid installation at */programs* or */opt/sbgrid*. These should be removed. You may also be blocked from accessing SBGrid servers on port 873 and port 8080 by your institution's firewall. You can check if you can access [port 873 here](http://portquiz.net:873) and [port 8080 here](http://portquiz.net:8080)
43
+**4. On successful activation, you should see the client populate with software titles.** If not, please close the application and try again. If activation continues to fail, you may have an old BioGrids installation at */programs* or */opt/sbgrid*. These should be removed. You may also be blocked from accessing BioGrids servers on port 873 and port 8080 by your institution's firewall. You can check if you can access [port 873 here](http://portquiz.net:873) and [port 8080 here](http://portquiz.net:8080)
44 44
For help, email *bugs@sbgrid.org.*
45 45
46 46
### Installation on an external drive or USB key
47
-Currently the installer application installs the software tree in */opt/sbgrid* and uses a symlink at */programs*. The */programs* link is required for the software to work, but in principle the software can be anywhere by linking */opt/sbgrid* to the desired installation point. This functionality is not yet included in the SBGrid application, but can be set up manually post-install with a symlink. First do an install (into */opt/sbgrid*), then move it to the desired localtion. Then symlink to the new location from */opt/sbgrid*.
47
+Currently the installer application installs the software tree in */opt/sbgrid* and uses a symlink at */programs*. The */programs* link is required for the software to work, but in principle the software can be anywhere by linking */opt/sbgrid* to the desired installation point. This functionality is not yet included in the BioGrids application, but can be set up manually post-install with a symlink. First do an install (into */opt/sbgrid*), then move it to the desired localtion. Then symlink to the new location from */opt/sbgrid*.
48 48
49
-**Example:** 128Gb USB 'key' drives are available on Amazon for 30$ or less and are a nice way to supplement the small SSDs that come in Mac laptops. To install on an external drive in this way, first mount it on your computer. For this example, the mount is */Volumes/sbgrid_client_install*. Then, using the SBGrid installer, do an initial installation on the hard drive. To make life easy, just do one application. Then close the installer application.
49
+**Example:** 128Gb USB 'key' drives are available on Amazon for 30$ or less and are a nice way to supplement the small SSDs that come in Mac laptops. To install on an external drive in this way, first mount it on your computer. For this example, the mount is */Volumes/sbgrid_client_install*. Then, using the BioGrids installer, do an initial installation on the hard drive. To make life easy, just do one application. Then close the installer application.
50 50
51 51
Next move **/opt/sbgrid** to the USB key at */Volumes/sbgrid_client_install*. You will likely need sudo for this.
52 52
... ...
@@ -58,7 +58,7 @@ Now we have */Volumes/sbgrid_client_install/sbgrid*. Create a symlink from **/op
58 58
59 59
The symlink at **/programs** still points to **/opt/sbgrid**, and that is a link that points to the external location. Open the installer and add the desired applications. These will now install to the external drive.
60 60
61
-[SBGrid install client -- Usage info](client_usage)
61
+[BioGrids install client -- Usage info](client_usage)
62 62
63 63
### Known issues
64 64
developers.md
... ...
@@ -1,26 +0,0 @@
1
-## SBGrid Developer Support Program
2
-In an effort to show our appreciation for their hard work and to encourage the continuing development and support of cutting edge structural biology software, SBGrid offers a Developer Support Program featuring a wide array of benefits for structural biology software developers.
3
-
4
-### Developer Network
5
-We can provide access to a dedicated development and test network for software developers. As a developer of an SBGrid supported application, you can request an account on this network and use our infrastructure to build and test your application on a wide range of operating systems. Visit the [developer network page](resources) for more details.
6
-
7
-### Support Letters
8
-When applying for grants or financial support please let us know! We can provide support letters on behalf of members of SBGrid Consortium. Letters would include details about our membership, number of computers that can access your software, operating systems used by our community, etc. Please use the [contact form](http://sbgrid.org/contact.php|contact) on the SBGrid website.
9
-
10
-### Software Beta Testing
11
-You are welcome to use SBGrid laboratories to beta-test your software. Just let us know when the new beta is available, and we will install it for all participating laboratories or a limited subset that you choose.
12
-
13
-### SBGrid Consortium Membership
14
-If your application is under active maintenance or development, your development group is entitled to free membership in the consortium. Letting us maintain your general structural biology software environment leaves you with more time to concentrate on your unique software contribution to the community.
15
-
16
-### Annual Software Awards
17
-Members of SBGrid Consortium vote in an annual poll to select their favorite structural biology application. Paul Emsley was the winner of the first poll. He won a Macbook Air laptop for his application Coot.
18
-
19
-### Stretch Your Resources
20
-First level software support is provided by the SBGrid non-profit center at Harvard Medical School. All members of the consortium communicate with the service center for assistance with software installation, upgrades, and basic troubleshooting. For many of the mundane problems involving installation, operating system portability and environmental set up, SBGrid members will never need to contact you for support. Your expertise with the software be best utilized answering questions and working on problems that directly involve the science behind your application.
21
-
22
-### Broad Exposure for Your Software
23
-More than 140 structural biology laboratories from 50 institutions in 11 countries participate in the Consortium including the labs of 25 HHMI investigators and 2 Nobel Prize winners. Deployment of your application can be customized to include only non-profit labs or broadened to include industry labs as well. Please visit the Consortium website for the full list of participating groups that can benefit from rapid access to your software. Please note that most SBGrid Consortium laboratories standardize on hardware and operating systems, which simplifies the installation and support process.
24
-
25
-### Connect With Users
26
-Announcing a new version of your software? We can use webex to broadcast your presentation to all laboratories participating in our consortium. We can also disseminate information about your application to our community in our monthly newsletter. Visiting Boston? Please let us know because we'd love to schedule a seminar for members of our local structural biology community.
getting_started.md
... ...
@@ -1,47 +1,47 @@
1 1
## Getting Started
2 2
3
-### Using the SBGrid software collection
4
-The SBGrid software collection can be found installed at **/programs**.
5
-All software in the SBGrid collection is run from the the command line in a terminal. Do set up the shell environment the terminal to run the programs, you will need to initialize the SBGrid environment.
3
+### Using the BioGrids software collection
4
+The BioGrids software collection can be found installed at **/programs**.
5
+All software in the BioGrids collection is run from the the command line in a terminal. Do set up the shell environment the terminal to run the programs, you will need to initialize the BioGrids environment.
6 6
7
-Bash users should initialize the SBGrid environment using :
7
+Bash users should initialize the BioGrids environment using :
8 8
9
- source /programs/sbgrid.shrc
9
+ source /programs/biogrids.shrc
10 10
11
-Tcsh users should initialize the SBGrid environment with :
11
+Tcsh users should initialize the BioGrids environment with :
12 12
13
- source /programs/sbgrid.cshrc
13
+ source /programs/biogrids.cshrc
14 14
15
-On initialization, you should see the SBGrid welcome message
15
+On initialization, you should see the BioGrids welcome message
16 16
17
-![SBGrid](images/terminal1.png)
17
+![BioGrids](images/terminal1.png)
18 18
19 19
### Making the shell configuration automatic
20 20
21
-To setup your terminal to automatically load the SBGrid environment, add the following to your configuration file:
21
+To setup your terminal to automatically load the BioGrids environment, add the following to your configuration file:
22 22
23 23
For Bash, in **~/.bashrc**, add :
24 24
25
- if [ -f /programs/sbgrid.shrc ] ; then
26
- source /programs/sbgrid.cshrc
25
+ if [ -f /programs/biogrids.shrc ] ; then
26
+ source /programs/biogrids.cshrc
27 27
fi
28 28
29 29
For tcsh, in **~/.tcshrc** or **~/.cshrc**, add :
30 30
31
- if ( -e /programs/sbgrid.cshrc) then
32
- source /programs/sbgrid.cshrc
31
+ if ( -e /programs/biogrids.cshrc) then
32
+ source /programs/biogrids.cshrc
33 33
endif
34 34
35 35
### Setting an alias
36 36
37
-If you would prefer to load the SBGrid environment on demand and not have to type the command above, you can set an alias to a shorter command of your choosing.
37
+If you would prefer to load the BioGrids environment on demand and not have to type the command above, you can set an alias to a shorter command of your choosing.
38 38
39 39
For example, for bash in ~/.bashrc :
40 40
41
- alias sbg='source /programs/sbgrid.shrc'
41
+ alias sbg='source /programs/biogrids.shrc'
42 42
43 43
For tcsh in ~/.tcshrc, this would be
44 44
45
- alias sbg 'source /programs/sbgrid.cshrc'
45
+ alias sbg 'source /programs/biogrids.cshrc'
46 46
47
-Questions or problems? Please email **bugs@sbgrid.org**
47
+Questions or problems? Please email **bugs@biogrids.org**
gpu.md
... ...
@@ -1,12 +1,12 @@
1 1
## GPU computing
2 2
3
-GPU-accelerated computing uses a graphics processing unit (GPU) to accelerate computations in computer programs. Several applications in the SBGrid programs tree are GPU-accelerated. Some examples are RELION, GCTF, MotionCor2, Gautomatch, IMOD, etc. Here's what you need to take advantage of a GPU:
3
+GPU-accelerated computing uses a graphics processing unit (GPU) to accelerate computations in computer programs. Several applications in the BioGrids programs tree are GPU-accelerated. Here's what you need to take advantage of a GPU:
4 4
5 5
### Requirements for GPU (CUDA) applications
6 6
7 7
**NVIDIA Hardware**
8 8
9
-To use GPU-accelerated applications, you will need an NVIDIA GPU. We don't currently support other co-processors (Xeon Phi, AMD). If you think we should, let us know at bugs@sbgrid.org .
9
+To use GPU-accelerated applications, you will need an NVIDIA GPU. We don't currently support other co-processors (Xeon Phi, AMD). If you think we should, let us know at bugs@biogrids.org .
10 10
11 11
Not all GPUs are created equal - some applications are restricted to GPUs with a certain 'Compute Capability (i.e. of 3.5 or greater)'. You can check your card's rating and find more information on GPU computing here : [https://developer.nvidia.com/cuda-gpus](https://developer.nvidia.com/cuda-gpus)
12 12
... ...
@@ -14,8 +14,6 @@ To use GPU-accelerated applications, you will need an NVIDIA GPU. We don't curre
14 14
15 15
You linux workstation must have the proper drivers for your GPU. You can find drivers for your card here : [https://developer.nvidia.com/cuda-zone](https://developer.nvidia.com/cuda-zone)
16 16
17
-We currently support applications that rely on versions of CUDA 5 to 8 and these libraries are included with the SBGrid distribution. For best results, it is important to have a recent driver version if possible.
17
+We currently support applications that rely on versions of CUDA 5 to 8 and these libraries are included with the BioGrids distribution. For best results, it is important to have a recent driver version if possible.
18 18
19
-For more information on GPUs and RELION, check Erik Lindahl's blog at the Department of Biochemistry & Biophysics, Stockholm University, [http://www.cryoem.se/relion-gpu](http://www.cryoem.se/relion-gpu)
20
-
21
-GPU questions? Want to use GPU support in an application and it's not working? Please email *bugs@sbgrid.org*
19
+GPU questions? Want to use GPU support in an application and it's not working? Please email *bugs@biogrids.org*
help.md
... ...
@@ -1,15 +1,15 @@
1 1
## Software Help
2 2
3
-If you are having a problem with software included in the SBGrid suite or think you've discovered an application bug, please use the [SBGrid](http://sbgrid.org/bugs) web form to alert us to the problem. You can also email bugs@sbgrid.org with details on the problem, but the web form is the preferred method.
3
+If you are having a problem with software included in the BioGrids suite or think you've discovered an application bug, please use the [BioGrids](http://biogrids.org/bugs) web form to alert us to the problem. You can also email bugs@sbgrid.org with details on the problem, but the web form is the preferred method.
4 4
5
-If the problem with the software started after an update, you can configure your SBGrid environment to [use an older version of the software](overrides).
5
+If the problem with the software started after an update, you can configure your BioGrids environment to [use an older version of the software](overrides).
6 6
7 7
### New Software and Software Updates
8
-To request a new software package or an update to an existing package, please use the [Software](http://sbgrid.org/req) Update/Installation Request form]].
8
+To request a new software package or an update to an existing package, please use the [Software](http://biogrids.org/req) Update/Installation Request form]].
9 9
10
-We try to accommodate most requests for new software, but we do occasionally run into difficulties. Despite most of our software being free for academics, some developers insist that each lab download and install their own software. We are happy to provide developers with the list of SBGrid members that have access to their software, but that doesn't always satisfy their requirements.
10
+We try to accommodate most requests for new software, but we do occasionally run into difficulties. Despite most of our software being free for academics, some developers insist that each lab download and install their own software. We are happy to provide developers with the list of BioGrids members that have access to their software, but that doesn't always satisfy their requirements.
11 11
12 12
Even when things go smoothly, license requests and working out licensing details with developers can take some time, so please don't wait until the last minute before requesting software you anticipate you may need for your project.
13 13
14 14
### Newsletter
15
-SBGrid sends a monthly newsletter with information concerning software updates, upcoming webinars, talks and other items of interest to our community. The archive of previous newsletters is available online at the [SBGrid Newsletter Archive](https://sbgrid.org/newsletters/).
15
+BioGrids sends a monthly newsletter with information concerning software updates, upcoming webinars, talks and other items of interest to our community. The archive of previous newsletters is available online at the [BioGrids Newsletter Archive](https://biogrids.org/newsletters/).
images/BioGrids_small_logo.png
... ...
Binary files /dev/null and b/images/BioGrids_small_logo.png differ
installation_admin.md
... ...
@@ -5,7 +5,7 @@ The *sbgrid-admin* utility used to install the complete software collection. A d
5 5
6 6
```
7 7
$ sbgrid-admin -h
8
-sbgrid-admin: a tool for administering an SBGrid Software suite installation
8
+sbgrid-admin: a tool for administering an BioGrids Software suite installation
9 9
10 10
Usage: sbgrid-admin [-chirstu]
11 11
... ...
@@ -19,9 +19,9 @@ Usage: sbgrid-admin [-chirstu]
19 19
-u Force manual update of an existing installation.
20 20
```
21 21
22
-The most commonly used option is *sbgrid-admin -u* to force a manual update. This will synchronize your local installation with the SBGrid master installation hosted at Harvard Medical School.
22
+The most commonly used option is *sbgrid-admin -u* to force a manual update. This will synchronize your local installation with the BioGrids master installation hosted at Harvard Medical School.
23 23
24
-The SBGrid software configuration files use both static and dynamically generated files. The main shell initialization files, **/programs/sbgrid.cshrc** and **/programs/sbgrid.shrc** are static files, but the operating-system specific configurations are dynamically generated and customized for the packages available at your site. *sbgrid-admin -r* will regenerate the branch-specific configuration files should you accidentally delete or alter them.
24
+The BioGrids software configuration files use both static and dynamically generated files. The main shell initialization files, **/programs/biogrids.cshrc** and **/programs/biogrids.shrc** are static files, but the operating-system specific configurations are dynamically generated and customized for the packages available at your site. *sbgrid-admin -r* will regenerate the branch-specific configuration files should you accidentally delete or alter them.
25 25
26 26
Configuration Options
27 27
The *sbgrid-admin* script has some additional configuration options to accommodate the installation requirements at different sites.
... ...
@@ -32,8 +32,8 @@ Options take the form of *OPTION_NAME="setting"*.
32 32
33 33
| **Option** |** Example** | **Description** |
34 34
|:------------- |:-------------:| :---------------|
35
-| SB_SITENAME | sbgrid-bene | The site name for your installation provided by SBGrid |
36
-| SB_SITEKEY | xyxyxyxyxyxyxy | The installation key for your site provided by SBGrid |
35
+| SB_SITENAME | sbgrid-bene | The site name for your installation provided by BioGrids |
36
+| SB_SITEKEY | xyxyxyxyxyxyxy | The installation key for your site provided by BioGrids |
37 37
| INSTALL_TARGET| /nfs/programs | The installation directory for the software |
38 38
| RSYNC_ARGS | "--port 8080"| Advanced arguments to rsync. Can be used to workaround blocked rsync ports. |
39 39
| HTTP_PROXY | host.name:port | Proxy hostname and port for use by rsync and curl |
installation_overview.md
... ...
@@ -1,6 +1,6 @@
1
-### Installing the SBGrid software collection
1
+### Installing the BioGrids software collection
2 2
3
-The SBGrid Software Suite contains 400+ Scientific software applications for [Linux and OS X](operatingsystems).
3
+The BioGrids Software Suite contains 400+ Scientific software applications for [Linux and OS X](operatingsystems).
4 4
5 5
The software can be installed using one of 3 methods:
6 6
... ...
@@ -13,9 +13,9 @@ This is ideal for large labs, shared and departmental installations that use a s
13 13
The MacOS GUI installation client allows users to select the applications they need when they need them through a MacOS-native graphical client. Applications are updated on a rolling basis and are available to the user at their convenience. Updates are reported to be available, but are managed by the user.
14 14
15 15
16
-[* Command line installation using the SBGrid package mangager for Linux and MacOS ](client_CLI_install)
16
+[* Command line installation using the BioGrids package mangager for Linux and MacOS ](client_CLI_install)
17 17
18 18
19
-The SBGrid CLI tool allows users to choose the titles they wish to install using a command-line driven package manager. Applications can be installed and updated as convenient. Updates are released on a rolling basis and can be installed by the user as necessary. This client can be made automatic or used in manual mode.
19
+The BioGrids CLI tool allows users to choose the titles they wish to install using a command-line driven package manager. Applications can be installed and updated as convenient. Updates are released on a rolling basis and can be installed by the user as necessary. This client can be made automatic or used in manual mode.
20 20
21 21
Member labs may use any/all of the installation types above for as many Computers as they require. 
managing_install.md
... ...
@@ -1,8 +1,8 @@
1
-# HOWTOs: SBGrid Installation Notes
1
+BioGrids# HOWTOs: BioGrids Installation Notes
2 2
3 3
## Site Configuration
4 4
5
-The SBGrid Software Suite is designed to be installed on a single computer at your site, which will then share that installation with all the workstations on your network via NFS.
5
+The BioGrids Software Suite is designed to be installed on a single computer at your site, which will then share that installation with all the workstations on your network via NFS.
6 6
We refer to this computer as the site "master" server.
7 7
8 8
The master server will require at least 250 GB of free disk space on a case-sensitive file system and must run some variety of UNIX. The installation script will download the software branches you select, and then install a cron job that will run regularly to check for updates.
... ...
@@ -49,8 +49,8 @@ Once the email has been received and your information has been entered into our
49 49
50 50
## Post-Installation Steps
51 51
52
- 1. Add a symlink in the root directory of each machine that wants to use the software. The installation script will print the suggested syntax for the command.`ln -s /path/to/sbgrid/installation /programs`
53
- 2. Any user that wishes to use the software needs to configure their shell to initialize the SBGrid shell environment. For bash and other sh-compliant shells, add the following line to your ~/.bash_profile or ~/.bashrc: `. /programs/sbgrid.shrc` For csh and tcsh, add the following line to your ~/.cshrc: `source /programs/sbgrid.cshrc`
52
+ 1. Add a symlink in the root directory of each machine that wants to use the software. The installation script will print the suggested syntax for the command.`ln -s /path/to/biogrids/installation /programs`
53
+ 2. Any user that wishes to use the software needs to configure their shell to initialize the BioGrids shell environment. For bash and other sh-compliant shells, add the following line to your ~/.bash_profile or ~/.bashrc: `. /programs/biogrids.shrc` For csh and tcsh, add the following line to your ~/.cshrc: `source /programs/biogrids.cshrc`
54 54
3. For some linux distributions, the shipped version of tcsh does not support shell variables longer than 4096 characters. Since the current PATH in our default shell initialization is larger than that, you will need to update tcsh. RPMs for Red Hat 4/5 and CentOS 4/5 are provided at /programs/i386-linux/system/RPMS.
55 55
56 56
operatingsystems.md
... ...
@@ -1,6 +1,6 @@
1 1
## Supported Operating Systems
2 2
3
-The SBGrid Software Suite can run on Linux, OS X and IRIX machines.
3
+The BioGrids Software Suite can run on Linux, OS X and IRIX machines.
4 4
5 5
### Linux
6 6
We build and test software under 64-bit Red Hat 6. The majority of our Linux users are using the Red Hat/CentOS/Scientific Linux or Fedora distributions, but we also have labs using the software with Ubuntu, Debian and OpenSuSE. We don't explicitly test the software on these distributions, but it is known to work, and we will work to resolve problems reported by users of these Linux distributions.
... ...
@@ -18,7 +18,7 @@ We build and test the programs under the most five most recent OS X releases.
18 18
Currently Supported:
19 19
20 20
* OS X Intel 10.9 - 10.12
21
-* As above with earlier versions of linux, there are many software applications that are fully functional on earlier versions of MacOSX in the SBGrid tree. We work to maintain an environment compatible with these OS versions, though they may not receive the latest applications available.
21
+* As above with earlier versions of linux, there are many software applications that are fully functional on earlier versions of MacOSX in the BioGrids tree. We work to maintain an environment compatible with these OS versions, though they may not receive the latest applications available.
22 22
23 23
## OS X PowerPC
24 24
The OS X PowerPC branch is currently frozen. The applications are stable and work well on our PowerPC hardware, but they are not being updated.
recommended.md
... ...
@@ -1,7 +1,7 @@
1 1
# Recommended Hardware
2 2
3 3
## Linux Workstations
4
-SBGrid's preferred hardware vendor is [ThinkMate](http://thinkmate.com) and we have some [recommended configurations](http://www.thinkmate.com/sbgrid) for structural biology computing. Please feel free to contact us at help@sbgrid.org regarding upcoming hardware purchases if you have questions - we'd be happy to advise.
4
+BioGrids's preferred hardware vendor is [ThinkMate](http://thinkmate.com) and we have some [recommended configurations](http://www.thinkmate.com/sbgrid) for structural biology computing. Please feel free to contact us at help@sbgrid.org regarding upcoming hardware purchases if you have questions - we'd be happy to advise.
5 5
6 6
## Apple Workstations
7
-Any Apple machine can be a capable computer for structural biology. The basic Apple educational discount is available through their online web store, and your institution may have negotiated an even better deal with their Apple representative. SBGrid has several labs that run exclusively on Macs and OS X.
7
+Any Apple machine can be a capable computer for structural biology. The basic Apple educational discount is available through their online web store, and your institution may have negotiated an even better deal with their Apple representative. BioGrids has several labs that run exclusively on Macs and OS X.
resources.md
... ...
@@ -1,85 +0,0 @@
1
-# Development Network
2
-
3
-The basic account is a UNIX shell account accessible via SSH. This network account will let you access designated machines in the developer network. Along with the shell account you also get up to 10 GB of data storage, access to high performance compilers, basic development tools like version control systems (svn, git, etc) and shell text editors.
4
-
5
-Once you have an account, you can access the developer network by connecting via SSH to:
6
-
7
- *developer.sbgrid.org*
8
-
9
- developer runs Scientific Linux 6 x86_64
10
-
11
-This machine (internally named sbgrid-dev-architect) is the only external facing host on the network, and it hosts your home directory and acts as the SSH bastion host for the network. From this machine you can SSH to any of the build and test hosts via their hostname in the table below in order to compile software, run tests, etc.
12
-
13
-The following are the always-on operating system/hardware combinations. They are generally kept at the latest point release:
14
-
15
-| Hostname | Operating System | Architecture | Notes |
16
-| ------------------ | --------------- | ----------- | ----------------------------------------- |
17
-| sbgrid-c5b | CentOS 5 | x86 | base SBGrid 32-bit Linux build VM |
18
-| sbgrid-c5b-64 | CentOS 5 | x86_64 | base SBGrid 64-bit Linux build VM |
19
-| sbgrid-c5t-64 | CentOS 5 | x86_64 | minimal install for portability testing |
20
-| sbgrid-c6b | CentOS 6 | x86 | base SBGrid 32-bit Linux build VM |
21
-| sbgrid-c6b-64 | CentOS 6 | x86_64 | base SBGrid 64-bit Linux build VM |
22
-| sbgrid-c6t-64 | CentOS 6 | x86_64 | minimal install for portability testing |
23
-| sbgrid-dev-vm-07 | Debian 5 | x86 | |
24
-| sbgrid-dev-vm-08 | Debian 5 | x86_64 | |
25
-| sbgrid-dev-vm-16 | Debian 6 | x86 | |
26
-| sbgrid-dev-vm-17 | Debian 6 | x86_64 | |
27
-| sbgrid-dev-vm-03 | Ubuntu 10.10 | x86 | |
28
-| sbgrid-dev-vm-04 | Ubuntu 10.10 | x86_64 | |
29
-| sbgrid-dev-vm-14 | OpenSuSE 11.3 | x86 | |
30
-| sbgrid-dev-vm-15 | OpenSuSE 11.3 | x86_64 | |
31
-| sbgrid-m106 | OS X 10.6 | x86/x86_64 | Base SBGrid OS X Intel build machine |
32
-| sbgrid-m107 | OS X 10.7 | x86/x86_64 | |
33
-| sbgrid-m108 | OS X 10.8 | x86/x86_64 | |
34
-| sbgrid-m109 | OS X 10.9 | x86/x86_64 | |
35
-| sbgrid-m1010 | OS X 10.10 | x86/x86_64 | |
36
-| sbgrid-dev-flange | OS X 10.5 | PowerPC | |
37
-
38
-
39
-We have the Intel, Portland and Absoft (PPC) compilers:
40
-
41
-* Intel 12.0, 11.1, 10.1 (ifc, ifort) - any linux host, OS X Intel hosts
42
-* Portland 14.4, 12.6, 10.9, 10.2, 9.0-1 (pgcc, pgf77/90/95) - sbgrid-dev-architect, sbgrid-dev-moose
43
-
44
-There is a configuration file for sh-compatible shells that will enable the compilers and their environmental settings:
45
-
46
- $ . /build/conf/buildenv.sh
47
-
48
-Then you can use the 'build' function to control your compiler settings:
49
-
50
- $ build help
51
- build: a shell function for controlling compilers
52
-
53
- Usage: build (help3264list)
54
-
55
- help This help message
56
- 32 Configure 32-bit compilers
57
- 64 Configure 64-bit compilers
58
- list List available compilers
59
-
60
-Additionally, there are other operating systems available as virtual machines that can be enabled (OpenSuSE, Ubuntu, Fedora, etc), and some additional hardware that can be made available (Sun SPARC, IRIX MIPS, etc) on request.
61
-
62
-Graphical access to the machines may be available through Apple Remote Desktop, VNC or the NoMachine desktop sharing client. Other tools could be made available if necessary as well. The whole thing's a bit of an experiment, really, so email us at `<bugs@sbgrid.org>`, and we'll see what we can work out.
63
-
64
-# Request an Account
65
-
66
-Thanks for your interest in participating in the SBGrid Developer Network.
67
-
68
-In order to be eligible for an account, you must have software in the SBGrid software suite or be planning to make your software available through SBGrid. This requirement limits accounts to developers of scientific software used in structural biology and related disciplines.
69
-
70
-That's the only requirement for new accounts. In return for access to these resources, you must agree to not abuse the resources for:
71
-
72
-* sending spam
73
-* cracking our computers or other peoples' computers
74
-* other activity which is illegal in the USA or your country
75
-
76
-And you agree to take reasonable precautions to maintain the security of your password and account by not sharing this information with other people.
77
-On our end, we will:
78
-
79
-* take reasonable precautions to maintain the security of the network, accounts and data
80
-* make occasional backups of account data (but don't count on it!)
81
-* attempt to maintain a high availability of the developer resources
82
-
83
-We reserve the right to close accounts at any time for any reason.
84
-
85
-Still interested? Great! We want to work with you, so please email `<bugs@sbgrid.org>` with your account request, and we'll get back to you as soon as possible.
stereo.md
... ...
@@ -1,83 +0,0 @@
1
-## General
2
-
3
-### 3D Stereo on RHEL/CentOS 6 systems
4
-
5
-Nvidia 3d stereo on RHEL 6 is reasonably straight-forward.
6
-Take a look [here](xorg_conf) for an example xorg.conf file. This configuration if for a Quadro 4000 card and a 1920x1080 display. Your settings may vary depending on your hardware.
7
-
8
-### 3D Stereo on RHEL/CentOS 7 systems with Gnome 3
9
-
10
-Nvidia 3D stereo typically requires disabling the Composite extension in X.org. Unfortunately, this extension is required to run Gnome 3 and the gdm login mangager supplied as the default desktop in CentOS and many other linux distributions.
11
-
12
-As of version 337.19 of the nvidia driver, some Quadro configurations can operate with the composite extension enabled, but stereo functionality depends on a stereo-aware composite manager. The Composite manager in CentOS7 Gnome3 is not stereo aware and 3D stereo does not work by default.
13
-
14
-In order to use 3D stereo on Gnome3 systems, you can switch from Gnome3/gdm to MATE/lightdm.
15
-The MATE Desktop Environment is the continuation of GNOME 2 which is the default desktop in CentOS 5 and 6.
16
-
17
-To change to MATE on CentOS7 systems, first, install the Extra Packages for Enterprise Linux (EPEL) repo:
18
-
19
-
20
- yum install epel-release
21
-
22
-
23
-Then install the nvidia drivers from epel
24
-
25
-
26
- yum install kmod-nvidia
27
-
28
-
29
-You may find you need these packages as well
30
-
31
-
32
- yum install mesa-libGLU-9.0.0-4.el7.x86_64 libXScrnSaver-1.2.2-6.1.el7.x86_64
33
-
34
-
35
-Next, install lightdm which doesn't require the composite extension.
36
-
37
-
38
- yum install lightdm
39
-
40
-
41
-From there we do a couple of groupinstalls
42
-You may have these rpms installed already, but just for good measure
43
-
44
-
45
- yum group install "X Window System"
46
-
47
-
48
-then
49
-
50
-
51
- yum groupinstall "MATE Desktop"
52
-
53
-
54
-Toggle from gdm to lightdm in systemd using systemctl.
55
-To see what you are using as a 'display manager', check this link
56
-
57
-
58
- ls -l /etc/systemd/system/display-manager.service
59
-
60
-
61
-This is likely pointing to gdm and should be changed to point to lightdm.
62
-You can change that with systemctl.
63
-
64
-
65
- systemctl disable gdm
66
- systemctl enable lightdm
67
-
68
-
69
-And then this will reload you changes, similar to changing runlevels with sysinitV
70
-
71
-
72
- systemctl isolate graphical.target
73
-
74
-
75
-Make sure to select MATE from the drop menu as your graphical before you login.
76
-## Mac OS X
77
-
78
-* Prior to OS X 10.8, the stock X11 has better compatibility than the Xquartz development version available from MacOSForge. With the OS X 10.8 release, X11 is no longer included by Apple, and you'll need to install the latest Xquartz version offered on the MacOSForge site to run X11-based applications.
79
-
80
-## Laptops
81
-
82
-* You can create a local installation to take along with you.
83
-http://www.sbgrid.org/wiki/laptopinstall
versions.md
... ...
@@ -1,6 +1,6 @@
1 1
# Overriding Software Versions
2 2
3
-Most of the software titles installed in the SBGrid software collection have several versions available. We try to provide at least three versions of each software package, although very old or very new applications may have fewer versions.
3
+Most of the software titles installed in the BioGrids software collection have several versions available. We try to provide at least three versions of each software package, although very old or very new applications may have fewer versions.
4 4
5 5
## Display Available Versions
6 6