SBOM Manager

Appearance

Troubleshooting ​

Browser Does Not Launch Automatically ​

Cause: System settings or antivirus may block auto-launch.

Windows ​

  • Manually open your browser and navigate to http://localhost:9001
  • Right-click the SBOM Manager icon in the system tray and select "Open Browser"

Linux ​

  • Manually open your browser and navigate to http://localhost:9001
  • If running headless, use a text-based browser or access from another machine

Port 9001 Conflict ​

Cause: Another application is using port 9001.

Windows ​

Check port usage:

cmd
netstat -aon | findstr :9001

Stop the conflicting process:

cmd
taskkill /PID <pid> /F

Change the port:

  1. Create a file named sbom-manager.l4j.ini next to sbom-manager.exe
  2. Add the line: -Dserver.port=9091
  3. Restart and access via http://localhost:9091

Linux ​

Check port usage:

bash
netstat -plten | grep 9001
# or
ss -tlnp | grep 9001

Stop the conflicting process:

bash
kill <pid>
# or force kill
kill -9 <pid>

Change the port:

  1. Edit sbom-manager.sh and add -Dserver.port=9091 to the Java command line arguments
  2. Alternatively, set an environment variable before launching:
    bash
    export SERVER_PORT=9091
./sbom-manager.sh
  3. Restart and access via http://localhost:9091

Missing Dependencies ​

Windows ​

Check if Java is installed:

cmd
java -version

If missing, download and install Java 11 or later.

Linux ​

Check if Java is installed:

bash
java -version

Install Java if missing:

bash
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-11-jre

# RHEL/CentOS/Fedora
sudo yum install java-11-openjdk

# Arch
sudo pacman -S jre11-openjdk

Ensure GUI/XRDP is enabled if using graphical mode.

Ensure shell script has execute permissions:

bash
chmod +x sbom-manager.sh

Application Won't Start ​

Symptoms: Application closes immediately or shows no window.

Windows ​

  • Check log files for errors (typically in logs/ directory or application folder)
  • Verify system requirements are met (Java 11+, available memory)
  • Try running as Administrator:
    1. Right-click sbom-manager.exe
    2. Select "Run as administrator"
  • Check if Java is installed: java -version

Linux ​

  • Run from terminal to see error output:
bash
./sbom-manager.sh
  • Check log files for errors (typically in logs/ directory)
  • Verify system requirements are met (Java 11+, available memory)
  • Check if the script has proper line endings:
bash
dos2unix sbom-manager.sh

System Tray Icon Missing ​

Windows ​

Symptoms: Application appears to be running but no system tray icon is visible.

Solution:

  • Click the arrow (^) to expand hidden system tray icons
  • Enable "Always show all icons" in Windows taskbar settings:
    1. Right-click taskbar → Taskbar settings
    2. Click "Select which icons appear on the taskbar"
    3. Find SBOM Manager and turn it on
  • Restart the application

Linux ​

Not applicable (system tray functionality varies by desktop environment).

Permission Denied Errors ​

Symptoms: Cannot read/write files or access directories.

Windows ​

  • Ensure the application has write permissions to its installation directory
  • Run as Administrator if accessing protected directories
  • Check folder permissions:
    1. Right-click the installation folder → Properties
    2. Security tab → Edit
    3. Ensure your user account has Full Control

Linux ​

Check ownership and permissions:

bash
ls -la sbom-manager.sh

Fix ownership:

bash
chown $USER:$USER sbom-manager.sh
chown -R $USER:$USER /path/to/installation

Fix permissions:

bash
chmod 755 sbom-manager.sh
chmod -R 755 /path/to/installation

Firewall Blocking Localhost ​

Symptoms: Browser shows "Connection refused" when accessing http://localhost:9001.

Windows ​

  • Verify the application is running in Task Manager (Ctrl+Shift+Esc)
  • Add exception in Windows Defender Firewall:
    1. Open Windows Security → Firewall & network protection
    2. Click "Allow an app through firewall"
    3. Add Java or sbom-manager.exe
  • Try accessing via http://127.0.0.1:9001

Linux ​

Check if the application is running:

bash
ps aux | grep sbom-manager

Verify port is listening:

bash
netstat -tlnp | grep 9001

Check firewall rules:

bash
# UFW
sudo ufw allow 9001/tcp

# firewalld
sudo firewall-cmd --add-port=9001/tcp --permanent
sudo firewall-cmd --reload

# iptables
sudo iptables -A INPUT -p tcp --dport 9001 -j ACCEPT

Try accessing via http://127.0.0.1:9001

Display/GUI Issues (Linux Only) ​

Symptoms: "Cannot open display" or GUI-related errors.

Linux ​

Enable X11 forwarding if running via SSH:

bash
ssh -X user@host

Set DISPLAY environment variable:

bash
export DISPLAY=:0

Install X11 libraries if missing:

bash
# Ubuntu/Debian
sudo apt install libx11-6 libxext6 libxrender1 libxtst6

# RHEL/CentOS
sudo yum install libX11 libXext libXrender libXtst

Getting Additional Help ​

  1. Check the application logs for detailed error messages
  2. Note your operating system and version
    • Windows: Run winver or check Settings → System → About
    • Linux: Run cat /etc/os-release
  3. Note your Java version: java -version
  4. Document the exact error message or behavior and contact support with this information

Copyright © 2025 CAST SOFTWARE.