Uploading Files to Customize Your Linux Deployment

Sisense enables you to upload files so you can customize your Linux deployment with custom connectors, add-ons, translations, and re-branded dashboards. These files are stored in your Linux shared storage.

With your Sisense Administrator credentials, you can manage these files for customization through the File Manager in the Sisense Admin page, or by using Kubernetes CLI commands.

For an explanation of File Management, watch this video:

Uploading Files Using the File Manager

You can use the File Manager to upload your static customized files for your Sisense deployment. The File Manager displays a list of the directories where the relevant customized files can be stored in your shared storage.

The following list are the folders where your customized files should be placed. The list includes links to relevant topics with more information about the files stored in each folder.

  • branding : The customized files for rebranding Sisense, see White Labeling Sisense.
  • emails : The customized automated Sisense emails, see Rebranding Emails .
  • plugins : The location for add-ons/plugins.
  • samples : The sample ElastiCubes included in your deployment.
  • translations : The translations of the Sisense interface.

To access the File Manager:

Navigate to the Admin page, search for and select System Management which is located under Server & Hardware, and click File Management.

The File Manager appears in a new browser window.


Note:

The File Management feature must be in enabled in Feature Management in order for it to appear here.

You can upload files by opening the relevant directory and dragging the files into your browser.

See File Management Automation for File Management if you have your own automation for managing files via API for:

  • Authenticating API calls
  • Uploading files and folders
  • Deleting files and folders
  • Renaming files and folders
  • Creating new files and folders
  • Moving files and folders

Note:

Droppy is an obsolete file browser. It has been replaced with the FileBrowser service.

If you prefer to use the Droppy file sharing platform instead of the default file manager:

  1. Use the Kubernetes command line tool to scale down the file browser deployment.


      
      
      
                                      kubectl scale deployment -n sisense filebrowser --replicas=0
                                  

  2. Scale up the Droppy deployment.


      
      
      
                                      kubectl scale deployment -n sisense droppy-replicas=1
                                  

  3. In Sisense , navigate to the Admin page and select System Management > Configuration.

  4. Click five times on the Sisense logo. The Advanced Configuration page appears.

  5. From the menu, select Api-Gateway and navigate to the Filebrowser section.

  6. Enter the following value for the filebrowser.proxyUrl field: droppy:8989.

  7. Click Save Changes.

Note:

For more information about Droppy support for Sisense versions L2021.3 and earlier, see:

Uploading Files Using the Kubernetes CLI

You can use Kubernetes CLI commands to upload your static customized files for your Sisense deployment.

The following command uploads files to the plugins folder path. You can modify the command to upload files to any other folder in your Sisense shared storage.

  • ${SISENSE_NAMESPACE}: Sisense namespace name (default: sisense)
  • ${PLUGIN_FOLDER}: Plugins folder path on the server
      
                  kubectl cp -n ${SISENSE_NAMESPACE} ${PLUGIN_FOLDER} $(kubectl get pods -n ${SISENSE_NAMESPACE} -l
                  app=management --no-headers -o custom-columns=":metadata.name"
                  ):/opt/sisense/storage/plugins/${PLUGIN_FOLDER}
              

Downloading Files Using the Kubernetes CLI

You can use Kubernetes CLI commands to download files from your Sisense shared storage.
The following commands download files from the plugins folder path. You can modify the commands to download files from any other folder in your Sisense shared storage.

  • ${SISENSE_NAMESPACE}: Sisense namespace name (default: sisense)
  • ${PLUGIN_FOLDER}: Target folder path for downloading
      
                  kubectl cp -n ${SISENSE_NAMESPACE} $(kubectl get pods -n ${SISENSE_NAMESPACE} -l app=management
                  --no-headers -o custom-columns=":metadata.name" ):/opt/sisense/storage/plugins
                  /${PLUGIN_FOLDER}
              

Example:

      
                  kubectl cp -n sisense $(kubectl get pods -n sisense -l app=management --no-headers -o
                  custom-columns=":metadata.name" ):/opt/sisense/storage/plugins/jaqline /jaqline
              

In this example, sisense.sh is the file specified for downloading.