Difference between revisions of "Upgrading Umbrel Node"

From PlebNet Wiki
Jump to navigation Jump to search
(Version 1)
 
(Version 1)
Line 1: Line 1:
== Intro ==
== Intro ==


Every once in a while you may have to upgrade your node. When a new upgrade is available, your umbrel dashboard will show a message.
Every once in a while you may have to upgrade your node. When a new upgrade is available, your umbrel dashboard will show a message like this.
 
[[File:Umbrell upgrade.jpg]]
 
However, before you rush in, it is better to be prepared for the upgrade so that you can recover from any surprises.
 
== Upgrade Check List ==
The following checklist can help you prepare for any unforeseen circumstances before you upgrade.
 
# Take a Static Channel Backup
# Copy the output of <code> bos peers </code> or your channel listings from [https://amboss.space/ amboss] so that you have a list of channels you have opened and local balances.
# Double check your 24-word seed for umbrel and any wallet passwords you have setup. Keep a safe backup.
# Make an upgrade area to safe keep some files. ssh to your node and
<code>
cd ~
mkdir upgrade
cd upgrade
</code>
# copy lnd.conf. Upgrade will overwrite it and you will need to re-do your customization again.
<code>
cp ~/umbrel/lnd/lnd.conf ~/upgrade/
</code>
# take a list of your watchtower peers so that you can add them again (if they are lost)
<code>
~/umbrel/bin/lncli wtclient towers | tee ~/upgrade/wtclienttowers.json
</code>
 
== updrade ==
Follow the instructions to upgrade
 
== post upgrade ==
# make a general healthchecks of your channels, nodes, balances.
# compare the lnd.conf in upgrade directory with ~/umbrel/lnd/lnd.conf and repeat your customisation again. If only changes are your own changes, you can also replace the file with the one you saved before the upgrade.
# restart lnd <code> cd ~/umbrel ; docker-compose restart lnd; docker-compose ps </code>
# compare your watch towers are still intact or else add them again. <code> ~/umbrel/bin/lncli wtclient towers </code>

Revision as of 09:53, 13 August 2021

Intro

Every once in a while you may have to upgrade your node. When a new upgrade is available, your umbrel dashboard will show a message like this.

Umbrell upgrade.jpg

However, before you rush in, it is better to be prepared for the upgrade so that you can recover from any surprises.

Upgrade Check List

The following checklist can help you prepare for any unforeseen circumstances before you upgrade.

  1. Take a Static Channel Backup
  2. Copy the output of bos peers or your channel listings from amboss so that you have a list of channels you have opened and local balances.
  3. Double check your 24-word seed for umbrel and any wallet passwords you have setup. Keep a safe backup.
  4. Make an upgrade area to safe keep some files. ssh to your node and

cd ~ mkdir upgrade cd upgrade

  1. copy lnd.conf. Upgrade will overwrite it and you will need to re-do your customization again.

cp ~/umbrel/lnd/lnd.conf ~/upgrade/

  1. take a list of your watchtower peers so that you can add them again (if they are lost)

~/umbrel/bin/lncli wtclient towers | tee ~/upgrade/wtclienttowers.json

updrade

Follow the instructions to upgrade

post upgrade

  1. make a general healthchecks of your channels, nodes, balances.
  2. compare the lnd.conf in upgrade directory with ~/umbrel/lnd/lnd.conf and repeat your customisation again. If only changes are your own changes, you can also replace the file with the one you saved before the upgrade.
  3. restart lnd cd ~/umbrel ; docker-compose restart lnd; docker-compose ps
  4. compare your watch towers are still intact or else add them again. ~/umbrel/bin/lncli wtclient towers