00fac4239a88e0f3093579070390555ae1f8810e
client_CLI_usage.md
... | ... | @@ -8,221 +8,206 @@ For information on how to run software from the BioGrids collection and configur |
8 | 8 | ### General |
9 | 9 | The BioGrids software installation client is a command line-based installer for the BioGrids software collection. The application allows for selected applications to be installed in the familiar BioGrids environment. |
10 | 10 | |
11 | -The client displays software 'Collections' as a list. |
|
11 | +To get started, load the BioGrids environment : |
|
12 | 12 | |
13 | - $ sbgrid list |
|
13 | + $ source /programs/biogrids.shrc |
|
14 | 14 | |
15 | 15 | ``` |
16 | -Crystallography |
|
17 | - 3dna |
|
18 | - adxv |
|
19 | - albula |
|
20 | - autoproc |
|
21 | - ... |
|
22 | - |
|
23 | -NMR |
|
24 | - aqua |
|
25 | - aria |
|
26 | - cara |
|
27 | - ccpnmr |
|
28 | - ccpnmr-chembuild |
|
29 | - ... |
|
30 | - |
|
31 | -Electron Microscopy |
|
32 | - 2dx |
|
33 | - ace2 |
|
34 | - auto3dem |
|
35 | - bfactor |
|
36 | - bsoft |
|
37 | - burnham-brandeis-helical-package |
|
38 | - chimera |
|
39 | - ... |
|
40 | - |
|
41 | -Structure Visualization & Analysis |
|
42 | - 3dna |
|
43 | - anaconda |
|
44 | - apbs |
|
45 | - aqua |
|
46 | - bobscript |
|
47 | - caver |
|
48 | - caver-analyst |
|
49 | - ccp4mg |
|
50 | - chimera |
|
51 | - ... |
|
52 | - |
|
53 | -Computational Chemistry |
|
54 | - ambertools |
|
55 | - apbs |
|
56 | - appion |
|
57 | - autodock |
|
58 | - autodock-vina |
|
59 | - avogadro |
|
60 | - concoord |
|
61 | - dock |
|
62 | - gromacs |
|
63 | - ... |
|
64 | - |
|
65 | -Other |
|
66 | - a2ps |
|
67 | - abyss |
|
68 | - aline |
|
69 | - amigos-ii |
|
70 | - amps |
|
71 | - assemble2 |
|
72 | - bamtools |
|
73 | - ... |
|
16 | +******************************************************************************** |
|
17 | + Software Support by BioGrids |
|
18 | +******************************************************************************** |
|
19 | + Developed with support from HMS Tools-and-Technologies fund. |
|
20 | + If your use of BioGrids compiled software was an important element in |
|
21 | + your publication, please include the following statement in your work: |
|
22 | + "Software used in the project was installed and configured by BioGrids |
|
23 | + (cite: eLife 2013;2:e01456, Collaboration gets the most out of software.)" |
|
24 | +******************************************************************************** |
|
25 | +This BioGrids installation last updated: 2017-10-11 |
|
26 | + Please submit bug reports and help requests to: help@biogrids.org. |
|
27 | +******************************************************************************** |
|
28 | + Capsule Status: Active |
|
29 | + For additional information visit https://sbgrid.org/wiki/capsules |
|
30 | +****************************************************************** |
|
74 | 31 | ``` |
75 | 32 | |
76 | -Information about each title, including a description and links to documentation can be show with the *sbgrid info <title>* command. |
|
77 | 33 | |
78 | -### Example : Installing Albula |
|
34 | +The client displays software 'Collections' as a list. |
|
79 | 35 | |
80 | - $ sbgrid info albula |
|
36 | + $ biogrids list |
|
81 | 37 | |
82 | 38 | ``` |
83 | -Package: ALBULA |
|
84 | -Name : albula |
|
85 | - |
|
86 | -Available versions: |
|
87 | -* 3.2.0-2 (default) |
|
88 | -* 3.1.0-13 |
|
89 | -* 3.0.0-14 |
|
90 | -* 2.2.12 |
|
39 | +-- High-Throughput Sequencing ----------------------------------------------------------------- |
|
40 | +abyss blat diamond miso solexaqaplusplus |
|
41 | +bamtools bowtie ebseq mothur spades |
|
42 | +bcftools bowtie-2 edger picard sra-toolkit |
|
43 | +bedtools breseq fasta pysam star |
|
44 | +bigpre bwa fastqc quartz tophat |
|
45 | +bioawk cora hisat2 rsem trimmomatic |
|
46 | +biobambam2 cufflinks kallisto sailfish gorpipe |
|
47 | +blast cutadapt macs2 salmon |
|
48 | +blastplus deseq2 mica samtools |
|
49 | +-- Genomics ----------------------------------------------------------------------------------- |
|
50 | +bedtools ffp mrbayes sam sra-toolkit |
|
51 | +bioawk infernal plink solexaqaplusplus |
|
52 | +-- Proteomics --------------------------------------------------------------------------------- |
|
53 | +amps mafft modeller rosetta zdock |
|
54 | +-- Visualization ------------------------------------------------------------------------------ |
|
55 | +aline cytoscape igv pymol-open-source weblogo |
|
56 | +-- Other -------------------------------------------------------------------------------------- |
|
57 | +a2ps cython miso python |
|
58 | +anaconda emboss mono pytz |
|
59 | +biogrids-installer fasta mpich qt |
|
60 | +blast ghostscript numpy r |
|
61 | +blastplus globus-connect-personal pandas rstudio |
|
62 | +breseq mafft perl tex-live |
|
63 | +``` |
|
91 | 64 | |
92 | -Collection(s): Crystallography |
|
65 | +Information about each title, including a description and links to documentation can be shown with the *biogrids info <title>* command. |
|
93 | 66 | |
94 | -Description: |
|
95 | - consists of the standalone program ALBULA VIEWER, a fast and easy-to- |
|
96 | -use program that allows optimal visualization of PILATUS and EIGER data, |
|
97 | -and ALBULA API, a Python programming interface for displaying images and |
|
98 | -performing operations and calculations. The API enables you to easily |
|
99 | -integrate the viewer functionality into your beamline infrastructure or |
|
100 | -experimental setup. |
|
67 | +### Example : Installing samtools |
|
101 | 68 | |
102 | -Links: |
|
103 | -* Website: https://www.dectris.com/Albula_Overview.html |
|
104 | 69 | ``` |
70 | +$ ./biogrids info samtools |
|
105 | 71 | |
106 | -To install: |
|
72 | +Package: SAMtools |
|
73 | +Name slug: samtools |
|
107 | 74 | |
108 | - $ sbgrid install albula |
|
75 | +Available versions: |
|
76 | + * 0.1.19 |
|
77 | + * 1.3 |
|
78 | + * 1.3.1 |
|
79 | + * 1.4.1 |
|
80 | + * 1.5 (default) |
|
109 | 81 | |
110 | -``` |
|
111 | -Installing: albula |
|
112 | -Updating installation configuration... |
|
113 | -Installation was successfull! |
|
114 | -``` |
|
82 | +Grids(s): Biogrids |
|
83 | +Collection(s): High-Throughput Sequencing |
|
115 | 84 | |
116 | -To get started, load the BioGrids environment : |
|
85 | +Description: |
|
86 | + (Sequence Alignment/Map) a generic format for storing large nucleotide |
|
87 | +sequence alignments that provides various utilities for manipulating |
|
88 | +alignments, including sorting, merging, indexing and generating alignments |
|
89 | +in a per-position format. |
|
117 | 90 | |
118 | - $ source /programs/sbgrid.shrc |
|
91 | +Links: |
|
92 | + Website: http://www.htslib.org/ |
|
93 | + Manual: http://www.htslib.org/doc/samtools.html |
|
94 | + Forum help: https://lists.sourceforge.net/lists/listinfo/samtools-help``` |
|
119 | 95 | |
96 | +To install: |
|
120 | 97 | ``` |
121 | - Software Support by BioGrids (www.sbgrid.org) |
|
122 | -******************************************************************************** |
|
98 | +$ biogrids install samtools |
|
123 | 99 | |
124 | -... |
|
100 | +samtools@1.5 for i386-mac installed |
|
101 | +Updating installation configuration... |
|
125 | 102 | |
126 | -BioGrids installation last updated: 2016-10-21 |
|
127 | -Please submit bug reports and help requests to: <bugs@sbgrid.org> or |
|
128 | - <http://sbgrid.org/bugs> |
|
129 | -******************************************************************************** |
|
130 | 103 | ``` |
131 | 104 | |
132 | -### Example : Removing Albula |
|
133 | 105 | |
134 | - $ sbgrid remove albula |
|
106 | +### Example : Removing samtools |
|
107 | + |
|
108 | + $ biogrids remove samtools |
|
135 | 109 | |
136 | 110 | results in : |
137 | 111 | |
138 | 112 | ``` |
139 | -Removing: albula |
|
113 | +Package samtools removed. |
|
140 | 114 | Updating installation configuration... |
141 | -Package removed! |
|
142 | 115 | ``` |
143 | 116 | |
144 | 117 | ### Version selection |
145 | 118 | |
146 | -Default versions are installed by default for each application, though individual versions can be selected for each title. |
|
119 | +Default versions are installed for each application. BioGrids makes available several versions for each software package. You can install specific versions if needed. |
|
147 | 120 | |
148 | -To do so, include the version after the title followed the version. To see what versions are available, use the *sbgrid info <title>* command. Let;s us the title epmr as an example here: |
|
121 | +To do so, specify the version after the title name with an @ symbol. Use the *biogrids info <title>* command to see all available versions. |
|
149 | 122 | |
150 | - $ sbgrid info epmr |
|
123 | + $ biogrids info samtools |
|
151 | 124 | |
152 | 125 | ``` |
153 | -Package: EPMR |
|
154 | -Name slug: epmr |
|
126 | +Package: SAMtools |
|
127 | +Name slug: samtools |
|
155 | 128 | |
156 | 129 | Available versions: |
157 | -* 16.04 (default) |
|
158 | -* 16.01 |
|
159 | -* 15.12 |
|
160 | -* 15.04 |
|
161 | -* 13.07 |
|
162 | -* 11.02 |
|
130 | + * 0.1.19 |
|
131 | + * 1.3 |
|
132 | + * 1.3.1 |
|
133 | + * 1.4.1 |
|
134 | + * 1.5 (default) |
|
163 | 135 | |
164 | -Collection(s): Crystallography |
|
136 | +Grids(s): Biogrids |
|
137 | +Collection(s): High-Throughput Sequencing |
|
165 | 138 | |
166 | 139 | Description: |
167 | - a program that finds crystallographic molecular replacement solutions |
|
168 | -using an evolutionary search algorithm. The program directly optimizes |
|
169 | -three rotational and three positional parameters for the search model with |
|
170 | -respect to the correlation coefficient between Fo and Fc. |
|
140 | + (Sequence Alignment/Map) a generic format for storing large nucleotide |
|
141 | +sequence alignments that provides various utilities for manipulating |
|
142 | +alignments, including sorting, merging, indexing and generating alignments |
|
143 | +in a per-position format. |
|
171 | 144 | |
172 | 145 | Links: |
173 | -* Website: http://www.epmr.info/ |
|
174 | -* Manual: http://www.epmr.info/UsersGuide.html |
|
175 | -``` |
|
146 | + Website: http://www.htslib.org/ |
|
147 | + Manual: http://www.htslib.org/doc/samtools.html |
|
148 | + Forum help: https://lists.sourceforge.net/lists/listinfo/samtools-help |
|
149 | + ``` |
|
176 | 150 | |
177 | -To install version 11.02, add the version string like so: |
|
151 | +To install samtools version 1.4.1, add the version string like so: |
|
178 | 152 | |
179 | - $ sbgrid install epmr 11.02 |
|
153 | + $ biogrids install samtools@1.4.1 |
|
180 | 154 | |
181 | 155 | which will produce : |
182 | 156 | |
183 | 157 | ``` |
184 | -Installing: epmr (11.02) |
|
185 | -Updating installation configuration... |
|
186 | -Installation was successfull! |
|
187 | -key@key-mbp [20161021-21:05:56] ~/Downloads |
|
158 | +samtools@1.4.1 for i386-mac installed |
|
159 | +Updating installation configuration.. |
|
188 | 160 | ``` |
189 | 161 | |
190 | -Check which versions are installed with the sbgrid info command again |
|
162 | +Check which versions are installed with the biogrids info command again |
|
191 | 163 | |
192 | - $ sbgrid info epmr |
|
164 | + $ biogrids info samtools |
|
193 | 165 | |
194 | 166 | ``` |
195 | -epPackage: EPMR |
|
196 | -Name slug: epmr |
|
167 | +Package: SAMtools |
|
168 | +Name slug: samtools |
|
197 | 169 | |
198 | 170 | Available versions: |
199 | -* 16.04 (default) |
|
200 | -* 16.01 |
|
201 | -* 15.12 |
|
202 | -* 15.04 |
|
203 | -* 13.07 |
|
204 | -* 11.02 (installed) |
|
171 | + * 0.1.19 |
|
172 | + * 1.3 |
|
173 | + * 1.3.1 |
|
174 | + * 1.4.1 (installed) |
|
175 | + * 1.5 (default) |
|
205 | 176 | |
206 | -... |
|
177 | +Grids(s): Biogrids |
|
178 | +Collection(s): High-Throughput Sequencing |
|
207 | 179 | |
208 | -``` |
|
180 | +Description: |
|
181 | + (Sequence Alignment/Map) a generic format for storing large nucleotide |
|
182 | +sequence alignments that provides various utilities for manipulating |
|
183 | +alignments, including sorting, merging, indexing and generating alignments |
|
184 | +in a per-position format. |
|
185 | + |
|
186 | +Links: |
|
187 | + Website: http://www.htslib.org/ |
|
188 | + Manual: http://www.htslib.org/doc/samtools.html |
|
189 | + Forum help: https://lists.sourceforge.net/lists/listinfo/samtools-help``` |
|
190 | + |
|
191 | +Reload the biogrids shell to use the new version ( or set the environment variable SAMTOOLS_M=1.4.1 ). |
|
192 | + |
|
193 | + $ source /programs/biogrids.shrc |
|
209 | 194 | |
210 | 195 | Confirm with the *sbwhich* command |
211 | 196 | |
212 | 197 | |
213 | - $ sbwhich epmr |
|
198 | + $ sbwhich samtools |
|
214 | 199 | ``` |
215 | -/programs/i386-mac/epmr/11.02/epmr |
|
200 | +/programs/i386-mac/samtools/1.5/bin/samtools |
|
216 | 201 | ``` |
217 | 202 | |
218 | -Reload the sbgrid shell to use the new version ( or set the environment variable EPMR_M=11.02 ). |
|
219 | 203 | |
220 | -### Software Versions Management in the BioGrids environment |
|
204 | + |
|
205 | +### Software Version Management in the BioGrids environment |
|
221 | 206 | If you have a single version of an application installed, explicit version selection in your environment is not needed. |
222 | 207 | |
223 | 208 | In the case of multiple installed versions, the *BioGrids Default* version will be the version available at the terminal when it is installed, unless configured otherwise in *~/.sbgrid.conf*. |
224 | 209 | |
225 | -In the case of multiple non-default versions installed, the *latest release* will be version available in your shell. If you would like to have more than one version of a title installed, and prefer to use an older release or the non-default version when a default version is installed, you must set this explicitly in your *~/.sbgrid.conf* file. This is the same as in the standard BioGrids environment. |
|
210 | +In the case of multiple non-default versions installed, the *latest release* will be the version available in your shell. If you would like to have more than one version of a title installed, and prefer to use an older release or the non-default version when a default version is installed, you must set this explicitly in your *~/.sbgrid.conf* file. This is the same as in the standard BioGrids environment. |
|
226 | 211 | |
227 | 212 | **Version priority in the shell** |
228 | 213 | 1. *~/.sbgrid.conf* |
... | ... | @@ -236,18 +221,18 @@ There is more info on how to do that here --> [BioGrids version overrides](vers |
236 | 221 | |
237 | 222 | To use the software at the terminal in bash, open a new terminal and run |
238 | 223 | |
239 | - $ source /programs/sbgrid.shrc |
|
224 | + $ source /programs/biogrids.shrc |
|
240 | 225 | |
241 | 226 | or in tcsh |
242 | 227 | |
243 | - $ source /programs/sbgrid.cshrc |
|
228 | + $ source /programs/biogrids.cshrc |
|
244 | 229 | |
245 | 230 | ### Questions, Problems and Known Issues |
246 | -For questions or problems, the Help menu will direct to the BioGrids help page. Or just email *bugs@sbgrid.org*. |
|
247 | -If relevant, please include a screenshot of the GUI if possible (command + shift + 4) and please include the ~/Library/Application Support/BioGrids/sbgrid.log file with your report. |
|
231 | +For questions or problems, the Help menu will direct you to the BioGrids help page. Or just email *help@biogrids.org*. |
|
232 | +If relevant, please include a screenshot of the GUI if possible (command + shift + 4) and please include the ~/Library/Application Support/BioGrids/biogrids.log file with your report. |
|
248 | 233 | |
249 | 234 | **Known issues** |
250 | 235 | |
251 | 236 | * The application will fail if outbound port 873 and port 8080 are blocked by your institution or are otherwise not available. |
252 | 237 | |
253 | -* In some cases the prompt for admin credentials fails to appear on activation. Be sure there is no prior BioGrids install on your machine at /programs or /opt/sbgrid. |
|
238 | +* In some cases the prompt for admin credentials fails to appear on activation. Be sure there is no prior BioGrids install on your machine at /programs or /opt/biogrids. |