GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

vaddhost - Configure Virtual Subhosts

bullet Introduction
The vaddhost utility is an interactive, command-line program that automates the process of configuring Virtual Subhosts. After launching vaddhost, it will ask you several questions about the configuration of your Virtual Subhost and provide you with default responses. As you answer each question, vaddhost will display the <VirtualHost> definition with each new piece of information.

Once you have responded to all questions, vaddhost will create necessary directories, add the <VirtualHost> entry to your main web server configuration file (~/www/conf/httpd.conf), and create a backup of your old ~/www/conf/httpd.conf file in your ~/www/conf directory. You can remove these backup files at your discretion.

To use vaddhost, connect to your Virtual Private Servers via Telnet or SSH and do the following.

    NOTE: If your Virtual Private Servers is running Apache Web Server 1.3 then it is necessary to add the following line to your web server configuration file (~/www/conf/httpd.conf).

    NameVirtualHost YOUR.IP.ADD.RESS:*
    


  1. Launch vaddhost
    Run the vaddhost command.

    % vaddhost
    

  2. Virtual Host Name(s)
    Virtual Host Names identify which domain names will be associated with the Virtual Subhost definition that vaddhost will add to your ~/www/conf/httpd.conf file. You may specify one or more domain names with each Virtual Subhost definition. Typically, Virtual Host Names will at the very least include www.SUBHOST-DOMAIN.NAME and SUBHOST-DOMAIN.NAME.

  3. Virtual Host Admin E-Mail Address
    The Host Admin E-mail Address identifies the e-mail address of the person responsible for the Virtual Subhost web site. If the e-mail address you specify will be a Virtual Private Servers E-Mail User Account, you will need to use the vadduser program to add the e-mail account separately.

    For more information about Virtual Subhosts and e-mail, see the following.

    • Virtmaps - Providing E-Mail for Virtual Subhosts

  4. Virtual Host Document Root
    The Virtual Host Document Root is the directory where the web site content for the Virtual Subhost will be stored. The value of the Document Root is defined with respect to your home directory, so you need not preface your definition with /usr/home/USERNAME. The default value for the Document Root directory is located in your ~/usr/local/etc/httpd/vhosts directory. This is to ensure compatibility with the latest version of Microsoft FrontPage.

  5. Transfer and Error Log Files
    You can (if you choose) specify separate transfer and error log files for each Virtual Subhost. This is an optional feature. If you do not wish to store separate log files for the Virtual Subhost, the transfer and error log information will be stored in the web server's master log files. If you do wish to store separate transfer and error log files, vaddhost will provide you with several options based on the input you provided for the Virtual Subhost Document Root.

  6. cgi-bin Directory
    You can also (if you choose) configure a cgi-bin directory for your Virtual Subhost. This is an optional feature. The ScriptAlias directive defines where CGI scripts are stored for the Virtual Subhost.

    NOTE: It is important to understand the Virtual Subhosting Security Issues involved when giving cgi-bin access to your Virtual Subhost customers. Giving your Virtual Subhost customers cgi-bin access is a potential security risk! The CGIs your customers upload and execute have all of the rights and privileges of the CGIs you execute. Therefore, it is possible for a Virtual Subhost customer, which has been granted CGI privileges, to read or remove any file in your directory hierarchy. Moreover, it is possible for a malicious Virtual Subhost customer to crack weak passwords and gain shell access to your Virtual Private Servers.


Toll Free 1-866-GSP-4400 • 1-301-464-9363 • service@gsp.com
Copyright © 1994-2016 GSP Services, Inc.