Chapter 3 - Installation

3.1 - First steps

In this section, you will install a set of components that make up WebMail/2. It assumes that your e-mail and web servers are already installed and configured. If you do not have these servers installed already, then you may continue with installation of WebMail/2 but you will not be able to use WebMail/2 untill your web and email servers are working.

There are several steps you must perform, and these steps vary based on your configruation, particularly whether you are using one or more servers and if you are going to use automatic or manual installation. The following instructions are for a single-server installation. Following this will be notes regarding changes that would need to be made for a multi-server configuration. These instructions are not step-by-step. It is assumed that if you have a multi-server configuration you are savvy enough to apply the provided information toward your unique configuration.

Before we begin the installation of WebMail/2, we need to make sure that your computer's loopback interface is configured. This is a special interface that allows programs running on the same machine to easily talk to each other. From an OS/2 command prompt, type:

PING 127.0.0.1 32 5

If you do not see a response similar to the following:

40 bytes from 127.0.0.1: icmp_seq=0. time=0. ms

you will need to add loopback support to your computer. To do this, edit "x:\MTPN\BIN\SETUP.CMD" , where x: is the drive where OS/2 is located. Add the following line immediately above the first line that begins with "ifconfig":

ifconfig lo 127.0.0.1

Save and exit. You can then either reboot your computer or re-type the ifconfig line directly within an OS/2 command prompt. Retest with the above PING statement and make sure that you now get the proper response.

3.2 - Automatic install

Automatic installation of WebMail/2. Unzip the WebMail/2 distribution archive and execute the installation script, install.cmd.

The installation script will ask a few questions about your system. The installation will also create an install.log file in your WebManager directory which containts the answers to those questions, so in case of an upgrade the installation will use them instead of asking you the same questions again.

The installation script can be used for both single and multiple server systems. In case of a multiple server system or a system where the web server is not on the same machine as the WebManager, you are required to install some parts of WebMail/2 manually.

3.3 - Manual install

Manual installation of WebMail/2. These instructions assume that you know your web server's CGI-BIN and HTML directories, and that you will be installing WebMail/2 to "D:\WebMail2". If you wish to install it to a different location, just substitue whatever path you want when you see "D:\WebMail2".

Unzip the WebMail/2 archive into D:\WebMail2. You will find several zip files. Bellow you will find the instructions how to install each zip file.

3.3.1 - cgi.zip

Unzip CGI.ZIP into your web servers' CGI-BIN directory. This file will contain only one file: webmail2.cmd. You have two options now, either set a few environment variables, or edit the webmail2.cmd script yourself to enter the proper settings.

Option 1:
Set the following environment variables:

Variable Parameter Description

WEBMAIL2_SERV

127.0.0.1

IP address of the machine running the WebManager

WEBMAIL2_PORT

1924

Port that WebManager listens to

WEBMAIL2_PATH

(undefined)

Path to .WM files. If undefined then default is %etc%\webmailhtml\
Note the trailing slash.

WEBMAIL2_MAXE

10

Maximum emails listed per page

WEBMAIL2_CHARSET

iso-8859-1

Default character set

WEBMAIL2_MAXSIZE

2097152

Maximum size of file attachements in bytes

Option 2:
This file may need to be edited to work with your configuration. From an OS/2 Window, type:

E <web server CGI-BIN path>\WebMail2.CMD

Look for the following lines:

Globals.!serv=127.0.0.1
Globals.!port=1924

The first line is the IP address of the machine running the Webmanager. If you are using a single system configuration this does not need to be changed. Also, if port 1924 is used on your computer, you can change it with the Globals.!port line. This should not be necessary, however. Please note that only IP addresses can be used. Hostnames are not allowed.

Now, look for the following lines:

Globals.!WMPath=""

Between the quotes add D:\WebMail2\HTML\, please note the trailing slash. The line should look like this:

Globals.!WMPath="D:\WebMail2\HTML\"

Look for the following line: Globals.!MaxEmails=10
The number specifies the maximum number of emails per screen.

The last option is the character set: Globals.!CharSet="iso-8859-1"
Change this if you want another default character set. WebMail/2 will change this setting automatically for emails which have the proper character setting.

Save and close the file.

3.3.2 - webmailhtml.zip

Create the directory "HTML" under "D:\WebMail2". Unzip WebMailHTML.ZIP into this directory. This will extract a series of .WM files that will be accessed by the WebMail2.CMD CGI script. This directory must be accessible from the WebMail/2 CGI script, webmail2.cmd.

3.3.3 - webmailimages.zip

Create the directory "webmailimages" under your web server's HTML directory and unzip WebMailImages.ZIP into this directory.

The .wm files from webmailhtml.zip use these image files. The path is hard-coded within these files as "/webmailimages". If you wish to change this path you will need to modify the .wm files in D:\WebMail2\HTML to reflect this.

Alternatively, you can create an alias of /webmailimages/ and make it point to a different physical directory that suits your needs. This is beyond the scope of this document, however. See your web server's documentation regarding aliases.

3.3.4 - dll.zip

Under "D:\WebMail2", create a directory called "DLL". In it, extract DLL.ZIP. This will extract five files.

dcdll.dll, dcplus.dll, rxdcplus.dll: Required by the WebMail/2 CGI script. These files are required for all installations.

HRxPass.dll: Required if you use the Inet.Mail email server for OS/2. It should exist at the same machine as your Inet.Mail installation.

HRxPassPro.dll: Required if you se Inet.Mail Pro email server for OS/2. It should exist in the same machine as your Inet.Mail Pro installation. Rename it to HRxPass.dll first before using it. This file has been renamed so as not to conflict with the above dll for Inet.Mail non-pro version.

ipsrexx.dll: Required if you use the InetPowerServer email server for OS/2. It should exist at the same machine as your IPS installation.

You may delete any DLLs that are not required by your configuration. Once the files are extracted, you may copy them to a path which exists in your LIBPATH, or you can edit your CONFIG.SYS and add the following to the end of the LIBPATH statement (add a semicolon if your existing LIBPATH statement does not end in one):

D:\WebMail2\DLL;

3.3.5 - webmanager.zip

Under "D:\WebMail2" create a directory called "WebManager". Unzip WEBMANAGER.ZIP into that directory. This will extract the required files for WebManager and the setup program. You will also need to unzip the file from: ftp://hobbes.nmsu.edu/pub/os2/dev/rexx/vrobj21d.zip This will extract three files. The only one you need is VROBJ.DLL; the others can be deleted if you wish.

Now that the files are extracted, WebManager is not yet ready to run. First you must run the setup.exe to set your system-specific values.

Start the Setup program, either by double-clicking on the Setup icon (the icon is created by the installer) or running "D:\WebMail2\WebManager\setup.exe". The Setup will set the default values the first time you start it. You will then get the main settings screen. To the left, you will see a list of sections, and to the right you will see the data for each of those sections.

For detailed information please read Chapter 4.2 - WebManager Settings