DMAILWEB Installation and Upgrade instructions

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

See the web page dmailweb.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 DMailWeb 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 \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 dmailweb.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
    dmweb10.exe          # Unzip the self extracting archive into tempdir
    cd \dmtemp           # Change to temporary unpack directory
 
    mkdir \dmweb         # Create a directory for templates
    copy * \dmweb        # Copy docs templates etc to destination
    mkdir \inetpub\wwwroot\nwimg # Create a dircectory for sound files
    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 dmailweb.exe "\inetpub\scripts"     # Copy cgi 
    copy dmailweb.ini "\inetpub\scripts"     # Copy ini 
    del  \dmtemp         # Remove temp files
Note: .ini must be with .exe

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

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

Now try referencing dmailweb from any web browser using the url

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

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

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 dmweb10_linux.tar     # Uncompress tar file
    tar -xvf dmweb10_linux.tar       # Extract distribuition files to cwmail sub-directory
    cd dmisp                         # 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:

You must install DMailWeb 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 dmailweb.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 temp directory
    uncompress dmweb10.tar    # Uncompress tar file
    tar -xvf dmweb10.tar      # Extract distribuition files to dmisp sub-directory
    cd dmisp                  # Change to temporary dmisp sub-directory

    mkdir /var/spool/dmweb                   # Create a directory for template files etc.
    mkdir /home/httpd/html/nwimg             # Create a nwimg directory
    chown nobody /var/spool/dmweb            # Set appropriate ownership
    cp -i ./tpl/* /var/spool/dmweb           # 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 * /var/spool/dmweb                    # Copy docs etc.
    cp dmailweb.cgi /home/httpd/cgi-bin      # Copy cgi
    cp -i dmailweb.ini /home/httpd/cgi-bin   # Copy ini file  
    rm -r -f ../dmisp                        # Remove temp files
Note:  .ini must be with .cgi 


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

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

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

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

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

