General Information Settings

InstallShield 2012 Spring Express Edition

The General Information settings are organized into the following main categories:

General
Summary Information Stream
Add or Remove Programs
Software Identification Tag

General Settings

Use the General area of the General Information view to specify details such as product name and product version. The following settings are available in this area.

General Settings

Setting

Description

Product Name

Enter the name of the product. For information on how the product name is used, see Specifying a Product Name.

Product Version

Enter the version number for your product. The version must contain only numbers. It is typically in the format aaa.bbb.ccccc or aaa.bbb.ccccc.ddddd, where aaa represents the major version number, bbb represents the minor version number, ccccc represents the build number, and ddddd represents the revision number. The maximum value for the aaa and bbb portions is 255. The maximum value for ccccc and ddddd is 65,535.

Note that although you can include the fourth field (ddddd), the installation does not use this part of the product version to distinguish between different product versions. To learn more, see Specifying the Product Version.

If your release includes a Setup.exe file, the product version that you specify is displayed on the Properties dialog box for Setup.exe. For more information, see Customizing File Properties for the Setup Launcher.

Product Code

Enter a GUID that uniquely identifies this product. To have InstallShield generate a different GUID for you, click the Generate a new GUID button ({...}) in this setting.

Since this code uniquely identifies your product, changing the product code after you have already distributed your release is not recommended.

For more information, see Setting the Product Code.

Upgrade Code

Enter a GUID that uniquely identifies this product. To have InstallShield generate a different GUID for you, click the Generate a new GUID button ({...}) in this setting.

The product GUID is used to associate uninstallation or maintenance with the original installation. A new GUID is automatically generated for each new project that you create, including copies of existing projects. Once you have changed a project's product GUID, its previous GUID cannot be recovered. For these reasons, changing a project's product GUID is typically not necessary and should be approached with caution.

For more information, see Setting the Upgrade Code.

INSTALLDIR

Specify the value of the Windows Installer property INSTALLDIR, which indicates the destination directory where most of the files of the product will be installed at run time. The default value is as follows:

[ProgramFilesFolder]My Company Name\My Product Name

Instead of hard-coding a path, you can enter a directory property as part of the path. To select a directory property, click the ellipsis button (...) in this setting. This enables you to select the appropriate directory from a list, or to create a new directory within a predefined directory. Separate further levels of subdirectories with a backslash—for example, [ProgramFilesFolder]MyApp\Bin.

For more information, see Setting the Default Product Destination Folder (INSTALLDIR).

Locked-Down Permissions

Select the type of permissions that you want to use for securing files, folders, and registry keys for end users who run your product in a locked-down environment. Available options are:

Custom InstallShield handlingInstallShield uses a custom ISLockPermissions table and adds custom actions to your project to set permissions on the target system. This option is the default value.
Traditional Windows Installer handlingInstallShield uses the LockPermissions table in the .msi database to store permission information for your product.

It is often more advantageous to use the custom InstallShield handling than the traditional Windows Installer handling. For example:

The custom option includes support for many well-known security identifiers (SIDs) that are not supported by the traditional option.
The custom option supports the use of localized user names for many well-known SIDs, unlike the traditional option. With the traditional option, if you try to use a localized name to set permissions on a non-English system, the installation may fail.
The custom option lets you specify that you want to deny a user or group from having the permissions that you are specifying. The traditional handling does not allow you to do this. That is, with the traditional handling, you can only set specific permissions; you cannot deny permissions.

This is a project-wide setting that affects all new permissions that you set for files, folders, and registry keys in your project. If you have already configured some permissions in your project and then you change the value of this setting, InstallShield lets you specify whether you want to use the alternate handling method for those already-existing permissions.

For more information about configuring this setting, see Securing Files, Folders, and Registry Keys in a Locked-Down Environment.

DATABASEDIR

Specify the default destination folder for all of your application's database files.

Note: When you are specifying a destination folder for your application's database files, you cannot include a space after the closing square bracket (]), or before or after a backslash (\). For example, the following paths are not valid:

[ProgramFilesFolder] \MyApp\Bin

[ProgramFilesFolder]MyApp\ Bin

It is important to note when using an installer folder property such as DATABASEDIR that you are specifying a default value. An end user could change this value by setting a property when launching Msiexec.exe at the command line or by selecting a new destination folder for a feature in the Database Folder dialog.

Default Font

To select the font that you want your installation to use in its user interface, click the ellipsis button (...) in this setting. If you do not select a font, the installer uses the default system font.

ALLUSERS

Specify how the Windows Installer property ALLUSERS should be set in your project. The ALLUSERS property specifies whether Windows Installer should attempt to perform a per-machine or per-user installation. Valid options are:

