Create a Baremetal Site

Objective

This document provides instructions on how to create a Volterra single-node or multi-node site on custom hardware, with the Volterra Site software image file. For more information, see Volterra Site.


Prerequisites

By proceeding with the installation, download and/or access and use, as applicable, of the Volterra software, and/or Volterra platform, you acknowledge that you have read, understand, and agree to be bound by this agreement.

Restrictions

The USB allowlist is enabled by default. If you change a USB device, such as a keyboard after registration, the device will not function.


Minimum Hardware Requirements

The Volterra Node software is designed to work on most commodity hardware.

The following minimum requirements will assist you when choosing a commodity hardware for Volterra Node deployments:

Memory Networking USB HDMI Disk Space
Minimum: 8GB Minimum: 1x 1000Mb/s (Intel-based) Minimum: 1 USB 2.0/3.0 for Imaging the host Minimum: 1 HDMI for imaging the system. (Only required if the hardware provided is not Volterra packaged) Minimum: 64GB
Recommended: 16GB Volterra provides Multiple NIC support where users can use multiple NIC’s for a customer edge Varies with peripheral connections (camera etc.) Recommended: 128 GB

Note: As you plan for your hardware setup, consider the following information:

  • Current architecture supported is x86. Arm is currently on the roadmap.
  • Memory, storage, and CPU requirements vary based on application usage on the system/host.
  • USB requirements for the host vary on the number of peripheral device connections.

Supported Hardware

  • All the hardware listed below has been tested and supported by Volterra. Known caveats are listed in the respective sections.
  • Volterra nodes can only be deployed on hardware with Intel-based Ethernet cards with DPDK support (https://core.dpdk.org/supported/nics/intel/).
  • Refer to product-specific data sheets for more information.
  • Using the minimum hardware requirements listed above, you may attempt to install a Volterra Node but official support will be limited.

Note: The Volterra Node software is certified to run on the hardware specified in the following sections. If you want to certify Volterra Node software for your specific hardware setup, send an email to sales@volterra.io.

Edge Hardware

Vendor Model Processor Memory Networking Storage USB HDMI Graphics Input Voltage
Advantech UTX-3117 Intel® Apollo Lake E3900 series & N series Processor 8 GB/8 GB per SO-DIMM 2x GbE1: Intel I210AT; GbE2:Realtek 8111G Supports 1x 2.5" HDD or SSD storage 2x USB 3.0 HDMI 3840 x 2160 @ 30Hz/ DP1.2a (4096 x 2160 @ 60Hz) Supports GT710 2G DDR3 PCI-E 16X DVI+HDMI+VGA Low Profile 12 to 24 VDC+/-5%
Intel NUC7i7DNKE 1.9 GHz Intel Core i7-8650U quad-core processor 32 GB DDR4 SO-DIMM RAM 2400 MHz 1x Intel 10/100/1000 Gigabit Ethernet 1 TB SSD SATA III 4x USB 3.0 2x HDMI 2.0 Dual HDMI 2.0a, 4-lane eDP 1.4 12-24 VDC
Intel NUC8i3BEH Intel® Core™ i3-8109U Processor (4M Cache, up to 3.60 GHz) 32 GB DDR4-2400 1.2V SO-DIMM 1x Intel 10/100/1000 Gigabit Ethernet 1 TB M.2 SSD SATA 5x USB 3.1 Gen 2
3x USB 2.0
1x HDMI 2.0a Intel Iris™ Plus Graphics 655 or Intel UHD Graphics 620 12-19 V DC
Fitlet2 E3950 Intel Atom™ Processor x7 Series E3950 1.6GHz to 2GHz 1x SO-DIMM 204-pin DDR3L Non-ECC DDR3L-1866 (1.35V) Up to 16GB 2x GbE LAN ports (RJ-45), LAN1: Intel I211 GbE controller, LAN2: Intel I211 GbE controller 1x M.2 M-Key 2242/2260* on board *M.2 2280 optional on some facet cards 2x USB 3.0 and 2x USB 2.0 HDMI 1.4 3840x2160 @30Hz Intel® HD Graphics 505 Dual display mode supported Unregulated 7 – 20VDC* input

Note: Fitlet2 interface naming is reversed. Eth2 = eth0 (WAN/Site Local Interface) and Eth1 = (LAN/Site Local Inside Interface).

Server Hardware

Vendor Model Processor Memory Networking Storage USB RAID HDD Input Voltage
Kingstar SYS-1029U-TN10RT Intel Xeon DDR4-2666 32GB x 12 (384GB+) Intel XXV710 (10/25G) SSD NVMe (1TB, 4TB)
Dell PowerEdge R640 Intel Xeon Gold 6230N(20 Core/2.3GHZ/27.5MB Cache/HT)x2 34GB:32GB*12 - DIMM Intel X710 10G SFP + x2 Port + Intel i350 1G Base-T x2 Port Add-on: Intel X710 10G SFP+x2 Port PCIe NIC x1 or Intel XL710 40G QSFP+ x2 Port PCIe NIC x2 960GB (mixed use SDD/Dell AG Drive) x3 (6GBPS SATA/2.5inch/HotPlug) 2 x USB 3.0 PERC H740P SAS RAID controller 960GB (mixed use SSD/Dell AG Drive) x3 (6Gbps SATA/2.5inch/HotPlug) 1100W 48VDC

Volterra Hardware

Model Processor Memory Networking Storage
Volterra IGW5508 Intel Atom® C3708 2x DDR4 ECC SODIMM 2133 Mhz, Max of 2x32 GB Serial Bus: 1x RS232 or RS485
RS485: Up to 10 Mbps, 2-wire, half-duplex
RS232: Up to 1 Mbps, 2-wire, full-duplex
Modbus master & slave
LAN: 4x 1000Base-T with PoE 802.3 af supported on each
Wireless: Wi-Fi 11ac 2x2 MIMO Bluetooth 4.2 HS, BLE, ANT+
LTE Cat 4 (150 Mbps max DL / 50 Mbps max UL) coverage: worldwide (Supported Frequency Bands B1, B2, B3, B4, B5, B7, B8, B12, B13, B18, B19, B20, B25, B26, B28, B38, B39, B40 and B41)
3G fallback
GNSS (GPS, GLONASS, BeiDou and Galileo)
Field replaceable SIM
1x M.2 2280 NVMe 1x M.2 2280 SATA
Volterra IGW5504 Intel Atom® C3538 2x DDR4 ECC SODIMM 2133 Mhz, Max of 2x32 GB Serial Bus: 1x RS232 or RS485
RS485: Up to 10 Mbps, 2-wire, half-duplex
RS232: Up to 1 Mbps, 2-wire, full-duplex
Modbus master & slave
LAN: 4x 1000Base-T with PoE 802.3 af supported on each
Wireless: Wi-Fi 11ac 2x2 MIMO Bluetooth 4.2 HS, BLE, ANT+
LTE Cat 4 (150 Mbps max DL / 50 Mbps max UL) coverage: worldwide (Supported Frequency Bands B1, B2, B3, B4, B5, B7, B8, B12, B13, B18, B19, B20, B25, B26, B28, B38, B39, B40 and B41)
3G fallback
GNSS (GPS, GLONASS, BeiDou and Galileo)
Field replaceable SIM
1x M.2 2280 SATA
Volterra IGW5008 Intel Atom® C3708 2x DDR4 ECC SODIMM 2133 Mhz, Max of 2x32 GB Serial Bus: 1x RS232 or RS485
RS485: Up to 10 Mbps, 2-wire, half-duplex
RS232: Up to 1 Mbps, 2-wire, full-duplex
Modbus master & slave
LAN: 4x 1000Base-T with PoE 802.3 af supported on each
Wireless: Wi-Fi 11ac 2x2 MIMO Bluetooth 4.2 HS, BLE, ANT+
LTE Cat 4 (150 Mbps max DL / 50 Mbps max UL) coverage: worldwide (Supported Frequency Bands B1, B2, B3, B4, B5, B7, B8, B12, B13, B18, B19, B20, B25, B26, B28, B38, B39, B40 and B41)
3G fallback
GNSS (GPS, GLONASS, BeiDou and Galileo)
Field replaceable SIM
1x M.2 2280 NVMe 1x M.2 2280 SATA
Volterra IGW5004 Intel Atom® C3538 2x DDR4 ECC SODIMM 2133 Mhz, Max of 2x32 GB Serial Bus: 1x RS232 or RS485
RS485: Up to 10 Mbps, 2-wire, half-duplex
RS232: Up to 1 Mbps, 2-wire, full-duplex
Modbus master & slave
LAN: 4x 1000Base-T with PoE 802.3 af supported on each
Wireless: Wi-Fi 11ac 2x2 MIMO Bluetooth 4.2 HS, BLE, ANT+
LTE Cat 4 (150 Mbps max DL / 50 Mbps max UL) coverage: worldwide (Supported Frequency Bands B1, B2, B3, B4, B5, B7, B8, B12, B13, B18, B19, B20, B25, B26, B28, B38, B39, B40 and B41)
3G fallback
GNSS (GPS, GLONASS, BeiDou and Galileo)
Field replaceable SIM
1x M.2 2280 SATA

Create a Site Token

Create a site token or use an existing token. If you are configuring a multi-node site, use the same token for all nodes.

Step 1: Log into VoltConsole and navigate to site tokens.
  • Click on the System namespace.
  • Select Manage -> Site Management -> Site Tokens.

NameSpaceNavig
Figure: Site Tokens

Step 2: Generate a new site token.
  • Click Add site token to create a new token. This loads the Add site token form.
  • In the Name field, enter the token name.
  • In the Description field, enter a description for the token.
  • Click Add site token.

CreateSiteToken
Figure: Site Token Form

Step 3: Note down the new token.
  • Find the token previously created or choose an existing token from the list of tokens displayed.
  • Click > to expand the token details in JSON format and note down the value of the uid field.

SiteTokenUID
Figure: UID Field


Prepare a Bootable USB

To create a bootable USB drive, you must flash the Volterra CE ISO image onto a USB drive. Depending on your operating system, you can use software (like Etcher) to quickly flash the USB drive with the ISO image.

Step 1: Download Etcher software based on your operating system.
  • Navigate to Etcher to download the installer file.
  • Follow the instructions to install Etcher.

Note: If you are running macOS X Catalina, you need to download the latest version of Etcher. If you do not and attempt to flash an ISO image, this terminal message appears:

“balenaEtcher” can’t be opened because Apple cannot check it for malicious software
Step 2: Download the Volterra Node ISO image file.

Note: A certified Volterra Node image software (iso/.img) is packaged with all the required components to provision Volterra-based components.

Step 3: Flash the USB drive.
  • Insert a USB into your computer.
  • Open Etcher.

FlashToUSB
Figure: Etcher


Configure the BIOS

Prior to installing the Volterra Node software, you need to configure your system’s BIOS menu. The BIOS provides the basic functions needed to boot your system and enables you to access specific hardware components.

Step 1: Invoke the BIOS menu.
  • To enter the BIOS menu, press a key or key combination (Delete or the F2 key) immediately after turning on your computer.

Note: The key combination differs from manufacturer to manufacturer. Typically, the start screen on the computer displays a message, stating which key to press to enter the BIOS menu.

FlashToUSB
Figure: BIOS Menu

Step 2: Select boot device.

Within the BIOS setup menu, you can select which devices will check in which sequence for a bootable operating system in the Boot tab.

Note: The possible choices usually include the internal hard disks, the CD/DVD-ROM drive and mass storage devices, such as USB sticks or external hard disks. The installation media in most of the scenarios is a flashed USB drive with the Volterra Node image.

  • Select the USB drive to boot first from the boot menu options.

USBBoot
Figure: Selection of Primary Boot Device

Most BIOS versions allow you to call up a boot menu on system startup in which you select from which device the computer starts for the current session. If this option is available, the BIOS usually displays a short message like “press F12 for boot menu” on system startup. The actual key used to select this menu varies from system to system. Commonly used keys are F12, F11, or F8. Choosing a device from this menu does not change the default boot order of the BIOS. In other words, you can start once from a USB drive while having configured the internal hard disk as the primary boot device.

BootMenu
Figure: Selection of Boot Device During System Start

Step 3: Check and fix potential issues.

If you have no PS/2-style keyboard, but only a USB model, you may need to enable legacy keyboard emulation in your BIOS menu to use your keyboard in the boot-loader menu. Modern systems do not have this issue.

  • If your keyboard does not work in the boot-loader menu, consult your system manual and look in the BIOS for “Legacy keyboard emulation” or “USB keyboard support” options.

Install the Volterra Node Software

After the boot order is configured to USB, a prompt loads with information to install the software.

  • Use the keyboard arrows to select INSTALL.

Prompt
Figure: Prompt for Review Configuration or Proceed Installation

  • Press Enter. The installation begins and displays the status of the process.

InstallProg
Figure: Installation Progress

Note: If no selection is made, the installation proceeds with the default values.

Note: If you install the Volterra Node software on hardware with CentOS, the Volterra software may fail to install. If this occurs, perform the following steps:

  • Check the disk name using the fdisk -l command.
  • Copy the disk that is affected using the dd command.

This is an example command:

dd if=/dev/zero of=/dev/nvme0n1 bs=1M count=32

Post-Install Node Parameter Configuration

At any point, you can login to the Volterra node via SSH using the admin user account and Volterra123 password to configure parameters.

Note: If you did not log in previously, you will be prompted to update the default password for the admin user account. Follow the instructions to update the default password.

Step 1: Log into the node using your credentials.

The login shell loads with different options to select for configuration.

  • Press the Tab key to select parameters to configure.

Node Login Shell Menu Options
Figure: Node Login Shell Menu Options

Step 2: Verify the configuration.
  • Select get-config.
  • Confirm the settings are correct.
Step 3: Start network configuration.

You have the option to configure the network.

  • Select configure-network.
  • Follow the prompts to configure network settings.
  • Optionally, enter Y for Do you want to configure wifi?.

Note: You cannot change an IP address for a registered node for a multi-node site. You must use fixed IP addresses or DHCP addresses with a fixed lease.

Step 4: Enter the SSID and password for your Wi-Fi network.

Configuring the network is optional. If you want to apply static configuration, then this option can be used.

Note: Configuring the network is optional. If you want to apply static configuration, then this option can be used.

Step 5: Configure the main options.
  • Press the Tab key to select the configure option.
  • Enter a cluster name.
  • Enter the registration token.
  • Enter a hostname. The option is set to master0 by default.

Note: Ensure that hostnames are unique if you are installing nodes for a multi-node site.

  • Enter the longitude and latitude information.
  • Select kvm-voltmesh for the certified hardware.

Note: You must first perform network configuration using the configure-network option before setting the other fields using the configure option in case you are applying static configuration for the network. Also, note that changing the assigned IP address after the successful registration of the node is not supported in cases of multi-node sites.

Step 6: Confirm configuration.
  • Enter Y to confirm configuration.

Generic Configuration
Figure: Generic Configuration

Step 7: Verify configuration status.
  • Press the Tab key to select the health option.
  • Verify your Wi-Fi configuration and registration status.

Node Wi-Fi Information
Figure: Node Wi-Fi Information

Note: You can select the factory-reset option to perform a configuration reset and repeat the registration process again per the instructions below.

Node Registration Status
Figure: Node Registration Status


Register the Baremetal Site

After the Volterra Node is installed, it must be registered as a Site in VoltConsole.

Note: The USB allowlist is enabled by default. If you change a USB device, such as a keyboard after registration, the device will not function.

Single-node Site Registration

Step 1: Navigate to the site registration page.
  • Log into VoltConsole and then navigate to the System namespace.
  • Click Manage -> Site Management -> Registrations.

Site Registration
Figure: Site Registration

Step 2: Complete site registration.
  • Under Pending Registrations, find your node name and then click the blue checkmark.

  • In the form that appears, fill in all required fields with the asterisk symbol (*).
  • Enter a latitude value and a longitude value.

  • Enter other configuration information, if needed.
  • Click Save and Exit.
Step 3: Check Site status and health.

It may take a few minutes for the site registration information to update.

  • In the System namespace, click Sites -> Site List.
  • Click on your site name. The Dashboard tab appears, along with many other tabs to inspect your site.
  • Click the Site Status tab to verify the following:

    • The Update Status field has a Successful value for the Volterra OS Status section.
    • The Update Status field has a Successful value for the Volterra Software Status section.
    • The Tunnel status and Control Plane fields under the RE Connectivity section have up values.

Multi-node Site Registration

Step 1: Navigate to the site registration page.
  • Log into VoltConsole and then navigate to the System namespace.
  • Click Manage -> Site Management -> Registrations.

AcceptReg
Figure: Site Registration

Step 2: Accept the registration requests.

Registration requests are displayed in the Pending Registrations tab.

  • Click Accept to accept the registration requests from the master-0, master-1, and master-2 nodes.
  • Enter the same values for the following parameters for all the registration requests:

    • In the Cluster name field, enter a name for the cluster. Ensure that all master nodes have the same name.
    • In the Cluster size field, enter 3. Ensure that all master nodes have the same cluster size.
  • Enter all mandatory fields marked with the asterisk (*) character.
Step 3: Check site status and health.

It may take a few minutes for the site health and connectivity score information to update.

  • In the System namespace, click Sites -> Site List.
  • Click on your site name. The Dashboard tab appears, along with many other tabs to inspect your site.
  • Click the Site Status tab to verify the following:

    • The Update Status field has a Successful value for the Volterra OS Status section.
    • The Update Status field has a Successful value for the Volterra Software Status section.
    • The Tunnel status and Control Plane fields under the RE Connectivity section have up values.

Note: You can log into your Node’s Volterra command-line interface (CLI) via SSH with username centos and your private key.


Concepts