---
# System prepended metadata

title: Oracles v1.8 Relayer Upgrade Guide

---

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

**Important:**
* Starting with this release, all transactions are of type 2 (EIP-1559). 
* OpenEthereum support is deprecated

# Prerequisites

If you use custom `pairs` settings in `/etc/omnia.conf`, i.e. `oracleExpiration` and `oracleSpread`, backup your file to be able to restore these settings later.

# Upgrade (Relayer Only)


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


**Configure Spire, Scuttlebot and Omnia**
```
install-omnia relayer --ssb-caps ~/caps.json --ssb-external <your external ip here>
```

**Restore custom settings**
Restore any custom setting in `/etc/omnia.conf`, taking care of keeping the new pairs and parameters.

**Restart services** 
```
sudo systemctl daemon-reload
sudo systemctl restart spire-agent
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 WSTETHUSD 0xDA1d2961Da837891f43235FddF66BAD26f41368b
```
_note: if you get the error not enough sources to calculate median, wait two minutes and try again_

# Final steps
**Check Status of Omnia and Scuttlebot**
```
sudo systemctl status ssb-server
sudo systemctl status omnia
sudo systemctl status spire-agent
```

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

**Optional: Adjust EIP-1559 gas parameters**
New parameters in `/etc/omnia.conf`:
* `maxPriceMultiplier`: the estimated maximum gas price is multiplied by this factor
* `tipMultiplier`: the maximum estimated priority fee is multiplied by this factor
* `source`: source for the maximum gas price and priority fee estimate:
   * `node`: obtain the price from the node via rpc
   * `ethgasstation`: query the EthGasStation API. This API uses legacy estimates and might have unexpected results. **not recommended**


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

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