Neverfail for Lotus Domino Plug-in Fails to Install with Illegal Characters in the Path



This Knowledgebase article provides information about Neverfail for Lotus Domino Plug-in failing to install with the error:

Illegal characters in path.

More Information


When attempting to install the Neverfail for Lotus Domino Plug-in, the pre-installation check fails with the following error message:

[Primary Pre Install Checks] The plugin : D:\Install Files\amx\LotusDomino\LotusDominoNFPlugin.dll failed its pre-install checks with the following errors :
The plugin <D:\Install Files\amx\LotusDomino\LotusDominoNFPlugin.dll> failed to execute it's pre-install checks, AMFx error : Unable to install plugin: Illegal characters in path.
The pre-install check failed. The installation may not continue.


The Lotus Domino plug-in will consider illegal any characters (including blank spaces) present after the notes.ini file path from this registry value name:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Lotus Domino Server (LotusDominoDataPath)\ImagePath

For example, if the Domino path is D:\Apps\Lotus\Domino\Data, the resulting registry value name is:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Lotus Domino Server

And its default value is:

"D:\Apps\Lotus\Domino\nservice.exe"  "=D:\Apps\Lotus\Domino\notes.ini"

If one or more characters are present after the notes.ini path (for example, the Domino java console is used):

"D:\Apps\Lotus\Domino\nservice.exe"  "=D:\Apps\Lotus\Domino\notes.ini" -jc

The plug-in installation will fail.


Note: Plug-ins should be installed only on the active server. Installation of a plug-in on a passive server may cause an Exception to occur.

  1. To resolve this issue and allow the installation to continue, follow the steps below:
  2. Press the Back button in Neverfail Heartbeat Setup window.
  3. Open the registry value using regedit.exe.
  4. Remove all characters after the last notes.ini quote.
  5. Proceed with the Neverfail Heartbeat or separate plug-in installation.
  6. Edit the registry value name back to its original value.

Side Effect

The above recommended changes in the registry will allow the pre-install check to finish and the successfull instalation of the Domino Plug-in. But, once the registry value is changed back to its original value (step 6 in Resolution) and the install is completed, the File Filter Discovery task will return a similar error after Neverfail is started:

"Task/Rule File Filter Discovery cannot be configured Illegal characters in path."

For fixing this problem, one of the two methods below can be used:

Method 1 :

Disable the File Filter Discovery task and manually add new file filters as needed.

Method 2:

Edit the registry key value such that there aren't any characters present after the notes.ini file path.

Applies To

Neverfail for Lotus Domino V201.5.1 and Later

Related Information



0 out of 0 found this helpful



Please sign in to leave a comment.