Major Upgrade of SmarterMail

The steps for upgrading to SmarterMail 15.x from an older version of the application vary depending on which version you are upgrading from. For instructions on how to upgrade from a previous 15.x release refer to the knowledge base article -- Minor Upgrade of SmarterMail.

Follow these steps to upgrade to the latest version of SmarterMail if you are upgrading from a previous version (such as 14.x or 13.x). NOTE: All configuration data and emails are preserved when upgrading from a previous major release.

NOTE: Before following the instructions in this article, make sure the appropriate Microsoft .NET Framework is installed for the version to which you will be upgrading, based on the version's System Requirements. (Versions 14.x and newer require the .NET 4.5 Framework.) Also, upgrading from older versions (up to SmarterMail 6.x) can take up to several hours based on the amount of data. This is due to file structure changes that are in SmarterMail 7.x. In addition, you will not be able to roll back to the older major version because of the file structure change. To go back to an older version, you will need to restore from a backup.

Applies to SmarterMail 8.x - 15.x

  1. Back up your SmarterMail installation and data.
  2. Download the latest automated installer from the SmarterMail Download page.
  3. If you are running SmarterMail as an IIS site, stop IIS.
  4. Uninstall SmarterMail. This is an important step in performing a major upgrade that should not be skipped. All configuration data and email will be preserved.
  5. Run the SmarterMail installer.
  6. During the installation process, you will be prompted for the installation path. In order to keep existing data and settings, install to the same path used in previous installs. For reference, the default installation location is C:\Program Files\SmarterTools\SmarterMail.
  7. If you have made any custom configuration changes in the MailService.exe.config, replace those changes to the appropriate location.
  8. If you are running SmarterMail as an IIS site, make sure the default web server is stopped.
  9. If you are running SmarterMail as an IIS site, change the .NET version of the Application Pool to .NET 4.0 and restart IIS.
  10. The Setup Wizard will automatically run.
  11. If you were running with an activated license key, you will need to reactivate using a license key that is valid for the version you upgraded to. For more information regarding activation refer to: Activate SmarterMail. In some cases you may need to reconfigure your spam settings, as those can change from version to version.

For more information, please refer to the SmarterMail Online Help.

 

Learn more about SmarterMail's enterprise email features and benefits.

Feedback

Add Feedback
Can I use this KB to upgrade from Smartermail 6.9 to 11.x?
Diego Santos (February 12, 2014 at 11:37 AM)
Hi, Diego. Sure - this same process would work. We'd just recommend you first upgrade to 7.x as there were some file system changes in 7.x that could take some time to upgrade, depending on the amount of users and mail you have. From there, a straight shot from 7.x to 11.x would be fine.
Derek Curtis (February 12, 2014 at 12:02 PM)
Hi Derek,

I appreciate your reply. How can I get version 7.x? I could only find version 10 at Smartermail download page.

Diego Santos (February 18, 2014 at 11:36 AM)
Diego - simply go to the SmarterMail download page, copy the Primary download link for SmarterMail, pasted it into a new browser tab but change Version=12 in the URL to Version=7 and you'll get the most recent version of SmarterMail 7.x
Derek Curtis (February 18, 2014 at 11:56 AM)
can anybody direct me instructions for upgrading from ver 11.x to 12.x on a winserver2008 box running plesk?
mark finguerra (February 21, 2014 at 3:54 PM)
Mark, the upgrade is the same whether you have Plesk installed or not. We haven't changed any of the API hooks that SmarterMail uses when integrating with Plesk, so the move to 12.x should not cause any issues for you.
Derek Curtis (February 24, 2014 at 4:26 PM)
can i upgrade from smartermail 5 to the newest version?
Carlos Carlos (February 23, 2014 at 10:12 AM)
Hi, Carlos. Yes, this isn't a problem. I would advise a staggered upgrade, though, from 5.x to 7.x first as we made some file system changes in SmarterMail 7.x, so that upgrade could take some time. Then you can easily upgrade from 7.x to 12.x fairly easily. For info on how to get the 7.x installer, see my reply to Diego, above.
Derek Curtis (February 24, 2014 at 4:27 PM)
obviously i have to purchase smartermail 12x entrerprise to get access to the downloads page right?
Carlos Carlos (February 26, 2014 at 12:19 PM)
Carlos - we offer a free download of SmarterMail 12.x, so it's not necessary to purchase it in order to use it or test it out. However, if you're an existing licensee, then you'll need to make sure your Upgrade Protection is up-to-date in order to upgrade to SmarterMail 12.x.
Derek Curtis (February 26, 2014 at 1:39 PM)
no, we have an entrerprise license for SM5, and our upgrade proteccion is no longer valid.
Carlos Carlos (February 26, 2014 at 4:59 PM)
regarding --> NOTE: All configuration data and emails are preserved when upgrading from a previous major release.

