WHM / cPanel Features Overview
This section documents the day-to-day operational features and customer management workflows available in StackConsole CMP after connecting a WebHost Manager (WHM) server.
CMP provides customer self-service hosting management, automated asynchronous provisioning, real-time disk quota monitoring, one-click cPanel Single Sign-On (SSO), in-place plan upgrades, and automated billing lifecycle management.
Configuration vs Features
Need to connect a new WHM server or configure plans? Start with WHM Setup & Configuration.
Capability Matrix
The following matrix categorizes all WHM integration features according to their verified implementation status in CMP:
| Area | Feature | Status | Operational Notes | Target Guide |
|---|---|---|---|---|
| Provisioning | Asynchronous Account Creation (createacct) | ✅ FULLY SUPPORTED | Validated via CreateHostingAccountJob on the virtual-machine queue. Idempotency verified via accountsummary. | Customer Provisioning |
| Authentication | cPanel Single Sign-On (SSO) | ✅ FULLY SUPPORTED | Generates temporary cPanel user sessions via create_user_session API. Opens directly in new browser tab. | Account Management |
| Authentication | In-Portal Password Reset | ✅ FULLY SUPPORTED | Resets cPanel password via WHM passwd API without requiring current password. | Account Management |
| Storage & Usage | Real-Time Disk Quota Usage | ✅ FULLY SUPPORTED | Polled dynamically from WHM accountsummary and rendered as a progress bar in customer portal. | Account Management |
| DNS | Nameserver & Record Guidance | ⚠️ PARTIALLY SUPPORTED | Displays nameserver assignments and DNS pointer records. Informational guidance only; not an authoritative zone editor. | Account Management |
| Plan Changes | In-Place Plan Upgrade | ✅ FULLY SUPPORTED | Supported for plans with higher disk_quota_gb. Applies proration invoice and calls WHM changepackage. | Lifecycle & Billing |
| Plan Changes | Plan Downgrade | ❌ NOT SUPPORTED | Intentionally blocked by UI and backend validation to prevent disk truncation issues. | Lifecycle & Billing |
| Plan Customization | Build-Your-Own Custom Plans | ❌ NOT SUPPORTED | Customers must choose from pre-defined plans mapped to WHM packages. | Package Configuration |
| Billing Lifecycle | Overdue Suspension (suspendacct) | ✅ FULLY SUPPORTED | Triggered automatically when unpaid invoices pass grace period. Displays suspended banner in portal. | Lifecycle & Billing |
| Billing Lifecycle | Automatic Unsuspension (unsuspendacct) | ✅ FULLY SUPPORTED | Triggered immediately upon balance restoration or invoice payment. | Lifecycle & Billing |
| Service Lifecycle | Immediate Termination (removeacct) | ✅ FULLY SUPPORTED | Destroys cPanel account on WHM immediately upon customer or admin cancellation request. | Lifecycle & Billing |
| Service Lifecycle | End-of-Period Cancellation | ✅ FULLY SUPPORTED | Service remains active until end of paid billing period, then invokes termination job. | Lifecycle & Billing |
| Audit & Logging | Customer & Admin Activity Logs | ✅ FULLY SUPPORTED | Full audit trail logged under HOSTING.ACCOUNT.* events in customer portal and admin backend. | Account Management |
| Operations | Admin Reconciliation / Retry UI | ⚠️ PLANNED GAP | Dedicated retry button not yet built. Operators must inspect failed jobs and reconcile manually. | Troubleshooting |
Feature Architecture
CMP manages Web Hosting accounts through specialized modules and background queue workers:
Operational Boundaries & Invariants
- Service Identifier: Web Hosting is identified in the CMP codebase as
AppServices::WEB_HOSTING. - Account States: Accounts progress through four discrete states:
creating→ Transient state whileCreateHostingAccountJobexecutes.active→ Account verified and fully operational.failed→ Provisioning encountered an error; requires administrative review.suspended→ Service suspended due to billing or disciplinary action.terminated→ Service destroyed and removed from active customer lists.
- Queue Alias: All hosting background jobs execute on the tenant queue alias
virtual-machine. - Idempotency: All account creation jobs query
accountsummaryfirst. If the account already exists on WHM, CMP links the account and marks itactivewithout throwing duplicate creation errors.
Feature Documentation Breakdown
Explore the detailed guides for each hosting feature:
- Hosting Account Management: Inspecting account overview, monitoring real-time disk usage, launching cPanel via SSO, resetting passwords, and viewing audit logs.
- Customer Provisioning Workflow: End-to-end customer purchase experience, domain validation, username rules, background job processing, and welcome emails.
- Billing, Lifecycle & Subscriptions: Subscriptions, recurring invoices, upgrade proration preview, automated suspension/unsuspension, and service termination.
- Troubleshooting & Recovery: Root causes and verified operational resolutions for connection, provisioning, upgrade, and SSO failures.