How to Install Sisense Add-ons

[Liliia_DevX]

How to Install Sisense Add-ons

This article provides instructions on how to install plugins if you have access to the server where Sisense is installed. Before installing any add-on, please review the README.md file, plugin manual, or guide on the marketplace. 

Note: this guide is created for add-ons published by Sisense. The installation instructions could be different for partners' or community solutions. 

Windows:

• If you run Sisense on Windows on-premises, to install any free add-on published by Sisense on the marketplace, you need to follow the instructions below:

1. Download the attachment.
2. Extract the .zip folder into the plugins folder: C:\Program Files\Sisense\app\plugins. If the folder does not exist, create it before extracting the .zip file.

Note: For multi-node Windows deployments, check the Service Mapping table of the corresponding deployment model and put plugins into the node where Sisense.Plugins service should be running. 

• For premium Sisense add-on installation on-premises, please follow installation instructions in the README.md file or in the plugin manual. 

Linux

• For free certified Sisense add-ons running on Linux, usually there is no need to install or update them manually (via File Manager, see Uploading Files to Customize Your Linux Deployment for more details). They're preinstalled and should be updated automatically within the Sisense application upgrade. 
• For the majority of premium Sisense add-ons installation on-premises, you need to have access to the server. Premium plugins contain a README.md file with instructions on how to install and use the plugin. However, in most cases installation via bash script steps are the following:

1. Connect to the server via SSH. For multi-node, connect to the node or bastion where you have access to the cluster. 
2. Download the plugin to the server. For example:
   ‘wget https://example.com/Sisense.{addon-name}.zip’ 

Where URL - URL of the file or directory you want to download or synchronize. In case you were provided with the archive instead of the download URL, upload the file to the server first.

3. Extract the 'Sisense.{addon-name}.zip'. For example:
'unzip Sisense.{addon-name}.zip'.

4. Navigate to the 'scripts' folder inside the extracted folder. For example:
‘cd /opt/sisense/storage/Sisense.{addon-name}.{version}/scripts’.

5. Run script 'bash ./l-addon-script.sh -i'.

6. All required pods should restart automatically. This may take a few minutes.

7. Review a README.md file, manual, or guide on the marketplace to check if any additional steps should be applied to complete the specific plugin installation process and proceed with its configuration accordingly. 

I hope this helps to install the Sisense add-ons smoothly! Feel free to share your experience or difficulties during the plugin installation process with us. We'll be happy to assist you 😊

[Astroraf]

Step 12 on the readme file for the Sisense Custom Data Security Add-on is very unclear. Can we get more clarification on this @Liliia_DevX 

[Liliia_DevX]

@Astroraf do you refer to this step "12. Verify the interceptor status (it should be enabled)"? 

[Astroraf]

@Liliia_DevX yup, it's just a little unclear what they mean in the directions since we already checked on this

[Liliia_DevX]

@Astroraf Thanks for the clarification. According to the instructions in the readme file, you should check if ServerSidePlugins is enabled. If it's enabled on your instance, just ignore this step. If you see the same steps listed twice in the instructions, please clarify the add-on version for us to review it.