Subdomains and addon domains are essential features for managing multiple websites within a single hosting account. However, users may encounter issues related to these functionalities. This knowledge base provides detailed information on how to troubleshoot subdomain and addon domain issues in WHM cPanel, ensuring smooth website management.

1. Understanding Subdomains and Addon Domains:

   • Subdomains are extensions of a primary domain, while addon domains are separate domains hosted within the same account.

2. Accessing WHM for Domain Management:

   • Log in to WHM using your administrator credentials.

3. Navigating to Subdomains/Addon Domains:

   • Locate and select 'Subdomains' or 'Addon Domains' from the WHM menu.

4. Reviewing Existing Subdomains/Addon Domains:

   • Check the list of current subdomains and addon domains to identify any issues.

5. Identifying Common Issues:

   • Familiarize yourself with common problems related to subdomains and addon domains, such as DNS misconfigurations or incorrect folder assignments.

6. Checking DNS Configuration:

   • Verify that DNS records for subdomains and addon domains are correctly configured.

7. Reviewing Document Root Paths:

   • Confirm that the document root paths are set accurately to direct traffic to the correct directories.

8. Resolving DNS Propagation Delays:

   • Address any delays in DNS propagation by ensuring that DNS changes have propagated across the internet.

9. Verifying Domain Ownership and Registration:

   • Ensure that subdomains and addon domains are properly registered and controlled by the hosting account.

10. Checking FTP Access for Subdomains/Addon Domains:

    • Verify that FTP accounts associated with subdomains and addon domains have the necessary permissions and are functioning correctly.

11. Managing SSL Certificates (If Applicable):

    • Confirm that SSL certificates are properly configured for subdomains and addon domains, if required.

12. Handling Subdomain/Addon Domain Redirection (Optional):

    • Implement redirection rules to forward traffic from one domain to another, if necessary.

13. Reviewing Error Logs:

    • Access error logs in WHM to investigate any errors or warnings related to subdomains and addon domains.

14. Managing Wildcard Subdomains (If Applicable):

    • Ensure that wildcard subdomains are configured correctly to handle dynamic subdomains.

15. Resolving Cross-Origin Resource Sharing (CORS) Issues (Optional):

    • Address CORS issues that may arise when subdomains or addon domains interact with resources on other domains.

16. Educating Users on Domain Management:

    • Provide guidelines to users on how to manage their own subdomains and addon domains through cPanel.

17. Documenting Troubleshooting Procedures:

    • Keep detailed records of subdomain and addon domain troubleshooting steps taken, including settings, changes, and their impact.

18. Conducting Regular Audits of Domain Configurations:

    • Periodically review subdomain and addon domain configurations to ensure they remain accurate and reliable.

19. Handling Domain Transfer or Migration (Optional):

    • Follow proper procedures for transferring or migrating subdomains and addon domains to different hosting accounts, if needed.

20. Implementing Domain-Specific Security Measures (Optional):

    • Set up domain-specific security measures, such as access controls or additional authentication, for enhanced protection.

Conclusion:

Effectively troubleshooting subdomain and addon domain issues in WHM cPanel is crucial for maintaining seamless website management. By following the steps outlined in this knowledge base, you can efficiently diagnose and address domain-related problems, ensuring that users can manage their websites without interruption. This contributes to an overall more reliable and user-friendly hosting environment.