KB34230: "Unable to open HTML template file (\machine-name\path-to-template file)" error occurs when running HTML documents in MicroStrategy Intelligence Server Universal 9.x and 10.x

SYMPTOM:
The following error message is received when attempting to run an HTML document from Strategy Web/Developer 9.x and 10.x, when the HMTL documents folder resides on the Strategy Intelligence Server machine, on a UNIX/Linux platform:
 
Sample Code/Error
Error: Cannot display HTML document Results
 
Unable to open HTML template file ( \\<machine-name>\shared-name/template-name ) for the document.
Please try starting the server with a network account.
Unable to open HTML template file. The server may be started with a system account. Please try starting the server with a network account.
 
The same HTML document can be edited successfully.
 
 
CAUSE:
The HTML document folder has not been properly mapped in the Strategy Intelligence Server machine. When the folder resides locally on this machine, the Samba server needs to be properly configured it accessible as \\machine-name\shared-name .
 
For more details on how to configure HTML documents with Strategy Intelligence Server Universal on Unix/Linux, refer to the following Strategy Knowledge Base technical note:
KB13899 (KB5300-753-0787): How to set up HTML Documents with MicroStrategy Intelligence Server Universal 8.x on Unix/Linux)
However, the configuration of the Samba server is just one step in the HTML document setup. The Strategy Intelligence Server Universal will use the path configured as HTML document folder location ( \\<machine-name>\shared-name ) to retrieve the HTML documents. It does this by converting the location into a UNIX formatted path and looking for the files locally. The location the server will look into for the HTML documents in /machine-name/sharename.
 
This error can be received when the folder /machine-name/sharename cannot be accessed on the Strategy Intelligence Server machine.
 
 
ACTION:
Follow these steps to complete the configuration of the HTML document folder in the Strategy Intelligence Server machine:

1. Create a folder 'machine-name' (same as the Samba configuration) in the root filesystem (/) of the machine running the Intelligence Server.
2. Change the permissions so that the account used to run Strategy Intelligence Server has access to read and write access to this location.
3. Create a folder as either hard or soft linked to the actual HTML document folder as follows:
    
   
4. ln -s /pathto/htmldocuments /machine-name/sharename

This will create a folder 'sharename' within the folder 'machine-name' which will be linked to the (Samba shared) HTML document folder. The HTML documents will successfully run after completing this configuration.
 
For example, the local folder where the HTML documents reside is /home/administrator/HTMLdocuments. The HTML document directory defined in the Project Configuration > Advanced section is: \\machineA\administrator\HTMLdocuments, since the Samba server is sharing  /home/administrator/HTMLdocuments using this path. After creating a folder with name machineA in the root filesystem of the machine, the folder can be linked as follows:
ln -s /home/administrator/HTMLdocuments /machineA/administrator/HTMLdocuments