Example Profiles

These profiles demonstrate how to construct various topologies and select options such as node type, operating system, etc.
Name
Created
Description
Powder Specific Profiles
gnuradio_dense Jan 4, 2023

Use this profile to allocate Dense Deployment radios with associated compute, with the GNU Radio 3.8 software stack (and UHD 4.x libraries) installed.
To see what radios are currently available, and what features/restrictions they have, please check the POWDER map and radio information pages:

POWDER map

Radio Information

Note that these radios only have their "TX/RX" port connected! The RX2 port is the default receive port for many GNU Radio and UHD applications, but it is not connected and so you will not see any signal on it.

If you plan to transmit anything, you will need to declare the frequency range you plan to use for transmission via the parameters in this profile. If you transmit without declaring frequencies, or transmit where you have not declared, you will be in violation of the POWDER AUP and FCC regulations. Also be aware that the attached antenna is matched for 3400 - 3800 MHz. Do not try to transmit on frequencies outside of this range.

Note 06/30/22: Dense Deployment radios will change somewhat in the coming months. Currently each site has a ruggedized NUC-like compute node with attached (ruggedized) NI B210 radio. As there is no compliance monitoring for these radios at this time, admin-reviewed reservations are required for using them. Ultimately NI N310 radios will be deployed and the B210 radios will instead run as transmission compliance monitors for these N310 radios.

gnuradio_otalab Aug 23, 2022

Allocate OTA lab radios with associated compute nodes with gnuradio installed.

The OTA lab has the following resources

  • Four NI X310 SDRs

These are paired with either d430 or d740 compute nodes (profile parameter) when allocated by this profile, connected by 10G Ethernet.

  • Four i7 NUC comput nodes with USB3-attached radios
    • One NI B210 per node
    • One Quectel RM500Q-GL 5G modem per node

See the following diagram for the lab layout: OTA Lab Layout

Be sure to select at least one node/radio, or nothing will be allocated!

If you plan to transmit anything, you will need to declare the frequency range you plan to use for transmission via the parameters in this profile. If you transmit without declaring frequencies, this will be detected, and your experiment may be shut down. Please make sure the frequencies you declare are compatible with the radios you specify for allocation.

mobile-demo Jan 13, 2022

Mobile demo. This demo will allocate all buses, installing the UHD tools, GNU radio, and X11 VNC to run uhd_fft.

O-RAN Sep 17, 2020

This profile creates a Kubernetes cluster and installs the O-RAN SC Near-RT RIC (and optionally, the ONF SD-RAN RIC) and xApps. When you click the Instantiate button, you'll be presented with a list of parameters that you can change to configure your O-RAN and Kubernetes deployments. Before creating any experiments, read the Instructions, and the parameter documentation.

oai-5g-e2e-rfsim Nov 10, 2021

OAI 5G E2E with Simulated RF

This profile deploys a single compute node with an image that includes docker, docker-compose, tshark, oai-cn5g-fed v1.2.1, and docker images for all of the OAI 5G core network functions. It was originally used for the OAI Fall 2021 Workshop RAN Lab hands-on sessions. The associated slides and instructions for this session, which show how to download, build, and run OAI 5G RAN alongside the OAI 5GCN, can be found at:

https://gitlab.flux.utah.edu/powderrenewpublic/oai_fall_2021_workshop.

Some of these instructions have been reproduced below, with adjustments for logging into the associated node directly, as opposed to using the browser-based VNC client that workshop participants used.

oai-indoor-ota Nov 14, 2021

OAI 5G using the POWDER Indoor OTA Lab

This profile instantiates an experiment for testing OAI 5G with COTS UEs in standalone mode using resources in the POWDER indoor over-the-air (OTA) lab. The indoor OTA lab includes:

  • 4x NI X310 SDRs, each with a UBX-160 daughter card occupying channel 0. The TX/RX and RX2 ports on this channel are connected to broadband antennas. The SDRs are connected via fiber to near-edge compute resources.
  • 4x Intel NUC compute nodes, each equipped with a Quectel RM500Q-GL 5G module that has been provisioned with a SIM card. The NUCs are also equipped with NI B210 SDRs, but they are not the focus of this profile.

