Webmail Installation for Zeus Web Server

Preparation

Download and install the EMUMAIL package following the instructions provided by EMUMAIL. Due to the way that Emumail runs, we suggest that you make your Emumail installation directory one that you are happy for html pages to be served from. We will refer to this directory as $EMUHOME To configure Emumail to use FastCGI :-

1. In the $EMUHOME/html/ directory, make a symbolic link from emumail.cgi to emumail.fcgi
    
   ln -s emumail.cgi emumail.fcgi
    
2. Edit the following lines in $EMUHOME/data/site.emu to read as below
    
   use_fastcgi=true
   emu_url=emumail.fcgi

1. Make a copy of $ZEUSHOME/web/bin/fcgirunner.pl
    
   fcgirunner.pl fcgirunner.old.pl
    
2. Replace the following lines from the section entitled "# Create the fcgi child process and exit."
    
   Replace:
    
   setgrp( 0, 0 ) or die "setgrp( 0, 0 ): $!\n";
    
   exec ( @ARGV ) or die "exec( ".(join ", ", @ARGV )." ) failed: $!\n";
    
   With:
    
   setgrp( 0, 0 ) or die "setgrp( 0, 0 ): $!\n";
    
   my $children = 10;
      while( --$children ) {
         my $res = fork();
         ( $res >= 0 ) or die "fork: $!\n";
         if( $res == 0 ) {
         exec( @ARGV ) or die "exec( ".(join ", ", @ARGV )." ) failed: $!\n";
         }
      }
    
   exec ( @ARGV ) or die "exec( ".(join ", ", @ARGV )." ) failed: $!\n";
    
3. Move to $EMUHOME/html and run the following command, or similar, as a user other than root who has permissions to read from and write to $EMUHOME/data/homes and $EMUHOME/data/tmp, substituting your Zeus webserver installation directory for $ZEUSHOME. You may use any free port that you can access as a user other than root.
    
   /usr/local/zeus/web/bin/fcgirunner 8004 emumail.fcgi
    
   You should now see 10 emumail children in your process list.
    
4. Create a virtual server with the document root set to $EMUHOME/html.
    
5. In the map module, set up two aliases.
    
   Docroot path: /emu/
   Filesystem directory: $EMUHOME
   Alias type: fastcgi
    
   Document path: /emu/emuimages/
   Filesystem directory: $EMUHOME/html/emuimages
   Alias type: simple
    
6. Enable the FastCGI module, and configure a remote responder
    
   Docroot path: /emu/emumail.fcgi
   Remote machine: localhost:8004
    
   The port number should be substituted for the port number used when starting the fcgirunner.
    
7. Edit the file $EMUHOME/html/index.html so that the URL section reads:
    
   URL=/emu/emumail.fcgi