Differences

This shows you the differences between two versions of the page.

--- gnu_radio_docker_benchmark_example [2021/02/04 10:52] – mention dockerhub account mimbert
+++ gnu_radio_docker_benchmark_example [2023/08/29 15:30] – Correct indentation for passive keyword cmorin
@@ Line 8: / Line 8: @@
 ## Create your docker image
-Using docker, we will enable on your laptop an environment suitable for Cortexlab with gnuradio and needed software. Your goal is to develop this image (with new software and files) so you can run your experiment. It will only modify the environment of the image and not your laptop. Then you will be able to save and deploy the new image on cortexlab, without having to re-install everything and dealing with software compatibility and versioning.
+Using docker, we will enable on your laptop an environment suitable for CorteXlab with gnuradio and needed software. Your goal is to develop this image (with new software and files) so you can run your experiment. It will only modify the environment of the image and not your laptop. Then you will be able to save and deploy the new image on cortexlab, without having to re-install everything and dealing with software compatibility and versioning.
 Therefore, you can retrieve and run the following image.
@@ Line 104: / Line 104: @@
-We will use the ssh method for this example, but know that you can also use the ''command'' option in a different way, by directly giving the parameters of you experience and not going through ssh.
+We will use the ssh method for this example, but know that you can also use the ''command'' option in a different way, by directly giving the parameters of you experience and not going through ssh. The idea is that when you're developing an experiment, you will go through trials and errors, parameter tweakings, and working interactively through ssh is the best option, When the experiment is running well and you want to reproduce it several times, on the other hand, it's best to automatize everything, so that you don't need to ssh to each node and run commands manually. It's also possible, for example, that you adjust interactively a receiver first, and when it's done, you run it automatically, and you keep the interactive sessions only for adjusting and tuning the emitter node(s).
 <code>
@@ Line 112: / Line 112: @@
     - image: [DOCKER USERNAME]/[NEW IMAGE NAME]:latest
       command: ./benchmark_rx.py --antenna="TX/RX" --rx-gain=25 -v -W 2M -f 2.49G
-      passive: true
+    passive: true
   node16:
@@ Line 181: / Line 181: @@
 First we need to reserve the CorteXlab room:
-<code>
+I a new browser window open the [CorteXlab web app](http://xp.cortexlab.fr/app). It will open in your current reservation list if you have any.
-you@srvairlock:~/workspace$ oarsub -l nodes=BEST,walltime=0:30:00 -I
-</code>
-(If you're running your reservation in a container reservation):
+{{ ::screenshot_2022-12-13_at_11.46.27.png?nolink&700 |}}
-<code>
-you@srvairlock:~/workspace$ oarsub -t inner=<id of container> -l {"network_address in ('mnode4.cortexlab.fr', 'mnode6.cortexlab.fr')"}/nodes=2,walltime=0:30:00 -I
+Use the "Book the testbed" button in the lower left corner.
-</code>
+You'll get to a screen that looks like this:
+{{ ::screenshot_2022-12-13_at_11.50.28.png?nolink&700 |}}
+Now let's create the reservation!
+Under "Book the testbed" select the date of your reservation:
+{{ ::screenshot_2022-12-13_at_11.52.34.png?nolink&700 |}}
+And using the clock icon select the start time of your reservation by dragging the clock pointers:
+{{ ::screenshot_2022-12-13_at_11.53.07.png?nolink&100 |}} and {{ ::screenshot_2022-12-13_at_11.53.18.png?nolink&100 |}}
+Now, in the duration, select the end of your reservation the same way as above.
+Finally select the nodes in the map of CorteXlab by clicking on the ones required for your experiment such that their color changes to orange. Since we're using 14 and 16, those are the ones to be selected:
+{{ ::screenshot_2022-12-13_at_12.39.54.png?nolink&700 |}}
+Finally click on the "Book the testbed" button. If your reservation works (no conflicting options were chosen), you should be brought back to the reservations page, and a new line highlighted in yellow will appear with the number of your reservation.
-(Be sure that no one else is using the same node as you)
-This will run a 30 minute job and open a sub-shell in which you can run minus tasks. This sub-shell will be killed after 30 minutes, and if you leave the shell earlier, it will terminate the corresponding oar job. More documentation on oar can be found [[reserve|here]]. You can also monitor the current jobs in the [gantt web interface](http://xp.cortexlab.fr/drawgantt/).
-We then submit the minus task:
+Back to the airlock terminal screen, we now can submit the minus task:
 <code>
@@ Line 240: / Line 257: @@
 # From node 16
-root@mnode14:~/ ./examples/my_task/benchmark_tx.py --antenna="TX/RX" --tx-amplitude=0.2 -v -W 2M -f 2.49G
+root@mnode16:~/ ./examples/my_task/benchmark_tx.py --antenna="TX/RX" --tx-amplitude=0.2 -v -W 2M -f 2.49G
 </code>