Oracles v1.10 Upgrade Guide

Disclaimer: These instructions are made for Ubuntu 20.04. The commands may not match 100% on other distros, nor is there any guarantee that it will work.

Changelog

• oracle-suite version 0.4.10 (gofer, setzer)
• Removal of the pairs AAVE/USD, AVAX/USD, BAL/USD, BAT/USD, COMP/USD, CRV/USD, DOT/USD, FIL/USD, KNC/USD, LRC/USD, PAXG/USD, SNX/USD, SOL/USD, WNXM/USD, XRP/USD, XTZ/USD, ZEC/USD, ZRX/USD
• Various fixes, including to setzer
• Test improvements
• Decreased default log verbosity
• Leeloo, a tool to attest on chain events, is included in the package but turned off by default.

Notes

• Configuration for gofer and spire is now in /etc/gofer.conf and /etc/spire.conf (was .json)
• Spire port config is set to its default (tcp/8000) by the upgrade script. Update your firewall configuration if applicable, or after the upgrade set it manually in /etc/spire.conf, transport: {libp2p: {listenAddrs: ["/ip4/0.0.0.0/tcp/8000"]} }

Prerequisites

These instructions are for those running 1.8

Upgrade

Optional: cleanup nix storage
This might free up several gigabytes of storage.
nix-collect-garbage

Upgrade Omnia and Dependencies to version 1.10.0

nix-env --set-flag priority 1 python3.8-stark-cli-0.0.0

nix-env --install --verbose --file https://github.com/chronicleprotocol/oracles/tarball/stable

Configure Gofer, Spire, Scuttlebot and Omniainstall-omnia feed --ssb-caps ~/caps.json --ssb-external <your external ip here> --eth-rpc <https://node1[:port]/path> --eth-rpc <https://node2[:port]/path> --eth-rpc <https://node3[:port]/path>

Restart services

sudo systemctl daemon-reload
sudo systemctl restart splitter-agent.service
sudo systemctl restart gofer-agent
sudo systemctl restart spire-agent
sudo systemctl restart ssb-server
sudo systemctl restart omnia

note: restarting spire-agent can take a few minutes

Final steps

Check that gofer is functionnal

gofer -c /etc/gofer.conf  prices WSTETH/USD --format=trace

note: if you get the error not enough sources to calculate median, wait two minutes and try again

Check Status of Omnia and Scuttlebot

sudo systemctl status ssb-server
sudo systemctl status omnia
sudo systemctl status gofer-agent
sudo systemctl status spire-agent

Recommended: cleanup temporary ssb files
Your /tmp directory may contain hundreds of thousands of uncessary files that may be safely removed
find /tmp -name "multiserver*" -delete

Notify

Let @marcandu on Keybase know that you completed the upgrade, so they can confirm that your feed is properly broadcasting messages on both Spire and Scuttlebot.