Skip to content

StakerSpace/sv-manager

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Solana Validator Manager

Automatically bootstrap a Solana validator node, optimize its performance, and connect the node to a monitoring dashboard

Solana is a fast, secure, and censorship-resistant blockchain providing open infrastructure necessary for global adoption.

In order to run, the Solana blockchain requires a decentralized network comprising computing resources to validate transactions as well as storage for ledger redundancy.

The computer resources are provided by validators who need to maintain high-performance Linux nodes.

There are now two Solana clusters, Mainnet-Beta and Testnet.

The Mainnet-Beta cluster is maintained by ~700 validators, and the Testnet cluster by ~1700 more validators.

Most of the people running these just bootstrap their nodes manually, referring to the Solana docs or similar community guides. Apparently, there are no 2 identical setups across these 2400 validators.

As a result, it is virtually impossible to support validators having issues with their nodes and/or help them improve their node, thus contributing to the overall cluster performance.

What we would like to do is provide a toolkit to help validators bootstrap and maintain their nodes in a uniform, consistent way.

The Ansible scripts we have created for this purpose are a compilation of best practices and community guidelines.

Please use them, enjoy them, and improve them.

Quick Install

  • Log in to your server

  • If you don’t have a key pair yet, skip this step: it will be generated automatically.

    If you have a key pair, create the key pair file in your home directory (you can also upload it via scp if you prefer):

    nano ~/validator-keypair.json

    Paste your key pair, save the file (ctrl-O) and exit (ctrl-X).

  • If you don’t have a vote account key pair yet, skip this step: it will be generated automatically.

    If you have a vote account key pair, create the key pair file in your home directory (or upload it via scp):

     nano ~/vote-account-keypair.json

    Paste your key pair, save the file (ctrl-O) and exit (ctrl-X).

  • Run this command…

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/mfactory-lab/sv-manager/latest/install/install_validator.sh)"

…and follow the wizard’s instructions (__enter your own Node name!__):

That's it, you are all set!

How to update validator

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/mfactory-lab/sv-manager/latest/install/update_validator_version.sh)" --version 1.7.9

how to update monitoring

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/mfactory-lab/sv-manager/latest/install/update_monitoring.sh)" 

If you want more control over the configuration of your node, please refer to the advanced technical specifications

We fixed a bug that sometimes caused the sv-manager to fail to copy the keypair file.

If you launched sv-manager on May 16, between 0:00 and 12:00 UTC and you have only about 1 SOL on your identity account,

then please run our quick fix:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/mfactory-lab/sv-manager/latest/install/quick_fix_wrong_keys.sh)"

It will backup your keypair, copy your correct keypair to /home/solana/secrets, set up your vote account, create a vote account keypair, and link your Identity keypair to your Vote account keypair. It will then restart the validator node.

Useful links

How you can support this project

Packages

No packages published

Languages

  • Python 49.2%
  • Shell 37.6%
  • Jinja 13.2%