You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/pos/how-to/full-node/full-node-ansible.md
+6-30Lines changed: 6 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,36 +2,18 @@
2
2
comments: true
3
3
---
4
4
5
-
An [Ansible playbook](https://docs.ansible.com/ansible/latest/user_guide/playbooks_intro.html)is used to configure and manage a full node.
5
+
An [Ansible playbook](https://docs.ansible.com/ansible/latest/user_guide/playbooks_intro.html)can be used to configure and manage a full node.
6
6
7
7
## Prerequisites
8
8
9
9
- Install Ansible on your local machine with Python3.x. The setup doesn't run on Python 2.x.
10
10
- To install Ansible with Python 3.x, you can use pip. If you do not have pip on your machine,
11
11
follow the steps outlined [here](https://pip.pypa.io/en/stable/). Run `pip3 install ansible` to install
12
12
Ansible.
13
-
- Check the [Polygon PoS Ansible repository](https://github.com/maticnetwork/node-ansible#requirements) for
14
-
requirements.
13
+
- Check the [Polygon PoS Ansible repository](https://github.com/maticnetwork/node-ansible#requirements) for requirements.
15
14
- You also need to ensure that Go is *not installed* in your environment. You will run into issues if you attempt to set up your full node through Ansible with Go installed as Ansible requires specific packages of Go.
16
15
- You will also need to make sure that your VM / Machine does not have any previous setups for Polygon Validator or Heimdall or Bor. You will need to delete them as your setup will run into issues.
17
16
18
-
!!! info "Heimdall source enhancements"
19
-
20
-
The latest Heimdall version, **[v1.0.3](https://github.com/maticnetwork/heimdall/releases/tag/v1.0.3)**, contains a few enhancements.
21
-
The delay time between the contract events of different validators **has been increased** to ensure that the mempool doesn't get filled quickly in case of a burst of events that could hamper the chain's progress.
22
-
23
-
Additionally, the data size **has been restricted in state sync txs to 30Kb (when represented in bytes) and 60Kb (when defined as string)**.
24
-
25
-
For example:
26
-
27
-
```bash
28
-
Data - "abcd1234"
29
-
Length in string format - 8
30
-
Hex Byte representation - [171 205 18 52]
31
-
Length in byte format - 4
32
-
```
33
-
34
-
35
17
## Full node setup
36
18
37
19
- Ensure you have access to the remote machine or VM on which the full node is being set up.
@@ -97,10 +79,10 @@ An [Ansible playbook](https://docs.ansible.com/ansible/latest/user_guide/playboo
97
79
- On the remote machine/VM, run `curl localhost:26657/status`
98
80
- In the output, `catching_up` value should be `false`
99
81
100
-
- Once Heimdall is synced, run
82
+
- Once Heimdall is synced, run:
101
83
- `sudo service bor start`
102
84
103
-
You have successfully set up a full node with Ansible.
85
+
If you've reached this point, you have successfully set up a full node with Ansible.
104
86
105
87
!!! note
106
88
@@ -120,14 +102,8 @@ Logs can be managed by the `journalctl` linux tool. Here is a tutorial for advan
120
102
journalctl -u heimdalld.service -f
121
103
```
122
104
123
-
### Check Bor REST-server logs
105
+
### Check Bor node logs
124
106
125
107
```bash
126
108
journalctl -u bor.service -f
127
-
```
128
-
129
-
## Ports and firewall setup
130
-
131
-
Open ports `22`, `26656` and `30303` to world (0.0.0.0/0) on sentry node firewall.
132
-
133
-
You can use VPN to restrict access for port 22 as per your requirement and security guidelines.
Copy file name to clipboardExpand all lines: docs/pos/how-to/full-node/full-node-binaries.md
+10-37Lines changed: 10 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
comments: true
3
3
---
4
4
5
-
This deployment guide walks you through starting and running a full node through various methods. For the system requirements, see the [minimum technical requirements](../validator/validator-system-requirements.md) guide.
5
+
This deployment guide walks you through starting and running a full node through various methods. For the system requirements, see the [minimum technical requirements](../prerequisites.md) guide.
6
6
7
7
!!! tip "Snapshots"
8
8
@@ -17,7 +17,7 @@ This deployment guide walks you through starting and running a full node through
17
17
18
18
!!! warning
19
19
20
-
It's crucial to follow the outlined sequence of actions precisely; deviating from it may result in encountering issues.
20
+
It is essential to follow the outlined sequence of actions precisely, as any deviation may lead to potential issues.
21
21
22
22
- Prepare the machine.
23
23
- Install Heimdall and Bor binaries on the full node machine.
@@ -29,7 +29,7 @@ This deployment guide walks you through starting and running a full node through
29
29
30
30
### Install `build-essential`
31
31
32
-
This is **required** for your full node. In order to install, run the below command:
32
+
This is *required* for your full node. In order to install, run the below command:
33
33
34
34
```bash
35
35
sudo apt-get update
@@ -44,22 +44,7 @@ Both binaries must be installed and run in the correct order to function properl
44
44
45
45
### Heimdall
46
46
47
-
Install the latest version of Heimdall and related services. Make sure you checkout to the correct [release version](https://github.com/maticnetwork/heimdall/releases). Note that the latest version, [Heimdall v1.0.5](https://github.com/maticnetwork/heimdall/releases/tag/v1.0.5), contains enhancements such as:
48
-
49
-
1. Restricting data size in state sync txs to:
50
-
**30Kb* when represented in `bytes`
51
-
**60Kb* when represented as `string`
52
-
53
-
2. Increasing the `delay time` between the contract events of different validators to ensure that the mempool doesn't get filled very quickly in case of a burst of events which can hamper the progress of the chain.
54
-
55
-
The following example shows how the data size is restricted:
56
-
57
-
```
58
-
Data - "abcd1234"
59
-
Length in string format - 8
60
-
Hex Byte representation - [171 205 18 52]
61
-
Length in byte format - 4
62
-
```
47
+
Install the latest version of Heimdall and related services. Make sure you checkout to the correct [release version](https://github.com/maticnetwork/heimdall/releases).
63
48
64
49
To install *Heimdall*, run the following commands:
65
50
@@ -73,7 +58,7 @@ You can run the above command with following options:
73
58
-`network_type`: `mainnet` and `amoy`
74
59
-`node_type`: `sentry`
75
60
76
-
That will install the `heimdalld` and `heimdallcli` binaries. Verify the installation by checking the Heimdall version on your machine:
61
+
This will install the `heimdalld` and `heimdallcli` binaries. Verify the installation by checking the Heimdall version on your machine:
0 commit comments