FAQ

Administration

I’ve just installed Koha, I haven’t touched any settings, and I can’t add patrons! Why?

You need to define your patron types and circulation rules before you can add patrons.

This will be especially relevant if you have not installed any sample data.

You can do this under More -> Administration.

How do I find out what version of Koha I am running?

Version information can be found on the About page of the Intranet. It’s usually a link in the lower right hand corner, right after the login. You can also find it by going to the More menu at the top of the page -> About Koha.

Viewing source (ctrl-u) on the OPAC also will give the version – it will look something like

 meta name="generator" content="Koha 3.1700054"   

Authorities

Is there a way to not use authorities?

Yes. You need to edit the desired subfields in your MARC framework and set the value of the ‘Thesaurus’ to blank.
For more information, see section 1.4.1.3 in the manual, and look to the entry on ‘Thesaurus.’


Cataloging

Why can’t I edit 1xx, 6xx, or 7xx fields in my catalog record?

These fields are authority controlled in the default frameworks, and the BiblioAddsAuthorities system preference is set to ‘don’t allow’ in all new Koha installs. When it is set to ‘don’t allow,’ these fields will be locked and require you to search for an existing authority record to add data to this field. Turning on BIblioAddsAuthorites will allow you to add authorities on the fly as you catalogue records, but be aware that any typos or duplicates you make will be added as authorities.

What’s the relationship between ‘Koha to MARC Mapping’ and ‘MARC Bibliographic Frameworks’?

Mapping can be defined through ‘MARC Bibliographic Frameworks’ OR ‘Koha to MARC Mapping’. ‘Koha to MARC Mapping’ is just a shortcut to speed up linkage. If you change a mapping in one of these modules, the mapping will change in the other as well. (In other words, the two modules ‘overwrite’ each other in order to prevent conflicts from existing in Koha).

Can Koha globally edit authority records or any elements in the bib. record?

If you use authority control in Koha you can set the system up to automatically update all bibs that link to that authority when you make changes to it. See Administration > System Preferences > Authorities > dontmerge for more information.

There is also an item edit tool in Koha that allows items/holdings to be edited in batch. There is currently not a tool within Koha to batch modify bibliographic records. All things going well, Bug 11395 will be included in version 3.20.


Circulation

How is the dropbox date determined? Is it the last open date for the checkout branch? Is it today’s date minus one? Can the dropbox checkin date be set?

If the library is closed for four days for renovations, for example, there would be more than one day needed for the dropbox date. You will only have one dropbox date and that will be the last day that the library open (determined by the holiday calendar) because there is no real way to know what day the books were dropped into the box during the 4 closed days. The only way to change the effective checkin date in dropbox mode is to modify the calendar.

Why are patrons getting two overdue notices?

This tool takes all branches in the overdue rules and sent notifications to them. So, if you have a default rule & a branch rule, the notification will be generated twice. A quick fix is to discard “default rule” for instance.

Why can’t I place holds when I have all of the preferences turned on?

At the very least you will need to set a default circulation rule. Koha does not come with one by default. This rule should be set for the default itemtype, default branchcode and default patron category. That will catch all instances that do not match a specific rule. When checking out if you do not have a rule for the default branch, default item and default patron category then you may see patrons getting blocked from placing holds.

Also check that the AllowOnShelfHolds system preference is turned on – it is off by default in a standard Koha. Turning this system preference on allows items to be placed on hold even if the item is currently checked-in.

Why am I getting fined 5.00 for every loan?

The money you are seeing on your borrower accounts isn’t a fine, it is a rental fee. The optional default item types that come with the Koha sample data contain a $5 rental fee. To remove this fee, do the following:

  • Click More -> Administration
  • Click Item Types
  • Note which item types have a $5 fee associated with them, select them for editing
  • Remove the fee, and save the item type

Display

Can I have my own set of item type images (or authorized value icons)?

