[Ubuntu 24.04] NGHDL Installation Script Failures & Source Path Fixes

[Lutfullah07]

[Ubuntu 24.04] Detailed Bug Report & Resolution Steps for eSim / NGHDL Installer

During the setup of eSim/NGHDL on Ubuntu 24.04 LTS, multiple environment and script-level errors were encountered and investigated. Below is the breakdown of issues with reproduction logs and resolved fixes.

---

1. Network / RPC Failure During Repository Clone

• Screenshot Ref: Screenshot 2026-08-20 230752.png

• Issue: Initial setup failed during git clone with RPC failed; curl 92 HTTP/2 stream 5 was not closed cleanly: CANCEL (err 8).
• Root Cause: Network buffer overflow on large object fetching over HTTP/2.
• Resolution: Re-tried clone with increased git HTTP postBuffer and resolved remote fetching.

---

2. Relative Path Mismatch in KiCad Setup (sym-lib-table)

• Screenshot Ref: Screenshot 2026-08-20 232312.png & Screenshot 2026-08-20 232846.png

• Issue: Running ./scripts/setup-esim.sh --install threw:
  cp: cannot stat '/3rdparty/template/sym-lib-table': No such file or directory
• Root Cause: A missing $BASE_DIR variable before /3rdparty/... converted the target into an absolute root path instead of project relative path.
• Fix Applied & Committed:
  Updated setup-esim.sh using sed to insert $BASE_DIR dynamically and committed changes to git branch installer:
  Fix: Resolved absolute path issue for KiCad sym-lib-table in setup-esim.sh

---

3. Deprecated Package Failure (libcanberra-gtk-module)

• Screenshot Ref: Screenshot 2026-08-20 233617.png

• Issue: Installation aborted with:
  Error: Package 'libcanberra-gtk-module' has no installation candidate
• Root Cause: Package name obsolete/renamed under Ubuntu 24.04 repositories (libcanberra-gtk3-module / libcanberra-gtk-module deprecation).
• Fix Applied: Modified dependency list in install script to bypass obsolete package check on 24.04.

---

4. GHDL Source Archive Extraction Mismatch

• Screenshot Ref: Screenshot 2026-08-20 233922.png

• Issue: Installation script failed while building GHDL:
  tar: ghdl-4.1.0.tar.gz: Cannot open: No such file or directory
• Root Cause: Script expected pre-downloaded tarball in the execution root directory instead of fetching it dynamically or utilizing standard APT repositories.
• Recommendation: Replace manual tarball dependency with upstream APT repository package (sudo apt install ghdl).

---

System Environment

• OS: Ubuntu 24.04 LTS (x86_64)
• Virtualization: Oracle VirtualBox
• Git Branch: installer