Updating tBTC v2 Node

Update procedure for the tBTC v2 client depends on installation method

Docker Installation

The following instructions assume your docker install followed these installation instructions.

These steps are specific to the Client: v2.0.0-m2 (Mainnet) release and may change.

The latest release is available on GitHub.

Systemd Service

Open the systemd service file created during the initial install.

~/etc/systemd/system/

The install instructions named the service tbtcv2.service. Locate your service file and open it in your prefered editor. For simplicity we use nano here. You may need sudo.

sudo nano tbtcv2.service

The service should look like this:

[Unit]
Description=tBTC v2 client
After=network.target
Wants=network.target

[Service]
Environment="ETHEREUM_WS_URL=<Ethereum API WS URL>"
Environment="OPERATOR_KEY_FILE_NAME=<Operator Account keyfile name>"
Environment="OPERATOR_KEY_FILE_PASSWORD=<Operator Account keyfile password>"
Environment="PUBLIC_IP=/dns4/<PUBLIC_IP_OF_MACHINE>/tcp/3919"
Environment="CONFIG_DIR=/home/<user name>/keep/config"
Environment="STORAGE_DIR=/home/<user name>/keep/storage"

# These items only apply if you setup rootless-mode.
# Do not enable unless using rootless mode. Don't forget to adjust user UID.
#Environment="XDG_RUNTIME_DIR=/run/<user name>/<user UID>/"
#Environment="DOCKER_HOST=unix:///run/<user name>/<user UID>/docker.sock"

Type=simple
WorkingDirectory=/home/<user>

ExecStart=/usr/bin/docker run \
    --volume ${CONFIG_DIR}:/mnt/keep/config \
    --volume ${STORAGE_DIR}:/mnt/keep/storage \
    --env KEEP_ETHEREUM_PASSWORD=${OPERATOR_KEY_FILE_PASSWORD} \
    --env LOG_LEVEL=info \
    --log-opt max-size=100m \
    --log-opt max-file=3 \
    -p 3919:3919 \
    -p 9601:9601 \
    keepnetwork/keep-client:latest \
    start \
    --ethereum.url ${ETHEREUM_WS_URL} \
    --ethereum.keyFile /mnt/keep/config/${OPERATOR_KEY_FILE_NAME} \
    --storage.dir /mnt/keep/storage \
    --network.announcedAddresses $PUBLIC_IP

Restart=always
RestartSec=15s

[Install]
WantedBy=default.target

Locate the following line:

keepnetwork/keep-client:latest \

Make the following change to this line only:

keepnetwork/keep-client:v2.0.0-m2 \

Save and exit the service file.

Reload the daemon and restart the service:

 sudo systemctl daemon-reload
 sudo systemctl restart tbtcv2

Verify your client updated by visiting your status page:

http://111.222.333.444:9601/metrics

Look for :

client_info{version="v2.0.0-m2"}

Docker Container

Binary Install