How to access a Windows shared network path from Spotfire Web Player running on Node Manager in Linux OS.

How to access a Windows shared network path from Spotfire Web Player running on Node Manager in Linux OS.

book

Article ID: KB0137482

calendar_today

Updated On:

Products Versions
Spotfire Web Player 12.0 LTS and later

Description

To access files on a Windows network shared drive from a Linux system, you must mount the shared folder on the Linux machine and modify the Spotfire.Dxp.Worker.Host.dll.config file accordingly.

This article outlines the step-by-step process for:

  1. Mounting the shared drive using /etc/fstab to ensure it is automatically mounted at system startup.
  2. Configuring the Spotfire.Dxp.Worker.Host.dll.config file to enable seamless access to the mounted files

Environment

Web Players Installed on Linux Operating System

Resolution

A)Steps to mount a shared file in Linux using /etc/fstab


============================
1. Install the cifs-utils package if not present already using the below commands

    sudo apt-get install cifs-utils # On Debian/Ubuntu 
    sudo yum install cifs-utils # On CentOS/RHEL

2. Create a Mount Point.

    sudo mkdir /mnt/test

3. First mount the share manually to check if the network connectivity is fine and everything is working correctly using the below command. No errors should be thrown on running the below command. This assumes the share allows guest access.

    sudo mount -t cifs //gasdspssanwin01/test /mnt/test -o guest

Replace guest with username=your_username, and password=your_password if authentication is required on your Windows network share as shown below.

    sudo mount -t cifs //gasdspssanwin01/test /mnt/test -o username=your_username,password=your_password

4. Now edit the /etc/fstab file with any editor of your choice.

    sudo vim /etc/fstab

Add the following line at the end of the file, replacing placeholders with your actual values

    //gasdspssanwin01/test /mnt/test cifs username=your_username,password=your_password,iocharset=utf8,vers=3.0 0 0

5. Now unmount the share that we have mounted manually in step 3 using the below command

    sudo umount /mnt/test

6. Once the above step is done now mount all entries in /etc/fstab using the below command

    sudo mount -a

7. Check if the share is mounted correctly by running the below command

    ls /mnt/test

8. Reboot your system to ensure the share mounts automatically at startup
==========================

 

B)Steps to configure Spotfire.Dxp.Worker.Host.dll.config and how to specify the path in the AllowedFilePaths section.

===============================
1. To whitelist a Windows path and corresponding Linux path assuming that the "test" is mounted under "/mnt/test".

2. In the "Spotfire.Dxp.Worker.Host.dll.config " the allowed file path should be mentioned with the pipe operator (|) in between Windows network share and the Linux mounted path as shown below

      <setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string>\\NetworkPath1\test|/mnt/test/</string>
          </ArrayOfString>
        </value>
      </setting>

3. Please refer to the below article for the steps to edit the service configuration
https://docs.tibco.com/pub/spotfire_server/latest/doc/html/TIB_sfire_server_tsas_adm[…]/topics/manually_editing_the_service_configuration_files.html
============================

Issue/Introduction

This article outlines the steps to access a Windows-shared network path from a Spotfire Web Player installed on Linux Operating System.

Additional Information