
                          Zwap INSTALLATION
                          =================

For a short description of the Zwap project see the file README.

We'd be very interested in your comments and feedbacks. 
Please contact: feedback@zwap.de or preferably use the 
discussion forum at http://www.zwap.de. 


Requirements
------------

- HTTP-Server 

  To run the CGI-scripts you have to install an HTTP-Server.
  We have tested the scripts with the Apache 1.3 HTTP server.
  For more information on the Apache Web server see http://www.apache.org/.

- Perl 5 Interpreter

  The CGI-scritps are written in the scripting language Perl. We have tested 
  the perl scripts with the perl interpreter version 5.005. Other perl
  5 versions should work also. For more information on the perl
  scripting language see: http://www.cpan.org/
  
- Disk Space

  Make sure you have approximately 0.5 MB of free disk space
  available. This amount is needed for the CGI-scripts and the static
  HTML- and WML-Code. In accordance to the number of users you may
  support you have to plan corresponding disk space for the user data
  which will be stored in the database files (see directory zwap/databases).
 


Installation
------------

- Install the Apache HTTP Server. 

- Make sure that the Web server delivers the correct MIME-Type with
  the HTTP-Header Content-Type. For the Apache HTTP Server version
  1.3.12 or higher nothing has to be configured. For older version 
  modify the file mime.types (directory conf). The following entries
  are needed:

  text/vnd.wap.wml
  application/vnd.wap.wmlc 
  image/vnd.wap.wbmp 
  application/vnd.wap.wbxml
  text/vnd.wap.wmlscript
  application/vnd.wap.wmlscriptc

- To run the CGI-scripts add the entry "AddHandler cgi-script .pl" to
  the apache file httpd.conf. 

- The Zwap-Distribution comes as compressed tar archive. Open the 
  file Zwap-<version>.tgz with the command "tar xvzf Zwap-<version>.tgz"
  to copy the files to the document root directory of your Web server.
  The document root directory of the Apache is called htdocs if the server
  is configured with the defaults.

- The zwap scripts need additional perl modules. These perl modules
  are often already installed if you use a standard linux distribution. 
  Is a needed module in your distribution absent you can download it from  
  a CPAN archive (e.g. http://www.cpan.org) and install it manually or you
  install it with the commands: 

  perl -MCPAN -e shell
  install MODULE

- After the installation you should start the deamon sIDkiller.pl
  which is responsible for automatically killing a session after a time
  limit if a user was not correctly logged out. You can find the
  script sIDkiller.pl in the directory zwap/session. The script sIDd.pl in 
  the same directory can be used by an administrator to manage user sessions. 
 
Thanks for running Zwap.

The Zwap Group
http://www.zwap.de/
