monero/src/blockchain_utilities
Riccardo Spagni 02e5dcd2fa
Merge pull request #2384
4e0e4e99 blockchain_import: warn for chunks over 500000, not 100000 (moneromooo-monero)
5b29e87f blockchain_import: properly cleanup core/db on exit (moneromooo-monero)
e167c4d9 blockchain_import: do not error out on truncated files (moneromooo-monero)
2017-09-02 11:32:46 +02:00
..
blockchain_export.cpp More DB support cleanup 2017-08-20 13:57:36 +01:00
blockchain_import.cpp Merge pull request #2384 2017-09-02 11:32:46 +02:00
blockchain_utilities.h blockchain_import: warn for chunks over 500000, not 100000 2017-09-01 22:48:33 +01:00
blocksdat_file.cpp update copyright year, fix occasional lack of newline at line end 2017-02-21 19:38:18 +02:00
blocksdat_file.h DB cleanup 2017-08-19 18:11:38 +01:00
bootstrap_file.cpp blockchain_import: warn for chunks over 500000, not 100000 2017-09-01 22:48:33 +01:00
bootstrap_file.h update copyright year, fix occasional lack of newline at line end 2017-02-21 19:38:18 +02:00
bootstrap_serialization.h update copyright year, fix occasional lack of newline at line end 2017-02-21 19:38:18 +02:00
CMakeLists.txt Merge pull request #2248 2017-08-15 20:47:49 +02:00
README.md update copyright year, fix occasional lack of newline at line end 2017-02-21 19:38:18 +02:00

Monero Blockchain Utilities

Copyright (c) 2014-2017, The Monero Project

Introduction

The blockchain utilities allow one to import and export the blockchain.

Usage:

See also each utility's "--help" option.

Export an existing blockchain database

$ monero-blockchain-export

This loads the existing blockchain and exports it to $MONERO_DATA_DIR/export/blockchain.raw

Import the exported file

$ monero-blockchain-import

This imports blocks from $MONERO_DATA_DIR/export/blockchain.raw (exported using the monero-blockchain-export tool as described above) into the current database.

Defaults: --batch on, --batch size 20000, --verify on

Batch size refers to number of blocks and can be adjusted for performance based on available RAM.

Verification should only be turned off if importing from a trusted blockchain.

If you encounter an error like "resizing not supported in batch mode", you can just re-run the monero-blockchain-import command again, and it will restart from where it left off.

## use default settings to import blockchain.raw into database
$ monero-blockchain-import

## fast import with large batch size, database mode "fastest", verification off
$ monero-blockchain-import --batch-size 20000 --database lmdb#fastest --verify off

Import options

--input-file specifies input file path for importing

default: <data-dir>/export/blockchain.raw

--output-file specifies output file path to export to

default: <data-dir>/export/blockchain.raw

--block-stop stop at block number

--database <database type>

--database <database type>#<flag(s)>

database type: lmdb, memory

flags:

The flag after the # is interpreted as a composite mode/flag if there's only one (no comma separated arguments).

The composite mode represents multiple DB flags and support different database types:

safe, fast, fastest

Database-specific flags can be set instead.

LMDB flags (more than one may be specified):

nosync, nometasync, writemap, mapasync, nordahead

Examples:

$ monero-blockchain-import --database lmdb#fastest

$ monero-blockchain-import --database lmdb#nosync

$ monero-blockchain-import --database lmdb#nosync,nometasync