# Oracles v1.11 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
- General changes
- [Data model updates](https://forum.makerdao.com/t/mip10c7-sp2-modify-data-models-for-btc-usd-link-usd-mana-usd-usdt-usd-yfi-usd-data-model/15235)
- [Update expiration time](https://forum.makerdao.com/t/mip10c19-sp1-update-oracle-expiration-time-for-all-oracles/15236)
- [setzer v0.5.1](https://github.com/chronicleprotocol/setzer/releases/tag/v0.5.1)
- [omnia v1.11.1](https://github.com/chronicleprotocol/omnia/releases/tag/v1.11.1)
- [oracle-suite v0.5.1](https://github.com/chronicleprotocol/oracle-suite/releases):
- Simple TWAP for onchain sources in Gofer
- Updates to Teleport functionnality (disabled by default, more on this in a later communication)
- Improved RPC handling

# Prerequisites

These instructions are for those running 1.10.x

# Upgrade

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

**Upgrade Omnia and Dependencies to version 1.11.3**

`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>`

*check `/etc/systemd/system/splitter-agent.service` for your current list of rpc nodes*

**Omnia config change**
If applicable, in file `/etc/omnia.conf`, change:

  "transports": [
    "transport-spire",
    "transport-ssb"
  ],

to

  "transports": [
    "spire",
    "ssb"
  ],

**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.