AgileSec Linux Installation Troubleshooting Guide

Troubleshooting guide for Linux AgileSec installation.

Installation Issues

• Check the console output for specific error messages.

• Verify all prerequisites are met.

• Ensure all certificate files are correctly placed and have proper permissions and filename.

• Check the .env file to make sure the following are correct:

  • private_ip

  • analytics_hostname

  • analytics_domain

  • analytics_port

  • cluster_frontend_node_ips

  • cluster_backend_node_ips

• Make sure analytics FQDN <analytics_hostname>.<analytics_domain> is reachable on <analytics_port>.

• Verify network connectivity between nodes in a multi-node installation.

Service Issues

• Check service logs in the <agilesec_install_dir>/logs directory.

• Verify port availability using netstat or ss commands.

• Ensure proper certificate permissions and ownership.

• Check disk space with df -h.

• Verify memory availability with free -h.

Common Errors

• Certificate Issues: Ensure all certificate DNs and CNs match specs from On-Prem Certificates Management Guide.

• Port Conflicts: Verify no other services are using the required ports.

• Permission Denied: Check file and directory permissions.

• Memory Errors: Verify you have sufficient memory available (minimum 8GB recommended).