Distribution file for current release of Collection Workflow Integration System (CWIS):
(You may need to shift-click on the link or right-click on the link and choose Save to get your browser to download the file correctly.)

CWIS 2.2.3 requires a web server with PHP 5.0.5 and MySQL 5.0 or later. PHP must be installed with MySQL and GD support.

CWIS is currently being developed with Apache 2.2.3, PHP 5.2.10, and MySQL 5.0.77 on Red Hat Linux and OS X. It should work with earlier version of Apache, but these specific versions (or later versions) of Apache, PHP, and MySQL are recommended.

Before beginning installation of the CWIS, you should have these 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.

Once you have the above information and have downloaded the CWIS distribution file (CWIS-2.2.3.zip), unpack that file, upload the unpacked files and directories to your web server, and make sure that the directory structure inside the zip file is preserved and that the directory you uploaded to and the following subdirectories under it are writable by the web server:

After you have the files uploaded and directories writable, begin the install by using your web browser to go to the URL:

where http://mysite.com is the base address of the new CWIS site on 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 will be displayed, and you can go to the new site and log in with the user name and password you specified on the installation page.

CWIS 2.2.3 can be used to upgrade sites running CWIS or SPT 1.4.0 or later. If you are running an earlier version of CWIS or SPT you'll need to first upgrade to 1.4.0 (available below) and then to 2.2.3.

When upgrading a live site, please first back up your CWIS directory and database if at all possible. Significant effort is made to test each version before it is released, but web server environments vary widely and it's good to have a backup copy in case of difficulty.

To upgrade, download the CWIS distribution file (CWIS-2.2.3.zip), unpack that file, and upload the unpacked files and directories to the CWIS directory on your web server, overwriting the existing files from the previous CWIS version.

After you have the files uploaded, run the upgrade by using your web browser to go to the URL:

where http://mysite.com is the base address of the existing CWIS site on your web server. This should bring up a web page titled CWIS Installation and begin the upgrade process

If everything checks out, the upgrade should take less than 30 seconds, after which a link to your new CWIS site will be displayed, and you can go to the new site and log in.

If you want to make sure that the file downloaded correctly, the MD5 checksum values for the files (obtainable on OS X systems with the md5 command, and on most Linux systems with the md5sum command) are as follows:

If you're not sure how to use the md5 or md5sum command, please consult your system administrator or local OS X or Linux guru. Thanks for your interest in CWIS. We're eagerly looking forward to your feedback!

These past versions of CWIS are presented for reference only — they are not recommended for production use or on a live web site.

(CWIS version numbering jumped from 1.1.1 to 1.3.0 to sychronize it with SPT version numbers.)

If you are running a version of CWIS or SPT earlier than 1.4.0, you'll need to first upgrade to 1.4.0 and then to the latest version of CWIS. These instructions are for upgrading a pre-1.4.0 installation to 1.4.0.

Please note that upgrading to 1.4.0 requires a shell (command line) login to your web server (as did installing pre-1.4.0 versions).

Once you have downloaded the two CWIS distribution files (cwisinstall-1.4.0 and cwis-1.4.0.tgz, available above), place those files in a directory on your web server and begin the installation with the command:

(Note: After downloading the distribution files you may need to make the install script executable with the command: chmod a+x cwisinstall* If you're not sure what this command means, try the preceding command to start the installation and consult your system administrator if you get an error message like "Permission denied.")

The install script will print out various progress messages, and then direct you to a web page where you can complete the installation.