Configuring Process Recycling Events

Before configuring process recycling events, you should understand why process recycling is configured at different levels of the metabase and when the properties are inherited by other levels.

There are four metabase keys that are used to configure process recycling, as described in About Process Recycling. They are PeriodicRestartTime, PeriodicRestartRequests, PeriodicRestartSchedule and ShutdownTimeLimit. Of the four, only the ShutdownTimeLimit metabase key cannot be configured from the UI. See Configuring Events without the UI for information about configuring the ShutdownTimeLimit metabase key.

Configuring Events Using the UI

Important   The W3SVC (IISWebService) level is the only level that Process Recycling settings for Pooled out-of-process (OOP) applications are available.

To configure the W3SVC (IISWebService) level

1. In the IIS snap-in, right-click the computer icon, and click Properties.

2. Select the Internet Information Services tab. Under the Master Properties section, select WWW Service from the Master Properties list, and click Edit.

3. Select the Home Directory tab.

4. In the Application Settings section, click Configuration.

5. Select the Process Options tab.

You are now on the Process Options property sheet. For information about how to configure process recycling events using this property sheet, see Process Options Property Sheet

Important   Process Recycling settings for Isolated OOP applications can only be configured at the three levels listed below using the UI. A prerequisite to configuring at these levels with the UI is that an Isolated application exists at the level you are enabling Process Recycling on. Otherwise, the Recycling Options on the Process Options properties sheet will be grayed out and un-available. For information about creating an application, see Creating Applications.

To configure the W3SVC/n/ROOT (IISWebVirtualDir) level

1. In the IIS snap-in, right-click the virtual directory that you want to configure, and select Properties from the list.

2. Select the Virtual Directory tab.

3. In the Application Settings section, click Configuration.

4. Select the Process Options tab.

You are now on the Process Options property sheet. For information about how to configure Process Recycling events using this property sheet, see Process Options Property Sheet

To configure the W3SVC/n/ROOT/WebVirtualDir (IISWebVirtualDir) level

1. In the IIS snap-in, right-click the directory within a virtual directory that you want to configure, and select Properties from the list.

2. Select the Directory tab.

3. In the Application Settings section, click Configuration.

4. Select the Process Options tab.

You are now on the Process Options property sheet. For information about how to configure Process Recycling events using this property sheet, see Process Options Property Sheet

To configure the W3SVC/n/ROOT/WebVirtualDir/WebDir (IISWebDirectory) level

1. In the IIS snap-in, right-click the Web directory within a virtual directory that you want to configure, and select Properties from the list.

2. Select the Directory tab.

3. In the Application Settings section, click Configuration.

4. Select the Process Options tab.

You are now on the Process Options property sheet. For information about how to configure Process Recycling events using this property sheet, see Process Options Property Sheet

Process Options Property Sheet

From this property sheet you can configure the following:

• If you choose to recycle applications after a set amount of time, select the Recycle Application Process after (# of) minutes check box and enter a whole number in the minutes text box. Entering the number "0" in the minutes field disables this feature. NOTE: This recycling event may not occur exactly on the threshold, it may occur shortly thereafter due to load on the server.
• If you choose to recycle applications after a set number of requests, select the Recycle Application Process after (# of) requests check box and enter a whole number in the requests text box. Entering the number "0" in the requests field disables this feature.
• If you choose to recycle applications at a certain time each day, select the Recycle Application at the following times during the day: check box and use the Add Time button to add a time of day, or multiple times per day. The default value is an empty sting.

Configuring Events without the UI

Configuring Process Recycling events without the UI allows you to configure these settings at any level of the metabase. You may want to do this for finer control of where settings can be inherited from. However, this approach requires an understanding of the following:

• How inheritance works
• The metabase keys that are unique to Process Recycling
• An understanding of the AppIsolated metabase key

Before configuring Process Recycling without the UI, you should review Levels and Inheritance.

You can use the following methods to configure process recycling without using the UI:

• Active Directory Service Interfaces (ADSI)
• A Metabase Editor, such as MetaEdit, included with the Windows 2000 Resource Kit.

See the ADSI Reference for information about using ADSI. You can use the IIS Admin Script Utility (adsutil) with ADSI to configure the metabase.

Related Resources

The following resources provide related information:

• About Applications   Conceptial information about applications, their starting point, and about the different processes an application can run in.
• Isolating Applications   Step-by-step instruction about how to configure an application to run in different processes.
• ADSI Reference   The ADSI Reference section describes properties and methods that are exposed by the IIS Admin Objects.
• IIS Admin Script Utility (adsutil)   The IIS administration utility uses VBScript with ADSI to manipulate the IIS configuration.

© 1997-2001 Microsoft Corporation. All rights reserved.