Skip to content

Conversation

@thisisjoshford
Copy link
Collaborator

@thisisjoshford thisisjoshford commented Sep 16, 2020

  • added @SkidanovAlex's guide to running a node w/o nearup
  • clarified node types & roles (non-block producing (regular) vs. block producing (validator))
  • added more links for further reference
  • renamed running-testnet.md to running-a-node.md to reflect its actual content
  • updated various links to point to running-a-node.md
  • created nodes.md under /docs/concepts and moved information about nodes into it from running-a-node.md
  • added more detailed information explaining nodes and their behavior / roles in nodes.md

fixes near/node-docs#8

@render
Copy link

render bot commented Sep 16, 2020


You may decide to run a node of your own for a few reasons:

- To view, process, and validate transactions on `MainNet`, `TestNet` or `BetaNet` (†)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think some reasons for running a regular node include:

  1. serve rpc for your own use cases. This includes transaction submission, queries, view calls etc.
  2. to index data from the network (running indexer on top of it for example)

<blockquote class="warning">
<strong>Note</strong><br><br>

Non-block producing nodes still validate every block and are very important to the network. This network of nodes, that view all transactions taking place, help us to be certain that the chain is correct and no invalid state transitions / forks are occurring.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Before we have challenges, non block producing nodes cannot really prevent invalid state transition from happening. Even with challenges you have to become a fisherman to challenge.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I should clarify that this is referring to raising alarms within the community, not actually preventing realtime issues.

_( † ) `TestNet` is intended to operate as closely (similarly) to `MainNet` as possible with only stable releases while `BetaNet` follows a weekly release cycle._
4) Run the following command replacing the paths & networkId:
```bash
neard --home=<absolute_path_to_the_desired_location> init --chain-id=<networkId> --genesis=<absolute_path_to_the_downloaded_genesis_file>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

--genesis argument only applies to betanet and testnet. For mainnet, genesis is built into the binary

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR was to add running a node without using nearup to this document. Existing instructions on running nearup were not checked for accuracy. Thank you for the update.

```bash
nearup betanet --nodocker --binary-path path/to/nearcore/target/release
nearup betanet --nodocker --binary-path <path_to_nearcore_target_release>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is outdated. The new version of nearup doesn't have an option to run docker inside. You can run the entire nearup from docker. https://github.com/near/nearup/tree/nearup_v2

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above... existing instructions on nearup were not checked for accuracy. I will carve out some time to run through them and update.


```text
Enter your account ID (leave empty if not going to be a validator):
Enter your account ID: (leave empty if not going to be a validator)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this doesn't exists any more, you have to pass the flag --account-id



### Block producing node ("validator node")
### Producing node ("validator node")
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why? Producing node makes no sense

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was discussed in a thread on slack. @SkidanovAlex was concerned that calling a node "block producing" would be incorrect in the future when chunk producing begins. Do you have a suggestion?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No but let's not call them "producing node". For now block producing node is fine

@thisisjoshford
Copy link
Collaborator Author

closed this stale PR as #739 was recently merged covering this topic.

@thisisjoshford thisisjoshford deleted the content.new--running-nodes-w/o-nearup branch September 16, 2021 15:01
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

Successfully merging this pull request may close these issues.

[DOC] Document how to run a node without nearup

5 participants