So I just did an upgrade from 11.x to 12.x and tadaaaa again, as per usual, zero domains, and emails were retained. Yes sure, great the folders are there, but the xml files which manage those domains, directories, and accounts, are simply wiped.

I don't understand why either
A: it isn't an option to "update existing installation" which then backs up and/or manages the existing domains or
B: A proper tutorial exists which deals with walking through an upgrade from one version to another listing the requirement to back up manually and restore the existing domains.

Also, secondary note. The MSI installer (this is the first time I've used it), completely assumes that no existing installation exists, and doesn't take into account that this is an existing client.

You guys have good products, but from an installation due diligence, this obvious dynamic has been summarily ignored.

it's annoying to be quite honest, and a waste of time for every upgrade.

James Mendham (February 24, 2014 at 1:01 AM)
James - in our testing of the 12.x major version release, we did an upgrade from 11.x to 12.x and saw no issues - all domains and emails were preserved in the upgrade. If you use the Windows unistaller to uninstall SmarterMail, it only removes the program files and doesn't touch any other SmarterMail data. I can't think of any other occasion when either a major or minor upgrade has removed these files, and we have customers across the globe doing both types of upgrades. If you're seeing something different, it may require a ticket in to our Support department.
Derek Curtis (February 24, 2014 at 4:31 PM)
It would be VERY helpful if STEP 11 was at the beginning.
If you stored your activation email IN your email, it is quite hard to go back and retrieve it if you are stuck in free version but running multiple domains therefore your mailbox is useless. It would also be wise to note that you MUST be able to recall your account management credentials to complete the activation too.

Jim Vaden (April 3, 2014 at 9:12 PM)
If this happens to anyone in the future. Simply login as the server admin. Mirror your email account and access your license key.
Ricky Hignite (April 29, 2014 at 10:09 AM)
Something that isn't listed but is highly recommended is to reboot the server AFTER uninstalling and BEFORE you start the new install.
Ricky Hignite (April 29, 2014 at 10:09 AM)
I got a fatal error during the first pass install when it tried to start the services. When I tried again, it worked. I believe your hint here is correct and would have kept me from having the error.
Clayton Vernon (December 14, 2014 at 6:21 PM)
Why is it always recommended to upgrade to version 7 first? Do the versions greater than 7 somehow not contain the 'before-v7-upgrade' functionality?

Are there errors that occur when attempting to update such an old installation with a brand new installer?

Is it simply erring on the side of caution, and experience that the gold standard v7 release is known to properly upgrade ,whereas you have just simply never tested the newer ones?

I really want to understand why always that one version, and not just simply make your newer versions update the old ones properly... And yes, there are still plenty of smartermail4 and 5 customers in my datacenter...

Mike Griffin (December 4, 2014 at 3:13 AM)
Hi Mike,

In SmarterMail 7.x, users' mailbox data was reorganized and saved in a new file structure. You can read more about this in the release notes for that version. Because of the file structure change, we recommended upgrading to version 7.x first; if there are any issues with the upgrade, doing it this way could help pinpoint what caused the trouble. That being said, we've had many users report that an upgrade straight from 4.x or 5.x to 13.x has gone smoothly, and upgrading to 7.x first wasn't necessary. So our recommendation is simply to err on the side of caution. If you choose not to, just be sure to do a full backup first as SmarterMail cannot be downgraded. Should you need to revert to an older version, you'd have to restore from a backup.

If you'd like to get some feedback from other users or post about your upgrade, there is a Community thread that addresses this question as well: https://portal.smartertools.com/community/a786/upgrading-from-smartermail-ver_-4-to-11.aspx

Hope this helps!

Andrea Rogers (December 4, 2014 at 8:29 AM)
I'm using Win7 Pro, upgrading from 11.4 to 13.0, and during the install (by the way, the default directory for me includes x86 in the folder name, of course, something recognized by the installer), there were several scary "error" messages related to not being able to create or write to a folder. Each time, I asked it to "Retry" and, shockingly, it seemed to work. This basically never happens in Windows, so I think there are some bugs on your side. An obvious candidate is trying to create a folder that already existed (wasn't removed by the uninstall), and I don't know exactly what for the "can't write to directory" error unless a thread creating it hadn't finished yet. Anyway, having said that, the process seemed to work fine in the end, and I'm very thankful for this.
Clayton Vernon (December 14, 2014 at 5:17 PM)
what would it cost to have Smarter Mail update my current version 5 system to the latest? We have six users
Phil Kipnis (January 7, 2015 at 12:10 AM)
Hi Phil. If you're using the free edition, your upgrade won't cost anything. You'll just follow these steps to upgrade to the latest version. If you're using a license, you'd need to reinstate the upgrade protection. That cost would depend on what product you are you using.

