5.0

14 vFabric Web Server
14
Creating and Using vFabric Web
Server Instances
Prompt Description
Administrator email [webmaster@myserver]? Email address to which vFabric Web Server instances send problems.
This address appears on some instance-generated pages, such as
error documents.
Port for http:// traffic [80]? HTTP port to which the vFabric Web Server instance listens. Default
value is 80 when running the newserver command as the root user
on Linux, 8080 otherwise.
Port for https:// SSL traffic [443]? HTTPS port to which the vFabric Web Server instance listens. Default
value is 443 when running the newserver command as the root
user on Linux, 8443 otherwise.
Creating a sample conf/userfile, add initial users Prompts for creating a sample file that contains the list of users
and passwords for authentication. Use this file if you later need to
authenticate users who use the vFabric Web Server instance. The
prompts ask you for the username and their password; enter Return at
the username prompt when you are done.
If you previously specified that you want to enable SSL... The newserver command prompts you for information required to
create the private key, such as the size of the SSL RSA key in bits and
the PEM pass phrase you specify when you start the instance.
You also are prompted to enter information for your certificate. The
information is mostly about your Distinguished Name, or DN, that will
be incorporated into your certificate request. As indicated, some fields
have default values. You can also leave some fields blank by entering
a '.' (period.)
When newserver completes, it generates the following SSL files in
the ssl subdirectory of the instance directory:
instancename.key: Unencrypted private key. The file has a
permission code of 0600 for additional security.
instancename.pem: DES 3 encrypted private key.
instancename.csr: Certificate-signing request. Submit this file to
the Certificate Authority.
instancename.crt: Self-signed certificate. Replace this certificate
with a signed certificate by the CA.
Important Be sure to record the passphrase to decrypt the *.pem
file and back up the file. Never transmit the .key file or cause it to be
readable by others.
Linux: Start and Stop vFabric Web Server Instances
You start, stop, or restart a vFabric Web Server instance on Linux with the httpdctl shell script in the bin directory of the
instance.
Warning: You always use the start script in the bin of the instance directory, such as /opt/vwmare/vfabric-web-
server/myserver/bin. Do not use the start script in the httpd-2.2/bin sub-directory of the main installation directory.
Prerequisites
Complete the appropriate procedure in Create vFabric Web Server Instances.
Procedure
1. Log in to your Linux computer as the root user.
2. Start a terminal window and change to the bin sub-directory of your vFabric Web Server instance's root directory. For
example, if you created an instance called myserver that lives in the installation directory /opt/vmware/vfabric-
web-server: