Académique Documents
Professionnel Documents
Culture Documents
Notice
Wise for Windows Installer, version 6.2 1994-2005 Wise Solutions, Inc. All Rights Reserved. This documentation and the accompanying software are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any human or computer language without prior written permission of Wise Solutions, Inc. Wise Solutions, Inc. asserts its Moral Right to be identified as the author of this work, in all jurisdictions which recognize the Moral Right. Unless otherwise provided by written agreement with Wise Solutions, Inc., this publication, and the software sold with this publication, are provided as is without warranty of any kind either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. The entire risk arising out of the use or performance of this publication and software remains with you. In no event will Wise Solutions, Inc., or any of its suppliers, be liable for any lost profits, lost savings, direct, incidental or indirect damages or other economic or consequential damages, even if Wise Solutions, Inc., or its suppliers, have been advised of the possibility of such damages. Wise Solutions, Inc. reserves the right to modify this document at any time without obligation to notify anyone. In no event shall Wise Solutions, Inc.s or its suppliers liability under this agreement exceed the sum of any amounts paid hereunder by the customer to Wise or the supplier. Wise Solutions, Inc. owns a number of trademarks and service marks (the Marks). These Marks are extremely valuable to Wise Solutions, Inc. and shall not be used by you, or any other person, without Wise Solutions, Inc.s express written permission. The Marks include, but are not necessarily limited to the following: Application Isolation Wizard; ApplicationWatch; ConflictManager; ExpressBuild; Installation Development Life Cycle; InstallBuilder; InstallMaker; InstallManager; InstallTailor; MSI Debugger; MSI Script; PackageManager; Preflight Deployment; SetupCapture; SmartMonitor; SmartPatch; Software Distribution Made Easy; Software Installations Made Easy; Unwise; Virtual Capture; Visual MSIDiff; WebDeploy; Wise Installation System; Wise MSI Editor; Wise Package Studio; Wise Software Repository; Wise Solutions; WiseScript; WiseScript Express; WiseUpdate; WiseUser; and the Wise Solutions logo. In addition to Wise Solutions, Inc.s Marks, some Wise Products may include Trademarks or Service Marks owned by other corporations. These other Marks include, but are not necessarily limited to Microsoft Windows and Microsoft Visual Studio .NET, which are registered Trademarks of Microsoft Corporation. You shall not use any of the Trademarks or Service Marks of Wise Solutions, Inc., Microsoft Corporation, or any other entity, without the express written permission of such Trademark or Service Mark owner. Wise Solutions, Inc., a wholly owned subsidiary of Altiris, Inc. 47911 Halyard Drive; Plymouth, Michigan 48170 USA Phone: +1 734 456 2100 Fax: +1 734 456 2456 www.wise.com
Contents
Chapter 1: Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Documentation Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Getting Help and Product Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Getting Updates Over the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Customize the Installations Behavior on the Destination Computer . . Set System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . Select Dialogs That Appear to End Users . . . . . . . . . . . . . . . . . . Configure Installation Types . . . . . . . . . . . . . . . . . . . . . . . . . . Define Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Create Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customize the Demo Release Properties . . . . . . . . . . . . . . . . . . Compile and Test the Installation . . . . . . . . . . . . . . . . . . . . . . . . . .
.. .. .. .. .. .. .. ..
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
44 44 44 45 45 46 47 48
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Chapter 1
Welcome
Wise for Windows Installer is an installation development system for creating and editing Windows Installer (.MSI) installation packages. It is a complete and userfriendly front end for generating Windows Installer database files, which are executed by the Windows Installer engine. With Wise for Windows Installer, you can: Create installations that are compliant with Microsofts Windows 2000 logo program. Edit and refine installations that youve converted from other formats. Import development projects. Through its Visual Studio integrated editor, Wise for Windows Installer offers a complete, seamless integration of the entire installation authoring environment directly into the Microsoft Visual Studio .NET development environment. This tight integration allows for automatic synchronization of your development project with your installation, saving you time and significantly improving the quality of your installations. Microsoft Windows Installer is a Microsoft technology that provides a standard installation engine that can be used for the installation of any 32-bit or 64-bit Windows software product. It resides on the destination computer and performs the installation of applications. Windows Installer technology provides features that are not available in traditional installation-building products (examples: self-healing and install-ondemand). Topics include: Documentation Roadmap. Getting Help and Product Support. How to Check Online Help. Getting Updates Over the Web.
Documentation Roadmap
The Wise for Windows Installer documentation assumes that you are proficient in the use of the Windows operating system. If you need help using the operating system, consult its user documentation. Use the following sources of information to learn the product.
Online Help
The online help contains detailed technical information and step-by-step instructions for performing common tasks. For details on using help, see Check Online Help on page 6.
Welcome
Reference Manual
All the material in the online help is also available in .PDF-format reference manuals. Reference manual .PDFs are provided for Wise for Windows Installer and WiseScript Express. The Enterprise Edition also includes a Software Manager reference manual. To access the .PDF reference manuals, select Help menu > Reference Manual from within each product. (In Visual Studio: Help menu > Wise Help > Reference Manual.)
Release Notes
A release notes document, in .HTM format, covers new features, enhancements, bug fixes, and known issues for the current version of this product. It also contains links to release notes for other versions. Access the release notes in the following ways: Browse the product CD. Select Help menu > Release Notes. (In Visual Studio: Help menu > Wise Help > Release Notes.) If you are a registered customer, visit http://support.wise.com to enter the Support Center, and then click the Downloads link.
Welcome
Select other commands from the Help menu to view the Windows Installer SDK Help, to view the .PDF-format reference manual or getting started guide, to view Wise resources on the Web, or to check for upgrades. If you need help and cannot find the answer in the documentation, explore our technical support options below.
Subscribe to TechInfo
TechInfo is a free e-mail newsletter that contains technical tips, product updates, and other important technical information. To subscribe or to read back issues, visit www.wise.com/techinfo.asp.
Welcome
Note Wise for Windows Installer can remind you to check for updates. Select an option in the Check for Updates drop-down list in Wise Options. This sets the frequency at which you will be reminded to check for updates.
Chapter 2
Wise Server
SQL Server
Clients
Computer
Wise for Windows Installer Server Dedicated SQL Server
What to Install
Wise for Windows Installer server Share point directory SQL Server Wise for Windows Installer databases
Clients
10
Wise/SQL Server
Clients
Computer
Dedicated Server
What to Install
Wise for Windows Installer server Share point directory SQL Server (for client support) or MSDE (local computer use, non-client support) Wise for Windows Installer databases
Clients
Single User
Recommended environment: Single user with no expected growth. This configuration is not scalable.
Wise/SQL Server
Computer
Dedicated Server
What to Install
Wise for Windows Installer server Share point directory SQL Server (for client support) or MSDE (local computer, non-client support) Wise for Windows Installer databases
Clients
no clients
11
Team 1 Server
Team 2 Server
Note For ease of illustration, the single server configuration is shown. This concept also works with the other recommended Wise for Windows Installer configurations.
12
which import packages and refresh package subscriptions on a server-based installation, on more than one database on a single computer.
SQL Server 1
Software Manager database 1
SQL Server 2
Software Manager database 2
Wise Server
Share point directory
Clients
2.
13
File Server
Share point directory
Clients
After
Wise for Windows Installer server is on the computer that contains the share point directory. The Wise for Windows Installer clients use the share point directory on the new Wise for Windows Installer server.
SQL Server
Wise databases * * Can also reside on separate servers
Wise Server
Share point directory Wise for Windows Installer
Clients
14
Chapter 3
System Requirements
Note Wise for Windows Installer cannot be installed on any computer that contains Wise for Visual Studio .NET or Wise Package Studio (any edition or version). The Visual Studio integrated editor requires Microsoft Visual Studio .NET (any edition). For Microsofts requirements for installing Visual Studio .NET, consult the documentation that you received with Visual Studio .NET.
Requirement
Computer/processor Operating system
Value
PC with a Pentium II-class processor, 450 MHz Windows 2000 or later (SP4 recommended) Windows XP Professional (SP2 recommended) Windows Server 2003
15
Requirement
Internet Explorer
Value
5.5 or later or later* * Software Manager reports require 6.0 or later, or Microsoft XML Parser (MSXML) 3.0 Service Pack 7.
RAM Drive Display Free space on boot drive Free space on installation drive Network (Enterprise Edition only) Database (Enterprise Edition only)
128 MB; 256 MB recommended CD-ROM or DVD-ROM drive Super VGA (800 x 600) or higher-resolution monitor with 256 colors 65 MB 120 MB Windows-based network environment Your environment must contain at least one server that has one of the following: Microsoft SQL Server (English version only). Version 7.0 required; 2000 recommended. SQL Server 2005 and SQL Server 2005 Express are supported. Microsoft Data Engine (MSDE). MSDE does not support Wise for Windows Installer client installations. If you will install Wise for Windows Installer in a client-server configuration, use SQL Server. If you are upgrading from a previous version of Wise for Windows Installer that used Access databases, the Wise Repository Manager will upgrade the databases to SQL Server or MSDE.
Installations that you create with Wise for Windows Installer can be run on any Windows operating systems that are supported by Windows Installer. Windows 95 and earlier versions of Windows NT 4.0 do not contain Windows Installer software by default, so if you plan to run an installation on those operating systems, configure it to pre-install Windows Installer. To do so, use the option provided in Installation Expert > Prerequisites page.
16
17
Environment
Single user Team, sharing project files
When the share point directory is on a shared network drive, all users in a workgroup must specify the same share point directory during installation. This lets all users access the same application data and shared resources.
Environment
Client users have local NT accounts. Client users have a domain account on the SQL server, and have read and write permissions.
Authentication Method
SQL Server only (recommended). Windows NT or SQL Server.
If you have installed SQL Server or MSDE with NT authentication only, the Wise Task Manager, which manages certain Wise for Windows Installer operations, will not work. Therefore, during the Wise for Windows Installer database configuration, the authentication method is changed to mixed mode (NT and SQL). If you have any questions about how this change affects SQL Server security, ask your database administrator.
18
Installation Options
You can install different editions and configurations of Wise for Windows Installer.
Enterprise Edition
Enterprise Edition is a Windows Installer and .NET installation authoring tool supporting organizations that develop multiple applications that share common resources. It helps professional developers create installations that adhere to their organizations standards, thereby decreasing the risk of deployment errors. The Enterprise Edition has 2 installation types: Server The server installation includes the share point directory and the Wise for Windows Installer databases. In a single-user environment, you can install the Enterprise Edition on your local computer. In effect, your local computer is the server. We recommend that you do this only if you do not plan to add users in the future. In the more typical group environment, you run the server installation on a shared network location. Then, you run the client installation on individual users computers. Client The client installation uses the share point directory and Wise for Windows Installer databases that are installed on the server. You install the Wise for Windows Installer program files on the client computer. See Installing the Enterprise Edition on page 21.
19
3.
(Enterprise Edition only.) The upgrade installation does not delete the existing share point directory, Wise for Windows Installer databases, or settings. After the installation finishes, open the Wise Repository Manager to upgrade the share point directory and databases. See Upgrading Databases on page 30.
5.
20
Mark the option for the edition of Wise for Windows Installer to install.
Final dialog
When the installation finishes, a dialog indicates that the installation has been completed successfully. On the final dialog, click Finish to exit the installation. If you chose to register on the Internet and you have an active connection to the Internet, your browser opens to product registration instructions on the Wise Web site. If you are prompted to restart your computer, do so.
5.
21
Install Evaluation Version Mark this to install an evaluation version without a serial number. Full Name, Organization Enter this identifying information. Register on the Internet If this checkbox is marked, you will be prompted to register at the end of installation. 6. Complete the remaining dialogs, which are described below.
22
Specify the share point directory that was configured during the server installation. Enter a shared network location in UNC (recommended) or mapped drive notation. (Example of UNC: \\SERVER_NAME\WISE SHARE POINT.) In a large enterprise with multiple teams, each team might have a different share point directory and Wise Software Repository. After installation, you can change the repository that a client installation connects to. See Setting Repository Options in the Wise for Windows Installer Help.
Final dialog
When the installation finishes, a dialog indicates that the installation has been completed successfully. Client installation: On the final dialog, click Finish to exit the installation. Server installation: If you mark Launch Wise Repository Manager, the Create New Repository wizard starts when you click Finish. See Repository Configuration Dialogs on page 33. If you chose to register on the Internet and you have an active connection to the Internet, your browser opens to product registration instructions on the Wise Web site. (Server installation: If you marked the option to launch the Wise Repository Manager, both windows open.) If you are prompted to restart your computer, do so.
What to Do Next
(Server installations only.) Before you can use Wise Package Studio, you must configure the repository. See Configuring the Wise Software Repository on page 29.
c.
23
the Language Pack serial number on the User Information dialog and click through the remaining dialogs.
For details on creating other types of installations and installations within a Visual Studio .NET solution, see the Wise for Windows Installer Help.
24
The evaluation version is converted to a production version. When you start Wise for Windows Installer, the Evaluation dialog no longer appears. If the production serial number is for a different edition than the evaluation serial number, you must uninstall the evaluation version before you install the production version.
25
Chapter 4
Additional topics include: About the Wise Software Repository. Accessing the Wise Repository Manager. The Wise Repository Manager Interface. Repository Configuration Dialogs.
26
Share Point Directory Contains shared resources used to create Windows Installer installations. It also contains source files for packages in the Software Manager database. All Wise for Windows Installer databases are associated with a specific share point directory. Software Manager database Contains all software packages created by an organization. Package resources might be included also (examples: files, merge modules, registry keys). Wise Services database Stores data that is generated and used by various background operations (examples: package import, the upgrade process). A repository can contain only one Wise Services database.
Multiple Repositories
In a large enterprise with multiple teams, each team might use a different share point directory and Wise Software Repository. Because a Wise for Windows Installer server can be associated with only one active repository at a time, each team must install their repository on a different server. A single Wise for Windows Installer server can contain multiple repositories. However, only one repository can be active at a time. To change the active repository on a Wise for Windows Installer server, open the repository in the Wise Repository Manager. A Wise for Windows Installer client can connect to any Wise Software Repository that it can access. To change a clients default repository, use the Wise Options dialog > Repository tab and specify the share point that is associated with an active Wise Software Repository.
27
If the Wise Software Repository has not been configured, the Create New Repository wizard starts. For details on the Create New Repository wizard, see Repository Configuration Dialogs on page 33. Also see: The Wise Repository Manager Interface on page 28 Configuring the Wise Software Repository on page 29 Upgrading Databases on page 30 Changing Database Settings on page 31 Creating Software Manager Databases on page 31 Creating a New Repository on page 32 Opening a Repository on page 32 Setting the Wise Service Account on page 35
The left pane contains a tree structure that represents: The databases that comprise the Wise Software Repository. If the repository contains multiple Software Manager databases, the default is displayed in bold type. Note The Subscriptions subfolder displays any databases that are subscribed to from the selected Software Manager database. To manage a subscribed database, open the repository that it is associated with. Click the top-level folder or a database icon to display help in the right pane. Click a specific database (in bold type) to display maintenance options in the right pane.
28
Lists the SQL scripts or command lines that the selected action runs
In the right pane, you can: Upgrade the database to a new version. See Upgrading Databases on page 30. Display a record of completed upgrade actions by clicking Show Log on the toolbar. Change the database settings. See Changing Database Settings on page 31.
29
2. 3.
Step through the Create New Repository wizard. For details, see Repository Configuration Dialogs on page 33. If you have upgraded from a previous version of Wise for Windows Installer, upgrade the databases. See Upgrading Databases on page 30.
Upgrading Databases
Enterprise Edition only.
When you upgrade Wise for Windows Installer, you must also upgrade the Wise for Windows Installer databases before you can use them with the new version. You do this in the Wise Repository Manager. Do this after you configure the repository with the Create New Repository wizard. The icon next to the database name in the left pane indicates that the database must be upgraded before it can be used. When the red X is removed from the icon, you can safely use that database with the current version of Wise for Windows Installer. This can occur before all upgrade actions have been completed. That is because the upgrade might contain background actions that do not have to be completed before users can begin using Wise for Windows Installer. To review the changes that the upgrade will make, click an action in the Actions list. Information about what that action does is displayed in the Description and Details sections. The Upgrade to 6.00 and Upgrade to 6.10 actions upgrade databases earlier than those versions to a baseline format, from which you can upgrade to 6.2 or any later version. (The baseline version that appears in the actions description does not necessarily correspond to any product version number.) Note If you are upgrading a repository that contained multiple Software Manager databases, or if one of the databases had a name other than the default name, register and upgrade those databases separately. See Registering a Database on page 31.
30
Registering a Database
Enterprise Edition only.
Do this when you upgrade a repository that contains multiple Software Manager databases. During the Create New Repository wizard, you can specify only one Software Manager database. Therefore, the other Software Manager databases are not registered.
To register a database:
1. 2. In the left pane of the Wise Repository Manager, click the Software Manager icon. On the toolbar, click Register. The Select Data Source dialog appears. This is a standard Windows ODBC connection wizard, which lets you connect to a database via an ODBC data source. 3. Connect to the database. If you need help, ask your database administrator. The database appears in the left pane of the Wise Repository Manager. 4. Upgrade the database. See Upgrading Databases on page 30.
31
The ability to create a database is disabled for the Wise Services databases because a repository can contain only one of that database. This procedure assumes that you are familiar with creating databases and registering ODBC data sources. We do not offer technical support for MSDE or SQL Server. If you need help, ask your database administrator. 1. In the left pane of the Wise Repository Manager, right-click the Software Manager icon and select Create New Database. The Create New Database wizard starts. 2. Complete the following dialogs: Database Identification dialog Database Administrator Logon Information dialog Creation Options dialog See Repository Configuration Dialogs on page 33. 3. To make this the default Software Manager database, right-click the database name in the left pane and select Set as Default. The default database name is displayed in bold type.
To provide an additional level of security, your database administrator can set permissions on tables in the new Software Manager database. This is not required, but is an option if you are concerned about unauthorized users changing database tables outside of Wise for Windows Installer.
The new databases are created and associated with the share point directory you specified. To provide an additional level of security, your database administrator can set permissions on tables in the new databases. This is not required, but is an option if you are concerned about unauthorized users changing database tables outside of Wise for Windows Installer.
Opening a Repository
Enterprise Edition only.
32
In a large enterprise with multiple teams, each team might use a different Wise Software Repository. However, a Wise for Windows Installer server can be associated with only one active repository at a time. To change the default Wise Software Repository for a server installation, open a new repository. Note To change the default repository for a client installation, use the Wise Options dialog > Repository tab and specify the share point that is associated with an active Wise Software Repository. See Setting Repository Options in the Wise for Windows Installer Help. If you upgrade from a previous version of Wise for Windows Installer that has multiple repositories, only one repository is upgraded. To upgrade the other repositories, you must open them and then upgrade them. 1. 2. In the Wise Repository Manager, select File menu > New. On the Wise Share Point Directory dialog, specify the share point that is associated with the repository you are opening and click Next. If the repository associated with that share point is at the current version, it opens in the left pane. If the repository associated with that share point has not been upgraded, additional dialogs appear. Complete the dialogs to configure the repository, and then upgrade the database. See Repository Configuration Dialogs on page 33 and Upgrading Databases on page 30.
33
Invalid path for a new share point: \\server\Wise Share Point 2 Note When you perform a server installation in a team environment, we recommend that you install the share point directory on the same physical drive that contains the Wise for Windows Installer application files.
34
35
Chapter 5
36
c. 3.
4. 5.
Select Tools menu > Options. On the Wise Options dialog, click the Installation Expert tab and mark the following options: View directories for all features on Files page This lets you see all directories in Installation Expert > Files page, regardless of what feature each directory was created for. View registry keys for all features on Registry page This lets you see a composite view of all registry keys in Installation Expert > Registry page, regardless of what feature the registry key was created for. Note To display context-sensitive help, press F1.
6. 7.
37
8.
38
Now that youve entered basic information about the installation, you can define the features that provide structure to the installation.
39
4.
Use the Add button to enter information for 3 additional features as shown in the following table.
Parent
Select <None>. Select <None>. Select <None>.
Description
Facts about birds Facts about cats Facts about dogs
Required Feature
Leave the default. Leave the default. Leave the default.
The Features page should display 4 features; all features should be on the same level in the tree. If not, display the feature details and change the Parent field until all features are on the same level.
5.
The installation is now set up and structured into features. In the next section, you add files and other system changes to the installation.
40
10. On the Add Contents dialog, leave the defaults and click OK. The Help directory and its contents are added to the installation. 11. In the lower-left list box, expand the Windows directory and click the System32 subdirectory. 12. In the upper-left list box, click the System32 subdirectory under the QuickFacts directory. 13. Drag the file QFGUITAM.DLL from the upper-right list box to the lower-right list box. In the Current Feature drop-down list, the number (6) should appear next to the Core feature name. This indicates that the Core feature contains 6 files. This completes the file additions for the Core feature. Now add files to each of the remaining features.
41
b.
In the lower-left list box, click the QuickFacts directory and click New. Name the new directory FactFiles and click OK. Note If the QuickFacts directory does not appear in the lower-left list box, select Tools menu > Options, click the Installation Expert tab, and mark the checkboxes for View directories for all features on Files page and View registry keys for all features on Registry page.
c. d.
In the upper-left list box, click the FactFiles subdirectory of the QuickFacts directory. In the upper-right list box, select the files: Birds.bmp Birds.qft
e. 2.
Click Add File to add the files to the lower-right list box.
From the Current Feature drop-down list, select Cats. Then add the following files to the FactFiles directory for this feature: Cats.bmp Cats.qft Because you selected View directories for all features on Files page in Wise Options, you can still see the FactFiles directory in the lower-left list box, even though you added it to a different feature.
3.
From the Current Feature drop-down list, select Dogs. Then add the following files to the FactFiles directory for this feature: Dogs.bmp Dogs.qft
4.
To see all the files you added to the installation for all features, select All Features (Modify/Delete only) from the Current Feature drop-down list. The number (12) should appear next to the All Features name, indicating that the installation contains 12 files. You can navigate through the installation directories in the lowerleft list box to see the files that you have added.
42
3. 4.
Click Add at the lower left of the window and select Import. On the Select Registry File to Import dialog, navigate to the Wise for Windows Installer directory, select Tutorial\QuickFacts\Registry File\QuickFacts.reg, and click Open. QuickFacts.reg contains all the registry keys required for QuickFacts.
5.
In the lower-left list box, right-click HKEY_CURRENT_USER and select Expand Children. This expands the subkeys that you just imported. You can click through the subkeys to see the values that have been added.
Add a Shortcut
1. 2. 3. 4. 5. 6. 7. Select the Shortcuts page. From the Current Feature drop-down list, select Core. Click Add at the right of the window. On the Shortcut Type dialog, make sure the File in the installation and Advertised options are marked and click Next. On the Shortcut File Selection dialog, select the QuickFacts directory in the left pane, select QckFacts.exe in the right pane, and click Next. On the Shortcut Destination Directory dialog, make sure the Programs directory under the Start Menu is selected, and click Finish. On the Shortcut Details dialog, change the Name field to QuickFacts and click OK.
A shortcut for QckFacts.exe is added to the installation and will appear under Program Files in the Start menu when the product is installed.
43
The installation now contains files and other system changes that will be installed on the destination computer. In the next section, you determine how the installation behaves on the destination computer.
4.
44
The selected dialogs will appear during installation. The Installation Type Dialog lets the end user choose from a Typical, Complete, or Custom installation, and the Select Feature Dialog lets the end user select features in a custom installation. In the next section, you define which features are installed with each type of installation.
5. 6.
In the upper-left list box, select &Complete and, in the list box on the right, make sure the checkboxes are marked for all features. In the upper-left list box, select C&ustom and, in the list on the right, make sure the checkboxes are marked for the Core, Birds, and Cats. Make sure the Dogs checkbox is cleared, as shown below. (The features might be listed in a different order in your installation.)
7.
You have configured the installation to require a specific version of Windows and to let the end user select which features to install. In the next section, you create a standard and a demo edition of the installation.
Define Releases
In this section, you will create a standard edition and a demo edition of the QuickFacts installation. You also will customize properties for the demo release so that the product name reflects that its a demo.
45
To generate more than one installation from a single project, you create multiple releases and then configure each release. You can create releases in Wise for Windows Installer project files (.WSI) only; release options are disabled in .MSI files. When you create a release, you can specify whether the compiled installation program is an .EXE or an .MSI and whether to pre-install the Windows Installer software before running the installation. For this tutorial, you will create .MSI files and you will not preinstall Windows Installer.
Create Releases
In this procedure, you create 2 releases for this installation: a standard edition and a demo edition. 1. Under the Release Definition page group (you might need to scroll down to see it), select the Releases page. A release named Default already exists, because every installation must contain at least one release. 2. Double-click the Default release. The Release Details dialog appears. 3. Complete the dialog: Release Name Change this to Standard. .MSI File Name Enter: QuickFacts.msi Description Enter: QuickFacts Standard Release Installation Theme, Compression Type, Release Type Leave the defaults. Build this release during compile Make sure this is marked. 4. 5. Click OK on the Release Details dialog. Click Add at the right of the window to add the demo release. The Release Details dialog appears. 6. Complete the dialog: Release Name Enter: Demo .MSI File Enter: QuickFacts_Demo.msi
46
Description Enter: QuickFacts Demo Release Installation Theme, Compression Type, Release Type Leave the defaults. Build this release during compile Mark this checkbox. Note An Edit Media button appears at the bottom of the dialog. This button is enabled only when you first add a new release. You dont need to use it in this tutorial. 7. Click OK.
The installation now contains 2 releases. In the next section, you customize the demo release.
To change the Summary settings to inform the end user that this demo release includes limited features: a. b. Select the Summary icon. Click Add. The Summary Settings Override dialog appears.
47
c. d.
From Name, select Comments. In Value, enter: This is a demo version; it contains limited features. This text appears if the end user views properties on the compiled QuickFacts_Demo.msi.
e. 6.
Click OK.
Congratulations! You have just completed an installation, without having to edit even one table. In the next section, you compile and test the installation.
48
5.
When the test finishes, test the demo release. Select the demo release in the Select an MSI File dialog and repeat the preceding steps, including selecting Custom on the Select Installation Types dialog. Notice that the product name on the installation dialogs includes Demo. Also, only 2 features are visible on the Select Features dialog. This is the result of the features you set on the Release Settings page.
6. 7.
Proceed by accepting the defaults on the remaining dialogs. Now run the installation of the standard release, which installs the files. a. b. Click Run at the lower right of the window and select Run from the button menu. On the Select an .MSI File dialog, select QuickFacts.msi and click OK.
The standard release of the QuickFacts installation is run. Accept all dialog defaults and click Finish when the installation finishes. 8. Select Windows Start menu > Programs > QuickFacts. The QuickFacts application starts. The upper-left list box lists the fact files that are available for viewing. Because you installed a Typical installation, you do not see the Dogs fact files. (The Core feature, which comprises the QuickFacts application and help, is installed also.) Exit QuickFacts and double-click a .QFT file in Windows Explorer, which should launch QuickFacts. The .QFT files are in Program Files\QuickFacts\FactFiles. Note Do not run an actual installation of the demo release. The demo release cannot be installed until the standard release has been uninstalled. This completes the basic Wise for Windows Installer tutorial. Now you know how to create an installation using Installation Expert. The Advanced Tutorial describes how to add custom actions to the installation using the MSI Script view.
49
Chapter 6
50
4.
Click the Execute Immediate tab at the bottom of the Installation Sequence pane. You will add the action to the Execute Immediate sequence immediately before the installation of files begins.
5.
Locate the InstallFiles action in the Execute Immediate script: a. b. c. d. Press Ctrl+F to open the Find dialog. In the Find dialog, enter InstallFiles in the Find What field and make sure Normal Installation is selected in the In What drop-down list. Click Find Next. Click Cancel after the InstallFiles action is found.
6.
Select the REM statement above the InstallFiles action. When you add a new action, it always appears above the line that is selected in the right pane.
7.
In the Actions list, double-click Call Custom DLL from Destination. Call Custom DLL actions let you send parameters while Call DLL actions do not. The Call Custom DLL From Destination dialog appears. Note Although this tutorial guides you through calling a particular Windows .DLL function, it is not the purpose of this tutorial to teach you about .DLLs. Consult Windows developer documentation or other documentation to learn more about calling system .DLLs or the MessageBoxA API.
8.
Click the Details tab and complete the dialog: Note This tutorial does not explain all the options available on this dialog. Press F1 on the dialog for details on all options. Custom Action Name Enter: DisplayMessageBox DLL File (Windows NT, 2000, or XP.) Enter: SystemFolder\user32.dll (Windows 95, 98, or Me.) Enter: System16Folder\user32.dll The predefined directories, SystemFolder and System16Folder, hold paths to the \System32 and \System directories, respectively. All predefined directories are listed in the Directory table in Setup Editor > Tables tab. If you would actually deploy this action, youd have to construct If Statement structures that checked the operating system and then referred to the correct directory. Function Name Enter: MessageBoxA (case-sensitive), which is the name of a function within User32.dll. Parameters List In the parameters list, use the Add button to add the 4 parameters listed below. Click OK on the DLL Parameter Details dialog after entering each parameter. First parameter:
51
Parameter type: long Value Source: Constant with NULL value Because Constant with NULL value passes a value of NULL regardless of the parameter type, the Details tab displays Not applicable for the parameter type. Second parameter: Parameter type: string pointer Value Source: Property Property Name: Enter: INSTALLDIR Third parameter: Parameter type: string pointer Value Source: Constant Constant Value: Enter: The value of INSTALLDIR is: Fourth parameter: Parameter type: long Value Source: Constant Constant Value: Enter: 0 9. Leave the defaults for the Return fields and the Properties tab. The dialog should look like this:
10. Click OK on the Call Custom DLL From Destination dialog. The action is added to the sequence, immediately after the MoveFiles action. The next steps demonstrate how to enclose the new action in an If Statement, which sets a condition on the actionthe action runs only if the condition is true. 11. Select the Call Custom DLL From Destination action that you just created, and then in the Actions list, double-click If Statement.
52
The If Settings dialog appears. 12. In If Condition, enter NOT Installed (case sensitive) and click OK. The Windows Installer property named Installed is true if the product is already installed, so this action will run only on the initial installation of the product, not on subsequent maintenance installations. See Installed Property in the Windows Installer SDK Help. 13. Select the line below the Call Custom DLL From Destination action and double-click End Statement in the Actions list. This encloses the custom action in an If block, which is located between MoveFiles and InstallFiles and should look like the image below. If not, double-click the actions to edit their settings or use the Move Up and Move Down commands on the rightclick menu to rearrange the lines.
5.
Click OK to close the dialog and then click Finish at the end of the installation. If the dialog does not appear as expected, verify that the parameters and function name in the custom action match the instructions in this tutorial. Also verify that the custom action is in the correct position in the sequence.
53
3.
In the blank area under the Destination Folder group box, right-click and select Add > Checkbox. The Properties for Checkbox dialog appears, where you set a property and control text associated with the checkbox.
4.
In Control Text, enter: Put installation under the Common Files folder This is the text label for the checkbox.
5.
Click the New button to the right of the Property drop-down list. The Property Details dialog appears, where you create a new property to hold the value of the checkbox.
6.
54
a. b. c. d. e.
In Name, enter COMMONDIR (all uppercase). Leave the Value field blank. The checkbox value must evaluate to blank (nothing) initially so that the checkbox is not marked when end users first see it. Leave the defaults in the remaining fields. Click OK.
Note Technically, leaving a property blank is not allowed according to Windows Installer guidelines, but in this tutorial, you leave it blank so that the checkbox is initially unmarked. Because the property value is blank, the property does not appear under the Properties icon in Setup Editor > Product tab. 7. Click OK on the Properties for Checkbox dialog. The checkbox appears on the Destination Folder dialog. 8. If necessary, drag the checkbox so it is aligned with other controls on the dialog.
In the next procedure, you create a custom action that tests the value of the COMMONDIR property during installation. If COMMONDIR is true (which means that the checkbox is marked), the custom action resets the value of the installation directory (INSTALLDIR) so that it is placed in the Common Files directory.
5.
55
Directory Value Enter (case-sensitive): [CommonFilesFolder]QuickFacts This will be the new location of the installation directory if the end user marks the checkbox during installation. CommonFilesFolder is a directory property that represents the Common Files directory on the destination computer. 7. Leave the defaults on the Properties tab. The dialog should look like this:
8.
Click OK on the Set Directory dialog. The action is added to the sequence, immediately after the Welcome_Dialog If block. In the next steps, you enclose this action in an If Statement, which sets a condition on the actionthe action runs only if the condition is true.
9.
Make sure the Set Directory custom action you just created is selected. In the Actions list, double click If Statement. The If Settings dialog appears.
10. In If Condition, specify 2 conditions joined by AND. Enter the following (casesensitive) and click OK: COMMONDIR AND NOT Installed The first condition checks the COMMONDIR property you attached to the Put installation under the Common Files folder checkbox, which is true if the end user marks it during installation. The second condition checks a built-in Windows Installer property, named Installed, which is true only if this is the initial installation of the product, not a reinstall or maintenance installation. 11. Place an End Statement below the Set Directory custom action. The If Statement, custom action, and End Statement should look like the image below. If not, double-click the actions to edit their settings or use rearrange the lines. to
56
57
3.
Click the Execute Deferred tab at the bottom of the Installation Sequence pane. For this tutorial, you add the action to the Execute Deferred sequence immediately after the InstallFiles action. This action must run in deferred mode because it relies on an installed file (readme.txt), which is not present on the destination computer until after the InstallFiles action runs in the Execute Deferred sequence.
4.
Locate the InstallFiles action in the Execute Deferred script: a. b. c. d. Press Ctrl+F to open the Find dialog. In the Find dialog, enter InstallFiles in the Find What field and make sure Normal Installation is selected in the In What drop-down list. Click Find Next. Click Cancel after the InstallFiles action is found.
5. 6.
Select the REM statement below the InstallFiles action. In the Actions list, double-click Execute Program From Destination. The Execute Program From Destination dialog appears.
7.
Click the Details tab and complete the dialog: Note This tutorial does not explain all the options available on this dialog. Press F1 on the dialog for details on all options. Custom Action Name Enter: OpenReadMe Working Directory Enter: INSTALLDIR This sets the current working directory of the .EXE when it runs on the destination computer. In this case, Notepad.exe looks in the installation directory for the readme file you specify below. EXE and Command Line Enter: notepad.exe readme.txt Note Because Notepad is in the PATH variable, you do not have to specify its full path. If you were calling an .EXE that is not in the PATH variable, you would have to specify the full path here, using bracketed property names to form the pathname. Also, you dont have to specify the full path to readme.txt because in the previous field you set Notepads current working directory to the QuickFacts directory, where readme.txt resides. The dialog should look like this:
58
8. 9.
Click the Properties tab. In Processing, select Asynch, No wait, which makes the installation continue after opening Notepad.
10. Click OK on the Execute Program From Destination dialog. The action is added to the sequence immediately after the InstallFiles statement. In the next steps, you enclose the action in an If Statement, which sets a condition on the actionthe action runs only if the condition is true. 11. Above the Execute Program From Destination action, add an If Statement action. In If Condition, enter: NOT Installed. 12. Click OK. 13. Below the Execute Program From Destination action, add an End Statement. The If Statement, custom action, and End Statement, which are located between InstallFiles and PatchFiles, should look like the image below. If not, double-click the actions to edit their settings or use to rearrange the lines.
59
4.
In the installation wizard, click Next until the installation of files begins. Because of the custom action you added earlier in this tutorial, a dialog displays the value of INSTALLDIR during installation. After the installation of files, Notepad should appear and display the readme.txt file. If this does not work, check the order of the custom action. It must occur after the InstallFiles action, or it will not work. Also make sure it is in the Execute Deferred sequence and that all fields are entered correctly.
This completes the tutorial. The next section describes some of the advanced tasks you can perform in Setup Editor.
60
Chapter 7
61
(Standard Edition.) Select Windows Application. (Professional and Enterprise Editions.) Select Setup Wizard. c. d. e. f. In Name, enter QuickFacts Installer. Before setting the Location, mark the Add to Solution option. In Location, specify the Program Files\Wise for Windows Installer\Tutorial\Integrated Tutorial\QuickFacts directory. Click OK.
(Standard Edition.) The Wise Setup Wizard steps below are skipped. Go to the end of this procedure. (Professional and Enterprise Editions.) The Wise Setup Wizard appears with pages for Overview, Project Type, Projects, and Main Project. 8. Select the Overview page. It contains a summary of the settings for the installation project. It indicates that the primary outputs for each project (TextViewer.dll, FactFinder.dll, and QuickFacts.exe) are added to the installation project. 9. Select the Project Type page. This page is used to specify the type of Windows Installer project to create. For this tutorial, leave Windows Application marked. 10. Select the Projects page. The default settings should be correct. Select the projects to include in this package The solutions projects are selected. Scan Method With Always Scan Solution selected, if the primary outputs for the 3 projects change, the files in the installation will change accordingly. Bind installed files to the solution build configuration With this marked, if you change your build configuration from Release to Debug or vice versa, the installation project will draw its files from the corresponding directories. 11. Select the Main Project page. The default settings should be correct. Main Project QuickFacts should be selected. Automatically Update Product Information With this marked, the version number and other summary information in the installation is updated whenever the main target file changes. The information is updated each time you build your solution. Create Shortcut With this marked, a shortcut is created for the installation project. Target Platform This is a 32-bit installation. 12. Click Finish. A new project named QuickFacts Installer is added to the other projects in Solution Explorer. (If Solution Explorer is not visible, select View menu > Solution Explorer.) FactFinder.dll, QuickFacts.exe, and TextViewer.dl are in the projects Source Files
62
folder. They were added to the installation project because they are primary output files from the existing C# projects.
The Visual Studio integrated editor opens and displays QuickFacts Installer.wsi. 2. Select Tools menu > Options. The Options dialog appears. 3. 4. In the left pane, click Wise Options to expand the list and then select Installation Expert. In Installation Expert Options, mark the following. If you marked these in the Basic tutorial, they will be marked already. View directories for all features on Files page This lets you see all directories in Installation Expert > Files page, regardless of what feature each directory was created for. View registry keys for all features on Registry page This lets you see a composite view of all registry keys in Installation Expert > Registry page, regardless of what feature the registry key was created for. Note To display context-sensitive help, click Wise Help on the Options dialog. 5. Click OK.
63
4. 5.
(Professional and Enterprise Editions only.) In the Application Type field, select .NET Application in the Value column. Leave the defaults in the remaining fields. Select the General Information page by clicking its name. On the General Information page, you set the information that appears when the end user right-clicks the installation file in Windows Explorer and selects Properties.
6.
Complete the General Information page: Title Enter: QuickFacts Author Enter your name.
7.
Select the Add/Remove Programs page. On the Add/Remove Programs page, you enter information to support the capabilities of the enhanced Add/Remove Programs control panel that was introduced with Windows 2000.
8.
Complete the Add/Remove Programs page: Display in Add/Remove Programs list Make sure this is marked. Online Info URL Enter: No support provided.
9.
Save the installation by selecting File menu > Save QuickFacts Installer.wsi.
Now that youve entered basic information about the installation, you can define the features that provide structure to the installation. To do this, see Create and Organize Features on page 39. After you define features, you can add files to the installation.
64
3.
In the lower-left list box, find and select Program Files\QuickFacts. It contains 3 files (FactFinder.dll, QuickFacts.exe, and TextViewer.dll) that are primary output files of the 3 C# projects.
4.
In the upper-left list box, navigate to the Tutorial\Integrated Tutorial\Content Files subdirectory of the Wise for Windows Installer application directory. The files in the Content Files directory appear in the upper-right list box.
5.
Make sure the QuickFacts directory is still selected in the lower-left list box. In the upper-right list box, select License.txt and ReadMe.txt and click Add File. The 2 files are added to the QuickFacts directory in the installation.
6. 7. 8.
In the upper-left list box, expand the Content Files directory and select the Help subdirectory. Make sure the QuickFacts directory is still selected in the lower-left list box, and click Add Contents. On the Add Contents dialog, leave the defaults and click OK. The Help directory and its contents are added to the installation.
9.
10. If the Copy Source Files dialog appears, click Cancel. This has to do with Source Code Control, which is not used in this tutorial. In the Current Feature drop-down list, the number (7) should appear next to the Core feature name. This indicates that the Core feature contains 7 files. This completes the file additions for the Core feature. To add files to the remaining features, see To add files to the remaining features: on page 41. The rest of the procedures in the Basic tutorial are the same for both editors except for the following differences for the Visual Studio integrated editor: You dont need to add a shortcut on the Shortcuts page, because it is added automatically. However, you need to change its destination directory to Windows\Profiles\Start Menu\Programs. To compile the installation, select Build menu > Build QuickFacts Installer. To test the installation, select Project menu > Start in Test Mode. To run the installation, right-click the QuickFacts Installer project icon in Solution Explorer and select Set as Startup Project. Then select Debug menu > Start Without Debugging. For other differences between the Wise editor and the Visual Studio integrated editor, see the Wise for Windows Installer Help.
65
Index
Symbols
.NET Framework requirements 16 requirements 17 evaluation converting to production 24 Enterprise Edition 17 installation 15 tutorial 36 Wise Repository Manager 27
A
Access 16 Altiris consulting 7 getting updates 8 training 7 authentication best practices 18 setting 34
F
file share name 34
R
readme See release notes reference manual accessing online 6 registration, product 24 release notes 6
G
Getting Started Guide 6
H
help about 5 using 6 Windows Installer SDK 6
B
best practices authentication 18 configuration 9
I
installation Language Pack 23 options 19 upgrade 19 integrated editor, tutorial 61
S
sales contact 8 sample applications 35 serial number 17 server installation about 19 default repository 33 share point directory 33 settings, database 31 share point sharing 18 where to locate 17 share point directory on separate server 13 share name 34 specifying for client 23 specifying for server 33 unsupported configuration 13 show upgrade log 31 Software Manager database 17, 27 creating 31 multiples 12 sample applications 35 SQL Server 16 start Wise Repository Manager 27 starting Wise for Windows Installer 24 subscriptions 28 support 7 newsgroups 7 online support 7 system requirements .NET Framework 16 database 16 Wise for Windows Installer 15
C
checking for updates 8 client installation share point directory 23 configuration best practices 9 dedicated SQL server 10 multiple repositories 12 single server 11 configure repository 29 consulting 7 create new users 35 creation options (database) 35
L
Language Pack, installing 23 launch Wise Repository Manager 27 launching Wise for Windows Installer 24 logon database administrator 34 database service 34
D
database creation options 35 identification 34 registering 31 requirements 16 settings, changing 31 upgrading 30 users, creating 35 where to install 9 database administrator logon 34 database service logon 34 database tree 28 database, Software Manager See Software Manager database documentation 5
M
manual accessing online 6 Microsoft Access 16 Microsoft Data Engine 16 Microsoft SQL Server 16 MSDE 16 MSI Script, tutorial 50
N
new features Refer to Release Notes new repository 32 newsgroups 7
P
prerequisites .NET Framework 16 database 16
E
Enterprise Edition
66
T
technical support 7 newsgroups 7 online support 7 training 7 tutorial advanced 50 basic 36 integrated editor 61 prerequisites 36 Refer to Getting Started Guide
U
update, checking for 8 upgrade database 30 installing 19 log 31 Wise Software Repository 30 user account, Wise service changing 35 setting 22
V
Visual Studio integrated editor tutorial 61
W
Windows Installer developer documentation 6 help 6 Windows Installer SDK Help 6 Wise Package Studio configuration 9 Wise Repository Manager interface 28 requirements 27 starting 27 Wise service account changing 35 setting 22 Wise Services database about 27 Wise Software Repository 26 active 27 client default 33 configuring 29 creating 32 multiples 12, 27 new 32 opening 33 server default 33 upgrading 30
67