Chat now with support
Chat with Support

Metalogix Content Matrix 8.8 - Advanced Installation Guide

Configuration

This section describes some of the basic configuration options that are required to quickly get up and running with the Metalogix Content Matrix Console Extensions Web Service and Email Viewer.

Configuring the Extensions Web Service

While there are no settings that need to be configured for the Extensions Web Service, there is a way to confirm that they are installed correctly and are working.  

Confirming the Metalogix Extensions Web Service is Installed and Working

After installing the Extensions Web Service, you should check to make sure that it was installed correctly. To do this you can attempt to connect to the web service page in a browser window by entering: [YourSiteURL]/_vti_bin/ml/[Extensions Web Service version number]/mlspextensions.asmx. For example, if the Extensions Web Service (version 8.7.0.1) is installed on a server named SharePointServ, then you would enter:

SharePointServ/_vti_bin/ml/8.7.0.1/mlspextensions.asmx.

If this command does not successfully connect to the Metalogix Extensions Web Service web page, then it may mean that the Web Service was not installed on all Web Front Ends for this farm.

Another method that can be used to check if the Extensions Web Service was installed is to go to the Solution Management page in Central Administration and see if the metalogix.sharepoint.adapters.extensions.X.X.X.X.wsp file is listed (where "X" is replaced by the version number). Users can find the Solution Management page at:

·SharePoint 2007 - Central Administration > Operations > Solution Management.

·SharePoint 2010, 2013, and 2016 - Central Administration > System Settings > Farm Management > Manage farm solutions.

Configuring Email Viewer for Public Folder Edition

After installation of the Email Viewer web part is complete, you will need to manually enable it in order for the web part to be used. This is because the Email Viewer web part would otherwise make changes to the web.config file for the environment it is installed on, so in order to enable it for use, some settings need to be manually configured in the web.config file.

This file is generally found on the server that the Email Viewer web part is installed on, at the following location:

C:\inetpub\wwwroot\wss\VirtualDirectories\<Port>\

There are two changes that need to be made in the web.config file to enable the Email Viewer for use. These changes primarily center around the Session State settings, and should be made by an Administrator. The following steps should help guide you through these changes.

1.On the target SharePoint server where the Email Viewer Web Part is installed, open the web.config file  in Notepad or a similar program, where it can be edited.

This can also be reached by going into your Internet Information Services (IIS) Manager, selecting your SharePoint Site (under "Sites"), the right-clicking on the SharePoint site node and choosing Explore. This will open a Windows Explorer window to the desired folder.

2.Search for the httpModules tag (it may be an empty tag that looks like this: <httpModules />

If the httpModules tag already contains content, you will need to add a new line under the node. If the tag doesn't have any listed modules (i.e. it is a closed tag) you will need to replace <httpModules /> with <httpModules> </httpModules>

3.Add the following line as a child under the httpModules tag.

<add name="Session" type="System.Web.SessionState.SessionStateModule" />

4.Find the enableSessionState tag and ensure that it is set to True.

5.Save the web.config file.

You should now be able to view and use/load the Email Viewer Web Part in your target SharePoint environments.

If the Email Viewer is still not work after adding the extra line to the <httpModules> tag, find the <modules runAllManagedModulesForAllRequests="true">  tag and remove the line <remove name="Session" />.

If you are encountering further issues with the Email Viewer, see the "Email Viewer Web Part Troubleshooting" page of the Metalogix Content Matrix Public Folder online help for possible tips and troubleshooting steps.

Related Documents