diff options
| author | Eric Wong <e@80x24.org> | 2019-06-13 00:29:37 +0000 |
|---|---|---|
| committer | Eric Wong <e@80x24.org> | 2019-06-14 01:31:25 +0000 |
| commit | e9eb3af852778a67533e9579b14695763535d262 (patch) | |
| tree | 09478c84234a4a7f99def3bbae8f4f7e19c390fe /Documentation | |
| parent | e665a4fa317bf9ceea812bc9ca3f486ec722dfea (diff) | |
| download | public-inbox-e9eb3af852778a67533e9579b14695763535d262.tar.gz | |
v2 repos are sometimes created on machines where CPU parallelization exceeds the capability of the storage devices. In that case, users may reshard the Xapian DB to any smaller, positive integer to avoid excessive overhead and contention when bottlenecked by slow storage. Resharding can also be used to increase shard count after hardware upgrades.
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/public-inbox-xcpdb.pod | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/Documentation/public-inbox-xcpdb.pod b/Documentation/public-inbox-xcpdb.pod index a04fd374..fd8770a4 100644 --- a/Documentation/public-inbox-xcpdb.pod +++ b/Documentation/public-inbox-xcpdb.pod @@ -30,6 +30,17 @@ preferable for gigantic inboxes where the coarse-grained lock currently required for L<public-inbox-compact(1)> can cause the compaction to take hours at-a-time. +=item --reshard=N / -R N + +Repartition the Xapian database on a L<v2|public-inbox-v2-format(5)> +inbox to C<N> partitions. Since L<xapian-compact(1)> is not suitable +for merging, users can rely on this switch to repartition the +existing Xapian database(s) to any positive value of C<N>. + +This is useful in case the Xapian DB was created with too few or +too many partitions given the capabilities of the current +hardware. + =item --blocksize / --no-full / --fuller These options are passed directly to L<xapian-compact(1)> when |