I see that you have a sales ticket open with Emily. If you reply to her message, letting her know what your current setup is, she'll be able to assist you further.

Andrea Rogers (January 7, 2015 at 8:16 AM)
Will my license key for 12.x be valid after upgrading to 13.x or will I need a new license key?
Donavon McKigney (January 15, 2015 at 1:24 PM)
Before upgrading your SmarterMail installation to version 13.x, I'd verify that your license key is valid for version 13.x. If your license had active upgrade protection at the time we released 13.x, it should have been automatically upgraded. If you're not sure what version your license is valid for, go ahead and reach out to our sales team. They can get your account information and let you know what's available. You can contact the sales team by emailing sales (at) smartertools.com, calling 877-357-6278 or starting a live chat using the button to the left of this screen.
Andrea Rogers (January 16, 2015 at 10:34 AM)
Also, in case I understood you incorrectly, if your license key is for version 13.x, you'll also be able to use this on 12.x and earlier as our licenses are backwards compatible.
Andrea Rogers (January 16, 2015 at 10:35 AM)
In the past step 4 "Uninstall SmarterMail" was followed by a reboot. Is that no longer needed?
Alex S (January 16, 2015 at 5:54 PM)
Hi Alex. The steps found in this article are the most accurate steps to complete your installation's upgrade. A reboot after uninstalling SmarterMail should not be necessary.
Andrea Rogers (January 19, 2015 at 7:53 AM)
I just did a simple minor upgrade and now my domains are gone! The files and folders are there but I can't login using those domain accounts. My configuration for the domains is pointing at the correct folder so how do I get it restored to normal?
Dave Stuart (June 11, 2015 at 7:36 PM)
Would we be able to do a straight upgrade from 11.7 to 14? Or do we need to take baby steps up to the latest version?
David Madison (July 10, 2015 at 7:00 AM)
You can go to directly to 14.x.
Andrea Rogers (July 10, 2015 at 8:49 AM)
Thank you Andrea!
David Madison (July 10, 2015 at 12:22 PM)
Hello,
Step 3: If you are running SmarterMail as an IIS site, stop IIS.
Is it really necessary to stop IIS? Could we simply stop the SmarterMail IIS site. I'd like to minimize disruption of other web sites while uninstalling/reinstalling.

Also Step 8: If you are running SmarterMail as an IIS site, make sure the default web server is stopped.
Do you mean the "Default Web Site", or default web server (meaning IIS)? And if Step 3 is followed, IIS would be off and no sites would be running anyway.

I'm just seeking clarity to make the upgrade go as fast as possible and with minimal disruption to users/site.
-John

secretwep (July 31, 2015 at 12:44 PM)
Hi John,

For step 3 you can just stop the SmarterMail site and application pool. It is not necessary to stop all of IIS.

For step 8 it is refering to the default web server that comes with SmarterMail. During the install of SmarterMail a default web server is also installed. You do not want the default web server and IIS running at the same time.

