If a new version of JungleMail is released and you have an active subscription, you can easily upgrade. We will notify you about the latest versions via email, but you can also check JungleMail Releases page.
The installation account must have at least the following permissions:
- Member of the local server Administrators group (to install application files)
- Member of the SharePoint Farm Administrators group (to deploy solutions to the farm)
- SharePoint site collection administrator (to activate the features after installation)
How to upgrade JungleMail
- Download the latest JungleMail installer here.
- Copy the installer on the SharePoint server running the Central Administration service.
- Restart the World Wide Web Publishing Service (W3SVC) before installation on every server running it in your SharePoint farm. You can use the
iisreset/stop / noforceand iisreset/start command line commands. This will ensure that no system files that need to be updated are locked, which could cause the installation to fail.
- Launch JungleMail Installer from SharePoint Server running Central Administration Service. The product will be automatically deployed to all other SharePoint Farm servers by the SharePoint Timer service.
Note: installation may cause 2-5 minutes of downtime.
- Follow the installation wizard instructions and choose the Upgrade option.
- When the installation is complete, review the summary screen to confirm that the product installed successfully, then click Close.
- Restart SharePoint Timer Service on all servers.
9. Run the setup program again. Follow the installation wizard instructions and choose a Repair option.
10. When the installation is complete, review the summary screen to confirm that the product installed successfully, and then click Close. Now your JungleMail successfully upgraded to the latest version.
Please note if you are upgrading from version 5.0 to 5.2 or later:
In order to fully utilize the new icon sets available in version 5.2 or later, please delete the old icons.
1. Navigate to site collection root, open Site Contents, then locate and open the JungleMail Assets library. In the library, open the Built-in Email Builder Blocks Images folder and delete the Social folder.
2. Open your site collection settings, click Site Collection Features, deactivate the JungleMail Core feature, then activate it again.
Upgrade to JungleMail 7
JungleMail is a farm solution, therefore it should either be installed on a SharePoint On-Premises server or on a fully controllable SharePoint server in the cloud.
- SharePoint Server 2013, SharePoint Foundation 2013, SharePoint Server 2016
- The installation and upgrading steps are described
atthe beginning of the article. Read more about JungleMail installation guidelines.
- Upgrading process can take longer due to analytical data processing.
- Clear browser temporary files and run the JungleMail UI to check installation.
- After upgrading to JungleMail 7, go to JungleMail License management in Central Administration. The product code is changed to JNML-1607 and JungleMail status is converted to Trial, as it requires license update. If you have an active Premium Support subscription, please contact us and we will send you the new license key.
Additional steps for JungleMail Enterprise
1. Enable SQL Mode for performance and extensive analytics.
Changes to Subscription Web Part configuration
To make the subscription web part safer and to make sure workflows can be used without problems, we have changed the way it works when used on Other Site Collections. For the new web part configuration to work on your environment, you will have to make some changes.
1. Create a separate user in Active Directory to access your main SharePoint Collection on which the JungleMail Core feature is activated. For example, your username could
2. Create a new Permission level on root site level for the newly created account. This will ensure the account will only have access to the JungleMail Service and not to the parent lists or libraries of that site collection.
- Open root site’s Site Permissions and click Permission Levels
- Click Add a Permission Level
- Check the Use Remote Interfaces and Open boxes and save this custom permission level, and give it a custom name,
3. On the root site, go to site settings, click Site Permissions, then click Grant Permissions and assign the newly created permission level to the user created in Step 1.
4. Now you need to assign the required permissions for the user in JungleMail built-in lists. All lists are located on the root site collection. Assign the following permissions to the user on a list level in the following lists:
- JungleMail Subscribers - View, Add and Edit items permissions
- JungleMail Topics - Read permission level
- JungleMail Tracker Links - Read permission level
- JungleMail Tracker Actions - View, Add permissions
Note: you should disable permission inheritance or Set Unique permissions for the above lists.