Account Creation Errors and Differences Between Suspension, Bandwidth Limiting, and Termination

1. Introduction

When creating a new account in cPanel & WHM, you may encounter several system-level errors. These issues often relate to file permissions, corrupted system files, or existing user entries. Additionally, understanding the differences between account suspension, bandwidth limiting, and account termination is essential for proper server management.

2. groupadd and useradd Errors

These errors typically occur due to system file restrictions or corruption.

2.1 Immutable Files

If /etc/passwd or /etc/group contain the immutable flag, the system cannot modify them to add new users.

Check file attributes:

lsattr /etc/group
lsattr /etc/shadow

If the output includes i, the file is immutable.

Remove the immutable flag:

chattr -i /etc/passwd
chattr -i /etc/group

2.2 Corrupt gshadow File

If /etc/gshadow becomes corrupted, the system cannot properly manage groups. Each group in /etc/group must have a corresponding entry in /etc/gshadow in the format groupname:::.

To rebuild the file:

mv /etc/gshadow /etc/gshadow.corrupt
grpconv

Delete lock files if they exist:

• /etc/gshadow.lock
• /etc/group.lock

3. unable to add user Errors

If the system cannot add a user, the username may already exist.

• Check the directory: /home/username
• Check for an entry in /etc/passwd

4. Account Suspension vs Bandwidth Limiting vs Account Termination

4.1 Account Suspension

Important: The system does not automatically suspend accounts.

You may suspend an account for reasons such as:

• Violation of terms of service
• Unpaid invoices

How to Suspend or Unsuspend an Account

• WHM » Home » Account Functions » Manage Account Suspension
• Command line:
  /usr/local/cpanel/scripts/suspendacct
/usr/local/cpanel/scripts/unsuspendacct

System Behavior During Suspension

• SUSPENDED=1 is added to the account’s cpuser file.
• A redirect is added in account_suspensions.conf to show the suspension page.
• Password hashes in /etc/shadow and /etc/proftpd/username are prefixed with !!.
• A suspension reason is stored in /var/cpanel/suspended/user.
• Email passwords in domain shadow files are wrapped with *LOCKED*.
• Email delivery, forwarding, and DNS queries remain functional.
• Remote Amazon RDS databases are not suspended.

4.2 Bandwidth Limiting

The system automatically limits accounts that exceed their monthly bandwidth allocation. These limits are removed when bandwidth statistics reset at the beginning of each month.

Note: Bandwidth limiting only affects HTTP and HTTPS services. FTP, Mail, and DAV remain accessible.

Indicators of Bandwidth Limiting

• The account exceeds its Disk Limit in WHM’s View Bandwidth Usage interface.
• The directory /var/cpanel/bwlimited/ contains user and domain files.

How to Remove Bandwidth Limits

• Increase bandwidth for a single user:
  WHM » Limit Bandwidth Usage
• Increase bandwidth for a package:
  WHM » Edit a Package
• Modify a single account:
  WHM » Modify an Account
• Remove limits for all accounts:
  WHM » Unsuspend Bandwidth Exceeders

4.3 Account Termination

Terminating an account permanently deletes all associated data. Common reasons include:

• Successful migration to another server
• Long-term nonpayment

How to Terminate an Account

• WHM » Terminate Accounts
• Command line:
  /usr/local/cpanel/scripts/removeacct

System Behavior After Termination

• You cannot immediately recreate the account because MySQL users must be removed first.
• The system deletes DNS zones by default.
• You may choose to retain DNS zones when migrating within the same DNS cluster.

Conclusion

Understanding account creation errors and the differences between suspension, bandwidth limiting, and termination is essential for effective server administration. With the troubleshooting steps in this guide, you can quickly diagnose and resolve common issues in cPanel & WHM.