web search: [advanced]your phone number:

Client IS login:

Westmaster ISP Corp.
8345 NW 66 ST #3383
MIAMI, FL 33166-2626

tel:	866-666-SALE
fax:	888-769-5062
email:	info@westmaster

Howto use Webmin

Tutorial: How to add new domain to your server using Webmin tool

Introduction

This tutorial shows you how to add domain to your Linux/BSD server. Your server comes with all deemons pre-configured. Adding new domain to your server is matter of minutes.
This tutorial covers these steps:

Domain registration at registration service
DNS configuration on your server
Adding user account to your server (for FTP access for uploading web pages)
Changing web server configuration (enabling web pages serving)
Changing mail server configuration (so you can recieve mails to this new domain)

Prerequisites

What you will need to add domain to your server:

Invitation letter from us with those informations
- URL of your server's Webmin web interface (eg. https://d63.westmaster.com:10000)
- login and password for Webmin interface (eg. root/jdoJowmsm)
- name of your server (eg. d63.westmaster.com)
- IP address of your server (eg. 81.31.32.72)
Name of domain you want to add (referenced as NEW DOMAIN in this text)
Name (login) and password for account , which you will use to upload your pages to server (we will use "site1" for username and "password" in this tutorial)
You must decide if you want to run DNS for your domain at your server, or we will run it on our secure DNS servers.

Step 1 - Registering your new domain

You have many options here:

Domain registration: You can register your NEW DOMAIN at registration service (joker.com, networksolutions.com - you will pay registration fee to them ) yourself or we can register it (westmaster will charge you for domain registration).
DNS server for your NEW DOMAIN: You can run your DNS for NEW DOMAIN at your dedicated server (we don't recommend it for security reasons) or we can run your NEW DOMAIN DNS on our secure central DNS servers (we recommend this for beginner customers with little administration experience).

Here is detailed description of those options:

Domain registration: you will register it

If you want to register your domain yourself, please go to registration service web and select register domain. When they ask you for DNS servers for NEW DOMAIN fill
- If you want to run your DNS server for NEW DOMAIN on your dedicated server (not recommended):
  - primary DNS server: your dedicated server name (d63.westmaster.com)
  - secondary DNS server: ns2.westmaster.com ( we will run slave DNS server for your domain on our server)
- If you want us to run DNS for your NEW DOMAIN on our secure DNS servers:
  - primary DNS server: ns1.westmaster.com
  - secondary DNS server: ns2.westmaster.com
Afer this, please send email to support@westmaster.com, so we will setup your domain on our DNS servers.

Domain registration: we will register it

If you want westmaster.com to register your NEW DOMAIN, please send email to support@westmaster.com with desired domain name and please specify if you want run DNS on your dedicated server or if you want to use our central secure DNS servers for free. We will register and setup your NEW DOMAIN on our central DNS servers in 24 hours.

Running DNS zone for NEW DOMAIN on your dedicated server

You can jump to Step 2 and add NEW DOMAIN to your dedicated server's DNS server

Running DNS zone for NEW DOMAIN on our secure DNS

Please send email with request to support@westmaster.com after this you can jump to Step 3 and add new FTP account to your server for NEW DOMAIN.

Step 2 - Adding DNS zone for NEW DOMAIN to your dedicated server

Your server comes preconfigured with ISC DNS daemon named BIND, with latest security patches. First open your server's Webmin URL in your browser. You will see Webmin login screen.

Log in using username and password we sent you in invitation letter.

After you successfuly log in you will see webmin welcome screen. Click on Servers Icon (red arrow on the picture).

After you click on the "Servers" icon, you will see "Servers" screen with all server configurators available. Click on "BIND DNS Server" icon and you will get into DNS server configurator.

In "BIND DNS Server" screen click on "Create new master zone" link at the bottom of the screen.

After clicking at "Create new master zone" link you will see "Create Master Zone" screen.

In this form fill in these fields:

Domain name / Network - enter NEW DOMAIN name (eg. testdomain.com)
Master server - enter your SERVER NAME (eg. d63.westmaster.com)
Email address - enter your email address

After this, press "Create" button. This will take you to "Edit Master Zone" screen. New empty master zone file for NEW DOMAIN is now added to your server. Now we must add some records to this empty zone file. In "Edit Master Zone" file click on "Address" button wih "A" icon.

You will see "Address Records" screen.

In "Address Records" form fill in these fields:

Name - enter www
Address - enter your dedicated server IP address (eg. 81.31.32.72)

After this click on "Create" button. First record, that maps www.NEWDOMAIN to IP was created. You will see "Address Records" screen again, but in table below form, you will see first record you created.

Now you must add second record which maps NEWDOMAIN to IP of your server. In "Address Records" form fill in these fields:

Name - leave empty.
Address - enter your dedicated server IP address (eg. 81.31.32.72)

After this click on "Create" button. You will see "Add Address Record" Screen again, but you will also see 2 records in second table.

Click "Return to record types" link. You should see "Edit Master Zone" screen again. As you can see, you have 2 Address records in this DNS zone. Now we add MX (Mail Exchanger record) to this zone. This record tells other computers on the Internet where to send mail for NEWDOMAIN. In "Edit Master Zone" screen click on "Mail Server" link with MX icon.

You should see "Mail Server Records" screen.

Fill "Add Mail Server Record" form:

Name - leave empty
Mail Server - enter you server name (eg. d63.westmaster.com)
Priority - enter number 20

After filling out form, press "Create button".

You will be on "Mail Server Records" screen again, but you can see new MX record in the table below.
Now click on "Return to zone list" link. This will take you back to "BIND DNS Server" screen.

You can see zone for NEWDOMAIN (in this example testdomain.com) in "Existing DNS Zones" table. Now press "Apply Changes" button and your zone will be served by your server. Now you have your DNS server configured to server zone for NEWDOMAIN.

Step 3 - Adding user for FTP uploading pages under NEW DOMAIN

In this step we will add new user to the Unix system, this must be done, we will use this user account for uploading web pages through FTP service, we will also forward mail for NEWDOMAIN to this users mailbox.

Select "System" icon from top menu in Webmin. You should see "System" screen.

Click on "Users and Groups" link. You should see "User and Groups" screen. You will see table with all users and groups in the system. Click on "Create a new user" link at the top of the table.

You should see "Create User" screen.

Fill "User Details" form.

Name - enter desired ftp user name (eg. site1)
Password - select normal password and enter desired password (in this simple example we use word "password" - this is not good idea in production environment)

Leave all other fields untouched and press "Create" button.

Now you should be back on "User and Groups" screen. Click link "Return to index" at the bottom of the page.

Now you have user account on your dedicated server, you can try to ftp to this account using ftp client (eg. if you are using windows you can use LeapFTP or CuteFTP). Connect to your dedicated server with login and password you entered in "User Details" form. It should work.

Step 4 - Adding NEW DOMAIN to Apache Web server configuration

In this step you will configure apache to server pages for NEWDOMAIN from home directory of user you created in "Step 3".
Click on the "Servers" icon in Webmin top menu, you should see "Servers" screen. Click on "Apache Webserver" link.

If you see "Re-Configure Known Modules" screen, don't change anything and click on "Configure" button. This screen will be only first time you run apache configurator, so don't be confused if it doesn't come up. Just forward to next picture.

Now you should see "Apache Webserver" screen. In table "Virtual Servers" you can see all domains configured on this server. There are only 2 default servers - one for normal http and one for SSL connection.

Scroll to the bottom of the screen, you will see "Create New Virtual Server" form.

Fill "Create New Virtual Server" form

Address - select button "Any"
Document root - enter /home/USERNAME (where USERNAME is user name, that you created in step 3, in this example, we created username site1, so Documet root will be /home/site1)
Server Name - enter www.NEWDOMAIN (in this example www.testdomain.com)

Press "Create" button and new domain will be added to apache configuration. You can see new Virtual Server in "Virtual Servers" table.

Now go up and click "Apply Changes" link. Apache will reload configuration and your domain will be ready for content upload.

After this step, your domain should be accessible from your web browser. It should display "Access denied", because you haven't uploaded content yet. Use FTP and connect to user account you created in step 3 and upload your pages directly to home directory of this user.

Please note, that after registering new domain it usually takes about 24 hours for new domain to be "visible" to rest of the world.

If you have problems contact us at support@westmaster.com

Now you have last thing to do in this simple domain setup.

Step 5 - Adding NEW DOMAIN to Sendmail Mail Server

You must configure sendmail to deliver all mail sent to NEWDOMAIN to user's (user we created for NEWDOMAIN in Step 3) mailbox. We will create "catch-all" mailbox for NEWDOMAIN. That means, every mail send to anything@NEWDOMAIN will be delivered to user's mailbox.

Click on icon "Servers" from top menu. You should see "Servers" screen. Click on "Sendmail Configuration" link.

You should see "Sendmail Configuration" screen. Now you add domain to local domains file (all domains for which mail is handled on this server must be in this file). Click on "Local Domains (Cw)) icon.

You should see "Local Domains" screen. Add NEWDOMAIN on the new line in text area as shown on the picure. Then press "Save" button.

Now you should be back in "Sendmail Configuration" screen. Click on "Address Mappings (virtuser)" icon.

You should see "Address Mappings" screen with "Create Mapping" form. Now we will map all mail for this domain to user mailbox.

Fill "Create Mapping" form:

Mail for - select domain and enter NEWDOMAIN into textbox
Send to - select Address and enter USERNAME of user you created in step 3 (in this tutorial we created user site1)

After this click on "Create" button. After this you should see new mapping in second table.

Click on "Return to sendmail configuration" link at the bottom of the page. This will take you back to "Sendmail Configuration" screen.

Now you must restart sendmail. Click on "Stop Sendmail" button.

Now start sendmail clicking on "Start Sendmail" button.

After sendmail configuration, all mail addressed to anything@NEWDOMAIN will be delivered to users mailbox.

For additional information read Webmin BOOK.