5.2

Creating and Using vFabric Web
Server Instances
21
VMware vFabric Suite 5.2 21
Table 5.1. Options of the newserver Command
Option Description Required?
--server=servername Name of the new vFabric Web Server
instance. The value of this option becomes
the name of the directory that contains the
instance configuration files, and by default is
the name of the host.
The value of servername must be a
valid DNS value and consist only of ASCII
letters, digits or the dash character. Illegal
characters include but are not limited to
control characters below ASCII 32 as well as
the following symbols: < > : " / \ | ? *.
If you want to use an internationalized (i18n)
name for the instance directory, you must
enter the correct Punycode domain name
provided by the registrar for the actual
hostname. Do this by either specifying the
--set HostName=punycode-hostname
option at the command-line or entering the
value interactively when the newserver
command prompts you for the hostname.
Yes.
--httpddir=httpddir Directory that contains the Apache HTTP
binaries.
The default value is rootdir/
httpd-httpdver, such as /opt/
vmware/vfabric-web-server/
httpd-2.2.23.0-64.
No.
--httpdver=httpdver Version of the Apache HTTP binaries you
want your instance to use.
The default value is 2.2, which is a symbolic
link to the actual installed version of the
binaries, such as 2.2.23.0-64.
No.
--mpm=mpm Specifies the type of multi-processing module
(MPM) that the instance uses. Valid values
are:
• worker: Threaded MPM, ideal if you need
a great deal of scalability. By using threads
to serve requests, the instance can serve
many requests with fewer system resources
than a process-based server.
• prefork: Non-threaded, pre-forking MPM
if you require stability or compatibility with
older software.
• event: Less proven but higher-efficiency
asynchronous connection-keepalive MPM.
The event MPM offers little benefit for
HTTPS connections, but is able to handle
more simultaneous kept-alive and pending
HTTP connections.
The default value is worker.
No.
--overlay Specifies that, if serverdir exists, you want
to overwrite the existing files with new ones.
No.
If you do not specify this option, and
serverdir exists, the newserver command
returns an error and suggests you specify a