FOSSEE · shinjini832 · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026
diff --git a/README.md b/README.md
@@ -1,17 +1,129 @@
-eSim Packaging
+
+eSim Upgradation
 ====
 
-It contains all the documentation for packaging eSim for distribution.
+This repository documents the issues encountered while installing **eSim 2.5**
+on **Ubuntu 25.04** as part of the **FOSSEE Semester Long Internship Spring 2026
+Screening Task (Task 4)**.
+
+---
+
+## System Information
+
+- Host OS: Windows (Virtualized Ubuntu)
+- Guest OS: Ubuntu 25.04
+- Architecture: x86_64
+- Internet: College Wi-Fi (No proxy)
+- Python: Python 3 (system-installed)
+
+---
+
+## Objective of the Task
+
+The objective of this task was to:
+- Attempt installation of eSim using the official installer
+- Identify bugs/issues in the installation process
+- Fix issues where possible
+- Clearly document all findings and attempts
+
+## Isusues Encountered ##
+
+### Issue 1: Missing Installation Script for Ubuntu 25.04
+
+**Issue Description**
+The eSim repository did not contain an installation script for Ubuntu 25.04.                                                                                                  Users running Ubuntu 25.04 were unable to find a corresponding installer script, which prevented them from installing eSim on the latest Ubuntu version.
+
+**Analysis:**
+On reviewing the repository, it was observed that installer scripts were available only for earlier Ubuntu versions (such as 22.04, 23.04, and 24.04). 
+The installer structure relies on version-specific scripts, and since Ubuntu 25.04 was not included, the installation process could not proceed for users on this OS version.
+
+This gap occurred because the repository had not yet been updated to support the newly released Ubuntu 25.04.
+
+**Action Taken:**
+-Identified the absence of an installer script for Ubuntu 25.04.
+-Created/added a new installer script for Ubuntu 25.04 following the structure and conventions of existing Ubuntu installer scripts.
+-Placed the script under the appropriate directory: `Ubuntu/install-eSim-scripts/`
+-Ensured consistency with existing installation logic so that the new script integrates smoothly with the current installer workflow.
+
+### Issue 2: Volare Installation Fails Due to Missing xz-utils
+
+**Issue Description**
+During the eSim installation process, the Volare package failed to install on some Ubuntu systems. The error occurred because the system did not have the xz-utils package installed, which is required for extracting .tar.xz archives during Volare installation.
+
+**Analysis:**
+The installer attempts to download and extract the Volare software.
+Extraction requires the xz command, provided by the xz-utils package.
+
+On systems where xz-utils was missing, the installer failed with errors such as:
+`E: Invalid operation xz-utils`
+
+This caused the Volare installation step to fail, halting the overall eSim installation process.
+
+The issue occurs on fresh Ubuntu installations where xz-utils is not pre-installed.
+
+**Action Taken:**
+Updated the installer script to check for the presence of xz-utils before attempting Volare installation.
+
+If xz-utils is not installed, the installer now automatically installs it using:
+`sudo apt-get install -y xz-utils`
+
+Verified that after this addition, Volare installs successfully without errors on Ubuntu systems lacking xz-utils.
+Ensured that this fix is backward-compatible and does not affect systems that already have xz-utils installed.
+
+### Issue 3: KiCad 6.0 PPA causes installation failure on Ubuntu 25.04
+
+**Issue Description**
+During the execution of the eSim installer on Ubuntu 25.04 (Plucky Puffin), the installation process fails while updating APT repositories. The installer attempts to add the KiCad 6.0 PPA (ppa:kicad/kicad-6.0-releases), which does not provide a valid Release file for Ubuntu 25.04. This causes apt update to fail and results in the installer aborting prematurely.
+
+**Analysis:**
+The main installer detects Ubuntu 25.04 and falls back to using the Ubuntu 24.04 child installer script.
+
+The child installer script contains the installKicad function, which:
+Adds KiCad PPAs based on Ubuntu version
+
+Defaults to using kicad/kicad-6.0-releases for non-24.04 versions
+
+The KiCad 6.0 PPA does not support Ubuntu 25.04, leading to the following error during apt update:
+`E: The repository 'https://ppa.launchpadcontent.net/kicad/kicad-6.0-releases/ubuntu plucky Release' does not have a Release file.`
+Since APT treats this as a fatal error, the installation process terminates with:
+`Error! Kindly resolve above error(s) and try again.
+Aborting Installation...`
+The root cause was identified as outdated PPA handling logic inside the installKicad function, which is incompatible with newer Ubuntu releases.
+
+**Action Taken:**
+The installKicad function in the child installer script was rewritten to handle Ubuntu versions more safely.
+
+The updated function:
+-Detects Ubuntu 25.04 explicitly
+-Avoids adding any external KiCad PPAs on Ubuntu 25.04
+-Installs KiCad directly from the official Ubuntu repositories, which already provide a supported KiCad 8.x version
 
+This prevents invalid repository additions, allows apt update to complete successfully, and ensures KiCad installs correctly on Ubuntu 25.04.
+The rewritten logic improves forward compatibility and avoids unsafe fallback behavior for future Ubuntu releases.
 
-# Packaging eSim for Distribution:
+### Issue 4:eSim Installer Fails Due to Missing kicadLibrary.tar.xz on Ubuntu 25.04
 
-1. eSim is currently packaged and distributed for Ubuntu OS (Linux) and MS Windows OS.
+**Issue Description**
+The eSim installation script aborts with a fatal tar error after successfully installing KiCad. The installer attempts to extract a KiCad library archive (library/kicadLibrary.tar.xz) that does not exist in the expected path, causing the installation to terminate prematurely.
 
-2. Refer the [documentation](Version_Change.md) for the changes to be done when a new release is to be made.
+Although KiCad is installed correctly via APT, the overall eSim installation fails due to this missing file.
 
-> Note: These changes have to be made `first` before proceeding with the packaging on either platform.
+``KiCad installation completed successfully!
+tar (child): library/kicadLibrary.tar.xz: Cannot open: No such file or directory
+tar (child): Error is not recoverable: exiting now
+tar: Child returned status 2
+tar: Error is not recoverable: exiting now
+Error! Kindly resolve above error(s) and try again.
+Aborting Installation...
+``
 
-3. Refer the [documentation](Ubuntu/README.md) to package eSim for Ubuntu OS.
+**Analysis:**
+The installer script assumes the presence of library/kicadLibrary.tar.xz.
+This file is not present in the library/ directory at runtime.
 
-4. Refer the [documentation](Windows/README.md) to package eSim for Windows OS.
+Possible causes:
+The library archive is not included in the repository or release package.
+Git submodules or LFS-tracked files were not initialized or fetched.
+The script uses a hardcoded relative path that breaks if executed from a different directory.
+The installer is not compatible with Ubuntu 25.04 and expects an older directory structure or packaging logic.
+Notably, KiCad itself installs successfully, indicating the failure is isolated to the eSim-specific KiCad library extraction step.
diff --git a/Ubuntu/README.md b/Ubuntu/README.md
@@ -1,37 +1,127 @@
-eSim Installer (Ubuntu OS)
+eSim Upgradation
 ====
 
-It contains the documentation to package eSim for Ubuntu OS.
+This repository documents the issues encountered while installing **eSim 2.5**
+on **Ubuntu 25.04** as part of the **FOSSEE Semester Long Internship Spring 2026
+Screening Task (Task 4)**.
 
-> Note: If planning to freeze the eSim source code for a target platform (Ubuntu OS), then refer this [documentation](executable.md). Remember to update the installer script to work with this executable!
+---
 
+## System Information
 
-## How to package eSim for Ubuntu OS?
+- Host OS: Windows (Virtualized Ubuntu)
+- Guest OS: Ubuntu 25.04
+- Architecture: x86_64
+- Internet: College Wi-Fi (No proxy)
+- Python: Python 3 (system-installed)
 
-1. Take the `master` branch containing the source code. Rename the folder to `eSim-<version>`.
+---
 
-2. Add the installer script `install-eSim.sh` from `installers` branch to `eSim-<version>` folder.
+## Objective of the Task
 
-3. Add the eSim executable (if available) in `eSim-<version>` folder. Also, remove following files from this folder:
-	- `.git` folder
-	- `.github` folder
-	- `code` folder
-	- `src` folder (Applicable only if eSim executable is used)
-	- conf.py
-	- setup.py
-	- index.rst
-	- requirement.txt
-	- .gitignore
-	- .travis.yml
-    - `library/browser/User-Manual/figures` folder
-    - library/browser/User-Manual/eSim.html
+The objective of this task was to:
+- Attempt installation of eSim using the official installer
+- Identify bugs/issues in the installation process
+- Fix issues where possible
+- Clearly document all findings and attempts
 
-4. Add eSim user manual `eSim_Manual_<version>.pdf` at location `library/browser/User-Manual`.
+## Isusues Encountered ##
 
-5. Add the zip file of `NGHDL` (`nghdl.zip`) in the eSim folder.
+### Issue 1: Missing Installation Script for Ubuntu 25.04
 
