This procedure presumes you've already performed the One Time Setup
This procedure refers to the machine running the Core Lightning Node
and VLS proxies as the CLNHOST
. This procedure refers to the
machine running the VLS signer as the VLSHOST
. In development these
hosts may be the same.
Some of the build may be completed before stopping running daemons but generally the install steps require the executable files to not be in use.
Update git
cd ~/lightning-signer/vls-hsmd
git fetch --all --recurse-submodules --tags
A good default choice is main:
git checkout main
Instead, if you want to be on a specific branch:
git checkout the-branch
Instead, if you want to update the branch you are on:
git pull
Instead, if the branch you were on was force pushed:
git reset --hard origin/the-branch
Align the submodules (vls
and lightning
):
make setup
Build:
cd ~/lightning-signer/vls-hsmd && make build
If you are running the software you need to quiesce it.
On the CLNHOST
:
sudo systemctl stop cln-testnet
ps uaxgwww | grep cln
On the VLSHOST
[if you are running in SOCKET
mode]:
sudo systemctl stop vls-testnet
ps uaxgwww | grep vls
If your CLNHOST
and VLSHOST
are the same:
sudo systemctl stop cln-testnet vls-testnet
ps uaxgwww | egrep 'cln|vls'
If you are running the signer on an STM32 in SERIAL
mode no action
is required, the signer can be left idle.
cd ~/lightning-signer/vls-hsmd && sudo make install
Flash the STM32 Signer if you are running in SERIAL
mode.
Generally, you don't do anything. But if you did want to change/erase/revert something this is a good time to do it.
If you do want to alter CLN state on the CLNHOST
:
sudo -u cln bash -c 'cd ~/.lightning && exec bash'
# do stuff
exit
If you do want to alter VLS signer state on the VLSHOST
:
sudo -u vls bash -c 'cd ~/.lightning-signer && exec bash'
# do stuff
exit
If you are using a STM32 signer in SERIAL
mode you can hold the blue
button while resetting with the black button to enter setup mode. You
can also mount the sdcard in a development machine and view/alter the
state.
If you are running the signer on an STM32 press the black button to reset it. The signer will disply "waiting for node" when it is ready.
On the VLSHOST
[if you are running in SOCKET
mode]:
sudo systemctl start vls-testnet
On the CLNHOST
:
sudo systemctl start cln-testnet
If your CLNHOST
and VLSHOST
are the same:
sudo systemctl start cln-testnet vls-testnet
Individual status checks:
sudo systemctl status cln-testnet
sudo systemctl status vls-testnet
Quick summary status:
for svc in \
bitcoind-testnet \
txood-testnet \
cln-testnet \
vls-testnet \
; do SYSTEMD_COLORS=1 systemctl status $svc | head -n 3; done