Overview

The Languages area enables you to create, alter, and upload/download language configuration files for cPanel. These configuration files accept HTML code and allow you to alter all the words in cPanel to conform to the native language of your customers.

NOTE: You will need to do some translating in this area if you do not have already translated language files to use.

To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.

Additional Language Configuration

Several of the existing scripts used by cPanel have pre-configured languages files already installed. You can choose which language file you want to use for your customers at any time.

Steps

1. To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.
2. Click on Additional Language Configuration.
3. Click on the required language from the drop-down list for each script.
4. Click on Save.

Clone/Create a New Language

In order to create a new language file you need to clone or copy one of the existing language files. You can then download the file for manual editing (refer to Downloading a language file) or edit the file online (refer to Editing a language file).

Steps

1. To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.
2. Click on Clone/Create a New Language.
3. Click on the language file that you want to clone.
4. Enter the name for the language file in the Please enter a name for the new language field and click on Do It.
5. You can now download the file for manual editing (refer to Downloading a language file) or edit the file online (refer to Editing a language file).

Delete a Language File

If you no longer need to use a specific language file, this function allows you to remove it from your server. Make sure that no users are using the language file before you delete it, or they will be unable to use the language.

Steps

1. To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.
2. Click on Delete a Language File.
3. Click on the name of the language file you wish to delete.

NOTE: If the language file was removed successfully, you will see a message saying: Removed <language file name>!

Download a Language File

You can download a language file for offline editing. This is most useful when you have copied an existing file, which you are going to change to a new language (refer to Cloning a language file for more information).

Steps

1. To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.
2. Click on Download a Language File.
3. Click on the language file that you want to download.
4. Copy and paste the displayed text to a text file which you can edit later.

Edit a Language File

You can edit the words used in any language file. You can use this to make small changes in the currently active language file or completely change a cloned language file to a new language.

Steps

1. To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.
2. Click on Edit a Language File.
3. Click on the language file that you want to edit.
4. Alter the text in any of the available fields. You can use HTML code if required.
5. Click on Save.

Troubleshooting

Most third-party themes or skins do not have the ability to change based on language files. Please contact the creator of your theme for more information.

Upload a Language File

You can upload a new language file once you have finished altering a downloaded file (refer to Downloading a language file for more information).

Steps

1. To access the Languages Menu, click on Languages, on the main screen of your WebHost Manager interface.
2. Click on Upload a Language File.
3. Use the Browse… button to select the language file that you want to upload. This can be any plain text file.
4. Click on Upload.

Configure Cluster

DNS Clustering allows you to keep DNS records synchronized across multiple servers.

Steps

1. To access the Cluster / Remote Access Menu, click on Cluster / Remote Access, on the main screen of your WebHost Manager interface.
2. Click on Configure Cluster.
3. To enable DNS clustering, click the checkbox next to Enable DNS Clustering, and then click on Change.
4. Then type the IP address of a server you wish to add to the cluster in the blank field next to Server IP Address.
5. Click on Configure.
6. Repeat steps 4 and 5 as necessary.

Setup Remote Access Key

A Remote Access Key is used for automatic account creation scripts, external billing software, and various other applications that need to call WebHost Manager to create, remove, or modify accounts. A Perl and a PHP module are both available for applications using those technologies.

Steps

1. To access the Cluster / Remote Access Menu, click on Cluster / Remote Access, on the main screen of your WebHost Manager interface.
2. Click on Setup Remote Access Key.
3. To generate a new key, click on Generate New Key. Otherwise, you can copy and paste the current key, if that is what you need.

Overview

The Support area contains a knowledge base of problems and script solutions and a support request form for server owners. The knowledge base is a great resource for simple questions and problems. You can also find answers to a lot of questions at http://forums.cpanel.net/

To access the Support Menu, click on Support, on the main screen of your WebHost Manager interface.

NOTE: You must register to view and interact on http://forums.cpanel.net/

Interactive Knowledge Base

The Interactive Knowledge Base enables you to find solutions to many common problems that you may encounter when running cPanel and WHM. Simply search for related topics to your keywords, and the Knowledge Base will present a list of solutions.

Steps

1. To access the Support Menu, click on Support, on the main screen of your WebHost Manager interface.
2. Click on the Interactive Knowledge Base link in the Support menu.
3. Enter a brief keyword description of the problem you are having in the Enter Issue field.

