Summary

Synopsis

Internet Information Services support was added to InstallScript project types beginning with InstallShield X. This functionality allows you to configure and install web sites and virtual directories. Specifically, you can statically set the port number of your web site through the InstallShield IDE. However, you may want to set the port number dynamically through script. This article explains how this can be done in an InstallScript project type. NOTE: This does not apply to an InstallScript MSI project type.

Discussion

To dynamically set the Port Number property of the web site you are about to install, follow these steps:

1. In your InstallScript project, select the Files and Folders view, under Application Data > Files and Folders.

2. Underneath the Destination Computer node, right-click the Script-defined Folders node and select New Folder to create a new script-defined folder variable, for example, <PORTNUMBER>. You will use this script-defined folder variable to dynamically set the port number for your web site.

3. Open the Internet Information Services view, under Server Configuration > Internet information Services.

4. Select the web site you want to configure and a property sheet for that web site should appear to the right.

5. Change the Port Number property from the default value of 80 and replace it with the script-defined folder variable you created, for example, <PORTNUMBER>. The script-defined folder variable is case sensitive.

6. Select the InstallScript view, under Behavior and Logic > InstallScript.

7. In your setup.rul file, add custom code to dynamically determine the port number you want to install. This can be done through a simple dialog or by some other means.

8. Use the InstallScript function TextSubSetValue() to assign the port number value to the script-defined folder variable you created. Because the web site is installed during data transfer, make sure your call to TextSubSetValue() is made in a script event that occurs before data transfer, for example, OnFirstUIBefore.

   NOTE: For DevStudio 9 InstallScript projects, you can use the function FeatureSetTarget() instead of TextSubSetValue().

Additional Information