docs: Add 1.2.0 release note.
This commit is contained in:
parent
f46ffcb60d
commit
a06a62bfd0
69
release-notes.1.2.0.md
Normal file
69
release-notes.1.2.0.md
Normal file
@ -0,0 +1,69 @@
|
|||||||
|
# vspd 1.2.0
|
||||||
|
|
||||||
|
vspd v1.2.0 contains all development work completed since v1.1.0 (March 2022).
|
||||||
|
Since then, 80 commits have been produced and merged by 3 contributors.
|
||||||
|
All commits included in this release can be viewed on GitHub
|
||||||
|
[here](https://github.com/decred/vspd/compare/release-v1.1.0...release-v1.2.0).
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
vspd 1.2.0 must be built with go 1.19 or later, and requires:
|
||||||
|
|
||||||
|
- dcrd 1.8.0
|
||||||
|
- dcrwallet 1.8.0
|
||||||
|
|
||||||
|
When deploying vspd to production, always use release versions of all binaries.
|
||||||
|
Neither vspd nor its dependencies should be built from master when handling
|
||||||
|
mainnet tickets.
|
||||||
|
|
||||||
|
## Recommended Upgrade Path
|
||||||
|
|
||||||
|
The upgrade path below includes vspd downtime, during which clients will not be
|
||||||
|
able to register new tickets, check their ticket status, or update their voting
|
||||||
|
preferences. Voting on tickets already registered with the VSP will not be
|
||||||
|
interrupted. You may wish to put up a temporary maintenance webpage or announce
|
||||||
|
downtime in public channels.
|
||||||
|
|
||||||
|
1. Build vspd from the 1.2.0 release tag. Build dcrwallet and dcrd from their
|
||||||
|
1.8.0 release tags.
|
||||||
|
1. Stop vspd.
|
||||||
|
1. Stop the instance of dcrd running on the vspd server.
|
||||||
|
1. **Make a backup of the vspd database file in case rollback is required.**
|
||||||
|
1. Install new dcrd binary on the vspd server and start it to begin database
|
||||||
|
upgrades. You can proceed with the following steps while the upgrades run.
|
||||||
|
1. Upgrade voting wallets one at a time so at least two wallets remain online
|
||||||
|
for voting. On each server:
|
||||||
|
1. Stop dcrwallet.
|
||||||
|
1. Stop dcrd.
|
||||||
|
1. Install new dcrd binary and start.
|
||||||
|
1. Wait for dcrd database upgrades to complete.
|
||||||
|
1. Check dcrd log file for warnings or errors.
|
||||||
|
1. Install new dcrwallet binary and start.
|
||||||
|
1. Wait for dcrwallet database upgrades to complete.
|
||||||
|
1. Check dcrwallet log file for warnings or errors.
|
||||||
|
1. Wait for dcrd on the vspd server to complete its database upgrade.
|
||||||
|
1. Check dcrd log file for warnings or errors.
|
||||||
|
1. Install new vspd binary and start it.
|
||||||
|
1. Check vspd log file for warnings or errors.
|
||||||
|
1. Log in to the admin webpage and check the VSP Status tab for any issues.
|
||||||
|
|
||||||
|
## Notable Changes
|
||||||
|
|
||||||
|
- vspd has moved into the cmd directory of the repo. This is standard practise
|
||||||
|
in Decred repos which include more than one golang executable. The new command
|
||||||
|
to build is:
|
||||||
|
|
||||||
|
```no-highlight
|
||||||
|
go build ./cmd/vspd
|
||||||
|
```
|
||||||
|
|
||||||
|
- `/vspinfo` now returns `votingwalletsonline` and `votingwalletstotal`.
|
||||||
|
- The login form for the admin page is now limited to 3 attempts per second per IP.
|
||||||
|
- A warning is logged when running a pre-release version of vspd on mainnet.
|
||||||
|
- The ID of the git commit vspd was built from is now included in startup
|
||||||
|
logging and in the output of `--version`.
|
||||||
|
- A new executable `vote-validator` is a tool for VSP admins to verify that
|
||||||
|
their vspd deployment is voting correctly according to user preferences.
|
||||||
|
Further details can be found in the [README](./cmd/vote-validator).
|
||||||
|
- A new executable `v3tool` is a development tool helpful for testing changes to
|
||||||
|
vspd. Further details can be found in the [README](./cmd/v3tool).
|
||||||
Loading…
x
Reference in New Issue
Block a user