vFabric Web Server Installation and Configuration VMware vFabric Web Server 5.0 VMware vFabric Cloud Application Platform 5.0 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
You can find the most up-to-date technical documentation on the VMware Web site at: https://www.vmware.com/ support/. The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http:// www.vmware.
Table of Contents 1. About vFabric Web Server Installation and Configuration .............................................................................. 1 Intended Audience ......................................................................................................................... 1 2. Overview of vFabric Web Server ............................................................................................................ 3 Complete Packages and Modules in vFabric Web Server 5.0 ...........
iv vFabric Web Server
About vFabric Web Server Installation and Configuration 1 1. About vFabric Web Server Installation and Configuration VMware vFabric Web Server Installation and Configuration describes product concepts and product-specific configuration tasks for VMware® vFabric™ Web Server. Fully compatible with Apache Web Server, vFabric Web Server is a dynamic loadbalancing service that is available exclusively with VMware® vFabric™ Cloud Application Platform.
2 vFabric Web Server 2 About vFabric Web Server Installation and Configuration
Overview of vFabric Web Server 3 2. Overview of vFabric Web Server vFabric Web Server is the Web server and load-balancing component of VMware vFabric Cloud Application Platform (vFabric Platform). vFabric Web Server 5.0 is based on Apache HTTP Server version 2.2. In addition to the standard features of Apache HTTP Server, vFabric Web Server provides the following mission-critical benefits: • Ability to easily install multiple instances of vFabric Web Server running on a single computer.
4 vFabric Web Server For details on configuring an application, including the number of persistent processes created, see Apache Module mod_fcgid. Open SSL 0.9.8r Supports SSLFIPS and SSLInsecureRenegotiation Directives The mod_ssl directive SSLInsecureRenegotiation supports per-directory/per-server client certificate renegotiation with legacy clients. Users are strongly cautioned to update all clients to use only the new TLS Renegotiation mechanism. The OpenSSL 0.9.
Installing vFabric Web Server 5 3. Installing vFabric Web Server vFabric Web Server is available only as part of vFabric Cloud Application Platform, which in turn runs only on vSphere. This means that you install vFabric Web Server on virtual machines that run on the vCenter Server. These VMs can run Red Hat Enterprise Linux, Ubuntu Linux, or Windows operating systems. Each type of operating system requires its own installation procedure.
6 vFabric Web Server • Installs vFabric Web Server into the /opt/vmware/vfabric-web-server directory. • Sets the owner of all directories and files under /opt/vmware/vfabric-web-server to root. What to do next • Read Description of 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.
Installing vFabric Web Server 7. 7 Change to the vfabric-web-server directory and run the fixrootpath.pl Perl script to correct the root paths. For example: prompt# cd vfabric-web-server prompt# perl fixrootpath.pl What to do next • Read Description of 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.
8 7. vFabric Web Server 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. For example, to use the 64-bit edition of vFabric Web Server on a Windows 2008 computer, run the following command: prompt> mklink /d httpd-2.2 httpd-2.2.19.0-64 On Windows 2003, use the makelink command, which is included in the main vFabric Web Server directory (such as c: \opt\vmware\vfabric-web-server).
Installing vFabric Web Server 9 Each instance directory contains subdirectories that contain all the data required to run a given vFabric Web Server instance. This includes configuration data as well as all other data that is associated with that instance's configuration.
10 vFabric Web Server 10 Installing vFabric Web Server
Creating and Using vFabric Web Server Instances 11 4. Creating and Using vFabric Web Server Instances To start using vFabric Web Server, you explicitly create a new instance after you install it. An instance is not created for you by default.
12 vFabric Web Server Procedure 1. Log on to your computer as root (Linux) or the Administrator user (Windows) and open a terminal (Linux) or command window (Windows). 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.
Creating and Using vFabric Web Server Instances 13 Table 4.1. Options of the newserver Command Option Description Required? --server=servername Name of the new vFabric Web Server instance. The value of this option also can be the name of the directory that contains the instance configuration files, and by default is the name of the host. Yes. --rootdir=rootdir Directory that contains the httpd-2.2.version directory, which in turn contains the Apache HTTP binaries. No.
14 vFabric Web Server 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.
Creating and Using vFabric Web Server Instances 15 prompt# cd /opt/vmware/vfabric-web-server/myserver/bin 3. Start the instance using the ./httpdctl start command: prompt# ./httpdctl start You should see a message as follows: Starting Apache: Server started OK 4.
16 vFabric Web Server 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\vfabricweb-server: prompt> cd c:\vmware\vfabric-web-server\myserver\bin 3.
Creating and Using vFabric Web Server Instances 17 The configuration file is called httpd.conf and is located in the INSTANCE-DIR/conf, such as /opt/vmware/ vfabric-web-server/myserver/conf/httpd.conf. The DocumentRoot directive looks like the following: DocumentRoot "/opt/vmware/vfabric-web-server/myserver/htdocs" 2. Copy your sample HTML pages to the document root. For example, if you have a hello.html page in the /home/samples directory that you want to serve up: prompt# cp /home/samples/hello.
18 vFabric Web Server 18 Creating and Using vFabric Web Server Instances
Configuring vFabric Web Server Instances 19 5. Configuring vFabric Web Server Instances The default configuration of a newly created vFabric Web Server instance is fairly simple. Although the configuration is likely adequate for your needs, sometimes you might need to further configure the instance to enable one of its many useful features, such as load-balancing between two or more tc Server instances. This chapter provides some information to get you started.
20 vFabric Web Server • Two tc Runtime instances are running at the following two hosts and port numbers: • http://192.168.0.203:8081 • http://192.168.0.
Configuring vFabric Web Server Instances LoadModule proxy_module LoadModule proxy_http_module 21 "VFWS-INSTALL/httpd-2.2/modules/mod_proxy.so" "VFWS-INSTALL/httpd-2.2/modules/mod_proxy_http.so" where VFWS-INSTALL refers to the directory in which you installed vFabric Web Server. If they are not in the file, add them in the same location as the other LoadModule directives.
22 4. vFabric Web Server Optional. If you want to enable the balancer manager Web application to watch the load balancing activity and control the behavior, add the following to the httpd.conf configuration file of your vFabric Web Server instance: SetHandler balancer-manager Order Deny,Allow Deny from all # BE VERY RESTRICTIVE with YOUR ALLOW STATEMENT Allow from 127.0.0.1 5. Optional. If you want to enable sticky sessions, follow these steps: a. In the httpd.
Configuring vFabric Web Server Instances 23 http://www.myhost.com/my-app If you see your application, then you have correctly set up the vFabric Web Server instance to route requests to the /my-app application to one of the two tc Runtime instances. The vFabric Web Server instance will also balance the load between the two instances. • If you enabled the balancer manager Web application, use it to watch and control load-balancing activity.
24 vFabric Web Server 24 Configuring vFabric Web Server Instances
Additional Documentation 25 6. Additional Documentation The documentation in this guide provides information about what vFabric Web Server contains; how to install it; and how to create, start, and stop instances. The vFabric Web Server documentation does not, however, provide details about configuring and using the core Apache HTTP component; for that you must go elsewhere, such as the Apache documentation. • Apache HTTP Server 2.2 http://httpd.apache.org/docs/2.2/ • OpenSSL http://www.openssl.
26 vFabric Web Server 26 Additional Documentation
