home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / wbmail10.zip / read.me < prev    next >
Text File  |  2000-11-02  |  6KB  |  177 lines
  1.  
  2.                             WebMail/2 - READ.ME
  3.                             -------------------
  4.  
  5. Welcome to WebMail/2.
  6.  
  7. This file contains information you need to install WebMail/2.
  8.  
  9. This README file is divided into the following categories:
  10.    -  Before You Install WebMail/2
  11.        -Software Requirements
  12.        -Hardware Requirements
  13.    -  Getting Help
  14.    -  Installing WebMail/2
  15.    -  Late-Breaking News
  16.  
  17.  
  18. Before You Install WebMail/2
  19. ----------------------------
  20.    Software Requirements
  21.    ---------------------
  22.     WebMail CGI
  23.     -----------
  24.      Any OS/2 webserver which can execute rexx CGI scripts.
  25.  
  26.     WebManager
  27.     ----------
  28.      OS/2 Warp 3 or better.
  29.      VROBJ.DLL: ftp://hobbes.nmsu.edu/pub/os2/dev/rexx/vrobj21d.zip
  30.  
  31.     An email server
  32.     ---------------
  33.      Any POP3/SMTP email server. Then dont need to run under OS/2,
  34.      but the supported OS/2 email servers have some advantages.
  35.  
  36.    Hardware Requirements
  37.    ---------------------
  38.      A computer capable of running OS/2.
  39.  
  40.  
  41. Getting Help
  42. ------------
  43. Please contact the author of WebMail/2:
  44.  
  45. Author: Dimitris 'sehh' Michelinakis
  46. Email : sehh@altered.com
  47.  
  48.  
  49. Installing WebMail/2
  50. --------------------
  51. unzip each file to the correct place:
  52.  
  53.  cgi.zip
  54.  -------
  55.  Place: Unzip in your /cgi-bin directory
  56.  
  57.  Then edit webmail2.cmd and change the lines at the top, which define
  58.  the ip and port of the authentication daemon, or your own authentication
  59.  method. Make sure you only use IP addresses, not hostnames!
  60.  
  61.  You shouldn't need to change anything else, unless you want to change
  62.  the way the CGI procedures work.
  63.  
  64.  
  65.  webmailhtml.zip
  66.  ---------------
  67.  Place: In the path you specified in the CGI, or under %etc%\webmailhtml
  68.  if you didn't define a directory.
  69.  
  70.  Edit the .wm files, and change them to suit your needs. They are
  71.  just examples for testing WebMail/2. The default directory placement
  72.  is under %etc%\webmailhtml
  73.  
  74.  NOTICE: Some .wm files don't use the header.wm/footer.wm, like the
  75.  user login.
  76.  
  77.  The .wm files can be anything. In them you define variables which
  78.  the CGI script parses before send it the output to the client.
  79.  
  80.  
  81.  webmailimages.zip
  82.  -----------------
  83.  Place: under /webmailimages/ in your web server html dir.
  84.  
  85.  You can change it, but you'll need to modify the .wm files first.
  86.  
  87.  Its a good idea to create an alias of /webmailimages/ and make it
  88.  point to a place that suits your needs.
  89.  
  90.  
  91.  dll.zip
  92.  -------
  93.  Place: Put those dlls somewhere in your LIBPATH or the currect directory
  94.  that WebManager runs from.
  95.  
  96.  Those dlls are needed only if you user IPS or Inet.Mail/Inet.MailPro.
  97.  
  98.  
  99.  webmanager.zip
  100.  --------------
  101.  Place: Unzip and place anywhere you like.
  102.  
  103.  This is the daemon, make sure you configure all the options. Please only
  104.  use IP addresses and not hostnames.
  105.  
  106.   Status page
  107.   -----------
  108.   This page has some statistics and debug information.
  109.   
  110.   Users page
  111.   ----------
  112.   This page allows you to add/remove users when using the Internal
  113.   user database authentication. In all other cases its not needed.
  114.  
  115.   Settings page 1
  116.   ---------------
  117.    Section 1
  118.    ---------
  119.    Here you define the port that webmanager listens to, the inactivity
  120.    timeout that passes before users are automatically logged off, and
  121.    user refresh time which defines every how long to check for the
  122.    existance of the file 'refresh.usr' in the current directory. If a
  123.    file with that name exists, then webmanager will refresh the user
  124.    database from the POP3 server. This is only used for the supported
  125.    OS/2 email servers.
  126.    
  127.    Section 2
  128.    ---------
  129.    Define the IP addresses and the ports of the POP3 and SMTP servers.
  130.    
  131.    Section 3
  132.    ---------
  133.    Choose the user database that WebManager uses to authenticate the
  134.    users. If you have one of the OS/2 supported email servers then
  135.    chooce the appropriate one, else either choose Internal Users or
  136.    Generic POP3. The internal users database is a user/password list
  137.    that WebManager keeps, the Generic POP3 makes the WebManager to
  138.    login to the POP3 server to authenticate the user before allowing
  139.    connections from webmail2.cmd.
  140.   
  141.   Settings page 2
  142.   ---------------
  143.   If you enable the alert program, then if a number of failed authentication
  144.   attempts is reached then the defined program is executed.
  145.   
  146.   Access page
  147.   -----------
  148.    Section 1
  149.    ---------
  150.    Add the IP addresses of your webservers which run webmail2.cmd and
  151.    are allowed to access your webmanager for authentication. You can
  152.    also use this notation to define ranges of IPs:
  153.     10.10.10.0, would allow from 10.10.10.1 to 10.10.10.xxx
  154.     192.64.0.0, would allow from 192.64.1.1 to 192.64.xxx.xxx etc.
  155.    We suggest you define individual IP's for security reasons.
  156.    
  157.    Section 2
  158.    ---------
  159.    Add the IP addresses of the clients (web browsers) who are allowed
  160.    to access the webmail2.cmd. You can also use this notation to define
  161.    ranges of IPs:
  162.     10.10.10.0, would allow from 10.10.10.1 to 10.10.10.xxx
  163.     192.64.0.0, would allow from 192.64.1.1 to 192.64.xxx.xxx etc.
  164.     0.0.0.0, would allow ALL ip's.
  165.  
  166.  
  167. Late-Breaking News
  168. ------------------
  169. There are a few issues that you have to keep in mind:
  170. 1) Webmail/2 won't detect a locked email account correctly.
  171. 2) TCPIP timeouts are not reported, you just get a 'no data' error.
  172. 3) The refresh.usr is not deleted after WebManager has finished
  173. the user database refresh.
  174. 4) Uploading a file bigger than 100kb will take a very long time to
  175. convert to MIME encoding.
  176.  
  177.