Configuring a Control Panel Host Estimated Reading Time: 4 Minutes Ubersmith can connect to control panel servers to manage hosting accounts. You can create hosting accounts from Ubersmith, and Ubersmith can create new accounts automatically on a pool of control panel servers. Ubersmith can also suspend or delete accounts, based on the status of the client's service. Ubersmith supports these control panels: cPanel/WHM DirectAdmin To set up a control panel host, do these steps: Make a device type for your control panel servers. Add the Control Panel Host module to the device type. Add a device for each control panel server. Connect the device to the control panel server. Test the connection. Create a hosting account manually. Make a device type for control panel servers Device types are in device type groups. Use a group for all of your control panel servers, and one device type for each control panel software. Go to Settings > Device Types. If you do not have a group for control panel servers, click Add New Device Type Group. Type a name, for example Control Panels. Then click Save. On the row of the group, click add type. Type a name for the device type, for example cPanel. Complete the other tabs as necessary. Then click Save. For more information, refer to the article "Managing Device Types Groups and Device Types". Add the Control Panel Host module On the row of the device type, click modules. Click add module. The Add Device Module popup opens. In Module, select Control Panel Host. In Client Access, select the access for clients who own the device: No Access: Clients cannot see the module. View: Clients can see the module. Edit: Clients can see and change the module. Click Save. The module has no settings on the Config tab. You set the connection on each device. Add a device for the control panel server Go to Devices. Click Add New Device. In Device Description, type a name for the server. In Type, select the control panel device type. Complete the other fields and tabs for your environment. Click Save. If you add the IP address of the server to the device, you can select it when you connect the device to the server. The device page shows a Control Panel Host section. Until you connect the device, the section shows Module Not Configured. Connect the device to the control panel server In the Control Panel Host section of the device, click edit. The Control Panel Host popup opens. In Software, select cPanel/WHM or DirectAdmin. In Hostname/IP, select the IP address of the server. To type a hostname or an address that is not on the device, click edit. In Username, type the user name for the control panel. For cPanel/WHM, this is usually root or a reseller user. In Password, type the credential for the control panel: cPanel/WHM: Type a WHM API token. Do not type the account password. To make an API token, refer to the cPanel documentation for API tokens in WHM. DirectAdmin: Type the password or a login key for the user. In Available for Account Provisioning, select Yes to add this server to the pool of servers for new hosting accounts. Select No if Ubersmith must not create new accounts on this server automatically. Click Save. After you save, the Control Panel Host section shows the software, a management URL, the status of the services on the server, and the number of accounts. For cPanel/WHM, the popup then also shows Available Themes. Type one theme on each line. These are the themes that you can select for new accounts. Note: Ubersmith uses the servers with Available for Account Provisioning set to Yes when it creates new accounts automatically. To set up automatic account creation for a service plan, refer to the article "Configuring Control Panel Account Manager Billing". Test the connection: create an account manually In the Control Panel Host section of the device, click create account. The Create Account popup opens. This link shows only after you connect the device to the server. In Host, make sure that the correct control panel server is selected. Type the Domain, Username, and Password for the new account. For cPanel/WHM, also type the Email Address and select a Package. Set the account limits, for example Disk Quota (MB), Bandwidth Quota (MB), and Max FTP Accounts. The default value for each limit is Unlimited. Click Create. Ubersmith creates the account on the control panel server and shows "Account created". To see the accounts on the server, click Show Accounts in the Control Panel Host section. If Ubersmith cannot connect to the server, it shows "Error communicating with host." Make sure that the address, the user name, and the password or API token are correct.