Brian Ward (July 31, 2015 at 1:09 PM)
Awesome. Everything went well, all things considered. Some old, previously deleted, renamed or moved folders reappeared in all Users mail boxes. Other than that, looks good. For Step 8, you might want to mention that you are referring to a service called "SmarterMail Web Server". It needs to be switched back to "Disable" after the upgrade (if using SmarterMail as an IIS site, which I imagine is most common).
secretwep (August 3, 2015 at 10:02 AM)
Brian, I run SmarterMail under IIS on a Windows 2011 Essentials server and just upgraded from SmarterMail 13.5 to 14.4 today following the directions (took IIS down, uninstalled 13.5, installed 14.4, turned IIS back on). The only snag I ran into was that I was unable to access the webmail when done until I enabled and turned on the internal SmarterMail default web server (on port 9998). After doing that I was able to log in normally via the web server (port 443) and enter branding and update license and all appears working. I've seen it specifically mentioned to NOT run the default SmarterMail server while running SmarterMail under IIS. I had the default server active for some time before turning it off prior to the upgrade. Are there any known issues resulting from keeping it running? Are you aware of it having to be on after restarting IIS to initially get back on to the IIS site so one can reactivate the license after a major upgrade?
CharlesWorks (December 20, 2015 at 9:26 AM)
it is very difficult to take a backup of nearly 1 TB of data is there any alternate solution. please suggest me.
Sathiya R (November 21, 2015 at 3:18 AM)
While performing a major upgrade should not cause you to lose any data, we do recommend performing a backup of your data prior. This backup method is up to you to use whatever you are most comfortable with. Check out this Community threads ideas from users: http://portal.smartertools.com/community/a1508/what-backup-software-are-you-using-and-what-is-your-experience-with-it.aspx
Andrea Rogers (November 23, 2015 at 8:57 AM)
Upgraded from v5.5 to v14.5 following the same steps, all email accounts are intact but the emails are not upgraded correctly. Folder structure is different where it used to be Users\[account name]\Inbox, now it is Users\[account name]\Mail\Inbox, where the installer didn't move the folder during upgrade.

The step to fix would be to move all the folders into the Mail folder, and using the Restore functionality to Rebuilt the mailbox's folders.

However, there is a quicker more efficient way to it:
1. Stop the SmarterMail service (optional rather)
2. Move the mail folders from the Users\[account]\[folder] to Users\[account]\Mail\[folder]. (not Index, FileStore folders which is not mailbox's folder itself)
*note: If there is prompt for replacing duplicate .grp file, DO NOT replace it, rather make duplicate or move it to a newly created folder, as these are newly incoming emails in the short duration when you perform this upgrade.
3. Delete all root.cfg and mailbox.cfg from [domain]\Users (do it recursively with "del /s" in command prompt).
4. Restart the SmarterMail service.

Hope it helps fellows admins if you are upgrading the same.

Choong Seng Chen (January 30, 2016 at 4:06 PM)
V14 > v15 upgrade was flawless. Good job on both the instructions and software.
Happy campers!

Daniel Comp (April 21, 2016 at 3:26 PM)
Thanks Daniel!
Andrea Rogers (April 28, 2016 at 1:02 PM)
V14 to V15 (IIS 8.5 win2012r2) upgraded without problems just executing the installer (didn't need to stop iis nor uninstall v14), reactivated the license at the end.
May I upgrade another server with Upgrade Protection expired?

Support Noitel (April 27, 2016 at 2:47 PM)
Glad to hear your upgrade went well! Please keep in mind, though, that we always recommend uninstalling the previous version first when doing a major upgrade. Installing on top of the old version can cause some big problems in most cases.

As for the upgrade, it depends on when the upgrade protection expired. If your upgrade protection expired at version 14.x, you can upgrade to the latest minor version available for 14. To get to the latest version of the software, 15.x, you would need to reinstate the upgrade protection. I'll send you a ticket to discuss your licensing further and provide some quotes on getting you updated.

Andrea Rogers (April 28, 2016 at 12:58 PM)
Can I upgrade Smarter mail V14.x straight shot direct to V15.x(lates)?
philip (December 27, 2016 at 6:38 PM)
Yes, Philip. This article contains the steps you should take to upgrade from 14.x to 15.x.
Andrea Rogers (December 29, 2016 at 2:17 PM)
We will upgrade from very old v4.x to v15.x(latest)
Have bought a new licence.
At the same time we have to move SM to a w2k8 server.
How much do we have to copy from old server to new?
What's the best way to do the whole procedure?

Lennart Eliasson (January 24 at 4:46 PM)
Hi Lennart! You should start by migrating SmarterMail 4.x to the new server by following the steps in the article linked below. When 4.x is up and running on the new server, you can begin your upgrade to 15.x. Keep in mind, in version 7.x, the structure of the server files weas changed. Typically we recommend upgrading first to 7.x and then to 15.x, though we've had users report this isn't totally necessary. If you have any trouble on the upgrade though, you may need to reach out to the sales team for a tool to convert your file structure. Let us know if you need any assistance!

http://portal.smartertools.com/kb/a2724/migrate-smartermail-to-a-different-server.aspx

Andrea Rogers (January 25 at 10:34 AM)

Add Feedback