Changes between Version 39 and Version 40 of Tutorials/Wireless/Full Duplex


Ignore:
Timestamp:
Mar 21, 2023, 4:43:18 AM (14 months ago)
Author:
mpk2138
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/Wireless/Full Duplex

    v39 v40  
    7272Before you can access the testbed, you need to [https://www.cosmos-lab.org/schedule make a reservation] and get it approved. After receiving the reservation's confirmation (approval) email:
    7373
    74  * Login into the reserved domain: {{{ssh -X username@console.sb2.cosmos-lab.org}}} (the {{{-X}}} option is for enabling the X11 tunneling). Note: if connecting from macOS, the {{{-Y}}} flag may be needed instead of {{{-X}}}.
     74 * Login into the reserved domain with the command below. The {{{-X}}} option is for enabling the X11 tunneling. Note: if connecting from macOS, the {{{-Y}}} flag may be needed instead of {{{-X}}}.
     75{{{
     76ssh -X username@console.sb2.cosmos-lab.org
     77}}}
    7578 * Once logged in, we can configure the COSMOS server. We will use the Sandbox 2 server {{{srv2-lg1}}}. Run the following command to ensure that the server is switched off:
    7679{{{
    7780omf tell -a offh -t srv2-lg1
    7881}}}
    79  * You should receive a {{{Reply: OK}}} message. If you do not, please see the troubleshooting section below. After receiving this notice, please run the following command to load the image:
    80 
    81 Login into the node: {{{ssh -X sb2@10.116.250.100}}}. The password is {{{cosmossandbox2}}}. After logging in into the node, a {{{FD_Examples}}} folder should exist under the home directory which contains some example experiments. Again, see above for using the {{{-Y}}} flag on macOS.
    82  * Check the conection and serial number of the USRP 2974: {{{uhd_find_devices}}}. The serial numbers should be 318DCED with address {{{192.168.50.2}}}.
     82 * You should receive a {{{Reply: OK}}} message. If you do not, please see the troubleshooting section below. After receiving this notice, please run the command below to load the image. Note - this command can take over 5-10 minutes to run, so this is a good time to grab a tea or coffee...
     83{{{
     84omf load -o 1800 -i flexicon-cosmos-v1.ndz -t srv2-lg1
     85}}}
     86 * '''Let the command run to completion, even if it does not seem to finish.''' Confirm that the command finished and output something along the lines of the text below. If not, please see the troubleshooting section.
     87{{{
     88 INFO exp:  -----------------------------
     89 INFO exp:  Imaging Process Done
     90 INFO exp:  1 node successfully imaged - Topology saved ....
     91 INFO exp:  -----------------------------
     92}}}
     93* Switch on the server with the command below, and check for {{{Reply: OK}}}. The server will take a couple of minutes to switch on fully after the command finishes.
     94{{{
     95omf tell -a on -t srv2-lg1
     96}}}
     97* Log into the server with SSH
     98{{{
     99ssh -X root@srv2-lg1
     100}}}
     101* Run the following command to optimize the server network interfaces for use with UHD and GNU Radio:
     102{{{
     103./optimizeInterfaces
     104}}}
     105* At this point, the server is ready to use. Please see the sections below for details on how to save work when finished, and the experiments and resources that are available on the server.
     106
     107==== Wrapping Up & Saving Work ====
     108When you are finished with your experiments, you can save your work to a new node image, that you can then load in next time. Since it can take some time to finish saving your work to a new server image, we recommend saving at least '''30 minutes''' of your reservation time to make sure you have enough time to complete the process.
     109
     110* To ensure a reliable image save, it is strongly recommended to reboot the server first. You will need to return to the Sandbox 2 console, either in a new SSH session, or by typing {{{exit}}} on the server SSH window.
     111* Run the following command from the Sandbox 2 console:
     112{{{
     113omf tell -a reboot -t srv2-lg1
     114}}}
     115* Check for {{{Reply: OK}}} and give some minutes to allow the server to come back online.
     116* Log back into the server: {{{ssh -X root@srv2-lg1}}}
     117* Run the following script to prepare the node for imaging. It is ok to ignore warnings and errors from this command. Note the command it provides to you once finishing.
     118{{{
     119./prepare.sh
     120}}}
     121* Go back to the Sandbox 2 console by running {{{exit}}}.
     122* Run the command that should have been provided by the {{{prepare.sh}}} script. This command, like the {{{omf load}}} command, can take 5-10 minutes to run. Good time to refill your tea or coffee...
     123{{{
     124omf save -n srv2-lg1.sb2.cosmos-lab.org
     125}}}
     126* '''Let this command run to completion, even if it does not seem to finish.''' Confirm that the command finished and output something along the lines of the text below. If not, please see the troubleshooting section.
     127{{{
     128 INFO exp: 
     129 INFO exp: - Saving process started at: 2023-03-21 04:33:09 +0000
     130 INFO exp:   (this may take a while depending on the size of your image)
     131 INFO exp: - Saving disk image of 'srv2-lg1.sb2.cosmos-lab.org' finished with success.
     132 INFO exp: - Saving process completed at: 2023-03-21 04:35:49 +0000
     133 INFO exp: 
     134}}}
     135* The filename of your image will be located in the output of the command, specifically in the third line of this part of the output:
     136{{{
     137 INFO srv2-lg1.sb2.cosmos-lab.org: 
     138 INFO srv2-lg1.sb2.cosmos-lab.org: - Saving image of '/dev/sda' on node 'srv2-lg1.sb2.cosmos-lab.org'
     139 INFO srv2-lg1.sb2.cosmos-lab.org:   to the file 'mpk2138-node-srv2-lg1.sb2.cosmos-lab.org-2023-03-21-04-32-59.ndz' on host '10.116.0.40'
     140 INFO srv2-lg1.sb2.cosmos-lab.org: 
     141}}}
     142* Keep a note of this filename. You can use this instead of {{{flexicon-cosmos-v1.ndz}}} the next time you login to use the FD testbed.
     143 * If you would like to change the filename, you can run the following command. Note, it is good to keep your COSMOS username on the front of your node image filename. Make sure to use your specific filename that was provided in the output of the {{{omf save}}} command. Spaces cannot be used in the filename.
     144 {{{
     145 mv /export/omf-images-5.4/mpk2138-node-srv2-lg1.sb2.cosmos-lab.org-2023-03-21-04-32-59.ndz /export/omf-images-5.4/mpk2138-IMAGE-NAME-HERE.ndz
     146 }}}
     147* The node image is now saved, and you will be able to pick up where you left off the next time you login to use the FD radios.
    83148
    84149==== Running an example experiment ====