You can find a diagram of the lab layout here: OTA Lab Diagram

The following will be deployed:

  • Server-class compute node (d430) with a Docker-based OAI 5G Core Network
  • Server-class compute node (d740) with OAI 5G gNodeB (fiber connection to 5GCN and an X310)
  • One to four Intel NUC compute nodes, each with a 5G module and supporting tools

Note: This profile currently requires the use of the 3550-3600 MHz spectrum range and you need an approved reservation for this spectrum in order to use it. It's also strongly recommended that you include the following necessary resources in your reservation to gaurantee their availability at the time of your experiment:

  • A d430 compute node to host the core network
  • A d740 compute node for the gNodeB
  • One of the four indoor OTA X310s
  • All four indoor OTA NUCs

Bleeding-edge Software Caveats!

You may see warnings, errors, crashes, etc, when running the OAI gNodeB soft modem. The COTS modules may sometimes fail to attach. Please subscribe to the OAI user or developer mailing lists to monitor and ask questions about the current status of OAI 5G: https://gitlab.eurecom.fr/oai/openairinterface5g/-/wikis/MailingList.

oai-rf-bench Nov 7, 2021

OAI 5G on POWDER Paired Radio Workbench

This profile instantiates an experiment for testing OAI 5G in standalone mode using one of three Paired Radio Workbenches available on POWDER. The test benches are all identical and currently include two USRP X310s, each with a single UBX160 daughterboard, and a common 10 MHz clock and PPS reference provided by an OctoClock. The transceivers are connected via SMA cables through 30 dB attenuators, providing for an interference free RF environment.

Note: Select Workbench A or B if you are not a POWDER team member; Workbench C is for internal use only.

The following will be deployed on server-class compute nodes:

  • Docker-based OAI 5G Core Network
  • OAI 5G gNodeB (fiber connection to 5GCN and X310)
  • OAI 5G nrUE (fiber connection to the other X310)

Bleeding-edge Software Caveats!

You may see warnings, errors, crashes, etc, when running the NR soft modems. Please subscribe to the OAI user or developer mailing lists to monitor and ask questions about the current status of OAI 5G: https://gitlab.eurecom.fr/oai/openairinterface5g/-/wikis/MailingList.

powder-ceph-clients Nov 29, 2023

This profile creates a node and attaches it to the shared vlan for the Powder Ceph cluster.

powder-control Jun 3, 2020

This profile provides a single compute node for running example.py, which programmaticaly starts an experiment based on another profile and interacts with it using the tools in ./powder/.

See the project README for more information.

renewlab Nov 22, 2019

This profile instantiates a d840 machine connected to a Skylark FAROS massive MIMO system comprised of a FAROS hub, a Faros massive MIMO Base Station, and a set of Iris UEs (clients). The PC boots with Ubuntu 20.04 and includes a MATLAB installation that could be used to run experiments on FAROS with RENEWLab demos. For more information on RENEWLab, see RENEW documentation page

srslte-controlled-rf Jun 3, 2020

srsLTE Controlled RF

Use this profile to intantiate an end-to-end LTE network in a controlled RF environment (wired connections between UE and eNB). The UE can be srsLTE-based or a Nexus 5.

If you elect to use a Nexus 5, these nodes will be deployed:

  • Nexus 5 (rue1)
  • Generic Compute Node w/ ADB image (adbnode)
  • Intel NUC5300/B210 w/ srsLTE eNB/EPC (enb1)

If instead you choose to use an srsLTE UE, these will be deployed:

  • Intel NUC5300/B210 w/ srsLTE (rue1) or
  • Intel NUC5300/B210 w/ srsLTE eNB/EPC (enb1)
srslte-otalab Nov 1, 2021

This profile allows the allocation of resources for over-the-air operation in POWDERs indoor over-the-air (OTA) lab.

A map of the lab's layout is here: OTA Lab Diagram

The OTA Lab has a number of X310 SDRs connected to two broadband antennas; one on the TX/RX port, and the other on RX2 port of channel 0. Each X310 is paired with a compute node (by default a Dell d430).

