manualshive.com logo in svg

Symantec WINDOWS INSTALLER EDITOR 7.0 SP2, Installation Manual

The Symantec Windows Installer Editor 7.0 SP2 is a powerful tool that allows users to efficiently create and edit installation packages for software deployment on Windows systems. This comprehensive Installation Manual is available for free download from our website, providing step-by-step instructions and guidance for seamless installations.

Share
Download
background image

Windows Installer Editor Reference

585

 

compiling to language 

transform 290

of progress text 567, 569
of user interface 287
strings, See text strings

translator, ODBC

adding 182
details 184

tutorial

Refer to Getting Started Guide

typical installation 203

U

UAC

See User Account Control (UAC)

UNC paths 361
undo

check out 353
Installation Expert page 21

uninstall

avoiding 332
leaving components installed 142
Palm OS application 249
patch 345
running action during 506
setting options 109
Windows Mobile application 246
WiseScript 501

Universal Access Protection

See User Account Control (UAC)

unmanaged code 549
update

based on wildcards 54

Update Clean Build 229, 230
upgrade

about 345
adding to installation 346
aligning component GUIDs 59
archiving previous 331
avoiding uninstall 332
configuring 346
description 331
errors, avoiding 333
further reading 330
general steps 330
guidelines 346
patch or upgrade 331
patch, creating 337
preparing for 333
product code, changing 332
product version, changing 332
specifying for patch 341
specifying version for 340
when to patch 331
when to reinstall 331

UpgradeCode 346, 565
Upgrades page 345
UpgradeSync 333
User Account Control (UAC)

about 200
disabling 79, 198
enabling 198
preventing in WiseScript custom 

action 503

user context 495
user data files

excluding 220

user defined path variable 357
User Information dialog box 451
User Interface 492, 495
user name, obtain 475
user-defined task 28
UserSID 509

V

validation

Also see Package Validation
error 405
errors in tables 435
issue in Task List 26
of installation 404
terminal server compatibility 408
test descriptions 407

Validation directory 33, 51
validation module

about 406
customizing 406
predefined 407
selecting 405
selecting rules 406

validation rule

selecting 406

value source, for parameter 516
variable parameters 517, 517
VBImport event macro 485
VBP file 395, 396
VBPROJ file 395
VBR file 161
VBScript

calling from embedded code 521
calling from installation 521
calling from installed file 522
calling from property 523
debugging 489
guidelines for calling 507

vendor redistributables, download 35
version

changing 103
incrementing on compile 105
of product 103
upgrading 332
when to update 107
Windows Installer 109

Version9X property 120
VersionNT property 120, 439
ViewLog 556

views 18
Virtual Directories page

See Web Files page

virtual directory

changing to Web site 273
child 271
choosing dialog boxes 274, 275
creating 270
details 276
editing web.config 153
how options are set 271
IIS 7.0 support 271
installation options 274, 275
removing on uninstall 271
top-level 271

virtual layer

deleting installation 101
running installation in 99

virtualization options 39
Vista standard user installation

about 79
creating 80

Visual Basic

editor 485
importing 396
project types 395, 396
tips for import 395
using in macro 483

Visual MSIDiff

key to icons 94, 355
using 93
with source control 354, 355

Visual SourceSafe 350
Visual Studio integrated editor

about 19

Visual Studio project

about 68
importing 396

Visual Studio Solution page

about 157
adding files 159
adding output group 159
Also see Files page
controlling dependencies 159
icons 161
when to use 127

Visual Studio, integration with 19
VJSPROJ file 395
volume combobox control 462
volume cost listbox control 462
VXD file 179

W

WBS file 482
Web dialog boxes

adding 274, 275
changing order 456
do not edit 274, 275, 456
regenerating 274, 275, 456

Summary of Contents for WINDOWS INSTALLER EDITOR 7.0 SP2

Page 1: ...Windows Installer Editor Reference ...

Page 2: ...D WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE DISCLAIMED EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING PERFORMANCE OR USE OF THIS DOCUMENTATION THE INFORMATION CONTAINED IN THIS DOCUM...

Page 3: ...n a regional business hours or 24 hours a day 7 days a week basis z Premium service offerings that include Account Management Services For information about Symantec s support offerings you can visit our web site at the following URL www symantec com business support All support services will be delivered in accordance with your support agreement and the then current enterprise technical support p...

Page 4: ...t information about product updates and upgrades z Information about upgrade assurance and maintenance contracts z Information about the Symantec Buying Programs z Advice about Symantec s technical support options z Nontechnical presales questions z Issues that are related to CD ROMs or manuals Support agreement resources If you want to contact Symantec regarding an existing support agreement plea...

Page 5: ...threats Consulting Services Symantec Consulting Services provide on site technical expertise from Symantec and its trusted partners Symantec Consulting Services offer a variety of prepackaged and customizable options that include assessment design implementation monitoring and management capabilities Each is focused on establishing and maintaining the integrity and availability of your IT resource...

Page 6: ...Reports 33 Downloading Redistributable Files 34 Downloading Redistributables From the Wise Web Site 34 Downloading Redistributables From Other Vendors Web Sites 35 Product Documentation 36 Chapter 2 Setting Up 37 How you can set up Windows Installer Editor 37 Setting Options 37 Setting General Options 38 Setting NET Assembly Options 40 Setting Advertising Options 41 Setting Digital Signature Optio...

Page 7: ... Standard Users 80 Creating an Installation Within a Solution 80 Creating a Stand alone Installation 82 Creating a Device Driver Installation 83 Options for New Installations 84 Entering Project Settings 85 Overview Page 86 Project Type Page 86 Projects Page 87 Main Project Page 88 Pre build Event 89 Post build Event 89 Project Outputs Page 89 How the Installation Integrates With the Solution 90 S...

Page 8: ...lusion List 139 Editing Settings for Automatic Updating 140 Removing a File From the Destination Computer 142 Copying and Moving Files on the Destination Computer 143 Editing File Details 145 Editing General File Details 146 Setting Permissions for Files and Directories 147 Editing Self Registration Settings for Files 148 Editing Assembly Settings for Files 149 Creating a Win32 Assembly 150 Viewin...

Page 9: ...ersion Specific Windows Installer Options 198 About UAC Elevation of Windows Installer Installations 200 About UAC Elevation of an Entire Installation 202 Setting Features for Installation Types 203 Chapter 7 Organizing Your Installation Into Releases 206 About Releases 206 Creating a New Release 207 Associating a Release With Visual Studio Build Configurations 209 Outputting a Multiple Language R...

Page 10: ...in an Installation 257 Applying Transforms to an Installation 258 Applying or Removing Patches With a Command Line 259 Command Line Options For WFWI EXE 259 WFWI EXE Command Line Option Example 261 Automating the Build Process 261 Adding a Digital Signature to an Installation 262 Creating an Installation for Microsoft SMS 263 Creating a NET Installation When You Have the NET Framework 264 Creating...

Page 11: ...s Dialog 308 Keeping Track of Changed Text Strings 309 What Pre Translated Languages Are Available 309 Language IDs 310 Chapter 10 Distributing an Installation 313 Package Distribution 313 Copying an Installation to the Share Point Directory 313 Copying an Installation to a Network Directory 315 Copying an Installation to an FTP Server 316 Performing an Administrative Installation 317 Copying an I...

Page 12: ...d Path Variable 357 Creating a Path Variable Based on an Environment Variable 357 Creating a Path Variable Based on a Registry Value 358 Source Paths in an Installation 359 Changing Source Directories 360 Converting to Relative Source File Paths 361 Converting to UNC Based Source File Paths 361 Changing the Source Directory Dynamically During Compile 362 Chapter 13 Merge Modules and Transforms 364...

Page 13: ...a Package 404 Customizing Validation Modules 406 Predefined Validation Modules 407 Windows Vista Windows 7 Validation 409 Removing Files With Missing or Invalid Source Paths 409 Wise Task Manager 410 Using Wise Task Manager 411 Chapter 15 Setup Editor 413 About Setup Editor 413 Product Tab 415 Specifying Summary Information 416 Features Tab 417 Assigning a Component to a Feature 418 Modules Icon 4...

Page 14: ... of Web Dialogs 456 Using the Dialogs Tab 456 Adding Controls to Dialogs 458 Editing Dialog Details 458 Creating a New Dialog 460 About Dialog Controls 461 Types of Dialog Controls 461 Editing Dialog Controls 463 Basic Control Settings 463 Setting an Event on a Control 466 Assigning Help to a Control 467 Assigning Conditions to a Control 467 Setting the Graphic for a Control 468 Setting the Items ...

Page 15: ...g Out Script Lines 498 Calling WiseScripts with Custom Actions 498 Examples of WiseScripts You Run From an MSI 499 Using a WiseScript to Parse a Path 499 Using a WiseScript to Install a License File 500 Uninstalling Changes Made by a WiseScript 501 Troubleshooting When WiseScript Custom Actions Fail on Windows Vista or later 503 Guidelines for Using Custom Actions 504 Guidelines for Custom Action ...

Page 16: ...34 Run WiseScript From Installation 535 Run WiseScript From Installed Files 536 Set Directory 537 Set Feature State 538 Set Property 538 Terminate Installation 539 Using the Custom Action Location Tab 539 Using the Custom Action Location Tab for Merge Modules 540 Using the Custom Action Properties Tab 542 Using the Custom Action Description Tab 544 Chapter 22 Windows Installer and NET Technologies...

Page 17: ...ws Installer Editor you can z Create installations that are compliant with the Microsoft Windows 2000 XP and Vista logo program z Edit and refine installations that you have converted from other formats z Import development projects Through its Visual Studio integrated editor Windows Installer Editor offers a complete seamless integration of the entire installation authoring environment directly i...

Page 18: ...ium platforms This sets the initial target platform for the Default release e If the application has been written to be installed and run by standard users without elevation mark Create a Vista Standard User Installation This clears the Enable User Account Control UAC check box in Installation Expert Windows Installer Options page See Creating an Installation for Standard Users on page 80 f Click ...

Page 19: ...tween the Wise editor and the Visual Studio integrated editor that are inherent in the Visual Studio development environment Examples z In the Visual Studio integrated editor you have different choices about how to start a new project and you can set source paths to update automatically according to the Visual Studio build configuration MSI Script MSI Script provides a powerful yet easy to use env...

Page 20: ...le in Windows Explorer you are prompted to select which editor to open the file in You can set an option on this dialog box to always open that file in a specific editor If you create an installation project in the Visual Studio integrated editor and then uninstall Microsoft Visual Studio you can continue working on the installation project in the Wise editor However if you right click a WSI or MS...

Page 21: ...ets you define a specific aspect of the installation Examples On the Files page you define what files are included in the installation On the Registry page you define what registry keys and values are created on the destination computer Complete only the pages that are pertinent to your particular installation in any order If required information is missing an error message appears during compile ...

Page 22: ...ically in the Page Views drop down list with the exception of the All page view which is always first The list also includes New View and Customize Page Views which are at the end of the list and are used to create or customize page views Predefined Templates and Page Views Most predefined installation templates have an associated page view When you create a new installation by using one of these ...

Page 23: ...age view See Setting Installation Expert Options on page 47 z The All page view is used when you open an installation file that does not have an associated page view An MSI does not have an associated page view See also Using Installation Expert on page 20 Customizing Page Views You can create customized Installation Expert page views that display only the page groups and pages that you use most o...

Page 24: ...ge view 1 From the Page Views drop down list in Installation Expert select Customize Page Views The Customize Page Views dialog box appears 2 Select the page view from Page View Name and do any of the following To add a new page group click the Page Groups Add button and enter a name To rename a page group select the page group and click Rename To add a page to a page group select the page group a...

Page 25: ... at once Example On the Files page this option displays all folders and files for all features Add and New buttons are unavailable while all features are displayed you must select a single feature to add items On some pages Current Feature also contains numbers in parentheses which represents the number of that page s items files or registry keys that are assigned to each feature or condition See ...

Page 26: ...k List z Package Validation When you run Package Validation validation issues appear on the View Correct dialog box If you mark the Add to Task List check box on the View Correct dialog box each issue becomes a task in the Task List when you click Finish If Package Validation encounters save or compile errors the package validation process ends and the errors are added to the Task List See Package...

Page 27: ...sual Studio Task List and select Show Tasks Save Compile In Visual Studio this is called Build Errors Tasks that correspond to errors that are generated when you save or compile Validation Tasks that correspond to issues that are generated during Package Validation Component Tasks that correspond to component errors that are generated when you check tables See Using the Task List on page 26 Table ...

Page 28: ...use unexpected undesirable behavior including damage to the installation We cannot provide technical support for problems arising from table editing To find table errors from the Task List If the task has a table listed in the Table column double click the task The table is displayed in Setup Editor Tables tab and the row in the table associated with the task is highlighted In Visual Studio a tabl...

Page 29: ...ting Packages in the Software Manager Help z Understand how the application will behave in the production environment so you can identify and resolve potential conflicts during the application s development Check each file and registry key you add to an installation for possible conflicts with those in other applications Example A developer who adds or updates a DLL to an installation can instantl...

Page 30: ...s developers can create installations that adhere to corporate standards It also reduces rework of internally developed installations by the development team and reduces end user downtime because the developers who create installations can be sure to use the correct versions of files and other resources before giving installations to the IT deployment team See also About the Share Point Directory ...

Page 31: ...hat are shared by the current installation and other packages in the Software Manager database z Shared Files Report Lists the files that are shared by the current installation and packages in the Software Manager database For each file the report lists each application that uses the file and shows detailed file information examples version date time path and so on z Shared Registry Report Lists t...

Page 32: ...directory instead Several of these directories are available only on the share point and only if you have a repository connection The share point directory also contains subdirectories that are specific to the Wise Package Studio Workbench You can specify alternate locations for storing resources See Setting Repository Options on page 50 Directory Contents Custom Actions Files that you create to u...

Page 33: ...ion Templates Dialogs The Wise Standard MSI that provides information that is used by the New Dialog Wizard to add a new dialog box to an installation Templates File Templates that are used to create a new installation If you have a repository connection you must create this subdirectory under the share point directory It is not created when the share point is created See Creating and Editing Inst...

Page 34: ...t of a merge module Download redistributable files from the following locations If you need to go through a firewall or proxy server to get to the Internet the Download Redistributables wizard uses your browser s proxy settings To change your Internet connection settings refer to your browser s documentation Downloading Redistributables From the Wise Web Site You must be in an active Wise installa...

Page 35: ...ctories See also Downloading Redistributable Files on page 34 Downloading Redistributables From Other Vendors Web Sites You must be in an active Wise installation to follow this procedure We have no control over other vendor s redistributable files Check with the vendor for product support To download redistributables from other vendors Web sites 1 Select Help menu Download Redistributables In Vis...

Page 36: ...nu Reference Manual Getting Started Guide The Getting Started Guide contains system requirements installation instructions and a tutorial You can access a PDF version of the Getting Started Guide from the Windows Start menu Windows Installer SDK Help You can get technical details about Windows Installer from its own help system which is written by Microsoft for a developer audience In Wise for Win...

Page 37: ...it the predefined rule sets or create new rule sets If the predefined rule sets do not meed your needs you can duplicate them and modify the copies as needed or you can create new rule sets See Component Rules on page 57 z You can connect to a Wise Software Repository that has been configured for an installation of Wise Package Studio See Connecting to a Wise Software Repository on page 65 Setting...

Page 38: ...re working on is backed up Example if you open a WSI and save it the corresponding MSI is not backed up Use caution with this option if you are working with large installation files if you save often your disk space will quickly become depleted z Add default remarks to installation sequences Although most Wise project WSI files have remarks that explain the actions in the sequences compiled MSIs d...

Page 39: ...rrors and let the merge module row overwrite the row in the main installation z Enable Quick Compile Mark this to speed the compile process by compressing only previously uncompressed or changed files Quick Compile writes the MSI table information If a file or media has changed a full compile will occur instead Quick Compile is for project files only You can also speed compile time by using Expres...

Page 40: ...blies tab are unavailable install the NET Framework and run a manual repair of the Windows Installer Editor MSI from Add Remove Programs Not applicable in the Visual Studio integrated editor COM Interop Options z Default Application Type This determines the default setting for the Application Type field on the Product Details page for new installations Changing this field does not affect existing ...

Page 41: ...an assembly dependencies on compile Mark this to scan for new assembly dependencies each time you compile z Rescan assembly attributes on compile Mark this to rescan and update assembly attributes each time you compile This check box is marked by default Note On NET Framework versions earlier than 1 1 the scan does not occur when you add an assembly from a UNC or mapped network drive example the s...

Page 42: ...not scan advertising information Use self registration for components that support it Windows Installer Editor will not scan files or the registry Scan advertising information into registry keys Add advertising information to the installation as registry keys only do not create entries in advertising tables This results in an installation that does not support advertising through COM Scan advertis...

Page 43: ...igital signature to an installation on the Digital Signature page You also can add a digital signature to a patch in Patch Creation The Digital Signature options provide default settings for the Digital Signature page and Patch Creation These options apply to all future installation and patch files They do not affect existing files Note Visual Studio integrated editor To display context sensitive ...

Page 44: ...ur own computer to provide processing power for another build computer ExpressBuild speeds compile time by distributing the time consuming task of compressing CAB files among multiple processors Therefore the greatest time savings are realized when you have multiple CAB files Specify CAB file creation rules in Installation Expert Media page See Setting ExpressBuild Options How ExpressBuild Groups ...

Page 45: ...elp process compiles that are started on another build computer Performance degrades while this computer helps to process compiles This causes WiseExpressBuild exe to start immediately Build Group Name Enter the group name of the build group that your computer will be a member of If another computer compiles using your build group name then your processor will be used to help compile See also Abou...

Page 46: ...n If you select any size other than zero in the Max Media Size field on the Media page If you are in a merge module z Because each processor compresses CAB files using multiple processors is more efficient if files are arranged into multiple moderately sized CAB files To achieve this select One Cab per feature or One Cab per component in the Cab Options field on the Media page Additional requireme...

Page 47: ...elected in the Current Feature drop down list Example If you create a directory for FeatureA and then use the Current Feature drop down list to go to FeatureB you no longer see the directory you made for FeatureA This does not apply to the Web Files page z View registry keys for all features on Registry page Mark this to display all registry keys on the Registry page regardless of what feature the...

Page 48: ...toring merge modules You can store merge modules on a local drive or a shared network drive When you add a merge module to an installation you can select from the merge modules in the directories you specify here When you use the Download Redistributables wizard you can download merge modules to directories you specify here Requires a repository connection You can use merge modules that are in the...

Page 49: ...ctories in the search mark the check box in the Include Subdirs column The next time you click the Add button on the Merge Modules page modules in that directory appear on the Select Merge Module dialog box To delete a directory from the list click the directory and click Delete Merge modules in that directory will no longer appear on the Select Merge Module dialog box See also Setting Options on ...

Page 50: ...rs double click one of the following items and browse to a new path You can use the variable WiseSharePoint to represent the share point directory in the following paths You also can use the predefined variables that appear on the Path Variables page However you cannot use other user defined path variables because they are specific to a single installation and the following paths are global option...

Page 51: ...emplates from the share point directory It must use templates on the local computer Themes Specify the location of the themes that are used to customize installation dialog boxes Validation Modules Specify the location of the validation modules CUB files and settings that are used in Package Validation See also Connecting to a Wise Software Repository on page 65 Setting Merge Module Directories on...

Page 52: ... when it is closed If this is marked then each time you open a file that has been previously checked out the file will be automatically checked in for you z Add new files to source control If this is marked then each time you create a new installation file and save it you will be prompted to add it to your source code control system Enabling the source control options above does not implement sour...

Page 53: ... option the prompt appears during save build or compile when there are new files Also if you previously excluded files by clearing their check boxes you ll be prompted to confirm that those files should be excluded Always scan solution Each time Windows Installer Editor scans a solution it adds new files to the installation and deletes files that have been removed from the solution z Bind installe...

Page 54: ...lick the Wildcard Groups tab In Visual Studio Tools menu Options Wise Options Wildcard Groups 2 On the Wildcard Groups tab click Add The Wildcard Group Details dialog box appears 3 Complete the dialog box and click OK Group Name Enter a name to precede the wildcards in the Include Wildcards list This is a visual identifier to help you quickly find the wildcards in the list Wildcards Enter semi col...

Page 55: ...Editor Templates are organized by integrated project and stand alone files z Templates Project contains templates for new projects that are integrated with a solution z Templates File contains templates for stand alone files The Visual Studio integrated editor cannot use templates from the share point directory even if you have a repository connection It must use templates on the local computer To...

Page 56: ...he Visual Studio integrated editor 1 If a solution is open in Visual Studio close it 2 Select File menu New File The New File dialog box appears 3 From the Categories list select Wise Files 4 In the Templates list select an icon on which to base the new template Some icons are not templates but instead invoke an import process or prompt to create a new transform To create a template in WSI or WSM ...

Page 57: ...llation you select a component rule set to manage components you add to that installation Then whenever you add a resource such as a file registry key shortcut or anything else that can be installed components are created for those resources in accordance with the rule set you selected Example You can always create a new component for each new file added to the installation or you can group relate...

Page 58: ...s applied and no subsequent rules are evaluated for that resource If you add a resource that does not meet any of the conditions in the rule set then the Microsoft Best Practices rule set is used for that resource See also Component Rules on page 57 Microsoft Best Practices Component Rule Set on page 63 Selecting a Component Rule Set Use the Component Rule Selection dialog box to select a rule set...

Page 59: ... for components that are based on file resources You can use the long file name of the keypath file the short file name of the keypath file or the naming convention specified in the Default field above 6 To make the options in the Component Key Values section the defaults for all future installations mark Make this the default key naming convention for all installations 7 Click OK on the Component...

Page 60: ...ld be the first rule in the rule set For best results use the same rule set if any that was used in the previous versions That way component creation in the upgrade will be consistent with the previous versions 4 Select Component Rules menu Previous Versions In Visual Studio Project menu Component Rules Previous Versions The Previous Installation Versions dialog box appears 5 On the Previous Insta...

Page 61: ...he conditions and actions that comprise the rule See Adding and Editing Component Rules on page 62 6 When you finish adding rules to the rule set click OK on the Customize Component Rules dialog box and then click OK on the Component Rules Manager dialog box The new rule set is added to the list of available rule sets To use the new rule set for the current installation or to make it the default f...

Page 62: ...tudio Project menu Component Rules Customize The Component Rules Manager dialog box appears listing the predefined rule sets and any custom rule sets you have created 2 Click a rule set and click Modify The Customize Component Rules dialog box appears To add a rule click Add This starts the Component Rule Wizard which lets you define component rules For details see the procedure below To edit a ru...

Page 63: ... action you selected is removed from the list 6 If an action contains underlined text click the underlined text to open a Rule Details dialog box There you can specify a value for the underlined text Example If you selected the action Set component key to Component you would click the word Component and enter specific text 7 When you have added all actions to the rule click Finish on the Actions p...

Page 64: ... component matching the conditions and set the component key base to CurrentUser The component key base will be incremented for each new component matching this condition Example CurrentUser1 CurrentUser2 and so on z Put non Current User registry keys in their own component If the added resource is a registry key NOT under HKEY_CURRENT_USER add the resource to an existing component that contains t...

