cPanel
cPanel 11 Documentation – Apache Handlers
by admin on Jan.10, 2012, under Tutorial, cPanel
What are Apache Handlers?
Apache handlers allow you to control what Apache will do with certain file types. When Apache sees a file, it has an action built in for that file type, and will perform that action. If you wish Apache to do a different action, you will need to make a handler to tell Apache to perform that action.
For example, if you use a file type that requires a special service to run it, such as a file with server side includes that is not named with a .shtml extension, you need to tell Apache to treat these files differently. More information on Apache’s Handlers can be found at http://httpd.apache.org/docs/1.3/handler.html or http://httpd.apache.org/docs/2.0/handler.html.
Creating An Apache Handler
Steps
- Enter the handler you want to create in the first empty text box.
- In the second empty text box, enter the extension the handler will use when being called.
- Click on the Add button.
cPanel 11 Documentation – MIME Types
by admin on Jan.10, 2012, under Tutorial, cPanel
Overview
MIME Types tell browsers how to handle specific file extensions. For example, the text/html MIME Types equates to .htm, .html, and .shtml extensions on most servers, telling your browser to interpret all files with those extensions as HTML files. You can alter or add new MIME Types specifically for your site (Note: You cannot alter the system defined MIME Types values). MIME Types are often used to handle new technologies as they appear. When WAP technology first appeared, no one had these extensions set up on their server. With MIME Types, however, you could have set it up yourself and began serving WAP pages immediately.
To learn more about MIME Types, view the WikiPedia web page at http://en.wikipedia.org/wiki/MIME.
Creating A MIME Type
Steps
- Enter the MIME Type you want to create in the “Mime Type” text box.
- Enter the Extension of the MIME Type you entered in Step 1 above in the “Extension(s)” text box.
- Click on the Add button.
WebHost Manager 11 Documentation – System Health
by admin on Jan.08, 2012, under Tutorial, cPanel
Overview
WebHost Manager can display a variety of system information that indicates the current health of the system:
- Current Disk Usage
- Displays the current amount of disk space being used on each hard drive and partition.
- Current CPU Usage
- Displays the current CPU usage divided by process. More information about each process is available by clicking on each process’s PID (Process ID).
- Current Running Processes
- Displays all currently running processes and their location.
To access the System Health Menu, click on System Health, on the main screen of your WebHost Manager interface.
Background Process Killer
You can set WebHost Manager to automatically detect and kill any one of the following processes (if a process is killed, you will be emailed with information about that process):
- BitchX
- bnc
- eggdrop
- generic-sniffers
- guardservices
- ircd
- psyBNC
- ptlink
- services
It is recommended that you do not allow any of these processes to run on your servers. You can also add trusted users who will not have these processes killed.
- To access the System Health Menu, click on System Health, on the main screen of your WebHost Manager interface.
- Click on Background Process Killer.
- Click on the checkboxes next to the processes that you want to automatically kill. It is recommended that you do not allow any of these processes to run on your servers.
- Enter the name of any trusted users in the available field, if required. Enter one user per line. All users with a uid of less than 99 (including root, mysql, named, and cpanel) are automatically trusted.
- Click on Save.
Show Current CPU Usage
This functions displays the current CPU usage divided by process. More information about each process is available by clicking on each process’s PID (Process ID).
Steps
- To access the System Health Menu, click on System Health, on the main screen of your WebHost Manager interface.
- Click on Show Current CPU Usage.
- You can display more detailed information about each process by clicking on the PID of that process.
Show Current Disk Usage
This function displays the current amount of disk space being used on each hard drive and partition.
Steps
- To access the System Health Menu, click on System Health, on the main screen of your WebHost Manager interface.
- Click on Show Current Disk Usage.
- The disk space used on each drive and partition will be displayed.
Show Current Running Processes
This function displays all currently running processes and their actual location on your server.
Steps
- To access the System Health Menu, click on System Health, on the main screen of your WebHost Manager interface.
- Click on Show Current Running Processes.
- The current running processes on your server will be displayed.
WebHost Manager 11 Documentation – Server Contacts
by admin on Jan.07, 2012, under Tutorial, cPanel
Change System Mail Preferences
The Mail Manager area enables you to forward system mail to specific locations, if required. You can set forwarding rules on four separate system users:
- Root
- The administrative user on the server.
- Nobody
- Mail going to no address.
- Mailman
- Mail from Mailman.
- cPanel
- Mail from cPanel and WHM
Steps
- To access the Server Contacts Menu, click on Server Contacts, on the main screen of your WebHost Manager interface.
- Click on Change System Mail Preferences.
- Enter the forwarding mail address for a system user in the available field.
- Click on Change.
- Repeat steps 3 and 4 if necessary.
Troubleshooting
Remove the address in a field and click on the Change button to disable mail forwarding for that user.
Contact Manager
The Contact Manager enables you to set priority levels on which alerts are sent to you and when. You can set the priority rating on each contact method, which indicates what level of priority is sent to that contact method. For example, if you set pager a rating of 3, each alert with a priority of 1-3 will be sent to your pager. You can also set the priority rating of each alert type.
Steps
- To access the Server Contacts Menu, click on Server Contacts, on the main screen of your WebHost Manager interface.
- Click on Contact Manager.
- Enter the Priority Level of each of the contact methods in the top fields.
- Change the Priority Level of the alerts in the fields listed, if required.
Troubleshooting
If you set the priority level of an alert higher than the priority level of any contact method, you will not be contacted when that alert occurs.
WebHost Manager 11 Documentation – cPanel
by admin on Jan.07, 2012, under Tutorial, cPanel
Overview
The cPanel area contains a variety of miscellaneous features that help you to manage cPanel accounts. To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
Branding
Branding allows you to modify images within a cPanel theme so that you can add your company logo or another image to a customer’s interface. This can be very useful when you are dealing with multiple levels of customers.
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Branding to activate Branding.
NOTE: You can now upload images/text for themes that support branding to /var/cpanel/cpanelbranding/themename. You can also alter branding options by clicking on a theme’s name.
Enable/Disable Outlook® AutoConfig
WebHost Manager can enable or disable Outlook Express® auto configuration files. These allow cPanel users to simply click on a link next to an email address and your server will install Outlook Express® registry settings on their computer. This function prevents a lot of support requests, as configuring email clients is a common problem for users.
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Enable/Disable Outlook AutoConfig.
- Click on Enable to enable Outlook Express® auto configuration files or click on Disable to disable Outlook Express® auto configuration files.
Troubleshooting
This feature only works for users who are using Microsoft Windows®.
Install cPAddons
The “Install cPAddons” feature allows you to install cPanel Addons.
When the page loads you will see a five-column table consisting of the following information:
- Installed – If the check box is checked, the associated cPAddon script has been installed. If the check box is not checked, the associated cPAddon script has not been installed.
- Vendor – The vendor that provided the cPAddon script.
- Category – The type of category the cPAddon script belongs to (Blogs, Bulletin Boards, CMS, Chat, Ecommerce, Gallery, Guest Books, Support).
- Security – The level of security for the associate cPAddon script.
- Name – The name of the associated cPAddon script.
Installing A cPAddon Script
Steps
- Click on the check box associated with the cPAddon script you want to install. You can check multiple cPAddon scripts to install.
- Click on the Update Addon Config button.
Uninstalling A cPAddon Script
Steps
- Click on the check box associated with the cPAddon script you want to uninstall. You can check multiple cPAddon scripts to uninstall.
- Click on the Update Addon Config button.
- After the cPAddon script has been uninstalled, click on the back link.
- When the page loads, you will see a “Completely Remove” link next to the name of the cPAddon script you uninstalled. You should only completely remove the cPAddon for an uninstalled cPAddon if you’ve uninstalled all installs of it first by clicking on the Completely Remove link. Otherwise you will end up with installations that can not be removed until you reinstall the module.
Force Refresh of All cPAddon Sources
Steps
- If you want to refresh all cPAddon sources, click on the Force Refresh of All cPAddon Sources check box.
- Click on the Update Addon Config button.
Manage cPAddons
You can select cPAddons for a single user on your server or you can select cPAddons for all users on your server.
Show all installs that need to be updated
This section is located at the top of the “Manage cPAddons” page.
Steps
- Select All installs that need to be updated from the Show drop down menu.
- Select either All Users or select a single user from the “Users” drop down menu.
- Click on the Manage button.
- When the page loads you will see a five-column table consisting of the following information:
- User – The username associated with the installed cPAddon.
- Addon – The name of the associated cPAddon.
- Latest – The latest available version of the associated cPAddon.
- Version – The current version of the associated cPAddon. If the current version is outdated, the “upgrade” link will be shown. Click on the upgrade link to update the associated cPAddon. If the version is the latest version available, the version number will be displayed in green, otherwise it will be displayed in red.
- Currently installed in WHM – This column entry will show either a green circle icon or a flashing red circle icon. The “uninstall” link will always be shown for the associated cPAddon. Click on the uninstall link to remove the associated cPAddon in its entirety.
Show all installs regardless of their status
This section is located at the top of the “Manage cPAddons” page.
Steps
- Select Every Install from the “Show” drop down menu.
- Select either All Users or select a single user from the “Users” drop down menu.
- Click on the Manage button.
- When the page loads you will see a five-column table consisting of the following information:
- User – The username associated with the installed cPAddon.
- Addon – The name of the associated cPAddon.
- Latest – The latest available version of the associated cPAddon.
- Version – The current version of the associated cPAddon. If the current version is outdated, the “upgrade” link will be shown. Click on the upgrade link to update the associated cPAddon. If the version is the latest version available, the version number will be displayed in green, otherwise it will be displayed in red.
- Currently installed in WHM – This column entry will show either a green circle icon or a flashing red circle icon. The “uninstall” link will always be shown for the associated cPAddon. Click on the uninstall link to remove the associated cPAddon in its entirety.
Upgrade all installs that need it
This section is located at the top of the “Manage cPAddons” page under the “Show installs” section.
Steps
- Select Upgrade all installs that need it from the “Show” drop down menu.
- Select either All Users or select a single user from the “Users” drop down menu.
- Click on the Go button.
- When the page loads, the system will display all cPAddons that have been upgraded in addition to a link to the associated cPAddon website.
Uninstall all installs that are no longer installed in WHM
This section is located at the top of the “Manage cPAddons” page under the “Show installs” section.
Steps
- Select Uninstall all installs that are no longer installed in WHM from the “Show” drop down menu.
- Select either All Users or select a single user from the “Users” drop down menu.
- Click on the Go button.
- When the page loads, you will see a confirmation statement similar to the following:
“Are you sure you want to uninstall this?”
- Click on the Yes I am sure I want to do this. link.
The system will display all cPAddons that have been upgraded in addition to a link to the associated cPAddon website.
Plugins
The Plugins feature provides a simple management system where you can install/uninstall and setup automated updates of any cPanel plugins such as tomcat, modresin, modmono, pro, spamdconf, clamavonnector, and much more.
NOTE: cPanel is not responsible for any aspect of third party scripts/themes. All trademarks are owned by their respective companies. Please send all questions reguarding this feature to support@cpanel.net.
Before You Begin
When the page loads you will see a list of available cPanel plugins. Each section in the list shows the following:
- Name – The name of the plugin.
- Packager – The company or vendor that produces the plugin.
- Installed Version – The version of the currently installed plugin.
- Version – The latest version available of the plugin.
- Price – The type of pricing system used such as “free.”
Install/Automatic Plugins
Steps
- Click on the Install and Keep Updated check box for any of the plugins available that you want to install. The system will automatically update the script to the latest available version if this option is checked.
- Click on the Save button.
Uninstall Plugins
Steps
- Each plugins listed has an uninstall button available. For example, if you currently have “pro” installed and you want to uninstall it, click on the Uninstall pro button.
- You should see information similar to the following (pro Example):
removed `/usr/local/cpanel/bin/leechprotect' removed `/usr/local/cpanel/bin/leechprotectinstall' removed `/usr/local/cpanel/bin/leechprotectpass' removed `/usr/local/cpanel/bin/updateleechprotect' removed `/usr/local/cpanel/etc/leechprotect.sql.in' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/images' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/bluelagoon.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/delleech.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/close.jpg' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/convert.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/filelist-convert.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/doconvert.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/dohtaccess.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/doleech.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/doscale.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/dothumbdir.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/filelist-scale.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/filelist-thumbs.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/images.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/leechprotect.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/scale.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/submitsupport.html' removed `/usr/local/cpanel/base/frontend/x/cpanelpro/support.html'
Modify cPanel/WHM News
You can display a customized version of the cPanel or WebHost Manager news, rather than use the default news script.
You can modify the following areas:
- Global cPanel News
- Displays on the home page of all cPanels that you can effect, including your own, your resellers’, and your resellers’ customers’ cPanels.
- Global WebHost Manager News
- Displays in the News area of all resellers’ WebHost Manager interfaces.
- Resold Customer News
- Displays on the home page of all your resellers’ customers’ cPanels
- CPanel News
- Displays on the home page of all your customers’ cPanels (not your resellers’ customers).
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Modify CPanel/WebHost Manager News.
- Enter or copy and paste the HTML code that you want to use into the relevant work areas.
- Click on Save News.
Troubleshooting
The News page is coded in HTML so you need to use HTML code when creating your own news content.
Reset a Mailman Password
You can change the password for any Mailman mailing list on your server, usually when a user has forgotten his or her own Mailman password.
You can modify the following areas:
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Reset a Mailman Password.
- Click on the Mailman User from the available list.
- Enter the New Mailman Password in the New Password field and click on the Change Password.
Shopping Cart Reset
You can refresh a shopping cart that is not resetting by itself. This command is only designed for use with the shopping cart scripts that come pre-installed with cPanel.
You can modify the following areas:
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Reset a Shopping Cart.
- Click on the Domain Name with the problem shopping cart and click on Reset.
Synchronize FTP Passwords
You need to synchronize FTP password files when you reinstall proftpd.
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Synchronize FTP Passwords.
Upgrade to Latest Version
You can upgrade to the latest version of cPanel and WHM. WebHost Manager will check for updates, and download and apply any changes as required.
Steps
- To access the cPanel Menu, click on cPanel, on the main screen of your WebHost Manager interface.
- Click on Upgrade to Latest Version.
- Click on Do It.