The OTA Lab also has a number of B210s SDRs paired with an Intel NUC small form factor compute node. These B210s are connected to broadband antennas, one on each of the "channel A" TX/RX and RX2 ports.

This profile uses a disk image with UHD pre-installed and clones/builds/installs srsRAN 22.04. The source code can be found at /var/tmp/srsran on each node after the startup scripts for the experiment have finished.

Resources needed to realize a basic srsRAN setup consisting of a UE, an eNodeB and an EPC core network:

  • Spectrum for LTE FDD opperation (uplink and downlink).
  • A "nuc+b210" OTA lab compute/SDR pair (This will run the UE side.)
  • An "x310" OTA Lab SDR. (This will be the radio side of the eNodeB.)
  • A "d740" or "d430" compute node. (This will run both the eNodeB software and the EPC software.)
srslte-simulated-rf Jun 3, 2020

srsLTE Simulated RF

Use this profile to intantiate an end-to-end LTE network using simulated links between eNB and UE (sending baseband IQ samples back and forth via ZMQ instead of transmitting over the air via SDRs). Three d430 compute nodes will be deployed (epc, enb1, and rue1), each with srsLTE 20.04.1, and connected to the same LAN.

srsran-handover Jun 2, 2021

srsRAN S1 Handover w/ Open5GS

This profile allocates resources in a controlled RF environment for experimenting with LTE handover. It deploys srsRAN on three nodes, each consisting of a NUC5300 compute node and a B210 SDR, in our RF attenuator matrix. One node serves as the UE, while the other two serve as "neighboring" eNBs. Since the srsRAN EPC does not support S1 handover, the profile deploys Open5GS on a node outside of the controlled RF environment and sets up LAN connections between this node and both eNB nodes. A command line tool is provided that allows you to change the amount of attenuation on the paths between the UE and both eNBs in order to simulate mobility and trigger S1 handover events.

srsran5g-simulated-rf Jul 13, 2022

srsRAN 5G with Open5GS and Simulated RF

This profile instantiates a single-node experiment for running and end to end 5G network using srsRAN_Project 24.10 (gNodeB), srsRAN_4G 23.11 (UE), and Open5GS (in container) with IQ samples passed via ZMQ between the gNodeB and the UE. It requires a single Dell d430 compute node.

Optionally, you can also deploy a containerized ORAN SC RIC and xApp on the same node to demonstrate a 5G RAN Intelligent Controller (RIC) and xApp interacting with the gNodeB.

WiMatch-OTA Jan 11, 2021

This profile is intended for capturing WiMatch/Shout dependencies and for reproducing experiments as conducted for the CNERT 2021 workshop paper.

Allocate some number of X310 radios (+ compute) for doing measurements. Can allocate both CBAND and Cellular band X310 Radios as well as FE NUC+B210 resources.

Other Useful Profiles
layer1-2pcs Jun 20, 2019

This profile allocates two bare metal nodes and connects them directly together via a layer1 link.

layer1-2sws-2pcs Nov 5, 2018

This profile allocates two bare metal nodes and connects them together via two Dell or Mellanox switches with layer1 links.

layer1-sw-2pcs Nov 5, 2018

This profile allocates two bare metal nodes and connects them together via a Dell or Mellanox switch with layer1 links.

start-vnc Jan 6, 2022

Start X11 VNC on a node.

two-arm-lan Nov 10, 2017

An example of constructing a profile with two ARM64 nodes connected by a LAN.

k8s May 27, 2020

This profile creates a Kubernetes cluster with Kubespray. When you click the Instantiate button, you'll be presented with a list of parameters that you can change to control what your Kubernetes cluster will look like; read the parameter documentation on that page (or in the Instructions).

longterm-dataset Aug 26, 2021

This profile demonstrates how to use a remote dataset on your node, either a long term dataset or a short term dataset, created via the Portal.

OpenStack Dec 20, 2017

