We're pleased to announce the immediate availability of Senate Matching Release 1.8.0 (July 2020). This release makes it easier for customers to get started with Senate Matching, and includes many improvements to performance, monitoring and bug fixing (you might not have noticed them, but we did!). All current Senate Matching customers are encouraged to update their Contributor Nodes to 1.8.0 at their convenience.

Here's what you need to know:

  • We've streamlined the on-boarding process so that our Customer Success team can help get you up and running faster.
  • We've also updated our development processes with more automated security checks, better monitoring of the matching network, and better matching performance. These are largely "internal facing" features, and they will help us serve you better!

Downtime: The release is scheduled to go to production environments Thursday, 2 July 2020 (Australian time - see below for specific time zones). System downtime is expected with this release, for up to one (1) hour during the release window. The release windows are:

  • USA: 9:00pm-10:30pm Sunday, 28th June PDT
  • Australia: 8am-9:30am Thursday, 2nd July AEST
  • Singapore: 7:30am-9:00am Thursday, 2nd July SGT

Here's what you need to do:

All customers are encouraged to upgrade to the new release at their earliest convenience.

To upgrade your Contributor Node, follow these steps:

1. Shutdown your current Contributor Node

To stop your currently running node, use the command contributor.sh down which will cleanly shutdown the Docker container.

$ sudo bash contributor.sh down

2. Update your start up script

Edit your version of contributor.sh to point to the latest Docker image tags. The relevant lines are given below (edit your file to match this):

contributor.sh (example)

export HITCH_DOCKER_IMAGE_TAG="1.8.0" # latest (Jul 2020)
export HITCH_UI_DOCKER_IMAGE_TAG="1.8.0" # latest (Jul 2020)

3. Restart your Contributor Node

Start your Contributor Node with the contributor.sh up command. The script will download the latest version of the node software from our repository. Your data will be preserved during the update. The "-d" option starts the Docker containers in the background. Depending on your local environment, you may or may not need to run as sudo.

$ sudo bash contributor.sh up -d

FAQ

Do I HAVE to update?

Customers on 1.7.0 or higher do not need to upgrade, although we encourage it to reduce the risk of support issues.

Customers on 1.6 or earlier must upgrade. The token format changed in 1.6, and Senate will no longer understand how to perform token masking on the old decimal-encoded tokens. You will not be able to load match results into a Workspace until your tokens are in 1.6 (hexadecimal) format.

Where do I get contributor.sh from?

Use your previously distributed version. Contact Customer Success if there are any issues.

How do I know what version I am running?

Use your browser to visit your Contributor Node UI. You do not need to log in. Check the bottom of the web page:

  • If you see a message starting "Version" (e.g. "Version 1.6.0 (build g13b5da0)") then this is the current version of your Contributor Node.
  • If you only see a copyright message, then you are running version 1.5.0 or earlier and must update.

What security / testing / review checks have been performed on this release?

  • QA performed a full regression test and tested performance of token databases containing up to 20M records. Recommended max database size is 10M rows.
  • Static code analysis (Gosec) scanned all files and found 0 errors or warnings.
  • All code is peer-reviewed in a "pull request" by at least one other developer before it is accepted onto the release branch.
  • All (automated) unit tests passed.
  • All (automated) integration tests passed.
Did this answer your question?