Update Program
The update program is not yet finished, and its a future feature.
 
The following covers how you upgrade WebMail, using the seperate update program.
 
This feature is only available to registered webmail users.
 
If you have any questions or need to know more about any aspect of WebMail, please Email:
support-webmail@netwinsite.com
Setup

The update program before it can work requires to have access to a number of webmail locations. These include:

  • WebMail's INI file. (webmail.ini)
  • Web server location where webmail's images are stored.
    (ie /nwimg/mail/)
  • WebMail's workarea. (/var/spool/webmail/)

The reason why is that the program will need to update the templates/images files and add new webmail.ini settings as needed to increase security/performance of WebMail.

Before you run the update program you should ensure that you have the following webmail.ini settings:

# Update Settings
nwimg_path /home/httpd/html
workarea /var/spool/webmail
templates /var/spool/webmail/panel
Running Update

The next step is then runing the update program. You must run update as a super-user (or root) access so that the program has access ot the neccessary webmail locations.

If the update program is in the same location as the webmail.ini/webmail.cgi location then just enter:

./update

If you want to run the update program from another location then enter the following:

./update -path /home/httpd/cgi-bin/

Once run the update program will collect information about 'webmail', it's verison what templates you have and what O/S you are using. Then it will contact 'netwinsite.com' requesting the complete update options for the O/S you are using. The output of the update program will look something like this:

Checking for Binary File: c:\inetpub\scripts\webmail

Getting version information...
Version: WebMail v3.0p
System Build: 4
Operating System: Windows

Connecting to External Site: https://netwinsite.com/scripts/update.exe
Connected to Site: https://netwinsite.com/scripts/update.exe

Product: WebMail
Support: support-webmail@netwinsite.com

IMPORTANT: You MUST have installed WebMail v3.1h to use this feature.

Available Updates for webmail v3.0p (build 4)
--------------------------------------------------

   Release:   Version: v3.1h (build 1)
                 Date: 28-Mar-2002 14:14:01 NZST
                Notes: This is the most stable.

   Beta:   Version: v3.1g (build 12)
              Date: 28-Mar-2002 14:14:01 NZST
             Notes: This is the most stable.

Available TPL Updates
---------------------

   Master Sets:

   Base Sets:

The above lists the Relase and Beta versions which is available, and any template updates for the verison which you currently have installed.

It will then display the following menu giving you the option to updated to different versions or only update your templates.

Menu
----

IMPORTANT: You MUST have installed WebMail v3.1h to use this feature.

1. Install Release - webmail v3.1h (build 1)
2. Install Beta - webmail v3.1g (build 12)

u. Install updated Templates for - webmail v3.0p (build 4)
q. quit
[q] ?

In this example we are going to upgrade to the beta version, once we select the beta version it will display more information about this version like the following

  Version: v3.1g (build 12)
     Date: 28-Mar-2002 14:14:01 NZST
    Notes: This is the most stable.

Available TPL Updates
---------------------

   Master Sets:
       smooth : v3.1g (build 12) - 28-Mar-2002 14:14:01 NZST ...[New]

   Base Sets:
        surge : v3.1g (build 12) - 28-Mar-2002 14:14:01 NZST ...[New]
        panel : v3.1g (build 12) - 28-Mar-2002 14:14:01 NZST ...[New]
-----------------------------------------------------------------------
Do you wish to also update template for 'v3.1g (build 12)' as well?
You will be prompted about templates you do not have installed
[Y/n] ?y

New Template: smooth - Do you wish to install?
[Y/n] ?y

New Template: surge - Do you wish to install?
[Y/n] ?y

New Template: panel - Do you wish to install?
[Y/n] ?y

As you can see their are 3 new template sets available that we do not have installed, and are asked if we want to install these as well. In this case we do so we answer yes to the question asked and then answer yes to the templates we want to install. In this example we will install all of them.

Once you have answer the questions about what templates you want to install you will be shown where the current files will be backed up to, and if you wish to continue to update. This is the last point before any changes are made to your system and you should be sure if you want to continue.

When upgrading, files are preserved in the folders
      C:\surgemail\web_work\upgraded\30pb4\binary
      C:\surgemail\web_work\upgraded\30pb4\tpl
      C:\surgemail\web_work\upgraded\30pb4\nwimg

There are also possible INI setting changes for this version.
Once installed you will asked about these settings.

Are you sure you wish to upgrade to 'v3.1g (build 12)'?
This is the most stable.
[Y/n] ?

Once all the templates and images have been updated to your system the next step is the webmail.ini file. When you update their might be new settings that you should setup on your system. It will list the ini settings and if their are already present on your system. in most cases you should answer yes to the below question to be guided though this. Depending on the ini setting will depend on the questions asked.

If you have added any new templates sets this will automatically add the required webmail.ini settings.

Double checking any INI setting requirements

      leave_headers_cache                                         ..[located]
      max_imap_download 200                                       ..[missing]
      max_download 200                                            ..[missing]
      suffix_domain                                               ..[located]

You are missing a few INI settings that should be added.
Do you want to be guided though these setting changes?
[Y/n] ?