This profile provides a highly-configurable OpenStack instance with a controller and one or more compute nodes (potentially at multiple Cloudlab sites) (and optionally a network manager node, in a split configuration). This profile runs x86, arm64, and POWER8 (Queens and up) nodes. It sets up OpenStack Zed (Ubuntu 22.04), Xena, Wallaby, Victoria, Ussuri (Ubuntu 20.04, python3), Train, Stein (Ubuntu 18.04, python3), Rocky, Queens (Ubuntu 18.04, python2), Pike, Ocata, Newton, or Mitaka (Ubuntu 16.04, python2) (Liberty on 15.10, Kilo on 15.04, and Juno on 14.10, python2, deprecated) according to your choice, and configures all OpenStack services, pulls in some VM disk images, and creates basic networks accessible via floating IPs. You'll be able to create instances and access them over the Internet in just a few minutes. When you click the Instantiate button, you'll be presented with a list of parameters that you can change to control what your OpenStack instance will look like; carefully read the parameter documentation on that page (or in the Instructions) to understand the various features available to you.

remote-diskspace Jun 24, 2018

This profile demonstrates how to add some extra remote disk space on your node. This is sometimes useful if you need more disk space then is available locally. This type of disk space is temporary; the data is deleted when your experiment is terminated. The space is located on a remote ISCSI disk and will of course not be as fast as local disk space, but for many applications is adequate.

routable-ip Jul 3, 2019

An example of constructing a profile with a single Xen VM with a routable IP address.

shared-vlan Aug 15, 2024

This profile demonstrates how to use a shared vlan.

shared-vm-routable-ip Jan 29, 2025

An example of constructing a profile with a single Xen VM, running on a shared VM host, with a routable IP address.

single-vm Nov 9, 2017

An example of constructing a profile with a single Xen VM.

two-vm-lan Nov 10, 2017

An example of constructing a profile with two VMs connected by a LAN.

imdataset Dec 14, 2020

An example of an image backed dataset. The dataset name and mountpoint can be customized when you instantiate the profile.

local-diskspace Dec 14, 2020

This profile demonstrates how to add some extra local disk space on your node. In general nodes have much more disk space then what you see with df when you log in. That extra space is in unallocated partitions or additional disk drives. An ephemeral blockstore is how you ask for some of that space to be allocated and mounted as a temporary filesystem (temporary means it will be lost when you terminate your experiment).

node-ips Nov 10, 2017

An example of constructing a profile with node IP addresses specified manually.

os-install-scripts Jun 8, 2020

An example of constructing a profile with install and execute services.

parameterized Jun 27, 2018

An example of using parameters to construct a profile with a variable number of nodes.

random-password Nov 30, 2016

An example of how to generate a random per experiment password that is displayed to the user in the instructions below, and can be accessed on nodes in your experiment. This avoids having to use a well known password.

RepoBased Mar 17, 2017

This is a trivial example of a gitrepo-based profile; The profile source code and other software, documentation, etc. are stored in in a publicly accessible GIT repository (say, github.com). When you instantiate this profile, the repository is cloned to all of the nodes in your experiment, to /local/repository.

This particular profile is a simple example of using a single raw PC. It can be instantiated on any cluster; the node will boot the default operating system, which is typically a recent version of Ubuntu.

root-sshkeys Sep 12, 2017

An example demonstrating how to control the installation of an ssh private and public pair for the root user such that root can ssh without a password to other nodes in your experiment.

select-hardware Feb 22, 2017

This profile demonstrates a parameterized profile that allows you to select the type of hardware to use. You can instantiate this profile on anycluster that has that type of hardware.

select-os Jun 29, 2020

This profile demonstrates a parameterized profile that allows you to select one of several standard OS images for your nodes. When you instantiate this profile, you will be asked to select the OS via a drop down menu.

single-pc Nov 9, 2017

An example of constructing a profile with a single raw PC.

single-pc-ubuntu May 22, 2020

An example of constructing a profile with a single raw PC, that is set to run a specific operating system image (Ubuntu). It can be instantiated on any cluster, this particular Ubuntu image is available on all clusters.

small-lan Apr 1, 2025

Variable number of nodes in a lan. You have the option of picking from one of several standard images we provide, or just use the default (typically a recent version of Ubuntu). You may also optionally pick the specific hardware type for all the nodes in the lan.

specific-node Jun 25, 2020

An example of constructing a profile that requests a specific raw PC. It can be instantiated only on the cluster where that pc is located; the node will boot the default operating system, which is typically a recent version of Ubuntu.