Troubleshooting installation or configuration

Use these tips to troubleshoot installation or configuration issues.

  • Issue: Error: Specified argument was out of range of valid values. Parameter name: entryValue
  • Solution: The Microsoft Outlook cache is corrupt. Follow these steps to clear the cache:
    1. From Windows Explorer, navigate to the following folder: C:\Users\<user>\AppData\Local\Apps\2.0
    2. Delete the \2.0 folder.
    3. Re-install HCL Mail Sync.
  • Issue: Error:
    Either there is no default mail client or the current mail client cannot fulfill the messaging 
    request
  • Solution: This error can occur during installation when the Outlook registry is corrupt.
  • Issue: Error: Value does not fall within the expected range
  • Solution: Refer to the following table for the conditions that can cause this error and actions to take for each one.
    Table 1. Conditions and actions
    Condition Action to fix
    A corrupted Microsoft Outlook cache. Clear the cache, as described for the previous issue.
    A corrupted .NET Framework.
    1. Uninstall any currently installed version of Microsoft .NET Framework.
    2. Install Microsoft .NET Framework 4.5. For more information, see this page on the Microsoft site: https://www.microsoft.com/en-us/download/details.aspx?id=30653.
    3. Run the mail client installer again.
    A conflict with a version of Microsoft Visual C++ redistributable that is later than Microsoft Visual C++ 2010 redistributable.
    1. Uninstall any version of Microsoft Visual C++ redistributable that is later than 2010 x86/x64.
    2. Run the mail client installer again.
    3. If the HCL Mail Sync install is not successful, complete the steps to repair a corrupted .NET Framework.
  • Issue: Error while the Microsoft Visual Studio Tools for Office (VSTO) file is installed, HCL mail add-in.vsto, or the file displays in the browser as XML instead of installing.
  • Solution: Install the VSTO runtime package directly from Microsoft. Then, run the HCL mail client installer again.
  • Issue: Error 1722 or an error in the Installing Office customization pane.
  • Solution: Complete the following steps:
    1. Open the Programs page in the Windows Control Panel.
    2. Uninstall Microsoft Visual Studio 2010 Tools for Office Runtime (x64).
    3. Uninstall HCL Mail Sync.
    4. Run setup.exe to reinstall the HCL mail client.
  • Issue: When you try to start Outlook after uninstalling the HCL Mail client, you see the error Cannot start Microsoft Outlook.
  • Solution: This issue occurs when HCL Mail is your default profile and you choose not to be prompted to select a profile when you start Outlook. To correct the problem, delete the Mail profile:
    1. Start the Windows Control Panel.
    2. Click Mail (32-bit).
    3. Click Show Profiles.
    4. Select the IBM mail profile.
    5. Click Remove and then Yes.
    6. Click OK.
  • Issue: The mail client is disabled. For example, when you click File, HCL Mail isn't listed.
  • Solution:
    1. Click File > Options.
    2. Click Add-ins to list the add-ins.
    3. If the HCL Mail client is shown under Disabled application add-ins, click Go.
    4. Select the HCL mail sync add-in and click OK.
    Outlook reloads the client.
    Note: If these steps do not work or the fix doesn't persist after a restart, run regedit and delete the following registry setting, if it exists: HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\HCL_mail_sync_add-in. Only use this option if you are an advanced user who is familiar with editing registry files.