Create Baremetal Site

Objective

This document provides instructions on how to install Volterra single-node or multi-node site on custom hardware using Volterra site image. For more information on Volterra site and nodes, see the Volterra Site document.


Prerequisites

  • Volterra Account. In case you do not have an account, see Create a Volterra Account.
  • Volterra node software image. See Volterra Images to download the image.
  • 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.

Minimum HW Requirements

Volterra Node has been designed to work on almost all commodity-based hardware. Below are the minimum requirements when sourcing ODM based 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

Notes:

  • Current architecture supported is x86. Arm is currently on the roadmap.
  • Memory, Storage and CPU requirements vary based on the application usage on the system/host
  • Must have: DPDK supported. Refer to: https://core.dpdk.org/supported/nics/intel/ for more information
  • USB requirements for the host vary on the number of peripheral device connections

Tested 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, a user may attempt to install Volterra Node but official support will be limited.

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
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) Eth1 = (LAN/Site Local Inside Interface).

Server Hardware

Vendor Model Processor Memory Networking Storage
HPE DL3xx Gen 10 Intel Xeon DDR4-2666 32GB x 12 (384GB+) Intel (XXV710: 10/25/40GMellanox (MLX5) 10/25GB SSD NVMe (1TB, 4TB)
Kingstar SYS-1029U-TN10RT Intel Xeon DDR4-2666 32GB x 12 (384GB+) Intel XXV710 (10/25G) SSD NVMe (1TB, 4TB)

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 Site Token

Step 1: Navigate to the system namespace.

Select the system namespace to obtain a token. You can use an existing token or create a new one. A site can be configured as single-node or multi-node site. In case of multi-node site, use the same token for all installations.

NameSpaceNavig
Figure: Navigate to Namespace

Step 2: Generate token.

Select Manage -> Site Management from the configuration menu and select Site Token from the options pane. Click Add site token to create a new token. This loads the Add site token form. Enter the site name and description in the Name and Description fields respectively. Click Add site token button at the bottom of the form.

CreateSiteToken
Figure: Create a site token

Step 3: Notedown the token.

Find the token you created or choose an existing token from the list of tokens displayed. Click the > to expand the token details in JSON format and note the value of the uid field.

SiteTokenUID
Figure: Find Site Token UID


Prepare a Bootable USB

You can use tools like Etcher to quickly flash Volterra CE - ISO image onto a USB drive.

FlashToUSB
Figure: Bootable USB Preparation

In case of Mac OS X Catalina, download the latest version of Etcher for flashing the image. If not, attempt to flash the image returns the following:

“balenaEtcher” can’t be opened because Apple cannot check it for malicious software.

Pre-Install

A certified image (iso/.img) is packaged with all required components to provision Volterra based components.

Step 1: Invoke BIOS menu.

The BIOS provides the basic functions needed to boot your machine and to allow your operating system to access your hardware. Your system provides a BIOS setup menu, which is used to configure the BIOS. To enter the BIOS setup menu you have to press a key or key combination after turning on the computer. Often it is the Delete or the F2 key (in most of the hardware including the ones mentioned above), but some manufacturers use other keys. Usually upon starting the computer there will be a message stating which key to press to enter the setup screen.

FlashToUSB
Figure: BIOS Menu Setup

Step 2: Select boot device.

Within the BIOS setup menu, you can select which devices shall be checked in which sequence for a bootable operating system. Possible choices usually include the internal hard disks, the CD/DVD-ROM drive and USB mass storage devices such as USB sticks or external USB hard disks.The installation media in most of the scenarios is a USB stick with Volterra-CE image on it (follow procedure in the section above to make a bootable Volterra USB device)

USBBoot
Figure: Selection of Primary Boot Device

Most BIOS versions allow to call up a boot menu on system startup in which you select from which device the computer should start 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 and F8. Choosing a device from this menu does not change the default boot order of the BIOS, i.e., you can start once from a USB stick while having configured the internal hard disk as the normal primary boot device.

BootMenu
Figure: Selection of Boot Device During System Start

Step 3: Check and fix potential issues.

USB BIOS support and keyboards: If you have no PS/2-style keyboard, but only a USB model, on some very old PCs you may need to enable legacy keyboard emulation in your BIOS setup to be able to use your keyboard in the boot-loader menu, but this is not an issue for modern systems. If your keyboard does not work in the boot-loader menu, consult your mainboard manual and look in the BIOS for “Legacy keyboard emulation” or “USB keyboard support” options.


Install

Step 1: Once the USB is chosen from the boot menu, a prompt loads with the choice to proceed with installation or review the configuration.

installreview
Figure: Prompt for Review Configuration or Proceed Installation

Step 2:Select install and an automated install will be initiated showing the status of the install.

InstallProg
Figure: Installation Progress

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


Post-Install

At any point of time, you can login to the node via SSH using the admin username and Volterra123 password. Perform the following in order to set the node parameters.

Note: Login for the first time prompts you to update the password for the admin user.

Step 1: Log on to the node using your credentials.

The login shell loads with the options to select for different activities. Use the TAB key to select options.

login
Figure: Node Login Shell Menu Options

Step 2: Select get-config and enter to verify the configuration.

get config
Figure: Node Login Shell Get Configuration

Step 3: Start network configuration.

Enter configure-network. Enter Yes for Do you want to configure ADVANCED network options? and Do you want to configure wifi? options.

Configuring network is optional.

Step 4: Enter the SSID and password for your wifi network.

wifi
Figure: Node Wifi Configuration

Note: Configuring network is optional. In case you intend to apply static configuration, then this option can be used.

Step 5: Select configure and press enter. Enter the following fields.
  • Cluster Name
  • Registration Token - Enter the token you created in the Create Site Token chapter.
  • Hostname (master0 by default)

    Note: Ensure that host names are distinct and unique incase you are installing nodes for multi-node site.

  • Longitude and Latitude information
  • Certified Hardware - Select generic-single-nic-voltmesh or generic-multi-nic-voltmesh depending on the NICs.

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

sel cert hw
Figure: Generic Configuration

Step 6: Confirm configuration.

Enter Yes for confirm configuration.

Step 7:Verify the configuration status.

Select health option and enter to verify your wifi configuration and registration status.

health wifi
Figure: Node Wifi Information

health reg
Figure: Node Registration Status

Note: Select the factory-reset option to perform a reset and perform registration again as per the instructions in the next chapter.


Perform Site Registration

Single-node Site Registration

Step 1: Navigate to registrations and start registration approval.

Log in to the VoltConsole with your tenant and select Manage from the configuration menu. Select Registrations from the options pane and choose your site in the displayed list of sites. Click ✅ to load the Registration Acceptance form.

AcceptReg
Figure: Accept Pending Registration

Step 2: Enter the required fields and complete registration.

Enter the site configuration parameters and click Accept.

SiteParam
Figure: Configure Site Parameters

Note: Enter all mandatory fields marked with the * character.

Step 3: Check the site status and health.

Select Sites -> Site List and click on your site from the displayed site list to see the dashboard for your site.

HealthCheck
Figure: Site Health Check

Note: After you accept the registration, it takes few minutes for the health and connectivity status to get updated in the portal. Click the Site Status tab to verify the following (established in that order during the site bring up):

  1. The Last Upgrade field has Successful value for the Volterra OS Status section.
  2. The Last Upgrade field has Successful value for the Volterra Software Status section.
  3. The IPSEC status field under RE Connectivity section has up value.

Multi-node Site Registration

Step 1: Navigate to registrations and perform registration.

Accept 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.

  1. ‘Cluster name’ = ‘volterra-demo-site-mce’
  2. ‘Cluster size’ = ‘3’

RegReqM-0
Figure: Registration request from ‘master-0’ node
RegReqM-1
Figure: Registration request from ‘master-1’ node
RegReqM-1
Figure: Registration request from ‘master-2’ node

Note: Enter all mandatory fields marked with the * character.

Step 2:Check the site status and health

Select Sites -> Site List and click on your site from the displayed site list to see the dashboard for your site.

SiteDashBrd
Figure: Volterra Site Dashboard

Note: After you accept the registration, it takes few minutes for the health and connectivity status to get updated in the portal. Click the Site Status tab to verify the following (established in that order during the site bring up):

  1. The Last Upgrade field has Successful value for the Volterra OS Status section.
  2. The Last Upgrade field has Successful value for the Volterra Software Status section.
  3. The IPSEC status field under RE Connectivity section has up value.

Note: You can log on to the Volterra CLI on your node through SSH with username centos and your private key.


Concepts