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 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.

    How to check size ratio of keyword files in /data directory
    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

    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


    The UTIL menu can also be used to run a keyword regen if one is needed.

    • Article last edited: 20-May-2020