Last Updated Wednesday September 6th, 2006
- What is the Collection Workflow Integration System (CWIS)? How much does it cost?
- What is required to run CWIS?
- I only have FTP access to my web server. Can I run CWIS?
- How much disk space is required for CWIS?
- Can I run CWIS on Windows 98/NT/ME/XP/2000?
- How well does CWIS scale?
- What documentation is available for CWIS?
- What technical support is available for CWIS?
- How do I customize the CWIS user interface?
- Will I lose my html customizations when I upgrade to a newer version of CWIS?
- Can I change the metadata fields or add my own fields for CWIS?
- Can records be added or revised at the same time that users are doing searches?
- What types of image files does CWIS support (GIF, JPEG, etc)?
- Is CWIS available in other (non-English) languages?
- Do I need root ("super user") access on the web server to install CWIS?
- What's the difference between CWIS and SPT (the Scout Portal Toolkit)?
- Why do I get a blank page when I try to do something?
- 1. What is the Collection Workflow Integration System (CWIS)? How much does it cost?
-
The Collection Workflow Integration System (CWIS) is a turnkey web-based software package designed to allow groups with collections of information to share that information with others via the World Wide Web and integrate that information into the National Science Digital Library (NSDL).
There is no charge for CWIS. CWIS is open source software that is licensed under the GPL (GNU General Public License). CWIS was developed by the Internet Scout Project under a grant from the National Science Foundation, as part of the National Science Digital Library (NSDL) initiative.
It is worth mentioning that, as currently licensed under the GPL, CWIS cannot be packaged or used as part of a commercial product. If you are interested in incorporating CWIS or making use of CWIS code as part of a commercial product, please contact the Internet Scout Project about possible licensing arrangements.
- 2. What is required to run CWIS?
To install and run CWIS you will need command-line (telnet or ssh) access to a Linux web server supporting (at minimum) PHP 4.0.6 and MySQL 3.23.29. CWIS has also been installed and is running successfully on Solaris and OS X servers. Red Hat Linux 7.3 (full installation) or later is the recommended environment for running CWIS.
- 3. I only have FTP access to my web server. Can I run CWIS?
At this time, command-line (telnet, ssh, or console) access is required to install CWIS. The command-line portion of the installation is very brief and self-explanatory, so you may be able to upload the package to your web server and ask the site administrator to run the command line portion for you.
- 4. How much disk space is required for CWIS?
The CWIS software itself requires less than 5 MB. Database storage requirements will, of course, vary with the number of resource records stored, but the disk usage is very modest by today's standards, since CWIS is primarily storing text-based metadata.
- 5. Can I run CWIS on Windows 98/NT/ME/XP/2000?
CWIS is designed to run in a Linux/Unix environment, and the CWIS install script will only run in that environment. However, some technically-adept users have managed, with significant effort, to get CWIS running under Windows. Scout does not support or recommend using Windows to run CWIS, and cannot provide assistance or information on doing so.
If you're still interested in trying to run CWIS under Windows despite all of that, your best bet is to join the SPT-CWIS-Users mailing list and post a query there, asking for info or recommendations from anyone that may have tried running CWIS under Windows.
- 6. How well does CWIS scale?
One of the CWIS development installations at Scout is normally loaded with 15,000 records and runs on a 500 MHz Celeron system (circa 1999), with no noticeable degradation in performance. The two CPU-intensive operations in CWIS are updating the search database and updating the recommender system (both of which are done when adding or editing records), and faster hardware may be desirable to ensure that those operations happen in a timely manner.
- 7. What documentation is available for CWIS? Is there an CWIS manual?
Documentation to support the management, customization, cataloging, and setup is incorporated into the Help pages within CWIS.
- 8. What technical support is available for CWIS?
The Internet Scout Project is a non-profit university research center, and as such we do not have the resources to provide corporate-level technical support, however we do try to track suggestions, bug reports, and other feedback, and generally support the user community. Comments and bug reports can be sent to the CWIS development team at cwissupport@scout.wisc.edu. Scout cannot offer ongoing technical support, answer in-depth customization questions, or assist in the resolution of server-related problems.
A mailing list is also available for discussion between CWIS users, and may be a good venue to post any questions you may have. You can subscribe to the CWIS users mailing list at http://scout.wisc.edu/mailman/listinfo/spt-cwis-users.
- 9. How do I change or customize the CWIS user interface?
There are two ways of changing or customizing the look and feel of a CWIS installation: through the "Theme" option in System Configuration, and by adding your own custom HTML code.
The "Current User Interface Theme" option in the System Configuration section allows you to select from one of an array of preconfigured "themes" (color and graphics combinations) to give your portal its own appearance.
To make more extensive changes to the CWIS interface you can add your own custom HTML code. (A guide to adding custom HTML in CWIS is forthcoming.)
- 10. Will I lose my HTML customizations when I upgrade to a newer version of CWIS?
CWIS is designed to preserve any customized HTML during upgrades, and will do so whenever possible. (For more information on how to insure that your HTML changes will be preserved, see the (forthcoming) customization guide.)
- 11. Can I change the metadata fields or add my own fields to CWIS?
Yes, the metadata field set in CWIS is easily modifiable and expandable by the portal administrator. Although CWIS is distributed with a metadata field set based on Dublin Core, implementers are fully expected to tweak and modify the schema to meet their needs.
- 12. Can records be added or revised at the same time that users are doing searches?
Yes, records can be added, modified, and deleted without interrupting use of the portal. You can even rebuild the entire search database without affecting users who may be running searches or asking for recommendations.
- 13. What types of image files does CWIS support (GIF, JPEG, etc)?
For image metadata fields (and the custom logo upload) the types of image files that CWIS supports is dependent on your web server environment. If you are running on a Linux server and do not have the PHP "safe_mode" option turned on, then CWIS should support GIF, JPEG, and PNG files. If you are running on a non-Linux server or a server with PHP safe_mode turned on, then which image types are supported will depend on what version of PHP you have. For versions of PHP that include release 1.6 or earlier of the GD library, GIF is supported but not PNG. For most newer versions, PNG is supported but not GIF. (GIF support has been dropped in newer versions because of patent issues.)
- 14. Is CWIS available in other (non-English) languages?
CWIS is only distributed with an English-language interface, although with some knowledge of HTML it would not be very difficult to create a non-English interface for the software.
- 15. Do I need root ("super user") access on the web server to install CWIS?
You do not need root access on your web server to install CWIS. CWIS can be installed using a regular user account, provided that you also have a MySQL database account to give CWIS to allow it to set up the CWIS database. (MySQL maintains its own login names and passwords, separate from those used to login to the Linux system.)
- 16. What's the difference between CWIS and SPT (the Scout Portal Toolkit)?
CWIS and SPT are both designed to help put collections of information on the web, but CWIS is being developed specifically for use by collections developers who want to integrate their work into NSDL (the National Science Digital Library). Specifically, CWIS comes pre-packaged with the nsdl_dc schema (set of metadata fields) and GEM subject taxonomy, includes reference links to various NSDL-related resources, and includes a set of user interface themes specifically intended for STEM (Science, Technology, Engineering, and Math) sites.
That said, there is no requirement that you take part in NSDL to use CWIS, but if you're developing any sort of STEM-related collection, it is strongly encouraged. Taking part in NSDL will bring wider exposure to your work and help encourage continued development of CWIS and other useful software.
- 17. Why do I get a blank page when I try to do something?
To aid in troubleshooting, you should make sure that PHP is setup to display errors. By default on some PHP installations setup for production use, error outputting is disabled. Turning on error outputting or making sure that it is turned on is the first step in figuring out what is setup wrong. To do this, you need to check with your site administrator to ensure that the "display_errors" variable in the php.ini configuration file is set to "On". This would also be a good time to check the "error_reporting" variable to make sure that no error messages are omitted out.
Typical problems that we've seen regarding blanks pages:
- PHP runs out of memory on big records and/or collections. To fix this, have your site administrator increase the "memory_limit" variable in the php.ini configuration file.
- OS X and PHP have a bug when resolving relative and symlinked paths. As a result, some files are called multiple times with functions such as require_once() which causes PHP to stop executing. The only current workaround is to make sure that all higher level directories in which your site is located have read and execute permissions. This seems like a bug, but it exists in both PHP4 and PHP5 installations on Mac OS X.
