Skip to content

Latest commit

 

History

History
217 lines (146 loc) · 5.68 KB

system-overview.md

File metadata and controls

217 lines (146 loc) · 5.68 KB
Raw
layout
title description tableOfContents outline pagination
visible
true
visible
visible
true
visible
true
visible
true

System Overview

To get a quick overview of the system status, you can use a shell script that gathers the most relevant data about the service on the main guide.

{% hint style="success" %} Difficulty: Easy {% endhint %}

Acknowledgments

This is a fork of the minibolt_info repository, the main developer of this project is rmnscb, a member of the MiniBolt community, all the merits go to him. Thank you for your contribution 🧡🫂

Installation

Install dependencies

  • With user admin, install the necessary dependencies using the apt package manager
sudo apt install jq net-tools netcat

Install

  • Go to the temporary folder
cd /tmp
  • Clone the GitHub repository and enter it

{% code overflow="wrap" %}

git clone https://github.com/minibolt-guide/system_overview && cd system_overview

{% endcode %}

{% hint style="info" %} You can inspect the scripts to make sure it does not do bad things, by going to the GitHub repository {% endhint %}

  • Install it to the system
sudo install -m 0755 -o root -g root -t /usr/local/bin *.sh

(Optional) Delete the folder of the temporary folder to be ready for the upgrade

sudo rm -r /tmp/system_overview

Run

  • Exec the script by typing the next command
minibolt.sh

{% hint style="info" %}

You should see a loading process, and if you have an admin user password set, the prompt should ask you for this. Enter the password [A] and enter

To avoid the prompt asking you to enter the user admin password before the script load, follow this section. ⚠️Taking into account that it carries a security risk ⚠️

✅ Finally, the terminal shows you something like the cover photo of this bonus guide 🎨 {% endhint %}

Extras (optional)

Show on login

Run the welcome script automatically every time you log in

  • With user admin, add minibolt.sh to the end of your .bashrc file
echo "minibolt.sh" >> ~/.bashrc

{% hint style="info" %} Now log in again as a user admin opening a new SSH session you can see the process of exec script before the prompt shows you.

To avoid the prompt asking you to enter the user admin password before the script load, follow this section. ⚠️Taking into account that it carries a security risk ⚠️

If you’re in a hurry, you can always press Ctrl-C to skip the script {% endhint %}

{% hint style="info" %} To uninstall the show on login feature, type the next command:

sed -i '/minibolt.sh/d' ~/.bashrc

Now log in again as a user admin opening a new SSH session to see that it doesn't appear anymore {% endhint %}

Get the channel.db size of an old LND bbolt database backend

  • With user admin, go to the temporary folder
cd /tmp
  • Clone the dedicated branch of the GitHub repository and enter it

{% code overflow="wrap" %}

git clone --branch LND_bboltdb https://github.com/minibolt-guide/system_overview && cd system_overview

{% endcode %}

  • Check out again the correct branch
git checkout LND_bboltdb

Expected output:

Already on 'LND_bboltdb'
Your branch is up to date with 'origin/LND_bboltdb'.
  • Install it to the system
sudo install -m 0755 -o root -g root -t /usr/local/bin *.sh

(Optional) Delete the folder of the temporary folder to be ready for the upgrade

sudo rm -r /tmp/system_overview

Use the MobaXterm compatibility version

MobaXterm is not compatible with special characters like "₿", by default. So we should replace it with the simple character "B".

  • With user admin, go to the temporary folder
cd /tmp
  • Clone the dedicated branch of the GitHub repository and enter it

{% code overflow="wrap" %}

git clone --branch LND_postgres_mobaX https://github.com/minibolt-guide/system_overview && cd system_overview

{% endcode %}

  • Check out again the correct branch
git checkout LND_postgres_mobaX

Expected output:

Already on 'LND_postgres_mobaX'
Your branch is up to date with 'origin/LND_postgres_mobaX'.
  • Install it to the system
sudo install -m 0755 -o root -g root -t /usr/local/bin *.sh

(Optional) Delete the folder of the temporary folder to be ready for the upgrade

sudo rm -r /tmp/system_overview

Upgrade

To upgrade, follow the complete Installation process and Run again

Uninstall

  • With user admin, type the next command to uninstall

{% code overflow="wrap" %}

sudo rm /usr/local/bin/minibolt.sh && sudo rm /usr/local/bin/get_LND_data.sh && sudo rm /usr/local/bin/get_CLN_data.sh

{% endcode %}