You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 19
Next »
To completely reestablish the projectdoc document index the Lucene index is required to be rebuilt and the projectdoc document cache needs to be cleared.
A reindex is only required if the algorithm for storing information by the projectdoc Toolbox in the Lucene index has been changed. The fact that this procedure is required will be provided in the release notes of each version.
Procedure
Usually running the Lucene Indexer via the admin view is sufficient.
Run the Lucene Indexer
The reindexer updates the Lucene database for full text queries.
- As a admin go to the "General configuration" section in the Confluence Administration
- Under "Administration" click "Content Indexing"
- Click "Rebuild" to run the indexer
Alternative Procedure
Run the following steps to reindex and refresh the projectdoc caches.
Clear the projectdoc Documents Cache
First refresh the projectdoc documents cache.
- As a admin go to the "General configuration" section in the Confluence Administration
- Under "Administration" click "Cache Management"
- Find the projectdoc caches
- Click "Flush" to clear the "projectdoc Document Cache"
Rebuild Doctype Cache
The doctype cache provides information about doctypes at runtime. This information is required for instance for ancestor queries.
To rebuild the doctype cache the admin is required to have the projectdoc-admin role (other roles also have the required privilege, see Cache Refresh Actions for details).
- On a projectdoc page click on the page tool icon
- Then click "Refresh Doctype Cache" (dependent on your roles not all menu items may be available)
Run the Lucene Indexer
The reindexer updates the Lucene database for full text queries.
- As a admin go to the "General configuration" section in the Confluence Administration
- Under "Administration" click "Content Indexing"
- Click "Rebuild" to run the indexer
Clearing projectdoc Tables
The projectdoc Toolbox uses Active Objects (AO) tables to persistently cache projectdoc documents for performance reasons. The tables are only used for caching and store no information that cannot be derived from your Confluence pages. Therefore it is possible to clear those tables and repopulate them.
In case you have cleared the database tables, a simple Lucene reindex is not sufficient. You need to use the Indexer REST service to properly repopulate the AO tables. If you do not use this service, the projectdoc Toolbox won't be able to find projectdoc documents. A query, for instance employed by the Display Table Macro, will present not hits.
The following curl call shows how to start the reindexer.
curl -n -s -X POST -H "Content-Type: application/json" "https://my.example.com/confluence/rest/projectdoc-internal/1/indexer/spaces"
Read our Tip on REST Login to Confluence with cURL for using curl with Confluence.
Please change the URL part "my.example.com/confluence
" to point to your Confluence server.