tutorials.md
... ...
@@ -3,5 +3,77 @@
3 3
4 4
### BioGrids on Amazon Web Services (AWS)
5 5
6
+You can easily reproduce your bioinformatics working environment with the BioGrids installer.
6 7
7
-### BioGrids Tools
8
+The HMS Orchestra cluster makes available all BioGrids software packages by default.
9
+
10
+With a few commands, you can install and use the same
11
+versions of bioinformatics software on your Mac laptop and AWS instances
12
+
13
+As a simple example, here is the command to install samtools
14
+on your OS X based Mac:
15
+
16
+`biogrids install samtools`
17
+
18
+This same command can be used to install
19
+on an AWS EC2 instance. Here is a brief
20
+overview of installing BioGrids by command
21
+line on an AWS EC2 instance.
22
+
23
+Start an AWS EC2 instance
24
+
25
+```
26
+aws ec2 run-instances --image-id ami-1609da7e [..other options..]
27
+
28
+```
29
+
30
+Log in to the instance
31
+```
32
+ssh -i "myaws.pem" centos@ec2-54-227-10-10.compute-1.amazonaws.com
33
+```
34
+
35
+Update the base software and install development tools
36
+```
37
+sudo yum update
38
+sudo yum groupinstall "Development Tools"
39
+sudo yum install wget
40
+
41
+```
42
+
43
+
44
+Get the BioGrids CLI installer
45
+```
46
+wget https://biogrids.org/wiki/downloads/biogrids-1.0.555-Linux.tgz
47
+tar zxf biogrids-1.0.555-Linux.tgz
48
+cd biogrids-1.0.555-Linux
49
+```
50
+
51
+Activate the installer
52
+
53
+```
54
+./biogrids activate <your_site> <your_name> <your_key>
55
+```
56
+Install your tools
57
+
58
+```
59
+./biogrids install samtools
60
+./biogrids install tophat
61
+./biogrids install trimmomatic
62
+```
63
+
64
+Verify versions of installed tools:
65
+
66
+```
67
+./biogrids installed
68
+Installed packages:
69
+samtools (1.5)
70
+tophat (2.1.1)
71
+trimmomatic (0.36)
72
+```
73
+
74
+Launch the BioGrids environment:
75
+
76
+```source /programs/biogrids.shrc
77
+```
78
+
79
+That's it! Your environment is now setup and ready for work.