
    ------------------------------------------------------------------------
    Collection Workflow Integration System (CWIS)
    Version 1.5.1
    Released January 23rd, 2009
    ------------------------------------------------------------------------
    Copyright 2001-2009 Edward Almasy and Internet Scout
    http://scout.wisc.edu
    ------------------------------------------------------------------------

 
    ----- RELEASE STATUS ---------------------------------------------------

    Information about the changes and additions included in this release
    can be found in the CHANGES file, or from the Administration menu within
    the portal.


    ----- REQUIREMENTS -----------------------------------------------------

    CWIS requires Apache with PHP 4.1.0 and MySQL 4.1 or later.  PHP must
    be installed with MySQL support.

    This version of CWIS is being developed with Apache 2.2.3, PHP 5.1.6,
    and MySQL 5.0.45.  It should work with earlier versions of Apache and
    4.1 and later versions of PHP, but these specific versions are
    recommended if possible.  (Some early 4.x versions of PHP have bugs
    that may impair functionality in minor ways.)


    ----- INSTALLATION -----------------------------------------------------

    Before beginning installation of CWIS, you should have six pieces of
    information:

      - the directory on the web server where the software is to be 
            installed,
      - the URL (web address) that will be used to reach this directory,
      - the host name of the system running your MySQL database server,
      - the user name and password for logging into that MySQL server, and
      - the name of the database on that MySQL server to use when storing
            CWIS data.

    If you don't know any of these, your system administrator should be able
    to help you.

    Once you have the above information and have downloaded the CWIS
    distribution file (cwis-1.5.1.zip), unpack that file, upload the
    unpacked files and directories to your web server, and make sure the
    directory you uploaded to and the following sub-directories are all
    writable by the web server:

          include
          MetadataTool
          SPTUI--CWIS/MetadataTool
          SPTUI--Standards/MetadataTool
    
    Once you have the files uploaded and directories writable, begin the
    install by using your web browser to go to the URL:

          http://mysite.com/installcwis.php
	  
    where "http://mysite.com" is the address of your web server.  This
    should bring up a web page titled "CWIS Installation".  You'll then
    enter the information you gathered above into the web page that comes
    up and click on the "Begin Installation" button.  If everything checks
    out, the installation should take less than 30 seconds, after which a
    link to your new CWIS site should be displayed, and you can go to the
    new site and log in.


    ----- UPGRADING --------------------------------------------------------

    PLEASE NOTE:  Version 1.5.1 cannot be used to upgrade older versions
    earlier than 1.4.0.  If you are currently running a version older than
    1.4.0 you'll need to first upgrade to 1.4.0 (or 1.4.1 or 1.5.0) and
    then upgrade to 1.5.1.

    The process for upgrading an existing installation is identical to that
    for installing the software, except that the necessary information is
    gathered automatically from the old installation, rather than entered
    manually.


    ----- CONTACT INFORMATION ----------------------------------------------

    To report bugs, you can send e-mail to "CWISSupport@scout.wisc.edu".
    Please keep in mind that although we definitely want your feedback,
    CWIS is not a commercial product, and as such Scout does not have the
    resources to offer direct technical support.  The best route for CWIS
    support is to subscribe to the SPT/CWIS Users mailing list, at:
 
            http://scout.wisc.edu/mailman/listinfo/SPT-CWIS-Users

    and post your questions there.  The SPT/CWIS development team reads
    messages in that forum, and will answer questions there as time permits.


    Thanks for taking the time to read through this!

