mirror of
https://github.com/hl-archive-node/nanoreth.git
synced 2025-12-06 19:09:54 +00:00
docs: add docker and error code 13 to troubleshooting chapter (#13133)
This commit is contained in:
@ -2,8 +2,40 @@
|
|||||||
|
|
||||||
This page tries to answer how to deal with the most popular issues.
|
This page tries to answer how to deal with the most popular issues.
|
||||||
|
|
||||||
|
- [Troubleshooting](#troubleshooting)
|
||||||
|
- [Database](#database)
|
||||||
|
- [Docker](#docker)
|
||||||
|
- [Error code 13](#error-code-13)
|
||||||
|
- [Slow database inserts and updates](#slow-database-inserts-and-updates)
|
||||||
|
- [Compact the database](#compact-the-database)
|
||||||
|
- [Re-sync from scratch](#re-sync-from-scratch)
|
||||||
|
- [Database write error](#database-write-error)
|
||||||
|
- [Concurrent database access error (using containers/Docker)](#concurrent-database-access-error-using-containersdocker)
|
||||||
|
- [Hardware Performance Testing](#hardware-performance-testing)
|
||||||
|
- [Disk Speed Testing with IOzone](#disk-speed-testing-with-iozone)
|
||||||
|
|
||||||
|
|
||||||
## Database
|
## Database
|
||||||
|
|
||||||
|
### Docker
|
||||||
|
|
||||||
|
Externally accessing a `datadir` inside a named docker volume will usually come with folder/file ownership/permissions issues.
|
||||||
|
|
||||||
|
**It is not recommended** to use the path to the named volume as it will trigger an error code 13. `RETH_DB_PATH: /var/lib/docker/volumes/named_volume/_data/eth/db cargo r --examples db-access --path ` is **DISCOURAGED** and a mounted volume with the right permissions should be used instead.
|
||||||
|
|
||||||
|
### Error code 13
|
||||||
|
|
||||||
|
`the environment opened in read-only code: 13`
|
||||||
|
|
||||||
|
Externally accessing a database in a read-only folder is not supported, **UNLESS** there's no `mdbx.lck` present, and it's called with `exclusive` on calling `open_db_read_only`. Meaning that there's no node syncing concurrently.
|
||||||
|
|
||||||
|
If the error persists, ensure that you have the right `rx` permissions on the `datadir` **and its parent** folders. Eg. the following command should succeed:
|
||||||
|
|
||||||
|
```bash,ignore
|
||||||
|
stat /full/path/datadir
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### Slow database inserts and updates
|
### Slow database inserts and updates
|
||||||
|
|
||||||
If you're:
|
If you're:
|
||||||
|
|||||||
Reference in New Issue
Block a user