Skip to content

Commit 62b0cce

Browse files
committed
Add new section: Errors and Troubleshooting - Full text searching not
working Also make every Errors and Troubleshooting section header include description of problem.
1 parent 74e4cb0 commit 62b0cce

File tree

1 file changed

+21
-8
lines changed

1 file changed

+21
-8
lines changed

doc/upgrading.txt

Lines changed: 21 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -135,13 +135,15 @@ It is recommended that you change your templates so every form
135135
that is not submitted via GET has an @csrf field. Then change
136136
the csrf_enforce_token setting to 'required'.
137137

138-
Errors and Troubleshooting
139-
~~~~~~~~~~~~~~~~~~~~~~~~~~
138+
Errors and Troubleshooting - @csrf in url
139+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
140140

141141
If you see the @csrf nonce in the URL, you have added the value to a
142142
form that uses the GET method. You should remove the @csrf token from
143143
these forms as it is not needed.
144144

145+
Errors and Troubleshooting - AttributeError list object no attribute value
146+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
145147
If you get an error:
146148

147149
AttributeError: 'list' object has no attribute 'value'
@@ -223,6 +225,17 @@ setting this value in the [main] section of the tracker's
223225
# Possible values: xapian, whoosh, native (internal).
224226
indexer =
225227

228+
Errors and Troubleshooting - Full text searching not working
229+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
230+
231+
If after the upgrade full text searching is not working try changing
232+
the indexer value. If this is failing most likely you need to set
233+
'''indexer = native''' to use the rdbms or db text indexing systems.
234+
235+
Alternatively you can do a
236+
'''roundup-admin -i /path/to/tracker reindex'''
237+
to generate a new index using roundup's preferred indexer from the list above.
238+
226239
Stemming improved in Xapian Indexer
227240
-----------------------------------
228241

@@ -306,8 +319,8 @@ or with::
306319
the important part is that the action field **must not** include any query
307320
parameters ('#' includes query params).
308321

309-
Errors and Troubleshooting
310-
~~~~~~~~~~~~~~~~~~~~~~~~~~
322+
Errors and Troubleshooting - Unrecognized scheme in ...
323+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
311324

312325
One symptom of failing to do this is getting an error:
313326

@@ -445,8 +458,8 @@ If you are running a tracker that **does not** allow read access for
445458
anonymous, you should remove this entry as it can be used to perform
446459
a username guessing attack against a roundup install.
447460

448-
Errors and Troubleshooting
449-
~~~~~~~~~~~~~~~~~~~~~~~~~~
461+
Errors and Troubleshooting - Unassigned issues for anonymous
462+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
450463

451464
If you notice that the "Unassigned Issues" search on page.html
452465
is displaying assigned issues for users with the Anonymous role,
@@ -526,8 +539,8 @@ permissions to your schema.py::
526539
description="User is allowed to Search queries for creator")
527540
db.security.addPermissionToRole('User', s)
528541

529-
Errors and Troubleshooting
530-
~~~~~~~~~~~~~~~~~~~~~~~~~~
542+
Errors and Troubleshooting - Public queries listed twice when editing
543+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
531544

532545
If you do not do this, public queries will be listed twice in the edit
533546
interface. Once in the "Queries I created" section and again in the

0 commit comments

Comments
 (0)