Page 65: ...ach new component matching this condition Example CurrentUser1 CurrentUser2 and so on z Put non Current user registry keys in their own component If the added resource is a registry key NOT under HKEY_CURRENT_USER add the resource to an existing component that contains the same type of resource z Name new non advertised shortcuts by destination directory If the added resource is a shortcut add it ...

Page 66: ... z Wise Package Studio 8 0 or later z Future releases of Wise Installation Studio might require an upgrade of Wise Package Studio and the repository To connect Windows Installer Editor to a Wise Software Repository 1 Select Start Programs Symantec Wise Installation Studio Repository Client Manager The Repository Client Manager dialog box appears 2 In Share Point specify the share point directory t...

Page 67: ...interruptions during installation development gather the following information before you begin creating an installation in Windows Installer Editor z All the files to install on the destination computer This includes program files files necessary for optional features related DLLs drivers and other support files Visual Studio integrated editor only Some of these files examples DLLs OCXs and EXEs ...

Page 68: ...r Editor However options that have to do with creating an MSI such as those on the Releases Release Settings and Media pages are unavailable You can convert an MSI to a project file WSI See MSI to WSI Conversion on page 399 WSI Windows Installer project file which describes an MSI but does not store contents It is in the same format as an MSI You edit a WSI in Windows Installer Editor and compile ...

Page 69: ...you create an installation you can work in a WSI project file or an MSI file The same applies to merge modules you can work in a WSM project file or an MSM file Note Do not confuse the Wise installation project file WSI with the Visual Studio project file WSPROJ MSP Windows Installer patch which updates an existing installed application Patches contain only the differences between the old and new ...

Page 70: ...mpile they are compiled into the resulting MSI or EXE Inside the database file Files are refreshed from disk unless Don t update or recompress files when saving is marked on the Product Details page Can you create releases Yes Use the Releases page and other Release Definition pages No Because you are already working in the final output file options for multiple output files are unavailable which ...

Page 71: ...llation File dialog box Viewing the Template Summary Property This setting is visible under Setup Editor Product tab Summary Do not change the target platform setting there When an installation project WSI contains multiple releases that compile to 32 bit and 64 bit MSIs the Template Summary property reflects one platform or the other The correct Template Summary property is set in each MSI during...

Page 72: ...dition Builder Condition Builder contains additional property values z VersionNT64 which is set when the installation runs on a 64 bit platform z Intel64 which is set when the installation runs on an Itanium platform z Msix64 which is set when the installation runs on an x64 platform Files Page Visual Studio Solutions Page Additional predefined directories appear in the lower left list box Program...

Page 73: ...form 32 bit x64 or 64 bit Itanium as the installation In a mixed target project file WSI condition each Call Custom DLL custom action for the appropriate platform 32 bit Applications on 64 bit Computers WOW64 Windows On Windows 64 is an emulator that lets 32 bit applications run on 64 bit versions of Windows To prevent file and registry collisions it isolates 32 bit applications from 64 bit applic...

Page 74: ...tallation File dialog box select one of the 64 bit options as the target platform This sets the initial target platform for the Default release z Select the appropriate 64 bit target platform for all features z Add resources to the installation as usual When you add 64 bit EXE and DLL files or 64 bit registry keys they are designated as 64 bit components The 64 bit component check box is marked on...

Page 75: ...on z A 64 bit merge module can be merged into a 64 bit installation The processor type x64 or Intel64 of the merge module must match that of the installation See also How to Specify the Target Platform on page 71 Using 64 bit Merge Modules in the Windows Installer SDK Help Creating Multiple Platform Specific Installations from One Project File You can create a single installation project WSI that ...

Page 76: ...t the appropriate feature Example Add Chart32 exe to the Charting32 feature and add Chart64 exe to the Charting64 feature 4 In MSI Script add a custom action to set the value of the INSTALLDIR property See Defining the INSTALLDIR Property in a Mixed Platform Installation on page 78 5 On the Releases page create a release for each target platform Example Graphic32 Graphic64 6 On the Release Setting...

Page 77: ...xe to the Charting feature 3 In MSI Script add a custom action to set the value of the INSTALLDIR property See Defining the INSTALLDIR Property in a Mixed Platform Installation on page 78 4 On the Releases page create a release for each target platform Example Graphic32 Graphic64 5 On the Release Settings page select the components to include in each release Example 6 Compiling the project creates...

Page 78: ...add a custom action to set the default value of INSTALLDIR based on the destination computer s platform Place the custom action at the beginning of the installation initialization You only need a custom action for the undefined installation directory Example The installation directory is Program Files x86 QuickFacts In MSI Script enter the following custom action If VersionNT64 then Set Property I...

Page 79: ...eed Not only do you choose whether to create a project associated with a solution but you also choose what kind of file to create Typically you will create an installation in one of these ways z As a project integrated with a Visual Studio solution Do this to create an installation for an application you have developed in Visual Studio See Creating an Installation Within a Solution on page 80 z As...

Page 80: ...n page 200 Creating an Installation for Standard Users Windows Installer 4 0 or later only A standard user installation is one in which the UAC is disabled so that standard users can install it without elevation The installation cannot contain actions that access a protected area on the destination computer See About Standard User Installations on page 79 To create a standard user installation 1 D...

Page 81: ...The data will be included in the compiled MSI and will appear on the Projects page the next time you compile the installation project To create an installation within a solution 1 Start Visual Studio and open a solution 2 Select File menu New Project The New Project dialog box appears 3 In the Project Types list select Wise Setup and Deployment Projects 4 In the Templates list do one of the follow...

Page 82: ... Within a Solution on page 80 You also can create other types of installations See Options for New Installations on page 84 To create a stand alone installation 1 Start Visual Studio If a solution is open close it 2 Select File menu New File The New File dialog box appears 3 In the Categories list select Wise Files 4 In the Templates list click one of the following icons Windows Application File C...

Page 83: ...ou have not already done so See Downloading Redistributable Files on page 34 Note Early versions of this merge module might be named Binaries 2 Make sure the device driver you are installing meets the Microsoft DIFx driver requirements 3 Do one of the following Start a new installation and select the Device Driver icon on the New Installation File dialog box See Starting a New Installation on page...

Page 84: ... Templates on page 54 This section describes the options that are available Setup Wizard Visual Studio integrated editor only Runs a wizard that creates a Windows Application Web Application Server Application or Merge Module installation With this wizard you can customize the settings rather than accepting the defaults of the standard templates See Creating an Installation Within a Solution on pa...

Page 85: ...stallation See Creating a Transform Based on an Existing MSI on page 385 Merge Module See Creating a Merge Module As a New Installation on page 369 In Visual Studio see Creating a Merge Module Within a Solution on page 371 or Creating a Merge Module As a New Installation on page 369 Import Tools The following tools open an import wizard where you select a development project file to import Target ...

Page 86: ...ge on page 86 Project Type Page on page 86 Projects Page on page 87 Main Project Page on page 88 Pre build Event on page 89 Post build Event on page 89 Project Outputs Page on page 89 Overview Page Visual Studio integrated editor only The Overview page summarizes the project settings for the project you are creating Review the settings to make sure they are correct To change these settings click t...

Page 87: ...ution and selecting Properties z Select the projects to include in this package From this list of all projects in the current solution select the ones to add to this installation All projects are selected by default Output files of the selected projects are added to this installation If you add a project to this solution later it will be added to the project list and selected for inclusion To excl...

Page 88: ... Main Project Page Visual Studio integrated editor only On the Main Project page you specify the main project and set options that affect the main project Access this page either from the Wise Setup Wizard when you create a new installation or by right clicking a project in a solution and selecting Properties z Main Project Select the project that generates the main target or executable file for y...

Page 89: ...ild event You can add as many command lines as needed Project Outputs Page Visual Studio integrated editor only By default the installation includes only the main output file EXE or DLL from each project in the solution and the content files from each project On the Project Outputs page you select which projects to include in the installation and specify additional project output files to include ...

Page 90: ... content and is a dependent of another project it is not added to the installation by default To add other outputs to the installation select the appropriate output group on the Project Outputs page in the project settings or add them on the Visual Studio Solution page Windows Installer Editor can scan for files you add or delete after you create the installation project and can add them to or del...

Page 91: ...stallation s project settings Examples output types projects to include How and when the solution is scanned is determined by the Scan Method option The default is set in Wise Options and can be changed for specific installations on the Projects page in the project settings See Setting Visual Studio Options on page 52 and Projects Page on page 87 z If you add an existing WSI to a solution the WSI ...

Page 92: ...ew files into the installation See also How the Installation Integrates With the Solution on page 90 Opening an Installation Package Requires a repository connection Not available in the Visual Studio integrated editor The Open dialog box might contain the following tabs that let you open different items z File System tab Opens a package from a directory on your computer z Repository tab Opens a p...

Page 93: ... Source dialog box appears This is a standard Windows ODBC connection wizard which lets you connect to a database through an ODBC data source 3 Specify criteria for filtering the packages that are displayed above Groups This lists the groups defined in Software Manager Status This lists the possible package statuses Package Type This lists the available package types 4 Select a package in the list...

Page 94: ...egrated editor Compare Transform to Base MSI Transform files only Automatically compares the MST to its base MSI You are taken to Setup Editor Tables tab and the Visual MSIDiff Key dialog box appears which describes icons that indicate changes Changes are shown in the tables and rows where they occur 3 On the Visual MSIDiff Key dialog box take note of the symbols and colors that indicate changes a...

Page 95: ...eneral 2 Mark the Create XML copy during save check box This global option causes an XML copy to be created every time you save an installation file The copy has the same name as the installation file with the extension XML appended and it is saved in the same directory Example If the current file name is Application wsi the XML copy is named Application wsi xml To export an XML file as needed Use...

Page 96: ...ge it Before you save the installation you change its package name on the Product Details page When you save the installation a new package with the same application name and its meta data are added to the database Duplicate package in Software Manager Database dialog box If you open an installation file that is a copy of a package in the Software Manager database and you don t change the applicat...

Page 97: ...e following methods to speed the compile process z Mark the Enable Quick Compile check box in Wise Options Quick Compile compresses only previously uncompressed or changed files If a file or media entry has changed a full compile occurs instead See Setting General Options on page 38 z Use ExpressBuild a multi processor compile feature See About ExpressBuild on page 44 To compile an installation in...

Page 98: ... Help menu Download Redistributables In Visual Studio Help menu Wise Help Download Redistributables See also Testing An Installation on page 99 Running An Installation on page 99 Running the Debugger on page 488 Testing and Running An Installation To test an installation you can z Test the installation which appears to run but does not install files or change the system See Testing An Installation...

Page 99: ...allation Reopen it and compile it and then run it again Testing a transform or merge module You cannot test a transform or a merge module by itself It can only be run in conjunction with an MSI To run a transform or merge module run the base MSI from the command line with the appropriate command line options which are documented in the Windows Installer SDK Help See also Compiling An Installation ...

Page 100: ...ommand lines to the Command Line page they also appear To avoid having to select from the button menu press Ctrl R to run with no command line 3 If you are working in a WSI that contains multiple releases you are prompted to select one The installation is compiled and run Note If you change the installation and then run it but the change is not apparent close the installation Reopen it and compile...

Page 101: ... virtual layer is WiseTemp_ProductName where ProductName is the value of the ProductName property See About the Altiris SVS Applet in the Virtual Package Editor Help Running a transform or merge module You cannot run a transform or a merge module by itself It can only be run in conjunction with an MSI To run a transform or merge module run the base MSI from the command line with the appropriate co...

Page 102: ...e how many files have been added to the Files page and so on z Links to the Package Contents reports z Installation package meta data read only You can edit the meta data See Product Details Page on page 102 A check box in Wise Options determines whether the Project Summary page appears when an installation is opened Product Details Page Use the Product Details page to enter edit or view an instal...

Page 103: ...duct Name meta data field This field appears in an MSI or WSI only z Package Requires a repository connection Enter a unique name to identify this package in the Software Manager database Typically you use the Application name plus specific version information Example If the Application name is Product the Package name might be Product 5 05 This field appears in an MSI or WSI only z Product Type R...

Page 104: ... is pre filled z Package Path Read only This displays the installation file s location z Repository ID Requires a repository connection Read only This displays the package s unique identifier in the Wise Software Repository which Windows Installer Editor generates in the form of a GUID This ID is generated when you save or compile an installation after entering the application and package names It...

Page 105: ... It does not change the installation Windows based desktop server PC Mark this if the installation does not install a Web service to an IIS server This is the default except for Web and server applications Windows based IIS Web server Mark this if the installation installs a Web application to an IIS server This is the default for Web and server applications z Description Describe the package If y...

Page 106: ...eta data is added to the Software Manager database and the Repository ID field is populated What happens when you add meta data to the Software Manager database z The meta data appears in Software Manager on the Package pane and the Package Attributes dialog box This only adds the package s meta data to the Software Manager database It does not import the package s resources z The package is assig...

Page 107: ...roperty Pages dialog box See Main Project Page on page 88 When should you increment the version field z When you add or delete files from the installation z When you create remove or edit any other items besides files Examples services ODBC runtimes registry and so on z If you plan to create a patch that updates earlier versions to this version z When you include upgrade entries on the Upgrades pa...

Page 108: ...directory 4 Mark Change Feature configurable directories to have any features that explicitly reference the default directory change when you select a new default directory To see if a feature explicitly references a directory double click the feature name on the Features page If the Directory field does not contain none then the feature explicitly references a directory 5 Click OK General Informa...

Page 109: ...rams Page Windows operating systems have an Add Remove Programs or Programs and Features applet that let end users uninstall change or repair programs Use the Add Remove Programs page to enter the information necessary to support these capabilities Select Installation Expert Add Remove Programs and complete the page z Do not display in Add Remove Programs list Mark this to exclude your application...

Page 110: ... Programs Features Page Use Installation Expert Features page to create the structure of an installation by defining z What features make up the application z How those features are presented to the end user during installation z What conditions must be true for portions of features to be installed z The target platform 32 bit 64 bit or both for each feature See How to Specify the Target Platform ...

Page 111: ... Down List z To configure all items for a feature click its name and click Details at the right of the Features page See Configuring a Feature Using the Feature Details Dialog on page 116 z To delete a feature or condition click its name and click Delete at the right of the page When you delete a feature all its child features and conditions are deleted also z To rearrange features click Move Up a...

Page 112: ...lication should always be in a top level feature The core feature should install a functioning version of your application it should have no dependencies on resources that are in optional features When Windows Installer repairs an installation due to corruption or deletion of a resource it repairs the entire feature Example If an advertised shortcut is part of the top level feature and that advert...

Page 113: ... External_Text_Editor and External_Graphics_Editor are stand alone applications which can run independently of the core application Therefore you can make them siblings of the Core feature An end user can install the text editor or the graphics editor without the core application Use conditions with features The Core feature has two conditions VersionNT specifies that the operating system must be ...

Page 114: ...e Details dialog box appears 2 Complete the dialog box See Configuring a Feature Using the Feature Details Dialog on page 116 3 Click OK on the Feature Details dialog box The new feature appears in the tree 4 The order in which features appear on the Features page determines the order of the features on the Select Features dialog box that appears during installation To rearrange the order select a...

Page 115: ...t to being run from source This option corresponds to setting Favor Source in the Attributes drop down list on the Feature Details dialog box If a feature is installed to run from source it is available to the application and visible to the end user but is not actually installed on the local hard drive When the feature is invoked your application must call Windows Installer functions such as MsiGe...

Page 116: ... New Files on page 91 For technical information on the fields on this dialog box see Feature Table in the Windows Installer SDK Help Note Some options on this dialog box set the default only the end user can change the default during installation To prevent the end user from being able to change the defaults you set you can turn off the Select Feature dialog box on the Dialogs page set features to...

Page 117: ... called Select Installation Type During a Custom installation the end user can turn features on or off individually Each installation has an installation level stored in the property INSTALLLEVEL Each feature has its own installation level value which is set by this field If a feature s level is less than or equal to the installation s INSTALLLEVEL property then the feature is installed By default...

Page 118: ...can change the default Favor Local The feature should be installed on the destination computer Favor Source The feature should be run from the source CD or network directory This means the feature is available to the application but is not installed on the local hard drive When the feature is invoked your application must call Windows Installer functions example MsiGetComponentPath to locate and r...

Page 119: ...our application in such a way that it can locate the features wherever they might be placed by the end user To do this you can call Windows Installer functions such as MsiGetComponentPath Note Only the files that are in the directory you select or in its child directories will be installed in the new directory that the end user selects Example Suppose FeatureA installs File1 in the Sample FeatureA...

Page 120: ...condition from the Current Feature drop down list then add the ApplicationNT dll file z On the Files page select the Version9X condition from the Current Feature drop down list then add the Application9x dll file During installation the files contained within the conditions are installed only if the condition is true Version9X and VersionNT are properties that are set by Windows Installer See Vers...

Page 121: ...ging Binary Resources Use Installation Expert Resources page to add and update binary resources and to change the names or source files for existing binary entries It provides an easy way to edit and update peripheral files Examples graphics you might have added for an installation dialog box or DLLs you might call with a custom action Any changes you make here are reflected in the Binary table th...

Page 122: ... select the resource on the Resources page and click the Edit button at the right of the page The file should open in an appropriate application If it doesn t select Edit menu Reset Page and save the resource again using a different extension Adding Binary Resources When you use the Resources page to add binary resources to an installation Windows Installer Editor adds the appropriate rows to the ...

Page 123: ...g z Mark the corresponding check box in the Refresh column on the Resources page z Mark the Create update link to refresh data when file changes check box on the Resource Details dialog box You can only refresh binary resources with known source files If you try to mark the Refresh check box for a resource whose source file is shown as unspecified you are prompted to export the data to a new sourc...

Page 124: ...Windows Installer Editor Reference 124 Defining an Installation Project Managing Binary Resources on page 121 ...

Page 125: ...rectories and Web folders and set their options The Web Files page displays items to be installed to a Microsoft Internet Information Services Web server while the Files page displays all items to be installed For a summary of differences between the two pages as well as links to Web related functionality see About Web Installations on page 266 Visual Studio integrated editor only When you create ...

Page 126: ...y using wildcards and link the directory so that the installation s contents change dynamically as the directory s contents change See Adding Contents of Directories to the Installation on page 134 Add File Add files to the directory that is selected in the lower left list box See Adding Files to an Installation on page 130 New Create directories to be installed on the destination computer You als...

Page 127: ... File Details on page 145 Removing a File From the Destination Computer on page 142 Copying and Moving Files on the Destination Computer on page 143 To learn about the Web specific functionality of the Web Files page see About Web Installations on page 266 See also Installation Directories on page 128 Files or Web Files Page Icons on page 129 Adding Merge Modules Instead of Files on page 132 Addin...

Page 128: ...nation computer Some standard directories are already created under Windows such as System32 and Fonts To create a subdirectory of the system directory create it under the Windows directory 64 bit installations only The Windows directory has an additional subdirectory SysWOW64 which stores 32 bit applications and components Program Files x86 64 bit installations only A 64 bit system has two direct...

Page 129: ... different types of files on the destination computer Default directory If you specify the default directory on the Product Details page it appears on the Files page followed by INSTALLDIR This makes it easy to identify the installation directory To enable or disable this option select Show InstallDir from the right click menu Installation file Duplicate installation file Installation file with pe...

Page 130: ... to a feature are installed on the destination computer only if the feature is installed Items that you add to a condition are installed only if the feature is installed and the condition is true 3 If the directory where the file is to be added is not listed in the lower left list box a Select the directory under which the new directory should be created b Click New enter a directory name and clic...

Page 131: ...d click Open The file is added to the component s installation directory and appears in the upper right pane Other dialog boxes might appear See Additional dialog boxes on page 131 Additional dialog boxes z If you add a NET assembly and if Scan Dependencies in Wise Options is set to Prompt to scan dependencies then Windows Installer Editor Scans the assembly manifest for dependencies Displays the ...

Page 132: ...merge module that contains the file instead of adding the file Example The file olepro32 dll is part of a merge module named oleaut32 msm Microsoft OLE 2 40 Because the file olepro32 dll is meant to function as part of a more comprehensive merge module it is better to add the merge module instead of the individual file The merge module might contain other files registry keys and dependencies on ot...

Page 133: ...t is used by a package in the Wise Software Repository is added to an installation Typically it appears when you z Add a file to the Files or Web Files page z Add a file on the Visual Studio Solution page z Run tools that add files to an installation Example ApplicationWatch The Files in Repository dialog box lets you add the version of the file that is in the repository which ensures that you use...

Page 134: ...ated when the source directory changes To add contents of directories to the installation 1 Select Installation Expert Files or Web Files page 2 From Current Feature select a feature or condition Because any item you add must be assigned to a specific feature you cannot add an item when All Features is selected Items that you add to a feature are installed on the destination computer only if the f...

Page 135: ...nts of the directory If you specified wildcards the installation is synchronized based on the wildcard criteria If you included subdirectories those directories are updated also If you don t mark this check box you can turn automatic updating on later by using the Wildcard Details dialog box See Editing Settings for Automatic Updating on page 140 7 Click OK The contents of the directory in the upp...

Page 136: ...ded way to copy source files z When the Copy Source Files dialog box appears click OK All files that are listed in the dialog box are copied to the default solution directory which is listed in the Copy To column and their source paths are changed in the installation When the files are successfully copied they appear in the Source Files tree in Solution Explorer To copy files to a specified direct...

Page 137: ...added to the Assembly tab of the File Details dialog box z In a mixed installation NET and Win32 registry keys are added to register NET assemblies so that they can be called as though they were COM components You can install assemblies into the Global Assembly Cache the WinSxS directory or a private directory Each of these directories is used in a different way Global Assembly Cache Assemblies th...

Page 138: ...ndencies without prompting check box Not available in the Visual Studio integrated editor You can exclude dependencies from the assembly scan for a specific installation or for all installations See About Dependency Scan Exclusions on page 139 Note On NET Framework versions earlier than 1 1 the scan does not occur when you add an assembly from a UNC or mapped network drive example the share point ...

Page 139: ...e xml and place it in one of the following locations z The Windows Installer Editor subdirectory of this product s installation directory on the local computer z The top level of the share point directory Project dependency exclusion list A project dependency exclusion list is maintained for every NET installation project A dependency is added to the list when you choose not to include the depende...

Page 140: ...rd coded exclusions add them to the XML file The following list of default exclusions is provided in the proper XML syntax You can add your own exclusions to this list xml version 1 0 encoding utf 8 Exclusions Assembly name Microsoft VisualBasic Assembly name Microsoft VisualBasic Vsa Assembly name Microsoft Vsa Assembly name Microsoft_VsaVb Assembly name Microsoft Vsa Vb CodeDOMProcessor Assembly...

Page 141: ...ry list and click Delete 6 To configure a particular source directory select it in the Source Directory list and complete the Wildcard Details dialog box Include Wildcards Exclude Wildcards To include or exclude files based on specific criteria enter a semicolon delimited list of wildcards Example Enter EXE for all EXE files or DLL for DLL files If you leave the wildcard fields blank all files in ...

Page 142: ...log box See also Files or Web Files Page on page 125 Files or Web Files Page Icons on page 129 Installation Directories on page 128 Adding Files to an Installation on page 130 Adding Contents of Directories to the Installation on page 134 Removing a File From the Destination Computer You can add an operation to remove one or more files from the destination computer during installation This operati...

Page 143: ...le should be removed during install uninstall or both install and uninstall 3 Click OK The operation to remove a file from the destination computer appears preceded by On the Files or Web Files page the entry s Type column contains Remove To edit it double click its name To delete it use the right click menu See also Files or Web Files Page on page 125 Installation Directories on page 128 Files or...

Page 144: ...directory and click New Folder Source File Name Specify the name of the file to be copied or moved You can use wildcards to select multiple files or you can mark All Files to select all files in the selected directory Dest Directory Specify the directory on the destination computer to copy or move the file to or create a new subdirectory To create a new subdirectory select a directory and click Ne...

Page 145: ... Directories on page 147 Editing Self Registration Settings for Files on page 148 Editing Assembly Settings for Files on page 149 Viewing Shared File Resources on page 152 Editing XML Files During Installation on page 153 To edit attributes for multiple files 1 On the Files or Web Files page select multiple files in the lower right list box In the Visual Studio integrated editor you also can use t...

Page 146: ...long file names Source Pathname The full path of the file on your computer If this is blank or if it is just a file name with no path you might be working in an MSI which encapsulates the file itself Font Name File Details dialog box only The name of the font contained in the file if it is a font file Read Only Make the file read only on the destination computer Hidden Make the file hidden on the ...

Page 147: ...he Global Assembly Cache a duplicate file is not created because they are treated as separate components Setting Permissions for Files and Directories You can set NTFS NT file system permissions for a single file or folder or for multiple files The permissions you set are applied to the domain and user you specify so you can set different permissions for the same file or folder for different users...

Page 148: ...h later in this installation has files written to it If the current user profile running this installation is ADMINISTRATOR then the installation will fail to write to SampleFolder because only ASPNET_USER has write permissions to SampleFolder ASPNET_USER is automatically set See Run Time Properties on page 570 Editing Self Registration Settings for Files Many files support self registration examp...

Page 149: ...ils dialog box to enter and edit information about NET and Win32 assemblies Windows Installer Editor uses this information to register the assembly files z For a NET assembly use the Assembly tab to enter the assembly attributes If the NET Framework is installed on your computer this information is filled in from the assembly manifest and you should not have to change it Also use the Assembly tab ...

Page 150: ... on this assembly A NET assembly can contain an install object that performs additional installation functions unique to the assembly Mark this to execute this assembly s install object after the file is installed Generate native code version during installation Mark this to run the Native Image Generator ngen exe on the assembly after it is installed The Native Image Generator precompiles portion...

Page 151: ...k the application file in the lower right list box In the Visual Studio integrated editor you also can use the Visual Studio Solution page The File Details dialog box appears 3 Click the Assembly tab 4 From Assembly Type select Win32 Attributes are read from the file and displayed in the Assembly Attributes list and a manifest file name is entered in Manifest 5 To add dependencies to the manifest ...

Page 152: ...tential file conflicts during the development cycle When the file in the current installation conflicts with a file in the Software Manager database you can replace the current file with the correct version from the repository You also can view shared file resources in a report format See Generating Shared Resource Reports on page 31 To view shared file resources 1 Do one of the following In Insta...

Page 153: ... existed the exclamation point to the left of the package changes from red to white See also Using a Wise Package Studio Repository on page 29 Editing File Details on page 145 Editing XML Files During Installation When you add an XML file such as Web config to the Files or Web Files page and then get details for the XML file the Dynamic Content tab appears which shows the file s contents The purpo...

Page 154: ...or dialog box when finished At run time the attribute is replaced with the dynamic value you specified Windows Installer properties are resolved to their value See also Editing File Details on page 145 Editing DIFxApp Options When an installation contains a device driver that meets Microsoft Driver Install Frameworks DIFx driver requirements you can use Microsoft s Driver Install Frameworks for Ap...

Page 155: ...ore robust than letting the file self register at installation time because it does not depend on the presence of other files on the destination computer or on how well the OCX or DLL file adheres to self registration conventions How self registration information is scanned z When a file is added to an installation its type libraries are scanned for registration information and the appropriate reg...

Page 156: ...the registry information u self unregisters the files after the extraction is finished Input_COM_Full_pathname is the path to the file or files that should be self registered Output_REG_pathname is the path and file name of the REG file to which the registry information will be extracted This file must be accessible to anyone who will be working on the installation The files are registered and the...

Page 157: ...t included in the solution scan z Organize files into features z Change file details z Define which output groups are included in the solution scan Changes that you make on the Visual Studio Solution page affect the output group settings on the Project Outputs page in the project settings See Project Outputs Page on page 89 See also When to Use the File Related Installation Expert Pages on page 12...

Page 158: ...pdated Working with the Visual Studio Solution page z If the installation has multiple features specify the feature you are configuring by selecting it from the Current Feature drop down list z In the lower left list box use the right click menu to expand or collapse folders to hide or show empty folders and to rename folders z Drag an output group or file from the upper list boxes to the lower li...

Page 159: ...n the lower left list box Note If the dependencies of an output group are excluded and you clear the Exclude dependencies option on the Output Group Details dialog box the dependencies will not appear in the lower right list box until you save the installation See also Installation Directories on page 128 Adding Merge Modules Instead of Files on page 132 Adding Files From the Wise Software Reposit...

Page 160: ...sting files This moves the output group from its current folder but leaves the existing files there Move the existing output group and files This moves the output group and its files to the new folder This option is selected by default for all output groups but if you select one of the first two options that option becomes the default selection Maintain directory structure This maintains the direc...

Page 161: ...ination computer You can either add registry entries manually or import a registry file REG If you import a Visual Basic VBR file it will import the registry settings but will not automatically set up for the installation of either a remote automation or DCOM server You also can export to a registry file When you import a registry entry that points to a standard directory such as Win32 or Program ...

Page 162: ...e key selected on the left Registry keys on your computer Registry keys to be created on the destination computer Registry values to be installed on the destination computer The button menu lets you add values to the 32 bit or 64 bit registry On a 64 bit computer the 64 bit registry is visible here The button menu lets you add keys to the 32 bit or 64 bit registry ...

Page 163: ... whether to add the value to the 32 bit or 64 bit registry Add Create a new key or import a registry file into the installation Delete Key Delete Value Remove a registry key or value from the installation Details Edit registry key settings See also Adding Registry Keys on page 163 Removing Registry Entries From the Destination Computer on page 165 Importing and Exporting Registry Entries on page 1...

Page 164: ...add a registry value in Installation Expert 1 Select Installation Expert Registry page 2 From Current Feature select a feature or condition Because any item you add must be assigned to a specific feature you cannot add an item when All Features is selected Items that you add to a feature are installed on the destination computer only if the feature is installed Items that you add to a condition ar...

Page 165: ...ys only the registry keys for the feature in the Current Feature drop down list To display registry keys for all features mark View registry keys for all features on Registry page in Wise Options Warning Be very careful when removing registry entries from the destination computer Do not remove registry entries unless you are sure that they are not used by another application To add a remove regist...

Page 166: ...elp 5 Click OK The remove registry operation appears in the upper right pane To edit it double click its name To delete it use the right click menu To remove multiple registry keys from the destination computer 1 Select Installation Expert Registry page 2 From Current Feature select a feature or condition Because any item you add must be assigned to a specific feature you cannot add an item when A...

Page 167: ...oot folder To export to a registry file 1 Do one of the following Select Installation Expert Registry page In the lower left list box right click the key to export and select Export to REG File To export all keys that you have designated for the destination computer right click the Destination Computer icon In Setup Editor on the Components or Features tab right click the Registry icon or a regist...

Page 168: ...amation point appears over the icon of the registry value you selected This option appears only when you access the Registry Details dialog box from the Registry page Root This is enabled only when you access the Registry Details dialog box from the Add button on the Registry page The top level key in which the new key will be added Example HKEY_CURRENT_USER Key This is enabled only when you acces...

Page 169: ...ry Hex REG_BINARY Identifies the value as a binary in hexadecimal notation Do not use spaces commas or other characters to separate the bytes Example AD30C0A94020A8FC4C0008 3 Click OK Setting Permissions for Registry Keys Use the Registry Key Permissions dialog box to set permissions to protect your application s registries against accidental deletion or changes See Configuring General Registry Se...

Page 170: ...tup Editor The Registry Details dialog box appears 2 Click the Shared Resources tab See also Using a Wise Package Studio Repository on page 29 Registry Page on page 161 Special Registry Keys In addition to the standard top level registry keys a special registry key named HKEY_USER_SELECTABLE is provided Depending on the operating system during installation an end user can install an application fo...

Page 171: ...n Key or Value fields in the INI File table entering the formatted text directly on the INI File Details dialog box You also can edit the IniFile table in Setup Editor For information on formatted text strings see Formatted in the Windows Installer SDK Help See Editing Existing Tables on page 434 Creating and Editing INI Files Note When you change an INI file and then view its contents the lines w...

Page 172: ...ete the INI File Details dialog box z INI Filename Enter a name for the new INI file or click Import to import an existing INI file This file will be created on the destination computer if it does not already exist If it exists the INI contents you enter will be used to edit the existing INI file Note Because Windows Installer does not support writing comments to INI files comments are removed fro...

Page 173: ...d the condition is true b Click Add at the right of the Shortcuts page In Setup Editor on the Components or Features tab right click a component or feature and select New Shortcut The Shortcut Type dialog box appears 2 Complete the dialog box File in the installation Mark this to have the shortcut open a file in the installation Advertised This is marked by default which means this shortcut appear...

Page 174: ... the shortcut in a new directory click New Folder to create it 6 Click Finish The Shortcut Details dialog box appears where you can specify further details for the shortcut When the end user installs your application this shortcut will appear in the location you specified See Editing a Shortcut Configuration on page 174 The shortcut appears To edit it double click its name To delete it use the rig...

Page 175: ...dard directories Example To specify a file named Notes txt in the Windows directory enter WindowsFolder Notes txt For a list of predefined directories see System Folder Properties in the Windows Installer SDK Help Description Enter a one line description of the shortcut which appears when an end user right clicks on a shortcut file in Windows Explorer and selects Properties Working Directory Selec...

Page 176: ...ment variable Note To read the value of an existing environment variable into a property use the Set Property type of custom action to read it into a property Enter ENVIRONMENT_VARIABLE_NAME in the Property Value field on the Details tab of the Set Property dialog box while making the action brackets required Operation Specify how to handle the variable during installation and uninstallation Repla...

Page 177: ...on in Windows Explorer See Adding Command Verbs on page 178 4 Optional On the MIME Types tab mark Show All and mark check boxes to select the MIME types to associate with this extension See Selecting MIME Types on page 179 5 Click OK The file association appears To edit it double click its name To delete it use the right click menu In Setup Editor a new branch of folders is created under the Adver...

Page 178: ...ou specified above Description Enter the type of file The end user sees this description on the Properties dialog box for files of this type Icon Click Change Icon and specify an icon This icon will be displayed on files of this type on the destination computer Note The Description and Icon fields are associated with the ProgID not the extension If no ProgID is specified those fields are unavailab...

Page 179: ...w All Mark this to display all available MIME types on your computer To associate a MIME type with an extension click its check box If you are an experienced Windows Installer developer you can add MIME types using the MIME table in Setup Editor Show Associated Mark this to display the MIME types currently associated with the selected file extension To disassociate a MIME type clear its check box ...

Page 180: ...the currently selected feature The left list box displays the directory structure of the installation and the right list box displays files in the selected directory 5 Select a file in the right list box and click OK The Create Service Details dialog box appears 6 Complete the dialog box The options you set on the Create Service Details dialog box are dependent on how you coded your service Some o...

Page 181: ...shares a process with others Mark this if the service runs as a shared process such as a kernel driver or file system driver Automatic Mark this to have the service always start when the destination computer is started Manual Mark this to have the service enabled but not automatically started If this option is marked the end user can start the process manually using the Services control panel or S...

Page 182: ...e passed to the service on the command line at startup Install Action Mark the actions to perform on the service when your application is installed Uninstall Action Mark the actions to perform on the service when your application is uninstalled Wait for service action to complete before continuing Mark this if the installation should wait until the actions specified above finish before continuing ...

Page 183: ...on page 184 The ODBC entry appears To edit it double click its name To delete it use the right click menu Setting ODBC Data Source Details To set ODBC data source details 1 Access the ODBC Data Source Details dialog box See Adding an ODBC Item on page 182 2 Complete the dialog box Data Source Name Enter a name for the data source or click Import to import data source information from a saved data ...

Page 184: ...alog box See Adding an ODBC Item on page 182 2 Complete the dialog box Description Enter a description of the translator or click Import to import an existing translator If you click Import the Select ODBC Driver dialog box appears which displays a list of ODBC translators that are currently installed on your computer Translator File Specify the file that contains the translator Setup File Specify...

Page 185: ...dd Windows Firewall exceptions to an installation is not restricted by the operating system that is running on your build computer The operating system on the destination computer determines whether the exceptions are implemented z When the destination computer is running Windows XP SP2 Windows Server 2003 SP1 or later the exceptions are added to the Windows Firewall exceptions list z When the des...

Page 186: ...me for the port c In Port Number enter the number of the port to open d Mark TCP or UDP to specify the communications protocol A combination of port number and protocol type can appear in the exception list only once e Click Finish The exception appears To edit it double click its name To delete it use the right click menu When you edit an application exception you can only change the Friendly Nam...

Page 187: ...ions on computers running Windows Server 2008 or later server operating system you can specify requirements for server roles and services See Setting a Requirement on the System Requirements Page on page 187 See Setting a System Requirement for Server Roles and Services on page 189 z Launch Conditions icon This is in Setup Editor Product tab It lets you build complex conditions using Windows Insta...

Page 188: ...on of Windows NT the minimum system requirements specified under the Windows NT Version item are checked instead Windows NT Version The requirements you set for the Windows NT version apply only if the destination computer is running one of the following operating systems Windows 2000 Windows XP Windows Server 2003 Windows Vista Windows Server 2008 Windows 7 If the destination computer is running ...

Page 189: ...irements to check its state as set on the destination IIS Web server You can specify the order in which these launch conditions are evaluated in the WiseLaunchCondition table See Wise Tables on page 559 See also Importing NET Framework Security Settings on page 283 About Microsoft NET Technology on page 548 Requirements for Creating a NET Installation on page 552 Setting a System Requirement for S...

Page 190: ...hem to the roles txt file they appear on the Server Roles and Services dialog box When you add a role or service to the roles txt file you must enter the value of the ID property for the server role or service These values are listed in the ID properties table in the Win32_ServerFeature Class article in Microsoft s MSDN Library This table has a column for the value and another column for the descr...

Page 191: ...icon and select New Launch Condition The Launch Condition Details dialog box appears 2 Complete the dialog box Condition Enter the new condition or click Build to create a condition in Condition Builder See Creating Conditions With Condition Builder on page 441 Message Text Enter the error message that appears if the destination computer doesn t meet the condition It should communicate to the end ...

Page 192: ...he Windows Installer SDK Help You can get the product code GUID of the previous installation by filling in the Action Property field on the Upgrade dialog box See Creating an Upgrade on page 346 Searching For Files or Directories On the System Search page you can set up a search for a file or directory on the destination computer To find a directory you must search for a specific file contained in...

Page 193: ...ch directory to search The default 0 searches only the top level of the directory specified in Search Directory If you are searching all fixed drives for a file then 0 searches the root directories only Enter 1 to search both the top level and the top level s child directories 2 to search two levels of child directories and so on File Name Enter the name of the file Details Click to specify more d...

Page 194: ... Items in INI Files On the System Search page you can set up a search for an item in an INI file on the destination computer You can either search for a generic value or do a special search that s tailored specifically for a file path or directory path Note When you use the System Search page to search for an INI file you can only search for INI files that are inside the Windows or the Winnt direc...

Page 195: ...lication exe However the file name itself is dropped from the search result A search of this type returns the directory path only minus the file name Example E Application If you use this operation on INI information that s in the form of a directory path or any other form then this type of search fails The search also fails if there is more than one value listed for the item separated by commas R...

Page 196: ...ready defined a new public property all uppercase in the Properties icon on the Product tab then you can select it from the list otherwise enter a new property name all uppercase If you enter a new property name and the search fails to find a match the property value will be null and will be false if used in a condition Operation Select the type of entry for the property Read directory name from r...

Page 197: ...want to find the installation directory of version 1 0 of your Sample1 application You could use a file search to find the file Sample1 exe but it might take a long time to search all drives Instead you could search for the component ID of the component that contained Sample1 exe in the original installation This type of search is much faster To perform a component search you must know the compone...

Page 198: ...u run the installation the property you specified will hold the results of the search If it is empty the search failed Setting Version Specific Windows Installer Options Windows Installer 4 0 or later only Use the Windows Installer Options page to set options for installations that will run on Windows Installer 4 0 or later The features that these options enable were introduced with Windows Vista ...

Page 199: ...t have files in use The use of Restart Manager determines which dialog box appears if the installation tries to update files that are being used If Restart Manager is enabled the Windows Vista Files in Use dialog box MsiRMFilesInUse appears If Restart Manager is disabled the Files in Use dialog box used in earlier versions of Windows appears z Restart registered applications that were shut down by...

Page 200: ...ows Installer Installations Windows Installer 4 0 or later only In pre Vista versions of Windows users frequently logged on as administrators leaving their computers vulnerable to security breaches The User Account Control UAC that was introduced with Windows Vista provides a temporary privilege elevation model A user who needs to run an administrative application can elevate their permissions by ...

Page 201: ...pecific Windows Installer Options on page 198 Elevate the entire MSI in the following situations z When the installation contains custom actions that access protected areas and are located outside of the Execute Deferred sequence Typically such custom actions check launch conditions or obtain data to populate installation dialog boxes z When you cannot or prefer not to wrap the MSI in an EXE See A...

Page 202: ...n you elevate an entire MSI the custom action WiseElevateCheck is added to the User Interface sequence Do not remove this custom action from the installation Note When you create a Web installation or a server installation Wise IIS related custom actions are added to the Execute Immediate sequence These actions are coded to run in an elevated mode Any other custom actions in the Execute Immediate ...

Page 203: ... the Installation Type dialog box Because the Installation Types page simply sets the defaults the end user can still override these choices during installation by clicking Custom in the Installation Type dialog box and then turning features on or off on the Select Feature dialog box To display the Select Feature dialog box to the end user during installation mark its check box on the Dialogs page...

Page 204: ...ures are turned on by default during installation select an installation type name in the upper left list and mark the check boxes of the features in the list on the right Warning If you are using the Installation Types page to manage the Installation Type dialog box do not edit the Installation Type dialog box Doing so causes the Installation Types page not to work properly The following examples...

Page 205: ...Windows Installer Editor Reference 205 Your Installation on the Destination Computer Select Features dialog box Default features ...

Page 206: ... creating and customizing releases within the installation You can create releases that install different features have different properties have different output formats and support different platforms The Releases page lets you define multiple releases for an installation edit releases and delete releases you have created If you haven t created additional releases for the installation the Releas...

Page 207: ...ion on page 97 You can edit various aspects of each release on the other pages in the Release Definition page group Creating a New Release Note This page is fully enabled in a WSI only In an MSI or MST you cannot add or delete To create a new release 1 Select Installation Expert Releases page 2 Click Add The Release Details dialog box appears 3 Enter the following Release Name Enter a unique name ...

Page 208: ...for an evaluation release to clearly distinguish it from your standard release See Changing the Theme of Dialogs on page 453 The theme of the Default release on the Releases page corresponds to the Default Theme on the Dialogs page Changing the theme on one page changes it on the other Renaming or deleting the Default release breaks this relationship Compression Type Select the amount of compressi...

Page 209: ...one installation The Visual Studio Releases dialog box appears See Associating a Release With Visual Studio Build Configurations on page 209 6 Click OK The release is added to the list on the Releases page To edit a release double click its name The other pages in the Release Definition page group let you further customize each release See also How to Specify the Target Platform on page 71 Associa...

Page 210: ...ove platform should cause this release to be compiled 4 If Platform appears repeat step 2 and step 3 for each platform that is listed 5 Click OK to return to the Release Details dialog box See also Creating a New Release on page 207 Compiling An Installation on page 97 Outputting a Multiple Language Release Note This page is fully enabled in a WSI only In an MSI or MST you cannot add or delete Nor...

Page 211: ... end user runs the installation EXE the installation either proceeds in the destination computer s language or prompts the end user to select a language If you created a single file EXE the MSI runs with the appropriate transform If you created an EXE that launches an external MSI the appropriate language MSI runs Customizing a Release When you create a new release it has the same properties summa...

Page 212: ...operties icon in Setup Editor Product tab Only those properties that you change or add for a specific release appear under the Properties icon on the Release Settings page Properties that you add for a specific release do not appear in Setup Editor Deleting a property from the Release Settings page removes the override for the specific release To customize properties for a release 1 Select Install...

Page 213: ... 2 From Current Release select a release 3 In the list box click the Summary icon 4 Click Add at the right of the Release Settings page The Summary Settings Override dialog box appears 5 From Name select a summary item 6 In Value enter a new value or text for the summary item 7 Click OK The summary item appears in the list box To edit it double click its name See also Specifying Summary Informatio...

Page 214: ...he link To share settings between releases 1 Select Installation Expert Release Settings page 2 From Current Release select a release to copy settings to 3 Click Share at the right of the Release Settings page The Share Release dialog box appears 4 From Copy Share Settings From select the release that contains the settings to copy 5 Click OK The settings of the release in Copy Share Settings From ...

Page 215: ... resources that let end users save files z On the Releases page you have created a release named Evaluation To create a sample evaluation release 1 Select Installation Expert Release Settings page 2 From Current Release select Evaluation 3 Click the Properties icon 4 Click Add at the right of the Release Settings page The Property Settings Override dialog box appears 5 From Name select ProductName...

Page 216: ...les are output when you compile this release If you create an EXE you can install Windows Installer and NET Framework runtimes and run prerequisite files on the destination computer before the main installation In a 64 bit installation the EXE will always be 32 bit For WebDeploy to be enabled you must select one of the WebDeploy options Do not create an EXE file Create only the MSI file The instal...

Page 217: ...e Install the MSI into an SVS layer option is selected For this to work the previous version must have been installed using Windows Installer technology If not then use the System Search page to search for a previous version Note For best results use the Upgrades page rather than this option to deal with previous versions of your application Do not mark this check box if you are using the Upgrades...

Page 218: ...Installer directories and any directories that you added on the Files page To exclude subdirectories mark Exclude all subdirectories under this directory Directories that you exclude appear in the list pane on the Build Options page See also Adding Prerequisites to a Release on page 221 Creating a WebDeploy Installation on page 233 About the Installation of an MSI into an SVS Layer You can create ...

Page 219: ... installed then the MSI is installed normally and not into an SVS layer You can include the SVS Driver runtime with your installation or have it downloaded when your installation runs See Adding the SVS Driver Runtime on page 223 The SVS Driver runtime does not appear in Add Remove Programs on the end user s computer The end user can remove the SVS Driver runtime by using the following command lin...

Page 220: ...iver runtime the SVS Driver runtime is installed Prompts the end user to restart the computer if the SVS Driver was installed The computer must be restarted to complete the installation of the SVS Driver Creates an SVS layer for the MSI and installs the MSI into the layer The MSI installation runs normally This includes the installation dialog boxes that appear to the end user The product code of ...

Page 221: ...r can perform the following operations from Add Remove Programs z Remove This option deletes the SVS layer along with the application z Repair This option runs Windows Installer repair This reinstalls missing or corrupt files registry keys and shortcuts Preferences stored in the registry may be reset to default values z Advanced This option lets the end user access the following options Modify Thi...

Page 222: ...n the Build Options page specify how to install the SVS Driver See Adding the SVS Driver Runtime on page 223 5 If necessary add prerequisite files See Adding a Prerequisite File on page 224 6 If necessary add runtime files See Adding a Runtime Prerequisite on page 226 For each prerequisite file and runtime file that you add in the lower pane script is added to the WiseScript that creates the insta...

Page 223: ...003 32 bit runtime then this 4 5 runtime would be added to the installation 4 Optional Mark the Delay Windows Installer runtime reboot until after product installation option This option delays the restart to the end of the installation and minimizes restarts for the end user This is enabled only if one of the Windows Installer Runtime Version fields is set to 2 0 or later Normally installing the ...

Page 224: ...s the size of the installation Download Driver Mark this to download the SVS Driver runtime during installation This option significantly reduces the size of the installation When this option is selected the end user sees a progress bar when the runtime is downloaded If the end user does not have an active Internet connection they have the option to install the application normally not into an SVS...

Page 225: ... File Path Specify the prerequisite file to be run before the main installation Command Line Specify the command line options to apply to the prerequisite file at run time If the prerequisite s launch conditions fail stop the MSI installation Mark this to stop the main installation if the prerequisite file fails to run because of its launch conditions Add Launch Conditions Click this to add launch...

Page 226: ...roject directory named Msi_Name FILEPATH1 Adding a Runtime Prerequisite If you need to distribute a runtime with an application you can use the Prerequisites page to add the runtime to run before the main installation A runtime is added as an include script to the WiseScript that creates the installation EXE Unlike prerequisite files you do not set command line options or launch conditions for a r...

Page 227: ...ript is added to the WiseScript that creates the installation s EXE You can edit this script to enhance the functionality of the prerequisites See Editing the WiseScript That Creates the Installation EXE on page 227 Editing the WiseScript That Creates the Installation EXE If you select an option on the Build Options page to create an EXE a WiseScript project file WSE is generated which is used to ...

Page 228: ...ted using the WiseScript file that you edited 5 Thoroughly test the WiseScript to make sure it executes as expected To reset the WiseScript 1 Click Reset Script at the right of the page This button is enabled only if you have used the Edit Script button A warning message appears 2 Click Yes The changes you made to the WiseScript are deleted and the ability to add and edit prerequisite files on the...

Page 229: ...k box appears only if a locally installed SCCS is detected on your computer 2 Select Installation Expert Clean Build page 3 From Current Release select a release 4 Mark Store clean build in source control This is unavailable if source control is not enabled in options In Visual Studio this is unavailable if an SCCS is not installed locally 5 Click Browse under the Store clean build in source contr...

Page 230: ...ted 6 From the directory copy the clean build folder to your clean build computer 7 From the clean build folder on the clean build computer double click the file Wisebuild exe which silently compiles the build The compiled files appear for each release whose Build check box is marked on the Releases page Two log files are created one shows compile actions and the other shows compile errors Creatin...

Page 231: ...r and NET runtimes and prerequisite files if any are external to the EXE The resulting EXE is very small When an end user runs the EXE it connects to the Web location of the MSI and runs the MSI The runtime and prerequisite files are downloaded only if they are needed on the destination computer Prerequisite and runtime files that you add on the Prerequisites page are always included in the EXE Th...

Page 232: ...XE that contains the MSI z Configure WebDeploy by specifying the location of installation files on the Web server z Upload the installation files to the Web server z Notify end users of the Web link to the EXE Your Computer Your Web Server Phase 1 The end user z Runs the installation EXE from your Web server Destination Computer Phase 2 HTTP Protocol Your Web Server z Contains the EXE and other pi...

Page 233: ...a Digital Signature to an Installation on page 262 See also Creating Web Based Installations With WebDeploy Creating a WebDeploy Installation Windows Installer version For best results with WebDeploy the destination computer should have Windows Installer 2 0 or later Note This page is enabled in a WSI only The WebDeploy page lets you enable an installation for distribution through the Web You do t...

Page 234: ...button next to each field to display a URL Settings dialog box which lets you enter the elements of the file location separately and then builds the full path from your entries Note If you select the Create EXE and INI option the password is stored in the INI file If you are concerned about the password being visible select the Create a downloadable EXE option instead which stores the password in ...

Page 235: ... to an EXE that contains the MSI Create a Web page containing a link to the EXE file then upload the EXE to the location of that Web page Example Upload Sample1 exe to http www Sample1 com installs If you are distributing a multi feature install on demand application over a corporate intranet the installation should be compiled to an EXE that runs an external MSI Create a Web page containing a lin...

Page 236: ...s fully enabled in a WSI only In an MSI or MST you cannot add or delete The Media page lets you prepare an installation for distribution Here you specify compression the media s size holding directories and how features and components are organized on the media You set media options per release If the installation spans more than one media you can determine which files are placed on which disk or ...

Page 237: ...d at the right of the Media page The Media Details dialog box appears 4 In Media Name describe the media item you re setting up Examples Compressed Application Files or Uncompressed Tutorial This name appears on the Media page The media name must be unique within a release 5 In Compression Option specify how to compress the installation files This is unavailable if Single file EXE is selected on t...

Page 238: ...the installation gets its own CAB file This option is most efficient on a CD or similar media where file size is not an issue One Cab per component Every component in the installation gets its own CAB file This option is best for WebDeploy installations where only required components are downloaded The remaining options on the Media page are enabled in a WSI only 7 In the Custom Media Settings are...

Page 239: ...r your installation are placed in one or more destination directories and you copy them from there to your distribution media Enter one destination for each distribution media If you don t create media destinations that is destination directories the files are copied to the directory where the WSI file is located Example If your installation is so large that it needs two CDs enter two destination ...

Page 240: ...in the Volume Label field Including Features and Components in Media Items Note These settings are enabled in a WSI only You can specify the features and components to include in each media item By default All Features Components are selected to be included Use this setting in any of the following instances z The installation has only one media item z You want to include every remaining feature an...

Page 241: ...e settings the settings for the releases are linked This means that any change you make to the media settings for any of the linked releases is applied to all other linked releases At any time you can break the link To share media settings between releases 1 Select Installation Expert Media page 2 From Current Release select a release to copy settings to 3 Click Share at the right of the Media pag...

Page 242: ...This scenario means that you need to create two media items z One media item for those features and components that are always installed compressed into one big CAB file z A second media item for those files that can be run from the CD and that you therefore don t compress To create media items with shared size information The following steps are for the first media item 1 Select Installation Expe...

Page 243: ...mponents list click Add and select the features and components to compress 11 Click OK The next steps are for the second media item 12 On the Media page click Add The Media Details dialog box appears 13 Complete the dialog box Media Name Enter a name for the second media item Example Uncompressed Files Compression Option Select Uncompressed external files Share media destination size info with pre...

Page 244: ...es page to configure a Windows Installer installation to install files that support a mobile device application This lets you install the main application to a desktop computer and simultaneously install support for any mobile device that the user has The ability to install to multiple platforms at once including Windows simplifies the installation process for you and the end user The Mobile Devic...

Page 245: ... not the mobile device 4 If you added one or more Palm OS files and you selected the option to install to the Palm user folder then verify that the installation contains the Installation Type and Palm User Information dialog boxes 5 Compile the installation The mobile device installation files are included in the compiled MSI or EXE If you added Windows Mobile CAB files an INI file that describes ...

Page 246: ...e To add Windows Mobile CAB files to a desktop installation use Installation Expert Mobile Devices page See Adding Windows Mobile Files See also About the Mobile Devices Page on page 244 Process for Adding Mobile Device Support to an Installation on page 245 Adding Windows Mobile Files To add Windows Mobile CAB files to a desktop installation use the Windows Mobile wizard To access the wizard Do o...

Page 247: ...tory the Download Redistributables wizard appears during compile and prompts you to download it NET Compact Framework Runtime Version Select a version of the NET Compact Framework c Click Next The Desktop Computer dialog box appears 3 Complete the dialog box Desktop Directory Specify the directory on the desktop computer in which to store the CAB and INI files that are necessary for installation t...

Page 248: ...cation which is a PDB that contains world wide web content z PRC Palm resource which contains resources To install a Palm OS application the end user installs or downloads its file to the desktop computer runs the Palm Desktop software to specify the new application and performs a HotSync operation to install the application on the mobile device To add Palm OS files to a desktop installation use I...

Page 249: ...formation dialog box You can add this dialog box See Creating a New Dialog on page 460 Uninstalling Uninstall of the mobile device application is controlled by the Palm device Uninstalling the application from the desktop computer does not affect the application that is installed on the mobile device For information about Palm OS applications search for developer documentation at www palmos com Se...

Page 250: ...e desktop computer The Palm OS Files dialog box appears 2 Click Add specify a file and complete the Palm File Details dialog box File Name Specify the name for the file when it is installed onto the Palm device Source Pathname This specifies the source path for the file you added Install File to Palm Add on Folder During Installation Copy the file to the Palm Add on folder When the end user runs t...

Page 251: ...menu for the Test and Run buttons so you can test them Command lines that you can apply to installations at run time Command lines that you can apply to Windows Installer Editor for compiling Call MSIExec EXE Call WFWI EXE Are applied to Windows Installer installations or patches at run time Are applied to Windows Installer Editor at run time to compile an installation Options let you specify UI l...

Page 252: ...e Select this option to remove patches Advertised Advertises the installation on the destination computer Repair Repairs an application that is installed on the destination computer Network Install Extracts the files in the installation package to a network location Uninstall Uninstalls the installation package Update Updates the installation package by applying patches 4 Depending on the install ...

Page 253: ...ilable in a transform Command lines cannot be applied to a transform You can use a command line to set the UI options which determine how much the end user interacts with the installation See User Interface Levels in the Windows Installer SDK Help You can set UI options for all versions of Windows Installer or for Windows Installer 3 0 only To apply UI options to an installation 1 On the Command L...

Page 254: ...he Cancel button from the installation dialog boxes 5 To set options for Windows Installer 3 0 only mark one of the following options in the Windows Installer 3 0 only section This overrides any options you mark in the All Windows Installer versions section These options are enabled only if Windows Installer 3 0 or later is installed on your computer Quiet No UI Displays no user interface during t...

Page 255: ... enable the Logging Options check boxes mark Create Log File This enables the field to its right which displays the default location for a log file created during installation The default location is the Temp directory 3 To change the location of the log file specify a new path 4 To set logging options for all versions of Windows Installer mark the appropriate check boxes in the All Windows Instal...

Page 256: ...t actually installing the application If an application is advertised only the interfaces required for installing the application are presented to the end user or other applications saving time and disk space End users install the application by activating the advertised interface You can use a command line to set advertising options that determine who sees the advertised application and whether a...

Page 257: ...ion on page 251 Note The Repair tab appears only when Install Mode on the General tab of the Command Line Details dialog box is set to Repair 2 Complete the dialog box p Reinstall only if file is missing o Reinstall if file is missing or if an older version is installed e Reinstall if file is missing or an equal or older version is installed d Reinstall if file is missing or a different version is...

Page 258: ... Installation on page 251 Applying Transforms to an Installation Not available in a transform Command lines cannot be applied to a transform For information on transforms see TRANSFORMS Property in the Windows Installer SDK Help To apply transforms to an installation 1 Click the Transform tab on the Command Line Details dialog box See Creating a Command Line To Apply to an Installation on page 251...

Page 259: ...y the command line Update Use this option to update installed applications 2 Click the Patches tab on the Command Line Details dialog box 3 Mark whether to add or remove patches The option to remove patches is enabled only if Windows Installer 3 0 or later is installed on your computer 4 Click Add and specify a patch file MSP The full path appears in the Patch List 5 Repeat the preceding step to s...

Page 260: ... in the command line statement releases release_name_1 release name 2 Visual Studio only Compile only the specified releases from an installation containing multiple releases c release_name Compile only the specified release from an installation containing multiple releases Not available in the Visual Studio integrated editor p name value Set property values The property name and value must immedi...

Page 261: ...ild Process You can use the WFWI exe command line options in conjunction with other processes to create an automated build process Enter the following command line statement into a batch file or any other program that has the ability to run command line statements such as Scheduled Tasks in Control Panel path WFWI EXE path project file c o path output file s where z path WfWI exe is the path to th...

Page 262: ...Root Certificate Program Members in the MSDN Library msdn microsoft com library z You must have the signtool exe or signcode exe tool on your computer z Signtool exe requires the CAPICOM 2 0 redistributable to be installed and registered on your computer CAPICOM provides services for digitally signing applications and is available from the Microsoft Web site z The location of signtool exe or signc...

Page 263: ...to a Patch on page 341 Setting Digital Signature Options on page 43 Creating an Installation for Microsoft SMS If an installation will be run in a Microsoft Systems Management Server SMS environment you can have the installation create a status MIF file in the Windows directory to describe the application In order to use an installation in an SMS environment you must also create a package definiti...

Page 264: ...lation Expert Product Details page 2 In the Application Type field select either NET Application or Mixed NET and Win32 This designates the installation as NET and determines how Windows Installer Editor handles COM interop registry entries See Product Details Page on page 102 3 Add assemblies and their dependency files to the installation using the Files page See Adding NET Assemblies to the Inst...

Page 265: ...determines how Windows Installer Editor handles COM interop registry entries See Product Details Page on page 102 3 Add assemblies to the installation using the Files or Web Files page Be sure to add all files in multifile assemblies See Adding NET Assemblies to the Installation on page 137 4 Add attributes and dependencies for each assembly a Use a computer that has the NET Framework installed an...

Page 266: ...sites to a Release on page 221 7 Finish building the installation as usual then compile and distribute it See also About Microsoft NET Technology on page 548 Requirements for Creating a NET Installation on page 552 Frequently Asked Questions About Microsoft Windows Installer on page 546 Creating a NET Installation When You Have the NET Framework on page 264 About Web Installations You can create a...

Page 267: ...which represents the physical InetPub wwwroot directory on the destination computer It does not contain wwwroot but you can map a virtual directory to a physical directory that you created under wwwroot on the Files page You cannot delete a physical directory that is mapped to a virtual directory or Web site You can delete a virtual directory or Web site and a message asks if you want to delete th...

Page 268: ...Setting Permissions for Files and Directories on page 147 Wildcard groupings To make it easier to quickly add all files of specific types such as all Web file types you can set up Wildcard groups in Wise Options Then when you add the contents of a directory on the Files or Web Files page you can choose a wildcard group to filter on See Setting Wildcard Groups on page 54 Check for IIS version On th...

Page 269: ...d select New Web Site The New Web Site dialog box appears 6 Complete the dialog box Description Enter a description for the directory which serves as an identifying name in Internet Information Services Local Path Specify the physical directory to which the Web site is mapped You can browse to any directory that has already been added to the installation Example Change this to a directory under ww...

Page 270: ...nd files Click No to clear the Web Folder settings but leave the folders and files in the installation and the lower left pane If the Delete button is unavailable it means you have selected a normal folder instead of a Web site To delete a normal folder from the installation use the Files page On the Files page or Visual Studio Solution page you cannot delete a physical directory that is linked to...

Page 271: ...its name in this field 7 Click OK The virtual directory appears in the lower left list box 8 Select the new virtual directory and click Details The details dialog box appears with several tabs For a top level virtual directory the Web Site Web Site UI and Home Directory tabs appear For a child virtual directory the Virtual Directory and Virtual Directory UI tabs appear The remaining tabs are the s...

Page 272: ...icking OK on the details dialog box regenerates the Web dialog boxes in the installation To add a directory from your computer as a virtual directory 1 On the Web Files page manually create a virtual directory with the name of the directory on your computer 2 In the upper left list box navigate to and select the directory on your computer 3 Click Add Contents The Add Contents dialog box appears 4 ...

Page 273: ... See Setting Installation Options for a Web Installation on page 274 and About the Web Site Details Dialog on page 276 See also About Web Installations on page 266 Creating a New Web Folder To create a new Web folder 1 Select Installation Expert Web Files page If you don t see the Web Files page select All from the Page Views drop down list 2 From Current Feature select a feature or condition Beca...

Page 274: ...ion Expert Web Files page 2 In the lower left list box select a Web site or a top level virtual directory and click Details If you don t see the item you want make sure you have the correct feature selected in Current Feature The details dialog box appears 3 Click the Web Site UI tab 4 To display installation dialog boxes to the end user at run time mark Display Run Time UI This adds Web dialog bo...

Page 275: ...ions for a Child Virtual Directory An important part of setting up a Web installation is specifying the installation options that will be available to the end user at run time To do so use the Virtual Directory UI tab which appears on the details dialog box for child virtual directories If the virtual directory is directly under Destination Computer then see Setting Installation Options for a Web ...

Page 276: ...l Directory Mark this to let end users install Web resources in the named virtual directory to a new virtual directory Existing Virtual Directory Mark this to let end users choose to install Web resources to an existing virtual directory They will see a list of existing virtual directories to choose from Let End Users Rename Virtual Directory at Run Time Mark this to let end users enter a new name...

Page 277: ...ion Settings Lets you override existing settings when installing over an existing Web site or virtual directory See Creating a Web Site on page 268 or Creating a Virtual Directory on page 270 Web Site UI Web sites and top level virtual directories Lets you specify the installation options that will be available to the end user at run time See Setting Installation Options for a Web Installation on ...

Page 278: ...e XML file is generated for a specific version of Windows Installer Editor and can only be used with that version z The XML file contains the default Web site settings that you set in the installation z If the installation contains a Web site the XML file cannot be generated on a workstation that runs on an operating system earlier than Windows Vista z End users should limit their editing to the s...

Page 279: ... you have the ability to do any configuration that is possible with SQL statements You can generate SQL statements in the following ways z Type or paste SQL statements z Import SQL statements from a file z Specify a database to recreate and the necessary SQL statements are generated automatically To configure an installation to run a SQL script 1 Select Installation Expert SQL Server Scripts page ...

Page 280: ...ts z Databases are connected to and configured through the ODBC driver on the destination computer z The SQL scripts you specify are saved to a file with the same name as the script name you specify with the extension SQL The file is added to the installation This file appears on the Files page under a Temp directory During installation this file is installed its statements are executed and then i...

Page 281: ...ction Dialogs on page 479 The database you specify here must be accessible through ODBC on the destination computer If you have a database registered in ODBC on your own computer you can click Browse to select it and the connection string is generated For this to work the destination computer must have access to the same database 3 Click OK See also Tips for Using the SQL Server Scripts Page on pa...

Page 282: ...ements tab because they will be overwritten during compile Remove this database first Mark this to delete this database if it already exists on the SQL Server before execution of the SQL statements If this check box is cleared and the database already exists then any overlapping tables are overwritten on the destination computer new tables are added and non overlapping tables are left as is This r...

Page 283: ...ework Security Settings Use the NET Framework Security page to import NET Framework security settings from your computer into an installation for a NET application that you are deploying using no touch deployment No touch deployment lets system administrators deploy NET desktop applications through a remote Web server without altering the end user s registry or shared system components Search for ...

Page 284: ... add the code group to the installation The code group appears in bold type in the lower left pane If you import a child code group any parent code groups also appear but are not in bold type These parent code groups contain no security settings but maintain the correct hierarchical structure for the code groups To delete a NET Framework security code group from the installation select it in the l...

Page 285: ...llation for a given MTS or COM application to the same feature If you need to install both the server and client of the same application either create two MSI files or put the server installation in one feature and the client installation in another feature If the MTS or COM application contains roles those roles are not installed on destination computers See also Adding an MTS or COM Application ...

Page 286: ...fresh Update Application on Compile Mark this to refresh the MTS COM application from your computer s Component Services control panel each time you compile the installation If you clear this check box the MTS COM application information is copied immediately to this installation and is not refreshed during compile Example You might use this option if you need to transfer the installation to a com...

Page 287: ...the optional Language Pack contains translations for 20 additional languages You can add any language that is not already pre translated The Languages page displays pre translated languages Pre translated languages contain translations for all default text in the installation s user interface elements Examples error messages disk prompts text and controls on dialog boxes descriptions or names for ...

Page 288: ... mark a language check box then clear it the translation remains in the installation but no MSI or MST is created in that language during compile This lets you omit a language from the compile without losing any translated text strings This is especially important when you have added custom translated text Additional translation options You can create a multiple language installation that installs...

Page 289: ...e regenerates the Web dialog boxes in the installation To create a translated MSI 1 Select Installation Expert Languages page 2 From Current Release select a release 3 Mark the check box next to each language to translate this installation to Some MSI files might not have languages listed on the Languages page In that case you must use the WSI that compiled the MSI Note If this installation was cr...

Page 290: ...elected languages You can share these language settings with other releases in this installation See Sharing Language Settings Between Releases on page 291 Creating a Language Transform You can create one or more language transforms that change the language in the dialog boxes that appear during installation The compile creates an MSI for the default language and a separate MST for each language t...

Page 291: ...are these language settings with other releases in this installation See Sharing Language Settings Between Releases on page 291 Sharing Language Settings Between Releases You can translate several releases into the same language or languages with the same settings you define in the Language Details dialog box To do this you share language settings between releases After you initially share languag...

Page 292: ...recommended if you have added or changed text strings in a language because the customized strings are lost Note If the installation contains Web resources adding or changing a language regenerates the Web dialog boxes in the installation To disable a language in an installation 1 Select Installation Expert Languages page and clear the check box next to the language to disable The translated text ...

Page 293: ...uage Then you can translate installations into the new language Example Suppose you want to translate an installation into Swiss French However that language is not one of the pre translated languages You can add Swiss French to the Languages page and add Swiss French text strings to the installation Then you can compile an installation that displays Swiss French on all dialog boxes and error mess...

Page 294: ... can send to a translator z Import translated text strings from a file to the installation To use the New Language wizard 1 Select Installation Expert Languages page 2 Click Add at the right of the page The Specify Language Details page appears 3 Complete the page The information you need to enter depends on what you plan to do for details see the topics listed in the next step Then click Next The...

Page 295: ... language is always compiled to an MSI whose name is created by adding an underscore and the language name to the installation file name Example If the new language is named NewLanguage and the installation file is named Sample the translated installation is compiled to Sample_NewLanguage msi Codepage A code page ensures that the correct character set is used for the language you are adding In mos...

Page 296: ...on Importing All Text Strings After Translation Typically while adding a new language to the Languages page you export the text strings from the installation to a file and send them to a translator After the text strings for the new language are translated you must import them into the installation In this procedure you use the Language Strings dialog box to import translated text strings This pro...

Page 297: ...rings at the same time you define a new language on the Languages page Do this only when you already have a file containing translated text strings for the language you are adding Example If you added the language Swiss French to a previous installation and now you want to use it in a new installation you can use the New Language wizard to import Swiss French translations to the new installation N...

Page 298: ...page from the drop down list See Setting the Code Page of a Database in the Windows Installer SDK Help Language ID Specify only one language ID for the language you are adding Windows Installer supports only one language in this field Language IDs are standardized See Language IDs on page 310 or visit msdn microsoft com Default release language WSI files only Mark this to use this language as the ...

Page 299: ...uire more space than the default language Example Most languages require more space than English Therefore you might need to resize dialog box controls to accommodate text expansion See Resizing Dialog Controls After Translation on page 304 Note dialog box controls are shared across all languages which means that a control you add to one language is added to all other languages as well Similarly a...

Page 300: ... used in the installation To export selected text strings 1 Select Installation Expert Languages page 2 From Current Release select a release 3 Click Strings at the right of the page The Language Strings dialog box appears 4 From Language select the language to export text strings for The drop down list shows those languages that have translated text strings in this installation they are indicated...

Page 301: ...another language you must export the changed text strings and have them translated See Exporting Selected Text Strings to a File on page 300 When you receive translated text strings from the translator you import them into the installation so that those text strings appear in the correct language in the compiled installation To import selected text strings 1 Select Installation Expert Languages pa...

Page 302: ...e changes yourself for each language Example Suppose you have translated an installation to German Then you add a Cancel button to an existing dialog box You already know the German translation for Cancel because other dialog boxes contain a Cancel button In this case you don t need to export translate and import the changed string you can change the text for the new Cancel button You have the fol...

Page 303: ...in Installation Expert and Setup Editor You can change translated text for any of the selected languages in certain areas of Installation Expert and Setup Editor Do this when you have only a small amount of text to be changed and you know the translation for that text If you need to translate larger amounts of text export the text strings to a file See Translating Text Strings by Exporting to a Fi...

Page 304: ...ialog Controls on page 461 Note dialog box controls are shared across all languages which means that a control you add to one language is added to all other languages as well Similarly a control you delete in one language is deleted in all other languages However you can add conditions to show or hide certain controls in certain languages Table Columns you can translate and edit ActionText Descrip...

Page 305: ... installation such as files added or dialog boxes selected This means you cannot add files or select dialog boxes for a certain language in this manner Any file you add in Installation Expert or any dialog box you select in the Dialogs tab in one language is added and selected for all languages in the overall installation To add files or select dialog boxes for a certain language only use features...

Page 306: ...tes subdirectory varies See Installation Resources and Their Locations on page 32 b From Save as Type select Installer Projects wsi c Click Save The WSI is saved and then is compiled to an MSI Only MSIs appear in the New Installation File dialog box as templates To test the new template 1 Select File menu New The New Installation File dialog box appears and the file you just created appears in the...

Page 307: ...Mark Default release language and click OK 8 Select File menu Save As name the file and save it 9 Select Build menu Compile to create an MSI 10 Copy the MSI file to the Templates File directory The location of the Templates directory varies See Installation Resources and Their Locations on page 32 11 If you prefer to create a WSI template rename the file s extension If you have added files to the ...

Page 308: ...Language Details dialog box for Spanish you enter Sample2_Spanish mst as the Destination File When you compile the following files result Sample2 msi which is in German and Sample2_Spanish mst which is a Spanish language transform The Default release language check box is on the Language Details dialog box and the Specify Language Details page of the New Language wizard It appears in WSI files onl...

Page 309: ...eads Yes after you have imported text strings one of two things happened z Formatting for the corresponding text string in the resource or text file was changed Example This can happen if a tab in a text file was deleted or moved Try to reformat the resource or text file and then import it again z When you imported you chose to compare current strings with original strings and you have made change...

Page 310: ...allations is English unless you change it See Changing the Default Language on page 305 Language IDs Windows Installer uses language IDs to determine whether the destination computer supports the language that is used for the installation dialog boxes Example If you create an installation with the language ID for Greek that installation only runs on a computer with Greek fonts Language IDs and Loc...

Page 311: ...German Standard 1031 1252 German Swiss 2055 1252 Greek 1032 1253 Hindi 1081 0 Hungarian 1038 1250 Icelandic Icelandic 1039 1252 Italian Italian Standard 1040 1252 Italian Swiss 2064 1252 Norwegian Norwegian Bokmal 1044 1252 Norwegian Norwegian Nynorsk 2068 1252 Polish 1045 1250 Portuguese Portuguese Brazilian 1046 1252 Portuguese Portuguese Standard 2070 1252 Romanian 1048 1250 Russian 1049 1251 S...

Page 312: ...Windows Installer Editor Reference 312 Translating an Installation Turkish 1055 1254 Language Sublanguage Language ID decimal notation ANSI codepage ...

Page 313: ... in a centralized location and use Software Manager to manage installation resources This option is available only if you are connected to a share point directory that is associated with a Software Manager database Typically this connection is made during installation Distributing to the share point directory does not actually import the package into the Software Manager database but copies it to ...

Page 314: ...re overwritten with the paths in the share point directory If the project is bound to other projects in the solution these bindings will be broken In most cases if the installation file is not already in the share point directory it is best to specify the Scripts Application_Name Package_Name subdirectory of the share point directory which is the default If you are distributing an MSI or WSI that ...

Page 315: ...you share the project with coworkers without breaking the paths to source files The source file paths are changed to the new paths during this process These paths are not relative however you can use relative paths in a project file See Source Paths in an Installation on page 359 When you run package Distribution from a WSI it is compiled and the compiled installation is distributed If an EXE is a...

Page 316: ...package Distribution from a WSI it is compiled and the compiled installation is distributed If an EXE is associated with the installation the EXE is distributed To copy an installation to an FTP server 1 Select File menu Distribute The Welcome page appears 2 If you specified a WSI that contains multiple releases a drop down list appears Select a release 3 Mark FTP Server 4 Click Next If necessary ...

Page 317: ...ation from the network location See Administrative Installation in the Windows Installer SDK Help To perform an administrative installation 1 Select File menu Distribute The Welcome page appears 2 If you specified a WSI that contains multiple releases a drop down list appears Select a release 3 Click Next If necessary the installation file is saved and compiled The Administrative Installation page...

Page 318: ...es when you distribute 5 If the Distribution Media Directories page appears check the following lists to verify that the installation files are in the proper directories before you distribute them Volume Label Displays the value you entered when you created this destination on the Media Details dialog box Directory Displays the media destination you entered on the Media Details dialog box If you m...

Page 319: ...Windows WiseUpdate Client checks for newer versions of your application at the Web location you specified If it finds a new installation it downloads and runs it WiseUpdate by itself does not deploy the current version of your application it simply adds a Web based update mechanism to your end users computers The first time you configure WiseUpdate you enable that version to check for later versio...

Page 320: ...pplication directory A shortcut to WiseUpdate client is placed on the destination computer Destination Computer 3 Upload to the Web server WiseUpdate update file Installation files and Readme Your Web Server FTP HTTP z Contains the WiseUpdate update file that stores The new version number URLs to the new installation files z Contains the new installation files and Readme Phase 3 When you update yo...

Page 321: ...ested and ready for distribution upload the installation files the Readme file and the update file to a Web server See Uploading WiseUpdate Files With an FTP Client on page 325 Warning If you do not upload the files before deploying your application to end users an error occurs when they check for upgrades 5 Test the WiseUpdate process See Testing WiseUpdate on page 325 6 Distribute your applicati...

Page 322: ...s don t require user names and passwords This is used for basic HTTP authentication Host Password If necessary enter the password that s required to connect to the host address Enter this only if the Host Username is entered above Host Directory Enter the directory on the Web server where you plan to store updated installation files including the WiseUpdate update file To put the files in the root...

Page 323: ...puter is started or the end user logs on to Windows the shortcut runs WiseUpdate Client according to the Check Interval days setting described above If you do not mark this check box then WiseUpdate Client will never run on the end user s computer unless you code your application to run it Only display UI if there is an update to install Mark this to run the update check silently and prompt the us...

Page 324: ... installation on the Merge Modules page That merge module contains a WiseScript named WiseUpdt exe which contains the WiseUpdate dialog boxes To customize the WiseUpdate dialog boxes 1 In Windows Explorer go to the following directory Program Files Symantec Wise Installation Studio Windows Installer Editor WiseUpdt 2 Right click WiseUpdt wse select Properties uncheck Read only and click OK 3 In Wi...

Page 325: ...llation files and the URL to the Readme See About the WiseUpdate Update File on page 323 You can place the installation files and Readme at any Web location provided their URLs are recorded correctly in the WiseUpdate update file When you enter the URLs in the FTP client make sure they match the case of the actual path on the Web server Some HTTP servers are case sensitive and display errors if th...

Page 326: ...ick the file WiseUpdt exe Then click Next Because the version on the Web server is now later than the version on the testing computer WiseUpdate Client displays the Readme file and then displays an option to download and run the installation 3 You can download and run the installation but installation will fail unless the version on the server is an upgrade or patch that updates the currently inst...

Page 327: ...r updates Add a menu command in your application to run WiseUpdate Client Run silently You can use this option with either of the options above z On the WiseUpdate page mark the Only display UI if there is an update to install check box z On the destination computer WiseUpdate Client silently checks the time elapsed since it last ran If the appropriate amount of time has elapsed WiseUpdate Client ...

Page 328: ...e sets the version for the application and is used by Windows Installer to determine whether updates and patches are valid upgrades for the installed version z The Product Version field on the WiseUpdate page sets the version in the registry of the destination computer which WiseUpdate Client checks against the update file on the FTP server It also sets the version that is stored in the WiseUpdate...

Page 329: ...atch If the end user has version 1 0 0 of your application installed and you make some changes to it and upload it with a new version number the WiseUpdate upgrade will fail unless you configured the updated package as an upgrade using the Upgrades page or a patch using Patch Creation z If end users cannot view the Readme file in WiseUpdate Client make sure the Readme file does not have embedded g...

Page 330: ...radeSync tool Patch Creation tool and the Upgrades page For information on upgrading see the following topics in the Windows Installer SDK Help Patching and Upgrades Preparing an Application for Future Major Upgrades Small Updates Minor Upgrades Major Upgrades UpgradeCode Property Patching Changing the Product Code Preparing for Software Updates Preparing for updates starts when you ship the first...

Page 331: ...stalled with Windows Installer technology z Are small containing only the changes between the original and updated applications z Are created with the Patch Creation tool See Creating a Patch File on page 337 z Allow little flexibility in customizing an update Example You cannot change feature states leave certain features installed or perform custom actions based on the version of the installed a...

Page 332: ...ether you need to change the product code and the product version Windows Installer uses the product code and product version to determine how to handle an upgrade Also your organization s support department might need to differentiate updates based on product version You change the product code and product version on the Product Details page For information on when to change them see Incrementing...

Page 333: ... and upgrades to work incorrectly Use UpgradeSync before you create a patch or an upgrade Use Patch Creation to create a patch and the Upgrades page to create an upgrade For information on the different types of updates and when to change the ProductCode and ProductVersion see Patching and Upgrades in the Windows Installer SDK Help UpgradeSync changes your current installation according to Microso...

Page 334: ...ists issues in the installation that might cause problems when creating an upgrade or a patch These errors are the most common causes of patch and upgrade failures reported by Windows Installer users Errors that can be fixed automatically have a check box The following types of error cannot be fixed automatically and therefore have no check boxes File filename txt is a new resource that needs to b...

Page 335: ...s running UpgradeSync z The previous version or versions must have been installed using Windows Installer z To edit an existing patch you need access to its patch settings file PCP z If you created any previous patches for an installation you need access to the most recent patch file MSP to read its file sequence number and disk ID z You need access to the complete installation in MSI format for e...

Page 336: ... destination computer Example If Patch2 is provided before Patch1 they will be applied in that order z Sequenced patches are applied in sequence order Patch families A patch family is a group of patches that update the same similar or related functionality of the application and should be applied in a specific order relative to other patches in the same family Most patches belong to a single famil...

Page 337: ... this also specify the PCP file 4 Click Next The Specify Previous Versions page appears where you select MSI files of previous versions that this patch updates referred to as targets When this patch is run on a destination computer it verifies that a valid target exists before installation You must add at least one previous version to this list 5 To add a previous version click Add complete the Pr...

Page 338: ... dialog box appears Complete the dialog box and click OK See Advanced Upgrade Version Details on page 341 Add a Digital Signature to the Patch Windows Installer 3 0 or later Mark this to digitally sign the patch 10 Click Next on the Specify Upgrade Version page 11 If you are prompted to run an administrative installation again click Yes If you are prompted to update the package code click Yes If y...

Page 339: ...CD or other media on which this patch will ship If the application needs repair in the future Windows Installer uses this label to tell the end user what media to insert to perform the repair If the patch is not shipped on any media but is distributed over the Internet this field is ignored Disk Prompt Enter the prompt that the end user should see if this application needs to be repaired Example I...

Page 340: ...d upgrade application The upgrade code should always be the same for different versions of the same application Match Language Mark this to confirm that the language codes match between the target and upgrade images Version To Check Select what parts of the product version the major minor or update version should be used in the version relationship comparison Example Suppose the product version is...

Page 341: ...f this patch represents Service Pack 2 setting this field lets end users upgrade to Service Pack 2 even if they did not install Service Pack 1 Read Product Codes to Upgrade from Target MSI Files By default the product codes are read from the MSI files of the previous versions that you specified If you do not want the product codes to be read from the previous version MSI files clear this check box...

Page 342: ...e tool For details search for Signtool in the MSDN Library msdn microsoft com library Requirements z You must have a valid code signing certificate which you can obtain from a commercial certificate authority such as Verisign For a list of certificate authorities search for Microsoft Root Certificate Program Members in the MSDN Library msdn microsoft com library z You must have the signtool exe or...

Page 343: ...e file Mark this to use signtool exe and then specify the Personal Information Exchange file PFX to use Signcode exe with public private key pair files Mark this to use signcode exe and then specify the credentials file SPC or CER that contains your Digital ID and your private key file PVK See also Setting Digital Signature Options on page 43 Specifying the Patch Sequence Windows Installer 3 0 or ...

Page 344: ...eation click Advanced to display the Advanced Patch Settings dialog box See Creating a Patch File on page 337 2 Complete the dialog box and click OK Do not create file patches use entire files in patch package Mark this to have the patch file contain entire files instead of only the changed bits of files Example Suppose that only five files have changed between version 1 0 and version 1 0 1 of you...

Page 345: ... DisplayName Enter a name for the patch that will appear in Add Remove Programs Classification Required Enter text to describe the category of updates that this patch belongs to The category descriptions are arbitrary Examples hot fix security rollup update critical update service pack update rollup and so on ManufacturerName Enter the manufacturer or publisher of the application TargetProductName...

Page 346: ...the sole factor for determining whether the upgrade takes place You can see the upgrade code under the Properties icon in Setup Editor Product tab It is in GUID format Creating an Upgrade To create an upgrade 1 Select Installation Expert Upgrades page 2 Click Add at the right of the page and specify the MSI or WSI for the previous version of the application If you see a warning to update the curre...

Page 347: ...ins Feature1 Feature2 and Feature4 Feature3 has been dropped When you upgrade 1 0 users you enter Feature1 Feature2 in Features to remove When the upgrade occurs Windows Installer first removes Feature1 and Feature2 from the existing installation then installs Feature1 Feature2 and Feature4 Therefore users of 1 0 still have Feature3 Action Property Specify a property to run a particular custom act...

Page 348: ...rce code files Various commercial and open source software applications such as Microsoft Visual SourceSafe act as source code control systems SCCS All SCCS applications have similar functionality tracking who is working on what file allowing for retrieval of previous versions backing out of changes adding and removing files from the SCCS and recording the history of files They might also provide ...

Page 349: ...hen you show history the XML file is used instead of the installation file z When you compare differences the XML file is used instead of the installation file In Visual Studio integrated editor you cannot perform comparisons with the XML file This is a Visual Studio limitation z If you are using the Visual Studio source code control do not check out files outside the Visual Studio interface If yo...

Page 350: ...dd those files to the SCCS 3 On the Add to Source Control dialog box mark the check boxes of the files to add to source control and click OK Comments which are stored as an attribute of the file in the SCCS are optional If necessary scroll to the right to view the Type and File Path columns The Copy Files to New Location dialog box appears if any files are not in the directory tree of the installa...

Page 351: ...es to New Location dialog box appears if any files are not in the directory tree of the installation file Because all files that you add to source control must be in the same directory tree as the installation file this dialog box prompts you to move the files to a new directory under the installation file directory 3 Mark the check boxes of the files to copy to the same directory tree as the inst...

Page 352: ...nts which are stored as an attribute of the file in the SCCS are optional See also Using Source Control on page 348 Adding an Installation to Source Control on page 349 Checking Files Out from Source Control Not available in the Visual Studio integrated editor You can use this feature only if you ve added the current installation to your source code control system SCCS If you check a file in then ...

Page 353: ...ource Control on page 348 Adding an Installation to Source Control on page 349 Removing Files from Source Control Not available in the Visual Studio integrated editor You can use this feature only if you ve added the current installation to your source code control system SCCS To remove files from source control 1 Select Source Control menu Remove The Remove dialog box appears listing all files in...

Page 354: ...y of the installation exists the Show History command displays the history of the XML file instead of the installation file To view the history of files other than the installation file use your SCCS directly To view the history of the installation file select Source Control menu Show History Dialog boxes from your SCCS appear For information on these dialog boxes consult the documentation for you...

Page 355: ...est installation file that is checked into your SCCS To compare the current installation to the latest in source control 1 Select Source Control menu Compare to Latest You are taken to Setup Editor Tables tab and the Visual MSIDiff Key dialog box appears which describes icons that indicate changes Changes are shown in the tables and rows where they occur 2 On the Visual MSIDiff Key dialog box take...

Page 356: ...fined path variable named Application_Files and set it to C Application Test If you then add the test build source files their source path would contain the variable name You could then change this path variable to C Application Production for your production build Note Do not create more than one variable that refers to the same path because only one of them is used when you add files Predefined ...

Page 357: ...ick Add at the right of the page and select User Defined Path Variable The User Defined Path Variable Details dialog box appears 3 Complete the dialog box Variable Name Enter any name but do not use special characters or spaces Because this is not a Windows Installer property you do not need to follow Windows Installer property naming conventions This variable is inserted into the paths of files t...

Page 358: ...s to activate this path variable If this is cleared this path variable has no effect on files you add to the installation 4 Click OK See also About Path Variables on page 356 Creating a Path Variable Based on a Registry Value You can create a path variable that is set to a registry value When a registry path value is displayed on the Path Variables page a double slash precedes the value name This ...

Page 359: ...e broken then during compile error messages appear in the Task List concerning the files that could not be opened Rather than adding the files again you can specify new source directories for these files If files with broken paths should not be in the installation you can use the Remove Missing Files tool to remove them See Removing Files With Missing or Invalid Source Paths on page 409 The Conver...

Page 360: ...urce Paths In Visual Studio Project menu Convert Source Paths The Convert Source Paths dialog box appears with a list of all the directories that are referenced in the installation 2 Select a directory from the list To change multiple directories select a high level directory so that you can change all of its subdirectories 3 Click Change Selected Path The Change Selected Path dialog box appears 4...

Page 361: ...ick Change All Paths to Relative The Change Source Directories to column displays the new paths A one time conversion of the paths in the installation is performed To change the directories back to absolute paths select high level directories and change the paths See Changing Source Directories on page 360 Paths to files that are not on the same drive as the installation file are not converted bec...

Page 362: ...are on local drives are not converted However if the local drive is shared it is converted to the shared drive name See also Source Paths in an Installation on page 359 Changing the Source Directory Dynamically During Compile Not available in the Visual Studio integrated editor You can define a source directory as a property so you can easily reassign the location of source files when you compile ...

Page 363: ...xample SourceFiles You can add other directories to the end of the property name to create other locations Example SourceFiles Libraries Visual Basic SourceFiles Libraries C Change Sub Directories Mark this to change the subdirectories of the current directory 5 Click OK The Change Source Directories to column displays the property name in brackets 6 Click OK To change the source directory by comp...

Page 364: ...ortion of an application at run time The purpose of merge modules is to let you add self contained software modules to multiple installations See Merge Modules in the Windows Installer SDK Help Example Suppose you have five applications that require a specifically configured version of the Visual Basic runtime You could create a merge module that installs and configures the Visual Basic runtime Th...

Page 365: ...onents enable or disable isolated components specify a bitmap for a dialog box or specify how a custom action is run When you add a configurable merge module to an installation an additional dialog box appears on which you specify values for the configurable items You also can create configurable merge modules Configurable merge modules are supported only by Windows Installer 2 0 or later See Conf...

Page 366: ...taller uses this information to identify the merge module To set merge module details 1 Select Installation Expert Module Details page If there is no Module Details page you are not in a merge module file 2 Complete the page Module Name Enter a name that Windows Installer and Windows Installer Editor can use internally to identify the merge module Version Enter the version of the module Windows In...

Page 367: ...esignate as a dependency could itself have a dependency on another module and so on Use dependencies to compartmentalize different components of software When you compile an installation that contains a merge module that has a dependency both the original merge module and all its dependencies are merged into the installation Example Suppose you have a merge module that consists of a library of dat...

Page 368: ...ich you can see in Setup Editor Tables tab See ModuleDependency Table in the Windows Installer SDK Help See also Available Tabs and Pages in Merge Modules on page 365 Setting Exclusions for a Merge Module Available in merge module files WSM MSM only The Exclusions page lets you add edit and remove the exclusions for a merge module Exclusions are a way of preventing two incompatible merge modules f...

Page 369: ...e module are excluded 4 Click OK The merge module is added to the Exclusions page Note The information on the Exclusion Module Details dialog box fills the ModuleExclusion table which you can see in Setup Editor Tables tab See ModuleExclusion Table in the Windows Installer SDK Help See also Available Tabs and Pages in Merge Modules on page 365 Creating a Merge Module As a New Installation You can ...

Page 370: ... Create a WSM Windows Installer merge module project file When you work in an WSM instead of an MSM the WSM is smaller and you can set multiple options for the output of the MSM See File Types on page 68 5 Click Open The new merge module opens In Installation Expert four page groups appear showing the pages that apply to merge modules See To assemble the merge module To assemble the merge module 1...

Page 371: ...io integrated editor only When you work in the Visual Studio integrated editor you typically create a merge module as a project within a Visual Studio solution Because the merge module is synchronized with the other projects in the solution it is rebuilt every time the solution is rebuilt Use this method if the content of the merge module is frequently changing You can also create a merge module t...

Page 372: ...der named Application By default files that you add to this folder are copied to the default installation directory of the installation into which the merge module is merged Example If you merge the merge module into an installation that installs files to C Program Files Product all files you add to the Application folder will also be installed to C Program Files Product 11 If you re creating a co...

Page 373: ...ontaining the components to move and select Move Components to Merge Module The Merge Module Information dialog box appears 3 Complete the dialog box Merge Module Path Specify a full path for the new merge module Module Name Enter a name that Windows Installer and Windows Installer Editor can use internally to identify the merge module Version Enter the version of the module Windows Installer and ...

Page 374: ... author can specify values for the substitution item based on the configuration item settings See Adding a Merge Module to an Installation on page 381 Configurable merge modules are supported only by Windows Installer 2 0 or later For information on creating a standard merge module see Creating a Merge Module As a New Installation on page 369 In Visual Studio also see Creating a Merge Module Withi...

Page 375: ...etails 1 Access the Configuration Item Details dialog box from the Module Substitution dialog box See Creating a Configurable Merge Module on page 374 2 Complete the dialog box Name Enter a name to represent the item in the Configuration Items list box on the Module Substitution dialog box Display Name Enter the name that should appear on the Merge Module Configuration dialog box when the merge mo...

Page 376: ...ler SDK Help Bitfield Drop down List The installation author can select from a drop down list to replace the default value This list displays only the name you gave the value not the actual value This is useful when you provide values that are not self explanatory Use the bitfield type only on columns that are bit flags Example In the Files table the Attribute column contains bit flags representin...

Page 377: ...a Configurable Merge Module on page 374 2 Complete the Configuration Item Details dialog box See Setting Configuration Item Details on page 375 3 From Type select Text Drop down List 4 Click Add The Drop down List Value dialog box appears 5 Complete the dialog box Name Enter text to describe the substitution value The installation author sees this value in the Value drop down list on the Merge Mod...

Page 378: ... add these values and enter a bitmask of 516 5 Click Add The Drop down List Value dialog box appears 6 Complete the dialog box Name Enter text to describe the substitution value The installation author sees this value in the Value drop down list on the Merge Module Configuration dialog box Value Enter the value to be substituted for the current value of the configuration item 7 Click OK The Config...

Page 379: ...renced If Delete Unreferenced Rows is marked the default bitmap is not merged into the installation 5 From Key Table select the type of table to make available for selection for this key 6 Click OK The Module Substitution dialog box appears The values you defined for the configurable item appear in the Value field and the items appear in the Configuration Item list box 7 Click OK Example Configuri...

Page 380: ...ter long name Display Name Enter Long file name Description Enter Choose whether to use a short or a long file name for this file Type Select Arbitrary Text Default Value Enter ReleaseNotes txt 12 Click OK On the Module Substitution dialog box long_name appears in the Configuration Items list box below the pipe character Value shows the substitution options for the file name short_name long_name 1...

Page 381: ...tch changes in an update to your own application and distribute it to your end users This could cause security and timing issues for your end users To add a merge module 1 Select Installation Expert Merge Modules page 2 From Current Feature select a feature or condition Because any item you add must be assigned to a specific feature you cannot add an item when All Features is selected Items that y...

Page 382: ...the installation contains multiple features the Merge Module File Directory dialog box contains a Next button Click Next to continue The Merge Module Features dialog box appears 11 To add this merge module to other features besides the one you selected in the Current Feature drop down list select them in the list box You can select multiple features If multiple features in the installation depend ...

Page 383: ...urrent Feature select the feature or condition that contains the merge module to edit 3 Double click a merge module The Merge Module Details dialog box appears It has one tab if you double clicked a standard merge module and two tabs for a configurable merge module 4 Click the Settings tab and change the dialog box s settings as needed Module Source Path To get the same merge module with the same ...

Page 384: ...hat cannot be located on your system you are prompted to download the merge module This can happen if the installation was created on a different computer or if you have moved your merge modules directory See also Adding a Merge Module to an Installation on page 381 About Transforms A transform is a special kind of Windows Installer file MST that customizes a Windows Installer installation You use...

Page 385: ...py of that installation file opens in Windows Installer Editor where you make the changes for the transform This is the most flexible way to create a transform Example Suppose you want a transform that changes the application name changes what registry entries are installed and changes what system requirements are necessary to run the installation Because these changes affect multiple areas of the...

Page 386: ... Details dialog box See MsiCreateTransformSummaryInfo in the Windows Installer SDK Help z Base database Read only This is the MSI on which this transform is based If this transform is applied to a database other than the one specified here an error is generated during installation z Suppress Transform Application Errors The following check boxes let you suppress certain errors if the transform tri...

Page 387: ...t the version of the base MSI If the versions do not match an error is generated during installation Version Relationship If you chose to check versions specify what version relationship must be true in order not to generate an error Applying a Transform to an Installation A transform must be applied to a base MSI during installation using a command line option it cannot be applied beforehand On t...

Page 388: ... of a product code to be installed per machine and one instance to be installed per user To install multiple instances of a product without creating a separate installation for each instance you can create instance transforms to change the product code for each instance An instance transform changes the product code of an installation or patch and can isolate its data so that multiple instances of...

Page 389: ...mes the name of the transforms that is created The transform is saved in the same directory as the base installation file Change install directory to Instance Property Value Mark this to change the value of the directory property INSTALLDIR to the value in the Instance Property Value field above INSTALLDIR is the main installation directory for the application example Program Files Application Thi...

Page 390: ...her types of transforms an instance transform must be applied to a base MSI or patch during installation using a command line option it cannot be applied beforehand On the command line type the following msiexec i Application msi TRANSFORMS Instance mst MSINEWINSTANCE 1 qb where Application msi is the name of the MSI and Instance mst is the name of the transform For additional examples see Install...

Page 391: ...cialized functions You can start a tool in several ways some options are available for specific tools only z By selecting its name from the Tools menu In Visual Studio Project menu z By clicking its icon on the Tools toolbar To display the Tools toolbar select View menu Tools In Visual Studio View menu Toolbars Wise Wizards z By clicking its icon on the New Installation File dialog box which puts ...

Page 392: ...d determines which DLL OCX and EXE files were accessed It then adds these files to a new installation You can use this tool for informational purposes or to facilitate the creation of a new installation Note Application Watch cannot monitor 16 bit applications To watch an application 1 Close all other applications so that the files they access are not added to the installation 2 Select Tools menu ...

Page 393: ...re whether it is safe to deploy a file check with Microsoft developer documentation before deploying these files to end users Convert SMS Installer or WiseScript Installation Use the Convert SMS Installer or WiseScript Installation tool to convert the following types of setup programs into Windows Installer packages z Microsoft SMS IPF or EXE z WiseScript WSE or EXE See Converting an SMS Installer...

Page 394: ...ted from the EXE before the conversion can begin This becomes the source directory for the new package 5 Click Next to start the conversion The IPF or EXE is converted to Windows Installer format When the conversion is finished the Conversion Complete page appears It shows the results of the conversion and lists any errors or problems that might have occurred Example An error occurs when files tha...

Page 395: ...2003 or earlier To work with projects that were created with Visual Studio or Visual Basic 2005 or later open the project in Visual Studio and create the installation in the Visual Studio integrated editor See Creating an Installation Within a Solution on page 80 z These types of files are supported VBP VBPROJ CSPROJ VJSPROJ or SLN z When you import a solution any project types other than those li...

Page 396: ...reate a Windows Installer package from a Visual Basic Visual C or Visual J project version 2003 or earlier See Import Visual Studio Projects on page 395 To start the import in the Wise editor 1 Do one of the following Select File menu New On the New Installation File dialog box select Import Tools from the Categories list and in the Templates Tools list double click the type of project to import T...

Page 397: ... and pages might appear If the project is out of date or missing a prompt appears You can try to rebuild the project from this tool or open the development environment and rebuild the project from there If the project has a reference to another project an error message appears and the import ends Restart the import and select the solution file SLN that contains both projects If dependency files DE...

Page 398: ...he installation See Assembly Dependencies on page 138 If a file that is part of a merge module is added the Files in Merge Modules dialog box appears It prompts you to add the merge module and if necessary download it See Adding Merge Modules Instead of Files on page 132 Requires a repository connection If a file that is used by a package in the Wise Software Repository is added the Files in Repos...

Page 399: ...nage Assembly Exclusions tool the Manage Assembly Exclusions dialog box lists all the dependencies that are in the exclusion list for the current installation You can uncheck the check box next to a dependency to remove it from the exclusion list so that it can appear in future assembly scans See Removing Dependencies from the Project Dependency Exclusion List on page 398 MSI to WSI Conversion Use...

Page 400: ...n an MSI If a message appears asking you to convert this Windows Installer database to a Wise project file click Yes Otherwise select Tools menu MSI to WSI Conversion In Visual Studio Project menu MSI to WSI Conversion The Welcome page appears 3 In New Source Directory specify the directory to which all files and merge modules in the MSI will be extracted In the converted WSI file all source paths...

Page 401: ...ge modules on your computer to replace the merge modules in the MSI The merge modules you select on your computer must have identical GUIDs as those you are replacing z Search Module Directories Search for merge modules by GUID in all the merge module directories defined in Wise Options z Reset to Default After changing the source path through any of the above methods you can reset a merge module ...

Page 402: ... unique identifier attached to Windows Installer files rather than by name The first found instance is used The Source column changes to Local to indicate that local merge modules will be used instead of merge modules from the MSI If the search is unsuccessful a dialog box lists the merge modules that were not found 3 Complete the MSI to WSI Conversion wizard Specifying File Source Directories Dur...

Page 403: ... directory you select Example Suppose you are repackaging Application msi and you have it installed in C Program Files Application you would select the C drive then select Selected Directory Contains Destination Directory Structure and click OK If you selected the Application directory itself it would result in searching C Program Files Application Program Files Application because the Destination...

Page 404: ...s based on rules in one or more validation modules It validates installation files MSI and WSI merge modules MSM and WSM and transforms MST When you select a transform Package Validation checks both the transform and the original MSI If you correct validation errors in a WSI or WSM the file is recompiled to an MSI or MSM at the end of validation If you correct validation errors in an MSI or MSM er...

Page 405: ...release to test 6 To customize or create validation modules click Customize See Customizing Validation Modules on page 406 7 Click Next to start testing The Performing Validation page appears Note The Windows Vista Compatibility Checks validation module takes longer to run than others due to the nature of its validation checks When the validation is complete the View Correct page appears It lists ...

Page 406: ...Add to Task List When you click Finish the issues appear in the Task List 12 To obtain a record of the issues click Save to File or Print All 13 Click Finish See also Package Validation on page 404 Windows Vista Windows 7 Validation on page 409 Using the Task List on page 26 Customizing Validation Modules A validation module is a CUB file that contains one or more validation rules A validation rul...

Page 407: ...Windows 2000 logo verification program The tests in logo cub are a subset of the tests in darice cub therefore running both tests at the same time might result in duplicate errors z Windows XP Application Specification Logo Runs XPlogo cub which is provided by Microsoft as part of its Windows XP logo verification program The tests in XPlogo cub are a subset of the tests in darice cub therefore run...

Page 408: ...ared with other applications that do not use Windows Installer z Files installed to Program Files by default Checks that all application files are installed to a subdirectory of Program Files z Terminal Server Compatibility Checks for errors that might cause problems when the package is installed in a Microsoft Terminal Services or Citrix environment With terminal service applications installation...

Page 409: ...fy the full path to WiseVistaIce cub Example C Program Files Symantec Wise Installation Studio bin getwrpitems exe C Program Files Symantec Wise Installation Studio Windows Installer Editor Validation wisevistaice cub The GetWRPItems exe utility deletes the contents of both tables and rebuilds them based on the WRP information on your computer Because the edition of the Windows Vista or later oper...

Page 410: ...lation has a missing or broken source path but the file should remain in the installation you must fix its source path before you can compile successfully Do either of the following z Select Installation Expert Files page a In the lower left list box navigate to the directory that contains the file b In the lower right list box double click the file to display the File Details dialog box c On the ...

Page 411: ...n Keys to using Wise Task Manager z The tasks for each operation form a group and every other group of tasks is shaded to distinguish the groups z A task can have one of six statuses Canceled Completed Executing Failed Waiting or Warning z A Warning status means the task completed but an error message was written to the task s log file z If a task fails Wise Task Manager moves to the next task z W...

Page 412: ...ll users Mark this to display the tasks for all managed operations run by all users who are using the same share point directory Show tasks from the last Select the time period of the tasks to display Show only the tasks with the following statuses Mark the statuses of the tasks to display b Click OK 4 To cancel a task select the task and click Cancel Tasks You can cancel only tasks belonging to o...

Page 413: ...ion Expert However there are certain advanced tasks that you can perform in Setup Editor only z Edit the text on installation dialog boxes z Create components and assign them to features z Build complex conditions that must be met for installation to occur z Select dialog boxes to appear during maintenance installations uninstalls z Edit the raw table data of the Windows Installer database Note Th...

Page 414: ...alogs Select and customize dialog boxes the installation uses See Using the Dialogs Tab on page 456 Tables Edit tables in the MSI database You can access most of the data in these tables through Installation Expert pages or other tabs of Setup Editor Deleting adding or editing table data directly is not recommended unless you are an experienced Windows Installer developer with a clear understandin...

Page 415: ...mary information by right clicking the compiled MSI or EXE in Windows Explorer and selecting Properties See Specifying Summary Information on page 416 Properties Use the Properties icon to add edit and delete properties in an installation Properties are variables that are initialized by the installation and are used by Windows Installer The property values can change during run time Some of the pr...

Page 416: ...ars in the upper right pane and you can edit an item by changing its value You cannot create or delete summary items because they are defined by Windows Installer The following summary items are named differently in the Windows Installer SDK Help The Template Summary determines the target platform of the compiled MSI See How to Specify the Target Platform on page 71 To set the value of a summary i...

Page 417: ...in a feature click the feature s Combined icon All items appear in the upper right pane z To display all items in a feature grouped by type expand the feature s Combined icon and click the type icon z To expand or collapse a selected feature s children use the right click menu z To customize how items appear in the features tree right click in the left pane and select Customize View In the Customi...

Page 418: ... file entry See Creating Duplicate File Entries on page 421 Environment variable See Adding an Environment Variable on page 176 File association See Advertising Icon on page 420 See Adding File Associations on page 176 File See Adding Files to an Installation on page 130 INI file See Creating and Editing INI Files on page 171 ODBC source driver or translator See Adding an ODBC Item on page 182 Reg...

Page 419: ...ins the component to unassign 2 Click the Components icon All components for the feature appear in the upper right pane 3 In the upper right pane right click a component and select Unassign Components that are not assigned to any feature are not installed on the destination computer To move a component to a different feature 1 In Setup Editor Features tab expand the folder for the feature that con...

Page 420: ... view and edit AppID and ProgID information Advertisement which is a way to deploy applications in large organizations is available with Windows Installer but only for supported platforms See Advertisement and Platform Support of Advertising in the Windows Installer SDK Help To view or edit AppID or ProgID information 1 In Setup Editor on the Components or Features tab expand the Advertising icon ...

Page 421: ...lder entry appears in the upper right pane 5 You can add permissions to the new folder See Setting Permissions for Files and Directories on page 147 See also Installation Directories on page 128 Features Tab on page 417 Creating Duplicate File Entries Duplicate files are files that must be copied to more than one location during installation According to Windows Installer rules you cannot install ...

Page 422: ...e If you do this then any future changes to the component will affect all features to which it is assigned To edit a duplicate file entry double click its name To delete it right click its name and select Delete See also Features Tab on page 417 How to ensure the installation of a duplicate file on page 422 How to ensure the installation of a duplicate file If a duplicate file is in more than one ...

Page 423: ... upper right pane You also can expand the component so that its contents appear in the components tree z To expand or collapse a selected component s children use the right click menu z To customize the icons that appear in the components tree right click in the left pane and select Customize View In the Customize View dialog box that appears mark the check boxes of the items to display and rearra...

Page 424: ... See Advertising Icon on page 420 See Adding File Associations on page 176 File See Adding Files to an Installation on page 130 INI file See Creating and Editing INI Files on page 171 Isolated component See Isolating a DLL With an EXE on page 429 ODBC source driver or translator See Adding an ODBC Item on page 182 Published component See Adding Published Components on page 430 Registry key See Add...

Page 425: ...he Multi Component Details dialog box you can edit a subset of the fields found in the Component Details dialog box z To delete or rename a component use the right click menu To add a new component 1 In Setup Editor Components tab right click and select New Component The Component Details dialog box appears 2 Complete the dialog box Component Enter a name for the new component Components generated...

Page 426: ...llation This setting overrides the corresponding feature s attribute Run from Source or Locally The component takes on the feature s attribute Key Path Type Select the type of item Windows Installer should use as a key path File Key Path Use a file as the component s key path Registry Key Path Use a registry entry as the component s key path ODBC Data Source Key Path Use an ODBC data source as the...

Page 427: ...ter key path file before compile Mark this so that each time you compile the file referenced in the Key Path field is re registered the registration information is rescanned and any new information is added to the installation If you clear this check box then the file is not self registered instead registration information is scanned from its type library and added to the installation Registering ...

Page 428: ...ent to another The procedure below works for all types of items and also warns you when a key path must be changed For files and registry entries you can drag between components but you are not warned if a key path is changed To move items between components 1 In Setup Editor Components tab navigate to an item so that it appears in the upper right pane 2 In the upper right pane select one or more ...

Page 429: ...e EXE even if the destination computer already has a DLL with the same name installed See Isolated Components in the Windows Installer SDK Help Add the DLL to the System32 directory as you normally would and then create an isolated component that moves the DLL to your application s directory Note Before you isolate a DLL with an executable make sure that you have added all files to the installatio...

Page 430: ...ID globally unique identifier for this component with a new one click Generate Feature Select the feature to have published Component Select the component to have published Qualifier Enter a text string to distinguish multiple forms of the same component Application Data Enter a text string that describes the qualified component that is the combination of component and qualifier This string can be...

Page 431: ...damage to the installation We cannot provide technical support for problems arising from table editing Tables tab in Setup Editor Working with tables By default the left pane of the Tables tab lists all the tables in the Windows Installer database even those that don t contain data z To hide empty tables right click in the left pane and select Show Empty Tables To redisplay the empty tables right ...

Page 432: ...ation Errors on page 435 Editing Binary Data in the Icon Table on page 436 Creating a New Table Warning Deleting adding or editing table data directly is not recommended unless you are an experienced Windows Installer developer with a clear understanding of Windows Installer database technology Editing table data might cause unexpected undesirable behavior including damage to the installation We c...

Page 433: ... column is linked to the File column in the File table Category Select the type of information stored in this column Description Enter a short text description of the information stored in this column 5 Click OK on the Field Definition dialog box 6 Continue to add fields as needed 7 On the Create Table dialog box click OK to add the table See also Tables Tab on page 430 Creating a New Row in a Tab...

Page 434: ...or editing Example The drop down list for the Feature_Parent column in the Feature table lets you select a new parent for the current feature Drop down lists for columns that contain formatted data type show the properties from the Property table You can either select from the list or enter a new property To delete a row from a table In Setup Editor Tables tab in the upper right pane right click a...

Page 435: ...ecomes a task in the Task List You can use the Task List to review the errors see Using the Task List on page 26 or you can click a red table name and use the Find Error menu item to find the row that contains the error See the following procedure To find individual validation errors in a database 1 In Setup Editor Tables tab right click and select Find Error The Find dialog box appears 2 In the D...

Page 436: ... to the installation We cannot provide technical support for problems arising from table editing To edit binary data 1 In Setup Editor Tables tab click the Icon table The table s data appears in the upper right pane You can change the data in the Name fields as you would in any other table 2 In the Data column click a binary field displayed as binary data and press F2 or Enter The Edit Binary Data...

Page 437: ...lation conditions are already created throughout the installation where appropriate You often use properties inside conditions Properties are named values that are any of the following z Predefined in Windows Installer Editor z Defined by Windows Installer by you in the installation file or by the end user during installation z Based on the system configuration of the destination computer See Prop...

Page 438: ... 800 x 600 in order for the installation to proceed ScreenX and ScreenY are Windows Installer properties that are set according to the screen resolution on the destination computer See ScreenX Property and ScreenY Property in the Windows Installer SDK Help Conditions for controls on dialog boxes In Setup Editor Dialogs tab you can use conditions with dialog box controls Controls are the items that...

Page 439: ...nditions to the Features page and add items to the conditions using the Current Feature drop down list at the top of Installation Expert pages then some of the components on the Components tab will have conditions set Note If you add a component condition that checks the installed state of a component or feature add the merge module CondFix msm to the installation This merge module fixes a Windows...

Page 440: ...h parentheses z Arithmetic operators and floating point numeric values are not supported For details see Conditional Statement Syntax in the Windows Installer SDK Help Examples of Conditions You can build conditions using property names environment variables and feature and component states Conditions can contain both Windows Installer properties and properties that you create A complete list of W...

Page 441: ...Features on page 119 Creating Conditions With Condition Builder Use the Condition Builder to build conditions that test the installed state of components and features and the value of properties and environment variables You can access the Condition Builder from different areas of Windows Installer Editor See Where Can You Use Conditions on page 437 Condition Builder dialog box Operator buttons Mo...

Page 442: ...on on page 444 z State Use this list only to check the installed state of a component or feature Action refers to what occurs during installation and Installed refers to the current state of the destination computer z Install Action state Use this list only to check the installed state of a component or feature Absent means the feature or component is not installed Advertised means it is advertise...

Page 443: ... Environment Variable Environment variables are system or end user variables that are set by the operating system running on the destination computer They contain values specific to that computer Note This procedure lets you check the value of an environment variable To read the value of an environment variable into a property use the Set Property type of custom action Enter ENVIRONMENT_VARIABLE_N...

Page 444: ... component 4 In the State list double click Installed 5 Click the button 6 In the Install Action state list double click one of the following to check the current installation state of the feature or condition Absent Not installed Advertised Installed in an advertised state Local Installed locally Source Installed to run from installation source When you finish a condition appears in the condition...

Page 445: ...n appears in the condition list box Based on the choices you make the appropriate Windows Installer codes are inserted Example Complete 3 7 Click OK Properties Properties are variables that are used by Windows Installer during installation You often use properties inside conditions You can hard code the value of a property but you can also make properties more flexible by manipulating them at run ...

Page 446: ...attach properties to controls on dialog boxes which puts the results of the control into the property Then use the property in a condition Example In Setup Editor Dialogs tab the Installation Type dialog has a set of radio buttons The radio buttons are associated with a property named InstallMode and based on the value of InstallMode the Next button displays a different dialog box Double click the...

Page 447: ... new property search the Windows Installer SDK Help to make sure the property name is not already used by Windows Installer See Property Reference in the Windows Installer SDK Help To create a new property 1 In Setup Editor Product tab right click the Properties icon and select New Property The Property Details dialog box appears 2 Complete the dialog box Name Enter a name for the property Propert...

Page 448: ...rty Do this if the installation is to be performed on locked down Windows computers and you want the ability to change and pass its value from the UI Sequence to the Execute Sequence See Restricted Public Properties in the Windows Installer SDK Help This is unavailable if you entered any lowercase letters in the name 3 Click OK The property is added to the list of properties initialized by this in...

Page 449: ...ools for editing the appearance as well as the behavior and logic of installation dialog boxes You can access dialog boxes from the following places z Dialogs page Installation Expert The dialog boxes on the Dialogs page are those in the Welcome Dialog Wizard which appear to the end user during a normal installation Turn the dialog box boxes on or off rearrange them view conditions and select the ...

Page 450: ...t Installation Modes on page 492 See also About Installation Sequences on page 495 Types of Actions in MSI Script Sequences on page 496 About the Wizard Dialogs on page 450 Using the Dialogs Page on page 452 Using the Dialogs Tab on page 456 About the Wizard Dialogs Some dialog boxes in the Welcome Dialog Wizard are probably familiar to you because they appear in almost all installations Others on...

Page 451: ...ers this dialog box appears and lets the end user specify which Palm users should be able to access the new Palm application For additional criteria for displaying this dialog box see Installing to the Palm User folder on page 248 SQL Connection dialog Appears in installations that are started from the Server Application template in the New Installation File dialog box It lets end users select a S...

Page 452: ...t has more options which are documented below If the installation was created in earlier versions it has fewer options and contains a Convert button Using the Convert button The Convert button converts the button navigation to a more flexible and robust system which facilitates changing the order of dialog boxes However converting may cause problems with legacy installations if you have extensivel...

Page 453: ...ld only be moved as a group See Changing the Order of Web Dialogs on page 456 To add a dialog box Click the Add button and complete the wizard See Creating a New Dialog on page 460 To turn off all installation dialog boxes Do one of the following z Use a silent installation See User Interface Levels in the Windows Installer SDK Help z In Setup Editor Dialogs tab clear the check box next to Welcome...

Page 454: ...fault Theme on the Dialogs page Changing the theme on one page changes it on the other Renaming or deleting the Default release breaks this relationship See Creating a New Release on page 207 Adding and Editing Dialog Themes The theme controls the overall look of installation dialog boxes by setting their top or side images and the fonts of the dialog box text You can edit themes and create custom...

Page 455: ...ettings do not control the font for the title of the Welcome dialog or any other dialog boxes that have a side image The Main Font settings control the font for the rest of the text on the dialog boxes You cannot edit the font of individual sections of a dialog box from the Edit Themes dialog box If you create a new theme and do not set the fonts for that theme it uses the default font settings in...

Page 456: ...ust be moved as a group Use the Move Up and Move Down buttons to move the group of Web dialog boxes Warning Do not edit the Web IIS dialog boxes except to change their order as a group in the installation sequence Editing the Web dialog boxes might cause unexpected undesirable behavior including damage to the installation Also any operation within this product that affects the installation s user ...

Page 457: ... resources then it might contain Web IIS dialog boxes Only enable or disable the Web dialog boxes as a group Enabling individual Web dialog boxes can prevent the installation from working properly To edit dialog box details and attributes Right click the dialog box name in the left pane and select Details See Editing Dialog Details on page 458 Warning If you are using the Installation Types page t...

Page 458: ...menu Add and then select the type of control to insert If the controls in the Add menu are unavailable click the dialog box to make it active and try adding the control again In Visual Studio select View menu Toolbox and on the toolbox double click the type of control to insert Depending on the type of control you select a Properties dialog box appears so you can configure the control s properties...

Page 459: ...X and Y Centering Enter X and Y values from 1 to 100 to indicate where on the screen the dialog box should be centered Values of 50 in both fields mean that the dialog box should be exactly centered on the screen If the Y Centering value is set to 33 the center of the dialog box will be 1 3 of the way from the top of the screen z Visible Mark this to make the dialog box visible z Minimize Button M...

Page 460: ...alog boxes available in each new installation open Wise Standard msi and add the dialog boxes to the All Dialogs branch on the Dialogs tab The location of the Templates subdirectory varies See Installation Resources and Their Locations on page 32 2 Select the type of dialog box and click Next The Dialog Properties page appears 3 Edit any values by clicking the item in the Type column and then clic...

Page 461: ...ate the control with a property whose value is not defined null Example Suppose you create a check box and you want the check box to be initially cleared In the Properties dialog box for the check box click the New button next to the Property field create a new property named CHECKBOX1 and leave its value blank Although this results in error messages during compile which you can safely ignore it e...

Page 462: ...roper type of character numeric or alpha for others You can enter certain characters in the Control Text field of the Masked Edit control to constrain which characters can be used at each character position of the control See MaskedEdit Control in the Windows Installer SDK Help Path Edit A single line input field that accepts only a valid path This is intended to be used in conjunction with the di...

Page 463: ...ntrol on page 468 To see the results of these settings compile and run the installation Basic Control Settings The Control tab which appears on the Properties dialog box for dialog controls determines the appearance and basic behavior of controls See Editing Dialog Controls The settings available on this tab vary depending on the type of control z Property The name of the property associated with ...

Page 464: ...fine a new font style add a new row to the TextStyle table in Setup Editor Tables tab Then create a new property and enter the new text style s name surrounded by curly brackets as the property value z Control Font You can click Set Font and select a font for the control The Font Property field if set overrides this field z X Position Y Position The location of the control within the dialog box Th...

Page 465: ...e set to a number in units of 512 bytes KB MB or GB is added to the end of the text depending on how large the number is z No Prefix Displays any ampersand characters in the control s text Otherwise characters do not appear and cause the next character to be underscored z Users Language Makes the text control use fonts created in the end user s default UI codepage If this is cleared the fonts are ...

Page 466: ...e z Elevation Shield Adds the Windows Vista shield icon User Account Control elevation icon to a pushbutton control Setting an Event on a Control The Events tab which appears on the Properties dialog box for dialog box controls determines the events that the control can send and receive See Editing Dialog Controls on page 463 Use events to control the display of other dialog boxes and to control t...

Page 467: ...l events Control Events for details on each control event z Attributes Select an attribute that should be set for the control when the subscribing control receives the ControlEvent For information on valid attributes see Control Attributes in the Windows Installer SDK Help Assigning Help to a Control The Help tab which appears on the Properties dialog box for dialog box controls lets you set toolt...

Page 468: ...ng the number of colors in its palette its width and height and its size z Preview Displays the image If necessary the image is scaled down to fit in the preview area Setting the Items in a Control The Items tab which appears on the Properties dialog box for list box controls comboboxes listview controls and radio button controls determines the items that are listed in the control It also lets you...

Page 469: ... X Position Y Position The location of the item within the control The upper left corner is represented by X Y values of 0 0 To rearrange items within the control example to reorder the items for radio buttons change the Y position z Width Height The size of the control in installation units which are equal to 1 12 the height of the system font on the destination computer Organizing and Aligning C...

Page 470: ... layer it will be See Setting Dialog Tab Order on page 472 Example On the sample dialog box shown below the image covers most of the dialog box and is overlapped by text and check box controls Because the graphic and static text controls are not included in the tab order they might be layered over the check box control at run time Incorrect tab order on a dialog box Aligning Dialog Controls You ca...

Page 471: ...rols the Same Size You can make multiple controls on a dialog box the same size To make dialog box controls the same size 1 In Setup Editor Dialogs tab select a dialog box in the left pane 2 In the right pane select two or more controls The last control you select is the master control that the other controls will be sized to 3 Select Layout menu Make Same Size and then select one of the following...

Page 472: ...box click the controls in order Each control turns blue as its new tab order is assigned If the first several items have the correct tab order and you want to begin renumbering the tab order at a later number hold down the Ctrl key and click the control after which you want to renumber Example If controls 1 through 7 have the correct tab order and you want to start renumbering from 8 press Ctrl an...

Page 473: ...ller does not support the display of billboards outside installation dialog boxes Adding Billboards to a Dialog In the following steps bitmaps icons and text controls are referred to as content items To add billboards to a dialog box 1 Select Setup Editor Dialogs tab 2 In the left pane select the Progress dialog under Install Dialogs By default the Progress dialog contains a billboard which is rep...

Page 474: ...one or more billboard controls a Right click the dialog box and select Billboards New The Billboard Details dialog box appears b Complete the dialog box Name Enter a descriptive name for this control Feature Select a feature from the list This control s content item only appears during installation if this feature is installed Action Select an action from the list We strongly recommended that you ...

Page 475: ...tent items you can resize the Progress dialog box itself to accommodate them Also you might need to resize bitmap items for them to display correctly 6 To preview the billboard select each billboard in order from the Billboard submenu of the right click menu 7 To see the billboard work compile and run the installation Note Billboards do not appear when you test the installation This is because fil...

Page 476: ... you can add the Logon Information dialog box by using the New Dialog Wizard in Setup Editor Dialogs tab In the Wise editor To create a new installation that contains the Logon Information dialog box 1 Select File menu New 2 In the Categories list select Predefined Templates 3 In the Templates Tools list select Server Application and click OK 4 In Setup Editor Dialogs tab select the Logon Informat...

Page 477: ...the Microsoft SQL Server logon mechanism prevents this from working See also Adding a Service to the Destination Computer on page 179 About Web Installations on page 266 Obtaining Logon Information From a Dialog on page 475 About the SQL Connection Dialog Add the SQL Connection dialog box to an installation to z Let the end user select a SQL Server name and security credentials to generate a valid...

Page 478: ...on templates contain the SQL Connection dialog box For all other installations you can add the SQL Connection dialog box In the Wise editor To create a new installation that contains the SQL Connection dialog box 1 Select File menu New 2 In the Categories list select Predefined Templates 3 In the Templates Tools list select Server Application or Web Application and click OK 4 In Setup Editor Dialo...

Page 479: ... page 478 2 On the Dialog Properties dialog box of the New Dialog Wizard edit the dialog box s default control properties Example Edit the dialog box s control properties as follows 3 Finish the New Dialog Wizard 4 In Setup Editor Dialogs tab select SQL Connection Dialog1 in the left pane 5 In the right pane edit the Argument of the WiseSqlParam event for the Browse and Next buttons using the new ...

Page 480: ...multiple Custom Property dialog boxes then multiple identical dialog boxes appear to the end user at run time To add the Custom Property dialog box 1 Select Installation Expert Dialogs page 2 Click Add The New Dialog Wizard appears See Creating a New Dialog on page 460 3 On the Select Dialog Type page select Custom Property Dialog and click Next 4 Leave the defaults on the Dialog Properties page a...

Page 481: ...value a second time to verify the entry This also omits the property value from the installation log Use this feature when the property value includes sensitive information example a password 6 Finish the New Dialog Wizard The Custom Property dialog box now appears in the list of dialog boxes on the Dialogs page When you run this installation the Custom Property dialog box appears To edit the prop...

Page 482: ...nts About Macro Files Use the Macro Editor to create and edit macro files The default macro file in the Templates folder Macros wbs contains sample macros These samples are commented out which means that you can view the script in the Macro Editor but you can t run the macros unless you uncomment the script You can add macros to Macros wbs and edit and delete its macros Each new file you start in ...

Page 483: ...ro Is Run Select Manually to create a manually run macro On Windows Installer Editor event to create a macro that runs on an event Event Name For a manually run macro enter a name for the new macro Do not include spaces in the name For an event macro select an event Pathname When you create a new macro it is added to the macro file displayed To add the new macro to a different WBS file browse to t...

Page 484: ... File menu Save 7 Exit the Macro Editor To run a macro manually 1 Do one of the following Wise editor only Select Edit menu Macros Visual Studio integrated editor only In MSI Script right click in the Installation Sequence pane and select Macros The Macro dialog box appears 2 From Macro Is Run select Manually 3 In the list box select the macro to run If the macro is in a file other than the one sh...

Page 485: ...playValidation Have Package Validation not display certain ICE error messages To do this set the variable bDisplay to FALSE for that error QueryFixValidation Have Package Validation determine if an ICE error is fixable and supply code to fix it It is first called when bCheckOnly TRUE If bFix is set to TRUE it determines that the error is fixable and the Correct button on the Package Validation Vie...

Page 486: ...drop down lists along the top of the script box The drop down list on the left lets you select the type of macro General for manually run macros and WFWIEvents for event macros The drop down list on the right lets you select corresponding macros Members Is context sensitive and gives you properties and methods in the context of a clicked object If your pointer is not on an object when you select t...

Page 487: ...n change to see how they affect the installation Example You can test a radio button s conditions by changing its current values or change the current value of an installation directory The debugger does not fix problems in the installation Once you have used the debugger to test the installation use Windows Installer Editor to make the appropriate changes in the MSI WSI or MST file You cannot edi...

Page 488: ...ller Editor open the WSI MSI or MST to debug 2 Click the Debug button at the lower right of the main window In Visual Studio In Solution Explorer right click the installation project icon and select Set as Startup Project Then select Debug menu Start Table List Lists all the tables in the installation in a window named _Tables To open a table double click its row in the Table List Move from one op...

Page 489: ...r Windows Installer Step Over runs VBScript actions but does not open the VBScript Debugger Run to a selected action Select the action then select Debug menu Run to Selection This executes all the actions up to the selected action After the actions are processed the arrow moves to the selected action and the debugger waits for another command 5 To stop the installation select Debug menu Stop Debug...

Page 490: ...gger for Windows Installer the Windows Installer runtime creates a temporary table named _Property and adds temporary columns to the Component Feature and File tables The fields in these temporary columns represent the current values of directories user defined properties and Windows Installer properties This is where you do most of your debugging Stop the installation to view a particular value a...

Page 491: ...at you do not delete or move any standard actions See Standard Actions Reference in the Windows Installer SDK Help The existing action sequences are sufficient for most installations If you need specialized functionality not offered by Windows Installer you can add custom actions to an installation With custom actions you can call EXEs DLLs WiseScripts JScripts and VBScripts You can set installati...

Page 492: ...F1 z Restricted Areas If you select an action that has restrictions on its placement the restricted area is shaded z Sequences Below the sequence area are tabs that let you switch between sequences Each installation mode is comprised of sequences which in the Windows Installer database correspond to sequence tables About Installation Modes MSI Script contains three installation modes Normal Instal...

Page 493: ...f the installed application End users who have access to the administrative installation can then install the application from the network location To run an administrative installation use the command line option a Example msiexec a C path Sample msi An administrative installation uses the Admin Dialogs See also Performing an Administrative Installation on page 317 Command Line Options in the Win...

Page 494: ...installation 3 In the Actions list double click the action 4 Complete the Details and Properties tabs as you would normally If the action does not have these tabs then you cannot add it outside a sequence 5 On the Location tab mark No Sequence This tab is only available in the All Custom Actions mode 6 Click OK Adding a Custom Action to Multiple Sequences When you copy and paste an action between ...

Page 495: ...es all the actions between InstallInitialize and InstallFinalize It is represented by the Execute Deferred tab This makes it easier to specify in which mode to run an action For information on where to place a custom action see Guidelines for Custom Action Location on page 505 When Windows Installer generates the installation script it generates a rollback script that will undo the actions of the ...

Page 496: ... 498 About MSI Script on page 491 Types of Actions in MSI Script Sequences z Windows Installer standard actions gray These built in actions are defined by the Windows Installer SDK Double click a standard action in the Installation Sequence list and press F1 to access the Windows Installer SDK help for the action These actions perform basic installation tasks such as creating shortcuts and writing...

Page 497: ...on Sequence list The new action appears before the line that is highlighted when you drop the action z Double click the action In the Installation Sequence list select the line above which the new action should appear and double click the action in the Actions list z Type and select the action In the Installation Sequence list select the line above which the new action should appear Type the first...

Page 498: ...Calling WiseScripts with Custom Actions The Run WiseScript custom actions provide the ability to call WiseScripts WiseScript technology provides many specialized functions that are not available in or are difficult to do with Windows Installer technology In a WiseScript you can use special actions that let you pass information between the main Windows Installer installation and the WiseScript EXE ...

Page 499: ...ing a WiseScript to Install a License File on page 500 z Uninstalling Changes Made by a WiseScript on page 501 Using a WiseScript to Parse a Path Because the Microsoft Windows Installer technology does not allow for parsing you cannot use it to create an installation that extracts a path from the registry and then parses the path to isolate the file name into a property However you can send the pa...

Page 500: ...two editions Regular and Super Serial numbers for the Regular edition begin with the letter R and serial numbers for the Super edition begin with S The serial number the end user enters during installation determines the license file that gets installed which determines which features are turned on You set up the installation to have the license files installed by the WiseScript instead of the MSI...

Page 501: ...t is run from your MSI Example You can use the Install File s script action to add files or you can use the Edit Registry script action to add edit or delete keys or values in the registry However the Windows Installer installation does not recognize any changes the WiseScript makes to the system and therefore will not uninstall any of these changes during uninstall of the main Windows Installer i...

Page 502: ...pt looks like this the script lines are numbered for clarity 1 If NOT Installed then 2 Run WiseScript From Installation C Plus CorePlus EXE 3 End 4 If REMOVE ALL then 5 Execute Program From Destination INSTALLDIR unwise32 exe S install log Default Directory Program Files Core 6 End In the CorePlus WiseScript do the following 1 Add a Get Windows Installer Property script action and set the followin...

Page 503: ...stall File C Plus A dll to MAINDIR A dll Troubleshooting When WiseScript Custom Actions Fail on Windows Vista or later The User Account Control UAC that was introduced with Windows Vista provides a temporary privilege elevation model When a program requires elevated privileges an administrator is prompted for approval and a standard user is prompted to provide administrator credentials Even if you...

Page 504: ...ws Installer to install a file it takes care of the repair and management of the file When you use a custom action to change an installation you take Windows Installer out of the loop Example If you use a custom action to install a file you must also include custom actions to repair or uninstall the file because Windows Installer is unaware of the file Therefore use custom actions conservatively w...

Page 505: ... of Windows Installer Installations on page 200 Correct Sequence If the action does this Place it in this sequence Gathers input from an end user User Interface Needs to change properties User Interface or Execute Immediate Is an Install MSI custom action Execute Immediate Is to be executed sometime during the installation of files Execute Immediate or Execute Deferred Place it between the Install...

Page 506: ...or Custom Action Conditions Place a custom action between conditional If Statements to run it only if a certain condition is true A condition can check whether the product is installed the value of a property is true if specific system requirements are met and more See Conditions on page 437 and Conditional Statement Syntax in the Windows Installer SDK Help To Run Only During Initial Installation ...

Page 507: ...sted installation and set its condition to NOT Installed Custom Action Location dialog box Set the second custom action to call the nested installation also set its Property Settings field to REMOVE ALL Custom Action Target dialog box and set its condition to REMOVE All With this type of custom action you can call only Windows Installer installations To call an installation that was created with a...

Page 508: ...ssion From within your DLL you must use Windows Installer function calls to access the current installer session and database properties Also the return value for the DLL is limited to a constant specifying whether the DLL call was successful See Custom Action Return Values in the Windows Installer SDK Help Your function declaration statement should look something like this UINT__stdcall CustomAct...

Page 509: ...u have Microsoft Visual Studio installed z You are using one of the Call Custom DLL custom action types z MSDEV EXE is in your path for debugging To enable debugging use Setup Editor Product tab to set the property named _WiseDebugMode to 1 Then test or run the installation Microsoft Visual Studio opens and attaches to the installation process and a breakpoint is invoked near the start of your DLL...

Page 510: ...rred sequence On the custom action s Properties tab set the In Script Options drop down to Deferred Execution System Context z Make sure the custom action name is unique To quickly survey your custom actions select All Custom Actions from Installation Mode z Does the custom action reference a Windows Installer property such as REMOVE Windows Installer standard actions set Windows Installer propert...

Page 511: ...t From Embedded Code on page 521 z Call VBScript From Installation on page 521 z Call VBScript From Installed Files on page 522 z Call VBScript From Property on page 523 z Display Message on page 523 z Download File From Internet on page 524 z End Statement on page 525 z Execute Program From Destination on page 525 z Execute Program From Installation on page 526 z Execute Program From Installed Fi...

Page 512: ...e custom actions let you add extensive functionality to an installation without having to write the code yourself For technical details on custom actions see Custom Actions in the Windows Installer SDK Help For help using the MSI Script interface see The MSI Script Window on page 492 Call Custom DLL From Destination This custom action calls a DLL file that already resides on the destination comput...

Page 513: ...or select a property name The return value of the function call will be put into this property In the Execute Immediate or User Interface sequences only you can send Windows Installer properties to the DLL function as parameters See Configuring DLL Parameter Settings on page 515 See also Guidelines for Calling DLLs on page 508 Guidelines for Custom Action Location on page 505 Using the Custom Acti...

Page 514: ...st specify the parameters to send to the DLL z Return Value Type Select the data type of the return value that is returned from the DLL z Returned Property Type or select a property name The return value of the function call will be put into this property In the Execute Immediate or User Interface sequences only you can send Windows Installer properties to the DLL function as parameters See Config...

Page 515: ...t can contain numbers and periods It must not match the name of any Windows Installer standard action See Standard Actions Reference in the Windows Installer SDK Help z DLL File Specify a DLL file to call during installation It must have already been added to this installation z Function Name Type the name of the function within the DLL file to call z Parameter List In the parameter list specify t...

Page 516: ...staller property a constant or a constant with a NULL value When you select a value source the appropriate field below becomes enabled z Property Name If you selected Property in Value Source enter or select a Windows Installer property here to send as a parameter This only works in the Execute Immediate or User Interface sequences z Constant Value If you selected Constant in Value Source enter a ...

Page 517: ...ustom Action Type 1 in the Windows Installer SDK Help Call DLL From Installed Files This custom action calls a DLL file that is installed by this installation Use this if the DLL should remain on the destination computer after installation Tips z You cannot send a variable parameter list to the DLL You can send only the handle to the installation which means the DLL must be written specifically fo...

Page 518: ...name of any Windows Installer standard action See Standard Actions Reference in the Windows Installer SDK Help z Run Script in Win64 Process 64 bit installations only Mark this if the script needs to access 64 bit functionality and run in a 64 bit process z Enter the JScript to execute Type or paste the script text Code elements such as function names declarations and values are color coded You ca...

Page 519: ... VBScripts and JScripts on page 507 Guidelines for Custom Action Location on page 505 Using the Custom Action Properties Tab on page 542 Using the Custom Action Location Tab on page 539 Custom Action Type 5 in the Windows Installer SDK Help Call JScript From Installed Files This custom action runs code from a JScript file that is installed by this installation Use this to call the script file duri...

Page 520: ...script needs to be generated dynamically based on end user input or system configuration Tips z The script is limited to 32 Kb which is the size limit for Windows Installer properties z Use the script to read and write properties to the installation z The destination computer must contain the script s runtime Usage Double click the custom action and complete the Details tab z Custom Action Name En...

Page 521: ...ly Mark this if the script needs to access 64 bit functionality and run in a 64 bit process z Enter the VBScript to execute Type or paste the script text Code elements such as function names declarations and values are color coded You can use bracketed property names table keys environment variable references and other special substrings See Formatted in the Windows Installer SDK Help See also Gui...

Page 522: ...BScript From Installed Files This custom action runs code from a VBScript file that is installed by this installation Use this to call the script file during installation while leaving the file on the destination computer as part of the installation Tips z Before you add this custom action add the file to be called to the Files page in Installation Expert z Shaded areas of MSI Script indicate rest...

Page 523: ...he custom action and complete the Details tab z Custom Action Name Enter a unique name that begins with a letter or underscore It can contain numbers and periods It must not match the name of any Windows Installer standard action See Standard Actions Reference in the Windows Installer SDK Help z Property Specify a property that stores the script either by selecting a property or typing a new prope...

Page 524: ...be displayed in the title bar of the message z Message Text Enter the text to be displayed in the message dialog box Press Ctrl Enter to add line breaks in the displayed text z Message Icon Select an appropriate icon for your message dialog box See also Remark on page 534 Guidelines for Custom Action Conditions on page 506 Download File From Internet This custom action downloads a file from the In...

Page 525: ...The field length is limited to 64 characters and two lines See also Launch Web Page on page 531 Post Data to HTTP Server on page 532 Guidelines for Custom Action Location on page 505 End Statement The End Statement action marks the end of an If action which specifies conditions to attach to an action or a set of actions The End Statement action takes no parameters and double clicking it in the Act...

Page 526: ...n Working Directory and type NOTEPAD EXE README TXT in this field the README TXT file that is in INSTALLDIR is opened See also Guidelines for Custom Action Location on page 505 Using the Custom Action Properties Tab on page 542 Using the Custom Action Location Tab on page 539 Custom Action Type 34 in the Windows Installer SDK Help Execute Program From Installation This custom action stores an EXE ...

Page 527: ...ter command line options to pass to the EXE file On the Properties tab In Script Options is unavailable for this custom action See also Guidelines for Custom Action Location on page 505 Using the Custom Action Properties Tab on page 542 Using the Custom Action Location Tab on page 539 Custom Action Type 18 in the Windows Installer SDK Help Execute Program From Path This custom action calls an EXE ...

Page 528: ...bject to Windows Installer guidelines for creating conditions See Conditional Statement Syntax in the Windows Installer SDK Help To use the Condition Builder to create a syntactically correct Windows Installer condition click Build See Creating Conditions With Condition Builder on page 441 See also Conditions on page 437 Using Conditions With Features on page 119 Install MSI From Destination This ...

Page 529: ...STALLDIR INSTALLDIR If the directory represented by the property might contain spaces as is typical with the installation directory enclose the property in quotes as shown above To set the nested installation to be advertised enter ADVERTISE ALL To uninstall the nested installation enter REMOVE ALL For a list of properties see Property Reference in the Windows Installer SDK Help See also Guideline...

Page 530: ...lation INSTALLDIR INSTALLDIR If the directory represented by the property might contain spaces as is typical with the installation directory enclose the property in quotes as shown above To set the nested installation to be advertised enter ADVERTISE ALL To uninstall the nested installation enter REMOVE ALL For a list of properties see Property Reference in the Windows Installer SDK Help See also ...

Page 531: ...l second msi enter the following SubInstall second msi z Property Settings Enter properties to set for the nested installation You can set Windows Installer properties or private properties Example To set the main installation directory for the nested installation to be the same as for the current installation INSTALLDIR INSTALLDIR If the directory represented by the property might contain spaces ...

Page 532: ...acement for this custom action because this custom action calls an installed file it must run after files are installed See also Guidelines for Custom Action Location on page 505 Pause Installation This custom action temporarily stops a sequence from executing After the specified number of seconds the sequence continues running This action must be placed in the Execute Deferred sequence Usage Doub...

Page 533: ...r marks to accept posting of data Associate the check box with a property and set up the conditional block to run if the property is true To create a condition use an If Statement See If Statement on page 528 Usage Double click the custom action and complete the dialog box z Destination URL The URL of the CGI program or ASP page that will accept the posted data z Text to Post The text to post shou...

Page 534: ...s a Set Windows Installer Property action place this custom action in the User Interface or Execute Immediate sequence Usage Double click the custom action and complete the Details tab z Custom Action Name Enter a unique name that begins with a letter or underscore It can contain numbers and periods It must not match the name of any Windows Installer standard action See Standard Actions Reference ...

Page 535: ...ich reflects the Binary table Usage Double click the custom action and complete the Details tab z Custom Action Name Enter a unique name that begins with a letter or underscore It can contain numbers and periods It must not match the name of any Windows Installer standard action See Standard Actions Reference in the Windows Installer SDK Help z WiseScript EXE File Specify an executable file on you...

Page 536: ...s custom action in the User Interface or Execute Immediate sequence z Before you add this custom action add the file to be called to the Files page in Installation Expert z Shaded areas of MSI Script indicate restricted placement for this custom action because this custom action calls an installed file it must run after files are installed Usage Double click the custom action and complete the Deta...

Page 537: ...his custom action refer to the Getting Started Guide Tips z For best results place this action in the User Interface or Execute Immediate sequence z On the Properties tab the In Script Options and Processing drop down lists are unavailable for this custom action Usage Double click the custom action and complete the Details tab z Custom Action Name Enter a unique name that begins with a letter or u...

Page 538: ...so Configuring a Feature Using Its Drop Down List on page 114 Configuring a Feature Using the Feature Details Dialog on page 116 Guidelines for Custom Action Location on page 505 Set Property This custom action sets a Windows Installer property This custom action is useful for setting a property based on end user input or on system configuration Tips z For best results place this action in the Use...

Page 539: ...his custom action Usage Double click the custom action and complete the Details tab z Custom Action Name Enter a unique name that begins with a letter or underscore It can contain numbers and periods It must not match the name of any Windows Installer standard action See Standard Actions Reference in the Windows Installer SDK Help z Termination Message Enter a message to explain to the end user wh...

Page 540: ...ions that are part of this installation Click on an action in the list box and click one of the following buttons Click Add to add the custom action to the sequence below the action you selected Click Remove to remove it from the sequence Click Move Up and Move Down to specify where in the sequence the custom action is stored z Condition For this action to run only if a certain condition is true e...

Page 541: ...p down list contains all the standard Windows Installer actions from the sequence that you selected in the Sequence drop down list This custom action when merged into a standard installation will be placed relative to the action you select in this list z Sequence Number If the reference action you select above is not found this custom action will be placed using this sequence number In most cases ...

Page 542: ...aller makes through the installation database before the internal script is generated and executed Actions in immediate execution mode can change properties actions in any type of deferred mode cannot Actions in immediate execution mode always run under User Context which means that they run with the same privilege level as the currently logged in user If the custom action needs to be run under a ...

Page 543: ...ailable if the custom action type is Set Property or Set Directory and are limited to synchronous for Install MSI custom actions z Synchronous Run the custom action synchronously to the main installation thread Windows Installer waits for the custom action to complete before continuing the main installation The exit code of the custom action must be 0 to indicate success Use this method for Window...

Page 544: ...f UI sequence was run Select this option if the custom action should run only if either Execute sequence is run following User Interface sequence Progress Bar Text Enter the text to display with the progress bar while the action runs The action must be placed in the Execute Deferred sequence for the text to be displayed You cannot enter properties or other formatted text see Formatted in the Windo...

Page 545: ...or installation packages The Windows Installer engine resides on the destination computer reads the installation database MSI and performs the installation and any subsequent management such as self repair Instead of an installation executable such as setup exe your installation is in the form of a database file MSI which contains instructions and can also enclose installation files Because this d...

Page 546: ...ght prompt the end user for the original installation source shared network directory or CD If you output an MSI file compressed in an EXE file Windows Installer uncompresses a copy of the MSI into Program Files Common Files Wise Installation Wizard on the destination computer These MSI files do not have to be left on the destination computer but if they are the end user does not need the source m...

Page 547: ...e an application to use Microsoft Windows Installer APIs Use the Windows Installer Software Development Kit SDK online help which is installed with Windows Installer Editor as a reference for coding Windows Installer functionality into an application See also About Microsoft Windows Installer on page 545 Working With Components and Features In Microsoft Windows Installer terminology a feature is a...

Page 548: ...t of an application has an assigned GUID You can use the System Search page to quickly search for components on the destination computer to determine if a previous version exists A GUID must be in the format XXXXXXXX XXXX XXXX XXXX XXXXXXXXXXXX where X is a hex digit 0 1 2 3 4 5 6 7 8 9 A B C D E F Windows Installer Editor generates GUIDs whenever necessary using an algorithm that reduces the chan...

Page 549: ...rch for Common Language Runtime in the MSDN Library msdn microsoft com library What s the difference between managed and unmanaged code Code developed with a language compiler that targets the common language runtime is called managed code All code based on Microsoft intermediate language MSIL executes as managed code Managed code is self describing it contains metadata that describes every elemen...

Page 550: ...of file sharing conflicts With the common language runtime the assembly is described by a manifest the registry is no longer relied upon for storing and accessing the COM activation data This allows components to be fully isolated from each other Assembly sharing is accomplished in several ways z Global Assembly Cache To install NET assemblies that are intended to be shared by many applications on...

Page 551: ...e security z Create a shortcut z Require elevated privileges to install on a locked down computer By creating a Windows Installer installation for your NET applications you can take advantage of the services Windows Installer provides installation repair and removal of assemblies roll back install on demand patching and advertisement How does Windows Installer Editor support NET installations Wind...

Page 552: ...ation computer must have the NET Framework installed Before you begin to create an installation for your NET application do the following To prepare to create a NET installation 1 Gather all your assemblies both Win32 and NET and their manifests into a common location 2 Determine the directories in which the assemblies are to be installed You can install assemblies into the Global Assembly Cache t...

Page 553: ...ons on page 504 Wise Custom Actions Custom action Description ClearDisableUAP Checks the version of Windows on the destination computer If it is less than 6 earlier than Windows Vista then it clears the DisableUAP property When User Account Control is disabled the option to install for all users or for the current user on the installation s User Information dialog box is hidden If the installation...

Page 554: ...the test fails This check is inserted after the launch condition check DiagnosticCheckExecuteLocally Evaluates type 34 or type 50 custom actions which run a file that is expected to exist on the destination computer Once the test obtains the application path and ensures that it is valid it calls the load library to ensure the application can be loaded and returns success if the application succeed...

Page 555: ...mplete DiagnosticOpenDocExtChec During Preflight Instrumentation builds a list of document extensions from the OpenDocument custom action and saves the list in the WiseExtDiag table On the destination computer checks the registry for support for each extension This test tries to open the registry key associated with the extension If it successfully opens the key then an association exists Otherwis...

Page 556: ...s left over from the custom action Wise textreplacementinit Immediate mode custom action that reads Dynamic XML data and stores it in a file for use by the deferred custom action Wise textreplacementmodify Wise textreplacementmodify Deferred mode custom action that reads data stored by Wise textreplacementinit and performs the appropriate XML substitutions WiseElevateCheck Windows Vista or later o...

Page 557: ...s it in a file for use by the deferred custom action WiseRegComPlus Add Remove WiseRemoveFirewall During an uninstall undoes changes that the installation made to the Windows Firewall Windows XP SP2 Windows Server 2003 SP1 and later Wise Set Assembly Framework Properties Scans the MsiAssemblyName table to find the NET Framework version associated with each component and its related NET assembly an...

Page 558: ... previous versions of the application WiseVerifyUser Verifies the user and password that is entered on the Logon Information dialog box for a Server Application installation WiseVirtDirCallDll Creates modifies or removes the appropriate Web sites and virtual directories based on the XML generated by WiseWriteWebXmlDll WiseWriteWebXMLDll Generates XML for operations that must take place during the ...

Page 559: ...the advertising information you select in the Compiler Options section of the Component Details dialog box WiseCommandLine Contains the information that is used on the Command Line page WiseComPlusApp Yes Contains a list of MTS COM applications that are in the installation WiseComPlusComponent Yes Contains information relating to MTS COM applications that are in the installation WiseCustomActionDo...

Page 560: ...cluded from assembly dependency scans WiseMetaDataCache Wise Package Studio only Contains user defined meta data after values for the meta data are entered on the Product Details page WiseMobileDevice Contains a list of all mobile device applications a description of each and appropriate attributes WiseMobileDeviceDesktopFiles Yes This is added only when you add a Palm application to the Mobile De...

Page 561: ...on about WiseScript runtimes that are added on the Prerequisites page WiseSequence Contains the remarks used in MSI Script as well as any empty If End If blocks WiseSourcePath Contains a list of all source paths for all files that are in the installation WiseStreamFiles Contains a list of all source path names for custom actions and graphics that are in the installation WiseTaskList Contains a lis...

Page 562: ... Studio integrated editor only Contains a list of projects in the solution and their settings WiseWebSiteAttributes Yes Stores the Web Dialogs settings for Web sites that you created on the Web Files page WiseWebSites Yes Stores the settings for Web sites that you created on the Web Files page WiseWildcard Contains an entry for each time you add a wildcard in Installation Expert Files page and mar...

Page 563: ...build properties below determine the default value of some of the properties in the INI file In that case the property description includes the name of the corresponding property in the INI file Property name Description _WiseDebugMode By default debug mode is off Set this property to 1 to debug DLLs that you added to an installation using a custom action For this feature to work the Custom Action...

Page 564: ...e located on the Tables tab DisableUAP Windows Installer 4 0 or later only Indicates whether User Account Control UAC previously known as UAP is disabled When User Account Control is disabled the option to install for all users or for the current user on the installation s User Information dialog box is hidden DiskPrompt Contains the default text that prompts the end user to insert the next instal...

Page 565: ...full product ID after the end user s entry has been validated ProductLanguage Indicates the language for this product See Language IDs on page 310 ProductName Contains the name of the product which is set on the Product Details page ProductVersion Contains the product version number which is set on the Product Details page If an installation creates an EXE that launches an MSI this property sets t...

Page 566: ...on which initially is English It can also contain the language ID separated from the language name by a comma Example English 1033 If the language of the destination computer matches this ID the installation runs without applying any language transforms If an installation creates an EXE that launches an MSI this property sets the default value for the WiseInitLangDefault property in the INI file t...

Page 567: ...splayed if the destination computer does not have enough free disk space to copy the MSI database to its local disk drive If an installation creates an EXE that launches an MSI this property sets the default value for the SpaceError property in the INI file that s generated See INI File Properties on page 567 WiseInitSuffix Contains the text that s displayed after the Wise Installation text in the...

Page 568: ...es CmdLine Contains the default command line that will be passed to MSIEXEC which is the Windows Installer executable that runs the MSI The command line statement should end with the I command line switch This defaults to the value of the build property named WiseInitCmdLine See Build Properties on page 563 DelayReboot If this is set to 1 a restart caused by pre installation of the Windows Install...

Page 569: ...ler for Windows 2000 XP 2003 Vista 2008 7 Do not change this property unless you change the location of this file RuntimeVersion If an installation includes the Windows Installer runtime this is the version of the included Windows Installer You set an installation to include the Windows Installer runtime on the Prerequisites page SpaceError Contains the error text that is displayed if the destinat...

Page 570: ... and where the Web site or virtual directory is installed Example Use these properties to create shortcuts to a Web site or virtual directory In the following property names VIRTDIR and WEBSITE are populated from the PropertyRoot column of the WiseVirtualDirectory table for the given Web site or virtual directory WiseInitSuffix Text that displays after the Wise Installation text in the installatio...

Page 571: ...cal home directory of the virtual directory VIRTDIR _BEGINURL Contains the beginning portion of the URL of the virtual directory VIRTDIR _URL Contains the URL of the virtual directory WEBSITE _BEGINURL Contains the beginning portion of the URL of the web site Example To create a shortcut to a specific page in the Web site use WEBSITE _BEGINURL file_name html WEBSITE _HOMEDIR Contains the physical ...

Page 572: ...109 AddFile event macro 485 Add on folder Palm about 248 installing to 250 Admin Dialogs 450 admin install error in Patch Creation 338 AdminError 568 administrative installation about 493 dialog boxes 492 during patching 337 performing 317 advertisement about 546 auto adding information 42 configuring shortcut for 175 extension adding 420 features 547 how it works 546 options 41 rescanning adverti...

Page 573: ...08 clean build in directory 230 in source control 229 Clean Build page 228 ClearDisableUAP 553 cluster size 238 CmdLine 568 code group importing for NET 283 code page 295 298 code signing See digital signature colors in sequence 496 column table 431 COM interoperability interop about 549 registering NET assembly 105 265 367 COM 285 combobox dialog box control 462 Command Line page 251 command verb...

Page 574: ...tallation 393 394 Convert button Dialogs page 452 copy file on destination computer 143 copy source files 135 credentials file 43 262 263 342 343 343 CUB file about 406 Also see validation module customizing 406 Current Feature list about 24 Features page 110 number in parentheses 25 Current Release list 25 custom action accessing properties 509 added by Wise 553 adding outside a sequence 494 addi...

Page 575: ... 467 Install Dialogs 450 Maintenance Dialogs 450 making modal 459 name 458 position 458 previewing 452 properties 447 properties editing 458 running action from 509 selecting 452 theme see theme dialog box translating 287 turning off all 453 457 turning on off 457 Welcome Dialog Wizard 450 WiseUpdate customizing 324 dialog box control about 461 adding 458 aligning 470 Also see dialog box attribute...

Page 576: ...ecute program from destination 525 from installation 526 from installed file 527 from path 527 ExistError 568 export to XML 95 ExpressBuild 44 extension adding 420 Also see first letter of the extension details 178 Extension table excluding extensions 218 F family patch 336 features about 547 adding 114 advertisement options 118 assigning component 418 attributes 118 checking if installed 444 444 ...

Page 577: ...ents 59 425 patch 341 guidelines for creating installation 67 H H file 300 hash table 146 help about 36 adding to dialog box 467 Installation Expert 21 using 36 Windows Installer SDK 36 hidden file 146 Hide Empty Folders Items 417 423 history showing for project 354 HKEY_USER_SELECTABLE 170 HTTP protocol 316 HTTP Server posting data 532 I ICE defined 406 errors 406 icon folder with magnifying glas...

Page 578: ...er 394 isolation using component 429 with Win32 assembly 150 Item Field in INI 194 J J importing 396 project types 395 tips for import 395 JScript calling from embedded code 518 calling from installation 518 calling from installed file 519 calling from property 520 guidelines for calling 507 K key fields 431 key path about 429 for components 426 setting 429 Key Table 379 L language adding 293 Also...

Page 579: ...erge Modules page 381 mergemod cub 407 message display to end user 523 meta data adding to Software Manager database 106 defining fields 103 editing 102 106 entering 102 issue in Task List 26 rearranging 103 metadata See meta data Microsoft NET See NET Microsoft Application Specification 407 Microsoft Internet Information Server See IIS Microsoft SMS converting to Windows Installer 394 installatio...

Page 580: ...h 104 package code 416 changing 104 in patch 335 Package Contents by Feature report 33 Package Contents Summary report 33 Package Definition File PDF 263 Package Distribution about 313 administrative install 317 and relative paths 315 copying EXE to disks 318 copying to FTP server 316 distributing to network 315 distributing to share point 313 Package Validation about 404 Also see validation corre...

Page 581: ...ss bar control 462 progress text translation 567 569 project dependency exclusions 399 project file connecting to existing 349 creating 79 82 merge module 68 multiple platforms 75 patch 69 Visual Studio 68 Windows Installer 68 working with 70 Project Outputs page 89 Project Summary page 102 Project Type page 86 project in Visual Studio entering settings 85 Projects page 87 prompt options 49 proper...

Page 582: ...re Repository repository connection about 29 65 connecting 65 repository ID 104 106 rescan advertising info 43 reset page 21 resolution screen requirement 188 resource directories 32 exporting 122 resource sharing about 29 locations 50 options 50 reports 31 Resources directory 32 51 Resources page 121 Restart Manager enable 199 restricted public properties 448 revision number 416 roles txt file 19...

Page 583: ...or files 91 source control about 348 adding clean build 229 adding project 349 351 checking files in 352 checking files out 352 checkout undoing 353 comparing to latest 355 connect to existing 349 differences showing 354 disabling 51 enabling 51 getting latest version 353 history showing 354 of XML files 349 removing files 353 source directory See source path source file location changing 360 rela...

Page 584: ...table error 26 435 user defined task 28 validation issue 26 template about 54 creating 55 import Visual Basic 396 import Visual C 396 import Visual J 396 language 305 location 55 page view 22 page view associating 22 56 page view customizing 23 56 server application 476 sharing 55 Template Summary property setting 71 viewing 71 Templates directory 33 51 55 TemplatesFile 33 temporary package file 3...

Page 585: ...scriptions 407 Validation directory 33 51 validation module about 406 customizing 406 predefined 407 selecting 405 selecting rules 406 validation rule selecting 406 value source for parameter 516 variable parameters 517 517 VBImport event macro 485 VBP file 395 396 VBPROJ file 395 VBR file 161 VBScript calling from embedded code 521 calling from installation 521 calling from installed file 522 cal...

Page 586: ...ce 495 Windows Mobile about 245 Windows Mobile installation about 245 Also see mobile device installation CAB file 245 INF file 245 Setup dll 245 uninstalling 246 Windows Mobile wizard 246 Windows NT locked down machines 448 service adding 179 service controlling 181 setting required version 188 Windows On Windows 64 73 Windows Vista logo requirements 409 Windows XP service adding 179 service cont...

Page 587: ...Package Editor 498 WiseSequence table 561 WiseSetAssemblyFrameworkPropertie s 557 WiseSetFirewall 557 WiseSingleFileCheck 557 WiseSourcePath table 561 WiseSql1 sql 280 WiseSQLCallDLL 557 WiseStartup 557 WiseStreamFiles table 561 WiseTaskList table 561 WiseTestSqlConn 557 WiseTextReplacement table 561 WiseUpdate about 319 client 319 326 configuring 321 dialogs customizing 324 INI file 323 log 323 p...

Reviews:

No comments

Related manuals for WINDOWS INSTALLER EDITOR 7.0 SP2

Canon PowerShot A410 Software Starter Manual preview
PowerShot A410
Brand: Canon Pages: 106
3Com 3C16120 - SuperStack 3 Server Load Balancer Release Note preview
3C16120 - SuperStack 3 Server Load Balancer
Brand: 3Com Pages: 20
Novell ZENworks 7.2 Linux Management Manual preview
ZENworks 7.2 Linux Management
Brand: Novell Pages: 10
Alphasmart AS 3000 Installation And User Manual preview
AS 3000
Brand: Alphasmart Pages: 4
MACROMEDIA COLDFUSION 5-ADVANCED ADMINISTRATION Manual preview
COLDFUSION 5-ADVANCED ADMINISTRATION
Brand: MACROMEDIA Pages: 372
Lexmark LexPrint User Manual preview
LexPrint
Brand: Lexmark Pages: 20
Waves Multimaximizer L3-16 User Manual preview
Multimaximizer L3-16
Brand: Waves Pages: 23
Dragon Systems DRAGON NATURALLYSPEAKING PROFESSIONAL 5 Manual preview
DRAGON NATURALLYSPEAKING PROFESSIONAL 5
Brand: Dragon Systems Pages: 222
Avaya PARTNER ACS PC Administration Getting Started Manual preview
PARTNER ACS PC Administration
Brand: Avaya Pages: 56
Avaya P120 SMON User Manual preview
P120 SMON
Brand: Avaya Pages: 61
Bay Networks NA User Manual preview
NA
Brand: Bay Networks Pages: 88
KAPERSKY ANTI-VIRUS 6.0 User Manual preview
ANTI-VIRUS 6.0
Brand: KAPERSKY Pages: 298
AVYCON Control4 Manual preview
Control4
Brand: AVYCON Pages: 16
Alpine NVD-A211 SMART MAP PRO Owner'S Manual preview
NVD-A211 SMART MAP PRO
Brand: Alpine Pages: 95
Waves GTR Solo User Manual preview
GTR Solo
Brand: Waves Pages: 29
Pantone TASKalfa 250ci User Manual preview
TASKalfa 250ci
Brand: Pantone Pages: 12
FARONICS DEEP FREEZE ENTERPRISE - INTEGRATING WITH BIGFIX PATCH MANAGER... Manual preview
DEEP FREEZE ENTERPRISE - INTEGRATING WITH BIGFIX PATCH MANAGER...
Brand: FARONICS Pages: 10
AMX AXD-CV6 Specifications preview
AXD-CV6
Brand: AMX Pages: 3

Brands by name

Popular brands

Load more brands