The vaddhost utility is an interactive, command-line program that
automates the process of adding virtual subhosts to your Virtual Server.
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
definition with each new piece of information.
Once you have responded to all questions, vaddhost will create
necessary directories, add the
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 Server via
Telnet or SSH
and do the following.
NOTE: If your Virtual Server is running Apache
Web Server 1.3.x then it is necessary to add the following
line to your web server configuration file (~/www/conf/httpd.conf).
Run the vaddhost command.
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 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
Virtual Host Admin Email Address
The Host Admin Email Address identifies the email address of the person
responsible for the Virtual Subhost web site. If the email address
you specify will be an email account on the Virtual Server, you will
need to use the vadduser
program to add the email account separately.
For more information about Virtual Subhosts and email, see the following.
- Providing Email for Virtual Subhosts
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
The default value for the Document Root directory is located in your
directory. This is to ensure compatibility with the latest version
of Microsoft FrontPage.
Of course, you may choose or create any other directory in the ~/usr/local/etc/httpd/
Transfer and Error Log Files
You may optionally specify separate transfer and error log files for
each Virtual Subhost. 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.
You may also optionally configure a cgi-bin directory for your Virtual
directive defines where CGI scripts are stored for the Virtual Subhost.
NOTE:Giving your Virtual Subhost customers cgi-bin
access is a potential security risk!
It is important to understand the Virtual
Subhosting Security Issues involved when giving cgi-bin
access to your Virtual Subhost customers. The CGI scripts
your customers upload and execute have all of the rights and
privileges of the CGI scripts 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 Server.