background image

Wise Installation Studio/Express
Getting Started Guide

Summary of Contents for WISE INSTALLATION EXPRESS 7.0 SP2

Page 1: ...Wise Installation Studio Express Getting Started Guide ...

Page 2: ...ESENTATIONS AND 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...

Page 3: ...urchased on 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...

Page 4: ...rs z Latest 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 agre...

Page 5: ...e to real 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 I...

Page 6: ...ze Features 19 Assemble the Installation 21 Add Files to the Installation 21 Add Registry Keys 23 Add a Shortcut 24 Create a File Association 24 Customize the Installation s Behavior on the Destination Computer 25 Set System Requirements 25 Select Dialog Boxes That Appear to End Users 26 Configure Installation Types 26 Define Releases 27 Create Releases 27 Customize the Demo Release Properties 28 ...

Page 7: ...Wise Installation Studio Express Getting Started Guide 7 Index 50 ...

Page 8: ...creating software installations for Windows devices z Windows Installer Editor This tool is comparable to Wise for Windows Installer Professional and Enterprise Editions Use it to create and edit Windows Installer installation packages z WiseScript Package Editor This tool is comparable to Wise Installation System all editions Use it to create and edit installation packages based on the WiseScript...

Page 9: ...are the minimum system requirements for running Wise Installation Studio and Wise Installation Express Restrictions We do not support the installation of Wise Installation Studio and Wise Installation Express on any computer that contains any edition or version of the following z Wise for Windows Installer z Wise for Visual Studio NET z Wise Package Studio Requirements for Wise Installation Studio...

Page 10: ...dows operating system If you need help using the operating system consult its user documentation Use the following sources of information to learn about this product Online Help The online help contains detailed technical information and step by step instructions for performing common tasks Access help in the following ways z To display context sensitive help for the active window or dialog box pr...

Page 11: ...access the Windows Installer SDK Help in Visual Studio select Help menu Wise Help Windows Installer SDK Help Windows Installer SDK help topics are also available within the Visual Studio help collection Release Notes The product release notes cover new features enhancements bug fixes and known issues for the current version of this product To access the release notes select Release Notes from the ...

Page 12: ...ements See System Requirements on page 9 To install Wise Installation Studio or Wise Installation Express 1 Close any other applications that are running 2 Download and run the installation file 3 On the installation s Welcome dialog box click Next 4 On the License Agreement dialog box read the license terms mark I accept the license agreement and click Next If you do not accept the license agreem...

Page 13: ... has been completed successfully On this dialog box click Finish to exit the installation If you are prompted to restart your computer do so Installing an Upgrade You can upgrade to Wise Installation Studio or Wise Installation Express 7 0 from an earlier version of a Wise product You also can upgrade from Wise Installation Express to Wise Installation Studio without uninstalling the previous edit...

Page 14: ...ing Wise Installation Studio or Wise Installation Express on page 12 Installing the Windows Installer Editor Language Pack The Language Pack is an add on to Windows Installer Editor It provides pre translated strings for 20 additional languages on the Languages page which lets you effortlessly ship your installations in other languages Options for Installing the Language Pack z If you purchase the...

Page 15: ... also Using a Wise Package Studio Repository in the Windows Installer Editor Help Converting an Evaluation Version to a Production Version You can convert an evaluation version of Wise Installation Studio or Wise Installation Express to a production version without uninstalling the product To convert an evaluation version to a production version 1 Purchase the product and obtain a production seria...

Page 16: ...computer and is safe to install This tutorial takes about 45 to 60 minutes to complete If you stop before finishing save the installation and resume the tutorial at a later time If you use Visual Studio integrated editor first follow this basic tutorial using the Wise editor Then follow the Visual Studio integrated tutorial which contains procedures that are specific to the Visual Studio integrate...

Page 17: ...ures in the installation Tasks in This Section z Setting options z Creating a new installation project z Entering product details z Entering general information z Entering information for Add Remove Programs z Setting up features Open a Project and Set Options You use the Wise Options dialog box to customize the behavior of Windows Installer Editor for all installations you create Windows Installe...

Page 18: ...ter Product Details and General Information To enter information about the installation you use pages in the Project Definition page group in Installation Expert To enter product details and general information 1 Click Installation Expert at the lower left of the application window Throughout this tutorial you will use pages in Installation Expert The pages are listed in the left pane they are org...

