JungleMail installation and activation guide

The latest version of JungleMail is always available from the download page.

System requirements

  • Microsoft Windows Server 2008, 2008 R2, 2012
  • SharePoint Server 2010, SharePoint Foundation 2010, SharePoint Server 2013 or SharePoint Foundation 2013
  • Microsoft Internet Explorer 8 or higher

Before Installation
Before you install EnovaPoint products, follow these guidelines to ensure a successful installation:

1. Back up your system before making any changes.
2. Verify the system requirements for the product you are installing.
3. Make sure you are starting the installation on the correct server. It is recommended to install JungleMail on one of the servers in the SharePoint farm running the Central Administration service. The product will be automatically deployed to other SharePoint servers by the SharePoint Timer service.
4. Verify the permissions required for the installation account you are using to install the product. 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).

5. Stop the World Wide Web Publishing Service (W3SVC) during installation on every server running it in your SharePoint farm. You can use the iisreset /stop /noforce and 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.

NOTE: If you had JungleMail 2 installed

Please note that when you upgrade from earlier versions to JungleMail 3, your Central Administration settings will not be preserved. All your group email jobs and recipient data will be preserved. So to ensure fluent upgrade please follow the steps below:

1. Write down Central Administration > JungleMail Global Settings.
2. Write down configuration from and remove all JungleMail Web Parts (Unsubscribe, Tracker, External Unsubscribe, External Tracker)
3. Upgrade to JungleMail 3.0 by selecting Upgrade option in JungleMail 3.0 installer (you must be local admin, farm admin and site collection admin on all site collections where JungleMail was used)
4. Configure Central Administration > JungleMail Global Settings
5. Configure Site Collection Settings > JungleMail Site Collection Settings (specify the same page ULRs as was before: Unsubscribe page URL > Subscription page URL, Tracker page URL > Tracker Page URL)
6. Place and configure new Web Parts on the same pages where old Web Parts have been removed (Tracker Web Part or External Tracker Web Part > Tracker Web Part, Unsubscribe Web Part > Subscriptions Web Part)

Installation process

1. Run the setup program you have downloaded from the EnovaPoint web site.
2. Follow the installation wizard instructions.
3. When installation is complete, review the summary screen to confirm that the product installed successfully, and then click Close.

Activating the Features

“EnovaPoint JungleMail Core” Feature
This feature creates JungleMail lists required for JungleMail functionality on particular site collection.
This is the main feature of JungleMail and should be activated on each site collection where you are going to use JungleMail. This feature also enables JungleMail Site Collection Settings.
Except site collections which are used only for tracking link clicks/email opens and for users subscribe/unsubscribe/subscription management activities. For these site collections we recommend only to activate “EnovaPoint JungleMail Publishing Web Parts” Feature.

Activating the feature
1. Log in to the top-level site in the SharePoint site collection using a site collection administrator account.
2. Go to Settings > Site Settings > Site Collection Administration > Site Collection Features.
3. Locate the “EnovaPoint JungleMail Core” feature and click the Activate button to activate the feature for the entire site collection.

JungleMail-Core-Lists-Activating-feature.png

Note: You must repeat these steps for each site collection on which you plan to use JungleMail.

After the activation of this feature, you will notice one document library and few lists have been created on the top-level site in the current site collection.

ConfigurationListsCreated.png

“EnovaPoint JungleMail Publishing Web Parts” Feature
This feature adds JungleMail Tracking and Subscriptions web parts to your web part gallery. Enable this feature on the site collection you are going to place web parts in.
If you are going to send emails from Internal environment and track external/anonymous users actions, there is no need to activate this feature on internal environment. You should activate it on SharePoint Site Collection accessible by anonymous users and which tracking and subscription management web parts will be placed.

Activating the feature
1. Log in to the top-level site in the SharePoint site collection using a site collection administrator account.
2. Go to Settings > Site Settings > Site Collection Administration > Site Collection Features.
3. Locate the “EnovaPoint JungleMail Publishing Web Parts” feature and click the Activate button to activate the feature for the entire site collection.

JungleMail-Publishing-Web-Parts-Feature.png

Activating the “EnovaPoint JungleMail User Menu” Feature
This feature enables the JungleMail ribbon button for creating new jobs from lists.
1. Log in to the SharePoint site using an account with Manage Web Site permissions.
2. Go to Settings > Site Settings > Site Actions > Manage Site Features.
3. Locate the “EnovaPoint JungleMail User Menu” feature and click the Activate button to activate the feature for the current site.


JungleMail-User-Menu-Activating-feature.png

Note: You must repeat these steps for each site on which you are going to use the JungleMail user menu.

After the activation of this feature, you will notice a new ribbon button in the lists and libraries on the current site.

JungleMail-User-Menu-Button.png

Note: this SharePoint group email product is not a SharePoint webpart solution. You do not need to place any webparts to SharePoint pages for sending group email campaigns.

Support

We hope this guide was helpful and you have successfully installed JungleMail on your servers.

If you need help installing or configuring JungleMail please contact our support team via e-mail at support/enovapoint/.com or by filling the support form.