ARGOS server installation notes
alpha 4 release; september 2003, d.gilbert

This ARGOS system is designed for automatic installation
and updates of FlyBase and other genome information servers.

This includes scripts, configurations, data, and Unix binaries
for all needed programs except Perl, Java and rsync.  Rsync is
used as the primary distribution program.

This is server distribution system is still in development.  It
will be possible to use this for automated updates of mirrored
servers.   Uses of an automated server distribution system include
local use for load distribution (apache backhand module is included
for this), world-wide mirror sites for rapid local access, 
institution/company mirror servers for local projects and  
data mining.   An automatable mirroring system differs from the
method of providing software and data downloads by FTP in that
packages of data and software in this system are kept up-to-date
without human intervention.  Similar package management systems
such as RPM, pacman and others are well developed tools but don't
quite meet the needs of this bio-database distribution.

Server packages are (mostly) at rsync://flybase.net/argos
Web notes are at http://eugenes.org/argos/ or http://flybase.net/ng/
Installation of a full FlyBase or other server will
require several gigabytes of disk space.
  
Some of these hosts have this server running
  http://cricket.bio.indiana.edu:8081/   -- solaris
  http://flybase.bio.indiana.edu:8081/   -- solaris
  http://chervil.bio.indiana.edu:8081/   -- linux
  http://marmot.bio.indiana.edu:8081/    -- macosx

REQUIREMENTS
------------
 Unix systems supported for binary packages:
   Sun Solaris v8 & v9
   Intel Linux (redhat v8,9 tested)
   Apple MacOSX v10.2   
   
 These packages need to be and commonly are preinstalled 
 except for Solaris v8
  Perl v5.6 or later  - http://www.perl.com/
  Java v1.3 or later  - http://java.sun.com/
  rsync v2.5 or later - http://rsync.samba.org/
  
     
INSTALL (with installargos script)
------------------------------

  This Perl script will handle installation 
  installargos.pl [ options ] -info|install|list|update|reconfigure 

  Summary of steps

   0. Fetch the install script from command line with
      rsync rsync://flybase.net/argos/install/installargos.pl .
  
   1. Run installargos.pl -root=/usr/local/argos -install 
       to create root folder and fetch the installation package
       (location for -root= is your choice; change below to match)
       
   2. Edit /usr/local/argos/install/install.conf.local
      to set configuration. Change package set, paths and ports
      as desired in this install.conf.
    
   3. Run /usr/local/argos/install/installargos.pl -update 
      to add the full set of packages. Packages selected from
      packages.conf will by copied from servers.
 
   4. Run /usr/local/argos/install/run-apache
      to start servers
      
The -info and -list commands make no changes to disk.
All commands are benign if used with -n[orun] option.
Some other installargos options:

  installargos.pl -info  == show packages information
  
  installargos.pl -list -pack flybase  == list all files in package, 
    and required packages, from distribution servers.

  installargos.pl -update == update installed packages on frequent basis
  
  installargos.pl -no -install == view steps without doing them
  
  installargos.pl -root=/usr/local/argos == use new root path
   
--------------------------------------------------

HISTORY
march 2003 : changed preliminary biodb to flybase-ng
may 2003   : renamed from flybaseng to argos 
summer 2003: added genome services: euGenes.org, daphnia-wFleaBase, centaurbase (test)