IGEL: Install Sanas app

This guide provides comprehensive instructions to install the Sanas app on an IGEL environment. The installation method covered in this guide is for custom app deployment on older IGEL OS, and IGEL OS 12.

Before you begin:

For IGEL older IGEL OS (below version 12), you must have received the Sanas app package .tar.bz2 from Sanas. If not, contact Sanas Support for assistance.
Ensure you have the required administrative privileges to deploy the custom app on the IGEL environment.

Installation procedure

IGEL OS 12

IGEL OS older versions

Sanas is available on the IGEL App Portal.
Sanas is now IGEL-verified and available on the IGEL App Portal for IGEL OS version 12. The Sanas app can be downloaded directly from the App Portal on endpoint machines or deployed by admins through IGEL UMS.

The guide below explains how to install the Sanas application on an IGEL machine running OS version 12 or later. If you are running an older IGEL OS version, please refer to the applicable procedure available in this guide.

Installing Sanas directly on the endpoint machine

Log in to your IGEL machine using your credentials.
Launch the IGEL App Portal.
Search Sanas through the search field, or look for Sanas under the Unified Communication app category.
Select Sanas from the search result, then click Install.
Sanas on IGEL App Portal
Click Continue to proceed with the installation. Downloading starts automatically.
Confirm installation
You’ll need to restart your machine to start using Sanas. Click Restart now to proceed.
Once back, launch the Sanas app and enter your credentials (Workspace ID + User ID) and click Activate.
Refer to the Sanas User Guide for detailed instructions on using the Sanas app.

Installing Sanas through IGEL UMS

This guide helps you to deploy the Sanas app through IGEL UMS on the connected endpoint IGEL machines.

Log in to IGEL UMS as admin using your credentials.
Navigate to the App Portal.
Search Sanas through the search field, or look for Sanas under the Unified Communication app category.
From the search results, click Import to proceed with installation.
Import Sanas to IGEL UMS
Click Continue to confirm your action.
Confirmation
Once imported, set the app download method on the endpoint devices.
1. From the App Portal page, navigate to Settings.
  App Portal Settings
2. Under Device should download the Apps from drop down menu, select Download directly from App Portal then click Save.
Now, from the UMS portal, select Devices from the left-side navigation bar and select the endpoint device where you wish to deploy Sanas.
Select an endpoint device for deployment.
Click Assign Object, then select and drag Sanas from the Available Objects to the Assignments section. Select your desired Sanas app version to deploy from the drop-down menu, if required.
Assign object
Click Save and apply on reboot to apply the changes. Sanas gets installed after rebooting the endpoint machines.
Test the Sanas app by launching and activating the app. You'll need the Workspace and User ID for activation. Refer to the Sanas User Guide for detailed instructions on using the Sanas app.

IGEL installation is divided into 5 key steps, covering the app preparation in steps 1 to 3, and deployment in steps 4 and 5.

Keep the Sanas app package ready
Ensure you have received the Sanas app package file (.tar.bz2) and have kept it ready to upload in the upcoming steps. If you haven’t received the file from us, contact Sanas Support for assistance.
Create the inf configuration file
The .inf file communicates with IGEL OS about application archive handling.
1. Open a text editor of your choice on your Linux or Windows machine.
2. Create a new file named:
```
Sanas-4.1.12.inf
```
3. Add the following configuration details (example structure shown below — adapt as needed for your environment):
  📔Notes:
  1. The configuration below uses the package name based on the file provided by Sanas, and may change in the future based on the app package version.
  2. The value for mount “/sanas" must be replaced with the currently used mount you’ve used to deploy other apps.
```
[PARTITION]
name=Sanas
version=4.1.12
archive="Sanas-4.1.12-prod.tar.bz2"
size=400M
mount=/sanas
```
4. Save the file.
Upload files to IGEL Universal Management Suite (UMS)
1. Navigate to the UMS Console.
2. Go to Files → New File.
  Create a new file
3. Upload both prepared files from the previous steps:
  - Sanas-4.1.12-prod.tar.bz2
  - Sanas-4.1.12.inf
    Upload prepared files
4. Set the Device File Location to:
```
/wfs/<filename>
```
- Confirm that the files are available by opening them in a browser:
```
https://<server:port>/ums_filetransfer
```
Create and configure a new profile
1. Profile creation
  1. In UMS, go to Profiles → New Profile
    Create a new profile
  2. Enter a Profile Name and Description.
  3. Select the correct IGEL OS version.
    📔Important: The Sanas app supports installation on IGEL OS versions 11 and earlier, with custom app deployment.
    Enter description and select OS version
  4. Open the created profile.
2. Profile configuration
  1. Go to,
    System → Firmware Customization → Custom Partition → Partition
  2. Enable Partition, Size & Mount Point.
  3. Set:
    - Mount Size: 400 MB (recommended)
    - Mount Point: <enter_name> ; For example, the below image shows /sanas as the mount name.
      📔Note: /sanas is an example mount. Please use your existing mount that is used to deploy other apps.
      Select partition size and mount
  4. Save the settings.
3. Link the inf configuration file
  1. Navigate to the URL below and copy the .inf file URL:
```
https://<server:port>/ums_filetransfer
```
    Copy link of uploaded .inf file
  2. In the profile, go to:
    System → Firmware Customization → Custom Partition → Download
  3. Click Add and paste the URL.
  4. Enter the Username and Password, then Save.
    Enter values for URL, User name, and Password
4. Configure the application
  1. In the profile, go to:
    System → Firmware Customization → Custom Application
  2. Create a new session named Sanas.
    Enter session name
  3. Configure icon name and command:
    ℹ️Important: The paths shown below are examples. Your path directory will differ based on the mount selected in the previous steps.
    - Icon Path:
```
/<mountname>/Sanas-4.1.12-prod/data/flutter_assets/assets/icons/icon.png
```
      Example: Below is a sample command with the mount name ‘custom’
      /custom/Sanas-4.1.12-prod/data/flutter_assets/assets/icons/icon.png
    - Command to Launch:
```
/<mountname>/Sanas-4.1.12-prod/sanas_app
```
      Example: Below is a sample command with the mount name ‘custom’
      /custom/Sanas-4.1.12-prod/sanas_app
      Enter icon name and command values
    - Customize desktop integration settings as required.
      (Optional) Customize deskotp integration
  iv. Save the profile.
Deploy the profile to devices
1. Assign the new profile to the desired IGEL devices or directories.
2. Restart the devices.
3. On reboot, IGEL will:
  - Mount the custom partition.
  - Install the Sanas application.
  - Display the Sanas app icon on the desktop.
Launch and activate
1. Double-click the Sanas app icon on the IGEL desktop.
2. Enter your Workspace ID and User ID.
  Launch the Sanas app
3. Click Activate Key to activate the app.
  Activate the app, and start using it.