Product Section of Info.sxp

The Product section contains the following entries with information about the product:

ArchiveName=archive_name

mandatory

LongName=product_name

mandatory

Version=product_version

mandatory

Release=archive_version

mandatory

PreRelease=predecessor

mandatory

Systems=system_id

mandatory

SystemsDos=0

 

SystemsWin9x=0

 

SystemsWinNT=system_id

 

CreateDate=creation_date

optional

CreateBy=creator

optional

BootLevel=boot_level

optional

DeinstBootLevel=boot_level

optional

ResetLevel=reset_level

optional

OSVersion=operating_system_version

optional

AdminVersion=packager_version

optional

DataUnitSizeVector=dataunitsize_target

optional

VarCode

reserved for internal use

ArchiveName

Specifies the name of the package as it appears in the Packager's product archive (maximum 32 bytes).

LongName

Indicates the product name and description, maximum 47 characters.

Version

Indicates the product version (original manufacturer's product version; informal)

Release

Indicates the product package version (1000 - 9999); the version number specified when the product was packaged.

PreRelease

Indicates the previous product package version (0000 - 9998). If this entry is 0000, it refers to a "complete" product If the entry is between 1000 and 9998, it refers to an update for a previous version.

Systems

This is a legacy entry, which is used by older Installer versions only.

Specifies the operating systems on which the product can be installed.

Each operating system is assigned a unique decimal value as shown in the list following. The parameter value (system_id) assigned to Systems is derived from the sum of the values of the permitted operating systems. For example, the entry Systems=768 specifies that the product can be installed on target computers running Windows XP or Windows 2003 (256 + 512 = 768).

8

Windows NT

16

Windows 2000

2048

Windows Server 2000

256

Windows XP

4096

Windows XP x64

512

Windows Server 2003

8192

Windows Server 2003 x64

1024

Windows Vista

16384

Windows Vista x64

32768

Windows Server 2008

65536

Windows Server 2008 x64

SystemsDos

Not supported. This entry is always set to 0 by the Packager.

SystemsWin9x

Not supported. This entry is always set to 0 by the Packager.

SystemsWinNT

Specifies the operating systems with Platform ID 2 (NT) on which the product can be installed.

Each operating system is assigned a unique decimal value as shown in the list below. Additionally, the value 1 is used to indicate, that the product can also be installed on all successor operating systems with the same platform ID.

The parameter value (system_id) assigned to SystemsWinNT is derived from the sum of the values of the permitted operating systems. For example, the entry SystemsWinNT=5889 specifies that the product can be installed on target computers running the 64-bit operating systems Windows XP x64, Windows Server 2003 x64, Windows Vista x64, Windows Server 2008 x64, or any predecessor of these operating systems (256 + 512 + 1024 + 4096 + 1 = 5889).

1

"Future operating systems", this means, all successors with the same platform ID

4

Windows NT

8

Windows 2000

128

Windows Server 2000

16

Windows XP

256

Windows XP x64

32

Windows Server 2003

512

Windows Server 2003 x64

64

Windows Vista

1024

Windows Vista x64

2048

Windows Server 2008

4096

Windows Server 2008 x64

CreateDate

Specifies the date on which the product was created.

CreateBy

Specifies the name of the person who packaged the SXP product.

BootLevel and DeinstBootLevel

BootLevel specifies the behavior during installation of the SXP product (installation boot level).

DeinstBootLevel specifies the behavior during uninstallation of the SXP product (deinstallation boot level).

The installation boot level is set automatically by the reference installation, however, it can be modified manually. You can set boot levels for installation and deinstallation separately. If a deinstallation boot level is not specified, the value of the installation boot level is used.

The Installer can change the boot level to a higher value, if a logoff/logon or reboot is necessary to install the product.

The following table provides information about the boot level, the initiating entity, and the corresponding action:

Boot Level

Action

Comment

0

Target driven

If circumstances during installation or removal of the product on the target computer require a reboot (for example, when a file to be replaced is locked on the target computer), the Installer initiates this reboot.

Default, when the Packaging Computer has not been rebooted during the reference installation.

1

Logoff required

Requires a user to log off and on to activate changes to the Windows desktop and registry.

3

Restart after batch

Automatically initiates a system reboot at the end of the transaction.

Default, when the Packaging Computer has been rebooted during the reference installation.

4

Restart after job

Initiates a system reboot immediately after the end of the installation or removal of the product.

For boot levels 1 and 3 the following applies: In a transaction with several installation and uninstallation jobs, the uninstallation jobs are executed first. The highest deinstallation boot level that occurs is recorded and the necessary system boot is performed at the end of all uninstallation jobs. If no deinstallation boot level exists, the installation boot level is used. Then the same procedure is applied to all installation jobs (using the highest installation boot level).

The boot level 2 no longer applies with this Packager version. If an older package that contains the boot level 2 entry is being edited, the boot level is internally set to "1—Logoff required".

Packager Sets Boot Level:

By default the Packager sets boot level 0. However, if the setup program reboots or the Restart button was selected during reference installation, the Packager changes this value to boot level 3.

Installer Changes Boot Level:

When the Installer installs a product with boot level 0 and the files to be replaced are locked by an active process, the Installer automatically changes to boot level 3.

Manual Modification of Boot Level:

You can manually change the boot level by:

ResetLevel

Defines the action to perform if the installation of the SXP product fails.

If this parameter is assigned, it overwrites the reset level pre-configured for the Installer. Products that use the reset level must be generated with the automatic method of packaging.

By default, the reset level is not set and no ResetLevel entry exists in the Product section of the info.sxp archive file. In this case, the settings on the target computer define the reset behavior (target driven). If you want to overwrite this standard setting on the target computer, you must enter a reset level manually in the Product section of the info.sxp or use the info.sxp editor (double-click the info.sxp icon on the Packager main window) and set the reset level on the Product tab.

The following table lists the permitted reset levels:

Reset Level

Action

Comment

No entry in info.sxp

Target driven - recommended

The settings on the target computer define the reset behavior.

0

No rollback

No reset.

1

Limited rollback

Specifies a limited reset. The product is uninstalled, but previously existing files on the target computer that were deleted or modified by the installation are not restored.

Exception: Even if an installation fails and reset level 1 is invoked, an INI or ASCII file that was modified through an ininnnn.sxp or ascnnnn.sxp archive file is always reset to its original content.

The following changes are not canceled by reset level 1:

  • Files specified in files.sxp in the InsDelFiles section remain deleted.
  • If an installation fails in some way and a reset is invoked, the files specified in the FilesInArchives section of the files.sxp archive file are not restored, if these files previously existed on the target computer from an earlier version. Examples include DLL files in the system directory.

Consequently, some files of the new version of the product remain on the target computer.

2

Complete rollback

Specifies a complete reset. Reset level 2 is more extensive than reset level 1. Previously existing files on the target computer that were deleted by the installation are restored.

OSVersion

Specifies the operating system under which the product was packaged.

AdminVersion

Specifies the Packager version used to package the product.

DataUnitSizeVector

Specifies the data unit size (32-bit and/or 64-bit) that the operating environment on the target computer must have. An SXP package is only delivered and installed on a target computer when the data unit size of the target computer is specified through DataUnitSizeVector.

An SXP product packaged in a 64-bit operating environment can only be installed on target computers running a 64-bit operating environment, even if a 32-bit operating environment has been specified as target operating system in info.sxp.

dataunitsize_target can have the following decimal values:

32 (for 32-bit data unit size only)

64 (for 64-bit data unit size only)

96 (for both 32-bit and 64-bit data unit sizes)

Default: 96

To ensure backward compatibility, the Installer installs all SXP packages that do not have the DataUnitSizeVector entry.