Skip to content

Commit e937403

Browse files
committed
extend README.md
1 parent b1a2d66 commit e937403

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,23 @@ version = "1.18.10"
8989
In this case, **remove the entire block** related to the outdated version.
9090

9191

92+
## Extra entry found: `._genesis.bin`
93+
You can get error while running `solana-test-validator` on `macOS`:
94+
```
95+
failed to start validator: Failed to create ledger at test-ledger: io error: Error checking to unpack genesis archive: Archive error: extra entry found: "._genesis.bin" Regular/failed to stash problematic rocksdb: Directory not empty (os error 66)
96+
```
97+
To resolve this issue, you need to install `gnu-tar` and update your `PATH` environment variable if you plan to run `solana-test-validator` locally. Follow these steps:
98+
```shell
99+
brew install gnu-tar
100+
# Put this in ~/.zshrc
101+
export PATH="/opt/homebrew/opt/gnu-tar/libexec/gnubin:$PATH"
102+
```
103+
104+
In our testing environment, we have implemented a mechanism to prevent this failure by automatically exporting the `gnu-tar` path within the code.
105+
Therefore, if you are running `solana-test-validator` only in tests, you just need to install `gnu-tar`.
106+
107+
You can find more info here: https://solana.stackexchange.com/questions/4499/blockstore-error-when-starting-solana-test-validator-on-macos-13-0-1/4761#4761
108+
92109

93110
# Run JSON RPC Server
94111
From root directory:

0 commit comments

Comments
 (0)