ALLUSERS="" (Per-user installation)—Windows Installer performs a per-user installation, and the configuration information is stored in the user's personal profile.
ALLUSERS=1 (Per-machine installation)—If the value of ALLUSERS is set to 1, Windows Installer attempts a per-machine installation. For per-machine installations, configuration information such as shortcuts and registry entries are stored in the All Users profile.

On Windows Vista and later systems, if User Account Control is enabled and the user does not have administrative privileges, the user must be able to provide administrative credentials in order to install the product.

On other systems, if the user does not have administrative privileges, the installation displays an error message and exits.

ALLUSERS=2 (Per-user or per-machine installation)—Windows Installer attempts to perform a per-machine installation on Windows Vista and later systems. On earlier platforms, if the user has administrative privileges, Windows Installer attempts to perform a per-machine installation; otherwise, Windows Installer performs a per-user installation.

The default value for all new projects is ALLUSERS=1 (Per-machine installation).

Note: The value that you specify here for ALLUSERS could be overwritten at run time. For more information, see Per-User vs. Per-Machine Installations.

Create MSI Logs

To specify whether Windows Installer 4.0 or later should log your installation, click the ellipsis button (...) in this setting, which launches the Logging Options for Windows Installer 4.0 and Later dialog box. This dialog box is where you specify whether Windows Installer should log your installation. You can also use this dialog box to customize the types of messages that are logged.

There are three possible values for this setting:

No—Installations are not logged. This is the default value.
YesInstallShield populates the MsiLogging property with the default value of voicewarmupx.
CustomInstallShield populates the MsiLogging property with the value that you specified on the Logging Options for Windows Installer 4 and Later dialog box.

If the value of this setting is Yes or Custom, and if the installation is run with Windows Installer 4.0 or later, as well as Windows Vista or later or Windows Server 2008 or later, the following occurs:

The installer creates a log file according to the appropriate logging mode: either voicewarmupx (if the Create MSI Logs value is Yes) or whatever custom value you specified on the Logging Options for Windows Installer 4.0 and Later dialog box.
The installer populates the MsiLogFileLocation property with the log file's path.
A Show the Windows Installer log check box is added to the SetupCompleteSuccess, SetupCompleteError, and SetupInterrupted dialogs. If the end user selects that check box and then clicks Finish, the log file is opened in a text file viewer or editor.

The Create MSI Logs setting applies to installations that are run with Windows Installer 4.0 or later on Windows Vista and later systems or Windows Server 2008 and later systems. The Show the Windows Installer log check box is not visible in run-time dialogs that are displayed on earlier systems that are running earlier versions of Windows Installer.

For more information, including details on how to customize the types of messages that are logged, see Specifying Whether Windows Installer Installations Should Be Logged.

Fast Install

If you want to reduce the time that is required to install a large Windows Installer package, consider selecting the check boxes for one or more of the following options:

No system restore point is saved for this installation
Perform only File Costing and skip checking other costs
Reduce the frequency of progress messages

This setting configures the Windows Installer property MSIFASTINSTALL, which can be set at the command line.

Windows Installer 5 includes support for this setting. Earlier versions of Windows Installer ignore it.

Summary Information Stream Settings

Windows Installer databases are implemented as COM structured storage, and COM structured storage files usually contain a Summary Information Stream. The Summary Information Stream contains information about your company and the product that is being installed.

The following settings are available in the Summary Information Stream area in the General Information view.

Summary Information Stream Settings

Setting

Description

Title

Specify the type of database that you are creating. For a product installation, the default value is Installation Database, which is the recommended value.

The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties.

Subject

Enter the name of the product.

The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties.

Author

Specify your company name.

The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties.

Keywords

Specify keywords that describe the Windows Installer database for your product.

The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties.

Summary Information Stream Comments

Enter any comments about your product. A typical value for this setting is as follows:

This installer database contains the logic and data required to install MyProduct.

The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties.

Schema

This setting lets you specify the integer that identifies the minimum Windows Installer version that is required for your installation package. For a minimum of Windows Installer 2.0, enter 200. For a minimum of Windows Installer 3.0, enter 300. For a minimum of Windows Installer 3.1, enter 301. For a minimum of Windows Installer 4.5, enter 405.

If the end user's system has a Windows Installer version earlier than the minimum requirement that you specify for the Schema setting—for example, if you specify a schema value of 405 because your installation uses Windows Installer 4.5 features, but an end user has Windows Installer 3.1—the installation displays an error message and exits.

The value that you enter for the Schema setting is used for the Page Count Summary property of your Windows Installer database.

Require Administrative Privileges

