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.

ℹ️ Important: The Sanas app supports installation on IGEL OS versions 11 and earlier, with custom app deployment.

Before you begin;

• 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 installation is divided into 5 key steps, covering the app preparation in steps 1 to 3, and deployment in steps 4 and 5.

1. 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.

2. 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.

3. Upload files to IGEL Universal Management Suite (UMS)

   1. Navigate to the UMS Console.

   2. Go to Files → New File.

      

   3. Upload both prepared files from the previous steps:

      • Sanas-4.1.12-prod.tar.bz2

      • Sanas-4.1.12.inf

        

   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
     

4. Create and configure a new profile

   1. Profile creation

      1. In UMS, go to Profiles → 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.

         

      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.

           

      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

         

      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.

         

   4. Configure the application

      1. In the profile, go to:

         System → Firmware Customization → Custom Application

      2. Create a new session named Sanas.

         

      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

           

         • Customize desktop integration settings as required.

           

      iv.   Save the profile.

5. 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.

6. Launch and activate

   1. Double-click the Sanas app icon on the IGEL desktop.

   2. Enter your Workspace ID and User ID.

      

   3. Click Activate Key to activate the app.

      

Support