Joystream / substrate-node-joystream

Joystream Full Node
https://www.joystream.org
GNU General Public License v3.0
15 stars 16 forks source link

WIP: KB for Joystream Node Athens Release #71

Closed sqyuid closed 4 years ago

sqyuid commented 5 years ago
Document scope/objectives: - This document currently deals with running a Joystream Node on the Athens testnet (either as a regular node or as a validator role) - This document does not currently extend to dealing with UI issues (such as staking/bonding). It may do so at a later stage. - This document does not extend to running storage or other nodes; should those nodes have similar documents they will be linked here. - This document currently deals with pre-compiled binaries and doesn’t include information pertaining to compiling software. - Transfer knowledge from various sources to a common place - Improve & contribute to search engine readability of the project - Provide limited technical information on how and why some errors occur - Allow users to be more self-sufficient and help to reduce the time required to help users with common technical issues. ### Revisions: - As newer versions of Joystream are released, some errors/solutions may no longer be useful and will be excluded from this document in the future. A subsection will be created for this eventually so that non-relevant knowledge is still available for users of other projects.
Some useful questions to answer before troubleshooting any issues: - **Are you running your node on a domestic/home internet connection or from a data center/VPS server?** Home internet connections, in general, have lower peer connectivity. It is highly recommended that if operating a node at home that you use a reliable ethernet connection and avoid things like WiFi. Some domestic internet providers also block, or throttle certain internet traffic, and this may cause connectivity issues. - **Is your node behind a firewall (such as on your computer, firewall, ISP, datacenter)?** Firewalls if not configured appropriately may cause connectivity issues. You may find that adjusting your firewall settings can help to improve your node’s health. Changing firewall settings should only be done if you're confident with you - **How long have you left the node running?** Joystream’s node utilizes technology that helps it to “discover” other nodes. It can take some time (5-30 minutes) for this process to fully happen. If you’re having issues connecting to other nodes, slow sync speed or other issues, try to leave the node running for a while before changing settings.

Current issues & solutions:

Common error messages & explanations:

Rare error messages & solutions:

bwhm commented 5 years ago

Hey @sjsqd .

This is much appreciated help! Please open an issue in the helpdesk repo, and refer to this!

mnaamani commented 4 years ago

We will be deprecating this repo soon, so any valuable knowledge from this issue as recommended in https://github.com/Joystream/helpdesk/issues/26 should be moved into the helpdesk trouble shooting section