Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add howto guide for how to setup a validator and attach to the testnet #3261

Closed
mvines opened this issue Mar 13, 2019 · 6 comments · Fixed by #3751
Closed

Add howto guide for how to setup a validator and attach to the testnet #3261

mvines opened this issue Mar 13, 2019 · 6 comments · Fixed by #3751
Assignees

Comments

@mvines
Copy link
Member

mvines commented Mar 13, 2019

Let's add a howto guide (perhaps as a section of the book) that details how a 3rd party can setup a validator on the testnet. This guide should not use multinode-demo/ scripts in any form, instead should describe how to do this from the pure solana program deliverables. Include how to setup the updater implemented at #3222 to keep the validator node up to date.

@mvines mvines added this to the Grandview v0.13.0 milestone Mar 13, 2019
@mvines
Copy link
Member Author

mvines commented Mar 21, 2019

Current solana-install-based node bootstrap looks like this on Linux:

$ wget https://github.com/solana-labs/solana/releases/download/v0.13.0-infratest1/solana-install-x86_64-unknown-linux-gnu -O /tmp/solana-install
$ chmod +x /tmp/solana-install
$ /tmp/solana-install init --url http://api.beta.testnet.solana.com/
$ export PATH=~/.local/share/solana/install/bin:$PATH

Once bootstrapped you can use the normal solana cli tools like

$ solana-keygen ; solana-wallet

or check for an update with

$ solana-install info

or manually apply an update with

$ solana-install update

or even run a validator while automatically applying updates:

$ solana-install run solana-fullnode ...

@aeyakovenko
Copy link
Member

how do we point to the testnet?

@mvines
Copy link
Member Author

mvines commented Mar 21, 2019

how do we point to the testnet?

Like this:

/tmp/solana-install init --url http://api.beta.testnet.solana.com/

The default URL is http://api.testnet.solana.com/ so a regular user who just wants “the testnet” can just run /tmp/solana-install init with no arguments

@mvines
Copy link
Member Author

mvines commented Mar 21, 2019

As of #3417, we now have a much nicer bootstrap process than described at #3261 (comment)

$ curl -sSf https://raw.githubusercontent.com/solana-labs/solana/v0.13.0/install/solana-install-init.sh | sh

@mvines
Copy link
Member Author

mvines commented Apr 8, 2019

The remaining work here is to add some plumbing to net/ to run solana-install deploy as new versions of the stable testnet is deployed to release the matching binaries to downstream users.

Flagging this as blocked for now as I'd like to do this work once 0.13 moves to beta and stabilizes first.

@mvines
Copy link
Member Author

mvines commented Apr 11, 2019

#3729 addresses the previous comment. I'll keep this issue open for a while longer to:

  1. Periodically remind myself to check that the solana-install deployment works against testnet-edge
  2. Update https://github.com/solana-labs/solana/blob/master/book/src/testnet-participation.md to describe how to use solana-install

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants