🔧 License Troubleshoot

This comprehensive guide will help you troubleshoot common licensing issues. Follow the solutions step-by-step to resolve problems quickly and efficiently.

📝 Before You Start:

This document is regularly updated with new solutions and fixes. Always ensure you're following the latest troubleshooting procedures for the best results.

❌ cPanel Error 500 or Invalid License File

🚨 Common Error Messages:

• Error 500 - Internal Server Error
• Invalid License File
• Incorrect authority delivering the license
• *** or any other cPanel related issues

This error typically occurs during first-time installation or when there are conflicting license files on your server.

🔧 Solution Steps:

Step 1: Remove all previous license files and reinstall

wget -O remover https://api.aquahost.in/remover
chmod +x remover
./remover

Step 2: Run the comprehensive fix command

AHctLicenseCP --fix-all

✅ What This Command Does:

• Removes all conflicting license files
• Checks all cPanel possible issues
• Corrects license authority problems
• Restarts necessary services
• Validates license installation

🐘 cPanel PostgreSQL Login Failed

🚨 Problem Description:

If you have installed PostgreSQL on your server and clients are experiencing login failed errors, this is usually due to configuration issues.

🔧 Quick Fix Solution:

AHctLicenseCP --fix-postgresql

✅ This Command Will:

• Configure PostgreSQL properly for cPanel
• Fix authentication issues
• Restart PostgreSQL service
• Update cPanel PostgreSQL integration
• Resolve any connection problems

📋 Manual PostgreSQL Troubleshooting:

# Check PostgreSQL status
systemctl status postgresql

# Restart PostgreSQL service
systemctl restart postgresql

# Check PostgreSQL logs
tail -f /var/log/postgresql/postgresql.log

🌍 Install cPanel Locale Files

Locale files are essential for proper language support in cPanel. Install them to ensure international characters and localization work correctly.

🔧 Installation Command:

AHctLicenseCP --install-locales

📋 Interactive Locale Selection:

After running the command, you'll see a list of available locales. Choose the ones you need for your server:

• en_US.UTF-8 - English (United States)
• es_ES.UTF-8 - Spanish (Spain)
• fr_FR.UTF-8 - French (France)
• de_DE.UTF-8 - German (Germany)
• pt_BR.UTF-8 - Portuguese (Brazil)
• And many more...

🔧 Manual Locale Installation:

# List available locales
locale -a

# Install specific locale (example for Spanish)
localedef -i es_ES -f UTF-8 es_ES.UTF-8

# Restart cPanel services
/usr/local/cpanel/scripts/restartsrv_cpanel

🛠️ General Troubleshooting Steps

🔍 Step 1: Check License Status

AHctLicenseCP --status

🔄 Step 2: Update License

AHctLicenseCP --update

🔧 Step 3: Restart cPanel Services

/usr/local/cpanel/scripts/restartsrv_cpanel
/usr/local/cpanel/scripts/restartsrv_cpsrvd

📊 Step 4: Check System Resources

# Check disk space
df -h

# Check memory usage
free -h

# Check system load
uptime

⚠️ Common Causes of License Issues:

• Insufficient disk space
• Network connectivity problems
• Firewall blocking license server
• System clock not synchronized
• Conflicting license files

🎯 Advanced Troubleshooting

🔍 Check License Logs:

tail -f /var/log/messages | grep -i license
tail -f /usr/local/cpanel/logs/error_log

🌐 Test Network Connectivity:

# Test connection to license server
ping -c 4 licenses.aquahost.in
curl -I https://api.aquahost.in

🕒 Synchronize System Clock:

# Install NTP if not present
yum install ntp -y

# Synchronize time
ntpdate -s time.nist.gov

# Enable NTP service
systemctl enable ntpd
systemctl start ntpd

🔥 Firewall Configuration:

# Allow outgoing HTTPS connections
iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT

# For CSF users, add to /etc/csf/csf.allow:
# tcp|out|d=443|d=licenses.aquahost.in

🔄 Documentation Updates:

This troubleshooting guide is continuously updated with new solutions and fixes. Bookmark this page and check back regularly for the latest troubleshooting procedures.