Skip to Content
Browse documentation

Troubleshoot the WHMCS Root Administrator Module

Diagnose Eenos installation, API connection, package, provisioning, synchronization and login issues with module-specific settings.

Identify the Eenos archive/version, WHMCS/PHP runtime, server hostname, configured protocol/port, service and incident time. Never include credentials or temporary SSO URLs in a report.

Module is missing

Check modules/servers/eenos/eenos.php and its packaged supporting files. An extra archive wrapper directory prevents discovery. Confirm the WHMCS PHP runtime can read the files.

Connection fails

Use Eenos, Secure/HTTPS mode and port 5555, or the actual configured endpoint port. Leave Access Hash empty; authentication uses the WAP API username and password.

The module prefers a nonempty hostname over the IP field. Verify DNS and firewall access from the WHMCS host. An API allowlist must permit the source IP Eenos actually sees. Confirm cURL is enabled in both web and cron PHP contexts. HTML proxy errors and empty responses are not valid API JSON.

Use the API connection guide to distinguish authentication and operation errors.

Certificate verification limitation

The reviewed Eenos download disables cURL peer-certificate and hostname verification. Secure selects HTTPS but does not authenticate the server certificate in this package. A successful connection test is not certificate validation. An update addressing this limitation is a separate module deployment; do not disable verification in unrelated clients.

The module timeout is 300 seconds. Check actual server state after a timeout before repeating a potentially completed operation.

Packages are missing or provisioning fails

Save the server connection, select a matching server group, save the product and reopen Module Settings. Package choices come from matching group members; a fallback text/default field does not establish that the package exists. Keep package definitions consistent across servers that may receive this product.

Review server package availability, requested addresses and administrator provisioning policy. Also check existing username/domain state and demo restrictions. Use the exact unlimited keyword where supported; zero may be omitted and arbitrary nonnumeric input can become unlimited. Change Package does not replay creation overrides.

Sync or login fails

Check that WHMCS invokes the appropriate callback and the service matches the correct server/account. Metadata refresh, account listing and Sync Data perform different work. Compare current Eenos usage before changing billing records.

Verify product type, browser reachability of the target panel and SSO expiry. See automation and login actions for this module's behavior and limitations.

Diagnostics

Exceptions can be written to WHMCS module logs with module parameters. The disabled-by-default EENOSLOG constant can append request diagnostics to debug.log beside this module. These logs can expose secrets: enable only for a needed diagnostic interval, review/redact excerpts and turn debugging off afterwards.

Correlate relevant Eenos log files by time and service identity. Do not send complete module configuration or private task folders.