# Oracles v1.6 Relayer 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.*

# Upgrade (Relayer Only)

**Upgrade Omnia and Dependencies to version 1.6.1**
`nix-env --install --verbose --file https://github.com/makerdao/oracles-v2/tarball/v1.6.1`

**Configure Spire, Scuttlebot and Omnia**

install-omnia relayer --ssb-caps ~/caps.json --ssb-external <your external ip here>

**Manual Configuration for Spire**

*install-omnia will have copied the spire configuration file to /etc/spire.json*

This file configure the signing key for the libp2p message, which is the same as the signing key for price data. It also configure the list of pairs and feeds that your node will relay to other network participant. Pairs and feeds that are not listed are not relayed to mitigate spamming.

`sudo vim /etc/spire.json`

In `rpc`, set the `address` to `127.0.0.1` to an arbitrary port:

  "rpc": {
    "address": "127.0.0.1:31823"
  },

In `ethereum`, set the `from`, `keystore` and `password` exactly as in `/etc/omnia.conf`

  "ethereum": {
    "from": "<ethereum address for the feed>",
    "keystore": "<keystore location>",
    "password": "<password file>"
  },

By default, Spire selects a random port to listen for p2p connections. If there is a firewall, if you're doing port mapping, or you intend to act as a bootstrap node to others, add the property `listenAddrs` to select a static port. Make sure to perform the appropriate change on your infrastructure.

  "p2p": {
    "listenAddrs": ["/ip4/0.0.0.0/tcp/8000"],
    "bootstrapAddrs": [

**Set Spire as systemd services and schedule to run on system boot**

sudo systemctl daemon-reload
sudo systemctl enable spire-agent.service

Start the spire service for the first time

sudo systemctl start spire-agent

**Check spire logs**
`sudo journalctl --follow --unit spire-agent`
Confirm that the agent is running without errors

**Enable spire in omnia**
This will make omnia pushing price updates to spire in addition to ssb.

sudo vi /etc/omnia.conf

In `transports`, add `transport-spire`

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

Restart omnia to load the configuration

sudo systemctl restart ssb-server
sudo systemctl restart omnia

**[fyi] To stop Omnia and Scuttlebot from starting on system boot**

sudo systemctl disable --now ssb-server
sudo systemctl disable --now omnia
sudo systemctl disable --now spire-agent

**[fyi] To query spire and confirm that the agent works**

spire -c /etc/spire.json pull price ETHUSD 0xDA1d2961Da837891f43235FddF66BAD26f41368b

# Final steps
**Check Status of Omnia and Scuttlebot**

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

**Check Scuttlebot logs**
`sudo journalctl --follow --unit ssb-server`

**Check Omnia logs**
`sudo journalctl --follow --unit omnia`

Here, we want to make sure that omnia is getting messages from both Scuttlebot and Spire. E.g.:

Jul 15 16:34:27 oracle omnia[3087529]: [07/15/21 16:34:27] Polling feed: 0xFbaF3a7eB4Ec2962bd1847687E56aAEE855F5D00
Jul 15 16:34:27 oracle omnia[2583168]: [07/15/21 16:34:27] Pulling ETHUSD price message with transport-ssb
Jul 15 16:34:27 oracle omnia[2583168]: [07/15/21 16:34:27] Pulling ETHUSD price message with transport-spire
Jul 15 16:34:28 oracle omnia[3087529]: [07/15/21 16:34:28] Adding message from 0xFbaF3a7eB4Ec2962bd1847687E56aAEE855F5D00 to catalogue

**Check Spire logs**
`sudo journalctl --follow --unit spire-agent`
There shouldn't be any errors in the spire logs.

**Monitor**
Confirm that the relayer is pushing the prices to the medianizer