Microsoft KB Archive/324355

= HOW TO: Install and Performance-Tune Microsoft Scalable Web Cache (SWC) 3.0 in Windows 2000 =

PSS ID Number: 324355

Article Last Modified on 11/20/2003

-

The information in this article applies to:


 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Professional
 * Microsoft Windows 2000 Server

-



This article was previously published under Q324355



IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

IN THIS TASK

 * SUMMARY
 * ** Overview of SWC 3.0
 * How to Install and Performance-Tune Microsoft Scalable Web Cache (SWC) 3.0
 * *** Download SWC 3.0
 * Configure and Run SWC 3.0
 * SWC 3.0 Logfile Post-Processing
 * REFERENCES



SUMMARY
This article describes how to install and performance-tune Microsoft Scalable Web Cache (SWC) 3.0 for use with Microsoft Internet Information Services (IIS) in Windows 2000.

Overview of SWC 3.0
SWC 3.0 is an HTTP 1.0-compliant front-end cache for Web request operations, and it is designed for use with IIS. SWC 3.0 and Trusted user Web Cache (TWC) API set extend the functionality of Microsoft SWC 2.0. In addition to maintaining the following SWC 2.0 features
 * Binary logging format
 * High level of performance in serving static requests
 * Scalability in symmetric multiprocessor computers

SWC 3.0 also supports keep-alive requests, dynamic requests, and CGI requests.

SWC 3.0 includes the following components:
 * Swc.sys: The kernel-mode SWC 3.0 driver.
 * Twcnt.lib and Twccore.lib: User-mode libraries for user-mode code to work with SWC 3.0.
 * Twcapi.txt: A document that describes API exposed by Twcnt.lib and Twccore.lib.
 * Twcshutdown.exe: A utility to shut down the user-mode application and Cgigate.exe.
 * Cgigate.exe: CGI gateway.
 * Swcpp.exe: A tool for post-processing Swc.log.

back to the top

How to Install and Performance-Tune Microsoft Scalable Web Cache (SWC) 3.0
Use the following methods to install and performance-tune SWC 3.0.

Download SWC 3.0
Download and extract SWC 3.0 to a folder on your computer's hard disk. To download SWC 3.0, visit the following Microsoft Web site:

http://www.microsoft.com/downloads/release.asp?ReleaseID=29211

back to the top

Configure and Run SWC 3.0
To configure and run SWC 3.0, follow these steps.

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

 Copy the Swc.sys file to the %SystemRoot%\System32\Drivers folder on your hard disk. Set up the registry parameters on the server. To do this, click Start, and then click Run. In the Open box, type cmd, and then click OK. At the command prompt, type regini server.reg, and then press ENTER. Modify the parameters in Swc.reg according to the configuration of your computer. The SmallBufferSize and LargeBufferSize parameters use megabyte (MB) units and must be adjusted according to the configuration of your server. These buffers are allocated from physical memory.

You may also have to modify the following registry values in the Swc.reg file:

'''LogDrive

VirtualRootName

VirtualRootPath'''

 Set up the registry parameters on the server for the Swc.sys driver. To do this, click Start, and then click Run. In the Open box, type cmd, and then click OK. At the command prompt, type regini swc.reg, and then press ENTER. Copy Cgigate.exe, Twcshutdown.exe, and your TWC program to your VirtualRoot directory. Start both SWC 3.0 and the TWC program. To do this:  Click Start, and then click Run. In the Open box, type cmd, and then click OK.</li> At the command prompt, type the following lines (press ENTER after each line):

net stop w3svc

net start swc

net start w3svc

</li> Navigate to your VirtualRoot directory, start your TWC program, and then run Cgigate.exe.</li></ol> </li> To stop SWC and your TWC program, follow these steps: <ol style="list-style-type: lower-alpha;"> Run Twcshutdown.exe.</li> Click Start, and then click Run. In the Open box, type cmd, and then click OK.</li> At the command prompt, type the following lines (press ENTER after each line):

net stop w3svc

net stop swc

</li></ol> </li></ol>

back to the top

SWC 3.0 Logfile Post-Processing
SWC logs all transactions in binary format. To view the SWC logs, you must first batch-process the logs by using the Swcpp.exe post-processing tool.

The log file is created at the root of the LogDrive, as specified in Swc.reg. Make a copy of the file (for example, copy swc.log snapshot02222000.log), and then post-process the log copy.

You can us the following parameters with Swcpp.exe:
 * -o: Use this parameter to specify the output file name.
 * -l: Use this parameter to specify the log file to be processed.
 * -s: Use this parameter to specify the increment. The default increment is 10000.

For example:

swcpp -o snapshot02222000.txt -l snapshot02222000.log -s 100000

back to the top

<div class="references_section">