# 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 Omnia**`install-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.