RESELLER PLANS DEDICATED SERVERS MEMBERS AREA FAQ SUPPORT

ORDER   



    

Mail Manager

The Mail Manager is where you go to manage all your email addresses.... create new ones, setup filters, forwarders, and much more.


Topics:

Manage/Add/Remove Accounts
Default Address
Autoresponders
E-mail Filtering
Forwarders
Mailing Lists
Spam Assassin
Trace an Email Address
Modify Mail Exchanger (MX Entry)




Manage/Add/Remove Accounts
You can set up as many POP (Post Office Protocol) e-mail accounts as you require, up to your maximum limit. Each one of these is in the standard e-mail formation of address@yourdomain.com. As with your default e-mail address, you can access these accounts through web mail or through your own offline e-mail application.

To add an e-mail account:

  1. Click on the Add / Del Email Accounts icon in your Control Panel.
  2. Click on the Add Account link.
  3. Enter the first part of the e-mail address and the password for the account in E-mail and Password fields.
  4. Enter the maximum size limit of this mailbox in the Quota field, if required. The size limit is in megabytes. Not entering a number means that the mailbox size is only limited by the available disk space.
  5. Click on the Create button.
  6. Your new account has been added. Refer to Configuring Outlook Express to read e-mail if you want to use Outlook Express to read e-mail received by the new account.

You can delete an e-mail account when the account is no longer needed. You can not delete your default account.

Warning: Make sure you download any mail that you want to keep, as deleting the account will delete all of the mail still in that account. You can not recover this information once the account has been deleted.

To delete an e-mail account:

  1. Click on the Add / Del Email Accounts icon in your Control Panel.
  2. Click on the Delete button next to the unwanted e-mail address.
  3. Click on the Yes button.

It is useful to occasionally change the passwords on your e-mail accounts to maximize your e-mail security. You should always change your password if you think someone else has access to your account.

Note: Make sure that you change the password in your offline e-mail application as well, or you will not be able to upload or download e-mail to this account.

To change the password of an e-mail account:

  1. Click on the Add / Del Email Accounts icon in your Control Panel.
  2. Click on the Change Password button next to the required e-mail address.
  3. Enter the new password in the New Password field.
  4. Click on the Change button. Your password has now been changed for that account.



Default Address
Any e-mail that is sent to an unknown account at your domain name, such as unknown@yourdomain.com, gets automatically rerouted to your default e-mail account. All web site accounts are automatically assigned a default e-mail address - user@yourdomain.com - which you can change, if required.

To set your default e-mail address:

  1. Click on the Default Address icon in your Control Panel.
  2. Click on the Set Default Address link.
  3. Enter the complete e-mail address of the new default in the field next to your web site name drop-down list.
    Note: You can enter :blackhole: to throw away all incoming mail, or :fail: no such address here to bounce the e-mail back to the sender.
  4. Click on the Change button. Your new default e-mail address has now been set.



Autoresponders
Autoresponders are e-mail messages that are sent automatically when an e-mail arrives for a specific e-mail account. Autoresponders are most commonly used for an "Out of Office" style message to inform your correspondents that you are not available, without you having to reply manually. You can have more than one autoresponder on one account. You can use plain text or include HTML code in the autoresponder, and choose from a wide variety of character sets.

To add an autoresponder:

  1. Click on the Auto Responders icon in your Control Panel.
  2. Click on the Add Autoresponder link.
  3. Enter the address of the account that the autoresponder responds to in the Email field.
  4. Enter your name or address in the From field. You do not have to put anything in this field.
  5. Enter the subject line of the autoresponder in the Subject field.
  6. Click on the required character set for this autoresponder from the Character Set drop-down list, if required.
  7. Click on the HTML Message tick box if you want to include HTML code in the autoresponder.
  8. Enter the autoresponder message in the Body field. You can not use HTML code in this field - plain text only.
  9. Click on the Create button.

Modify an autoresponder if you need to alter the details of the message or if you set it to the wrong account.

To edit an autoresponder:

  1. Click on the Auto Responders icon in your Control Panel.
  2. Click on the Edit button next to the autoresponder that you want to edit.
  3. Edit the autoresponder's fields as required.
  4. Click on the Create button to edit the autoresponder.

Delete an autoresponder when you no longer need to use it. If you use the autoresponder at frequent intervals, such as an "Out of Office" message, you can modify it to point to a nonexistent e-mail account, such as store@yourdomain.com, and then simply change the account name back when you need it again. Refer to Editing an autoresponder for more information.

To delete an autoresponder:

  1. Click on the Auto Responders icon in your Control Panel.
  2. Click on the Delete button next to the autoresponder that you want to delete.



E-mail Filtering
You can block an e-mail using spam filters. There are many definitions of spam, but one particularly useful one is the following:

Spam is the electronic version of junk mail, and has been around since the Internet was created. E-mail filters are a way of filtering your e-mail to remove unwanted mail based on a variety of criteria. You can block any sort of e-mail, not just mail of a commercial nature. Blocked mail can be deleted automatically or sent to another e-mail address or script. These filters are quite flexible - some examples are provided after the instruction on how to add a spam filter below. All filters are cumulative.

Useful spam links:

Six simple things you can do to prevent spam
Alternate definition of spam
 Usenet definition of spam

Also refer to Spam Assassin for another approach to dealing with spam.

To add an e-mail filter:

  1. Click on the Block Email icon in your Control Panel.
  2. Click on the Add Filter link.
  3. Click on the required header field in the first drop-down list. These are the various fields in any e-mail message.
  4. Click on the required filter action in the second drop-down list. This action will act on the text entered in the third field.
    equals - match the text exactly (whole words only). "Credit" will block "Credit".
    matches regex - matches the text based on regular expression (regex) rules. Regular expressions are a powerful but complex area. You do not need to use regular expression filters for most circumstances. Refer to these two good introductory tutorials - Using Regular Expressions and Learning to Use Regular Expressions - for more information.
    contains - match the specified text in any circumstance. "porn" will block "porn" and "pornography".
    begins with - match the specified text when it is the beginning of a word. "porn" will block "porn" and "pornography" but not "teenporn".
  5. Enter the filter text in the third field. This text is case sensitive.
  6. Enter the destination for the filtered e-mail in the Destination field. There are three separate types of destination:
    Destroy the e-mail - Enter Discard in the field.
    Redirect to another address - Enter the e-mail address to which to redirect the e-mail.
    Redirect to a script - Enter the full script path on the machine that hosts your web site.
  7. Click on the Activate button.

