Dedicated Server Management – Troubleshooting Guide

This guide covers common issues and solutions when using the Snowtech Dedicated Server Management addon.

Module Not Appearing in Admin Area

Possible Causes:

• Module not activated
• Admin role not assigned access

Solution:

1. Go to System Settings → Addon Modules.
2. Confirm the module is Activated.
3. Click Configure.
4. Ensure your Admin Role is ticked under permissions.
5. Save changes and refresh WHMCS.

Licence Status Showing Invalid or Expired

Check:

• Correct licence key entered
• No extra spaces before or after the key
• Licensed domain matches your WHMCS installation domain
• Server can make outbound HTTPS connections

If the issue persists, contact Snowtech Services for licence validation.

Database Table Not Created

The module uses the database table:

mod_ds_manage

If missing:

• Deactivate and re-activate the module
• Ensure database user has CREATE TABLE permissions
• Check WHMCS activity log for SQL errors

Unable to Save Server Record

Possible Causes:

• Required fields missing
• Database permission issue
• PHP error during save process

Steps to Diagnose:

1. Enable WHMCS Display Errors temporarily.
2. Check Utilities → Logs → Activity Log.
3. Verify all mandatory fields are completed.

Server Record Not Updating

Check:

• Form submitted successfully (no browser errors)
• No conflicting customisations in admin templates
• Database user has UPDATE permissions

Client or Product Not Linking Correctly

Possible Causes:

• Invalid Client ID
• Product ID does not exist
• Product deleted from WHMCS

Solution:

• Verify Client ID exists in WHMCS
• Confirm Product ID exists and is active
• Edit the server record and reselect valid entries

Sensitive Credentials Not Displaying

Credential visibility is restricted to authorised administrators.

Check:

• Your admin role has module access
• No custom admin theme conflicts

Module Slow to Load

Possible Causes:

• Large number of server records
• Hosting performance limitations
• Custom template overrides

Recommendation:

• Optimise database tables
• Ensure WHMCS caching is enabled
• Review server performance metrics

Module Disappeared After WHMCS Upgrade

Check:

• Addon still activated under Addon Modules
• Licence status still Active
• File permissions unchanged during upgrade

If required, re-upload module files and re-activate.

Unexpected Behaviour After Customisation

If you have modified the module code:

• Revert to the original Snowtech version
• Test before reapplying changes
• Contact Snowtech for supported custom development

Security Reminder

• This module does not execute server commands.
• It does not provision or modify live infrastructure.
• It functions purely as an asset management and inventory tool.

Need Further Assistance?

When contacting support, provide:

• WHMCS version
• PHP version
• Exact error message
• Screenshots if applicable
• Relevant Activity Log entries