Todd Harris > Bio-GMOD > gmod_update_installation-wormbase.pl

Download:
Bio-GMOD-0.028.tar.gz

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Source  

NAME ^

gmod_update_installation-wormbase.pl

USAGE ^

 $ gmod_update_installation-wormbase.pl [options]

This script should be executed with superuser privileges.

OPTIONS ^

Available options include (default values in parenthesis): Versions and process tasks: --version Update to the provided version (if available on the server!) --force [boolean] Force an update to the provided version (false)

 --exclude       [list...] Files, paths, or patterns to exclude from the rsync update (none)
 --help          Display this message

In order to avoid a ludicrously long incantation, full options for this script should be stored in a configuration file consisting of key=value pairs. See the "wormbase_update_defaults.cfg" file that is included with this distribution for a full description of all options complete with suitable defaults.

To invoke the script:

 gmod_update_installation-wormbase.pl --config /full/path/to/my.config

Controlling which update steps are executed ^

You can broadly control which steps are executed by passing either the --update_database and/or the --update_software flags.

If you would like more specific control, you can specify specific steps to run during the update by passing a comma-separated list with the "--steps" paramater. Available steps are:

  acedb         Fetch and install the acedb database
  elegans_gff   Fetch and install the C. elegans GFF database
  briggsae_gff  Fetch and install the C. briggsae GFF database
  blast         Fetch and install the blast/blat databases
  software      Rsync the software
  analyze_logs  WormBase logs; requires Analog and ReportMagic
  clear_cache   Clear the wormbase cache at /usr/local/wormbase/cache

The --update_database flag is equivalent to "--steps acedb,elegans_gff,briggsae_gff,blast,clear_cache" and the --update_software flag is equivalent "--steps software".

If the --steps option is not specified or the --update_* options are omitted, the following steps will be executed:

   acedb, elegans_gff, briggsae_gff, blast, software, clear_cache

Examples ^

Do an update of both software and databases

  ./gmod_update_installation-wormbase.pl \
           --sync_to live \
           --update_software \
           --update_databases

      Or more simply:

  ./gmod_update_installation-wormbase.pl \
           --sync_to live \

Fetch the most up-to-date version of the code without updating databases:

  ./gmod_update_installation-wormbase.pl \
           --sync_to live \
           --update_software

Official mirror sites should use a command like:

  ./gmod_update_installation-wormbase.pl \
           --sync_to live \
           --update_databases \
           --update_software \
           --steps analyze_logs

Update databases without updating the software:

  ./gmod_update_installation-wormbase.pl \
           --sync_to live \
           --update_databases

Excluding files from the syncing process ^

If you have local files or directories stored in your WormBase distribution, you can prevent them from being overwritten by the update process by passing a space separated list of files/directories with the '--exclude' option. This options will be passed directly to rsync. See the rsync man page for more details. Note that you do NOT need to include files that contain local defaults (like localdefs.pm) as these are exluded by default.

Running under cron ^

You may wish to run this script under cron to ensure that your installation is always up-to-date.

A suggested crontab entry for a simple local installation is:

 0 2,14 * * * gmod_update_intallation.pl --sync_to live --purge 1

A suggested crontab entry for official WormBase mirror sites is:

 0 2,14 * * * gmod_update_intallation.pl --sync_to live \
        --update_databases --update_software \
        --steps analyze_logs

Crontab entries like these will check for updates twice a day -- including updating the software. Be sure to include any necessary options as well, such as the path to your mysql data directory.

BUGS ^

None reported.

SEE ALSO ^

Bio::GMOD, Bio::GMOD::Update, Bio::GMOD::Update::WormBase, Bio::GMOD::Adaptor, Bio::GMOD::Adaptor::WormBase

AUTHOR ^

Todd W. Harris <harris@cshl.org>.

Copyright (c) 2004-2005 Cold Spring Harbor Laboratory.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: