Application Pool Settings

InstallShield 2020 » Internet Information Services View » Application Pools

Project:The Internet Information Services view is available in the following project types:

• Basic MSI
• DIM
• InstallScript
• InstallScript MSI
• Merge Module

Note:Application pools are available only on machines with IIS 6.0 or later installed.

Use the Application Pools item in the Internet Information Services view to add and delete application pools.

When you select an application pool in the explorer, many settings are displayed. The application pool settings are organized into several main categories:

• General
• CPU Settings
• Process Model
• Recycling

General Settings

The following settings are available in the General area for an application pool in the Internet Information Services view.

General Settings for an Application Pool

Setting

Description

Name

Provide a display name for the application pool that you want to configure.

When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.

Component

Select the component with which the application pool is associated. You can also click the ellipsis button (...) to locate an existing component or create a new one.

Overwrite Existing Application Pool

Select the appropriate option to indicate the behavior that you want to occur if the application pool already exists on the target system at run time. Available options are:

• Yes—If the application pool already exists on the target system, the installation overwrites its settings with the values that you have configured for it in your project. During uninstallation, the application pool is uninstalled.
• No—If the application pool already exists on the target system, the installation does not overwrite any of its settings; during uninstallation, the application pool is left on the target system. If the application pool does not exist on the target system, the installation creates it; during uninstallation, the application pool is uninstalled.

Mark Component as Permanent

Specify whether you want the component that contains the application pool to be removed when the component's feature is uninstalled. If you want the component to be marked as permanent so that it is not uninstalled, select Yes.

.NET Framework Version

If appropriate, select the .NET Framework version that the application pool should load.

This setting applies to IIS 7 and later. Earlier versions of IIS ignore this setting.

Queue Length

Specify the maximum number of requests that HTTP.sys should queue for the application pool. The default value is 4000.

Managed Pipeline Mode

Specify the appropriate request-processing pipeline mode for the selected application pool:

• Integrated—The ASP.NET request processing is integrated into the IIS 7 request-processing pipeline. This is the default option.
• Classic—IIS routes requests for code through ISAPI, which processes the requests as if the application were running in IIS 6.

This setting applies to IIS 7. Earlier versions of IIS ignore this setting.

Enable 32-Bit Applications

Specify whether you want to allow 32-bit applications in the selected application pool to be run on 64-bit systems.

This setting applies to application pools that are installed on IIS 7 or later. Earlier versions of IIS ignore this setting.

For more information, see Considerations for Supporting IIS 6 on 64-Bit Platforms.

CPU Settings

The following settings are available in the CPU area for an application pool in the Internet Information Services view.

CPU Settings for an Application Pool

Setting

Description

Limit

Specify the maximum percentage of CPU time (in 1/1000ths of a percent) that the worker processes in the application pool are allowed to consume over the period of time that is indicated for the Limit Interval setting.

To avoid limiting the worker processes to a percentage of CPU time, specify the number 0. If you leave this setting blank, InstallShield does not configure the CPU limit, and whatever value is set by default on the server is used for your application pool.

Limit Action

Specify the action that should occur if the CPU limit that is set for the application pool is exceeded. Available options are:

• No action—An event entry is added to the event log. No other action occurs.
• Shutdown—An event entry is added to the event log. In addition, the application pool is shut down for the remainder of the limit interval.

Limit Interval (minutes)

Specify the amount of time (in minutes) between the reset intervals for CPU monitoring and throttling limits on the application pool.

When this time interval has elapsed, IIS resets the CPU timers for the logging and limit intervals.

To disable CPU monitoring, specify the number 0. If you leave this setting blank, InstallShield does not configure the CPU limit interval, and whatever value is set by default on the server is used for your application pool.

Process Model Settings

The following settings are available in the Process Model area for an application pool in the Internet Information Services view.

Process Model Settings for an Application Pool

Setting

Description

Identity

Specify the account under which the application pool’s worker process should run. Available options are:

• NetworkService—This account is a member of the Users group, and it has the fewest user rights that are required to run the application. This account provides the most security against an attack that might try to take over the Web server.
• LocalService—This account is a member of the Users group, and it has the same user rights as the NetworkService account. However, the LocalService account is limited to the local computer.
• LocalSystem—This account has all user rights, and it is part of the Administrators group.
• SpecificUser—If you do not want to use one of the predefined accounts, select this option, and also specify the user name and password for the account that you want to use.
• ApplicationPoolIdentity—This account uses a virtual identity that is unique to the selected application pool for running the application pool’s worker process. Support for this option is available on target systems that have IIS 7 and later. If this new option is selected in an installation that is run on a system that has IIS 6, the NetworkService account is used instead for the application pool’s identity.

Note:If you use a SpecificUser identity, ensure that the user account that you specify is a member of the IIS_IUSRS group on the Web server so that the account can access the appropriate resources.

SpecificUser User Name

If you select SpecificUser for the Identity setting, enter the specific user’s user name.

SpecificUser User Password

If you select SpecificUser for the Identity setting, enter the specific user’s password.

Project:In Basic MSI and InstallScript MSI projects, you can specify a Windows Installer property for the password. To prevent the password from being logged, set the value of the MsiHiddenProperties property to the name of the Windows Installer property that you are using for the password. For more information, see MsiHiddenProperties in the Windows Installer Help Library.

Idle Timeout (minutes)

Specify the amount of time (in minutes) for which a worker process should remain idle before it is shut down.

Maximum Worker Processes

Specify the maximum number of worker processes that can service requests for the application pool.

If you specify a number greater than 1, the application pool is considered to be a Web garden.

Load User Profile

Select the appropriate option to load the user profile for an application pool entity. Available options are:

• Yes—IIS loads the user profile for the application pool.
• No—IIS does not load the user profile for the application pool. This is the same behavior that occurred with IIS 6.0.

Recycling Settings

The Recycling settings for an application pool in the Internet Information Services view let you configure the recycling of worker processes. In worker process isolation mode, you can configure IIS to periodically restart worker processes in an application pool, enabling you to manage precisely those worker processes that are faulty. This helps to ensure that specified applications in those pools remain healthy and that system resources can be recovered.

The following settings are available in the Recycling area for an application pool in the Internet Information Services view.

Recycling Settings for an Application Pool

Setting

Description

Regular Time Interval (minutes)

Specify the amount of time (in minutes) after which the application pool should be recycles.

To prevent the application pool from being recycled on a regular interval, enter the number 0.

Request Limit

Specify the maximum number of requests that the application pool can process before it is recycled.

To allow the application pool to process an unlimited number of requests, enter the number 0.

Specific Times

To specify the time of day when the application pool should be recycled, click the ellipsis button (...) in this setting. The Recycling Specific Times dialog box opens, enabling you to configure the specific local time or times.

When you specify a time, use the 24-hour format. For example, to specify 10:00 P.M., enter a time of 22:00.

In this setting, InstallShield indicates the number of times that were specified, and also lists the times in square brackets. Times are separated with a vertical bar. For example, the following value indicates that the specific recycling times are 5:00 A.M. and 11:00 P.M.:

2 defined [05:00|23:00]

See Also

Adding Application Pools

Uninstalling Web Service Extensions and Application Pools

Internet Information Services View

Managing Internet Information Services