Examples:

To redirect all e-mail from "john@paradise.net", enter: From, equals, john@paradise.net, david@corse.org.nz

To delete all e-mail from paradise.net, enter: From, contains, paradise.net, Discard

To delete all references to pornography, enter: Any Header, contains, porn, Discard

To discard all e-mail that Spam Assassin has marked as spam, enter: SpamAssassin Spam Header, begins with, yes, Discard


Delete a spam filter when you no longer need it. There is no way to modify a spam filter - if you have made a mistake, simply delete the filter and start again.

To delete a spam filter:

  1. Click on the Block Email icon in your Control Panel.
  2. Click on the Delete button next to the spam filter that you want to delete.



Forwarders
Forwards simply allow you to automatically forward e-mail sent to one account to another account. This is useful when you work at two separate locations, or have gone on holiday.

To forward mail from one account to two or more accounts, just add two or more forwards for the account that is being forwarded.

To add a forwarder:

  1. Click on the Email Forwarders icon in your Control Panel.
  2. Click on the Add Forwarder link.
  3. Enter the first part of the e-mail address that will be forwarded in the first field.
  4. Choose the required domain from the drop-down list.
  5. Enter the full e-mail address that the forwarder will forward mail to in the second field.
  6. Click on the Add Forwarder button.

Delete a forwarder when you no longer need it. You can not modify an e-mail forwarder - if you have made a mistake, simply delete the forwarder and start again.

To delete an e-mail forwarder:

  1. Click on the Email Forwarders icon in your Control Panel.
  2. Click on the Delete button next to the forwarder that you want to delete.



Mailing Lists
Mailman is a popular mailing list script. Mailing lists are an ideal tool for communication between far-flung participants and can be about anything you want. Mailman allows you to set up a mailing list with a large number of configurable options, such as who is on the list, where mailing lists messages are sent, and whether you include welcoming messages to new subscribers.

The Mailman documentation, which is incorporated into its Administration panel, is clear and helpful, and should be referred to for all questions about using the script. The instructions in this section deal with how to set up, modify, and delete a Mailman mailing list from your CPanel. You can can also refer to the Mailman home page for more information.

Note: It is a good idea to be aware of spam and its definition before setting up a mailing list - refer to Blocking E-Mail for more information.

To add a mailing list:

  1. Click on the Mailing Lists icon in your Control Panel.
  2. Click on the Add Mailing List link.
  3. Enter the name of the mailing list in the List Name field, the password for the list in the Password field, and the domain it is for from the Domain drop-down list.
  4. Click on the Create button. The list is created in the /usr/local/cpanel/3rdparty/mailman/lists folder.

Editing a Mailing Lists
There are many different configurable options available with the Mailman script. This procedure shows you how to open up the Administration panel so that you can modify the script options. Use the Mailman documentation that is included in the Administration panel to answer any specific questions you might have.

To edit a mailing list:

  1. Click on the Mailing Lists icon in your Control Panel.
  2. Click on the Edit button next to the mailing list that you want to edit.
  3. Log in to the mailing list with your password. You are now in the Mailman Administration panel and can adjust options as you require.

Deleting a Mailing Lists
Delete a Mailman mailing list when you no longer want the list to be active.

Warning: Deleting the mailing list will delete all archives, current mail, and members e-mail addresses. If you want to keep any of this information, be sure to download or otherwise copy these files before deleting the mailing list. Once the mailing list is deleted the information is unrecoverable.

To delete a mailing list:

  1. Click on the Mailing Lists icon in your Control Panel.
  2. Click on the Delete button next to the mailing list that you want to delete.
  3. Click on the Yes button.



Spam Assassin
Spam Assassin is a mail filter installed on a mail server used to identify spam. It checks for spam using a large number of pre-set rules that check the header, body, and sender of all e-mail messages sent to your domain mailbox. For more information about Spam Assassin, refer to the following links:

Spam Assassin - Spam Assassin web site.
Spam Assassin rules - A list of all the rules that Spam Assassin currently uses.

Also refer to Blocking Emails for more information about spam and setting up filters.

To enable Spam Assassin:

  1. Click on the Spam Assassin icon in your Control Panel.
  2. Click on the Enable Spam Assassin button.


Configuring Spam Assassin
You can change how Spam Assassin deals with spam. The following options are available:

required_hits - The number of e-mails received before a certain e-mail is considered spam.
rewrite_subject - Alter the subject line of spam e-mail. Enter 1 to enable or 0 to disable.
subject_tag - Text added to the subject line of spam e-mails. rewrite_subject must be enabled for this to work.
blacklist_from - Enter an e-mail address that you always want classified as spam. The asterix symbol (*) can be used as a wildcard.
whitelist_from - Enter an e-mail address that you never want classified as spam. The asterix symbol (*) can be used as a wildcard.

To configure Spam Assassin:

  1. Click on the Spam Assassin icon in your Control Panel.
  2. Click on the Configure Spam Assassin button.
  3. Change the settings as required.
  4. Click on the Save button.

 
Enabling or disabling the Spam Box
The Spam Assassin Spam Box is a separate mail folder called "spam". If enabled, all e-mail that Spam Assassin flags as spam is automatically delivered to the "spam" folder.

Note: You need an IMAP e-mail client, such as Horde, to view the Spam Box (refer to Horde summary for more information).

To enable or disable the Spam Box:

  1. Click on the Spam Assassin icon in your Control Panel.
  2. Click on the Enable Spam Box or Disable Spam Box as required.

 
Disabling Spam Assassin
You can disable Spam Assassin whenever you require. If you are not able to receive a non-spam e-mail it is a good idea to disable Spam Assassin and have the e-mail resent.

To disable Spam Assassin:

  1. Click on the Spam Assassin icon in your Control Panel.
  2. Click on the Disable Spam Assassin button.



Trace an Email Address
CPanel enables you to trace the delivery path of an e-mail address, from server to server, to your web site.

To trace an e-mail address:

  1. Click on the Trace an Email Address icon in your Control Panel.
  2. Enter the e-mail address that you want to trace in the available field.
  3. Click on the Show Route button.



Modify Mail Exchanger (MX Entry)
CPanel manages your e-mail through its own mail server. However, by altering your MX (Mail Exchange Record) Entry you can point your e-mail to another mail server, if this is required.

Note: CPanel will not be able to manage your e-mail if you change your MX Entry setting. Do not change your MX Entry unless you know what you are doing.

To alter your MX Entry setting:

  1. Click on the Modify MX Entry icon in your Control Panel.
  2. Click on the Change an MX Entry link.
  3. Enter the domain name of the new MX Entry in the available field.
    Note: You can only change the entry to a domain name (e.g. yourdomain.com), not an IP (Internet Protocol) address.
  4. Click on the Change button.


Read Web Mail

You can read your online e-mail using NeoMail, Horde, or SquirrelMail. All of these popular web mail applications allow you to read your e-mail, save them, keep an address book, and perform all of the other basic e-mail functions that you are used to. The main difference between web mail and an offline e-mail applications, such as Eudora or Microsoft Outlook Express, is that all of these functions are performed online, rather than on your own computer, and offline applications generally provide more features.

Web mail is optional. You can still use your favorite offline e-mail applications, if you prefer. You can even use a combination of web mail applications and another tool - you can check your e-mail online, perhaps when you're at work, and download your e-mail to your computer when you get home. You can automatically configure Outlook Express, or manually configure other mail applications to read your e-mail offline.

To read your e-mail online:

  1. Click on the Read Web Mail in your Control Panel.
    Note 1: You can also save this link as a bookmark, so that you can access it without having to use CPanel.
    Note 2: Another way to access your Web Mail without logging into your COntrol panel is to use the following link:
    http://www.yourdomain.com/webmail/
    (don't forget the "trailing slash" at the end of the above link)
  2. Click on the web application that you would like to use.
  3. You are now in the web mail window for your default e-mail address. Refer to the topics below if you need more information about the web mail application you are using.

Topics:

NeoMail summary
Horde summary
SquirrelMail summary

 



NeoMail logoNeoMail summary
NeoMail is fairly self-explanatory. The text below describes the main buttons in NeoMail and what they do. This is provided as a summary reference, and not a detailed description of how to use NeoMail. If you do not know how to use some of the features, have a look at the NeoMail home page.

Note: You can not use HTML code in NeoMail - plain text only.

NeoMail functions:

  1. Inbox - Choose a folder to display. The default folder is your Inbox.
  2. Compose - Compose a new e-mail message and send it using the Send button. You can not use HTML code - plain text only.
  3. Refresh - Refreshes the displayed page. Use it to check if new mail has arrived since the window was opened.
  4. User Preferences - Displays the Preferences page, which allows you to set a variety of options., such as default language, number of messages displayed per page, and your e-mail signature.
  5. Address Book - Displays your Address Book of saved e-mail addresses. Click on an address to create a new e-mail with their e-mail address automatically added.
  6. Folders - Allows you to create new folders and delete old ones. Useful for organizing your e-mail.
  7. Empty Trash - Empties the neomail-trash folder.
  8. Logout - Closes the connection between you and NeoMail.
  9. Page Navigation - Navigate to the first, previous, next, last, or specific page of e-mail.
  10. Move - Moves the selected items to the displayed folder - the default folder is the trash. Click on the on the tick box next to the specific message to select, or click on the All tick box to select all messages in this window.

 



Horde logoHorde summary
Horde is a full-featured e-mail application. The text below describes the main buttons in Horde and what they do. This is provided as a summary reference, and not a detailed description of how to use Horde. If you do not know how to use some of the features, have a look at the Horde home page.

Horde functions (available from the top menu bar):

  1. Inbox - Displays your inbox with all your current mail that has not been viewed, moved, or deleted.
  2. Compose - Write a new e-mail message. There are several options available, such as using an address book to choose the recipient(s) of your e-mail, adding attachments, and using special characters in the e-mail.
  3. Folders - Organize your mail messages into different folders. You can have as many different folder as you want.
  4. Options - Set a large number of options on how you use Horde. Please read the description of a setting carefully before applying it.
  5. Search - Search for a particular e-mail message. You can search by any field in the e-mail and search through any folder.
  6. Help - Displays the Horde online help. Please read this help when you have any questions or problems.
  7. Addressbook - Stores e-mail addresses of contacts. Click on any e-mail address to create a new e-mail message to that person.
  8. Logout - Logs you out of the Horde application. You should always do this when you have finished using Horde.

Additional Horde functions (available from the bottom menu bar):

  1. Calendar - Displays a calendar on which you can enter events.
  2. Memos - Create notes for your future reference.
  3. Tasks - Create a list of tasks that you need to perform.

 



SquirrelMail logoSquirrelMail summary
SquirrelMail is a full-featured e-mail application. The text below describes the main buttons in SquirrelMail and what they do. This is provided as a summary reference, and not a detailed description of how to use SquirrelMail. If you do not know how to use some of the features, have a look at the SquirrelMail home page.

SquirrelMail functions:

  1. Compose - Write a new e-mail message. There are several options available, such as using an address book to choose the recipient(s) of your e-mail, adding attachments, and choosing a signature.
  2. Addresses - Stores e-mail addresses of contacts. Click on any e-mail address to create a new e-mail message to that person.
  3. Folders - Organize your mail messages into different folders. You can have as many different folder as you want.
  4. Options - Set a large number of options on how you use SquirrelMail. Please read the description of a setting carefully before applying it.
  5. Search - Search for a particular e-mail message. You can search by any field in the e-mail and search through any folder.
  6. Help - Displays the SquirrelMail online help. Please read this help when you have any questions or problems.

 

Change Password

This tool allows you to change your own login password. By using this tool to change your password, your password will be changed for:

- Control Panel login
- SSH login
- FTP login
- FrontPage publishing

It's a good idea to change this occasionally to maximize your site security. You should always change your password if you think someone else has access to your account.

To change your password:

  1. Click on the Change Password icon in your control panel.
  2. Enter your current password in the Old Password field.
  3. Enter your new password in the New Password and New Password (again) fields
  4. Click on the Change your password now! button. Your password has now been changed.

Parked Domains

You can set up a domain name that you own to point to another domain name. This is known as "parking" a domain.

Example: You own the business.co.nz and innovation.co.nz domain names. You already have a web site for business.co.nz, but you do not want to create a new web site for innovation.co.nz at the moment. By parking innovation.co.nz on top of business.co.nz, all URLs for innovation.co.nz will automatically go to business.co.nz instead.

To park a domain:

  1. Click on the Parked Domains link in the Domain Manager.
  2. Enter the name of the domain that you want to park in the New Domain Name field.
  3. Click on the Add button.

Deleting a parked domain
You need to delete a parked domain when you no longer own that domain or when you want to set up a separate web site for the parked domain.

To delete a parked domain:

  1. Click on the Parked Domains link in the Domain Manager.
  2. Click on the required domain from the Remove Domain Name drop-down list.
  3. Click on the Delete button.


Addon Domains

An addon domain is a domain name that that points to a subdirectory within your account. For example, you may want innovation.org.nz to point to business.org.nz/innovation/. Addon domains must be registered domain names that you own and configured to point to your web site's servers.

To add a domain to your web site:

  1. Click on the Addon Domains link in the Domain Manager.
  2. Enter the domain name in the New Addon Domain field.
  3. Add the directory that the addon domain points to in the Username/directory name field.
  4. Enter the password for the domain in the Password field, if required.
  5. Click on the Add button.

Deleting an addon domain
Deleting an addon domain stops redirecting Internet traffic from a domain to a subdirectory.

To delete an addon domain:

  1. Click on the Addon Domains link in the Domain Manager.
  2. Choose the required domain from the Remove Addon Domain drop-down list.
  3. Click on the Delete button.


FTP Manager

The FTP area deals with all the tools relating to setting up and managing FTP accounts, as well as managing FTP sessions. FTP (File Transfer Protocol) is a method by which you can transfer files between computers, usually using the Internet. There is a huge amount of information stored on FTP servers around the world that can only be accessed by using FTP. When using FTP you use an application called a "client" to connect to a machine called a "server".

There are a large number of FTP software packages available. Some of them are built in to your browser (such as Internet Explorer), others are dedicated applications (such as such as CuteFTP or WS_FTP), while still others are built into web applications (File Manager in CPanel is one example). Generally speaking, if you are going to spend a lot of time using FTP or have a large amount of files to upload/download, a dedicated FTP client is the way to go.

CPanel allows you to set up FTP accounts so that certain external users can access a restricted part of your system. You can also set up an anonymous FTP account so that anyone can access a restricted part of your system. You can also manage these FTP sessions, cutting them off if they go on for too long.

Warning: FTP, by its very nature, allows external users to modify your web site (albeit a restricted area of your web site). External users can upload, download, and delete files. Keep this in mind when you set up an FTP account.


Topics:

Adding an FTP account
Setting Anonymous FTP access
Adding an Anonymous FTP message
Controlling FTP sessions



Adding an FTP account
An FTP account creates a folder on the public_html level of your site that allows external users that know the password to upload and download files from that location. Change your password if you think that your account is being used incorrectly.

Note: Please be aware that all users with the correct password will be able to add, edit, and delete files from the directory that you specify for the FTP account, and any directories within the stated directory.

To add an FTP account:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the FTP Accounts link.
  3. Click on the Add Account link.
  4. Enter the name of the FTP account in the Login field and the password for the account in the Password field.
  5. Enter the path to the directory to which this FTP account has access.
    Warning: If you enter the top-level of the web site by entering a slash (/), all users with the correct password will be able to add, edit, and delete all files on your site. It is advisable to limit an FTP account to a smaller section of your web site.
  6. Click on the Create button.

To download FTP access logs:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the FTP Accounts link.
  3. Click on one of the URLs listed at the bottom of the window, or copy and paste that URL into an FTP client application.

To change a password on an FTP account:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the FTP Accounts link.
  3. Click on the Change Password button.
  4. Enter the new password in the New Password field.
  5. Click on the Change button.

To delete an FTP account:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the FTP Accounts link.
  3. Click on the Delete button.

 



Setting Anonymous FTP access
Anonymous FTP access allows anyone to access your public_ftp folder. There are two options available:

  1. Allow anonymous access to ftp://ftp.yourdomain.com - This allows to view, download, and delete files from your public_ftp folder.
  2. Allow anonymous upload to ftp://ftp.yourdomain.com/incoming - This allows to view, upload, download, and delete files from your public_ftp/incoming folder.

Warning: Anonymous FTP allows anyone access to a restricted area of your site. It is generally safest to not enable Anonymous FTP. If you do enable it, you are responsible for the bandwidth and space used.

To set Anonymous FTP access:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the Anonymous FTP Controls link.
  3. Click on the Allow anonymous access to ftp://ftp.yourdomain.com tick box or the Allow anonymous upload to ftp://ftp.yourdomain.com/incoming tick box. You must click on both tick boxes to enable uploads.
  4. Click on the Save Settings button.

To remove Anonymous FTP access:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the Anonymous FTP Controls link.
  3. Remove the tick from the Allow anonymous access to ftp://ftp.yourdomain.com tick box or the Allow anonymous upload to ftp://ftp.yourdomain.com/incoming tick boxes.
  4. Click on the Save Settings button.

 

 

Adding an Anonymous FTP message
You can add a message that appears in all FTP clients that access your public_ftp folder. This is usually used to add copyright notices or other warnings or comments based on the available files.

To add an Anonymous FTP message:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the Anonymous FTP Message link.
  3. Enter the message that you want visitors to see in the text area. You cannot enter HTML code - plain text only. This is created as a welcome.msg text file.
  4. Click on the Save Message button.

 

 

Controlling FTP sessions
You can view and terminate FTP sessions using the provided FTP session controls. This is useful for general information and stopping unwanted FTP activity.

To control FTP sessions:

  1. Click on the FTP Manager icon in your Control Panel.
  2. Click on the FTP Session Control button.
  3. All active FTP sessions (FTP connections that are actively uploading or downloading files) are listed. Click on the Delete button next to a session to terminate that session.


File Manager

The File Manager allows you to manage your site through HTML, rather than an FTP tool or other third-party application. You can upload, create or delete files, organize files in folders, and change file permissions. While not as sophisticated as most FTP tools, File Manager is free and gives you all the basic functionality necessary to manage your site.

To open and navigate in File Manager:

  1. Click on the File Manager icon in your control panel.
  2. Navigate by using the following:
    - Open a folder by clicking on the folder icon.
    - Go up a level by clicking on the Up one level link.
    - Use the path links at the top of the window to move up and down the path.
    - Select a folder, so as to view or modify its properties, by clicking on the folder name link.

Note: All of the other topics in this section assume that you are already in File Manager.

Topics:

Creating a new folder
Uploading files in File Manager
Creating a new file
Editing a file
Editing a file using an HTML editor (IE6 only)
Renaming a file or folder
Changing file/folder permissions
Deleting a file or folder
Restoring an item from the trash
Emptying the trash

 



Creating a new folder
Folders are a very useful way of adding organization and structure to your web site. They make maintenance of the site much easier, as you can easily see what files are in which folder. Most web sites include at least an /image folder to keep all the image files separate from the HTML files.

To create a new folder in File Manager:

  1. Navigate to the area in which you will create the new folder.
  2. Click on the Create New Folder link.
  3. Enter the name of the new folder in the available field in the top-left corner of the window.
  4. Click on the Create button. The new folder will appear in the main display area.

 



Uploading files in File Manager
You can use File Manager to upload files to your web site, up to 12 files in one go. Although useful, a third-party FTP client has many more features and does not limit you to the number of files you can upload at one time. Refer to the FTP Manager section for more information.

To upload files in File Manager:

  1. Navigate to the folder where you want to upload your files.
  2. Click on the Upload file(s) link.
  3. Click on the Browse... button next to one of the top fields.
  4. Search for and double-click on the first file to upload.
  5. Repeat the above steps for each file you want to upload.
  6. Click on the Overwrite existing files tick box if you want to overwrite existing files of the same name.
  7. Click on the Upload button when you have finished selecting files. The status of the upload will appear in the top-right corner of your window. The contents of the folder is displayed in the main area, including your uploaded files.

 

 

Creating a new file:
For small text files it can be easier to create them online, rather than on your home computer and uploading the file. You can create text files, such as HTML, PHP, or plain TXT, but not binary files.

To create a new file:

  1. Navigate to the folder where you want to create your text file.
  2. Click on the Create New File link.
  3. Enter the name of the file to be created in the available field in the top-right corner of your window. You do need to add the file extension to the name, for example script.pl for a Perl script, not just script.
  4. Select the type of document from the drop-down list. Each type of file adds specific information to the text file:
    - Text Document - No text is added to the file.
    - HTML Document - No text is added to the file.
    - Perl Script - Automatically adds the path to Perl to the top of the file. Make sure to double check that the path is correct.
    - Shell Script - Automatically adds the path to the Shell executable to the top of the file. Make sure to double-check that the path is correct.
  5. Click on the Create button. The file has now been created and the display updated to show the new file. Refer to Editing a file in File Manager to add text to these new files.

 

 

Editing a file:
Editing a pre-existing file through File Manager allows you to make immediate changes to your web site, without having to upload a new version of the file. This is useful for small changes, but would be inefficient for large alterations.

To edit a file:

  1. Navigate to the folder where the file is located.
  2. Click on the name of the file.
  3. Click on the Edit File link in the top-right corner of your window. This will open a new window with the contents of the file displayed.
    Note: Clicking on the Show File link will display the contents of the file. However, you will not be able to make any changes to the file.
  4. Alter the text of the file as you wish.
  5. Click on the Save button when you have finished altering the file. The file has been saved and any changes will take effect from now on.

 

 

Editing a File using an HTML editor (IE6 only):
If you are using Internet Explorer 6 as your web browser you can edit online HTML pages directly through the File Manager.

To edit a file using the HTML Editor:

  1. Navigate to the folder where the file is located.
  2. Click on the name of the file.
  3. Click on the WYSIWYG Html Editor (IE 6 only) link in the top-right corner of your window. This will open a new window with the contents of the file displayed.
  4. Edit the file in the same manner as using a word processor.
  5. Click on the Save icon when you have finished editing the file.

 

 

Renaming a file or folder:
You can quickly rename a file or folder if you originally labeled a file or folder with the wrong name, or if the name needs to be updated. This is useful if a small number of files need to be changed, since you do not need to upload any files for the changes to take effect, but inefficient if you needed to rename your entire site.

To rename a file or folder:

  1. Navigate to the file or folder.
  2. Click on the Rename File link in the top-right corner of your window.
  3. Enter the new name for the file or folder in the text field. You need to enter an extension if it is a file, such as .html for HTML files.
  4. Click on the Rename button. The file name has now been changed and the display updated to show the modified file.

 

 

Changing file/folder permissions:
All files on UNIX (including Linux and other UNIX variants) machines have access permissions. These tell the operating system how to deal with requests to access these files. There are three types of access:

  1. Read - Denoted as r, files with read access can be displayed to the user.
  2. Write - Denoted as w, files with write access can be modified by the user.
  3. Execute - Denoted as x, files with execute access can be executed as programs by the user.

Access types are set for three types of user group:

  1. User - The owner of the file.
  2. Group - Other files which are in the same folder or group.
  3. World - Everyone else.

The web server needs to be able to read your web pages in order to be able to display them in a browser. The following permissions need to be set in order for your web site to function properly.

  1. All HTML files and images need to be readable by others. The setting for this is 644 (readable by User, Group, and World, and writable by User), and is set automatically when you upload files.
  2. All folders need to be executable by others. The setting for this is 755 (readable by User, Group, and World, writable by User, executable by User, Group, and World), and is set automatically when you create a folder.
  3. All CGI files (all files in the cgi-bin folder) need to be executable by other. The setting for this is 755 (readable by User, Group, and World, writable by User, executable by User, Group, and World), and is not set automatically when you upload files. You need to change file permissions manually. Refer to the Introduction to CGI topic for more information.

Warning: It is important that none of your files or folders are writable by anyone else. Any file or folder which is writable by others can be erased by them. Generally there is no problem, just be careful how you set your permissions.

To change file or folder permissions:

  1. Navigate to the file or folder that you need to change.
  2. Click on the name of the file or folder.
  3. Click on the Change Permissions link in the top-right corner of the window.
  4. Click on as many tick boxes as you require to create the right permission. The permission numbers underneath the tick boxes will update automatically.
  5. Click on the Change button when you have finished setting the permission. The new permission level has now been saved and the display updated to show the modified file.

 

 

Deleting a file or folder:
Your Control Panel includes a Trash folder, which operates the same way as the Windows Recycle Bin. All deleted files are automatically placed in the Trash folder and can be restored to their original positions by a simple click. However, once you empty the Trash folder, the files are permanently deleted. Refer to Emptying the Trash for more information.

To delete a file or folder:

  1. Navigate to the file(s) or folder(s) that you want to delete.
  2. Click on the name of the file or folder to display the item's properties in the top-right corner of your window.
  3. Click on the Delete File link. The deleted file or folder is now displayed in the Trash area. Refer to Restoring an item from the Trash if you deleted the wrong file or folder by accident.

 

 

Restoring an item from the trash:
You can easily restore a deleted file from the Trash by moving it from the Trash to another folder. Restored folders are automatically moved back to their original location. However, you will not be able to restore the item if you have emptied the Trash since deleting it - it has been permanently destroyed.

To restore an item from the Trash:

  1. Click on the icon of the item that you want to restore in the Trash area on the bottom-right of the window. The folder or file will be automatically returned to its original location.

 

 

Emptying the trash:
Warning: Make sure you do not need any of the files or folders in the Trash before you empty it, because the files are deleted permanently once the Trash is emptied.

To empty the Trash:

  1. Click on the Trash button in the Trash area. All of the files in the Trash have now been permanently deleted.


Backup

The Backup area allows you to download the daily, weekly, or monthly backup file of your entire web site, or a particular MySQL, alias, or filter backup file. If your computer crashes, or your personal backups are destroyed, these files allow you to recover your site in a convenient manner (you could also use FTP to download each file, but it would take much longer as the files are not compressed).

How often a backup is created is decided by your web host. Contact your hosting administrator for more details.

Important: You should keep your own backup copy of your web site as well. Do not rely solely on the backup provided by your web host. Having multiple backups in different locations provides security against permanently losing information.

Note: A complete web site backup file includes everything - from web pages to images to scripts to access logs. A large site will have a large backup file, and will take some time to download.

To download a backup file:

  1. Click on the Backup icon in your Control Panel.
  2. Click on the Daily, Weekly, or Monthly backup file to download the entire system backup for the indicated time, or click on the link underneath the required area to download an SQL, Alias, or Filter backup file. Refer to Generating a backup (see below) if you need to generate a backup first before downloading it.
    Note: To download any previous stored backups, click on the Generate/Download a Full Backup link, and click on any backup that is listed.
  3. Save the file to disk.
    Note for Windows users: This file is in .tar.gz format (a GZIP archive file that contains a TAR archive file). This is a common archive format used on Unix machines, in the same way that .zip is a common Windows archive format. Most compression utilities should be able to uncompress a .tar.gz file.



Topics:

Generating a backup
Restoring your web site from a backup

 



Generating a backup
You can generate a backup at any time. This is useful if you have just made some changes to the site and you do not want to have to wait for the routine backup (usually daily or weekly) before downloading the backup.

To generate a backup:

  1. Click on the Backup icon in your Control Panel.
  2. Click on the Generate/Download a Full Backup link.
  3. Click on the location for the backup from the Backup Destination drop-down list. The following locations are available:
    Home Directory - Saves the backup in the public_html level of your site.
    Remote Ftp Server - Saves the backup on a specified remote FTP server.
    Remote Ftp Server (passive mode transfer) - Saves the backup on a specified remote FTP server that will only accept passive (PASV) mode FTP transfer. Please refer to your hosting administrator or the remote FTP server if you have questions about passive mode transfer.
  4. Enter your e-mail address in the Email Address field. An e-mail will be sent to this address when the backup has completed.
  5. Enter the FTP address, user name, and password in the Remote Server, Remote User, and Remote Password fields if you are saving the backup file at a remote location.
  6. Click on the Generate Backup button. An e-mail will be sent to the specified address when the backup has finished and can be downloaded.

 



Restoring your website from a backup
In the unlikely event that your web site or other files are deleted from your web host's servers, you can restore the web site using your most recent backup file.

To restore your web site from a backup file:

  1. Click on the Backup icon in your Control Panel.
  2. Click on the Browse... button next to the relevant area that you want to restore.
  3. Search for and double-click on the relevant backup file (in .gz format).
  4. Click on the Upload button.
    Note: You may need to wait for a few minutes to upload and restore a large web site file.



Password Protection
You can protect directories within your site from browsers by using a password to protect them. This allows you to restrict material to only authorized users or store sensitive material online. This is also useful if you want to create a special login area for members to be able to login to. Unless they have a password, they will not be able to browse to that location (directory).

If you are using FrontPage to build your website, and therefore have the FrontPage server extensions installed in your hosting account, you should not use this Password Protection feature. Instead, FrontPage has it's own unique way of allowing you to password protect directories. To learn more about this, please consult your FrontPage documentation, or visit www.microsoft.com.

Custom Error Pages

Error pages are displayed to Internet users when any one of a variety of errors occur, such as when a user enters an incorrect URL or is not authorized to access a specific directory in your web site. Companies often customize error pages to brand them with a specific corporate image and a link to their home page. You do not have to customize these pages - the error page is always available, whether customized or not.

Note: Custom error pages that are smaller than 10k in size will not display properly in Internet Explorer. Insert a large amount of text into a comment to create the required size.

To create or modify a customized error page:

  1. Click on the Custom Error Pages icon in your Control Panel.
  2. Click on the button of the required error page, such as the 403 button.
  3. Enter the HTML code for the error page. You can use the buttons at the top of the page to insert variables into the displayed code.

    Example: 

    <h1>404 Not Found</h1>
    <p>The requested page, <!--#echo var="REQUEST_URL" --> ,is not available.</p>
  4. Click on the Save button.


Sub Domains

Subdomains are a way of creating separate accounts within your master account, which are accessed as separate URLs. For example, you could set up a "timber" subdomain on your master account "hardware.org.mart", which would be accessed as "timber.hardware.org.mart". A lot of larger businesses use subdomains to establish branding and focus on separate product lines, because a subdomain creates a separate URL and web presence. However, you do not create a new Control Panel when you create a subdomain. You still perform most administration functions for the subdomain through your master Control Panel.

Practically, a subdomain is a sub folder within the public_http level of your account that has it's own cgi-bin directory. The "timber" example above creates a new top-level folder called timber, with a cgi-bin sub-folder. Upload your files for the subdomain to this location, including a separate home file (such as index.htm).

Currently you cannot create e-mail accounts with the subdomain extension. A workaround for this is to create an account called "sales-timber@hardware.org.mart", or similar.

To add a subdomain:

  1. Click on the Subdomains link in the Domain Manager.
    Note: You can only successfully create a new subdomain once your DNS number has successfully propagated for this account.
  2. Enter the text for the new subdomain in the field in the available field. You must conform to domain name conventions for the addition to the name.
  3. Click on the Add button. A folder with the same name as the subdomain has now been added to your public_html folder, with a cgi-bin sub-folder (if CGI scripts are enabled on your account).

Adding Subdomain redirection
You can redirect Internet traffic from a particular subdomain to another location. This is usually used when the web pages that made up the subdomain have been moved to another location.

To add subdomain redirection:

  1. Click on the Subdomains link in the Domain Manager.
  2. Click on the required subdomain from the first drop-down list.
  3. Click on the Setup Redirection button.
  4. Enter the redirection address in the available field. Make sure that you end the address with a trailing slash (e.g. http://yourdomain.com/).
  5. Click on the Save button.

Removing Subdomain redirection
Remove subdomain redirection when you no longer want Internet traffic to be diverted from the subdomain to another location.

To remove subdomain redirection:

  1. Click on the Subdomains link in the Domain Manager.
  2. Click on the Remove Redirection button next to the required subdomain.


MySQL Database

SQL stands for Structured Query Language. SQL is an international standard in querying and retrieving information from databases. MySQL is essentially an SQL server - it responds to requests for information that are written in SQL. You can communicate with MySQL using a wide variety of programming languages (PHP being one of the most common). MySQL is Open Source software and free for use.

Refer to the following links for more information about MySQL:

  1. www.mysql.com - The MySQL homepage.
  2. MySQL and PHP tutorial - A good introduction to using the two Open Source technologies together.

To create a MySQL database:

  1. Click on the MySQL databases icon in your Control Panel.
  2. Enter the name of the database in the Db field.
  3. Click on the Add Db button. The database will be added to the /var/lib/mysql folder.

    You need to create at least one database user and grant that user permission to use the new database. Refer to Creating a MySQL user and Grant a user's permissions to a MySQL database for more information.

Topics:

Removing a database
Creating a MySQL user
Grant a user's permissions to a MySQL database
Managing MySQL databases
Adding host access

 



Removing a database
Removing a database will delete that database from its online location. Be sure that you have saved a copy of the database if you want to keep any of the information in the database. Removing a database will not remove any user's but it will remove all user's permissions to that database.

To remove a database:

  1. Click on the MySQL databases icon in your Control Panel.
  2. Click on the Delete button next to the specific database.

 



Creating a MySQL user
You need to create a MySQL user before that user is able to use the database. This does not automatically allow the user to use a database - you need to grant that user permission to the specific database first. Refer to Grant a user's permissions to a MySQL database for more information.

To create a MySQL user:

  1. Click on the MySQL databases icon in your Control Panel.
  2. Enter the user's name in the UserName field and the user's password in the Password field.
  3. Click on the Add User button.

 



Grant a user's permissions to a MySQL database
Once you have created a user to use a database you need to grant that user permission to use the database. If you have not yet created a user, refer to Creating a MySQL user for more information.

To grant user permissions to a MySQL database:

  1. Click on the MySQL databases icon in your Control Panel.
  2. Choose the specific user from the User drop-down list and the specific database to grant permissions to from the Db drop-down list.
  3. Click on the Add User to Db button. The user now has permission to use that database and sample connection strings are shown in the MySQL window.

 



Managing MySQL databases
CPanel includes a web-based MySQL management tool called phpMyAdmin. This tool allows you to manage all aspects of your database structure and data. Refer to the phpMyAdmin documentation link, which is http://yourURL/3rdparty/phpMyAdmin/Documentation.html, if you need to know more about using phpMyAdmin.

To manage MySQL databases using phpMyAdmin:

  1. Click on the MySQL databases icon in your Control Panel.
  2. Click on the phpMyAdmin link at the base of the window. Refer to the phpMyAdmin documentation link, which is http://yourURL/3rdparty/phpMyAdmin/Documentation.html, if you need to know more about using phpMyAdmin.

 



Adding host access
You can allow external web servers to access your MySQL databases by adding their domain name to the list of hosts that are able to access databases on your web site. localhost stands for your own web server.

To add host access:

  1. Click on the MySQL databases icon in your Control Panel.
  2. Enter the domain name or IP number of the host that you wish to add in the Host field.
  3. Click on the Add Host button.

SSH / Telnet

For security reasons, shell access is not enabled by default. In order to activate shell access on your account, you will need to contact our customer service department at sales@resellerstoday.com and request that it be setup for you. You will be asked to prove your identity with a faxed driver's license, passport, or other photo ID. The reason for the extra security measures is because shell access is commonly used by hackers to gain unlawful access to servers, and may result in attacks to other accounts on the server. Although the technology exists to allow shell access, it is not needed for the vast majority of customers. You have all the access to your account needed via FTP and/or the control panel.

Manage Redirects

The Redirects area allows you to redirect Internet traffics from one web page to another. This is usually used when a web page has been moved to another location.

To set up a redirect:

  1. Click on the Manage Redirects icon in your Control Panel.
  2. Enter the address of the web page to move in the first field.
  3. Enter the redirection address in the second field.
  4. Choose one of the following options in the drop-down list:
    Temporary - This tells Internet traffic agents (browsers, search engines, etc.) that this is only a temporary redirection, and that they should return to this initial location again in the future for the same page.
    Permanent - This tells the Internet traffic agents to go to the redirection address in the future, as the old address will never be used again.
  5. Click on the Add button.

Removing a redirect
Remove a redirect when you no longer want to redirect Internet traffic from a web page. There is no way to modify a redirect - if you need to change the details of an existing redirect, you need to delete the existing one and start again.

To remove a redirect:

  1. Click on the Manage Redirects icon in your Control Panel.
  2. Click on the required redirect in the Remove Redirect drop-down list.
  3. Click on the Remove button.


FrontPage Extensions

Frontpage Extensions allow you to publish your web site using Microsoft Frontpage. These extensions can occasionally become corrupted, so you can uninstall and then reinstall Frontpage Extensions whenever required.

To (re)install Frontpage Extensions:

  1. Click on the Setup Frontpage Extensions icon in your Control Panel.
  2. Click on the Install / Reinstall Extensions button.

Uninstalling FrontPage extensions
If you are having problems publishing your site using Frontpage, the first test is to uninstall and then reinstall your Frontpage Extensions. If you are still having trouble with Frontpage after that, contact your hosting administrator for help.

Note: The password protection on any protected directories will be removed. Refer to Password protect directories for more information about reapplying password protection.

To uninstall Frontpage Extensions:

  1. Click on the Setup Frontpage Extensions icon in your Control Panel.
  2. Click on the Uninstall Extensions button.


Raw Access Log

You can download the raw access logs that contain all the recorded hit information that your site has received. These logs are only really useful if you have a preferred reporting tool that you prefer to use, rather than the variety of reporting tools presented in this section.

To download the raw access logs:

  1. Click on the Raw Access Logs icon in your Control Panel.
  2. Save the file to disk.
    Note: The access logs are in .gz (GZIP compression) format.


Web/FTP Stats

The Web / FTP Statistics area presents you with a wide variety of information about your web site, from the latest visitors to a detailed monthly summary of hits, as well as providing an error log. Use the Statistics tools to keep track of what pages are being visited most often, and where they are being referred from.

For more information about exactly what these web site statistics mean, refer to the following excellent articles:



Topics:

Analog
Awstats
Webalizer
Latest visitors
Bandwidth
Error Log



Analog
The Analog reporting tool presents a comprehensive coverage of web server statistics available for your web site using CPanel. Refer to the following links for more information about the Analog tool:

To use the Analog tool:

  1. Click on the Web / FTP Statistics icon in your Control Panel.
  2. Click on the Analog link in the Web/FTP Stats area.
  3. Click on the month that you are interested in.
  4. You are now presented with the Web Server Statistics page for your web site. You can browse the report online, or print it for more detailed perusal offline. Take your time - there is a lot of information available.

 



Awstats
The Awstats reporting tool combines a comprehensive coverage of web server statistics available for your web site with very attractive reporting pages. Refer to the Awstats home page for more information about Awstats.

To use Awstats:

  1. Click on the Web / FTP Statistics icon in your Control Panel.
  2. Click on the Awstats link in the Web/FTP Stats area.
  3. Browse the results.

 

 

Webalizer
The Webalizer tool creates a graphical summary display of usage of your site. This is useful to give you a quick and clear overview of your web site activity. Refer to the Webalizer home page for more information about Awstats.

To use Webalizer:

  1. Click on the Web / FTP Statistics icon in your Control Panel.
  2. Click on the Webalizer link in the Web/FTP Stats area.
  3. Browse the results.

 

 

Latest Visitors
This quick tool lists the last 300 visitors that have visited your site in the last 24 hours. Note that visitors are defined as requests from servers, not individual people.

To view the most recent visitors:

  1. Click on the Web / FTP Statistics icon in your Control Panel.
  2. Click on the Latest Visitors link in the Web/FTP Stats area.
  3. Browse the results. You can click on the Referrer link to open the referring site page, or click on the URL link to open the file that was requested.

 

 

Bandwidth
The Bandwidth tool generates an overall summary of the amount of bandwidth that your site is using. This is generated from HTTP traffic (looking at your web site, downloading files, etc.) and possibly FTP traffic. However, this does not include any other type of traffic, the most notable of which is POP3 - e-mail. Depending on what files you send and receive through e-mail, this amount could be considerable. Contact your hosting administrator if you want to check how much bandwidth you are using.

To check how much bandwidth is being used:

  1. Click on the Web / FTP Statistics icon in your Control Panel.
  2. Click on the Bandwidth link in the Web/FTP Stats area.
  3. Browse the results.

 

 

Error Log
The error log contains all HTTP errors that occur when visitors attempt to view your site, such as requested files not found, etc. The Error Log tool is a presentation of the last 300 entries in your error log. A central use of this tool is to locate suspicious server activity, such as attempted virus attacks. Please contact your hosting administrator if you have concerns about activity in your error logs.

To check your error log:

  1. Click on the Web / FTP Statistics icon in your Control Panel.
  2. Click on the Error Log link in the Web/FTP Stats area.
  3. Browse the results.


Sub Domain Stats

This is just a direct link to the "Subdomain Stats" as described above, in Web/FTP Stats. It shows statistics for any subdomains you may have created in your hosting account.

Error Log

The error log contains all HTTP errors that occur when visitors attempt to view your site, such as requested files not found, etc. The Error Log tool is a presentation of the last 300 entries in your error log. A central use of this tool is to locate suspicious server activity, such as attempted virus attacks. If you have concerns about any activity in your error logs, please contact our support staff immediately.

Search Engine Submit

You can submit your web site details to several search engines at one time from within your Control Panel. Some pointers on this process:

  • This is not a guaranteed way of becoming registered by these search engines, as some may charge a registering fee. It is always best to check each search engine site individually to see what their registration policy currently is.
  • It may take several weeks (4-8 weeks is common) before your web site will appear on a search engine.
  • Do not submit your site multiple times to the same search engine within a short period of time, as the search engine may ban you from its list.

To submit your site to one or more search engines:

  1. Click on the Search Engine Submit icon in your Control Panel.
  2. Click on the tick boxes next to the search engines that you want to submit to.
  3. Enter the address of your site in the URL field and your contact e-mail address in the Email field.
  4. Enter a short description of your site in the Comments field.
  5. Enter the keywords of your site in the Keywords field. These are the handful (3-6) of words that are predominantly used by search engines to index your site. Separate each key word by a comma.
  6. Choose the language of the site in the Language drop-down list and the country in which the site is located in the Country drop-down list.
  7. Choose the category that your web site best fits into from the Category drop-down list.
  8. Click on the Submit button.


Chat Rooms

PhpMyChat is a PHP chat room script that uses a MySQL database to store information. Refer to the PhpMyChat home page for more information about this script.

To install PhpMyChat:

  1. Click on the on the PHP Chatroom icon in your Control Panel.
  2. Enter the directory in which to install PhpMyChat in the available field. This must be a top-level directory on your site.
  3. Enter the administrator's user name and password in the Admin Username and Admin Password fields.
  4. Click on the Install button.
  5. Click on the entry page link to go to the new chat room.