Absolutely. To add additional icons to your system you simply add a new directory to koha-tmpl/intranet-tmpl/prog/img/itemtypeimg/ and to koha-tmpl/opac-tmpl/prog/itemtypeimg and put your icons in the new directory. Your icons will show up in a new tab as soon as they are in the folders.
TIP: Remember to put the icons in both places (on the OPAC and the intranet).


Installing/Upgrading

My Zebra Indexing won’t work! How do I fix it? (AKA: I search for stuff and nothing comes up! Help!)

There are several things to check:

  • FIRST: If you imported the records you are looking for less than 20 minutes ago, you may simply need to wait for the indexer to catch up. Results are not instantaneous – the update process only runs once every 10 minutes by default – so go get yourself a cup of coffee and try it in a little bit. If THAT doesn’t work…
  • Make sure zebra is installed!
  • Are your environment variables set correctly? Try this as the user zebra runs as (koha by default):
    export PERL5LIB=/path/to/your/koha/

    (this is the directory above where your C4 directory is) and

    export KOHA_CONF=/path/to/your/koha-conf.xml

    and run rebuild_zebra.pl again.

  • Make sure that you are pointing to the correct koha-conf.xml, and that you don’t have duplicates.
  • Make sure that you are running the reindex as your Koha system user (or root, depending on your setup).
  • The indexes must be owned and readable by the correct user (usually your system koha user or root, depending on your setup). Permissions are a common cause of indexing not working.

To rebuild using the packages (recommended installation) you do:

sudo koha-rebuild-zebra -v --full $(/usr/sbin/koha-list)

If you have installed with a tarball:

misc/migration_tools/rebuild_zebra.pl -b -r -v

If this has not been run at least once, you will get no results. Preferably, run this after you have added a few biblios, so that the result is immediately clear. See also: New items aren’t getting updated when I catalog.

What kind of barcode scanner will I need for Koha?

Any barcode reader that will read your barcodes into a notepad document accurately will work with Koha.
Most institutions use handheld USB models that range in price from $50 (USD) to $300 (USD).

I added some books for testing, now I’m done testing but I want to delete all of my test items and bibs and start fresh. How do I do it?

You can delete them all in MySQL.
** Please make sure you have made a backup of your data, just in case. We are not responsible for your lost data **

In your MySQL client, issue the following:

truncate biblio;

This will clean out biblio, biblioitems and items (by cascade), leaving you with a fresh biblio database for production use.

Additionally, until you clear the indexes, your deleted items will still be searchable in the database.

Should I use the Debian packages or the tarball to install Koha?

For the beginning user, it is highly recommended to use the package install of Koha – it provides many simple commands to do powerful things to your Koha installation. Packages should almost always be your choice of install on an ordinary production Koha install. A relative minimum of system administration skill is required to install Koha using the Debian packages.

Instructions for using the packages with:

Installing from tarball or git is the only option for people not installing on Debian or Ubuntu.

Developers should give the KohaDevBox a look, it’s the easiest, quickest way to get a Developer instance of Koha going.


OPAC

Can I customize the images in the OPAC?

Absolutely. Koha comes with a series of original images that you can alter to meet your needs. The originals can be found in the misc/interface_customization/ directory.

Why is Amazon’s enhanced content not appearing?

Amazon uses the server time in its API requests and so if the system time is off one will not be able to use Amazon content. Verify that your server time is correct, uptdate it if necessary, and make sure all of your Amazon preferences are turned on.

Amazon also requires an ISBN for displaying book covers – make sure that you have the correct ISBN for your title. If you are having trouble with a book that seems like it should have a cover but doesn’t turn one up, give it a try with the 10 digit ISBN in the first 020a. If you have a 10 digit and it’s not turning up, try with the 13 digit ISBN in the first 020a.

What cookies does Koha use?

Koha uses 3 cookies :

OpacLanguage : User preffered language, expires one year after the user chooses a language
KohaOpacRecentSearches : Keeps the latest user searches, expires at the end of the session
CGISESSID : Keep the information of the user session, expires at the end of the session


