[[Include(WikiToC)]]

== Getting Started with COSMOS SDR Resources ==

=== Description ===
In this tutorial we'll demonstrate how to run a basic wireless experiment using software defined radios in the COSMOS testbed. Two COSMOS nodes will be used: one to transmit a signal, and the other to receive it.

=== Prerequisites ===
All tutorials on the COSMOS wiki assume that you have already created a user account through [https://www.orbit-lab.org/userManagement/register the new user registration form].

In order to access the test bed, create a reservation on [https://wiki.cosmos-lab.org/cPanel/controlPanel/start the online scheduler] and have it approved by the reservation service. Access to the resources are granted after the reservation is confirmed. Please see the page describing [wiki:CosmosOverview/Workflow the COSMOS work flow page] for more information. 

=== Resources required ===
For this example we used two USRP 2974 SDRs on [wiki:Architecture/Domains/cosmos_sb1 sandbox 1].

=== Tutorial Setup ===
 Follow the steps below to gain access to this console and set up your node with an appropriate image. 
 1. [GettingStarted#MakeaReservation Create a resource reservation] for sandbox 1.
 2. Once reservation is approved, [wiki:GettingStarted#LogintoyourReservation login into the console] using ssh. Since you are using sandbox 1, you will ssh to 
 {{{#!shell
 YOUR_USERNAME@console.sb1.cosmos-lab.org
 }}}
 3. Use OMF commands to [GettingStarted#ControlResourceswithOMF load the baseline-uhd.sdr image] on your resources.
 {{{#!shell
 omf load -i baseline-uhd.ndz -t sdr2-s1-lg1,sdr2-md1
 }}}
 1. Once the nodes are successfully imaged, turn them on and check the status
 {{{#!shell
 omf tell -a on -t sdr2-s1-lg1,sdr2-md1
 }}}
 {{{#!shell
 omf stat -t sdr2-s1-lg1,sdr2-md1
 }}}
 1. After waiting for the nodes to power up and boot, you will be able to ssh to them from the console: 
 {{{#!shell
 ssh root@sdr2-s1-lg1
 }}}
 NOTE: for some nodes, such as the server machines, it can take several minutes for a node to finish the booting process. This is normal, and you'll have to wait until the nodes is fully booted before you can ssh to it.