Skip to content

Commit

Permalink
prepare for pre-release 0.4.3
Browse files Browse the repository at this point in the history
  • Loading branch information
Juarez Rudsatz committed May 1, 2020
1 parent 7bfdb1b commit e0090a5
Show file tree
Hide file tree
Showing 3 changed files with 50 additions and 16 deletions.
2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "solrcopy"
version = "0.4.2"
version = "0.4.3"
edition = "2018"

authors = ["Juarez Rudsatz <juarezr@gmail.com>"]
Expand Down
33 changes: 26 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ Command line tool for backup and restore of documents stored in cores of [Apache
- solrcopy backup/restore
- Should work well in most common cases.
- Works for me... :)
- Packaging:
- Not started yet
- Check the issues in github
- Patches welcome!

Expand All @@ -21,7 +19,7 @@ Command line tool for backup and restore of documents stored in cores of [Apache
1. Use the command `solrcopy backup` for dumping documents from a Solr core into local zip files.
1. Use the switch `--query` for filtering the documents extracted by using a [Solr](https://lucene.apache.org/solr/guide/8_4/the-standard-query-parser.html) [Query](https://lucene.apache.org/solr/guide/8_4/the-standard-query-parser.html)
2. Use the switch `--order` for specifing the sorting of documents extracted.
3. Use the switch `--limit` for restricting the number of documents extracted.
3. Use the switches `--limit` and `--skip` for restricting the number of documents extracted.
4. Use the switch `--select` for restricting the columns extracted.
2. Use the command `solrcopy restore` for uploading the extracted documents from local zip files into the same Solr core or another with same field names as extracted.
1. The documents are updated in the target core in the same format that they were extracted.
Expand All @@ -33,7 +31,7 @@ Command line tool for backup and restore of documents stored in cores of [Apache

``` text
$ solrcopy --help
solrcopy 0.4.2
solrcopy 0.4.3
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
Expand All @@ -57,7 +55,7 @@ SUBCOMMANDS:

``` text
$ solrcopy help backup
solrcopy-backup 0.4.2
solrcopy-backup 0.4.3
Dumps documents from a Apache Solr core into local backup files
USAGE:
Expand Down Expand Up @@ -89,7 +87,7 @@ $ solrcopy backup --url http://localhost:8983/solr --from demo --query 'price:[1

``` text
$ solrcopy help restore
solrcopy-restore 0.4.2
solrcopy-restore 0.4.3
Restore documents from local backup files into a Apache Solr core
USAGE:
Expand All @@ -102,7 +100,7 @@ FLAGS:
OPTIONS:
-c, --commit <mode> Mode to perform commits of the index while updating documents in the core
[default: none] [possible values: none, soft, hard]
[possible values: none, soft, hard, final, <num docs>] [default: final]
-f, --from </path/to/zips> Existing folder for reading the zip backup files containing documents [env:
SOLR_COPY_DIR=]
-i, --into <core> Case sensitive name of the Solr core to upload documents
Expand All @@ -114,6 +112,26 @@ OPTIONS:
$ solrcopy restore --url http://localhost:8983/solr --from ./tmp --into target
```

``` text
$ solrcopy help commit
solrcopy-commit 0.4.3
Perform a commit in the Solr core index for persisting documents in disk/memory
USAGE:
solrcopy commit [FLAGS] --into <core> --url <localhost:8983/solr>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
--verbose Show details of the execution
OPTIONS:
-i, --into <core> Case sensitive name of the Solr core to perform the commit
-u, --url <localhost:8983/solr> Url pointing to the Solr cluster [env: SOLR_COPY_URL=]
$ solrcopy commit --url http://localhost:8983/solr --into target
```

## Known Issues

- Error extracting documents from a Solr cloud cluster with unbalanced shards:
Expand Down Expand Up @@ -212,6 +230,7 @@ $ docker exec -it test-container solr create_core -c target
- `--order`
- `--select`
- `--batch`
- `--skip`
- `--limit`
2. Check the [Solr Query](https://lucene.apache.org/solr/guide/8_4/the-standard-query-parser.html) docs for understading this parameters.
4. Test the parameters in Solr admin UI at your core in **solr address** (somenthing like: [http://localhost:8983/solr/#/corename](http://localhost:8983/solr/#/corename))
Expand Down
31 changes: 23 additions & 8 deletions changelog.txt
Original file line number Diff line number Diff line change
@@ -1,10 +1,25 @@
debian (0.40.1) unstable; urgency=low
debian (0.4.3) unstable; urgency=low

* feature: add modes final and <docs> for restore --commit
* improved: added a default commit on final
* improved: replace crate reqwest by ureq
* fixed: fixed url to solr update handler

-- Juarez Rudsatz <juarezr@gmail.com> Mar, 1 Ma 2020 00:04:03 -0300

debian (0.4.2) unstable; urgency=low

* feature: continuos integration, cross compiling (Closes: #2)

-- Juarez Rudsatz <juarezr@gmail.com> Mar, 23 Mar 2020 00:04:02 -0300

debian (0.4.1) unstable; urgency=low

* feature: handle app interrupt on Crl+C or Ctrl+Break (Closes: #5)

-- Juarez Rudsatz <juarezr@gmail.com> Mar, 16 Mar 2020 00:40:00 -0300
-- Juarez Rudsatz <juarezr@gmail.com> Mar, 23 Mar 2020 00:04:01 -0300

debian (0.40.0) unstable; urgency=low
debian (0.4.0) unstable; urgency=low

* feature: retry on http timeout errors (Closes: #6)
* feature: add --max-files for splitting zip files
Expand All @@ -15,9 +30,9 @@ debian (0.40.0) unstable; urgency=low
* fixed: some minor bugs also
* refactored: added rustfmt.toml for code formmatting

-- Juarez Rudsatz <juarezr@gmail.com> Mar, 16 Mar 2020 00:40:00 -0300
-- Juarez Rudsatz <juarezr@gmail.com> Mar, 16 Mar 2020 00:04:00 -0300

debian (0.30.0) unstable; urgency=low
debian (0.3.0) unstable; urgency=low

* feature: process backup/restore in parallel (Closes: #3)
* feature: add --readers --writers for controlling parallel workers
Expand All @@ -33,10 +48,10 @@ debian (0.30.0) unstable; urgency=low
* refactored: created a container with solr for testing
* refactored: formatted source code with cargo fmt

-- Juarez Rudsatz <juarezr@gmail.com> Mar, 11 Mar 2020 00:30:00 -0300
-- Juarez Rudsatz <juarezr@gmail.com> Mar, 11 Mar 2020 00:03:00 -0300

debian (0.21.1) unstable; urgency=low
debian (0.2.1) unstable; urgency=low

* Initial release (Closes: #1)

-- Juarez Rudsatz <juarezr@gmail.com> Mar, 04 Mar 2020 00:21:01 -0300
-- Juarez Rudsatz <juarezr@gmail.com> Mar, 04 Mar 2020 00:02:01 -0300

0 comments on commit e0090a5

Please sign in to comment.