-> Note: Refer this [documentation](https://github.com/fossee/nghdl/tree/installers/Ubuntu/README.md) on packaging of NGHDL for Ubuntu OS.
+**Issue Description**
+The eSim repository did not contain an installation script for Ubuntu 25.04.                                                                                                  Users running Ubuntu 25.04 were unable to find a corresponding installer script, which prevented them from installing eSim on the latest Ubuntu version.
+
+**Analysis:**
+On reviewing the repository, it was observed that installer scripts were available only for earlier Ubuntu versions (such as 22.04, 23.04, and 24.04). 
+The installer structure relies on version-specific scripts, and since Ubuntu 25.04 was not included, the installation process could not proceed for users on this OS version.
 
-6. Compress `kicadLibrary` folder to a `tar.xz` format and then remove that folder.
+This gap occurred because the repository had not yet been updated to support the newly released Ubuntu 25.04.
+
+**Action Taken:**
+-Identified the absence of an installer script for Ubuntu 25.04.
+-Created/added a new installer script for Ubuntu 25.04 following the structure and conventions of existing Ubuntu installer scripts.
+-Placed the script under the appropriate directory: `Ubuntu/install-eSim-scripts/`
+-Ensured consistency with existing installation logic so that the new script integrates smoothly with the current installer workflow.
+
+### Issue 2: Volare Installation Fails Due to Missing xz-utils
+
+**Issue Description**
+During the eSim installation process, the Volare package failed to install on some Ubuntu systems. The error occurred because the system did not have the xz-utils package installed, which is required for extracting .tar.xz archives during Volare installation.
+
+**Analysis:**
+The installer attempts to download and extract the Volare software.
+Extraction requires the xz command, provided by the xz-utils package.
+
+On systems where xz-utils was missing, the installer failed with errors such as:
+`E: Invalid operation xz-utils`
+
+This caused the Volare installation step to fail, halting the overall eSim installation process.
+
+The issue occurs on fresh Ubuntu installations where xz-utils is not pre-installed.
+
+**Action Taken:**
+Updated the installer script to check for the presence of xz-utils before attempting Volare installation.
+
+If xz-utils is not installed, the installer now automatically installs it using:
+`sudo apt-get install -y xz-utils`
+
+Verified that after this addition, Volare installs successfully without errors on Ubuntu systems lacking xz-utils.
+Ensured that this fix is backward-compatible and does not affect systems that already have xz-utils installed.
+
+### Issue 3: KiCad 6.0 PPA causes installation failure on Ubuntu 25.04
+
+**Issue Description**
+During the execution of the eSim installer on Ubuntu 25.04 (Plucky Puffin), the installation process fails while updating APT repositories. The installer attempts to add the KiCad 6.0 PPA (ppa:kicad/kicad-6.0-releases), which does not provide a valid Release file for Ubuntu 25.04. This causes apt update to fail and results in the installer aborting prematurely.
+
+**Analysis:**
+The main installer detects Ubuntu 25.04 and falls back to using the Ubuntu 24.04 child installer script.
+
+The child installer script contains the installKicad function, which:
+Adds KiCad PPAs based on Ubuntu version
+
+Defaults to using kicad/kicad-6.0-releases for non-24.04 versions
+
+The KiCad 6.0 PPA does not support Ubuntu 25.04, leading to the following error during apt update:
+`E: The repository 'https://ppa.launchpadcontent.net/kicad/kicad-6.0-releases/ubuntu plucky Release' does not have a Release file.`
+Since APT treats this as a fatal error, the installation process terminates with:
+`Error! Kindly resolve above error(s) and try again.
+Aborting Installation...`
+The root cause was identified as outdated PPA handling logic inside the installKicad function, which is incompatible with newer Ubuntu releases.
+
+**Action Taken:**
+The installKicad function in the child installer script was rewritten to handle Ubuntu versions more safely.
+
+The updated function:
+-Detects Ubuntu 25.04 explicitly
+-Avoids adding any external KiCad PPAs on Ubuntu 25.04
+-Installs KiCad directly from the official Ubuntu repositories, which already provide a supported KiCad 8.x version
+
+This prevents invalid repository additions, allows apt update to complete successfully, and ensures KiCad installs correctly on Ubuntu 25.04.
+The rewritten logic improves forward compatibility and avoids unsafe fallback behavior for future Ubuntu releases.
+
+### Issue 4:eSim Installer Fails Due to Missing kicadLibrary.tar.xz on Ubuntu 25.04
+
+**Issue Description**
+The eSim installation script aborts with a fatal tar error after successfully installing KiCad. The installer attempts to extract a KiCad library archive (library/kicadLibrary.tar.xz) that does not exist in the expected path, causing the installation to terminate prematurely.
+
+Although KiCad is installed correctly via APT, the overall eSim installation fails due to this missing file.
+
+``KiCad installation completed successfully!
+tar (child): library/kicadLibrary.tar.xz: Cannot open: No such file or directory
+tar (child): Error is not recoverable: exiting now
+tar: Child returned status 2
+tar: Error is not recoverable: exiting now
+Error! Kindly resolve above error(s) and try again.
+Aborting Installation...
+``
+
+**Analysis:**
+The installer script assumes the presence of library/kicadLibrary.tar.xz.
+This file is not present in the library/ directory at runtime.
+
+Possible causes:
+The library archive is not included in the repository or release package.
+Git submodules or LFS-tracked files were not initialized or fetched.
+The script uses a hardcoded relative path that breaks if executed from a different directory.
 
-7. Compress `eSim-<version>` to a zip format for distribution.
diff --git a/Ubuntu/install-eSim-scripts/install-eSim-24.04.sh b/Ubuntu/install-eSim-scripts/install-eSim-24.04.sh
@@ -1,3 +1,6 @@
+ubuntu_version="24.04"
+ubuntu_version="24.04"
+ubuntu_version="24.04"
 #!/bin/bash 
 #=============================================================================
 #          FILE: install-eSim.sh
@@ -224,7 +227,7 @@ function installDependency
     pip3 install PyQt5  
 
     echo "Installing volare"
-    sudo apt-get xz-utils
+    sudo apt-get install -y xz-utils
     pip3 install volare
 }