Installation and Setup

The file you download comes with an installer that will automatically install dnotice. If you require clarification reguarding the questions the installer asks, please refer to the sections below, named 'intallation using installer'. If you do not wish to use the installer, instructions for installing by hand are provided under the 'manual installation' sections.

If you have any questions or problems please EMail: support-dnotice@netwinsite.com

Contents



NT Installation Using Installer

Download the self extracting archive from netwinsite "dnoticeXX.exe", then execute it. It is a self extracting zip file and will extract and automatically execute the installation program "install.exe", if this does not happen please contact support-dnotice@netwinsite.com. Follow the onscreen instructions and answer the questions (read below if you are unsure how to answer). The installer will then proceed to copy the dbanner files and installation is complete.

Answering Installer Questions:

CGI directory:

The DNotice CGI needs to be placed in a directory where it is visable to your webserver. Normally a server will have a special directory for storing CGI's. If you are unsure of how to setup a CGI program you should read your webserver documentation or consult the system administrator. Typically the CGI directory will be called something similar to:
SERVER_ROOT\cgi-bin
or c:\inetpub\scripts
or "FrontPage Webs\Content\cgi-bin"
HTML directory:
The image files associated with DNotice need to be place in the home directory of the webserver.


Install Directory:

This can be any directory on your machine for DNotice to use as a work area. Ideally this will be a new directory that is not used for anything else. If the directory you specify doesn't exist it will be created for you.
SMTP host name/ip:
The name or ip number of your mail server. If you are unsure of your mail servers name and use a mail client e.g Eudora, Pegasus Mail, Outlook Express etc, your out going mailserver's name may be found in one of the options or properties menus of the mail client under the name of smtp host,smtp server,outgoing mail server or something similar.
To test the installation you use a web browser. Enter a url like:
    http://www.domain.com/dnotice.exe   or
    http://www.domain.com/scripts/dnotice.exe      (replacing www.domain.com with your domain name)

Manual NT Installation

If you want to handle the installation manually use the following instructions:

The DNotice CGI needs to be placed in a directory where it is visable to your webserver. Normally a server will have a special directory for storing CGI's. If you are unsure of how to setup a CGI program you should read your webserver documentation or consult the system administrator. Typically the CGI directory will be called something similar to:

SERVER_ROOT\cgi-bin
or c:\inetpub\scripts
or "FrontPage Webs\Content\cgi-bin"
You also need to copy all other files to one particular directory on your system, it can be anywhere as long as you define the workarea variable in dnotice.ini to point to the same place. Note: This directory should not be in the web-pages tree as direct access tp the work areacould be a security risk.

Example:

download the self extracting archive from netwinsite to a temp directory ie \dnoticetmp
dnotice.exe            # Unzip the self extracting archive to cwtemp
cd \dnoticetmp       # Change to temporary unpack directory
mkdir \dnotice              # Create a directory for templates and workarea
copy .\tpl\* \dnotice      # Copy docs templates etc to destination
copy .\img\*.gif  \inetpub\wwwroot              # Copy image files
copy .\scripts\dnotice.exe \inetpub\scripts     # Copy cgi
copy .\scripts\dnotice.ini \inetpub\scripts     # Copy ini file (this must always be in same directory as dnotice.exe)
del  \dnoticetmp                        # Remove temp files


Now edit dnotice.ini and define values for the settings shown below:
 

Name Example Explanation
mailserver mail.your.domain  The name/ip of your mail server
templates /dnotice  Directory where you have copied the template files
mailerpath    Path to mailer executable, if blank the template path is used
workarea   Path to workarea, if blank a subdirectory off the templates directory will be created

Unix Installation Using Installer

Download the archive from netwinsite "dnoticeXX_<operating_system>.tar.Z", or "dnoticeXX_<operating_system>.tar.gz". To extract this archive create a temporary unpack directory and use uncompress and tar (or gzip), see below for an example:
mkdir dbtemp
uncompress dnotice10_linux.tar.Z
tar -xvf dntoce10_linux.tar.Z dnoticetmp
The archive should now have be extracted into the dnoticetmp directory, this directory should contain an installation program "install.exe", to install DBanner execute it and follow the onscreen instructions and answer the questions (read below if you are unsure how to answer). The installer will then proceed to copy the dbanner files and installation is complete.

Answering Installer Questions:

CGI directory:
The DNotice CGI needs to be placed in a directory where it is visable to your webserver. Normally a server will have a special directory for storing CGI's. If you are unsure of how to setup a CGI program you should read your webserver documentation or consult the system administrator. Typically the CGI directory will be called something similar to:
SERVER_ROOT/cgi-bin or
/home/httpd/cgi-bin
HTML directory:
The image files associated with DNotice need to be place in the home directory of the webserver.
Install Directory:
This can be any directory on your machine for DNotice to use as a work area. Ideally this will be a new directory that is not used for anything else. If the directory you specify doesn't exist it will be created for you.
SMTP host name/ip:
The name or ip number of your mail server. If you are unsure of your mail servers name and use a mail client
your out going mailserver's name may be found in one of the options or properties menus of the mail client under
the name of smtp host,smtp server,outgoing mail server or something similar.
To test the installation you use a web browser. Enter a url like:
    http://www.domain.com/dnotice.cgi    or
    http://www.domain.com/cgi-bin/dnotice.cgi  (replacing www.domain.com with your domain name)

Manual Unix Installation

The DNotice CGI needs to be placed in a directory where it is visable to your webserver. Normally a server will have a special directory for storing CGI's. If you are unsure of how to setup a CGI program you should read your webserver documentation or consult the system administrator. Typically the CGI directory will be called something similar to:
SERVER_ROOT/cgi-bin or
/home/httpd/cgi-bin
You also need to copy all other files to one particular directory on your system, it can be anywhere as long as you define the workarea variable in dnotice.ini to point to the same place. Note: This directory should not be in the web-pages tree as direct access to the work area could be a security risk.

Example:

download the distribution set from netwinsite to a temp directory ie /dnoticetmp
uncompress dnotice10.tar          # Uncompress tar file
tar -xvf dnotice10.tar            # Extract distribution to dnotice sub-directory
cd /dnoticetmp                    # Change to temporary dnotice sub-directory

mkdir /var/spool/dnotice                 # Create a directory for template and workarea.
chown nobody /var/spool/dnotice          # Set appropriate ownership
cp -i ./tpl/* /var/spool/dnotice         # Copy template files over
cp -i ./img/*.gif /home/httpd/           # Copy image files over
cp ./scripts/dnotice.cgi /home/httpd/cgi-bin       # Copy cgi
cp -i ./scripts/dnotice.ini /home/httpd/cgi-bin    # Copy ini file
rm -r -f ../dnotice                      # Remove temp files
Note:  .ini must be place in the same directory as the .cgi file

Now edit dnotice.ini and define values for the settings shown below:
 
Name Example Explanation
mailserver mail.your.domain  The name/ip of your mail server
templates /dnotice  Directory where you have copied the template files
mailerpath    Path to mailer executable, if blank the template path is used
workarea   Path to workarea, if blank a subdirectory off the templates directory will be created

INI Settings

If you wish to change the directory DNotice uses as a workarea, or you would like to use a different mailserver, you must manually edit your the file called 'dnotice.ini'. Your ini file will be found in your webservers script directory. This is the same directory as the dnotice cgi resides. The dnotice cgi will typically be called 'dnotice.exe' on a windows platform or 'dnotice.cgi' on a unix machine.

Once the file has been located you can open it in any text editing program and change any of the following variables. When you save your new setting be sure that it is saved as type 'text' if your text editor has the option to do so. Making a backup of your ini file before editing can be useful if the new ini file turns out to be less than functional.

Name Example Explanation
mailserver mail.your.domain  The name/ip of your mail server
templates /dnotice  Directory where you have copied the template files
mailerpath    Path to mailer executable, if blank the template path is used
workarea   Path to workarea, if blank a subdirectory off the templates directory will be created