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.bat 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:\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

Procedure

  1. Log in to your Windows computer as the Administrator user and start a command window.

    Note for Windows: Depending on the Windows version, you may not have the required permissions when you start the command window, even if you logged in as the Administrator user. If some commands in this procedure fail because of a lack of permissions, start a new command window and use the runas command to execute commands from the new window instead of the original one:

    prompt> runas /user:administrator "cmd.exe /k"
  2. Change to the bin subdirectory of the root directory for the vFabric Web Server instance.

    For example, if you created an instance called myserver that lives in the installation directory c:\vmware\vfabric-web-server:

    prompt> cd c:\vmware\vfabric-web-server\myserver\bin

  3. Install the instance as a Windows service by running the httpdctl.bat install command:

    prompt> httpdctl.bat install

    Subsequently use the Windows Services console to start, stop, and restart the vFabric Web Server instance. The name of the instance in the Windows Services console is vFabric httpd servername. Also use the Windows Services control panel to configure whether the service starts automatically when Windows starts, and so on.

  4. To test that the vFabric Web Server instance actually started, navigate to the http://host:port URL in your browser, where host is the host computer (you can use localhost if your browser is on the same computer), and port is the HTTP port number you provided when you created the instance. The default value on Windows is 8080.

    For example, if you are using the default ports on your local computer, use this URL:

    http://localhost:8080

    If the vFabric Web Server instance started successfully, you should see the Welcome page.

  5. To uninstall the vFabric Web Server instance as a Windows service, use the following command:

    prompt> cd c:\vmware\vfabric-web-server\myserver\bin
    prompt> httpdctl.bat uninstall

What to do next