diff doc/upgrading.txt @ 6599:39189dd94f2c

issue2551189 - increase size of words in full text index. Increased indexed word maxlength to 50 DB migration code is written and tests work. Restructured some tests to allow for code reuse. Docs. If this passes CI without errors 2551189 should be done. However, testing on my system generates errors. Encoding (indexer unicode russian unicode string invalid) and collation errors (utf8_bin not valid) when running under python2. No issues with python3 and I haven't changed code that should cause these since the last successful build in CI. So if this fails in CI we will have more checkins.
author John Rouillard <rouilj@ieee.org>
date Wed, 26 Jan 2022 15:04:09 -0500
parents feab8c878d08
children 0d99ae7c8de6
line wrap: on
line diff
--- a/doc/upgrading.txt	Wed Jan 26 08:58:46 2022 -0500
+++ b/doc/upgrading.txt	Wed Jan 26 15:04:09 2022 -0500
@@ -38,8 +38,15 @@
 Rdbms version change from 6 to 7 (required)
 -------------------------------------------
 
-To add support for database supported full-text search (FTS), the
-rdbms database schema has to be upgraded.
+This release includes two changes that require updates to the database
+schema:
+
+  1. The size of words included in the Roundup FTS indexers have been
+     increased from 25 to 50. This requires changes to the database
+     columns used by the native indexer.  This also affect the whoosh
+     and xapian indexers.
+  2. Some databases that include native full-text search (native-fts
+     indexer) searching are now supported.
 
 You should run the ``roundup-admin migrate`` command for your
 tracker once you've installed the latest codebase.
@@ -52,6 +59,16 @@
 "No migration action required" (if you have run it, or have used
 another interface to the tracker, or are using anydbm).
 
+See `below for directions on enabling native-fts`_.
+
+.. _below for directions on enabling native-fts: \
+    #enhanced-full-text-search-optional
+
+The increase in indexed word length also affects whoosh and xapian
+backends. You may want to run ``roundup-admin -i tracker_home
+reindex`` if you want to index or search for longer words in your full
+text searches. Re-indexing make take some time.
+
 Check compression settings (optional)
 -------------------------------------
 

Roundup Issue Tracker: http://roundup-tracker.org/