5.3

26 vFabric Web Server
26
Creating and Using vFabric Web
Server Instances
Prerequisites
• Complete the appropriate procedure in Installing vFabric Web Server.
• As of version 5.2 of vFabric Web Server, you must 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.
Procedure
1. Log on to your computer as root (Unix) or the Administrator user (Windows) and start a terminal (Unix) or PowerShell
window (Windows).
To start a PowerShell window, go to Start > All Programs > Accessories > Windows PowerShell, then right-click on
Windows PowerShell and select Run as Administrator.
2. Change to the directory in which you installed vFabric Web Server. For example, on Unix:
prompt# cd /opt/vmware/vfabric-web-server
3. Run the newserver command to create the new instance; the command prompts you for information about the new server.
The only required command option is --server, with which you specify the name of your vFabric Web Server instance.
On Unix, use the Perl flavor; for example:
prompt# ./newserver --server=myserver
On Windows, use the PowerShell script:
PS prompt> .\newserver.ps1 --server=myserver
In both preceding examples, the way you specify the options is exactly the same. In the examples, the new instance is called
myserver and its server directory is /opt/vmware/vfabric-web-server/myserver.
For additional options, see newserver Prompts and Command Reference.
4. Enter values for the newserver prompts as the command requests information about your new instance. You can use the
default values for many of the prompts, or even leave them blank.
newserver Prompts and Command Reference provides additional information about the prompts.
What to do next
• Start the vFabric Web Server instance and verify that it is working correctly. See Unix: Start and Stop vFabric Web Server
Instances and Windows: Start and Stop vFabric Web Server Instances.
• 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.
newserver Prompts and Command Reference
The newserver command has a number of options and prompts, as described in the two tables that follow.
The newserver command format depends on your operating system:
• newserver : Perl script for Unix.
• newserver.ps1: PowerShell script for Windows.
The command-line options for the two flavors are exactly the same.