Skip to main content
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    How do I determine if keyword regen is needed?

    • Product: Voyager
    • Product Version: All
    • Relevant for Installation Type: Dedicated-Direct; Direct; Local;


    How to determine if a keyword index regen is needed?


    Quick Answer: When the size of the dynamic file is more than half the size of the largest static file, and/or if you can't do OPAC keyword searches to find known records.

    Other signs you may need a regen:

    • issues with saving or updating bibliographic records
    • issues with keyword searching
    • display/search issues in clients and WebVoyage
    • performance issues and a dynamic.dc file that exceeds 250M (even if it is less than 50% the size of your static dictionary
    Use the UTIL menu 

    Note that the UTIL menu can be used to determine if you need a keyword regen as well as run a keyword regen if one is needed.

    How to check size ratio of keyword files in /data directory  (where xxxdb is the Voyager Database Instance)
    1. SSH to voyager server.
    2. cd /m1/voyager/xxxdb/data
    3. ls -lh
    4. Review the files and note the file sizes. You will see output similar to this:
    -rw------- 1 voyager exlibris 42M Jul 8 08:14 bib_text.1.tbt
    -rw------- 1 voyager exlibris 636K Jul 8 08:14 bib_text.1.tdr
    -rw------- 1 voyager exlibris 144 Jul 8 08:14 dynamic.bif
    -rw------- 1 voyager exlibris 19M Jul 8 08:15 dynamic.dc
    -rw------- 1 voyager exlibris 2 Jul 8 08:14 dynamic.que
    -rw------- 1 voyager exlibris 264 Apr 30 11:34 xxxdb.1.bif
    -rw------- 1 voyager exlibris 92M Apr 30 11:34 xxxdb.1.dc
    -rw------- 1 voyager exlibris 324 Jul 8 08:14 xxxdb.1.kil
    1. 5. Use the following formula to determine if a keyword regen may be needed: (size of dynamic.dc - 2048 KB) * 2 > size of largest xxxdb.N.dcOR, dynamic.dc file is approximately 50% the size of the static dictionary(xxxdb.N.dc) file.
    2. Use same procedure to check mfhd keyword data (/m1/voyager/xxxdb/
    Check size ratio of keyword files using UTIL menu
    1. dlib xxxdb
    2. util
    3. I. Index Maintenance
    4. I. Keyword Info

    Note the "Keyword Regen suggested" value in the output:

    Voyager Keyword Statistics for xxxdb
    Last Regen Run:                 Jun  7 14:45
    Largest Keyword File Size:      117404 K
    Dynamic Keyword File Size:      2060 K
    Keyword Regen suggested:        No
    Required regen diskspace:       1700 MB
    Last MFHD Regen Run:            Jun  7 14:45
    Largest MFHD Keyword File Size: 3824 K
    Dynamic MFHD Keyword File Size: 2216 K
    MFHD Keyword Regen suggested:   No
    Required regen diskspace:       1700 MB

    Additional Information

    Support can run a keyword regen for you.  Open a ticket to request this.



    • Article last edited: 20-May-2020