Page 19: ...ld define its structure To create the structure of an installation you define 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 Determine features and conditions before configuring other aspects of the installation because all other system changes adding files adding...

Page 20: ...g Core and then press Tab Title Core Parent Leave the default Target Platform Leave the default Description QuickFacts program and help files Required Feature Mark this Remaining options Leave the defaults Name Birds Title Birds Parent None Target Platform Leave the default Description Facts about birds Required Feature Leave the default Remaining options Leave the defaults Name Cats Title Cats Pa...

Page 21: ... Installation Expert Tasks in This Section z Adding files to the installation z Adding registry keys z Adding a shortcut z Creating a file association Before you perform these tasks you must have created an installation project See Create a New Installation Project on page 17 Add Files to the Installation On the Files page you specify the directories and files that will be installed on the destina...

Page 22: ... the upper right list box select License txt QckFacts exe and ReadMe txt and click Add File The three files are added to the QuickFacts INSTALLDIR directory in the installation 8 In the upper left list box expand the QuickFacts directory and select the Help subdirectory 9 Make sure the QuickFacts INSTALLDIR directory is still selected in the lower left list box and click Add Contents 10 On the Add...

Page 23: ...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 13 should appear next to the All Features name indicating that the installation contains 13 fil...

Page 24: ... the Shortcut File Selection dialog box select the QuickFacts directory in the left pane select QckFacts exe in the right pane and click Next 6 On the Shortcut Destination Directory dialog box make sure the Programs directory under the Start Menu is selected and click Finish 7 On the Shortcut Details dialog box change the Name field to QuickFacts and click OK A shortcut for QckFacts exe is added t...

Page 25: ...s you must have assembled the installation See Assemble the Installation on page 21 Set System Requirements You can specify minimum hardware and software requirements for the installation and set warning messages that appear to the end user if the destination computer does not meet specified requirements To set system requirements 1 Under the Target System page group select the System Requirements...

Page 26: ...cal or Custom on the Installation Type dialog box On the Installation Types page you turn features on or off for each type of installation To configure installation types 1 Under the User Interface page group select the Installation Types page The upper left list box shows three installation types by default Typical Complete and Custom which correspond to the three radio buttons presented to the e...

Page 27: ...es 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 pre install Windows Installer Tasks in This Section z Creating releases z Customizing the demo release properties Before you perform these tas...

Page 28: ...ard release In this procedure you customize the demo release so that z It includes limited features z The product s name indicates that it is a demo z The product s summary informs the end user that this demo release includes limited features To customize the demo release 1 Under the Release Definition page group select the Release Settings page 2 From the Current Release drop down list select Dem...

Page 29: ...you need to compile it into an MSI Because the installation consists of two releases compiling will result in two MSI files one for each release After compiling you can test the installation Before you perform this task you must have defined releases See Define Releases on page 27 Note This procedure guides you through testing the installation on your computer If you were really distributing this ...

Page 30: ...the result of the features you set on the Release Settings page 6 Proceed by accepting the defaults on the remaining dialog boxes 7 Now run the installation of the standard release which installs the files a Click Run at the lower right of the window and select Run from the button menu b On the Select an MSI File dialog box select QuickFacts msi and click OK The standard release of the QuickFacts ...

Page 31: ...on and resume the tutorial at a later time This tutorial contains examples of how to z Call a DLL With a Custom Action z Set a Directory With a Custom Action z Call an EXE With a Custom Action These exercises demonstrate the power and versatility that custom actions add to the installation building process This section also describes some of the advanced tasks you can perform using Setup Editor in...

Page 32: ... 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 Press Ctrl F to open the Find dialog box b In the Find dialog box enter InstallFiles in the Find What field and make sure Normal Installation is selected in the In What drop down list c Click Find Next d Clic...

Page 33: ... the four parameters listed below Click OK on the DLL Parameter Details dialog box after entering each parameter First parameter 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 P...

Page 34: ...ppears 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 ...

Page 35: ...ected 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 Set a Directory With a Custom Action In this section you create a custom action that changes the location of the installation based on end user interaction with the installation wizard To do this you z Create a...

Page 36: ... box appears where you create a new property to hold the value of the check box 6 Complete the dialog box a In Name enter COMMONDIR all uppercase b Leave the Value field blank The check box value must evaluate to blank nothing initially so that the check box is not marked when end users first see it c Leave the defaults in the remaining fields d Click OK Note Technically leaving a property blank i...

