Application and Virtual Directory Settings

InstallShield 2019 Express Edition » Internet Information Services View » Web Sites » Virtual Directory

Edition • The Express edition of InstallShield includes support for installing only one Web site per installation.

The following editions of InstallShield support the creation of more than one Web site per installation. These editions also include support for managing IIS application pools and Web service extensions:

•

Premier

•

Professional

In addition, the Premier edition of InstallShield includes an IIS scanner that checks an existing IIS Web site and records data about the settings for the Web site, its virtual directories, its applications, and its application pools. You can import that IIS data into the Internet Information Services view in InstallShield Premier Edition. Once you have imported the IIS data into a project, you can use the Internet Information Services view to make changes to the IIS settings as needed.

You can add applications and virtual directories to your Web site in the Internet Information Services view. When you select an application or virtual directory in this view, many settings are displayed. The settings are organized into several main categories:

•

•

•

•

•

The following settings are available in the General area for an application or a virtual directory in the Internet Information Services view.

General Settings for an Application or a Virtual Directory
Setting	Description
Name	Enter a name for the application or virtual directory.
ASP.NET Version	Note • This setting applies to applications but not virtual directories. To set the ASP.NET version for the application, enter the complete version number, or select it from the list. For example, to specify version 2 of ASP.NET, type 2.0.50727. To specify version 1.1 of ASP.NET, type 1.1.4322. If you specify an ASP.NET version for a Web site, IIS uses that same version number for any of the Web site’s applications. Important • If your installation may be run on a Windows Vista or later system, you may not want to set the ASP.NET version. Also note that if you specify version 3 of ASP.NET, an error occurs at run time. For more information, see Setting the ASP.NET Version for a Web Site or Application.
Default Documents	Type the name of the default page on your application or virtual directory. To specify multiple pages, separate each with a comma. An application or virtual directory serves a default page whenever a browser request does not specify a document name.

Virtual Directory Settings

The following settings are available in the Virtual Directory area for an application or a virtual directory in the Internet Information Services view.

Virtual Directory Settings for an Application or a Virtual Directory

Setting

Description

Content Source Path (Local or UNC)

This setting identifies the local path or network directory path that stores the default files for your application or virtual directory.

•

If the content for the application or virtual directory is on the target system, click the ellipsis button (...) in this setting to specify a local path. The Browse for Directory dialog box opens.

By default, the files are stored in IISROOTFOLDER.

•

If the content for the application or virtual directory is not on the target system, click the UNC button in this setting to specify a network location. Following is an example:

\\server\share

Tip • Each application or virtual directory should have a unique physical path, especially if it is going to be installed on a Windows Vista and later system or a Windows Server 2008 and later system. To learn more, see Run-Time Requirements for IIS Support.

Script Source Access

Specify whether you want to allow end users to access source code if either read or write permissions are set. Source code includes scripts in ASP applications.

Read Access

Specify whether you want to provide end users with read access to the application or virtual directory.

Write Access

Specify whether you want to provide end users with write access to the application or virtual directory. This means that end users can change the application’s or virtual directory’s properties on the target machine.

Directory Browsing

Specify whether you want to allow end users to see all the virtual directories and subdirectories below this application or virtual directory.

Log Visits

Specify whether you want to record visits to this application or virtual directory in a log file. Visits are recorded only if logging is enabled.

Index this Resource

Specify whether you want to allow Microsoft Indexing Service to include this application or virtual directory in a full-text index.

This setting applies to IIS 6 and earlier. IIS 7 ignores this setting.

Application Settings

The following settings are available in the Application Settings area for an application or a virtual directory in the Internet Information Services view.

Application Settings for an Application or a Virtual Directory

Setting

Description

Application Name

To associate the selected virtual directory with an application, specify the application name.

Note • This setting is available for virtual directories, but not for applications.

If the virtual directory was created in InstallShield 2009 or earlier and then upgraded to the current version of InstallShield, this setting is displayed. Otherwise, this setting is not included.

Application Mappings

To customize the directory’s application mappings, click the ellipsis button (...) in this setting. This opens the Application Mappings dialog box, which enables you to add, edit, and delete a mapping between a file name extension and the application that processes those files.

MIME Types

To add, edit, or delete MIME types for the selected application or virtual directory, click the ellipsis button (...) in this setting. This opens the MIME Types dialog box, which enables you to add, edit, and delete a mapping between a file name extension and the corresponding content type that is served as a static file by the Web server on the target system to a browser or mail client.

Session Timeout (minutes)

Specify the number of minutes that a session can remain idle before the server terminates it automatically. If the end user does not refresh or request a page within the timeout period, the session ends. The default value is 20 minutes.

ASP Script Timeout (seconds)

Specify the length of time in seconds that .asp pages will allow a script to run before terminating and writing an event to the Windows Event Log. The minimum value for this property is 1 second and the default value is 90 seconds.

Execute Permissions

Specify what level of program execution is allowed for the selected application or virtual directory. Available options are:

•

None—Only static files such as HTML and image files can be accessed.

•

Scripts Only—Only scripts such as ASP scripts can be run.

•

Scripts and Executables—All file types can be accessed or run.

Application Protection

Note • This setting applies to applications but not virtual directories.

Specify the level of protection:

•

High—The application is run in an isolated process that is separate from other processes.

•

Medium—The application is run in an isolated pooled process with other applications.

•

Low—The application is run in the same process as Web services.

This setting applies to IIS 5 and earlier. Later versions ignore this setting.

Security Settings

When you select an application or a virtual directory in the Internet Information Services view, InstallShield displays several security-related settings in the Security area. The Security area lets you configure your application or virtual directory to verify the identify of users. You can authenticate users to prevent unauthorized ones from establishing a Web (HTTP) connection to restricted content. For more information, refer to the IIS documentation.

The Security area contains the following categories of settings:

•

Anonymous Connection

•

Authenticated Access

The settings in the Anonymous Connection area are as follows.

Anonymous Connection Settings in the Security Settings Area
Setting	Description
Enable Anonymous Access	Specify whether you want to allow users to establish an anonymous connection. If you do want to allow anonymous connections, also enter the appropriate Windows user account information. If you do not need the Web server to confirm the identity of end users before they can access the content, select No for this setting.
IIS Controls Anonymous Password	Specify whether you want to automatically synchronize your anonymous password settings with those set in Windows on the target system. If the password that you type for the anonymous account differs from the password that Windows has, anonymous authentication will not work. Note • Password synchronization should be used only with anonymous user accounts defined on the local computer, not with anonymous accounts on remote computers.
Anonymous User Name	If you are enabling anonymous connections, type the name of the anonymous account.
Anonymous Password	If you have selected No for the IIS Controls Anonymous Password setting, type the anonymous user account password. The password is used only within Windows. Anonymous users do not log on by using a user name and password.

The settings in the Authenticated Access area are as follows.

Authenticated Access Settings in the Security Settings Area

Setting

Description

Basic authentication

Specify whether you want to enable the basic authentication method for collecting user name and password information for end users who access the application or virtual directory.

Important • With the basic method of authentication, user names and passwords are not encrypted when they are transmitted across the network. An unscrupulous end user who has network monitoring tools could intercept user names and passwords.

Integrated Windows authentication

Specify whether you want to enable integrated Windows authentication. Integrated Windows authentication uses a cryptographic exchange with the end user's browser to confirm the identity of the user.

When integrated Windows authentication is enabled, the Web site will use it only under the following conditions:

•

Anonymous access is disabled.

•

Anonymous access is denied because Windows file system permissions have been set, requiring end users to provide a Windows user name and password before establishing a connection with restricted content.

Advanced Settings

The following settings are available in the Advanced area for an application or a virtual directory in the Internet Information Services view.

Advanced Settings for an Application or a Virtual Directory
Setting	Description
Custom Errors	To customize HTTP errors that are sent to clients when Web server errors occur, select the ellipsis button (...) in this setting. The Custom Errors dialog box opens, enabling you to specify the page that should be displayed for one or more HTTP errors. Administrators can use generic HTTP 1.1 errors, detailed custom error pages that IIS provides, or your own custom error pages that are you including in the installation.

Application and Virtual Directory Settings

InstallShield 2019 Express Edition Help Library

April 2019