mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-27 23:25:51 +00:00
Migrate content syntax via script
The changes in this commit were auto-generated by running tool/migrate.sh Following this commit, the Dactyl build no longer works but the Redocly build (mostly) should.
This commit is contained in:
mDuo13
@@ -7,9 +7,9 @@ labels:
|
||||
---
|
||||
# rippled Server Doesn't Sync
|
||||
|
||||
This page explains possible reasons [a `rippled` server](xrpl-servers.html) may start successfully, but get stuck in a ["connected" state](rippled-server-states.html) without ever fully connecting to the network. (If the server crashes during or shortly after startup, see [Server Won't Start](server-wont-start.html) instead.)
|
||||
This page explains possible reasons [a `rippled` server](../../concepts/networks-and-servers/index.md) may start successfully, but get stuck in a ["connected" state](../../references/http-websocket-apis/api-conventions/rippled-server-states.md) without ever fully connecting to the network. (If the server crashes during or shortly after startup, see [Server Won't Start](server-wont-start.md) instead.)
|
||||
|
||||
These instructions assume you have [installed `rippled`](install-rippled.html) on a supported platform.
|
||||
These instructions assume you have [installed `rippled`](../installation/index.md) on a supported platform.
|
||||
|
||||
|
||||
## Normal Syncing Behavior
|
||||
@@ -17,7 +17,7 @@ These instructions assume you have [installed `rippled`](install-rippled.html) o
|
||||
Syncing with the network normally takes about 5 to 15 minutes. During that time, the server does several things:
|
||||
|
||||
- Loads a recommended validator list (for example, from `vl.ripple.com`) to determine which validators it trusts.
|
||||
- [Discovers peer servers](peer-protocol.html#peer-discovery) and connects to them.
|
||||
- [Discovers peer servers](../../concepts/networks-and-servers/peer-protocol.md#peer-discovery) and connects to them.
|
||||
- Listens to its trusted validators to find which ledger hashes have been recently validated.
|
||||
- Downloads the full latest ledger from its peers, and uses that to build its internal database of ledger data.
|
||||
- Collects newly-broadcast transactions and attempts to apply them to its in-progress ledger.
|
||||
@@ -29,14 +29,14 @@ If the server is unable to keep up with the network while doing these tasks, the
|
||||
|
||||
Many syncing issues can be resolved by restarting the server. No matter why it didn't sync the first time, it may succeed on the second try.
|
||||
|
||||
If the [server_info method][] shows a [`server_state`](rippled-server-states.html) other than `proposing` or `full` and a `server_state_duration_us` of more than `900000000` (15 minutes in microseconds), then you should shut down the `rippled` service, wait a few seconds, and start it again. Optionally, restart the entire machine.
|
||||
If the [server_info method][] shows a [`server_state`](../../references/http-websocket-apis/api-conventions/rippled-server-states.md) other than `proposing` or `full` and a `server_state_duration_us` of more than `900000000` (15 minutes in microseconds), then you should shut down the `rippled` service, wait a few seconds, and start it again. Optionally, restart the entire machine.
|
||||
|
||||
If the problem persists, check the other possibilities listed on this page. If none of them seem to apply, [open an issue in the `rippled` repository](https://github.com/XRPLF/rippled/issues) and add the "Syncing issue" label.
|
||||
|
||||
|
||||
## Usual Causes of Syncing Issues
|
||||
|
||||
The most common cause of syncing issues is not meeting the [system requirements](system-requirements.html). The three most common shortfalls are:
|
||||
The most common cause of syncing issues is not meeting the [system requirements](../installation/system-requirements.md). The three most common shortfalls are:
|
||||
|
||||
- **Slow disks.** You need a consistently fast solid state disk (SSD). Cloud providers like AWS usually don't guarantee disk performance, because it depends on hardware shared with other customers.
|
||||
- **Insufficient RAM.** The memory requirements vary depending on several factors including ones that are hard to predict like network load and how people use the XRP Ledger, so it's good to have more than the minimum system requirements.
|
||||
@@ -47,7 +47,7 @@ If you are having trouble remaining synced, double-check that your server meets
|
||||
|
||||
## Couldn't Load Validator List
|
||||
|
||||
The default configuration uses a recommended list of validators retrieved from `vl.ripple.com`. This list is signed by Ripple's cryptographic key pair and has a built-in expiration date. If your server cannot download the list from `vl.ripple.com` for some reason, your server does not choose a set of trusted validators and cannot determine which possible ledgers to declare as valid. (If you are connected to [the testnet or another parallel network](parallel-networks.html), your server uses a list of trusted validators for that network instead.)
|
||||
The default configuration uses a recommended list of validators retrieved from `vl.ripple.com`. This list is signed by Ripple's cryptographic key pair and has a built-in expiration date. If your server cannot download the list from `vl.ripple.com` for some reason, your server does not choose a set of trusted validators and cannot determine which possible ledgers to declare as valid. (If you are connected to [the testnet or another parallel network](../../concepts/networks-and-servers/parallel-networks.md), your server uses a list of trusted validators for that network instead.)
|
||||
|
||||
The `validator_list` block in the [server_info method][] response shows the status of your validator list including its expiration date. If you have a list, but it's expired, it's possible that your server had connectivity to the validator list site before but hasn't been able to connect lately, so your current list expired while your server was unable to download a more updated list.
|
||||
|
||||
@@ -58,9 +58,9 @@ You can also use the [validator_list_sites method][] to get more detailed inform
|
||||
|
||||
## Not Enough Peers
|
||||
|
||||
If your server does not connect to enough [peer servers](peer-protocol.html), it may not be able to download enough data to remain synced with the network as the network continues processing new transactions. This can happen if your network connection is unreliable, or if you configure your server as a [private server](peer-protocol.html#private-peers) without adding enough reliable fixed peers.
|
||||
If your server does not connect to enough [peer servers](../../concepts/networks-and-servers/peer-protocol.md), it may not be able to download enough data to remain synced with the network as the network continues processing new transactions. This can happen if your network connection is unreliable, or if you configure your server as a [private server](../../concepts/networks-and-servers/peer-protocol.md#private-peers) without adding enough reliable fixed peers.
|
||||
|
||||
Use the [peers method][] to get information about your server's current peers. If you have exactly 10 or 11 peers, that may indicate that your firewall is blocking incoming peer connections. [Set up port forwarding](forward-ports-for-peering.html) to allow more incoming connections. If your server is configured as a private server, double-check the contents and syntax of the `[ips_fixed]` stanza in your config file, and add more proxies or public hubs if possible.
|
||||
Use the [peers method][] to get information about your server's current peers. If you have exactly 10 or 11 peers, that may indicate that your firewall is blocking incoming peer connections. [Set up port forwarding](../configuration/peering/forward-ports-for-peering.md) to allow more incoming connections. If your server is configured as a private server, double-check the contents and syntax of the `[ips_fixed]` stanza in your config file, and add more proxies or public hubs if possible.
|
||||
|
||||
|
||||
## Corrupt Databases
|
||||
@@ -69,31 +69,39 @@ In rare cases, corrupt data saved in your `rippled` server's internal databases
|
||||
|
||||
As a test, you can temporarily change the paths to your server's databases as long as you have enough free space to re-download the current ledger and store other settings.
|
||||
|
||||
**Note:** When you change the database paths, the server does not load some saved settings, such as the server's current [node key pair][] and [peer reservations](peer-protocol.html#fixed-peers-and-peer-reservations). If changing the database paths fixes your server' syncing problems, you may want to re-create some of these settings.
|
||||
**Note:** When you change the database paths, the server does not load some saved settings, such as the server's current [node key pair][] and [peer reservations](../../concepts/networks-and-servers/peer-protocol.md#fixed-peers-and-peer-reservations). If changing the database paths fixes your server' syncing problems, you may want to re-create some of these settings.
|
||||
|
||||
1. Stop the `rippled` server if it is running.
|
||||
|
||||
$ sudo systemctl stop rippled
|
||||
```
|
||||
$ sudo systemctl stop rippled
|
||||
```
|
||||
|
||||
2. Create new empty folders to hold the fresh databases.
|
||||
|
||||
$ mkdir /var/lib/rippled/db_new/
|
||||
$ mkdir /var/lib/rippled/db_new/nudb
|
||||
```
|
||||
$ mkdir /var/lib/rippled/db_new/
|
||||
$ mkdir /var/lib/rippled/db_new/nudb
|
||||
```
|
||||
|
||||
3. Edit the config file to use the new paths. Be sure to change the `path` field of the `[node_db]` stanza **and** the value of the `[database_path]` stanza.
|
||||
|
||||
[node_db]
|
||||
type=NuDB
|
||||
path=/var/lib/rippled/db_new/nudb
|
||||
```
|
||||
[node_db]
|
||||
type=NuDB
|
||||
path=/var/lib/rippled/db_new/nudb
|
||||
|
||||
[database_path]
|
||||
/var/lib/rippled/db_new
|
||||
[database_path]
|
||||
/var/lib/rippled/db_new
|
||||
```
|
||||
|
||||
{% include '_snippets/conf-file-location.md' %}<!--_ -->
|
||||
{% partial file="/_snippets/conf-file-location.md" /%}
|
||||
|
||||
4. Start the `rippled` server again.
|
||||
|
||||
$ sudo systemctl start rippled
|
||||
```
|
||||
$ sudo systemctl start rippled
|
||||
```
|
||||
|
||||
If the server successfully syncs using the fresh databases, you can delete the folders that hold the old databases. You may also want to check for hardware failures, especially to your disk and RAM.
|
||||
|
||||
@@ -101,20 +109,18 @@ As a test, you can temporarily change the paths to your server's databases as lo
|
||||
## See Also
|
||||
|
||||
- **Concepts:**
|
||||
- [The `rippled` Server](xrpl-servers.html)
|
||||
- [Peer Protocol](peer-protocol.html)
|
||||
- [Technical FAQ](technical-faq.html)
|
||||
- [The `rippled` Server](../../concepts/networks-and-servers/index.md)
|
||||
- [Peer Protocol](../../concepts/networks-and-servers/peer-protocol.md)
|
||||
- [Technical FAQ](../../faq.md)
|
||||
- **Tutorials:**
|
||||
- [Understanding Log Messages](understanding-log-messages.html)
|
||||
- [Capacity Planning](capacity-planning.html)
|
||||
- [Understanding Log Messages](understanding-log-messages.md)
|
||||
- [Capacity Planning](../installation/capacity-planning.md)
|
||||
- **References:**
|
||||
- [rippled API Reference](http-websocket-apis.html)
|
||||
- [rippled API Reference](../../references/http-websocket-apis/index.md)
|
||||
- [peers method][]
|
||||
- [server_info method][]
|
||||
- [validator_list_sites method][]
|
||||
|
||||
<!-- SPELLING_IGNORE: aws -->
|
||||
<!--{# common link defs #}-->
|
||||
{% include '_snippets/rippled-api-links.md' %}
|
||||
{% include '_snippets/tx-type-links.md' %}
|
||||
{% include '_snippets/rippled_versions.md' %}
|
||||
|
||||
{% raw-partial file="/_snippets/common-links.md" /%}
|
||||
|
||||
Reference in New Issue
Block a user