5.2
Table Of Contents
- vFabric Web Server Installation and Configuration
- Table of Contents
- 1. About vFabric Web Server Installation and Configuration
- 2. Overview of vFabric Web Server
- 3. Installing vFabric Web Server
- Installation Note for vFabric Suite Customers
- Available Distribution Packages
- RHEL: Install vFabric Web Server from an RPM
- Unix: Install vFabric Web Server from a Self-Extracting ZIP
- Windows: Install vFabric Web Server from a ZIP File
- Activate a vFabric Web Server Local License
- Description of the vFabric Web Server Installation
- 4. Upgrading vFabric Web Server
- 5. Creating and Using vFabric Web Server Instances
- 6. Configuring vFabric Web Server Instances
- Using Sample Configuration Files to Enable Features and Modify Configuration
- Configure Load Balancing Between Two or More tc Runtime Instances
- Configure SSL Between vFabric Web Server and vFabric tc Server
- Configure tc Runtime Instances to Use SSL
- Configure the vFabric Web Server Instance to Use SSL
- Restrict Communication With tc Runtime Instances to Known Clients
- Update the Web Server Configuration for HTTPS Connections to tc Runtime Instances
- Configure vFabric Web Server to Authenticate Itself Using a Specific Client Certificate
- Configure BMX for Monitoring vFabric Web Server Instances
- 7. Security Information
- 8. Managing Planned and Unplanned Outages
- 9. Additional Documentation
12 vFabric Web Server
12 Installing vFabric Web Server
5. Execute the downloaded *.zip.exe file to self-extract the files into the directory you created. You can do this, for
example, by opening Window Explorer, navigating to the directory, and double-clicking on the *.zip.exe file.
When the extraction completes, the vFabric Web Server files are located in the vfabric-web-server subdirectory.
6. From your command window, change to the main vFabric Web Server directory:
PS prompt> cd c:\opt\vmware\vfabric-web-server
7. Run the fixrootpath.ps1 PowerShell script to correct the root paths:
PS prompt> .\fixrootpath.ps1
8. Create a symbolic link from the existing httpd-2.2.version directory to one called httpd-2.2, where version
refers to the minor version and architecture of vFabric Web Server.
PowerShell does not include mklink intrinsically, so you must use the command cmd /c mklink. For example, to use
the 64-bit edition of vFabric Web Server, run the following command:
PS prompt> cmd /c mklink /d httpd-2.2 httpd-2.2.23.0-64
What to do next
• If you installed Web Server standalone, activate a local Web Server license as described in Activate a vFabric Web Server
Local License.
If you installed Web Server as part of vFabric Suite, you should have already activated licensing as described in the procedures
for installing vFabric License Server and activating vFabric Suite licenses in Getting Started with vFabric Suite. (You may
also want to read the other vFabric licensing sections in that guide, to understand how licensing works with vFabric Suite.)
• Read Description of the vFabric Web Server Installation for a brief tour of what was installed.
• Create and start using a vFabric Web Server as described in Creating and Using vFabric Web Server Instances.
Activate a vFabric Web Server Local License
When you purchase a local production vFabric Web Server license, your account manager provides you with one or more serial
numbers. This section describes how to activate this local license.
Important: This section does not apply if you purchased vFabric Web Server as part of vFabric Suite. To activate licensing
for vFabric Suite (including vFabric Web Server), complete the procedures for installing vFabric License Server and activating
vFabric Suite licenses in Getting Started with vFabric Suite. You may also want to read the other vFabric licensing sections in
that guide, to understand how licensing works with vFabric Suite.
Procedure
1. On the computer on which you installed Web Server, paste the serial number into a file named vf.ws-serial-
numbers.txt.
2. Save this file to the directory appropriate to your operating system:
• Windows: %ALLUSERSPROFILE%\VMware\vFabric\
• Unix: /etc/opt/vmware/vfabric/
3. Ensure that the file is readable by the user who runs the Web Server instance. Because this user is typically root, no
additional steps are typically required on Unix. Windows users who adjust the vFabric Web Server service to run as an
account other than LocalSystem will need to verify these permissions.