5.3

Creating and Using vFabric Web
Server Instances
31
VMware vFabric Suite 5.3 31
What to do next
• Complete the procedure in Serve a Sample HTML File from your vFabric Web Server Instance.
• Configure your instance as described in Configuring vFabric Web Server.
Installing vFabric Web Server Instances as Unix Services
You can install a vFabric Web Server instance as a system service on Unix, Linux, so it automatically starts and stops when
the operating system itself starts and stops. If you install it as a service, you start and stop the service by using the /etc/
init.d/ServiceName script.
Procedure
1. Log in to your 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:
prompt# cd /opt/vmware/vfabric-web-server/myserver/bin
3. Install the instance as a service using the ./httpdctl install command:
prompt# ./httpdctl install
You should see the following output:
Installing vFabric httpd myserver
as the unix service vFabric-httpd-myserver
The display name for the service name is vFabric httpd InstanceName. The service name is the display name,
with spaces replaced by dashes: vFabric-httpd-InstanceName.
4. After creating the service, you can control it (1) with the system-config-services GUI utility, (2) by running the bin/
httpdctl shell script from the instance directory, or (3) by running the /etc/init.d/ServiceName script, passing
it the same commands as httpdlctl. For example, to start the myserver instance:
prompt# /etc/init.d/vFabric-httpd-myserver start
5. To uninstall the instance as a Unix service:
prompt# ./httpdctl uninstall
Windows: Start and Stop vFabric Web Server Instances
You start, stop, or restart a vFabric Web Server instance on Windows by first installing it as Windows service using the
httpdctl.ps1 PowerShell script in the bin directory of the instance directory, and subsequently using the Windows Services
console to start or stop it.
Warning: You always use the start script in the bin of the instance directory, such as c:\opt\vmware\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.
• As of version 5.2 of vFabric Web Server, you are required to use Windows PowerShell to execute vFabric Web Server scripts
on Windows computers. See the prerequisites section of Windows: Install vFabric Web Server from a ZIP File for information
on installing PowerShell (if it is not already installed on your Windows computer) and enabling it for script processing.