web server hosting

Vadduser is the command used to create user accounts on the Virtual Server. While running vadduser, you give the user an e-mail and an FTP account. You can also use vadduser to modify user accounts after they have been created. In short, use vadduser:

  • When you create a user account.
  • To modify an existing user account.
Creating E-mail Accounts
  1. From a Telnet prompt, type vadduser. This action displays a series of fields to fill in after beginning with the following command example:

% vadduser

Please supply answers to the series of questions below. When a `default answer' is available, it will follow the question in square brackets. For example, the question:

        What is your favorite color? [blue]:

has the default answer `blue'. Accept the default (without any extra typing!) by pressing the Enter key -- or type your answer and then press <Enter>.

Use the <Backspace> key to erase and aid correction of any mistyped answers -- before you press <Enter>. Generally, once you press <Enter> you move onto the next question.

Once you've proceeded through all the questions, you will be given the option of modifying your choices before any files are updated.

Press <Enter> to continue:

  1. Type the username.
  2. Type the E-mail/FTP Password.
  3. Retype new password.
  4. Type the User's Full Name followed by a return. Use 8 characters or fewer, no "." characters, and no ':' characters.
  5. Select the account services that the new users will require. The default selections are FTP and e-mail. Type the service name (FTP or e-mail) to toggle the selected/deselected services for the account.

    • FTP (File Transfer Protocol) for uploading/downloading files
    • E-mail services including POP, IMAP, and SMTP


    Note: If the user account will be accessed via IMAP, then FTP service must be enabled.

  6. Enter a positive or negative response to the question "Do you want to add service options like quotas to this account?"
  7. Enter ftp quota for this account in MB (enter "0" for no quota).
  8. Enter a numerical response for the question "Where would you like to put the user's home directory?" You are given four options for where to put the user's home directory, or you can put it in any location you choose. The table below lists and describes each location briefly.

Description

Example

Email account home directory

/usr/home/username

Web hosted account directory

/usr/local/etc/httpd/htdocs/username

Virtual hosted account directory

/usr/local/etc/httpd/htdocs/vhosts/username

Anonymous FTP home directory

/ftp/pub/username

Your choice

/usr/local/etc/httpd/htdocs/vhosts/some_directory/username

Enter "1" for an E-mail account home directory.
Enter "2" for a web-hosted account home directory.
Enter "3" for a virtual hosted account.
Enter "4" for an anonymous FTP home directory.
Or enter in any custom path.

(We recommend using option 3 for two reasons. First, FrontPage 2000 requires it. Second, The vhosts directory is an orderly location under which each of your subhosted users' directories can reside. Each one is separate, distinct, and secure from the others.)

Note: Running the vadduser script is straightforward with one exception: the account services (FTP and e-mail). These services are added to each user's account by default. If you want the user to have both FTP and e-mail privileges, press <enter> when asked to accept the defaults. For the user to have FTP privileges only, deselect the mail privileges by entering "mail." For the user to have e-mail privileges only; deselect the ftp privileges by entering "ftp." If you need to add a service not currently in the list enclosed by the square brackets ([]), then type the service (e-mail or FTP) and press the Enter key.

For example, if Mary Smith has the account name "mary" and the domain name associated with your Virtual Server is "yourcompany.com," then Mary's e-mail address would be "mary@yourcompany.com".

Note: The FTP quota governs the space that may be consumed by the entire directory tree of a user's home directory. The FTP quota is only effective when using FTP to upload files. The mail quota governs the space that may be consumed by a user's mail file under ~/usr/mail. Each quota is expressed as a decimal integer number of megabytes (MB) of disk space.

Changing E-mail Mailbox Passwords
As the Virtual Server administrator, you can change user passwords at any time. However, due to the nature of the UNIX password system, you cannot easily recover a user's password. If one of your users accidentally forgets his or her account password, then you must establish a new password.

Changing an E-mail Mailbox Password

  1. From the UNIX command-prompt enter (where username is the account name):

    % vpasswd username

  2. Enter the new password twice, as prompted.

Note: If your users use Eudora for your POP/IMAP client software, the package includes Poppass, a password change option. Eudora users can select the Change Password menu option to change their own passwords without intervention by the server administrator.

Advise your users to change passwords frequently. Changing passwords lessens the likelihood that malicious users can access your Virtual Server. Characteristics of good passwords include:

  • Length (traditional UNIX systems recognize and use the first eight characters of the password).
  • Complexity (UNIX passwords are case-sensitive, and can contain unusual characters).
  • Obscurity (never use a password that incorporates personal information about yourself or family).
  • Example: "De76sAf4" is a good password, because the password has mixed case, numbers, no personal information, and is not a regular word. This makes the password more secure.

Managing E-mail Accounts
Besides adding users, you can use vadduser to edit existing accounts.

Removing E-mail Service from an Existing Account Without Removing the User

  1. From the command prompt, enter vadduser. This action launches the vadduser program that proceeds through a series of prompts.
  2. At option number 4, "Account Services," type E-mail to remove the user's e-mail service or type ftp to remove FTP services.
  3. Continue through the rest of the prompts.
Removing an E-mail Account
  1. From the command prompt, enter vrmuser. This action launches the vrmuser program that proceeds through a series of prompts.
  2. Enter the account name to remove. This action removes the entire account except the user's home directory and contents (remove these items manually, if necessary).
  3. If the account is only being used to receive mail, then consider removing the account entirely when removing the mailbox.
Listing E-mail Mailboxes
From the command prompt, enter vlistuser. This action displays a report with the following account information about each user:
  • Account name
  • Account owner
  • Home directory
  • Service list (with associated quotas)

Note: The absence of a dash ("-") in the "mail quota" column indicates that the account has an e-mail mailbox (meaning the account is enabled to receive incoming mail).

Configuring E-mail Client Software
There are many e-mail clients available today. Describing how each e-mail client should be setup to receive e-mail is beyond the scope of this chapter. There are three basic things the user needs to setup in order to receive e-mail from the Virtual Server:
  1. E-mail address - the e-mail address is the username you created with vadduser plus the domain name. For example:

    bob@yourcompany.com

  2. Incoming Mail Server - the incoming mail server is your Virtual Server's domain name or IP address.
  3. Outgoing Mail Server - same as the incoming mail server.

For more information on configuring mail clients, see Step 11 in Getting Started in 13 Easy Steps.

Hosting  ::  Web Design  :: Server Administration  ::  Tech Support  ::  Contacts
Data Centers  ::  Tier I Global IP Network  ::  SLA/Contracts  ::  Search  ::  Account Login