From b48d93b1d40705ca39c160117f4384784299a36d Mon Sep 17 00:00:00 2001 From: Juarez Rudsatz Date: Fri, 8 May 2020 04:17:03 -0300 Subject: [PATCH] prepare for pre-release 0.5.1 --- Cargo.toml | 2 +- README.md | 65 +++++++++++++++++++++++++++------------------------ changelog.txt | 8 +++++++ 3 files changed, 44 insertions(+), 31 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index f80a380..8dac827 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "solrcopy" -version = "0.5.0" +version = "0.5.1" edition = "2018" authors = ["Juarez Rudsatz "] diff --git a/README.md b/README.md index b64c40a..535bd90 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ Command line tool for backup and restore of documents stored in cores of [Apache ``` text $ solrcopy --help -solrcopy 0.5.0 +solrcopy 0.5.1 Command line tool for backup and restore of documents stored in cores of Apache Solr. Solrcopy is a command for doing backup and restore of documents stored on Solr cores. It let you filter docs by using a @@ -55,7 +55,7 @@ SUBCOMMANDS: ``` text $ solrcopy help backup -solrcopy-backup 0.5.0 +solrcopy-backup 0.5.1 Dumps documents from a Apache Solr core into local backup files USAGE: @@ -66,34 +66,40 @@ FLAGS: -V, --version Prints version information OPTIONS: - -b, --docs-per-step Number of documents retrieved from solr in each reader step [default: 4k] - -f, --from Case sensitive name of the Solr core for extracting documents - -i, --into Existing folder for writing the zip backup files containing the extracted - documents [env: SOLR_COPY_DIR=] - -l, --limit Maximum quantity of documents for retrieving from the core (like 100M) - --log-file-level What level of detail should write messages to the file [default: debug] - [possible values: off, error, warn, info, debug, trace] - --log-file-path Write messages to a local file - --log-level What level of detail should print messages [default: info] [possible - values: off, error, warn, info, debug, trace] - --log-mode What output should be used to output [default: mixed] [possible values: - none, stdout, stderr, mixed] - -m, --max-files Max number of files of documents stored in each zip file [default: 200] - -o, --order ... Solr core fields names for sorting documents for retrieval - -p, --prefix Optional prefix for naming the zip backup files when storing documents - -q, --query Solr Query for filtering which documents are retrieved - -r, --readers Number parallel threads reading documents from solr core [default: 1] - -s, --select ... Names of core fields retrieved in each document [default: all but _*] - -k, --skip Skip this quantity of documents in the Solr Query [default: 0] - -u, --url Url pointing to the Solr cluster [env: SOLR_COPY_URL=] - -w, --writers Number parallel threads writing documents into zip archives [default: 1] + -d, --docs-per-step Number of documents retrieved from solr in each reader step [default: 4k] + -f, --from Case sensitive name of the Solr core for extracting documents + -i, --into Existing folder for writing the zip backup files containing the extracted + documents [env: SOLR_COPY_DIR=] + -l, --limit Maximum quantity of documents for retrieving from the core (like 100M) + --log-file-level What level of detail should write messages to the file [default: debug] + [possible values: off, error, warn, info, debug, trace] + --log-file-path Write messages to a local file + --log-level What level of detail should print messages [default: info] [possible values: + off, error, warn, info, debug, trace] + --log-mode Terminal output to print messages [default: mixed] [possible values: stdout, + stderr, mixed] + -m, --max-files Max number of files of documents stored in each zip file [default: 200] + -o, --order ... Solr core fields names for sorting documents for retrieval + -p, --prefix Optional prefix for naming the zip backup files when storing documents + -q, --query Solr Query for filtering which documents are retrieved + -r, --readers Number parallel threads reading documents from solr core [default: 1] + -s, --select ... Names of core fields retrieved in each document [default: all but _*] + -k, --skip Skip this quantity of documents in the Solr Query [default: 0] + -u, --url Url pointing to the Solr cluster [env: SOLR_COPY_URL=] + --workaround-shards Use only when your Solr Cloud returns a distinct count of docs for some + queries in a row. This may be caused by replication problems between cluster + nodes of shard replicas of a core. Response with 'num_found' bellow the + greatest value are ignored for getting all possible docs. Use with `--params + shards=shard_name` for retrieving all docs for each shard of the core + [default: 0] + -w, --writers Number parallel threads writing documents into zip archives [default: 1] $ solrcopy backup --url http://localhost:8983/solr --from demo --query 'price:[1 TO 400] AND NOT popularity:10' --order price:desc weight:asc --limit 10000 --select id date name price weight popularity manu cat store features --into ./tmp ``` ``` text $ solrcopy help restore -solrcopy-restore 0.5.0 +solrcopy-restore 0.5.1 Restore documents from local backup files into a Apache Solr core USAGE: @@ -114,8 +120,8 @@ OPTIONS: --log-file-path Write messages to a local file --log-level What level of detail should print messages [default: info] [possible values: off, error, warn, info, debug, trace] - --log-mode What output should be used to output [default: mixed] [possible values: none, - stdout, stderr, mixed] + --log-mode Terminal output to print messages [default: mixed] [possible values: stdout, + stderr, mixed] -m, --max-errors How many times should continue on source document errors [default: 0] -p, --params Extra parameter for Solr Update Handler. See: https://lucene.apache.org/solr/guide/transforming- @@ -124,14 +130,13 @@ OPTIONS: -s, --search Search pattern for matching names of the zip backup files -u, --url Url pointing to the Solr cluster [env: SOLR_COPY_URL=] -w, --writers Number parallel threads writing documents into zip archives [default: 1] -# juarezr@D2019599 [13:25:49-03] ~/src/github/solrcopy @master $ solrcopy restore --url http://localhost:8983/solr --from ./tmp --into target ``` ``` text $ solrcopy help commit -solrcopy-commit 0.5.0 +solrcopy-commit 0.5.1 Perform a commit in the Solr core index for persisting documents in disk/memory USAGE: @@ -148,8 +153,8 @@ OPTIONS: --log-file-path Write messages to a local file --log-level What level of detail should print messages [default: info] [possible values: off, error, warn, info, debug, trace] - --log-mode What output should be used to output [default: mixed] [possible values: none, - stdout, stderr, mixed] + --log-mode Terminal output to print messages [default: mixed] [possible values: stdout, + stderr, mixed] -u, --url Url pointing to the Solr cluster [env: SOLR_COPY_URL=] $ solrcopy commit --url http://localhost:8983/solr --into target diff --git a/changelog.txt b/changelog.txt index c74e016..7644fd6 100644 --- a/changelog.txt +++ b/changelog.txt @@ -1,3 +1,11 @@ +debian (0.5.1) unstable; urgency=low + + * feature: added --workaround-shards + * improved: changed progress bar style + * fix progress with --log-level off + +-- Juarez Rudsatz Mar, 8 Ma 2020 00:05:01 -0300 + debian (0.5.0) unstable; urgency=low * feature: added --log-level --log-mode --log-file-path