How to Provision a Solana Validator/RPC Edge Bare Metal Server

Updated by Brandy Smith on Apr 12, 2022
Article Code: kb/1417

Description

This article outlines the step-by-step process to provision a bare metal server within the Lumen Edge Services portal specific to the contracted server configuration approved for Solana Validators/RPC.

Prerequisites

  • Customer has a Control Center account with an active Edge Bare Metal account.
  • Customer can successfully access the Edge Services portal. First time log-in guide can be found here.
  • The Solana Validator/RPC needs to add credentials for the instance type (Linux or Windows) in their profile.
    At deployment, the applicable credentials for the provisioning user are added to the server by default.

If you have not yet added credentials for the instance type (Linux or Windows) to your profile, please do that step now by following the steps below.

Important: Failure to add credentials for the instance type in the User Profile will cause you to be locked out of accessing the server.

If you accidentally provision a server prior to adding your credentials, please delete the server, set your credentials, and deploy a new server.

Password Requirements per Operating System
Below are the Password requirements per Operating System as defined by the OS vendor.

  • There is no password limitation on the clean install of Ubuntu and CentOS; however, a BAD PASSWORD message may appear while trying to set the password. Whenever there is a BAD PASSWORD prompt for the following conditions, the user-data script is unable to properly set the credentials and the user will not be able to login.

  • Password must be minimum 8 characters for all operating systems (OS) and must include uppercase, lower case, a number, and a special character.

  • Ubuntu 18 and 20 - Capital letters and email addresses are not allowed as the username.

  • CentOS 7.9 and 8.3 - Email addresses are not allowed, dictionary words can’t be used as a password, the password cannot contain the username in any form.

CentOS Specific Password Requirements

  • Must be at least eight characters long.
  • May contain numbers, letters (upper and lower case), and symbols.
  • Is case-sensitive and should contain a mix of cases.
  • Should not be a word, abbreviation, or number associated with you, your organization, or found in a dictionary (including foreign languages).

For more information on CentOS password requirements, please view the CentOS Password Guide.

Linux/Ubuntu Specific Password Requirements

By default, Ubuntu requires a minimum password length of 6 characters, as well as some basic entropy checks. These values are controlled in the file /etc/pam.d/common-password, which is outlined below.

For more information on Linux/Ubuntu password requirements, please view the Linux/Ubuntu Password Guide.

Steps to add Linux and Windows Settings under the User Profile

  1. Log into the Edge Services portal.
  2. In the top right corner of the Edge Services Portal, click on your Name.
  3. Click User Settings.
  4. Enter your Linux and Windows username(s) and password(s).
    Note: Ubuntu is the approved OS for Solana Validators/RPC, it is a required step that you enter your Linux credentials under User Settings.
  5. Click Save.

Steps to Provision a Solana Validator/RPC Edge Bare Metal Server

Log into your Lumen Edge account within the Lumen Edge Services portal.
To start the Provision Server process, use the top navigation and choose Provisioning.

  1. Under the Provisioning tab, choose Instances.

Provisioning > Instances menu

  1. Once under the Instances tab, Click the +ADD button to begin the process of Provisioning a Bare Metal server.

Click the +Add button

  1. Create Instance Type: The approved Operating System for Solana Validator/RPC software is Ubuntu 20.04.
    Choose the Ubuntu operating system for this server and click the NEXT button.

Note: The ability for customers to bring their own OS/image is not yet available but is a feature that Lumen is building on the platform for future release.
Some Operating Systems may have licensing fees associated with them; for ones that have a licensing fee, the cost will be displayed in the portal prior to purchase. Ubuntu 20.04 is an Open Source operating system and no fees will be applied to your account for using this operating system.

Instance Operating System Select

  1. Instance Summary: in this section, you will see multiple fields.

Instance Summary

Below outlines the purpose of each field in the image above.

Group

  • Required field, pre-populated, no cost.
    Currently, the only Group option available, "Lumen Edge Computing Solutions" is pre-populated for you.
    As the platform evolves, customers will have more Group options to choose from.

Name

  • Required field, free text, no cost.
    Customers can name the servers as they see fit.

Environment

  • Required field, drop down, no cost.
    Customers can choose which environment they want the server to be hosted.
    The environment exists to provide segmentation of server groups across environments.
    The Environments section is where you create and manage your environment labels, which are available in the Environment dropdown during Instance or App provisioning.
    An Instance’s environment label can be changed by editing the Instance.

Label

  • Required field, free text, no cost.
    Customers can add labels to the servers as they see fit.
    Labels provide another way for customers to manage, report, or group servers.
  1. Configuration Options

In this section, you will see multiple fields. Once you have made selections for all the required fields, please review each for accuracy and then click the NEXT button to proceed to the next steps.
Please note that there are some prerequisites and actions users must take for some fields below. Please read this section carefully before moving on to the next step.

Configuration Options

Below outlines the purpose of each field in the image above.

Version

  • Required field, drop down, cost based on OS.
    The operating system approved for Solana Validator/RPC software is Ubuntu 20.04. Choose the 20.04 version under the version drop down field.

Layout

  • Required field, pre-populated, cost based on OS.
    This field is pre-populated with the Operating System you selected earlier.

