Chapter 3 - Installation

3.1 - First steps

In this section, you will install each of the 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, step-by-step instructions for installing and configuring certain servers are included in this documentation.

There are several steps you must perform, and these steps vary based on your configruation, particularly whether you are using one or more servers. 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 - WebMail/2 files

Now, we will begin the 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.2.1 - cgi.zip

Unzip CGI.ZIP into your web servers' CGI-BIN directory. This file will contain only one file: webmail2.cmd. 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, the line should look like this:

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

Save and close the file.

3.2.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.2.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.2.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.

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.2.5 - webmanager.zip

Under "D:\WebMail2" create a directory called "WebManager". Unzip WEBMANAGER.ZIP into that directory. This will extract a single file, WEBMANAGER.EXE. 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 ready to run. If you wish, you may create a program icon. If you want to use the Startup folder, this will be required. The Path and File name is "D:\WebMail2\WebManager\WebManager.EXE" and the Working Directory is "D:\WebMail2\WebManager". When finished, start the WebManager, either by double-clicking on the icon or running "D:\WebMail2\WebManager\WebManager.EXE". WebManager will set the default values the first time you start it. You will then get the main WebManager 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