Troubleshooting issues during installation of SafeSquid
Troubleshooting issues during installation of SafeSquid
A comprehensive guide for troubleshooting common issues encountered during the installation of SafeSquid.
It is designed to help users navigate through potential problems and find effective solutions.
Before Installation
Common issues in this stage include system compatibility, creating a bootable USB or attaching the appropriate .iso file, and correctly setting up the BIOS/UEFI settings.
Solutions involve checking system requirements, verifying the integrity of the installation media, and ensuring correct boot order.
During Installation
Issues during installation can range from partitioning errors, network configuration problems, to software selection difficulties.
Resolutions may include checking disk space, reviewing network settings, and ensuring proper selection of software packages.
For network related issues such as mentioned below you can use the installer console to identify the root cause of the issue and act based on them.
Network Checks for Issue Identification
Network issues can significantly impact the installation and functionality of SafeSquid.
Administrators can perform various checks to identify and resolve network-related problems:
- Network Configuration: Review and modify network settings using the `ip` commands.
and route command to check your default gateway and route.
Ensure correct IP addressing and gateway configuration.
- DNS Resolution and Ping check: Since busybox is a minimal version of linux and nslookup or dig command is not present, we can check name resolution using ping command and to check connectivity to external servers.
For example, `ping google.com` can confirm DNS resolution and internet connectivity.
- Firewall Rules: check your network firewall rules for possible port blocking.
By performing these network checks and using the available networking commands, administrators can pinpoint network-related problems and take corrective actions.
Once you have identified and solved your network problem, come back to the installer tty using ctrl + alt + F1 and select continue.
Select continue again.
Select “Download debconf preconfiguration file” step.
Follow the steps of standard installation and continue your installation process.
Conclusion
This guide aims to cover the most common issues encountered during the SafeSquid installation process.
For additional assistance, users are encouraged to consult the SafeSquid forums and community resources.
Related Articles
Standard Operating Procedure (SOP) for Troubleshooting Issues in your SafeSquid proxy server
Purpose: To provide a consistent and effective approach to troubleshooting network connectivity and web server issues using key commands. Scope: This SOP applies to troubleshooting sessions involving DNS resolution, port connectivity, web server ...ISO installation Failure
Issues When you misconfigured any of your DNS IP, Gateway or the NIC card, you will face issue as "Failed to retrieve the pre-configuration file". IP address which you assigned for SafeSquid proxy if blocked because of firewall, you will face issue ...SSL certificate downloaded with zero size OR unable to download SSL certificate
Issues SSL certificate downloaded with zero size Unable to download SSL certificate Note: If you generate new activation key from Self-Service Portal and activate SafeSquid using same activation key. And directly download SSL certificate from ...Category update is not working
Issues I am trying to add new websites to whitelist or black list category, but it is not updating Uploaded a new file with some websites and added to specific category, but i did not find that websites in the respective category SafeSquid interface ...Restart the SafeSquid Service from Terminal
Run below command to restart the SafeSquid service from the terminal (Linux Box) /etc/init.d/safesquid restart