Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

suggestions for improving the "Running A Full Node" on bitcoin.org/en/full-node #4247

Open
arb2065694 opened this issue Jul 13, 2024 · 0 comments

Comments

@arb2065694
Copy link

Dear correspondant,
As a retired IT trainer, I have always been concerned by the quality of documentation particularly when it is about describing How To Do something.
The bitcoin.org page called "Running a Full Node" is very good, but the dead-end where I am now is the direct consequence of missing infos on this page. My node is stopped node till I clear the situation.

First, this page should be printable or downloaded in pdf format...

For each step of installing the BTC node, we could have 3 parts :
-a general short sentence, what we are going to do
-the commands required for attaining this
-the consequences of these actions (files, directories...)

The two commands below should be updated with the new bitcoin-27.1 version
-tar xzf bitcoin-27.0-x86_64-linux-gnu.tar.gz
-sudo install -m 0755 -o root -g root -t /usr/local/bin bitcoin-27.0/bin/*

The consequences of the 'install' command is the creation in /usr/local/bin of the 7 following files :
-bitcoin-cli, bitcoind, bitcoin-qt, bitcoin-tx, bitcoin-util, bitcoin-wallet, test_bitcoin
A short word about each of these files would be apreciated.

Then I was ready for IBD.
« You will be prompted to choose a directory to store the Bitcoin block and your wallet. Unless you have a separate partition or drive you want to use click OK to use the default »
As I have added a new 2To SSD, I choose the second option by giving the name of the SSD.
You could separate the two cases :
-if you choose the default directory (name) this will create the following files in the default directory…
-if you choose the second choice (an example) this will create the following files in the custom directory...
[The 8 CPU and 16Gb RAM of the ACER Predator + Fedora39+ISP... completed the download of the blockchain in roughly 2 days. ]

You could add the screenshot which show the downloading of the blockchain is completed. Then warn the user that he should create a wallet (empty/not empty).
Everything looks fine, but to be sure, please mention the command to check the incoming connections : $ bitcoin-cli getconnectioncount

I mentioned a dead-end above which impelled me to stop the node. I’ll write a separate anomaly report about it but what happened ? Upon launching the GUI
it is always the same initial screen (default directory/custom directory) as if the program didn’t know the whole blockchain was already there.
Then I had a warning telling /home was almost full !!
The responsible for this is a hidden directory ‘.bitcoin’ in /home/user/. It reached 580 Gb in 2 days !!
This ‘.bitcoin’ directory holds 11 directories/files among which : anchors, banlist, blocks, chainstate...mempool
Nowhere in the documentation this constantly growing ‘.bitcoin’ directory is mentioned.

The last part with reducing storage, reducing trafic is not clear to me. Where do all these parameters apply ?
As a newbie i am not sure whether or not this is the right place for these suggestions,
kind regards,
armel near Lyon France

@arb2065694 arb2065694 changed the title suggestions for improving the "Running A Full Node" on bitcoincore.org suggestions for improving the "Running A Full Node" on bitcoin.org Jul 13, 2024
@arb2065694 arb2065694 changed the title suggestions for improving the "Running A Full Node" on bitcoin.org suggestions for improving the "Running A Full Node" on bitcoin.org/en/full-node Jul 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant