WHM Initial Setup

For WHM version 11.24

Accessing WHM

To access the WHM interface:

  1. Type https://IP:2087 in your preferred web browser.
    • IP is meant to stand for the IP address of your web server.
  2. Use root as the login name in the Name field.
  3. Enter the password into the Password field.
  4. Click Log In.

Initial Setup

When you log into WHM for the first time, you will be greeted by an Initial Setup screen. This feature will help you configure your server in 6 steps.

Step 1: Agreement

Please read the license agreement and click I Agree/Go To Step 2 at the bottom of the screen when you are finished.

  • note Note: To view more information about this version of WHM, click the View Release Notes link.

Step 2: Setup Networking

This area of the setup feature allows you to define contact information. Required fields are marked with a red asterisk (redasterisk.jpg).

Under the Contact Information heading:

  1. Enter the email address through which you will be contacted if your server has a problem in the Server Contact Email Address field.
  2. If you would like to be contacted via text messages, enter a phone number into the Server Contact SMS Address field.
  3. If you would like to be contacted via AIM, click the Server Contact AIM Name checkbox.
    • Enter the contact AIM name into the Server Contact AIM Name field.
      • If you do not yet have an AIM contact name, click the Get a new AIM name link to create a new AIM account.
    • Enter the AIM name your server will use into the AIM Name to Send Alerts From field.
    • Enter the password for the server's AIM name into the Password for that AIM account field.
  4. If you would like to be contacted via ICQ, click the Server Contact ICQ Number checkbox.
    • Enter the ICQ number through which you wish to be contacted into the Server Contact ICQ Number field.
      • If you do not yet have an ICQ contact number, click the Get a new ICQ number link to create a new ICQ account.
    • Enter the ICQ number your server will use to contact you in the ICQ Number to Send Alerts From.
    • Enter the password for your server's ICQ account in the Password for that ICQ account field.

Under the Hostname heading:

  • Enter your server's hostname into the This Server's Hostname field.

PICK Remember: The hostname, in this case, must be a fully qualified domain name (FQDN). FQDNs are domain names that specify the exact location from the top level user domain to the root domain, when read from right to left. This hostname will require you to use 2 dots (.'s), for example: server.example.com.

About resolvers

Resolvers initiate DNS queries, in effect, allowing your server to find and convert human-readable domain names to machine-readable IP addresses. You will need to configure these resolvers in order for your server to work correctly. Resolver IP address can be obtained through your Internet service provider (ISP).

Under the Resolvers heading:

  1. Enter a primary resolver IP address into the Primary Resolver field.
  2. Enter a secondary resolver IP address into the Secondary Resolver field.
    note Note: The primary and secondary resolvers are required fields.
  3. If you have a third resolver IP address, enter it into the Third Resolver field.
    • Adding an additional resolver, though not required, is a good idea for helping ensure your server's uptime if anything should happen to either of your other resolvers.

Under the Main Network/Ethernet Device heading:

  1. Select the device you would like to use for your connection from the Select the main network/ethernet device pull-down menu.
  2. Click Save & Go to Step 3.
  • You may go back to Step 1 by clicking the Go Back button.

Step 3: Setup IP Addresses

This area of the setup allows you to add IP addresses to your server. These IP addresses can be useful for hosting multiple domain names.

PICK Remember: You will need at least 1 IP address to function as the primary IP address of your server. Without this IP address, visitors will not be able to access your server through the Internet.

To add IP addresses:

  1. Enter the new IP address(es) into the IP Address(es) to add field.
    • You may use CIDR notation to add multiple IP addresses simultaneously. Refer to the Quick CIDR Reference Table at the bottom right of the screen.
    • PICK Remember: When using CIDR notation, enter the appropriate subnet mask for the range of IP addressess.
  2. Click Add Ip(s).
  3. Click Go to Step 4.

  • You may go back to Step 2 by clicking the Go Back button.

note Note: If you intend to use only 1 IP address on this server, click the Skip This Step and Use Default Settings button at the top of the page.

Step 4: Nameservers

This part of the Initial Setup feature allows you to configure nameservers. Nameservers are responsible for spreading your server's DNS information throughout the Internet. You will need to use nameservers in order for visitors to access your website(s).

To configure a nameserver:

  • Select the nameserver software you would like to use from the list, or disable local nameservers, by clicking the corresponding button.
  • PICK Important: Read through the advantages, disadvantages, and notes before making a decision. The BIND nameserver software will be adequate for most servers.

Next, you will need to choose nameserver domains. You will need to add these at your domain registrar before they will work.

To add nameserver domains:

  1. Enter the first nameserver into the Nameserver 1 field.
    • Most nameservers follow the naming convention ns1.example.com and ns2.example.com, where ns stands for nameserver and example.com is meant to stand for your domain name.
  2. Enter the second nameserver into the Nameserver 2 field.
  • If possible, you should add nameserver domains to the Nameserver 3 and Nameserver 4 fields. Having additional nameservers configured for your server will improve uptime if anything should happen to the first 2 nameservers.

The last step in configuring your nameservers is to add A entries for your nameserver domains. A entries are records on your server that couple the domain names of your names servers to their corresponding IP addresses.

To add A entries for your nameserver domains:

  1. Click the Add "A Entries" for all Nameservers checkbox.
  2. Enter the IP addresses for each of your nameservers listed below.
  3. Click Add "A Entries" for Hostname if you would like to add an A entry for your server's hostname.
  4. If you clicked the Add "A Entries" for Hostname checkbox, enter the IP address for your server.
  5. Click Save & Go to Step 5.
  • You may go back to Step 3 by clicking the Go Back button.

Step 5: Services

This area of the initial setup feature allows you to configure what services you and your clients will be able to use on the server. To begin, select which, if any, FTP server software you would like to use.

To configure an FTP server:

  • Select which FTP server software you would like to use, or disable FTP, by clicking the corresponding button.
  • PICK Remember: Review the information within the Advantages, Disadvantages, and Notes fields before making a decision.

The next step is to select a mail server.

To configure a mail server:

  • Select which mail server you would like to use, or disable mail, by clicking the corresponding button.
  • PICK Remember: Review the information within the Advantages, Disadvantages, and Notes fields before making a decision.
  • Under the Convert Mailbox Format heading, select the checkbox if you would like to preserve settings for each mailbox, such as information about read mail and subscriptions, as you migrate to a new mail server. Unchecking this box will speed up the migration, but the email settings may be lost.

The final step in configuring the services for use on your server is to select whether or not you would like to use our cPHulk software. cPHulk is a small program that will run in the background of your server to prevent people from using a brute force attack to compromise your machine.

To enable and configure cPHulk:

  1. Click the Enable cPHulk checkbox.
  2. Use the checkboxes to determine:
    • Whether to extend lockout time for each additional failure past the limit.
    • Whether you will receive notifications when a brute force attack is detected.
  3. You may access cPHulk's advanced settings by clicking the Configure Advanced Settings checkbox. Using the advanced settings you can:
    • Specify the number of minutes you would like to block the IP address of a potentially malicious user (in the IP Based Brute Force Protection Period in minutes field).
    • Specify the number of minutes to lock an account (in the Brute Force Protection in minutes field).
    • Specify the maximum number of failed authentication attempts allowed by an account (in the Maximum Failures By Account field).
    • Specify the maximum number of failed authentication attempts allowed by a particular IP address (in the Maximum Failures Per IP field).
    • Specify the number of failed authentication attempts before an IP is blocked for 2 weeks (in the Maximum Fails Per IP before IP is blocked for two week period field).
  4. Click Save & Go to Step 6.
  • You may go back to Step 4 by clicking the Go Back button.

Step 6: Set Up Quotas

This is the final stage of the Initial Setup process. You will need to select whether you would like to track disk usage on your server. This is generally a good idea if you plan to lease server space to individual users. However, if you do not plan to host individual accounts on your server, there may be no need to enable quotas.

To set up quotas:

  • Click the Use file system quotas button.
  • PICK Remember: This is a good idea if you plan to host individual accounts on your server.

To disable quotas:

  • Click the Do not use file system quotas button.
  • PICK Remember: This is not a good idea if you plan to host individual accounts on your server.

  • Once you have finished, click the Finish Setup Wizard button. You will then be taken to the WHM home page.
  • You may go back to Step 5 by clicking the Go Back button.

Topic revision: r6 - 25 Oct 2010 - 14:24:53 - MelanieSeibert