Products Downloads Prices Support Company

Installing and Upgrading SurgeMail

Windows

To install or upgrade, download the latest version from our website (download link on (http://netwinsite.com/surgemail/) or FTP site (ftp://netwinsite.com/pub/surgemail) and run it. It is a self extracting archive which will automatically detect your existing surgemail or dmail configuration and upgrade an existing install or perform a clean install as appropriate. You will be asked for confirmation before any action is taken.

If you are already running a Mail server it is essential that you stop it and uninstall it before starting SurgeMail as both will not run at once. 

UNIX

To install or upgrade download the latest version from our FTP site, uncompress and untar the files, then run the install.sh script. The _XXX_ in the file below is the version platform and verison number. (eg surgemail_36f5_linux.tar.gz or surgemail_36f5_freebsd4.tar.gz)

e.g. 

  ftp ftp.netwinsite.com
  FTP> cd pub/surgemail
  FTP> ls 
  FTP> bin
  FTP> get surgemail_XXX_linux.tar.gz
  FTP> quit
  gunzip surgemail_XXX_linux.tar.gz 
  tar -xvf surgemail_XXX_linux.tar
  cd mtemp
  ./install.sh

On a first time installation the standard UNIX mail server will be stopped by commenting out the line in /etc/inetd.conf and sending HUP signal to that process. Also on unix installs you will need to be logged in as root to install surgemail and may need to create the "mail" unix account on the server. In most situations surgemail will create the "mail" account itself if it does not exist.

If you ever need to manually start the server:
On NT based systems (ie XP/2000/2003), type in: net start surgemail
On 95/98, type in: /windows/surgemail
On Unix, /usr/local/surgemail/surgemail_start.sh
If you ever need to manually stop the server:
On NT based system (ie XP/2000/2003), type in: tellmail shutdown
		or alternatively "net stop shutdown" can be used but tellmail shutdown will provide a cleaner shutdown
On 95/98, type in: tellmail shutdown
On Unix, /usr/local/surgemail/surgemail_start.sh

Upgrading from other Mail Servers and Migration support

SurgeMail has a number of features to make the migration from an existing mail server to your new SurgeMail installation easier. These can be combined to your choice to make your mail migration as painless as possible for both you and your users. However migrating from one mail server to another should always be done carefully and should be fully controlled. Important considerations are factors such as simplicity of upgrade procedure, length of downtime and ability to rollback.

The recommended upgrade method is migration using POP or IMAP intercept mode. This is a simple method to upgrade from any arbitrary mailserver.

Further migration support is described on the migration page.

Upgrading from DMail

SurgeMail will detect an existing DMail configuration and create a SurgeMail configuration based on the dmail.conf file. In general this will successfully upgrade an existing DMail installation.

However, SurgeMail is not 100% compatible with DMail and upgrades should be attempted with caution. It is suggested to copy your existing dmail.conf file to a test systems and install SurgeMail on that to test that SurgeMail will upgrade your DMail configuration.

The suggested upgrade procedure is to copy your existing dmail.conf file to a test systems and install SurgeMail on that to test that SurgeMail will upgrade your DMail configuration. The SurgeMail installation scripts will warn you about any ini settings that it thinks it cannot convert and might be serious. If you use include files in your dmail.conf or have scripts that modify dmail.conf you should definitely hesitate as SurgeMail uses a completely different ini file format.

Also note that when DMail is upgraded external modules such as authentication modules and their databases will remain in their original location, it is important to check your dmail.conf and surgemail.ini files before deletion of any files relating to your DMail configuration.

Please read the following online upgrade notes for any latest information on upgrading DMail.

 

Uninstalling SurgeMail

Windows

The uninstall is available through the Start Menu - SurgeMail - Uninstall SurgeMail, or through Control Panel - Add / Remove Programs. If for some reason this is not available you can also run "surgemail -uninstall" from the command line in the directory that SurgeMail is installed.

UNIX

Run "./surgemail -uninstall" in the directory in which SurgeMail was installed. (default is /usr/local/surgemail)

 

Note: Have you read How SurgeMail fits together? It will help your understanding of SurgeMail features.