Establish Connectivity to Samba Filesystem

This article details how to establish connectivity to Samba Filesystem  to use it as Data Source for creating Elements in Metric Insights.

PREREQUISITE:

TABLE OF CONTENTS:

  1. Add New Data Source
  2. Provide Required Parameters
  3. Configure Optional Parameters
  4. Advanced Configuration
  5. Other Settings

1. Add New Data Source

Access Admin > Collection & Storage > Data Sources

  1. [+New Data Source]
  2. Choose "Samba Filesystem" from Plugin drop-down list
  3. [Next]

 

2. Provide Required Parameters

  1. Enter a descriptive Data Source Name
  2. [Create]
  3. Domain: Your organization's Kerberos realm
  4. Kerberos File Path and Login Config File Path: Paths to the previously created .conf files
    • NOTE: The paths are relative to the Remote Agent folder
  5. Login Context Name: Enter the value from the login.conf file
    • Example: KerberosLogin
  6. Path: Enter a path to files or a folder within the shared folder specified in the Share name
  7. SMB server: Domain name of the SMB server
  8. Share name: Name of the shared folder
  9. Username: The user who generated the Kerberos ticket
  10. Display Files: Select how files will be displayed in the External Content Viewer and Editor
    • Individually: Each file is displayed individually
    • Grouped within Each Folder: Files are grouped by their  containing folder. In the External Content Viewer, the most recent file  is displayed by default, with a drop-down menu allowing to select other  files from the folder

Optionally, toggle on Enable On-Demand Element Creation and Enable Content Auto Synchronization.

3. Configure Optional Parameters

  1. CSV Delimiter: Choose the delimiter character used in your CSV files
    • "," is the default value
  2. Extension filter: Provide a comma-separated list of file extensions to fetch only files with the specified file extensions
  3. Files filter: Collect only files that match the defined filters.
    • "*" can be used as a wildcard
  4. Includes headers: Choose whether the first row of the CSV file should be treated as column headers ("true") or as a regular data row ("false")
    • Accepts "true"/"false"
    • "True" is the default value
  5. Include Excel sheets: Choose whether to extract and return metadata for each worksheet within Excel files ("true") or treat each file as a single document ("false")
    • Accepts "true"/"false"
    • "False" is the default value
  6. Retrieve empty folders: Choose whether to fetch empty folders
    • Accepts "true"/"false"
    • "False" is the default value
  7. Use absolute path as report Id: Select whether the Report ID displayed on the Source Objects tab should include the path from the Path parameter
    • The default value is "true"

4. Advanced Configuration

  1. Use Remote Agent: Yes
  2. [+New Remote Agent], select the previously configured Remote Agent

Other Advanced Configuration settings can be set to default values unless Data Source requires more precise tuning. For more details on how to  proceed, refer to Advanced Data Source Configuration.

5. Other Settings

  1. You can create Datasets and view all the elements or Datasets using this Data Source from the respective tabs
  2. Open the Access tab to assign Data Source access to Groups or Power Users