IMPORTANT NOTE FOR SOLANA VALIDATORS/RPC
There are only two Bare Metal Server plans approved for Solana Validator/RPC software.
It is the responsibility of the Solana Validator/RPC to select the approved server plan. If the wrong server plan is selected, the Validator/RPC is responsible for any incurred charges and will be billed accordingly.
Solana Validators/RPC are approved to purchase up to two Validator/RPC servers at the special Solana contracted rate per the contract you signed.
The two Validator/RPC servers will not have egress bandwidth charges applied.
The list pricing in the portal applies to any services you procure above and beyond the two Validator/RPC servers that are outlined in the Solana Validator/RPC contract.
The special pricing will be applied at the time of invoicing and the price in the portal is rounded to the nearest hourly unit using the formula below. Partial month usage is pro-rated at the monthly price based on the calculations below. As this is a usage-based platform, you are billed for services a month in arrears.

ASSUMPTIONS FOR CALCULATION OF HOURLY COMPUTE

  • 720 hours in a month
  • 30.42 days in a month
  • 4.35 weeks in a month

Validators/RPC can purchase other plans and services with the Edge Services portal. Please note that those services will all bill at list price. For estimated costing of list prices for Edge services outside of the Solana Validator/RPC contract, please visit the Edge Price Estimator.

Plan

  • Required field. Select the Solana-approved server configuration based on the region you are deploying the server under the plan drop down field. The approved server configuration and plan for Solana validators/RPC is listed below.
  • For Servers in North America, choose the following plan option:

Lumen Edge Bare Metal Solana NA - Cores: 32 RAM: 256 Storage: 2400

  • For Servers in EMEA, choose the following plan option:

Lumen Edge Bare Metal Solana EMEA - Cores: 32 RAM: 256 Storage: 2400

Volumes

  • Required field, pre-populated, not editable.
    This field shows the storage volumes for the related Server Plan selected.
    Note: During provisioning only the primary disk on bare metal server is preconfigured to give the user more control over the volume configuration. All additional disks are left in a raw state for configuration as you see fit.

Location

  • Required field, drop down.
    This field is where you will select which Lumen Edge data center you want to deploy the Solana Validator/RPC Bare Metal Server in.
  • The location you choose should match the plan region of the server plan selected.
  • Currently, the below locations are the ONLY locations available for Solana Validators/RPC. Please choose one of the locations listed below. New sites will be added in a phased approach and this documentation will be updated with the new sites as they become available to Solana Validators/RPC.

If you choose a location outside of the list below, the server will fail to provision.

North America Locations & (Markets)

  • Austin, TX (Austin)
  • Amarillo, TX (Amarillo)
  • Boise, ID (Boise)
  • Cambridge, MA (Boston)
  • Charlotte, NC (Charlotte)
  • Cincinnati, OH (Cincinnati)
  • Cleveland, OH (Cleveland)
  • Dallas, TX (Dallas)
  • Denver, CO (Denver)
  • Detroit, MI (Detroit)
  • El Paso, TX (El Paso)
  • Fresno, CA (Fresno)
  • Herndon, VA (Washington DC)
  • Houston, TX (Houston)
  • Indianapolis, IN (Indianapolis)
  • Jackson, MS (Jackson)
  • Jacksonville, FL (Jacksonville)
  • Kansas City, MO (Kansas City)
  • Lachine, QC (Montreal)
  • Las Vegas, NV (Las Vegas)
  • Little Rock, AK (Little Rock)
  • McAllen, TX (McAllen)
  • Metairie, LA (New Orleans)
  • Minnetonka, MN (Minneapolis)
  • Nashville, TN (Nashville)
  • Omaha, NE (Omaha)
  • Philadelphia, PA (Philadelphia)
  • Phoenix, AZ (Phoenix)
  • Pittsburgh, PA (Pittsburgh)
  • Portland, OR (Portland)
  • Reno, NV (Reno)
  • Sacramento, CA (Sacramento)
  • Salt Lake City, UT (Salt Lake City)
  • San Antonio, TX (San Antonio)
  • San Diego, CA (San Diego)
  • Santa Clara, CA (San Jose)
  • Spokane, WA (Spokane)
  • St.Louis, MO (St.Louis)
  • Tampa, FL (Tampa)
  • Toronto, ON (Toronto)
  • Tulsa, OK (Tulsa)
  • Tustin, CA (Tustin)
  • Vancouver, BC (Vancouver)

EMEA Locations

  • Amsterdam, Netherlands
  • Frankfurt, Germany
  • London, England
  • Munich, Germany
  • Paris, France

Bandwidth

  • Required field, drop down.
    This field is where you select your Network Bandwidth.

User Config

  • Required field, pre-populated, no cost, no action required.

Advanced Options

  • Non-Required fields, free text, no costs.
    These fields are discretionary for the customer to use as they see fit.
  1. Automation

Currently, this section is not functional. Please press the NEXT button to proceed.

  1. Review

Configuration Final Review Screen

This is the final screen for customers to review all of the sections from the previous steps. When you click the COMPLETE button, the server will begin provisioning.

After the server is successfully created, billing for that server configuration starts, so it is important that you review and ensure that your selections are accurate and meet the Solana Validator/RPC requirements prior to clicking the COMPLETE button.

Any billable components will show on the review screen.

If you need to make a change to selections, click the PREVIOUS button to go back to make any changes.

Once you have reviewed for accuracy, please click the COMPLETE button to proceed.

After you click the COMPLETE button, your Bare Metal server will begin to provision.

A live tracker will appear showing the progression of your server build with an estimated time of completion.

On average, server configurations take up to 30 minutes to build. Once built, if a reboot time is ~3 minutes.

After the server is built, billing starts. You can manage your Edge Bare Metal Server by going to your Dashboard section and finding the server under the MY INSTANCES section of the dashboard.

To learn more about how to manage your Bare Metal servers, please visit this Knowledge Base article.

For more Bare Metal support, please visit this Support page.