Upgrading WebMail
The following covers how to upgrade WebMail. There are a number of ways to upgrade WebMail and these are explained in the sections below.
 
If you have any questions, or need to know more about any aspect of WebMail, please Email:
 
support-webmail@netwinsite.com
Basic Upgrade

There are 2 simple ways to do a basic upgrade of WebMail.

  • Using SurgeMail Distribution
  • Using WebMail Distribution

They are explained below.

SurgeMail Distribution

First, you need to download the version of Surgemail that you wish to install, from one of the following URL's:

Main Release: https://netwinsite.com/cgi-bin/keycgi.exe?cmd=download&product=surgemail
Beta Release: https://netwinsite.com/surgemail/betadownloads.htm

If you are using Windows, all you need to do is run the download. It will then take you though the step-by-step instructions on upgrading. On unix'ish systems you need to uncompress/untar the distribution and run the 'install.sh' file.

The installation will ask you if you want to upgrade webmail, which you should answer yes to. It will then ask you if want to upgrade webmail templates as well. In general, if you are upgrading webmail cgi you should also upgrade the templates so that you get all the changes/fixes.

If you do upgrade the templates, the installer will backup your old templates to a directory like this:         rollback/#version

This will allow you to convert back to an older version if you wish.

If the version you already have installed is a newer version than the one in the distribution it will not upgrade the CGI.

Note: Upgrading via this method will NOT update your webmail.ini so any new templates will not be available until updated. SeeAdding New Templates.

WebMail Distribution

First you need to download the version of WebMail that you wish to install from one of the following URL's:

Main Release: https://netwinsite.com/webmail/download2.htm
Beta Release: ftp://netwinsite.com/pub/webmail/beta

If you are using windows all you need to do is just run the download it will then take you though the step-by-step instructions on upgrading. On unix'ish systems you need to uncompress/untar the distribution and run the 'install.sh' file.

The installation will ask you if you want to upgrade webmail, which you should answer yes to. It will then ask you if want to upgrade webmail templates as well. In general if you are upgrading webmail cgi you should also upgrade the templates so that you get all the changes/fixes.

If the version you already have installed is a newer version than the one in the distribution, it will replace with the one in the distribution.

You can also use this distribution to upgrade an SurgeMail installation of WebMail.

Note: Upgrading via this method will NOT update your webmail.ini so any new templates will not be available until updated. SeeAdding New Templates.

Upgrading the CGI only

If you wish to only upgrade the CGI and would like to do it by hand all you need to do is rename the OLD cgi so that you have a backup, just in case you wish to move back to the old version. Then copy over the webmail CGI.

The CGI will be located in the 'cgi-bin' or 'scripts' folder of the web server. The file might have a extension of .cgi or .exe depending on the setup.

In this sort of case I expect the CGI is provided by Netwin support. But you can do this from the SurgeMail and WebMail distribution, you will just need to extract the CGI from the download.

Adding New Templates

If you have upgraded your site with a new version of webmail which has templates that you did not already have installed and would like to allowed your users to select these from your login page and/or users options page then you will need to follow the instructions below .

When you upgrade using a distribution, it would have copied over all the images and templates of all the new templates but not added the webmail.ini settings required to have these selectable by the user.

The below are the webmail.ini settings that you would add if you upgraded to v3.1i (or higher) and did not already have set up the 2 new templates 'Surge' and 'Smooth'.

The example is for a windows system which is using SurgeMail as your web server. If you are using another O/S or web server you will need to change the directories to match your setup.

SurgeMail on Windows
do_full_login surge,smooth

# masterset id base_tpl nwimg
masterset surge c:\surgemail\webmail\ /nwimg/imap/surge
masterset smooth c:\surgemail\webmail\ /nwimg/imap/smooth

# New Templates to Display
tpl_set surge c:\surgemail\webmail\masterset\surge /nwimg/imap/surge Surge
tpl_set smooth c:\surgemail\webmail\masterset\smooth /nwimg/imap/smooth Smooth
SurgeMail on Linux
do_full_login surge,smooth

# masterset id base_tpl nwimg
masterset surge /usr/local/surgemail/webmail/ /nwimg/imap/surge
masterset smooth /usr/local/surgemail/webmail/ /nwimg/imap/smooth

# New Templates to Display
tpl_set surge /usr/local/surgemail/webmail/masterset/surge /nwimg/imap/surge Surge
tpl_set smooth /usr/local/surgemail/webmail/masterset/smooth /nwimg/imap/smooth Smooth

Removing Templates

If, after you Upgrade or Install WebMail and there are template sets that you do not want your customers to be able to use, all you need to do is edit your 'webmail.ini' file. Locate the 'tpl_set' which matches the template that you do not want to allow and place a '#' character at the being. This will comment out the template and not allow the users to select it from the login page or user option page.

Users that might already be using the removed template will automatically default back to the default template.