Reports

I don’t know SQL, but I want to write a report that does X. Can you tell me how?

The community people in the Koha IRC channel are usually happy to help write reports, but a great many reports have already been shared by the community, so there are a few places to check before you ask:

Koha Reports Library
Koha Database Schema

Help with custom report parameters:
Koha Manual – SQL Reports (scroll down to section 1.1.2)


Searching

I have double ups in my search results, how do I clear my index and start again?

It should be as simple as running rebuild_zebra.pl with the -r switch. But if this doesn’t work you can drop and recreate the zebra indexes. To do so for the biblios index.
As the user your zebra runs as (probably koha)
run
zebraidx -c /path/to/zebra-biblios.cfg drop biblios

For me that is
zebraidx -c /home/chris/koha-dev/etc/zebradb/zebra-biblios.cfg drop biblios

Then
zebraidx -c /path/to/zebra-biblios.cfg commit

Then you can run rebuild_zebra.pl -b -r -v

What does ‘scan indexes’ on the advanced search page mean?

When you choose an index, enter a term, click ‘scan indexes’ and do the search, Koha displays the searched term and the following terms found in this index with the number of corresponding records That is search is not made directly in the catalog, but first in the indexes It works only for one index at once, and only with no limit in Location (All libraries needed)

I have added rebuild_zebra.pl -b -a -z in crontab, however, new entries are not indexed and cannot be found. I have to reindex everything each time with rebuild_zebra.pl -b -a -r. What’s wrong?

The problem could be one or more of several issues (given in order
from most likely to least likely):
1. Check that you are exporting the two environmental variables
necessary to run Koha scripts from the command line. These are (modify
to fit paths on your system):

PERL5LIB=/path/to/koha
KOHA_CONF=/path/to/koha-conf.xml

Note: You must also include these at head of the crontab file which
invokes any Koha scripts.

2. Be sure that you are running rebuild_zebra.pl as your kohauser.
This would include setting up the cron job under your kohauser.

3. Check directory permissions. Everything Zebra must be owned by your kohauser.

4. Be sure you are *not* running the zebraqueue daemon. Currently this
daemon has major problems and the recommended method of indexing is to
run rebuild_zebra.pl as a cron job. Running both causes more problems.

After deleting all the biblios and biblioitems we are still seeing the deleted items. What’s wrong?

The most likely cause of this problem is the need to re-index the Zebra database. Simply execute ‘rebuild_zebra.pl -a -b -r’.

My Zebra Indexing won’t work! How do I fix it? (AKA: I search for stuff and nothing comes up! Help!)

There are several things to check:

  • FIRST: If you imported the records you are looking for less than 20 minutes ago, you may simply need to wait for the indexer to catch up. Results are not instantaneous – the update process only runs once every 10 minutes by default – so go get yourself a cup of coffee and try it in a little bit. If THAT doesn’t work…
  • Make sure zebra is installed!
  • Are your environment variables set correctly? Try this as the user zebra runs as (koha by default):
    export PERL5LIB=/path/to/your/koha/

    (this is the directory above where your C4 directory is) and

    export KOHA_CONF=/path/to/your/koha-conf.xml

    and run rebuild_zebra.pl again.

  • Make sure that you are pointing to the correct koha-conf.xml, and that you don’t have duplicates.
  • Make sure that you are running the reindex as your Koha system user (or root, depending on your setup).
  • The indexes must be owned and readable by the correct user (usually your system koha user or root, depending on your setup). Permissions are a common cause of indexing not working.

To rebuild using the packages (recommended installation) you do:

sudo koha-rebuild-zebra -v --full $(/usr/sbin/koha-list)

If you have installed with a tarball:

misc/migration_tools/rebuild_zebra.pl -b -r -v

If this has not been run at least once, you will get no results. Preferably, run this after you have added a few biblios, so that the result is immediately clear. See also: New items aren’t getting updated when I catalog.