Bug 39899 - Reset Zebra FAQ
Summary: Reset Zebra FAQ
Status: Needs documenting
Alias: None
Product: Koha
Classification: Unclassified
Component: Documentation (show other bugs)
Version: unspecified
Hardware: All All
: P5 - low enhancement
Assignee: Bugs List
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-05-14 12:31 UTC by Alexander Wagner
Modified: 2025-05-15 23:33 UTC (History)
3 users (show)

See Also:
GIT URL:
Change sponsored?: ---
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:
Circulation function:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Alexander Wagner 2025-05-14 12:31:02 UTC
https://koha-community.org/manual/latest/en/html/faq.html#reset-the-zebra-index

gives the following command to reset the ZEBRA index for biblios:

```
$ sudo zebraidx -c /etc/koha/sites/YOURLIBRARY/zebra-biblios.cfg  -g iso2709 -d biblios init
```

This results in a `file not found` error at least in 24.1104.

It seems that the name of the config file in question should read

```
/etc/koha/sites/YOURLIBRARY/zebra-biblios-dom.cfg
```

Probably this is version dependend?

**Note** the manual gives two commands, one for biblios and one for authorities. The command for authorities seems to be correct. Also note that the two commands are effectively given twice as the package install versions require a `sudo` to be prepended.
Comment 1 Aude Charillon 2025-05-14 13:24:04 UTC
Hi Alexander, thanks for logging this as a bug. The Documentation team has decided (please don't ask me to go through our meeting minutes to check when exactly!) that the FAQ chapter was not fit for purpose anymore. We will slowly empty it by moving content to the relevent Manual chapters and deleting what is clearly out of date.

We have also agreed that the more technical information usually belongs in the Wiki. See https://wiki.koha-community.org/wiki/Documentation_-_Content_Development_Guide#Koha_Manual_vs._Koha_Wiki It will be up to whoever picks up this bug to review the particular section you highlight.

As you seem to have the knowledge required to update this type of information (while, clearly, I don't :-D) please do consider submitting a correction to the Manual yourself. https://wiki.koha-community.org/wiki/Editing_the_Koha_Manual
Comment 2 Alexander Wagner 2025-05-14 13:46:33 UTC
Hello Aude,

I'll update the Wiki accordingly. One issue was that the wiki linked to a page (in the wiki?) that does not exist any more and it looked like the FAQ is moved to the manual. But if it's the other way round :)
Comment 3 Aude Charillon 2025-05-14 13:48:15 UTC
Oh dear; sounds like we changed things round a few times over the years! Certainly doesn't make it easy :-)
Comment 4 Alexander Wagner 2025-05-14 14:03:42 UTC
(In reply to Aude Charillon from comment #3)
> sounds like we changed things round a few times over the years!

This can happen. And a project certainly has to live long enough to have this luxury problem ;)

I added the lines to

https://wiki.koha-community.org/wiki/Troubleshooting_Zebra#Doing_a_manual_re-index
Comment 5 Alexander Wagner 2025-05-15 14:50:08 UTC
For sake of completeness:

https://koha-community.org/faq/

would require an update if the FAQs go to the wiki.