Page 37: ...ser sees during installation The User Interface sequence gathers end user input and sets installation properties 4 Scroll to near the end of the script and select the If Installed AND RESUME OR Preselected AND NOT PATCH then statement You will place a new If block above this line 5 In the Actions list double click Set Directory The Set Directory dialog box appears 6 Click the Details tab and compl...

Page 38: ...ears 10 In If Condition specify two conditions joined by AND Enter the following case sensitive 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 check box which is true if the end user marks it during installation The second condition checks a built in Windows Installer property named Insta...

Page 39: ...s folder check box When this installation is finished the QuickFacts directory should appear in your Common Files directory Call an EXE With a Custom Action In this section you create a custom action that calls an EXE and passes parameters to it This action calls Notepad exe and passes the name of the QuickFacts readme file to it causing the readme file to be displayed during installation Before y...

Page 40: ...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 path Also you don t have to specify the full path to readme txt because in the previous field you set the current working directory for Notepad to the QuickFacts directory where readme txt resides The dialog box...

Page 41: ...ion by clicking Compile at the lower right of the main window 3 To run the installation click the Run button select Uninstall Install from the button menu and when prompted select QuickFacts msi 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 box displays the value of INSTALLDIR during installat...

Page 42: ...ly z Edit installation dialog boxes by adding and editing text and controls z Select dialog boxes to appear during maintenance installations repair and uninstall z Create properties for use in custom installation logic z Create and edit components manually and assign them to features z Build complex conditions that must be met for an installation to occur For instructions on the tasks listed above...

Page 43: ...tor This tutorial includes only the procedures that have content that is specific to the Visual Studio integrated editor Note If you install Wise Installation Studio or Wise Installation Express before you install Visual Studio some of the files you need for this tutorial are not installed To install those files perform a repair on the Wise Installation Studio or Wise Installation Express installa...

Page 44: ...ompile all projects 6 When the compile finishes select File menu New Project The New Project dialog box appears 7 On the New Project dialog box a In Project Types select Wise Setup and Deployment Projects b In Templates select Setup Wizard c In Name enter QuickFacts Installer d Before you set the Location select the Add to Solution option In Visual Studio 2005 or 2008 this is available from the So...

Page 45: ...or all features simultaneously making it easier to see the installation as a whole To open the installation project and set options 1 In Solution Explorer double click QuickFacts Installer wsi Make sure you double click the WSI file shown below not the project name The Visual Studio integrated editor opens and displays QuickFacts Installer wsi 2 Select Tools menu Options Select the projects to inc...

Page 46: ...ect Definition page group on the left click Product Details The Product Details page appears It contains meta data that is used in the installation dialog boxes to identify the product to the user who is installing it The Product Name Manufacturer Version and Default Directory fields are populated with information from the main project 4 In the Application Type field select NET Application in the ...

Page 47: ...which you are adding files You do this by selecting it from the Current Feature drop down list In the Visual Studio integrated editor installations synchronize automatically with the other projects in the solution Example Adding EXEs DLLs OCXs and assemblies to the solution adds them to the installation Therefore this installation already contains files that are primary outputs of the three C proj...

Page 48: ... Feature drop down list the number 11 should appear next to the Core feature name This indicates that the Core feature contains 11 files This completes the file additions for the Core feature Now add files to each of the remaining features To add files to the remaining features 1 Add files to the Birds feature a From the Current Feature drop down list select Birds b In the lower left list box clic...

Page 49: ...tutorial are the same for both editors except for the following differences in the Visual Studio integrated editor z You don t need to add a shortcut on the Shortcuts page because it is added automatically However on the Shortcuts page you should select the Core feature double click the shortcut and change its destination directory to Windows Profiles Start Menu Programs z To compile the installat...

Page 50: ...t installing 8 starting Wise Installation Studio Express 15 SVS Driver installing 8 system requirements NET Framework 10 Visual Studio integrated editor 10 Wise Installation Express 9 Wise Installation Studio 9 system requirements Wise product Refer to Getting Started Guide T tutorial advanced 31 basic 16 integrated editor 43 prerequisites 17 Refer to Getting Started Guide U upgrade from Express t...

Reviews: