-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathINSTALL.txt
192 lines (112 loc) · 6.21 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
ReproZip currently supports Linux distributions.
If you want to use ReproZip to pack experiments (packing step), your
Linux distribution must be supported by SystemTap and MongoDB, which are the
packages used for the packing step.
If you want to use ReproZip to unpack a reproducible package,
you do not need to have SystemTap and MongoDB.
How to install ReproZip:
1) Download the latest version at https://pypi.python.org/pypi/reprozip
2) After extracting the package, use the following command (you may need root
privileges):
python setup.py install
3) If you want to use ReproZip to pack experiments, you also need to install
both SystemTap and MongoDB.
For Ubuntu (9.10 or higher), Debian and Fedora, ReproZip has a script that
tries to automatically install these dependencies (not fully tested though).
Just use the following command:
reprozip-dep
If you're not using any of these distributions, please run the script anyway so
the log directories and the configuration file can be correctly created.
Note that installing the kernel packages for SystemTap and making it work
can be tricky. So, the script does not guarantee that SystemTap will be
correctly installed - errors may occur.
We suggest you to also take a look at the installation instructions in this
file and follow the links there for additional information.
Automatic installation of dependencies for other distributions is coming.
Please, send an email to [email protected] if you want to have an automatic
installation feature for your favorite Linux distribution in the future, so
we can put it in our TO-DO list :)
Problems while installing SystemTap or MongoDB?
Contact Fernando Chirigati at [email protected] to see if he can help you!
Using Google may also help a lot :)
ReproZip is in a beta version, so please, if you have any bugs while installing
the tool (and dependencies), send an email to [email protected]
********************************************************************************
Manually installing the dependencies on Ubuntu 9.10 or higher:
--------------------------------------------------------------
- Install SystemTap
. sudo apt-get install systemtap
. sudo apt-get install linux-headers-generic gcc libcap-dev
. sudo apt-get install pkg-create-dbgsym
. create file /etc/apt/sources.list.d/ddebs.list
. include the following lines in /etc/apt/sources.list.d/ddebs.list
deb http://ddebs.ubuntu.com $(lsb_release -cs) main restricted universe multiverse
deb http://ddebs.ubuntu.com $(lsb_release -cs)-updates main restricted universe multiverse
deb http://ddebs.ubuntu.com $(lsb_release -cs)-security main restricted universe multiverse
deb http://ddebs.ubuntu.com $(lsb_release -cs)-proposed main restricted universe multiverse
. sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys ECDCAD72428D7C01
. sudo apt-get update
. sudo apt-get install linux-image-$(uname -r)-dbgsym
. Now, it should be installed! Try the following scripts:
sudo stap -ve 'probe begin { log("hello world") exit () }'
sudo stap -v -e 'probe vfs.read {printf("read performed\n"); exit()}'
. For more information on how to install SystemTap on Ubuntu, please refer to
the following links:
http://sourceware.org/systemtap/wiki/SystemtapOnUbuntu
https://lists.ubuntu.com/archives/ubuntu-users/2010-October/229714.html
http://sourceware.org/systemtap/wiki/SystemtapOnUbuntu
- Create log directory
. mkdir $HOME/.reprozip
- Install MongoDB
. Follow instructions at the official website:
http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/#install-mongodb
. create the database directory
. mkdir $HOME/.reprozip/mongodb
********************************************************************************
Manually installing the dependencies on Debian:
-----------------------------------------------
- Install SystemTap
. sudo apt-get install systemtap
. sudo apt-get install linux-image-$(uname -r)-dbg
. sudo apt-get install linux-headers-$(uname -r)
. Now, it should be installed! Try the following scripts:
sudo stap -ve 'probe begin { log("hello world") exit () }'
sudo stap -v -e 'probe vfs.read {printf("read performed\n"); exit()}'
. For more information on how to install SystemTap on Debian, please refer to
the following link:
http://sourceware.org/systemtap/wiki/SystemtapOnDebian
- Create log directory
. mkdir $HOME/.reprozip
- Install MongoDB
. Follow instructions at the official website:
http://docs.mongodb.org/manual/tutorial/install-mongodb-on-debian/#install-mongodb
. create the database directory
. mkdir $HOME/.reprozip/mongodb
********************************************************************************
Manually installing the dependencies on Fedora:
-----------------------------------------------
- Install SystemTap
. sudo yum install systemtap systemtap-runtime
. sudo yum install kernel-devel
Note that your kernel version may NOT be listed by 'yum' because it is in
an older tree (you can see your kernel version by running 'uname -r').
In this case, you can download it manually in the following website
and install it using 'rpm':
http://koji.fedoraproject.org/koji/packageinfo?packageID=8
Another option is to update your kernel, reboot your system, and
use 'yum' again.
Make sure you have the kernel-develfor your kernel version.
'yum' may install the kernel-devel for a newer kernel version, even if
your version is different.
. sudo debuginfo-install kernel
. For more information on how to install SystemTap on Fedora, please refer to
the following link:
http://sourceware.org/systemtap/wiki/SystemtapOnFedora
http://sourceware.org/systemtap/SystemTap_Beginners_Guide/using-systemtap.html#using-setup
- Create log directory
. mkdir $HOME/.reprozip
- Install MongoDB
. Follow instructions at the official website:
http://docs.mongodb.org/manual/tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux/#install-mongodb
. create the database directory
. mkdir $HOME/.reprozip/mongodb