usage/versions
... ...
@@ -1 +0,0 @@
1
-../overrides.md
... ...
\ No newline at end of file
usage/versions.md
... ...
@@ -0,0 +1,71 @@
1
+# Overriding Software Versions
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.
4
+
5
+## Display Available Versions
6
+
7
+To list the available versions of a software title, you can use the *sbgrid* utility. Running *sbgrid -l* will list the versions for your current platform. From a Linux machine, a search for CCP4 versions looks like this:
8
+
9
+
10
+ $ sbgrid -l ccp4
11
+ Version information for: /programs/x86_64-linux/ccp4
12
+
13
+ Default version: 7.0
14
+ In-use version: 6.5
15
+ Other available versions: 6.4.0 6.3.0
16
+ Overrides use this shell variable: CCP4_X
17
+
18
+
19
+Running *sbgrid -L* will print the available versions for the three current platforms (OS X PowerPC and Intel, Linux).
20
+
21
+
22
+ $ sbgrid -L gnuplot
23
+ Version information for: /programs/x86_64-linux/gnuplot
24
+
25
+ Default version: 4.6.4
26
+ In-use version: 4.6.4
27
+ Other available versions: 4.6.0 4.4.3 4.2.6
28
+ Overrides use this shell variable: GNUPLOT_X
29
+
30
+ Version information for: /programs/i386-linux/gnuplot
31
+
32
+ Default version: 4.6.0
33
+ Other available versions: 4.4.3 4.2.6
34
+ Overrides use this shell variable: GNUPLOT_L
35
+
36
+ Version information for: /programs/i386-mac/gnuplot
37
+
38
+ Default version: 4.6.4
39
+ Other available versions: 4.4.3 4.2.6 4.6.0
40
+ Overrides use this shell variable: GNUPLOT_M
41
+
42
+
43
+## Overriding Default Versions
44
+
45
+To override the default version of a software title, you need to create an override file. The shell configuration scripts will read this file and override the default version.
46
+
47
+The override file is named .sbgrid.conf and should be placed in your $HOME directory. The syntax for overrides is a simple key=value pair. E.g. it should look like this:
48
+
49
+`APPLICATION_X=1.2`
50
+
51
+APPLICATION_X is the name of the application followed by an underscore and the shorthand initial for the architecture. The last field on the line is the software version number you want to use. The initials for each software branch are:
52
+
53
+ | Software Directory | Shorthand Initial |
54
+ | :----------------- | :---------------- |
55
+ | i386-linux | _L |
56
+ | x86_64-linux | _X |
57
+ | i386-mac | _M |
58
+
59
+To quickly open the overrides file in your default $EDITOR, you can run *sbgrid-overrides -e*.
60
+
61
+When you open a new shell, you will see a message about the overridden version. Note that a site administrator can create sitewide or machine-specific overrides as well.
62
+
63
+The example output below shows CCP4 on linux being changed from the default version:
64
+
65
+ Configuration options in effect for this shell:
66
+ Variable Setting Configuration
67
+ CCP4_M 6.3.0 personal
68
+
69
+
70
+## Disabling a Software Package
71
+To disable a specific software package, set its version to "disable" in your ~/.sbgrid.conf file.