CWMail Installation and Upgrade instructions

Contents:
1. NT Installation Instructions
2. Unix Installation Instructions

See the web page cwmail.htm for more detailed information.

1. NT Installation:
-------------------
The self_extracting archive you have downloaded will normally 
run wmsetup once it has unpacked the files to a temporary directory. 
All you need to do is answer the questions to complete the installation.
If you want to handle the installation manually use the following instructions:

You must install CWMail on your WEB server, in a 
directory that you have already setup on your server 
as containing CGI programs, you should read your 
server documentation if you don't currently know 
how to setup a cgi program, typically you would 
copy the files to a directory like: 

	"\FrontPage Webs\Content\cgi-bin"
	or c:\inetpub\scripts
        or \SERVER_ROOT\cgi-bin

And you also need to copy all the template files to a 
directory on your system, it can be anywhere as long 
as you define the templates variable in cwmail.ini 
to point to the same place.
Note: By default the dmailweb user files are stored below the template directory. Therefore the template directory should not be in the web-pages tree as direct access to user files could be a security risk.

If you plan to customize the template files (most people do :-) then you should probably keep a copy of the original set so that you can later compare them with future releases. This may save you much effort when adding  new features into your customized set.

Example:
    download the self extracting archive from netwinsite
    cwmail10.exe          # Unzip the self extracting archive to cwtemp
    cd \cwtemp            # Change to temporary unpack directory
 
    mkdir \cwmail         # Create a directory for templates
    mkdir \inetpub\wwwroot\nwimg # Create a dircectory for sound files
    copy * \cwmail        # Copy docs templates etc to destination
    copy *.wav \inetpub\wwwroot\nwimg        # Copy sound files
    copy *.gif \inetpub\wwwroot\nwimg        # Copy image files
    copy *.jpg \inetpub\wwwroot\nwimg        # Copy image files
    copy cwmail.exe "\inetpub\scripts"   # Copy cgi 
    copy cwmail.ini "\inetpub\scripts"   # Copy ini 
    del  \cwtemp         # Clean out temporary directory
Note: .ini must be with .exe

Now edit cwmail.ini with a command like
notepad "\inetpub\scripts\cwmail.ini"

Make sure you define the following four things for your site
	pophost       pop.your.domain
	templates     \cwmail
	smtphost      mail.your.domain
	domain        your.domain

Now try referencing CWMail from any web browser using the url

     http://your.web.server/cgi-bin/cwmail.exe

See cwmail.htm for more detailed help and please dont hesitate
to contact support@netwinsite.com if you have problems
installing or configuring CWMail.

2. Unix Installation:
---------------------

Normally you just download the distribution set uncompress and untar it
and then run the installation setup wizard wmsetup. For example
    download the distribution set from netwinsite to a temp directory
    uncompress cwmail10.tar          # Uncompress tar file
    tar -xvf cwmail10.tar            # Extract distribuition files to cwmail sub-directory
    cd cwmail                        # Change to temporary cwmail sub-directory
    ./wmsetup                        # Run setup wizard
Then just answer the questions to complete the installation. If you want
to perform the installation by hand rather than using the setup wizard 
use the following instructions:
installation 
The self_extracting archive you have downloaded will normally 
run wmsetup once it has unpacked the files to a temporary directory. 
All you need to do is answer the questions to complete the installation.
If you want to handle the installation manually use the following instructions:

You must install CWMail on your WEB server, in a 
directory that you have already setup on your server 
as containing CGI programs, you should read your 
server documentation if you don't currently know 
how to setup a cgi program, typically you would 
copy the files to a directory like: 

        SERVER_ROOT/cgi-bin       
	where SERVER_ROOT is something like
        /home/httpd   or    /var/lib/httpd

And you also need to copy all the template files to a 
directory on your system, it can be anywhere as long 
as you define the templates variable in cwmail.ini 
to point to the same place. 
Remember to set the correct ownership on these files.
Note: By default the dmailweb user files are stored below the template directory. Therefore the template directory should not be in the web-pages tree as direct access to user files could be a security risk.

If you plan to customize the template files (most people do :-) then you should probably keep a copy of the original set so that you can later compare them with future releases. This may save you much effort when adding  new features into your customized set.

If your web server is in /home/httpd
then the command file install.sh supplied will do the
installation or upgrade for you. Note it will not overwrite 
templates or the ini file in case you already have modified ones.

Example:
    download the distribution set from netwinsite to a temp directory
    uncompress cwmail10.tar          # Uncompress tar file
    tar -xvf cwmail10.tar            # Extract distribuition files to cwmail sub-directory
    cd cwmail                        # Change to temporary cwmail sub-directory

    mkdir /var/spool/cwmail                    # Create a directory for template files etc.
    mkdir /home/http/html/nwimg                # Create a nwimg directory
    chown nobody /var/spool/cwmail             # Set appropriate ownership
    cp -i ./tpl/* /var/spool/cwmail            # Copy template files over
    cp -i ./tpl/*.wav /home/httpd/html/nwimg   # Copy sound files
    cp -i ./tpl/*.gif /home/httpd/html/nwimg   # Copy image files
    cp -i ./tpl/*.jpg /home/httpd/html/nwimg   # Copy image files
    cp cwmail.cgi /home/httpd/cgi-bin          # Copy cgi
    cp -i cwmail.ini /home/httpd/cgi-bin       # Copy ini file  
    rm -r -f ../cwmail                         # Delete temporary files
Note:  .ini must be with .cgi 


Now edit cwmail.ini with a command like
    vi /home/httpd/cgi-bin/cwmail.ini

Make sure you define the following four things for your site with lines like:
	pophost       pop.your.domain
	templates     /var/spool/cwmail
	smtphost      mail.your.domain
	domain        your.domain

Now try referencing CWMail from any web browser using the following URL.

     http://your.web.server/cgi-bin/cwmail.cgi

See cwmail.htm for more detailed help and please dont hesitate
to contact support-cwmail@netwinsite.com if you have problems
installing or configuring CWMail.

