Concepts

This is a brief overview of the main concepts and terms needed to follow Cosmos Overview/Workflow

Resources

Everything that Experimenters can interact with is referred to as a Resource

Types include:

• Compute resources: servers, PCs, etc.
• Software Defined Radios
• Other RF Devices: basestations, full duplex radios
• RF Frontends
• Network Switches
• Optical switches and roadms

Domains

• Resources are grouped under Domains. Each domain won't interfere with any others, and they are reserved completely separately.
• The hardware in a domain may span several sites, or may be contained within a single site.

Consoles

• Each Domain has a dedicated control machine called a console.
• The console can be logged into with SSH from outside.
• Access is only available during a reservation.
• It acts as a jump host to access resources within its domain.

Sites

• Physical locations where hardware is installed.
• A site consists of one or more nodes.

Nodes

• Nodes refer to a set of radio, compute, and other resources meant to be used as a unit.
• The resources in a node will share infrastructure such as power, networking, or RF frontends.
• Therefore, the use of resources within a node must be coordinated to avoid interference.
• It is possible to use a subset of the resources within a node

Reservations

• Reservations allow users to obtain exclusive use of resources for a define time period.
• Currently, to ensure repeatable results, resources are reserved at the domain level.
• TODO Once the framework is in place, it will be possible to reserve a combination of nodes + frequency allocation, but for now the time slot guarantees exclusive use.

Images

• Compute resources have their state defined by what disk image is loaded
• Predefined base images are available, and described at User Guide/Image Versions
• Tutorials will either use a base image, or a specific customized image.
• The normal workflow is to load a base image, make the changes you need, and then save your own customized image to preserve your work.
• Details on how to work with images are at OMF Quick Start

Tutorials

• Tutorials are used as both instructional tools, as well as starting points for developing your own experiments.
• For example, following the basic usage tutorial, you will be able to send and receive RF data with a SDR.