Failed to access NFS share on Windows server when using HCL Connections™ Docs

Troubleshoot failure to access NFS share on Windows server when using HCL Docs.

Problem

There is an issue when publishing a document. In SystemOut.log for the Conversion server or cluster, the following error is displayed:

[5/19/15 11:18:53:037 CST] 00000113 ConversionWor I   conversion started, application/json, 
application/vnd.openxmlformats-officedocument.wordprocessingml.document, 
W:\draft\default_org\draft\58\72\ccc7ef8b-04e4-4603-a8bd-0a296504677c\temp\abc99e82-f826-48bf-b6a7-bcd017a9c772\concord

[5/19/15 11:18:53:037 CST] 00000113 ConversionWor I   conversion is cancelled because 
W:\draft\default_org\draft\58\72\ccc7ef8b-04e4-4603-a8bd-0a296504677c\temp\0fe87a71-4828-4eee-932d-b44b05fd603e does not exist 
when converting W:\draft\default_org\draft\58\72\ccc7ef8b-04e4-4603-a8bd-0a296504677c\temp\abc99e82-f826-48bf-b6a7-bcd017a9c772\concord. 
Please check NFS configuration

Cause

If the node and server are configured to start automatically along with the Windows Operating System, they will be system services running with a user name of SYSTEM. Check services with the Task Manager. If the user name for java.exe is displayed as SYSTEM, the mount must also be done with a user name of SYSTEM. Otherwise, the NFS shares will not be able to be accessed from the node or server.

Resolving the problem

  1. Create a batch file, for example, :\IBMConversionNFS\nfsmount.bat, and type:
    mount -o mtype=soft retry=10 timeout=6 casesensitive=yes anon DocsLab01.renovations.com:/nfs/docs_data W:

mount -o mtype=soft retry=10 timeout=6 casesensitive=yes anon DocsLab01.renovations.com:/nfs/viewer_data Y:
  2. Click Start > Administrative Tools > Task Scheduler.
  3. Click Create Task in Task Scheduler (Local).
  4. Click General, and type nfs_auto_mount for the name. In Security options, click Change User or Group > Advanced > Find Now, and select SYSTEM. Select Run whether user is logged on or not and Do not store password, and then select Run with highest privileges. Then click OK.
  5. Click Triggers > New, select At startup for Begin the task. Click OK.
  6. Click Actions > New > Browse, select c:\IBMConversionNFS\nfsmount.bat and click OK.
  7. Click OK.
  8. Unmount all the mounted points. Right-click the task and then click Run. The client mounted points will be displayed in Windows explorer as Disconnected Network drivers, which is the expected normal status.