Specify whether your installation requires administrative privileges. The default is Yes.

If you set this to No, InstallShield sets bit 3 in the Word Count Summary property to indicate that elevated privileges are not required to install the .msi package. Note that if you select No but your .msi package tries to perform a task for which it does not have adequate privileges, Windows Installer may display a run-time error.

This setting applies to installations that are run with Windows Installer 4.0 or later on Windows Vista and later systems or Windows Server 2008 and later systems. Earlier versions of Windows Installer and Windows ignore this setting.

Note that an end user's installation experience is more secure when installations are run with only the permissions that they need. Unless an application is designed to be run only by system administrators, it should be run with the least privilege.

Add or Remove Programs Settings

Add or Remove Programs (which is called Programs in the latest versions of Windows) in the Control Panel provides end users with technical support links and telephone numbers, product update information, and information about a product's manufacturer. Depending on how the installation is configured, the end user may have the option of removing, repairing, or changing the installation with the click of a button. You can specify this information in your project by configuring the Add or Remove Programs settings in the General Information view.

Add or Remove Programs Settings

Setting

Description

Show Add or Remove Programs Entry

Indicate whether you want to show your product's entry in Add or Remove Programs in the Control Panel. Available options are:

Yes—Your product's entry is displayed on the target system in Add or Remove Programs. This is the default value.
No—Your product's entry is not displayed on the target system in Add or Remove Programs. The end user cannot use Add or Remove Programs to remove the product, perform maintenance, or view support information. If you select this option, InstallShield disables the other Add or Remove Programs settings.

Display Icon

Enter the path on your development system to the icon file (.ico or .exe) that you want to be used for your product's entry in Add or Remove Programs. Instead of manually typing the path and file name, you can click the ellipsis button (...) in this setting to browse to the file.

Disable Change Button

Specify whether you want to disable the Change button for your product's entry in Add or Remove Programs. The Change button enables end users to change installation options after the product has been installed. End users can remove or add features as needed.

Disable Remove Button

Specify whether you want to disable the Remove button for your product's entry in Add or Remove Programs. The Remove button enables end users to remove the product by clicking one button, which runs your uninstaller with a reduced user interface.

If the end user clicks the Remove button to remove your product, actions in the User Interface sequence of the project are executed.

Disable Repair Button

Specify whether you want to disable the Repair button for your product's entry in Add or Remove Programs. The Repair button enables end users to run the Windows Installer repair option if any files have been deleted or corrupted.

Publisher

Specify the name of the company that created the product. This information is displayed for your product's entry in Add or Remove Programs. The value that you enter is stored in the Windows Installer Manufacturer property.

Publisher/Product URL

Enter a general URL for your company or product—for example, http://www.installshield.com.

On some versions of Windows, the publisher name on the Support Info dialog box is a hyperlink to this URL. The Support Info dialog box is displayed when an end user clicks the support information hyperlink for your product's entry in Add or Remove Programs.

Support Contact

Enter the name of the person or department that end users should contact for technical support.

On some versions of Windows, this information is displayed on the Support Info dialog box for your product's entry in Add or Remove Programs.

Support URL

Enter the URL that you would like end users to visit for technical support information for your product. This URL is displayed for your product's entry in Add or Remove Programs.

Support Phone Number

Enter the technical support phone number for your product.

On some versions of Windows, this information is displayed on the Support Info dialog box for your product's entry in Add or Remove Programs.

Read Me

Enter the name or path of the Readme file for your product. As an alternative, you can link to a Readme file located on the Internet by specifying a valid URL.

On some versions of Windows, this information is displayed on the Support Info dialog box for your product's entry in Add or Remove Programs.

Note: You do not need to use a backslash (\) between a directory identifier that you select from the list and the file or folder name. For example, [INSTALLDIR]MyFolder\Readme.txt is a valid path format.

Product Update URL

Specify a URL where end users can get information about product updates or download the latest version.

On some versions of Windows, this information is displayed on the Support Info dialog box for your product's entry in Add or Remove Programs.

Add or Remove Programs Comments

Enter comments about your product. This information is displayed for your product's entry in Add or Remove Programs.

Software Identification Tag Settings

Use the Software Identification Tag area of the General Information view to specify whether you want to include an ISO/IEC 19770-2 software identification tag in your installation. If a tag is included, this area also lets you specify the identification information that is not already specified in other areas of the General Information view.

For more information, see Including a Software Identification Tag for Your Product.

Software Identification Tag Settings

Setting

Description

Use Software Identification Tag

Specify whether you want to include an ISO/IEC 19770-2 software identification tag in your installation. If you select Yes, use the other tag-related settings in this area of the General Information view to specify the identification information that is not already specified in other areas of the General Information view.

Require Software Entitlement

Specify whether you want to require your product to have a corresponding software entitlement in order for software reconciliation to be considered successful. In general, if the software must be purchased, Yes should be selected for this setting; if the software is free, No should be selected for this setting.

Unique ID

Enter a unique ID that identifies the specific version of this specific product. To have InstallShield generate a different GUID for you, click the Generate a new GUID button (...) in this setting.

Note that InstallShield uses the value that you enter as part of the name of the tag file (TagCreatorID_UniqueID.swidtag). Therefore, the ID that you enter must not contain any characters that are invalid for file names.

Tag Creator

Enter the name of the organization that created the tag.

Tag Creator ID

Enter the registration ID of the organization that created the tag. This ID helps to differentiate between different legal organizations that have the same creator name but are in different countries.

The convention for the registration ID is as follows:

regid.YYYY-MM.ReversedDomainName,division

The registration ID consists of the following parts:

regid.—The string regid indicates that the XML portion is a registration ID for a software identification tag. A period (.) must be included after this string.
YYYY-MM.—This part of the registration ID identifies the first full month (MM) and the year (YYYY) in which the domain name was owned by the tag creator. For example, if you are creating the tag and you purchased the domain name February 15, 1999, you would use 1999-03 in this part of the registration ID, since the first full month the domain name was owned was March (03), and the year was 1999. The year and month must be separated by a dash.
ReversedDomainName—This part identifies the reversed domain name of the organization that is creating the software identification tag. For example, for the flexerasoftware.com domain name, the reversed domain name is:
com.flexerasoftware
,division—This optional part starts with a comma (,), and is followed by an additional string. You can enter a string that helps to distinguish between different divisions or areas of the organization. If you do not want to use this optional distinguishing part of the registration ID, do not include the comma or an additional string in your entry.

Note that InstallShield uses the value that you enter as part of the name of the tag file (TagCreatorID_UniqueID.swidtag). Therefore, the ID that you enter must not contain any characters that are invalid for file names.

Software Creator

Enter the name of the organization that created the software.

This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator setting for the name of the software creator.

Software Creator ID

Enter the registration ID of the organization that created the software. This ID helps to differentiate between different legal organizations that have the same creator name but are in different countries.

This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator ID setting for the software creator ID.

The convention for the registration ID is as follows:

regid.YYYY-MM.ReversedDomainName,division

The registration ID consists of the following parts:

regid.—The string regid indicates that the XML portion is a registration ID for a software identification tag. A period (.) must be included after this string.
YYYY-MM.—This part of the registration ID identifies the first full month (MM) and the year (YYYY) in which the domain name was owned by the tag creator. For example, if you are creating the tag and you purchased the domain name February 15, 1999, you would use 1999-03 in this part of the registration ID, since the first full month the domain name was owned was March (03), and the year was 1999. The year and month must be separated by a dash.
ReversedDomainName—This part identifies the reversed domain name of the organization that is creating the software identification tag. For example, for the flexerasoftware.com domain name, the reversed domain name is:
com.flexerasoftware
,division—This optional part starts with a comma (,), and is followed by an additional string. You can enter a string that helps to distinguish between different divisions or areas of the organization. If you do not want to use this optional distinguishing part of the registration ID, do not include the comma or an additional string in your entry.

Software Licensor

Enter the name of the organization that owns the copyright for the software.

This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator setting for the name of the software licensor.

Software Licensor ID

Enter the registration ID of the organization that owns the copyright for the software. This ID helps to differentiate between different legal organizations that have the same licensor name but are in different countries.

This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator ID setting for the software licensor ID.

The convention for the registration ID is as follows:

regid.YYYY-MM.ReversedDomainName,division

The registration ID consists of the following parts:

regid.—The string regid indicates that the XML portion is a registration ID for a software identification tag. A period (.) must be included after this string.
YYYY-MM.—This part of the registration ID identifies the first full month (MM) and the year (YYYY) in which the domain name was owned by the tag creator. For example, if you are creating the tag and you purchased the domain name February 15, 1999, you would use 1999-03 in this part of the registration ID, since the first full month the domain name was owned was March (03), and the year was 1999. The year and month must be separated by a dash.
ReversedDomainName—This part identifies the reversed domain name of the organization that is creating the software identification tag. For example, for the flexerasoftware.com domain name, the reversed domain name is:
com.flexerasoftware
,division—This optional part starts with a comma (,), and is followed by an additional string. You can enter a string that helps to distinguish between different divisions or areas of the organization. If you do not want to use this optional distinguishing part of the registration ID, do not include the comma or an additional string in your entry.

See Also