docs icon indicating copy to clipboard operation
docs copied to clipboard

Add troubleshouting page/FAQ for running nodes

Open MbBrainz opened this issue 3 years ago • 1 comments

Summary

There are multiple small issues one can run into when running a node, but there is no documentation on how to handle those issues. One issue where i ran into today is the "too many open files" error which kills the daemon. The solution appeared to be quite easy, namely increase the max open file limit, but it was hard to find.

this eventually helped me: https://github.com/axelarnetwork/axelarate-community/issues/257

Problem Definition

Troubleshooting node issues can be hard and is not well documented across the ecosystem.

Proposal

As Osmosis' docs are one of the most elaborate out there, it would be great to have a node troubleshooting page as part of the docs. Just make a single item, for example the max open file limit, and then add a link where people can suggest issues. Maybe some webscrapping would also help finding common issues.


MbBrainz avatar Oct 11 '22 10:10 MbBrainz

@niccoloraspa This is a good idea, we should start with a hackmd file and happy to push it here based on all the knowledge your team has gathered.

daniel-farina avatar Jul 03 '23 13:07 daniel-farina