Chapter 2 - Getting started

2.1 - System requirements

Please make sure that you have the following software and resources available before you begin installation.

Obviously, all the WebMail/2 components require TCP/IP, and all of them must be able to communicate with each other. If they are running on the same machine and you can communicate on the Internet, you will be fine.

Please note that certain security devices such as firewalls may make it impossible for communications to or from the WebManager to reach their destination, especially in multi-server configurations. Such configurations are beyond the scope of this document. Please see your network administrator if you suspect that you may have such a problem.

2.1.1 - Web server

Any OS/2 webserver which can execute rexx CGI scripts, supports cookies, the HTTP/1.1 and CGI/1.1 protocols. WebMail/2 has been tested with the following web servers:

Web server URL

Apache for OS/2

www.apache.org

Web/2

www.dink.org

Lotus Domino Go Webserver

Provided with OS/2 Warp
Server for e-business (and ACP)

InetPowerServer for OS/2

www.InetPowerServer.com

IBM EWS GoServe with
SRE-http filter

(no URL)

Xitami for OS/2

www.imatix.com(read NOTE)

NOTE: Xitami is now fully supported. All problems have been addressed in the latest versions of WebMail/2 and Xitami (2.5b).

2.1.2 - E-mail server

Any POP3/SMTP email server. Again, the e-mail server does not need to run under OS/2, but the supported OS/2 email servers have some advantages over other servers: On advanced configurations of WebMail/2, a New User Registration feature which allows users to apply for an email account. Authentication is also faster with OS/2 supported email servers, because WebMail/2 reads the user configuration directly from the email server without any TCP/IP communication.

Email server URL

Weasel

Weasel Home Page

Inet.Mail

Hethmon Brothers

Inet.Mail Pro

Hethmon Brothers

InetPowerServer

IPS Home Page

IBM OS2PopS

OS2PopS Home Page

ZxMail

Zeryx Home Page

Genetic POP3

Any POP3-type email server (RFC1939).

2.1.3 - WebMail/2

WebMail/2 in general runs on OS/2 Warp 3 or better. It can will on either the web server machine or the e-mail server or independently, depending on your configuration.

In addition, WebManager, which is the daemon service of WebMail/2 requires VROBJ.DLL. This is available from: vrobj21d.zip.

Make sure you have this DLL file when you install WebMail/2. You may place it anywhere in your LIBPATH, or in the current directory of WebMail/2.

Depending on your version of OS/2 and the installed fixpacks, you may be required to install the latest MPTS/TCPIP fixpack. It includes a version of rxsock.dll that doesn't have a bug which prevents ObjectRexx from using some TCP/IP functions.