TOutlookPlugin

Error: Deployment and Application do not have matching security zones.

Issue Description: Outlook plugin could not be installed use to security zone issue.

Workaround: 

Please follow the below procedures.

1. Remove email plugin from registry if installation have security zone/other issue.

The steps are as follows: Please delete the highlighted keys mentioned in the below screenshots.

a)

 

 

b) c)d) 

e)

f)

2.  After these keys are deleted, open Outlook to make sure that the plugin is not available in COM Addins (File -> COM AddIns). Then delete the relevant files from C:\Users or D:\Users that correspond to the following locations:

(Example: Here nxgen.vendor2 is username)

3. Close Outlook.

4. Plugin installation must be done after Outlook is closed.

5. After this, ensure that the installation file directory is available in the IE Secure sites. (Ex: \\mbsvacmmprd02\Tetherfi)

6. Following this, proceed to install the plugin by double-clicking the vsto file in the installation path (Ex: (\\mbsvacmmprd02\Tetherfi\PRD\PluginPublishLocation\).

7. After selecting “Install” in the popup window, wait until installation in complete. Then close the window by clicking on the “Close” button.

8. Verify that the plugin is installed by launching Outlook.

This must solve the issue.

TMAC tab from Outlook not removed even after uninstalling Outlook plugin.

Issue Description: Outlook plugin application is been uninstalled but user still can see the TMAC tab in outlook profile.

Workaround:

Navigate to the windows control panel and check if Tetherfi Outlook Plugin is uninstalled successfully. If present, then try removing/uninstalling it again.

 

 

 

 

 

 

 

If above doesn’t work, On your outlook profile click on File -> Options which will open up below window,

On the left menu list, select Add-ins which will show below a window.

Select Tetherfi Outlook Plugin under Add-ins then click on the button “Go”. On click of Go, below window will open up,

By default, a checkbox will be ticked for Tetherfi Outlook Plugin. Uncheck the checkbox and click on button Remove and then click OK.

This must solve the issue.

 

Error: Same identity is already installed, Unable to install Outlook Plugin.

Issue Description:

This issue occurs usually after uninstalling the current Tetherfi Outlook Plugin version from the control panel window and then user again tries to install the same version of the file.

Error window is shown while installing a plugin

 

Resolution:

Uninstalling Tetherfi Outlook Plugin from the windows control panel sometimes will not remove all files from the installation directory path.

This issue occurs only when the user tries to run the same version (i.e. previously uninstalled) files again.

To solve this problem, follow steps as below,

  1. Navigate to path C -> Users and select the logged-in user id/LANID folder.

 

As shown in the above screenshot, my username or login name is User. In your case, it might be different, might be a system login name or                     Lan-ID or any configured name.

Once you identify correct folder, then navigate further to below path,

C -> Users -> (UserLanID/UserProfileFolder) -> AppData -> Local -> Apps -> 2.0

Once you are able to navigate till above folder path, you will notice two folders (as shown below) inside 2.0 folder,

Both folders are created at the install time of the Tetherfi Outlook Plugin application. Folder W47RZ0NJ.575 is a random folder

generated by Plugin on installation, hence it might be with a different name in your location.

Delete both the folders and try installing the plugin again. This must resolve this issue.

2.    If the issue still persists we suggest you check out our below post and follow our instructions provided there.

Error: Unable to install, TetherfiOutlookPlugin.dll.config has a different computed hash than specified in the manifest.

 

Emails are being read successfully by Email Manager, but Outlook doesn’t reflect same.

Issue Description: Emails are being polled by Email Manager successfully, however in outlook user can’t perform email actions.

Troubleshooting steps:

  • For an email account, if Outlook routing is to be enabled then column OutlookRoutingEnabled value in Email_AccountConfiguration table must be configured to 1. A sample screenshot is attached below for reference,

Email account configuration table

  • Validate if the Outlook plugin is installed successfully, to verify follow below two steps.
    • go to the windows control panel, look for Tetherfi Outlook Plugin application name under programs and features list.
    • when the plugin is been installed successfully, custom tab TMAC will appear in Outlook as shown below.

Tetherfi Outlook Plugin Ribbon tab

  • Open Outlook plugin configuration file ("TetherfiOutlookPlugin.dll.config.deploy")
    • verify if the Tetherfi outlook plugin is configured with a valid email account that needs to be monitored also verify whether web socket URLs and Tetherfi HTTP proxy URLs are configured correctly in the outlook plugin configuration file. Refer below screenshot for more information.

      Outlook plugin application configuration file

 

 

 

 

 

 

Where the client log is written for Tetherfi Outlook Plugin?

Tetherfi Outlook plugin logs are by default written in below windows path,

  • Navigate to path C -> Users and select logged-in user id/LAN-ID folder.

 

  •  As shown in above screenshot, my username or login name is User. In your case, it might be different, might be system login name  or Lan-ID or any configured name.
  • Once you identify correct folder, then navigate further to below path,
    C -> Users -> (UserLanID/UserProfileFolder) -> AppData -> Local -> Apps -> 2.0
  • Once you able to navigate till above folder path, you will notice two folders (as shown below) inside 2.0 folder,

 

  • These both folders are created at install time of Tetherfi Outlook Plugin application. Folder 84E3J0RY.8K8 is a random folder generated by Plugin on installation, hence it might be with different name in your location.
  • Open folder 84E3J0RY.8K8(in your case folder might be with different name), one more folder with random name can be seen, open it and navigate further till below folder path.

  • File present inside this path with name logger.log is client /Tetherfi Outlook Plugin log file.

 

 

Error: Unable to install, TetherfiOutlookPlugin.dll.config has a different computed hash than specified in the manifest.

Issue Description: When the config file of the Tetherfi Outlook plugin is been changed manually before deploying or running the installation file this issue occurs.

Resolution:

  • Files get corrupted if changed manually, delete all files and re-take fresh build from the release folder and try installing.
  • If the above method doesn’t work, then try removing add-in files from the registry.
    • To navigate to below registry path, run windows command “regedit”, this will open the registry window. Then navigate to below root folder,Registry Path:Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\AddIns\TetherfiOutlookPlugin
      Note: Please be more conscious while modifying registry. However, this is not recommended to do as it is risky to modify registry files, instead we recommend going with below approach.

      Plugin Registry location.

      Note: Please be more conscious while modifying the registry. However, this is not recommended to do as it is risky to modify registry files. Instead, we recommend going with the below approach.

  •  Try upgrading the application to a newer version or request our team to build the same files with different manifest file version.

Can Tetherfi Outlook Plugin be deployed in any system to monitor any email accounts?

No, Since Outlook Plugin is a Click-Once application release files will always come with pre-configured email accounts. Application will only monitors these pre-configured accounts.