EXAMPLE: If you have a problem with mailman after installing suexec, enter: suexec mailman.

1. Enter the domain that has the problem in the Affected Domain field, if required. This will customize any solutions you find to that domain.
2. Click on the Search for Answer button.
3. Click on the Click-to-fix! link next to the required solution.

If you entered a domain as part of the search criteria, the solution script will automatically run against that domain. If you did not enter any domain as part of the search criteria, the solution script will run against your account.

Support Center

You can submit a support request to the cPanel Customer Service Team through the Support Center. There are several alternate forms of help you may wish to pursue before you submit a support request:

cPanel and WHM FAQ

Please use the online search facility in the online FAQ to see if your problem is listed.

Support Forums

Search through the archives or ask a question at the cPanel Support Forums.

Documentation

Please check the Online cPanel and WebHost Manager Documentation for help.

NOTE: Please check the online cPanel and WebHost Manager documentation for help.

Steps

1. To access the Support Menu, click on Support, on the main screen of your WebHost Manager interface.
2. Click on Support Center.
3. Click on one or more of the available links. If you need to contact cPanel directly, click on the Contact cPanel.net link.
4. Enter your name, email address, phone number, IP address, and cPanel version/build of your server in the Your Name, Your Email Address, Call Back # fields, IP Address of Server, and cPanel version/build fields.
5. Enter a brief, one line description of your problem in the Brief Description of Problem field.
6. Enter the name of the distributor from which you obtained a software license in the Distributor/Partner NOC Name field.
7. Enter a detailed description of the problem in the Detailed Problem Description field. Add as much detail as you can about the problem. You should include here, any and all parts of the software that are affected, any changes you have made to the server recently, what you are trying to accomplish, and any other information you feel may help the technical support representative to better assist you.
8. To the best of your ability, enter each action required to reproduce the problem in the Steps to Reproduce the Problem field.
9. Click on Send Request.

How your site works

Your web site is made up of a group of files and directories, much like your Documents folder on your home computer. Only in this case, everyone in the world can see some of your files. To give you an idea of how the directories and files work, we’ll look at a view of the file manager.

Contents of /usr/home/username/.

Above, you can see an example of the files and directories in your site. There are three main directories to be concerned with:

home /usr/home/username/ – This is your home directory. All of your files are stored within this directory. Files placed directly in this directory will not be visible on the internet. You will start out in your home directory when connecting by FTP, Web Disk or the File Manager.

/usr/home/username/public_ftp/ – This is the directory used for anonymous FTP access. Any files in this directory can be downloaded by anyone if anonymous FTP access is enabled.

public_html /usr/home/username/public_html/ (www) – The public_html directory contains the files for your site. Files in public_html and any subdirectories of public_html will be able to be viewed by anyone on the internet.. (/usr/home/username/www/ is the same directory as /usr/home/username/public_html/).

When someone views a directory in your public_html area, they will see the index page for that directory. When creating your index page, you should use one of the following names (the first one found will be shown if the visitor doesn’t type in a specific page in their URL):

index.php
index.html.var
index.htm
index.html
index.shtml
index.xhtml
index.wml
index.perl
index.pl
index.plx
index.ppl
index.cgi
index.jsp
index.js
index.jp
index.php4
index.php3
index.php
index.phtml
default.htm
default.html
home.htm
index.php5
Default.html
Default.htm
home.html

Warning: When adding files to your site, it is important that you add them in the right place. For example, you will need to place files that you wish to be visible on the internet in public_html or a subdirectory of public_html. If you placed them in / for example, no one will be able to view them.

If you want to avoid download interruptions during apache restarts, apache has to be changed to restart gracefully.
To do that, you’ll need to change your httpd boot script.
The path for your script will vary depending on your OS.
For FreeBsd it’s:
/usr/local/etc/rc.d/httpd
For all other OS’s, it’s:
/etc/init.d/httpd
As for the actual change, you’ll edit the httpd boot script for your system, find this code:

restart)
  stop
  waitforexit "httpd" 20
  start
  ;;

and change it to read:

restart)
  kill -USR1 `cat $PIDFILE`
  ;;

Note, this is not tested as much, so you’ll need to keep an eye on things until you’re satisfied that it’s stable.
An apache restart will no longer start apache if it’s stopped. You must "start" it, as the graceful restart only works on already running processes.