2018-08-15 18:51:52 -07:00
|
|
|
# TestNet debugging info
|
|
|
|
|
|
|
|
Currently we have two testnets, 'perf' and 'master', both on the master branch of the solana repo. Deploys happen
|
|
|
|
at the top of every hour with the latest code. 'perf' has more cores for the client machine to flood the network
|
|
|
|
with transactions until failure.
|
|
|
|
|
|
|
|
## Deploy process
|
|
|
|
|
|
|
|
They are deployed with the `ci/testnet-deploy.sh` script. There is a scheduled buildkite job which runs to do the deploy,
|
|
|
|
look at `testnet-deploy` to see the agent which ran it and the logs. There is also a manual job to do the deploy manually..
|
|
|
|
Validators are selected based on their machine name and everyone gets the binaries installed from snap.
|
|
|
|
|
|
|
|
## Where are the testnet logs?
|
|
|
|
|
|
|
|
For the client they are put in `/tmp/solana`; for validators and leaders they are in `/var/snap/solana/current/`.
|
|
|
|
You can also see the backtrace of the client by ssh'ing into the client node and doing:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ sudo -u testnet-deploy
|
|
|
|
$ tmux attach -t solana
|
|
|
|
```
|
|
|
|
|
|
|
|
## How do I reset the testnet?
|
|
|
|
|
|
|
|
Through buildkite.
|
|
|
|
|
|
|
|
## How can I scale the tx generation rate?
|
|
|
|
|
|
|
|
Increase the TX rate by increasing the number of cores on the client machine which is running
|
|
|
|
`bench-tps` or run multiple clients. Decrease by lowering cores or using the rayon env
|
|
|
|
variable `RAYON_NUM_THREADS=<xx>`
|
|
|
|
|
|
|
|
## How can I test a change on the testnet?
|
|
|
|
|
|
|
|
Currently, a merged PR is the only way to test a change on the testnet.
|
2018-08-20 17:50:12 -07:00
|
|
|
|
|
|
|
## Adjusting the number of clients or validators on the testnet
|
|
|
|
|
|
|
|
1. Go to the [GCP Instance Group](https://console.cloud.google.com/compute/instanceGroups/list?project=principal-lane-200702) tab
|
|
|
|
2. Find the client or validator instance group you'd like to adjust
|
|
|
|
3. Edit it (pencil icon), change the "Number of instances", then click "Save" button
|
|
|
|
4. Refresh until the change to number of instances has been executed
|
|
|
|
5. Click the "New Build" button on the [testnet-deploy](https://buildkite.com/solana-labs/testnet-deploy/)
|
|
|
|
buildkite job to initiate a redeploy of the network with the updated instance count.
|