Child pages
  • Troubleshooting

This space has moved to IU's Confluence.
It is located at https://uisapp2.iu.edu/confluence-prd/display/iulV3/

Skip to end of metadata
Go to start of metadata

Troubleshooting

Contents

Required Processes

The following processes must be running for Variations to work.

Process

Log File

Command to Check

Authentication Server (at least one)

installation dependent

installation dependent

Darwin Streaming Server

 

 

Apache Web Server

 

 

MySQL Server

 

 

RMI Registry

/home/dmlserv/log/rmi_registry.log

bin/checkVariations.sh

Variations Logging Server

/home/dmlserv/log/ui_log_server.log

bin/checkVariations.sh

Variations Lease Manager (at least one)

/home/dmlserv/log/LeaseManager.log

bin/checkVariations.sh

Variations Cataloging Server

/home/dmlserv/log/LIBRARY_CATALOGING.log

bin/checkVariations.sh

Variations Production Server

/home/dmlserv/log/LIBRARY_PRODUCTION.log

bin/checkVariations.sh

Required Cron Jobs

The following cron jobs must be running for Variations to work correctly.

Cron Job

Log

Desccription

updateNewMetaData.sh

log/updateNewMetadata._LIBRARY_PRODUCTION.log

This cron jobs copies new metadata from the cataloging schema
to the production schema.

purgeDeletedMySqlMetadata.sh

log/purgeDeletedMetadata._LIBRARY_PRODUCTION.log

This cron job purges metadata from the
production schema that has been deleted
from the cataloging schema.

updateKeywordIndex.sh

log/updateKeywordIndex.LIBRARY_CATALOGING.log
log/updateKeywordIndex.LIBRARY_PRODUCTION.log

This cron job updates information used for keyword searches.

generateQTstats.pl
generateStats.pl

log/qtStats.log
log/stats.log

Generates Variations usage statistics

Logging Problems

The servers are not logging.

The logging configuration files may not have been created or have been created incorrectly. Check that the files exist:

conf/server/logging/<YOUR_LIBRARY_NAME>_CATALOGING.lcf
conf/server/logging/<YOUR_LIBRARY_NAME>_PRODUCTION.lcf

If they do not exist, you may be able to create them by going to conf/server/logging and executing the following commands:

cp EXAMPLE_CATALOGING.lcf <YOUR_LIBRARY_NAME>_CATALOGING.lcf
cp EXAMPLE_PRODUCTION.lcf <YOUR_LIBRARY_NAME>_PRODUCTION.lcf

Then:

  • In the new file <YOUR_LIBRARY_NAME>_CATALOGING.lcf, replace EXAMPLE_CATALOGING with <YOUR_LIBRARY_NAME>_CATALOGING
  • In the new file <YOUR_LIBRARY_NAME>_PRODUCTION.lcf, replace EXAMPLE_PRODUCTION with <YOUR_LIBRARY_NAME>_PRODUCTION

Version Errors

If you get version errors, it could be because the versions files for the servers do not exist. The following two files should exist:

conf/server/versions/<YOUR_LIBRARY_NAME>_CATALOGING.versions
conf/server/versions/<YOUR_LIBRARY_NAME>_PRODUCTION.versions

If the files do not exist, you may be able to create them using the following steps:

    • Go to directory conf/server/versions
    • Copy EXAMPLE_CATALOGING.versions to <YOUR_LIBRARY_NAME>_CATALOGING.versions
    • Copy EXAMPLE_PRODUCTION.versions to <YOUR_LIBRARY_NAME>_PRODUCTION.versions

Cron Job Problems

  • Make sure that the file bin/crontab exists and does not contain EXAMPLE_ (which should have been replaced with <YOUR_LIBRARY_NAME>_).
  • Make sure that you executed the crontab crontab command in the bin directory. To check this, check to see if the output from crontab -l matches the contents of the file bin/crontab.
  • Check to see that the script bin/cronRun.sh exists and is correct. It should have been created by the bin/initVariations.sh script. The script should look something like what is below (with JAVA_HOME and PATH set correctly for your system).
    #!/bin/sh 
     
    # This script is a wrapper that sets up the proper environment before 
    # running another script. Its purpose is to guarantee a useful 
    # Variations environment when running scripts from crontab.
     
    JAVA_HOME=/usr/java/j2sdk1.4.2_12
    export JAVA_HOME
     
    PATH=/usr/kerberos/bin:/usr/java/j2sdk1.4.2_12/bin:/usr/local/ant/bin:/usr/local/bin:/bin:/usr/bin:/usr/X11R6/bin:/home/dmlserv/bin
    export PATH
     
    umask u=rwx,g=rwx,o=rx 
     
    # Run the command 
    "$@" 
    
  • No labels