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
|
# In this How-To we explain how you setup IntelliJ IDEA
First of all you can download IntelliJ here: https://lp.jetbrains.com/intellij-idea-promo/
# Basic steps
```
git clone git@github.com:atlarge-research/opendc
```
Check if you have a compatible java version available. Make sure to have one of these versions available: [21]
If not install a supported version!
On a MAC
```
/usr/libexec/java_home -V
```
On Debian
```
update-alternatives --list java
```
On Redhat/Centos
```
yum list installed | grep java
```
Open the project in IntelliJ
Now fix the settings so that you use the correct java version. (In the example the java version is set to "21")
Navigation path in the settings pannel: "Build, Execution, Deployment" -> "Build Tools" -> "Gradle"
Now navigate in the file menu to and open the file: "gradle"/"libs.versions.toml"
Make sure the java version is set to the same version as previously cofigured in the settings.
Now open the Gradle panel on the right-hand side of the editor (1) and hit the refresh button at the top of the panel (2).
# Setup your first experiment and run it from source
Create a directory where you are going to put the files for your first experiment.
File structure:
You can download the example workload trace (bitbrains-small-9d2e576e6684ddc57c767a6161e66963.zip) [here](https://atlarge-research.github.io/opendc/assets/files/bitbrains-small-9d2e576e6684ddc57c767a6161e66963.zip)
Now unzip the trace.
The content of "topology.json"
```
{
"clusters":
[
{
"name": "C01",
"hosts" :
[
{
"name": "H01",
"cpu":
{
"coreCount": 32,
"coreSpeed": 3200
},
"memory": {
"memorySize": 256000
}
}
]
},
{
"name": "C02",
"hosts" :
[
{
"name": "H02",
"count": 6,
"cpu":
{
"coreCount": 8,
"coreSpeed": 2930
},
"memory": {
"memorySize": 64000
}
}
]
},
{
"name": "C03",
"hosts" :
[
{
"name": "H03",
"count": 2,
"cpu":
{
"coreCount": 16,
"coreSpeed": 3200
},
"memory": {
"memorySize": 128000
}
}
]
}
]
}
```
The content of "experiment.json"
The paths in the "experiment.json" file are relative to the "working directory" which is configured next.
```
{
"name": "simple",
"topologies": [{
"pathToFile": "topology.json"
}],
"workloads": [{
"pathToFile": "bitbrains-small",
"type": "ComputeWorkload"
}]
}
```
In the project file structure on the left open the following file:
"opendc-experiments"/"opendc-experiments-base"/"src"/"main"/"kotlin"/"org.opendc.experiment.base"/"runner"/"ExperimentCLi.kt"
Now open the "Run/Debug" configuration (top right).
We need to edit two settings:
"Program arguments": --experiment-path experiment.json
"Working Directory": a path where you have put the experiment files
Now you can click "Run" and start your first experiment.
In the working directory a "output" direcotry is created with the results of the experiment.
|
