Symantec SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0 Reference Download Page 301

Page: 301 / 302

Wise Package Studio Reference

301

running with shortcut 108

tutorial

Refer to Getting Started Guide

Unassigned group 41
uninstall

patch 138

uninstall tests

about 193
not appearing 194
running 194
with group 166

uninstall, capturing 217
upgrade, preparing for 138
UpgradeSync 138

command-line options 285
not available 78
running 139

upgrading

errors, avoiding 138
patch, creating 130
specifying for patch 134
specifying version for 133

URL, Management Reports 86
user

Admin 41
creating 41
defined 41
group assignment 42
name, Wise Package Studio 42
password, Wise Package

Studio 42

user account, server-side service 143
user group

See group

user security

See security

user-defined test case 172

validation

Also see Package Validation
error 147
of installation 146
terminal server compatibility 157
test descriptions 156

Validation directory 26
validation module

about 148
adding 148
customizing 148
predefined 156
selecting 146
selecting rules 149

validation rule

about 152
action 154
calling .DLL 151

calling .EXE 151
calling custom action 150
calling VBScript 151
condition 154
creating 150, 153
editing predefined 155
selecting 149

variables

about 75
adding to help text 71
in Project Directory field 55
in Vendor Package field 56
list 75

VBScript file

calling with validation rule 151

vendor

name 56
package 56

VendorPackage variable 75
Verify Installation, test case 177
Virtual Capture

about 237
capture method 225
limitations 238

virtual memory page file, for SOE
Snapshot 243
Virtual OS

about 237
creating 239
creation utility 239
selecting 226

Virtual OS directory 26
Virtual OS file

defined 32

Virtual Package Editor

about 88
command-line options 285

virtual software archive 32
virtual software layer

capturing in 219
running Test Expert 164

virtual software package 30
virtual software project 32
VSA file 32

wamdb.idx

about 27

Web application

adding as tool 68
allow connection attempts 52
connecting 79
override URL 69, 79
URL disabled 79

Web Capture Conversion 141
wildcard, excluding with 213
Windows 2000, validation checks 156
Windows 2003

with Preflight 265

Windows Application.msi 36
Windows Installer

administrative installation 257
advantages 15
capturing installation to 219
database 31
developer documentation 34
help 34
logo requirements 156, 157
package, defined 31
project, defined 32

Windows Installer Editor

about 88
command-line options 286
not available 78

Windows Installer SDK Help 34
Windows NT

authentication 39
importing security group 42

Windows Vista

logo requirements 157

Windows XP, isolation 93
WinINSTALL package, converting 115
WinSxS directory 93
Wise package definition file

See package definition

Wise Services database

about 23

Wise share point

See share point directory

Wise Software Repository

about 23
active 23
adding files from 144, 206, 232
connecting 53
default, changing 53
multiples 23

Wise Software Repository database

See Software Manager database

Wise Task Manager

about 141
using 142

Wise Task Manager task 141
Wise Users group 41
Wise Web Capture

decrypting output 141
using 245

WiseComCapture.exe 207
WisePSSC.ini

about 202
basic exclusion list 247
using 205

WiseScript

capturing installation to 219
converting to Windows

Installer 116

editing 89

Summary of Contents for SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

Page 1: ...Wise Package Studio Reference ...

Page 2: ...NTIES 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 DOCUMENTATIO...

Page 3: ...elivers automatic software upgrade protection z Advanced features including Account Management Services For information about Symantec s Maintenance Programs you can visit our Web site at the following URL www symantec com techsupp Contacting Technical Support Customers with a current maintenance agreement may access Technical Support information at the following URL www symantec com techsupp Befo...

Page 4: ...that are related to CD ROMs or manuals Maintenance agreement resources If you want to contact Symantec regarding an existing maintenance agreement please contact the maintenance agreement administration team for your region as follows Additional enterprise services Symantec offers a comprehensive set of services that allow you to maximize your investment in Symantec products and to develop your kn...

Page 5: ...pertise 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 resources Educational Services Educational Services provide a full array of technical trainin...

Page 6: ... Point Subdirectories 28 Integration with Software Virtualization Solution 29 About Virtual Software Packages 30 Wise Package Studio File Types 31 Wise Package Studio Status Types 33 Product Documentation 33 Chapter 2 Setting Up Wise Package Studio 35 Steps for Setting Up Wise Package Studio 35 Using the Initial Workbench Setup Project 38 About Wise Package Studio Security 38 Integrating With Wind...

Page 7: ...Package Studio Variables 75 Chapter 4 Repackaging Applications and Managing Projects 76 About the Project and Tools tabs 76 Using the Projects Tab 76 Using the Tools Tab 78 Connecting to a Web Application 79 Managing Projects 80 Entering Project Tracking Information 80 Assigning Users to Tasks in a Project 81 Entering Time for Tasks 82 Viewing Project Metrics 83 Creating a To Do List 84 Workbench ...

Page 8: ...tion 120 Altiris RapidInstall Package Conversion Guidelines 121 Converting an Altiris RapidInstall Package 122 Package Definition 123 Creating a Package Definition File 124 Setting Exclusions in Package Definition 127 Patch Creation 128 About Patch Sequencing 129 Creating a Patch File 130 Specifying Previous Versions for Patches 133 Advanced Upgrade Version Details 134 Adding a Digital Signature t...

Page 9: ...o be Ignored During Uninstall Tests 171 Adding a User Defined Test Case 172 Test Case Reference 172 Installation Tests 173 How to Run Installation Tests 174 Launch Conditions Test Case 176 OS Conditions Test Case 176 Verify Installation Test Case 177 Standard Tests 177 Check Internet Connection 178 Check Network Location 178 Database Connectivity 179 Execute Program 180 Application Verification Te...

Page 10: ...apturing an Installation 219 Specifying the Installation File 223 Configuring SetupCapture 224 Selecting the Capture Methodology 224 Selecting a Virtual OS File 226 Beginning the SetupCapture 226 Using a Previous Scan 227 Executing Installations to Be Captured 228 Editing SetupCapture Inclusions 228 Editing SetupCapture Exclusions 229 Finishing SetupCapture 230 Adding Merge Modules Instead of File...

Page 11: ... Command Line Options for InstallTailor 273 Command Line Options for Legacy Setup Conversion 274 Command Line Options for Linux Package Editor 276 Command Line Options for Mobile Device Package Editor 277 Command Line Options for Package Distribution 277 Command Line Options for Package Relationships 278 Command Line Options for Package Validation 279 Command Line Options for Patch Creation 280 Co...

Page 12: ...e and release management Use Wise Package Studio to z Improve the reliability of software installations which reduces support costs and increases end user productivity Wise Package Studio provides the processes and tools to effectively test an application prior to mass deployment z Enable faster and more reliable software rollouts by streamlining the process of preparing applications for distribut...

Page 13: ... that may be either centralized or distributed It provides advanced project management functionality and security helping organizations create and manage a formalized enterprise wide application integration process z Quality Assurance covers all aspects of testing Windows Installer packages including an easy way to conduct multiple testing activities in both the lab and real world environments Wis...

Page 14: ...cation typically the installation file and instructions for running the installation when it is deployed typically a command line A package might also contain additional files that should be distributed with the installation example an informational text file This information represents a package definition z The source files associated with each package s installation Application A collection of ...

Page 15: ...ficult to capture all of the changes made to the operating system and a significant number of service pack files are Microsoft file protected MDAC is not repackaged because it is a merge module Advantages of the Windows Installer Format Wise Package Studio provides complete capabilities for migrating applications to Windows Installer format Using Windows Installer results in a solid robust install...

Page 16: ... of the user who is logged on to the computer z Easier deployment of application updates Windows Installer provides built in patching technology to update installed versions of a Windows Installer based application Unlike full installations a patch installation contains only the information necessary to update an installed version of the application During an upgrade Windows Installer detects whet...

Page 17: ...ee Adding Serial Numbers on page 49 If you entered a user name from a Windows NT account and Security Setup does not contain a security group that matches the domain group you belong to you are prompted to contact your Wise Package Studio administrator Enterprise Management Server only Wise Package Studio Logon Options Not available in Standard Edition When you start Wise Package Studio the Wise P...

Page 18: ...installed z You must have an Enterprise Management Server license z Security Setup must contain a security group whose name matches a valid group in the NT domain and you must be defined in that domain group If you are in multiple NT groups you are logged on under the first valid group that is encountered Option Workbench account entries Current NT account entries Windows NT account entries User N...

Page 19: ... Help link in the upper right of the right pane The right pane is visible only when you are in full screen mode For information about Workbench display modes see Resizing the Workbench Pane on page 22 The Projects Tab On the Projects tab you select a project from Active Project The left pane of the Projects tab displays either tools or tasks depending on whether the active project is associated wi...

Page 20: ...vailable tools To use a tool click the Run link to the right of the tool You do not have to use the tools in any particular order When a Project Has a Process Not available in Standard Edition When a project is associated with a process the left pane of the Projects tab displays the project s tasks When a task involves running a tool you run the tool by clicking the Run link to the right of the to...

Page 21: ...tool double click the tool name With Enterprise Management Server Security Setup determines whether you have access to the Tools tab Workbench resizing tools When a task is associated with a tool click this link to toggle between task help and tool help The Description tab displays help text for the active task When you run a Web application tool it opens in the Description tab The edition or modu...

Page 22: ...ack to full screen mode when you close all Workbench tools Side by side mode Hides the right pane and decreases the width of the left pane to make room for a tool window or dialog box Workbench changes to side by side mode when you start a tool or run a task The window size and position in this mode are retained from session to session Stay on top mode Hides the right pane and changes the left pan...

Page 23: ...and other resources that are used by an organization Other resources include merge modules device drivers Group Policy Objects and standard operating system environment snapshots A repository can contain multiple Software Manager databases See About the Software Manager Database in the Software Manager Help z Wise Services database Formerly named Preflight database Stores the following data that i...

Page 24: ...y for use or unintentionally changing a proven production package z Reduce conflicts between applications before deployment producing reliable error free deployments and reducing help desk calls When corporate developers have the Enterprise Edition of Wise for Windows Installer or Wise for Visual Studio NET they can use the Wise Software Repository to manage shared resources and ensure they always...

Page 25: ...nd Their Locations in the Windows Installer Editor Help Projects Project information including installation files SetupCapture reports and transform files Information for each project is stored in a separate subdirectory You define the subdirectory name when you create the project The subdirectory is created the first time you open the project on the Projects tab Package definition files WPF and t...

Page 26: ...nt rules language files and so on z Predefined Workbench reports TaskFiles Not available in Standard Edition Log files and INI files associated with tasks in the Wise Task Manager which are given a TMP extension This directory is created the first time you run an operation that is managed by the Wise Task Manager You can safely delete these files for tasks that have a status of Completed Templates...

Page 27: ...ou cannot revert The only recommended way to delete files from the share point directory is to delete the entire package from the Software Manager database When you do so you can delete the package s source files from the share point subdirectories 000 001 and so on if those files are not referenced by any other application See Deleting a Package in the Software Manager Help How Source Files Are I...

Page 28: ...rectory structure 000 001 and so on is created to hold the installation s source files z A temporary QUE file is created in the share point Scripts subdirectory Import to the Software Manager database z The QUE file is deleted z Package and resource information is added to the Software Manager database The installation file remains in the Projects directory and the Software Manager database refere...

Page 29: ...n use Wise Package Studio to create edit manage and distribute virtual software packages Wise Package Studio also incorporates the software virtualization technology into two of its tools to greatly enhance their capabilities See About Virtual Software Packages on page 30 Several script actions in the WiseScript editing tools specifically deal with virtual software packages You can use these scrip...

Page 30: ...e installation You can then edit the package with Virtual Package Editor A virtual software package created with SetupCapture does not retain any of the installation s configuration logic See About SetupCapture in the Virtual Package Editor Help z Virtual Package Editor Virtual Package Editor lets you edit any virtual software package You can edit the contents of a layer exclude data from a layer ...

Page 31: ...ibed below Extension Description CAB Cabinet file which consists of multiple files compressed into one A Windows Mobile device installation consists of a single self extracting CAB file which is generated by the CabWiz program from an information file INF EXE Installer file either created by you or obtained from a software vendor You create a WiseScript EXE by compiling a WiseScript project file W...

Page 32: ...rchive file created by the Virtual Package Editor when you compile a WVP file A VSA file is a portable virtual software package that becomes a virtual software layer when it is imported into Symantec SVS applet A VSA file is also created when you export a virtual software layer from Symantec SVS applet See About the Altiris SVS Applet in the Virtual Package Editor Help WOS Not available in Standar...

Page 33: ...rences Package Status Not available in Standard Edition Indicates the state of packages in the Software Manager database Use the package status to determine whether a package can be deployed to end users A package can have any of three statuses Under Development Available or Retired To set the package status either change the Status field in the Software Manager Package pane or run Software Manage...

Page 34: ...Getting Started Guide are also available as online help In the Wise Repository Manager select Help menu Help Topics or click the Help button on any of the Wise Package Studio installation dialog boxes 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 Sy...

Page 35: ...tup which contains tasks that help you perform these steps See Using the Initial Workbench Setup Project on page 38 To set up Wise Package Studio 1 Define company standards Define and document standards for repackaging applications Examples The privileges under which applications are installed What you need to do to incorporate inventory or licensing control within your environment How you registe...

Page 36: ... or make a snapshot of the standard operating environment SOE of a baseline computer This lets you find conflicts between applications and the SOE To perform this step run SOE Snapshot and then use Software Manager to import the snapshot into the Software Manager database See SOE Snapshot on page 242 and Package Import in the Software Manager Help Warning Predefined templates are read only Editing...

Page 37: ...ype of conflicts that are detected and the files and registry keys that are excluded from conflict detection Also decide whether to use conflict resolution rules and if so decide which predefined rule sets to use To perform this step run ConflictManager Select Setup menu Conflict Settings and edit the default settings based on your corporate standards Then select Setup menu Conflict Resolution Rul...

Page 38: ... the tool by clicking the View Tool Help link in the upper right of the right pane b If a Run link appears to the right of a task it means that the task is associated with a tool Click the Run link to start the tool then use the tool as needed to perform the task c As you finish each task mark the check box to the left of the task to indicate that the task is complete Tasks that are associated wit...

Page 39: ...ows security in several ways z During logon a user can specify how to validate their logon by selecting from a list of Windows NT domains z A user can log on to Wise Package Studio with their current Windows NT user name When the user starts Wise Package Studio they are logged on to Wise Package Studio automatically z In Security Setup instead of creating users individually you can import an entir...

Page 40: ... valid group in the NT domain See Integrating With Windows NT Security on page 39 4 In Permissions a Mark options to allow access to areas of Wise Package Studio No Access Members of this group cannot access the selected area View Members of this group can display the selected area but cannot make changes Edit Members of this group can add to or change information in the selected area b Under the ...

Page 41: ... assign them at least one license Wise Users This group is reserved for users who have a license for Professional Edition or Quality Assurance but not Enterprise Management Server Users are added or moved to this group when z You add a user with a license for Professional Edition or Quality Assurance z A user has a license for Professional Edition or Quality Assurance and Enterprise Management Ser...

Page 42: ... from the user s Windows NT password because you should not store NT passwords in the Workbench database 6 In a Windows NT environment you can enter the user s domain in Domain When the user starts Wise Package Studio while logged on to this domain they are logged on to Wise Package Studio automatically 7 From Group select the security group to assign this user to The new user is saved when you cr...

Page 43: ...o security groups according to the level of permissions you want to grant them Examples Administrator Usually the database administrator Workbench Users Users who repackage applications and manage conflicts You might create a separate group for team leaders if you want to give them access to more functions than other users Management Supervisors and managers who need to view conflicts create group...

Page 44: ...es X X X Delete Packages Delete packages from the database X X Change Package Properties Edit the Package Attributes dialog box except meta data create and edit package relationships X X X Manage Meta Data Fields Add and edit meta data fields X X Edit Meta Data Values Edit meta data values in both Software Manager and ConflictManager X X X Change Package Status Change the Package Status in the Pac...

Page 45: ...figuration file in SetupCapture Configuration Clear this check box to force users to use the configuration file on the share point for all SetupCaptures and SOE Snapshots z Modify Configuration File on Share Point Lets users edit the shared configuration file in the share point directory Limit this permission if you plan to develop a global configuration file and maintain its integrity for all cap...

Page 46: ...nd Modify Configuration File on Share Point are cleared Or z Allow Non Shared Configuration File is marked and Modify Configuration File on Share Point is cleared and the configuration file in the share point directory is selected Note If this button is disabled the user can select the Do not change current configuration file option on the Welcome dialog box to enable it Any changes they then make...

Page 47: ...ored in the Workbench database Therefore if a user selects a different share point directory in Workbench Preferences and thus a different Workbench database that user must have a different license assignment in the Workbench database that they change to Users must be assigned a license for each edition and module of Wise Package Studio that they will use Examples z Company A has a repackaging tea...

Page 48: ... licenses However to facilitate the process license assignments can also be made z When an unassigned user logs on to Wise Package Studio Professional Edition only With Enterprise Management Server the Wise Package Studio administrator must assign licenses The first time an unassigned user logs on to Wise Package Studio if a license is available they are prompted to select a license If no license ...

Page 49: ...Studio from User Licensing Setup Add them from the Evaluation Central dialog box which appears when you log on to an evaluation version On the Add Serial Number dialog box you can import a license file containing multiple licenses A license file is a text file with the extension WLC and the following format serial number user name Example XXXX XXXX XXXX XXXX maryk The user name is optional however...

Page 50: ...rs must be assigned a license for each edition or module of Wise Package Studio they will use You assign licenses to users in User Licensing Setup With Enterprise Management Server you also can assign licenses in Security Setup Before you can assign licenses to users you must add serial numbers to the Workbench database See Adding Serial Numbers on page 49 With Enterprise Management Server you mus...

Page 51: ...ight need to move the new user to another group in Security Setup after you assign licenses Example When you add a user without assigning a license the user is added to the Unassigned group After you assign a license you can move the user to a different group Deleting Serial Numbers Not available in Standard Edition You can delete serial numbers from the Workbench database which means they will no...

Page 52: ... Installer Editor or WiseScript Package Editor This check box also appears in the preferences for each editor this global setting affects the settings in the individual editors The backup file name consists of the current file name plus a number Example if the current file name is Sample wsi the backups are named Sample1 wsi Sample2 wsi and so on Only the file you are working on is backed up Examp...

Page 53: ...not copy resources to the new location Typically you will specify a share point or path that is already in use To connect to a different repository Client installations only You can connect to a different repository by specifying the share point that is associated with it When you change the default share point you are logged off and prompted to log on Because serial numbers and license assignment...

Page 54: ...ith Enterprise Management Server Security Setup determines whether you have access to Project Setup See Adding a New Project on page 55 Project editing The predefined projects cannot be edited With Enterprise Management Server each project has an owner The owner can be a user a group or none When you assign an owner to a project you limit who can edit the project Project process In the Professiona...

Page 55: ... 3 In the project entry fields in the right pane specify the following Project Name Enter a unique name for this project Do not use the following special characters Project Directory Specify the directory in which to store all files associated with this project If multiple users will work on this project enter a network directory You can add Wise Package Studio variables to the path See Wise Packa...

Page 56: ...n the Software Manager database If this project creates a Windows Installer package it will have this package name when it is opened in Windows Installer Editor on the Product Details page and Software Manager File Name Enter the name to use for all files that are created and used by the tasks in this project An appropriate extension is appended to each type of file Example If you enter Sample her...

Page 57: ... the right of Process Making changes here does not affect the original process template or any other projects that use the same process template Warning If you change the process or select a different process after work on this project has begun any existing task data will be lost Notes Enter any additional information about the project 4 To undo all changes you made to the new project right click...

Page 58: ...r program but might be something that you need to perform during the course of the process You can organize tasks into parent tasks and subtasks About predefined processes Wise Package Studio contains predefined processes that are based on industry best practices View the predefined processes to see if they meet your needs If not you can duplicate one and customize the copy for your organization o...

Page 59: ...esses that are based on industry best practices To see the predefined process templates select Edit menu Process Templates Predefined process template names are gray because they cannot be changed This allows for updates and enhancements to the predefined process templates in future releases However you can duplicate them and customize the copies You can also copy tasks from predefined process tem...

Page 60: ...e process templates in that database become visible in Workbench and the predefined process templates in the local database become unavailable If the external share point is disconnected or otherwise unavailable then the predefined process templates in the local repository become available Process templates that users create in their local database are always available Repackage into VSA format Le...

Page 61: ...u can create processes in a regional database to be used only by members of a specific team To add a new process 1 Select Edit menu Process Templates The Process Templates Setup dialog box appears 2 Right click in the left pane and select Add Process A new process appears in the list on the left with process entry fields on the right 3 In Process Name type the name for this process 4 In Process No...

Page 62: ... With Enterprise Management Server Security Setup determines whether you have access to Process Templates Setup Note You can copy a task from any process into processes that you create Because predefined processes are read only you cannot copy tasks into them but you can copy tasks from them When you copy a task any help associated with that task is not copied the new task refers to the original h...

Page 63: ...e executable stored in the same directory on their computers Options Optional Enter command line options to change the default behavior of this tool or application See Guidelines for Entering Command Line Options on page 72 Pre defined Application This task requires the user to run a program other than a Workbench tool When this task is displayed on the Projects tab clicking its Run link starts th...

Page 64: ...he Resolve conflicts task is completed you can change the project s status to Testing If you select Do not change the project s status will not change when this task is completed This drop down list does not appear if this is a header task 8 Optional Specify or enter help text to appear when a user clicks this task on the Projects tab Mark one of the following options See Help for Tasks and Tools ...

Page 65: ...tes Setup To delete a process 1 Select Edit menu Process Templates The Process Templates Setup dialog box appears 2 Right click a process in the process list and select Delete Deleting a process template does not affect any existing projects because each project contains its own a copy of the process Deleting a process cannot be undone Importing and Exporting Processes In Process Templates Setup y...

Page 66: ...menu You can create a task hierarchy with parent tasks and subtasks To see an example of a task hierarchy expand any of the predefined processes in the process list When you create a task hierarchy you might want to set up the first level of tasks as header tasks and use them to organize sets of subtasks See Adding Tasks to a Process on page 62 With Enterprise Management Server Security Setup dete...

Page 67: ...of your processes require the user to use Microsoft Word you can create a tool that runs Word With Enterprise Management Server Security Setup determines whether you have access to Tool Setup You also can use Security Setup to allow or restrict access to tools you create See Creating Groups and Setting Permissions on page 39 To add a new tool 1 Select Edit menu Tools The Tool Setup dialog box appe...

Page 68: ...s check box to hide this tool in the Tools tab When you hide a tool you still can associate it with a task but users cannot start it from the Tools tab This prevents users from running the wrong tool accidentally and from using tools that should only be used from within a process You also can use this check box to hide predefined tools that your company never uses This option does not affect tasks...

Page 69: ...ange to all users who do not have a local override If you clear this check box the URL is changed in your registry and does not affect other users If Allow Local Override of URL is cleared this is marked by default and cannot be changed 7 Complete the tool entry See Adding a New Tool on page 67 Duplicating Deleting and Rearranging Tools Not available in Standard Edition Use Tool Setup to duplicate...

Page 70: ...L or RTF format and associate the help file with the task or tool Write HTML format help outside Workbench You can write RTF format help text directly in Workbench With Enterprise Management Server Security Setup determines whether you have access to Process Templates Setup and Tool Setup Using HTML for help In Process Templates Setup or Tool Setup mark the HTML option and in the Location field th...

Page 71: ...d name add the following variables to the help text ProjectDir ProjectName wsi Insert Object Inserts an object such as an image into your help text Click this to open a standard Windows Insert Object dialog box where you can select the object to insert Available objects can vary depending on the computer If you add an object that other users do not have on their computers they will not see the obj...

Page 72: ...To customize the way a predefined tool runs it is best to add command line options when you associate that tool with a task in Process Templates Setup There you can select from predefined command line options for that tool These predefined options have plain English descriptions that make it easier to understand what each command line option does You can define options for the predefined tools or ...

Page 73: ... tool To produce more specific tool behavior on the task level you can enter command line options in Process Templates Setup when you create a task that runs a tool Example Package Distribution requires the following option to run workbench exe tool Package Distribution That is the option specified in Tool Setup Adding the option tgt 23 to the command line runs Package Distribution and selects the...

Page 74: ...ool has a wizard interface the wizard must be completed through the final page Canceling the tool does not mark the task complete Note This option does not work for user defined tools because it requires a return code from the application Mark task complete if following file changes The task check box is marked only when the file specified in the File Path field changes Example If you have a task ...

Page 75: ...tup Some variables are not available in all Wise Package Studio editions and modules Available variables ApplicationName The current project s Application Name field in Project Setup FileName The current project s File Name field in Project Setup Notes The current project s Notes field in Project Setup PackageName The current project s Package Name field in Project Setup PackageStudioDir The direc...

Page 76: ... and To Do tabs See Using the Projects Tab on page 76 Using the Tools Tab on page 78 Using the Projects Tab Use the Projects tab to work on projects that you create in Project Setup See About Projects on page 54 When you create a project you can associate it with a process See About Process Templates and Tasks on page 58 If you associate a project with a process you can take advantage of the proce...

Page 77: ...o the right of a task the task is associated with a tool Click the Run link to run the tool Note When you click the Run link if the tool program cannot be found on your computer a dialog box appears that lets you browse for the program Wise Package Studio records the location you specify so it can find the program the next time you run that tool When you run a tool from the Projects tab the tool m...

Page 78: ...ls on page 87 About Capturing Applications on page 201 About ConflictManager in the ConflictManager Help About Linux Package Editor in the Linux Package Editor Help About Mobile Device Package Editor in the Mobile Device Package Editor Help About Software Manager in the Software Manager Help About Virtual Package Editor in the Virtual Package Editor Help About Windows Installer Editor in the Windo...

Page 79: ...the application resides Example http computer_name virtual_directory application asp Specifying a new URL might change the URL for other users See below z If you do not specify a new URL the Connection Failed dialog box might continue to appear as you use Workbench To prevent future connection attempts and disable the dialog box mark Prevent Connection Attempts to Web Applications To activate the ...

Page 80: ...group You cannot edit project tracking information for the predefined projects Sample Project and Initial Workbench Setup You can make a duplicate of these projects and edit them See Duplicating or Deleting a Project on page 57 To enter project tracking information 1 Click the Projects tab or press Alt P 2 From Active Project select a project that is associated with a process 3 In the right pane c...

Page 81: ...ered here automatically See Entering Time for Tasks on page 82 Remaining Hours After work on the project begins use this field to record the number of hours of work that remain Example Suppose you originally estimated the project to take 40 hours and you ve completed 20 hours However because you know the remaining tasks will take 30 hours you enter 30 hours here This provides a more realistic numb...

Page 82: ...er the time spent on tasks This provides data for determining the difference between estimated and actual time spent on project tasks Having historical data will help improve the accuracy of estimates for future repackaging projects You can view this information in the Project Variance report See Workbench Reports on page 85 Security Setup determines whether you have access to the Project Manageme...

Page 83: ... tool the start date is recorded when a user first clicks the Run link for that task If the first task is manual the start date is recorded when the user marks the task s check box or moves to the next task z Actual Completion Date The date when the last task in the project is marked complete z Elapsed Time The total amount of time in HH MM SS format the project has been open in the Active Project...

Page 84: ... the first task in your project is Analyze vendor package and a later task is Test package The person who performs the analysis task can make notes about issues discovered during the analysis and enter to do items to record specific things the tester needs to do during the testing task In a project that has no process you can use the to do list to provide general guidelines for the users who will ...

Page 85: ...tion as the Project Overview report but also lists each project s tasks the user assigned to each task and each task s status A project leader can use this report to check the status of individual tasks for a project Project Variances Enterprise Management Server Lists project estimated and actual completion dates and times and their variances You can generate this report for all projects or proje...

Page 86: ...port by clicking Print in the lower right of the report viewer window Perform a text search by clicking within the report and typing Ctrl F To generate a report through the Management Reports Web application Enterprise Management Server only 1 In your browser enter the URL for Management Reports The Management Reports URL is http server name Wise_Management_Reports where server name is the name of...

Page 87: ... Tools tab the tools are organized to correspond to the phases of the application management lifecycle To run a tool double click the tool name z On the Projects tab you click the Run link to the right of the tool or in a project with a process to the right of the task associated with the tool When you run a tool from the Projects tab the tool might skip pages or populate fields based on command l...

Page 88: ...cation See About Mobile Device Package Editor in the Mobile Device Package Editor Help z Package Definition z Package Distribution z About Package Validation z Patch Creation z Preflight Analysis See Viewing Results from Preflight Deployment on page 263 z Preflight Instrumentation See Creating a Preflight Package on page 262 z SOE Snapshot on page 242 Not available in Standard Edition z SetupCaptu...

Page 89: ...anager the tool you are using checks the file s revision control status This table shows what the tool does for each revision control status You can view a package s revision control status in the Application Package Summary pane in Software Manager See Revision Control in the Software Manager Help Application Isolation Not available in Standard Edition Application Isolation provides a quick and e...

Page 90: ...Isolation has the potential to change the location of files within your installation and to change the feature and component layout of the installation database test the package thoroughly after using Application Isolation For further reading See Isolated Components in the Windows Installer SDK Help In the MSDN Library msdn microsoft com library search for the following terms Assembly manifest Iso...

Page 91: ...n type Automatically isolate application files This option automatically isolates all applications with all support files in the installation Example Suppose your installation contains Sample1 EXE Sample2 EXE and Sample3 EXE and also contains four DLLs stored in the System32 directory All four DLLs will be copied to the application directory and if any of the three EXEs call any of the DLLs the sy...

Page 92: ...s for isolation and to store files in the WinSxS directory the Digital Signature Information page appears You must digitally sign files that are stored in the WinSxS directory Enter paths to the digital signing files you obtained from your digital signature provider such as Verisign and click Next 11 On the Perform Isolation page click Next Isolation is performed which might take a few minutes The...

Page 93: ...n Windows XP or later and uses manifests for isolation 2 Mark the assembly type Create private side by side assemblies in application directory Files and manifests which together form assemblies are installed to the application directory if they are isolated Create shared side by side assemblies in WinSxS directory Isolated assemblies are stored in the WinSxS directory a global directory in the Wi...

Page 94: ...ent features they would not be isolated with each other If you chose manual isolation only files in the same feature as the EXE appear on the Select Files to Isolate page 2 From Repair Support for Isolated Files mark one of the following options Do not add repair support for isolated files Isolated files in the installation do not have self repair Install isolated files in their original location ...

Page 95: ... are accessed during the normal course of operating a computer and that typically have nothing to do with a specific application Likewise when you create a WiseScript installation WSE with ApplicationWatch Professional Edition only a built in exclusion list is used Though you cannot access this built in list you can add exclusions to it To do this open WiseScript Package Editor and select Edit men...

Page 96: ...o ensure that files used by rarely used features are recorded Do not use the application to print because printing accesses Windows operating system and printer specific files 7 Close the application return to the Run Application page and click Next In the Standard Edition the Finish page appears Click Finish and skip the next steps In the Professional Edition the ApplicationWatch Inclusions page ...

Page 97: ... update Command lines let you change the behavior of a package to account for different work environments and end user requirements You can specify the following UI Options Windows Installer provides package developers the ability to create user interfaces with multiple levels of functionality Using a command line you can control what level of functionality the end user sees during the installatio...

Page 98: ...s Note Although you can enter a command line in the Command Line field we recommend that you use the options provided in this utility for an optimal error free installation 5 Select an Install Mode These options with the exception of Update are available only if you specified a file in the File Location section on the Welcome page Install Installs or configures the installation package Select this...

Page 99: ... on page 101 Advertising Options Advertise applications and apply a transform to the advertised package See Adding Advertising Options to Your Command Line on page 102 Repair Options Repair installed files See Adding a Repair Option to Your Command Line on page 103 Edit Properties Change the value of public properties See Editing Public Properties With a Command Line on page 104 Apply Transforms A...

Page 100: ...he installation Note Modal dialog boxes require user input whereas modeless dialog boxes don t qr Reduced UI Displays authored modeless dialog boxes and built in modal error message boxes during the installation qf Full UI Displays both modal and modeless dialog boxes that have been authored into the internal user interface and built in modal error message boxes during the installation qn No UI Di...

Page 101: ... Your Command Line The Command Line Builder lets you create a command line that sets logging options that determine what activities are logged during the installation For information on logging options see Logging in the Windows Installer SDK Help You can set logging options for all versions of Windows Installer or for Windows Installer 3 0 only To add logging options to a command line 1 On the De...

Page 102: ...on computer only if it has Windows Installer 3 0 or later installed 6 Click OK The Define Command Line page reappears and the selected logging options are added to the command line Adding Advertising Options to Your Command Line Windows Installer can advertise the availability of an application to end users and to other applications without actually installing the application If an application is ...

Page 103: ... Options see REINSTALLMODE Property in the Windows Installer SDK Help To add a repair option to a command line 1 On the Define Command Line page select Repair from Install Mode See Creating a Command Line With the Command Line Builder on page 98 The Repair Options button appears 2 Click Repair Options The Repair dialog box appears 3 Complete the dialog box p Reinstall only if file is missing o Rei...

Page 104: ... transforms see TRANSFORMS Property in the Windows Installer SDK Help To apply transforms with a command line 1 On the Define Command Line page select Install from Install Mode See Creating a Command Line With the Command Line Builder on page 98 The Apply Transforms button appears 2 Click Apply Transforms The Transform List Builder dialog box appears 3 Click Add and specify the transform file MST ...

Page 105: ...log box appears 3 In the Add Remove section specify whether to add or remove patches Note 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 specify additional patches Note Windows Installer 3 0 or later is required to add multipl...

Page 106: ...cation s contact management component First you create a language transform to change the language of the installation dialog boxes to German Then you use InstallTailor to create a second transform based on the first transform that installs the contact management component When the second transform is run it applies the first transform to the base installation then applies the second transform Tra...

Page 107: ...pted to specify the base MSI if that information is not embedded in the transform The installation runs in a simulated mode 4 Step through the installation and make the changes to save in the transform The resulting transform when applied to the base installation will make the same changes that you make during this simulated installation 5 If the Hide Dialog check box is available on an installati...

Page 108: ... not possible in InstallTailor If you mark this the transform file opens in Windows Installer Editor after you click Finish If you started InstallTailor from the Projects tab this check box might not appear 9 On the Capture Complete page click Finish The MST and shortcut are created in the location you specified or in the current project s directory Double clicking the shortcut applies the transfo...

Page 109: ...ct the directory from the list which contains all the directories that are in the installation but do not appear in the Captured Changes list Default Value Read only The installation sets this value for this directory unless you override it Value To override the default value or change the captured value type a new value To use a property enclose the property name in brackets For example to set th...

Page 110: ...e the original installation project file you can convert the compiled EXE instead because it contains an embedded copy of the script z Because script installations are based on a different technology than Windows Installer not all elements of the script are converted to Windows Installer format Microsoft SMS IPF or EXE See SMS Conversion Guidelines on page 110 and Converting an SMS Installation on...

Page 111: ...rsion This tool might skip pages or populate fields based on command line options defined in Process Templates Setup On the Tools tab double click Legacy Setup Conversion 3 If the Select Source Format page appears mark Microsoft SMS Installer and click Next 4 Complete the Specify Files page and click Next Source Installation Specify the full path of the IPF or EXE to convert Target Installation Sp...

Page 112: ...tion If you converted an IPF files are referenced from their original locations If you converted an EXE files from the converted installation are stored in and referenced from the extract directory that you specified above Novell Conversion Guidelines Following are guidelines for using Legacy Setup Conversion to convert an existing application object from Novell ZENworks 3 x or later to a Windows ...

Page 113: ...files are hard coded in the AXT file Therefore if you move the AXT file to a different computer you must also move the directory containing the source files Then open the AXT file in a text editor such as Notepad find the section that contains Name SOURCE_PATH and change the Value of the source path to the new file location 2 Do one of the following On the Projects tab click the Run link to the ri...

Page 114: ... guidelines for using Legacy Setup Conversion to convert an existing OnDemand Software WinINSTALL installation to a Windows Installer package WSI or MSI In the Professional Edition you also can convert a WinINSTALL package to a WiseScript WSE z Legacy Setup Conversion cannot convert a WinINSTALL installation NAI or compiled executable directly you must first convert your WinINSTALL installation to...

Page 115: ...e same locations as specified in the original WinINSTALL installation Converting a WinINSTALL Installation To convert a WinINSTALL installation 1 In WinINSTALL open the installation and export it to a text file In WinINSTALL 7 or WinINSTALL 2000 use the Export command on the Actions menu The text file has the same name as the WinINSTALL installation but with the extension TXT and it is saved in th...

Page 116: ...4 10 Open the resulting package in Windows Installer Editor WSI or MSI or WiseScript Package Editor WSE to view the converted file and to resolve reported problems Pages in Installation Expert such as the Files page are populated based on the contents of the source installation WiseScript Conversion Guidelines Following are guidelines for using Legacy Setup Conversion to convert a WiseScript WSE t...

Page 117: ...If you are converting an EXE the Specify Temporary Directory page appears In Extract Directory specify a directory to hold the extracted files and click Next Files must be extracted from the EXE before the conversion can begin This becomes the source directory for the new installation 7 The WSE or EXE is converted to Windows Installer format When the conversion is finished the Conversion Complete ...

Page 118: ...logy than Windows Installer not all elements of the source installation are converted to Windows Installer format The installation is built from the configuration files defined by the IPR Files registry keys and shortcuts are converted The Product Name Product Version and Company Name Properties are also converted File source paths are retained The RUL file which controls how the resources are ins...

Page 119: ...rs click Save Errors or Print Errors 6 Click Finish More errors might appear at this point which have to do with saving in Windows Installer format 7 Open the resulting package in Windows Installer Editor to view the converted file and to resolve reported problems Pages in Installation Expert such as the Files page are populated based on the contents of the source installation If a file that is pa...

Page 120: ... of the MSI on a computer where the MSI is not installed If the InstallShield MSI specifies text strings to be found and replaced within SQL statements during installation these are not converted You must enter these in Windows Installer Editor on the SQL Server Scripts page If the InstallShield MSI recreates a SQL Server database during installation and does not use a SQL script to do this this i...

Page 121: ...indows Installer Editor SQL Server Operations If you mark this option SQL Server scripts that configure a SQL Server during installation are converted to the Windows Installer Editor format This information appears on the Installation Expert SQL Server Scripts page in Windows Installer Editor b Click Apply 5 Click Next to start the conversion Several progress dialog boxes appear The MSI or EXE is ...

Page 122: ...Package EXE and click Next The Welcome page of the Rip to MSI Migration Utility appears 3 Click Next The RIP Files to Migrate page appears 4 To select the RapidInstall packages RIPs to convert do one of the following Drag and drop RIPs from an explorer window Click Add 5 If you clicked Add complete the File Properties page and click OK Source RIP Path Specify the RIP file to convert Destination MS...

Page 123: ...ion file WPF which lists the files and command lines that make up the package The package definition file is saved in its own subdirectory of the share point Projects directory The files in the package definition are saved in a Files subdirectory of the package definition s project directory This ensures that all the files are in a shared location and are accessible when the package is distributed...

Page 124: ...ages or populate fields based on command line options defined in Process Templates Setup On the Tools tab double click Package Definition The Specify Package page appears 2 Complete the page Project Name Enter a name to identify the project when the package definition is saved in the share point Project directory Application Name Enter a name to identify this application in the Software Manager da...

Page 125: ...clusions list Exclusions Opens the File and Folder Exclusions page where you can specify the files to be excluded from this package You exclude files to reduce the size of the package for distribution Example Exclude readme files or a help directory See Setting Exclusions in Package Definition on page 127 Delete Deletes files that are selected in the lower pane Note If you add an MSI MSP or MST th...

Page 126: ...le is saved in its own subdirectory in the share point Projects directory All the files that you specified are copied to a Files subdirectory of the package definition directory A Microsoft hotfix that is in the package definition For information on Microsoft hotfixes search for Command Line switches for Windows software update packages at msdn microsoft com z We recommend that you first run the h...

Page 127: ...xclude page appears 4 To exclude a file a In File Wildcard specify a file b Directory is pre filled when you specify a file You can use environment variables surrounded by percent signs to specify paths To exclude the file for all local drives leave this field blank 5 To exclude a directory a In Directory specify a directory This causes Package Definition to ignore files in the top level of this d...

Page 128: ...tch Creation then sends the patch settings file to PATCHWIZ DLL which creates the patch file MSP Note Patch Creation is only applicable to Windows Installer MSI technology not WiseScript technology For patching WiseScript installations use the SmartPatch page in Installation Expert in WiseScript Package Editor Patch Creation guidelines z Before you use Patch Creation use UpgradeSync UpgradeSync co...

Page 129: ...mall update patches only Sequenced patches can be installed by Windows Installer 2 0 but the sequencing is ignored You add sequencing information to a patch during Patch Creation You can add sequencing to a patch you created previously Step through Patch Creation open an existing patch file enter sequencing information and complete the wizard to recompile the patch Order in which patches are appli...

Page 130: ... Process Templates Setup On the Tools tab double click Patch Creation The Welcome page appears listing the basic steps for creating a patch file The wizard guides you through each step 2 Click Next The Specify Patch Settings File page appears 3 Mark one of the following Create a new patch file This creates a new patch settings file PCP Open an existing patch settings file PCP file If you mark this...

Page 131: ...peat the steps above to add additional previous versions 8 When you finish click Next on the Specify Previous Versions page The Specify Upgrade Version page appears 9 Complete the page Upgrade MSI path The earlier versions of your application will be upgraded to the version you specify here By default the path to the current installation s MSI appears Advanced Click this to enter advanced settings...

Page 132: ...he Media table For patches these numbers must be at least 1 greater than the corresponding numbers in the most recent patch or MSI for this application installation To specify these numbers browse to the most recent patch file created for this installation Volume Label Enter the name of the CD or other media on which this patch will ship If the application needs repair in the future Windows Instal...

Page 133: ... installed only if the product code of the installed application on the destination computer matches the product code of the current installation The product code is located on the Product Details page in Windows Installer Editor Match Upgrade Code Leave this marked to make sure that the upgrade code is the same for the previous application and the upgrade application The upgrade code should alway...

Page 134: ...ir GUIDs to this list This list of GUIDs should not be delimited do not enter spaces or other characters between the GUIDs If any of these patches are found on the destination computer and are registered with Windows Installer they are unregistered and their patch transforms are removed from the list of transforms associated with the application This lets you apply a patch to an original installat...

Page 135: ...e key pair files This method requires a credentials file SPC or CER and a private key file PVK This method is supported by the signcode exe tool For details search for Signcode in the MSDN Library msdn microsoft com library z Personal Information Exchange file This method requires a Personal Information Exchange file PFX which is a container file for the public private key information This method ...

Page 136: ...lation z Certificate options Signtool exe with Personal Information Exchange file Mark this to use signtool exe and then specify the Personal Information Exchange file PFX to use This option requires a password 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 Se...

Page 137: ...Sequencing on page 129 Sequencing Patches and MsiPatchSequence Table in the Windows Installer SDK Help Specifying Advanced Patch Settings To specify advanced patch settings 1 On the Compile Patch dialog box of Patch Creation click Advanced to display the Advanced Patch Settings dialog box See Creating a Patch File on page 130 2 Complete the dialog box and click OK Do not create file patches use en...

Page 138: ...his to make this patch removable through Add Remove Programs When you make a patch removable enter values for the following meta data which is used by Add Remove programs Only the Classification is required Description Enter a brief description of the patch that will appear in Add Remove programs DisplayName Enter a name for the patch that will appear in Add Remove Programs Classification Required...

Page 139: ...ee Patching and Upgrades in the Windows Installer SDK Help UpgradeSync changes your current installation according to Microsoft s recommendations based on the type of upgrade you plan to make When you add new resources to an upgrade installation you can use component rules to ensure that the component GUIDs are aligned with those in previous installations See Using Component Rules to Align GUIDs i...

Page 140: ...en 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 errors cannot be fixed automatically and therefore have no check boxes File filename txt is a new resource that needs to be added to a new component and assigned to a new subfeature...

Page 141: ... database z Adding removing or replacing merge modules that are part of MSI or WSI packages in the Software Manager database z Compiling MSI or WSI packages in Software Manager or remotely compiling packages in Windows Installer Editor z Checking packages back into Revision Control in Software Manager Each of these managed operations consists of one or more tasks Because Wise Task Manager manages ...

Page 142: ...tus 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 When a task is executing An icon appears in the status column Details on the progress of the task appear at the bottom of the Wise Task Manager dialog box unless you select another task To use Wise Task Manager 1 Do one of the following On the Tools tab ...

Page 143: ... cancelled Performing Server Side Operations Not available in Standard Edition Wise Package Studio has a server side service that lets users on client computers perform certain operations on the Wise Package Studio server By processing operations on the server you reduce the workload of the client computer and if the packages and databases reside on the server you improve the operation s performan...

Page 144: ...ture a large application with many files the repository check can slow SetupCapture considerably Therefore you can disable this feature in SetupCapture Clear the Enable checking of files against Wise Software Repository check box in the General Settings of SetupCapture Configuration To add a file from the Wise Software Repository 1 Do one of the following to display the Files in Repository dialog ...

Page 145: ...recommend that you run the server side instance of Package Validation to reduce the time that it takes to perform the validation Package Validation contains predefined validation modules The validation modules are fully customizable to accommodate corporate standards z You can select which validation rules to use during the validation test z With the Quality Assurance module you can create new val...

Page 146: ...f the Specify Target Installation File or Folder dialog box appears select an installation file or a folder that contains multiple files and click Next If you select a single installation file the file can be an MSI WSI MSM WSM or MST If you select an MST and the program cannot find the base MSI file you are prompted to specify it If you select a folder that contains multiple installation files yo...

Page 147: ... module see ICE Reference or Merge Module ICE Reference in the Windows Installer SDK Help for details on the issue 9 If the Correct button is enabled when you select an issue click it to correct the issue When Package Validation checks multiple files the Correct button does not appear Warning If you correct a WSI or WSM it is recompiled to an MSI or MSM at the end of validation If you correct an M...

Page 148: ...ng which validation rules to use during the validation test See Selecting Validation Rules to Use on page 150 With the Quality Assurance module you also can create new validation modules and new validation rules Do this if you prefer not to modify a predefined validation module or to define a validation module that contains only your custom rules With Enterprise Management Server Security Setup de...

Page 149: ... specified appears in Validation Files 9 To add a rule to the validation module click Add to the right of the Validation Rules list To add a rule that Calls a custom action See Adding a Rule That Calls a Custom Action on page 152 Consists of a series of conditions and actions See Adding a Validation Rule Set on page 154 10 Enable or disable the rules to use during validation See Selecting Validati...

Page 150: ...e added When you select a validation module its rules appear in Validation Rules 4 In Validation Files select a validation module Quality Assurance module only If the validation module you want is not listed you can add it See Adding a Validation Module to Package Validation on page 149 5 In Validation Rules mark the check boxes for the rules to include 6 Quality Assurance module only To add a rul...

Page 151: ...That Calls a Custom Action Quality Assurance module only Note When customizing a predefined validation module customize a copy of the CUB file to retain the original file To add a rule that calls a custom action 1 Write a custom action DLL EXE or VBScript to perform validation checks 2 Do one of the following On the Projects tab click the Run link to the right of the task or tool associated with P...

Page 152: ...The OK button is unavailable if required fields are missing The Customized Validation Rules dialog box reappears and the new rule is displayed at the end of the Validation Rules list with its check box marked 13 To add more rules to this validation module either repeat this procedure or see Adding a Validation Rule Set on page 154 The customizations remain in effect until you change them About Val...

Page 153: ...lick Package Validation In Windows Installer Editor select Tools menu Package Validation 2 If the Specify Target Installation File or Folder dialog box appears select an installation file or folder and click Next 3 Click Customize on the Welcome dialog box The Customized Validation Rules dialog box appears Validation Files lists the predefined validation modules and any validation modules you ve a...

Page 154: ...r View dialog boxes Replace text with your message 13 If an action contains underlined text click the underlined text to open the Rule Details dialog box and specify its value Example If you selected the action Display text none in View Correct or View dialog boxes you would click the word none and enter specific text 14 When you finish adding actions click Finish The Validation Rules dialog box r...

Page 155: ...with the current project will be verified This tool might skip dialog boxes or populate fields based on command line options defined in Process Templates Setup On the Tools tab double click Package Validation In Windows Installer Editor select Tools menu Package Validation 2 If the Specify Target Installation File or Folder dialog box appears select an installation file or folder and click Next 3 ...

Page 156: ...ou validate a merge module z Windows Vista Windows 7 Compatibility Checks Runs WiseVistaIce cub which checks for adherence to Microsoft s package validation requirements for the Vista and later operating systems Wise Package Studio Checks The following checks are built in to Package Validation they do not run CUB files z Component design Checks that the proper files have been placed into each comp...

Page 157: ...odule ICE Reference in the Windows Installer SDK Help Windows Vista Windows 7 Validation The Windows Vista Windows 7 Compatibility Checks validation module in Package Validation runs WiseVistaIce cub which checks for adherence to Microsoft s package validation requirements for the Vista and later operating systems For information about Windows Vista logo requirements visit the MSDN Library msdn mi...

Page 158: ...Wise Package Studio Reference 158 Package Validation the rebuilt files run the utility on the edition of the operating system that your installations target ...

Page 159: ...m the Wise Software Repository Use Test Expert as part of your organization s quality assurance process for testing Windows Installer packages Test Expert generates test cases lets you create your own test cases tracks statuses and helps you create a test plan that fits your organization s needs Test Expert reads package contents and generates a Master Test Plan that contains test cases based on t...

Page 160: ...kages on page 166 Application That Is Installed on This PC Mark this to specify the cached MSI of an installed application Every time a Windows Installer installation is run a randomly named copy of the MSI is cached in the system directory The cached copy contains the installation information and logic but it does not contain the installation files Therefore if you open a cached MSI installation ...

Page 161: ...g Results Files on page 163 Setting Test Expert Preferences Quality Assurance module only To set Test Expert preferences 1 In Test Expert select Edit menu Preferences 2 On the Prompts tab reactivate prompts that you previously suppressed Example If an alert dialog box had a check box labeled Don t show this message again and you marked it the prompt would appear here To reactivate a prompt select ...

Page 162: ...t plan You do not run tests from the Master Test Plan view you must first select a test case See Running a Test Case on page 165 and About Test Cases on page 164 Master Test Plan Click Test Plan Details to display the master test plan in the right pane Test Groups Only groups that contain test cases are shown Opens the test plan for a Windows Installer package or group Test Cases ...

Page 163: ...tem but fail on another The results file can be opened and saved from within Test Expert so you can share testing results with co workers z To open a results file select File menu Load Results navigate to a WTE file and open it Any current testing results are immediately deleted z To save the current results file select File menu Save Results name the file and save it z To clear the current result...

Page 164: ...ated layers are deactivated If the installation test depends on something in a virtual software layer it will not be available because the layer is deactivated When the installation is complete the layers that were deactivated are reactivated When you run an uninstall test on a package that was installed into a virtual software layer the layer must be activated About the Altiris SVS Applet in the ...

Page 165: ... of the buttons at the top of the window Install Uninstall Execute or Run Not all buttons appear for all tests only relevant buttons appear For a description of each test case see Test Case Reference on page 172 5 After test execution set the status of test items to Pass or Fail Some tests set this automatically Then set the overall status of the test case to Pass or Fail See Setting Test Statuses...

Page 166: ...e already applied Setting Test Statuses and Details Quality Assurance module only You can set the status for a test case or a test item Test cases are listed in the left pane of Test Expert and test items appear in the right pane after you select a test case name z Some tests particularly application verification tests are run automatically and set test item statuses automatically In some cases th...

Page 167: ...ect the status in the Pass Fail dialog box that appears after you visually verify the test See Application Verification Tests on page 180 OR z For automated tests such as Prog IDs the status is set automatically To change details of a test item z Double click a test item and add comments in the Test Details field of the dialog box that appears This field is replaced each time a test is run Status ...

Page 168: ...s 2000 you cannot use Test Expert on these operating systems If your target computers include these operating systems use another method for testing your installations on these systems Testing on Multiple Computers Quality Assurance module only Some test cases in Test Expert might have to be run on multiple computers Example To test a launch condition that specifies Windows XP you must install not...

Page 169: ...vailable if a group is open See Uninstall Tests on page 193 In the initial dialog box of Machine Capture you can set options that govern how the snapshot is created These options are saved in a configuration file that is shared with both SetupCapture and SOE Snapshot See z Setting Directories to be Watched for Uninstall Tests z Setting a File Wildcard or Directory to Be Ignored During Uninstall Te...

Page 170: ...eates a snapshot of the current state of the computer Uninstall tests omit these files and directories from uninstall test results Uninstall tests are not available if a group is open Generally you should exclude anything that is temporary or anything that is likely to result from applications other than the one you are testing Example An installation might temporarily store files in a temp direct...

Page 171: ...ot of the current state of the computer Uninstall tests omit these registry entries from uninstall test results If this value or key changes during the installation it will be ignored in the results for uninstall tests Uninstall tests are not available if a group is open Generally you should exclude anything that is temporary or anything that is likely to result from applications other than the on...

Page 172: ... left pane of Test Expert and select Add Test Case The Add User Defined Test Case dialog box appears 2 Complete the dialog box Name Enter a unique name for this test case You cannot use the name of any of the test cases that Test Expert generates See Test Case Reference on page 172 Group Select the group that matches the type of test case you are adding The test groups are those that are listed in...

Page 173: ... Coverage Test Case on page 193 Uninstall Tests on page 193 Created Files Test Case on page 195 Created Registry Entries Test Case on page 196 Destroyed Files Test Case on page 197 Destroyed Registry Entries Test Case on page 198 Residual Files Test Case on page 198 Residual Registry Entries Test Case on page 199 Installation Tests Quality Assurance module only In Test Expert installation tests ar...

Page 174: ...sts 1 Close all applications other than Wise Package Studio and Test Expert including all background applications and services that might access files or registry entries on the testing computer Files and registry entries accessed by other applications can interfere with the test results 2 In Test Expert select a test case under the Installation Tests group in the left pane Note You simultaneously...

Page 175: ...t the Capturing Machine State dialog box appears and the scan begins which takes a few moments When the capture is complete click Finish 9 If you have a group open the Package Execution dialog box opens from which you install each package in the group The packages are in the order that they were put in Software Manager Note Non MSI based packages might show erroneous information in the Status colu...

Page 176: ...at the installation fails Example If a launch condition requires a specific operating system install the package on every operating system and verify that it installs successfully only on computers with the required operating system It is unlikely that testing on only one computer will adequately test launch conditions See Testing on Multiple Computers on page 168 When you finish the test select t...

Page 177: ...t Launch Conditions and OS Conditions on multiple computers During this installation you are prompted to install the package into a virtual software layer if you have the Software Virtualization Agent installed See Installing an Installation Test into a Virtual Software Layer on page 164 You are also prompted to create a pre installation snapshot of the computer This snapshot is not necessary to v...

Page 178: ...eck Internet Connection test case in the left pane of Test Expert 2 Click Add The Check Internet Connection dialog box appears 3 Configure the test item a In URL enter a complete Internet address Example http www company com b Mark Make this a global test to have this test item appear for every package or group that is subsequently opened in Test Expert Otherwise it appears only in the test plan o...

Page 179: ...o remove a test item 4 To run the test item select its check box and click Execute Database Connectivity Quality Assurance module only Use this test case to check if a specific database is accessible This test case appears for any package or group that you open but it does not have any test items until you add them Requirements z The data source you set must be able to connect to its specified dat...

Page 180: ... Test Expert will be used on other computers specify the executable with a UNC path b In Command Line enter command lines to apply to the EXE c Mark Make this a global test to have this test item appear for every package or group that is subsequently opened in Test Expert Otherwise it appears only in the test plan of the currently opened package or group Global tests are stored in the repository a...

Page 181: ... case 1 Select the Class IDs test case in the left pane of Test Expert All class IDs installed by the package are listed 2 Mark the check boxes of the class IDs to test 3 Click Execute Test Expert examines the class ID descriptions tries to create class objects and marks each test item as either passed or failed When the tests are finished the dialog box closes and the statuses are displayed in th...

Page 182: ... execute one test at a time 4 Click Execute in the Test Case dialog box An Open file dialog box appears 5 Navigate to and open a file of the type specified in Files of type Test Expert opens the file in the application and applies the verb Example The verb Print might open the file print it and close the application depending on how it was coded Typically the verb is either Open or default both of...

Page 183: ...elp files detected in the package are listed 2 Mark the check boxes of the help files to test 3 Click Execute The Test Case Help Files dialog box appears where you execute one test at a time 4 Click Execute in the Test Case dialog box After a pause the installed help file should open 5 Close the help file 6 When the Pass Fail dialog box appears a Click Pass or Fail based on your visual verificatio...

Page 184: ...re displayed in the Status column 4 Select the overall status of the test case in Status of Test Case To troubleshoot failures To see the returned error double click an item and look in the Test Details field on the Test Item Details dialog box If an ODBC test item fails for an MSI open the package in Windows Installer Editor and check the ODBCDataSource table Make sure the data source was actuall...

Page 185: ...s search locations in a package the Search Locations test case appears This test verifies that search locations defined within the package exist and are accessible It does not verify the presence of the package s source files Search locations represent locations the package will search for source files if the installation is run in maintenance mode In Windows Installer Editor you can view search l...

Page 186: ...stalled To run the test case 1 Select the Services test case in the left pane of Test Expert All services installed by the package are listed 2 Mark the check boxes of the services to test 3 Click Execute Test Expert examines the ServiceInstall table and then examines the services that are registered with the computer s Services Manager For each service in the ServiceInstall table the test item is...

Page 187: ... visual verification of the test results b In Comments enter any pertinent information about the test case 7 In the Test Case dialog box continue to click Execute for each subsequent test case entering Pass Fail results for each When the tests are finished the dialog box closes and the statuses are displayed in the Status column 8 Select the overall status of the test case in Status of Test Case T...

Page 188: ...a computer that contains the default software common to all computers on your network z The Application Monitor window must remain open while you are running the application and must be closed when you finish Closing the window stops the monitoring of the testing computer Tips z If an error occurs when a file is accessed the status is set to Fail and the error from the operating system is displaye...

Page 189: ...ts group See Verify Installation Test Case on page 177 2 Close all applications other than Wise Package Studio and Test Expert including all background applications and services that might access files or registry entries on the testing computer Files or registry entries accessed by other applications can interfere with the test results 3 Select any of the test cases in the Application Execution T...

Page 190: ...0 Select the overall status of the test case in Status of Test Case See also Setting Test Statuses and Details on page 166 Extra Files Test Case on page 190 Extra Registry Entries Test Case on page 191 File Coverage Test Case on page 191 Isolated Files Test Case on page 192 Registry Coverage Test Case on page 193 Extra Files Test Case Quality Assurance module only The Extra Files test case in Test...

Page 191: ...ry entries on the testing computer Initially when you select this test case you see no test items As you run the application non installed registry entries are added to the list with the status of Pending Installed registry entries that are accessed are added to the Registry Coverage test with a Passed status You must change the status for each item manually During this test you check whether any ...

Page 192: ...ests on page 189 About Test Cases on page 164 Isolated Files Test Case Quality Assurance module only If Test Expert detects file extensions in a package the Isolated Files test case appears It monitors the testing computer as you exercise the features of the application It then records what isolated files are accessed during application execution Because all application execution tests are run at ...

Page 193: ...are accessed the Registry Coverage graph shows 90 See also How to Run Application Execution Tests on page 189 About Test Cases on page 164 Uninstall Tests Quality Assurance module only In Test Expert run uninstall tests to determine how the uninstall sequence in the package is performing All tests in the Uninstall Tests group are run simultaneously when you uninstall the application Note Uninstall...

Page 194: ...e only This procedure applies to all uninstall tests Note Uninstall tests do not appear if a group is open Before running uninstall tests 1 Click the Install or Install As button that appears on the Test Expert toolbar 2 Create a pre installation snapshot with Machine Capture 3 Install the application For details on the preceding steps see How to Run Installation Tests on page 174 4 Run applicatio...

Page 195: ...esidual Registry Entries Test Case on page 199 Created Files Test Case Quality Assurance module only The Created Files test case in Test Expert which is primarily informational shows files that were created after installation After uninstall tests are run the test case list is populated with created files and all statuses are set to Pending Review the list and select the status for each test item ...

Page 196: ...ll Tests group are updated simultaneously This test compares the pre installation snapshot to the post uninstall snapshot and reports the differences between the two snapshots Registry entries accessed by other applications can interfere with the test results Before you run this test close all applications other than Wise Package Studio and Test Expert including all background applications and ser...

Page 197: ...potentially break the other application This error can be caused when two separate packages install the same file to the same place but the file has a different component ID in each package Example Suppose Package1 installs sample dll into the System32 directory then Package2 installs a newer version of sample dll over the original When Package2 is uninstalled it removes sample dll breaking Packag...

Page 198: ...moving registry entries that another application installed could potentially break the other application This error can be caused when two separate packages install the same registry entry to the same place but the registry entry has a different component ID in each package Example Suppose Package1 installs a registry value then Package2 installs the same value to the same place When Package2 is u...

Page 199: ...See also How to Run Uninstall Tests on page 194 About Test Cases on page 164 Residual Registry Entries Test Case Quality Assurance module only The Residual Registry Entries test case in Test Expert shows registry entries that did not get uninstalled properly After uninstall tests are run the test case list is populated with residual registry entries and all statuses are set to Pending Review the l...

Page 200: ...nce 200 Test Expert residual registry value If Leave installed on uninstall is marked the registry value is set to never uninstall Clear the check box See also How to Run Uninstall Tests on page 194 About Test Cases on page 164 ...

Page 201: ...n use SetupCapture to capture the first use changes that an application makes to a computer Wise Web Capture which you run from a browser lets you capture installations on a clean machine without installing any additional software It also lets you capture on a computer that is running a non supported system SOE Snapshot is used exclusively in conjunction with Software Manager and ConflictManager S...

Page 202: ...iguration file with different exclusions settings for SOE Snapshot Machine Capture in Test Expert uses the local configuration file when it creates pre installation and post uninstall snapshots Changes you make on the Machine Capture Settings dialog box affect the local configuration file SetupCapture Configuration lets you specify z The location of the configuration file See Selecting the Configu...

Page 203: ...med then click Next These settings apply to SetupCapture only See Setting General Settings on page 205 The Directories to Watch page appears This page applies to SetupCapture only 5 If you are using the snapshot capture method specify the directories to scan for changes during SetupCapture and click Next If you automatically build an exclusion list later in SetupCapture Configuration the directori...

Page 204: ...t 8 Specify registry keys and values to exclude from a SetupCapture or SOE Snapshot and click Next See Setting Registry Exclusions on page 214 The INI Files Exclusions page appears It displays the INI file items in the current configuration file s exclusion list Items with a question mark icon were added by the exclusion list building process Items without a question mark icon were already in the ...

Page 205: ...point directory The file is named repackage ini By default it contains a recommended basic exclusion list This lets you share central standardized configuration settings with coworkers This option might be unavailable See Setting SetupCapture Configuration Security on page 44 Use configuration file from the local PC Edit or use the configuration file on the local computer The file is named WisePSS...

Page 206: ...ill have identical hardware configuration z Allow root to be watched during capture Normally even if you select the root as a directory to watch files on the root are ignored Only its subdirectories are watched Typically you don t want to edit the root s system files because doing so can result in a damaged or inoperable operating system To capture changes to files on the root mark this check box ...

Page 207: ...n and type library do not include all of the registry keys that the file updates during registration SetupCapture may place those registry keys into different components than the file This mis association can cause self repair problems if one of the components is uninstalled When you mark this check box SetupCapture performs an additional step using the WiseComCapture exe utility to find all regis...

Page 208: ...s for captured Windows Installer packages z WiseScript Template SetupCapture Configuration only Not available in Standard Edition This field lists the templates in the WiseScript Editor Templates directory Select the template to use as a basis for captured WiseScript packages z Installation Changes Report Specify whether to generate a report after each SetupCapture and the report format The items ...

Page 209: ...lick Settings and click the Directories to Watch tab If the Settings button is unavailable you might not have permission to change settings See Setting SetupCapture Configuration Security on page 44 2 Click Add The Select Directory dialog box appears 3 Select a directory and click OK to add it to the list of watched directories To watch all the subdirectories of the directory also mark Include Sub...

Page 210: ...ing INI File Exclusions on page 215 Building an Exclusion List Automatically On the Build Exclusion List page you decide whether to build an exclusion list automatically using snapshot comparison technology An exclusion list is a list of files folders and registry keys and values to be ignored by SetupCapture or SOE Snapshot See Exclusion List Guidelines on page 209 The exclusion list you build is...

Page 211: ...n SetupCapture or SOE Snapshot SetupCapture and SOE Snapshot automatically ignore certain system files See Files and Registry Entries Ignored During Captures on page 247 You can exclude the following items See also Exclusion List Guidelines on page 209 Setting a File to Be Excluded You can specify files to be ignored by SetupCapture or SOE Snapshot or when building an exclusion list in SetupCaptur...

Page 212: ...directories Click OK to return to the SetupCapture Configuration dialog Items that you specify will be ignored if they change during a capture while this configuration file is in effect To edit an exclusion double click it in the list See also Exclusion List Guidelines on page 209 Setting a Directory to Be Excluded You can set directories to be ignored by SetupCapture or SOE Snapshot Example If a ...

Page 213: ...ldcard criteria within a particular directory To set a file to be excluded based on a wildcard 1 Do one of the following Run SetupCapture Configuration and proceed until the File and Folder Exclusions dialog box appears On the Welcome page of SetupCapture or SOE Snapshot click Settings and click the File and Folder Exclusions tab If the Settings button is unavailable you might not have permission ...

Page 214: ...s Index dat That path won t exist on anyone else s computer because a user name is part of the path If you click Yes in the prompt the entry above is changed to Current_User_Profile Cookies Index dat Current_User_Profile will be replaced with the user profile folder for the computer that is running SetupCapture You edit the exclusion list from SetupCapture Configuration SetupCapture or SOE Snapsho...

Page 215: ...etupCapture Configuration and proceed until the INI File Exclusions dialog box appears On the Welcome page of SetupCapture or SOE Snapshot click Settings and click the INI File Exclusions tab If the Settings button is unavailable you might not have permission to change settings See Setting SetupCapture Configuration Security on page 44 2 Click Add The Exclude INI File Section or Entry dialog box a...

Page 216: ... the two scans z A combination of SmartMonitor and Snapshot If you have the Software Virtualization Agent installed you can use the SmartMonitor and snapshot methods to capture the installation in a virtual software layer See Capturing an Installation in a Virtual Software Layer on page 219 Configuration files control how SetupCapture works You select the configuration file when you run SetupCaptu...

Page 217: ...ard Edition z During SetupCapture changes to an INI file are recorded as changes to an INI file only if the INI file follows standard INI file format Otherwise the changes are recorded as a file change z Do not capture an MSI based installation Instead open the MSI directly in Windows Installer Editor To customize it for specific workgroups create a transform See Creating a Transform Based on an E...

Page 218: ...with SOE Snapshot use a clean machine If you run SetupCapture on a baseline machine all the repackaging and conflict resolution work you do becomes suspect if you upgrade any of the additional applications Example If you upgrade from version 3 0 to version 4 0 of your antivirus software system DLLs or other files might change As a result items that did not conflict before might conflict now Instal...

Page 219: ...nt which is installed with Wise Package Studio For general information about the Software Virtualization Solution see Integration with Software Virtualization Solution on page 29 Note If the output of the capture is an uncompiled file WSI or WSE either import the package into Software Manager or compile it before you delete the virtual layer If you delete the layer first you lose the package s sou...

Page 220: ...ting file Add Update Resources in Existing Installation If you specified an existing installation in Target Installation you can mark this check box to append or update the resources from the capture in the existing installation instead of overwriting the existing installation Note If you previously ran SetupCapture from the Projects tab an installation file already exists If you run it again you ...

Page 221: ...Virtual OS to use and click Next You must have run the Virtual OS Creation utility on the current computer or another computer See Creating a Virtual OS on page 239 Use the existing Virtual OS file Mark this if you are working in a clean build environment and you previously ran the Virtual OS Creation utility on the current computer This option is unavailable if no Virtual OS is found on this comp...

Page 222: ...SetupCapture will not capture them The End Installation Capture page appears 13 Click Next Standard Edition The Finish page appears Skip the next steps that describe the Inclusions and Exclusions pages Professional or Enterprise Edition The SetupCapture Inclusions page appears The SetupCapture Inclusions page displays the items that will be added to the repackaged installation These items represen...

Page 223: ... the beginning of SetupCapture Specifying the Installation File On the Specify Target Installation File page you specify the repackaged installation that results from the SetupCapture and how to handle source files This page appears during SetupCapture It might not appear when you run SetupCapture from a task in the Workbench Projects tab See Capturing an Installation on page 219 z Target Installa...

Page 224: ...capture z Change the configuration file that controls how SetupCapture works To use a different configuration than the one listed on the Welcome page click Change which opens the Configuration File dialog box If you select the Do not change current configuration file option this option is disabled See Selecting the Configuration File on page 205 for details z Change or review the settings in the S...

Page 225: ...h Virtual Capture on page 237 Note Virtual Capture is not available if you chose First Use Settings on the SetupCapture Type page z SmartMonitor SetupCapture monitors and records the installation s operations as they happen This method is faster than snapshot comparisons because it doesn t require a time consuming scan of the computer SmartMonitor records the following operations Copying moving de...

Page 226: ...her computer See Creating a Virtual OS on page 239 z Use the existing Virtual OS file Mark this if you previously ran the Virtual OS File Creation utility on the current computer When you click Next the Virtual OS is cleaned This means that installed remnants from the last capture are removed from the Virtual OS directory and registry structure This option is unavailable if no Virtual OS is found ...

Page 227: ...page specify whether to rerun the initial scan or use the initial scan that was created previously This page appears during SetupCapture if you selected the snapshot method and one of the following is true z You previously started a SetupCapture but canceled before it completed In that case use the initial scan that was created previously z You previously performed a SetupCapture on this computer ...

Page 228: ...Capturing an Installation in a Virtual Software Layer on page 219 4 Click Execute The installation starts Run the installation installing the product as you want it to be captured and return to SetupCapture when the installation is finished 5 To run additional installations repeat the preceding steps for each installation The option to capture to a layer is unavailable now because this option must...

Page 229: ... file listing it in the Files list of the SetupCapture Inclusions page and creating a single entry for the whole file in the Files table rather than creating several entries in the IniFile table You cannot move non standard INI files from the Files list of the SetupCapture Inclusions page to the INI files list z If you are not using SmartMonitor click View Report An HTM formatted list of all file ...

Page 230: ...ppears The inclusions and exclusions are grouped by the type of system change z If you are using SmartMonitor Click View Report and select Installation Changes from the button menu An HTM formatted list of all file INI file and registry inclusions and exclusions appears The inclusions and exclusions are grouped by the type of system change Click View Report and select Installation Sequence from th...

Page 231: ...stination Directory dialog box is called the Single Feature Destination dialog box in Windows Installer Editor z Destination Feature Windows Installer packages only To save results from this SetupCapture to a specific feature either specify an existing feature or click New to create a new feature See Configuring the Installation as a New Feature on page 233 Click Finish to save the SetupCapture re...

Page 232: ...ly it appears after you add a file to the Files page in Windows Installer Editor or after a SetupCapture The Files in Merge Modules dialog box lets you add the 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 ...

Page 233: ...ations Print Album and Touchup When you repackage Photo you want the end users who will install this bundled application to be able to choose which of the three Print Album and Touchup they want to install First you run SetupCapture on Print s installation When the SetupCapture Finish page appears click New and configure a new feature named Print Then do the same with Album s and Touchup s install...

Page 234: ...a multi line description of the feature This appears if the end user selects a feature on the Select Features dialog box during installation This text must fit in the Feature Description area of the Select Features dialog box z Level If you are using the Installation Types page to determine which features to install for a Typical or Complete installation you can skip this field If not specify whet...

Page 235: ... or 1000 z Display Specify if and how the feature is displayed to the end user on the Select Feature dialog box during installation Invisible Do not display the feature Visible and Expanded Display the feature and its children Visible and Collapsed Display the feature but not its children z Attributes Specify the default for the feature in the installation The end user can change the default Favor...

Page 236: ...ry set to none then the files for this feature are installed in the directory structure specified on the Files page in Windows Installer Editor To ensure that two features always get installed to the same directory select the same option in Directory for both features If you let end users select directories for individual features you must code your application in such a way that it can locate the...

Page 237: ...Converting or Repackaging in the Software Manager Help Note A security setting in Windows Vista or later operating system prevents Virtual Capture from working When you try to use Virtual Capture a prompt appears and provides the option to disable the security restriction If you choose to disable the security restriction the following registry setting is set HKEY_LOCAL_MACHINE SOFTWARE Microsoft W...

Page 238: ...you ran the Virtual OS Creation utility on a computer with Windows 2000 service pack 2 MDAC 2 5 and Internet Explorer 5 then the computer where you run SetupCapture with Virtual Capture must also have Windows 2000 service pack 2 MDAC 2 5 and Internet Explorer 5 z The contents of the computer on which you create the Virtual OS cannot exceed 3 GB of used space z Execute the original application from...

Page 239: ... Select this option if you plan to perform captures on the current clean machine This would be the case if you are working in a clean build environment Create a Virtual OS file and copy to a shared location Select this option if the current computer is clean but you plan to perform captures on another non clean machine Also select this option if you plan to use the Universal Import feature in Soft...

Page 240: ...k SetupCapture 3 On the SetupCapture Type page specify the following then click Next First Use Settings Target MST File Specify the file name and location of the transform file that will be created Base MSI File Specify the MSI that installed the application The Welcome page appears 4 On the Welcome page To select a different configuration file click Change This session of SetupCapture will use th...

Page 241: ...cify the full path of the installation executable Command Line Enter any command lines to apply to the executable Capture the application in a virtual software layer If you mark this all changes made to the computer when you set first use settings are put into a virtual software layer You can then use Symantec SVS applet to delete or deactivate the layer and restore the computer to its original st...

Page 242: ...n the Windows Installer Editor Help 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 232 The transform is saved in the directory you specified at the beginning of this procedure SOE Snapshot Not available in Standard Edition SOE Snapsh...

Page 243: ...gh you can edit an SOE file in Windows Installer Editor you cannot compile it into an executable installation The sole purpose of an SOE file is to let you import a snapshot of a baseline machine into the Software Manager database See also SOE Snapshot Configuration Settings on page 243 Capturing the Standard Operating Environment on page 244 SOE Snapshot Configuration Settings Not available in St...

Page 244: ...s enabled only if the user has permission to use the SetupCapture Configuration tool If the Settings button is disabled selecting this option enables it The user can then modify the settings for the current capture To select a different configuration file click Change This session of SOE Snapshot will use the settings in the specified configuration file See Selecting the Configuration File on page...

Page 245: ...flictManager you can check for conflicts between other applications and your SOE Note You might see a message telling you that a service in the capture requires a password to function correctly This happens when a service on the computer is installed under an account other than the system account Because you won t be installing the result of an SOE Snapshot onto another computer it is not necessar...

Page 246: ...pture where machine name is the computer on which the Wise Web Capture Web application is installed Example http localhost Wise_Web_Capture 3 On the Log On page enter a valid Workbench user name and password and click Submit 4 On the Specify Output page a In Target Installation specify the full path of the file in which to store the capture results Do not include a file extension the extension MSI...

Page 247: ...egistry entries that you added to the exclusion list on the Machine Capture Settings dialog box in Test Expert z Files and registry keys that are hard coded to be ignored See Files that are hard coded to be ignored on page 247 See Registry keys that are hard coded to be ignored on page 248 Files that are hard coded to be ignored An asterisk in any of the following paths means that any file in the ...

Page 248: ...ist in WisePSSC ini Therefore if you do want these items to be captured by SOE Snapshot remove them from the predefined exclusion list Windows System32 Config log Windows System32 Shlwapi dll Windows System32 Shdocvw dll Windows System32 Shfolder dll Windows System32 Dllcache Registry keys that are hard coded to be ignored SetupCapture SOE Snapshot and the Test Expert Machine Capture ignore the fo...

Page 249: ...ows Installer administrative installation z Preparing a package s MSI file for distribution to end users using Microsoft Active Directory You can select these types of packages to distribute z Windows Installer packages WSI MSI z Merge modules WSM MSM z Windows Installer patches MSP z Transforms MST z WiseScript packages WSE Professional Edition only z Virtual software packages WVP VSA Professiona...

Page 250: ...work project file and Administrative Installation are unavailable The distribution methods are described in the following topics z Moving a Package into Microsoft Active Directory on page 250 z Copying a Package to the Share Point Directory on page 252 Not available in Standard Edition z Copying a Package to a Network Directory on page 254 z Copying a Compiled Installation to an FTP Server on page...

Page 251: ... computer 4 Click Next If necessary the installation file is saved and compiled The Microsoft Active Directory dialog box appears 5 Complete the dialog box MSI Pathname This non editable field contains the file name of the package you chose to distribute This must be specified using UNC or mapped drive notation to ensure that it is accessible to all users in the Group Policy Object see requirement...

Page 252: ... Share Point Directory You can use Package Distribution to copy a package or merge module to the share point directory for later importing into the Software Manager database Distributing to the share point directory also copies all of the package s source files to the share point and updates the source paths for those files which means that after resolving conflicts you can recompile the fixed pac...

Page 253: ... which the package will be copied It defaults to the share point directory that is specified in Workbench Preferences 6 The Copy Installation File To check box enables Pathname This option does not appear for virtual software packages During distribution a copy of the package s installation file is placed in the directory you specify here and its source paths are updated to reflect the location of...

Page 254: ...ng a project and its source files to a network directory lets 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 z Open a Windows Installer project in Windows Installer Editor and select Tools menu Convert Source Paths...

Page 255: ...Package Distribution from Workbench select one of the following options they appear below the Network option If you are running Package Distribution from Software Manager these options do not appear and the compiled package is distributed Compiled package Distributes the compiled installation Project file and source files Distributes the project file and its source files 4 Click Next If necessary ...

Page 256: ...ble To copy an installation to an FTP server 1 Do one of the following On the Projects tab click the Run link to the right of the task or tool associated with Package Distribution The package associated with the current project will be distributed This tool might skip dialog boxes or pre fill fields based on command line options defined in Process Templates Setup On the Tools tab double click Pack...

Page 257: ...status of the upload 7 Click Finish Note If this option does not work as you expect open an FTP client configure it with the same information you entered in Package Distribution and make sure it works Windows contains a default FTP client Performing an Administrative Installation of a Windows Installer Package When a Windows Installer package is ready to deploy to end users you can use Package Dis...

Page 258: ...ect a release 3 Mark Administrative Installation If this option is not available you might not have met the criteria listed at the beginning of this topic 4 Click Next If necessary the installation file is saved and compiled The Administrative Installation page appears 5 Complete the page Network Directory Specify the directory in which to place the administrative installation Use Short File Names...

Page 259: ...e package contents without actually making any changes on the target computers then sends the results to a Web server Use the Preflight Analysis tool to view results Parts of Preflight Deployment z Preflight Instrumentation The Preflight Instrumentation tool in Workbench reads and analyzes a package that you plan to deploy It then generates a preflight package based on that package The preflight p...

Page 260: ... Preflight Data Collector is a Web application that receives the data from the preflight package unpacks it and inserts it into the Wise Services database This Web application has no user interface z Wise Services Database Stores data from preflight packages and interacts with the Preflight Data Collector and Preflight Analysis Web applications See also The Preflight Deployment Process on page 261...

Page 261: ...tion The URL is embedded in the preflight package so that when it runs it sends its results to the Data Collector Web application Obtain the Data Collector URL from the team member who installed Preflight Web server z Preflight Data Collector Web application collects data and inserts into SQL database z Preflight Analysis Web application organizes and displays results SQL Server Phase 1 Use Prefli...

Page 262: ...e SQL database that the Preflight Web applications interact with To do so use the Wise Repository Manager See Managing the Wise Software Repository in the Getting Started Guide For information about installation see Installing Web Applications in the Getting Started Guide Creating a Preflight Package Quality Assurance module only Use the Preflight Instrumentation tool to create a preflight MSI pac...

Page 263: ...u view results by job identifier 4 Enter a unique job identifier that describes the package you are testing and click Next Example Microsoft Office 2002 The Package Instrumentation dialog box appears 5 Click Next and the preflight package is generated at the path you specified Click Finish after the preflight package is created Note Package Instrumentation also validates that the package exists in...

Page 264: ... and so on To avoid this problem you could locate preflight Web applications on the same computer as you use for deployment because the deployment computer has a history of successful communication with target computers z Fully Qualified Domain Names Remote computers might have trouble connecting to the IIS server if they are required to connect using fully qualified domain names The URL to the Da...

Page 265: ...the files in the package that are in use at on the computer These could fail to be installed properly because in use files cannot be replaced This test is informational only Connectivity to URL Extracts URLs from any Launch Web Page Download File From Internet or Post Data to HTTP Server custom actions that are found in the original package It puts them in a table which is processed on the target ...

Page 266: ... are not recorded in the Wise Software Repository Specifically an unmanaged file is a file on the target computer that has the same name and location but differing attributes as a file in the preflight package The presence of unmanaged files indicates that software outside the packaging process is installed on target computers which might invalidate previous conflict analysis and installation test...

Page 267: ...est fails This test only applies if the package being tested is a patch Registry Security Read Cycles through the registry entries that are installed and queries the target computer for permissions to access them Registry Security Write Cycles through the registry entries that are installed and queries the target computer for permissions to create and update them ...

Page 268: ...for Package Validation on page 279 z Command Line Options for Patch Creation on page 280 z Command Line Options for Preflight Instrumentation on page 280 z Command Line Options for SetupCapture Configuration on page 280 z Command Line Options for SetupCapture on page 281 z Command Line Options for SOE Snapshot on page 283 z Command Line Options for Software Manager on page 284 z Command Line Optio...

Page 269: ...pplication Isolation See Application Isolation on page 89 Option Results d Required option to run Application Isolation d path file_name Run isolation on a specified file Place the full path or appropriate variables of the source file the file to isolate within quotation marks after the space delimiter d path file_name_Isolated msi Specify the name of the updated MSI file Place the full path or ap...

Page 270: ...x1 The fourth space in this command line option corresponds directly to the Repair support for isolated files group box on the Select Isolation Options dialog box The xxx represents the first three digits as described above do not enter xxx in this command line If you enter 1 as the fourth digit it has the same effect as clicking Do not add repair support for isolated files on the Select Isolation...

Page 271: ... exe d111 ProjectDir FileName _Isolated msi ProjectDir FileName msi Option Results tool ApplicationWatch Required option to run ApplicationWatch tgtfmt Specify the type of installation file to create Options are z MSI to create an MSI or WSI z WSE to create a WSE Place the option after the equals sign This option is not necessary if the target file is specified tgt path file_name Specify the name ...

Page 272: ...e shown as they would be entered at the command prompt When you define a command line option in Tool Setup you do not need to include the EXE in the command line Desired behavior Example command line Do not prompt for file name Instead save the results in a WSI using the default project directory and project file name path workbench exe tool ApplicationWatch tgt ProjectDir FileName wsi Do not prom...

Page 273: ...tallTailor The following table lists the command line options you can use with wfwi exe to run InstallTailor See InstallTailor on page 105 Option Results D DSN_name Specify the Software Manager database to use in ConflictManager Place the DSN name or the Database variable within quotation marks after the equals sign Desired behavior Example command line Open ConflictManager to the default Software...

Page 274: ...line Options for Workbench exe The following table lists the command line options you can use with Workbench exe to run Legacy Setup Conversion Desired behavior Example command line Prompt for an MSI file to transform and save the transform in a file with the default project file name path wfwi exe t ProjectDir FileName mst Use the vendor installation specified in the project and create a transfor...

Page 275: ... z WSE to create a WSE Place the option after the equals sign This option is not necessary if the target file is specified tgt path file_name Specify the name of the installation file to create which will populate Target Installation on the Specify Files dialog box Place the full path and file name or appropriate variables within quotation marks after the equals sign Option Results s Run Legacy Se...

Page 276: ...ired if the RIP was created with an edit password b Skips to the Performing Migration dialog box of the conversion wizard u Only the Performing Migration dialog box appears which displays the progress of the conversion i Skips the introduction page of the conversion wizard a Converts the Add Remove Programs data that was added by the RIP Desired behavior Example command line Convert an SMS Install...

Page 277: ... would be entered at the command prompt When you define a command line option in Tool Setup you do not need to include the EXE in the command line Command Line Options for Package Distribution The following table lists the command line options you can use with workbench exe to run Package Distribution See Package Distribution on page 249 Desired behavior Example Command line Open the default proje...

Page 278: ...ution without the ability to distribute to the share point directory or to distribute an installation package tgt 21 Select Distribute to share point directory in the Distribution Method dialog box tgt 23 Select Network Project file and source files in the Distribution Method dialog box tgt 23 path file_name Select Network Project file and source files in the Distribution Method dialog box To popu...

Page 279: ...See About Package Validation on page 145 Examples The following table shows how you would use the option above to run this tool using variables to provide information required by the program See Wise Package Studio Variables on page 75 Note These examples are shown as they would be entered at the command prompt When you define a command line option in Tool Setup you do not need to include the EXE ...

Page 280: ... Note These examples are shown as they would be entered at the command prompt When you define a command line option in Tool Setup you do not need to include the EXE in the command line Command Line Options for SetupCapture Configuration The following table lists the command line option you can use with wfwi exe to run SetupCapture Configuration See SetupCapture Configuration on page 202 Validate t...

Page 281: ...is used in the Wise Software Repository with the default package name Place the package name or the PackageName variable after the equals sign k path file_name Capture a specified installation package Place the full path of a specific installation or the VendorPackage variable within quotation marks after the equals sign qa application_name Populate Name in the Finish dialog box with the default a...

Page 282: ...etwork directory Place the full path or appropriate variables of the directory within quotation marks after the equals sign src 45 path Use this option with a WSE or WVP file and be sure to include the pipe character The 4 causes the source files from the captured installation to be copied to a network directory The 5 indicates that the paths to these files should be written as relative paths rela...

Page 283: ...ault application and package names Append the default application name and manufacturer path workbench exe tool SetupCapture z2 app ApplicationName pack PackageName k VendorPackage qa ApplicationName qm ProductVendor tgt ProjectDir FileName wsi Save the capture results in a WSI file with the default project file name and location In this example the text Uninstall is appended to the resulting file...

Page 284: ...3 ProjectDir SOESnapshot soe Option Results s Required option to run Software Manager j1 path file_name que Import a package into the Software Manager database from the share point directory x Change the status of a package in the Software Manager database Possible values 0 empty 1 Under Development 2 Available 3 Retired Use the A P and D options to specify the package the order of the options is ...

Page 285: ...ool using variables to provide information required by the program See Wise Package Studio Variables on page 75 Command Line Options for Virtual Package Editor The executable that runs Virtual Package Editor is SVSEditor exe There are no options for running the executable See About Virtual Package Editor in the Virtual Package Editor Help Change the status of the default project package in the def...

Page 286: ...Windows Installer Editor to Installation Expert app application_name Populate the application name that is used in the Wise Software Repository with the default application name Place the application name or the ApplicationName variable after the equals sign pack package_name Populate the package name that is used in the Wise Software Repository with the default package name Place the package name...

Page 287: ...exe n e1 j Admin Open Windows Installer Editor to Setup Editor path wfwi exe n e Create or edit a file in the default project directory with the default project file name Populate the application and package names used in the Wise Software Repository with the default application and package names path wfwi exe app ApplicationName pack PackageName n ProjectDir FileName wsi Edit the default Applicat...

Page 288: ...nd run the Resolve wizard against all applications in the Software Manager database path wfwi exe ProjectDir FileName wsi yr1 Software Manager Database All Applications 0 Option Results pe Open WiseScript Package Editor n Open WiseScript Package Editor and suppress the New Installation File dialog box c Open WiseScript Package Editor and compile the package e Open WiseScript Package Editor to Scri...

Page 289: ...d Admin path wise32 exe pe n e1 j Admin Open WiseScript Package Editor to Script Editor path wise32 exe pe n e Create or edit a file in the default project directory with the default project file name path wise32 exe pe n ProjectDir FileName wse Edit the default ApplicationWatch package path wise32 exe pe ProjectDir FileName ApplicationWatch wse Edit the default project Uninstall package path wise...

Page 290: ... enhancements in the current release refer to the Release Notes In Wise Package Studio select Help menu Release Notes Feature Edition or Module Workbench Tools Application Isolation Professional ApplicationWatch Standard or Professional Command Line Builder Standard or Professional ConflictManager Professional Impact and Risk Assessment Professional InstallTailor Standard or Professional Legacy Se...

Page 291: ...onal Create your own processes which are shared among the local team Professional Connect to an external Workbench database and access its processes Enterprise Specify a project or process owner Enterprise Project Management tab for projects which allows overall resource management of a project Enterprise Metrics tab for projects which allows task level management of a project Enterprise To Do tab...

Page 292: ...dual rules on and off Standard or Professional or Quality Assurance Create a new validation module CUB file Quality Assurance Create new validation rules Quality Assurance SetupCapture SetupCapture tool with the ability to capture to a Windows Installer package WSI MSI Standard or Professional SetupCapture tool with ability to capture to a WiseScript WSE or virtual software project WVP Professiona...

Page 293: ...oject query the tables Professional Import virtual software archive VSA and virtual software project WVP files Professional Import device driver INF information Professional Import Group Policy Object GPO information Professional Import an InstallShield Developer version 7 or 8 executable Professional Import an installation EXE of any type Professional Use the Auto Import Service to import package...

Page 294: ...Windows Installer 113 B backup creating during save 52 baseline machine 218 for SOE Snapshot 218 for Test Expert 168 best practices 59 C C symbol file directory 134 134 CAB file mobile device 31 Cancel button hiding in install 100 CAPICOM 135 capture methodology 208 capturing an application See SetupCapture CER file 135 Check Internet Connection test case 178 178 Citrix validation 157 with Preflig...

Page 295: ...WinINSTALL 114 error found by UpgradeSync 140 Patch Creation 131 validation 147 evaluation serial number 50 excluded file remove from package 204 exclusion adding to permanent list 229 Also see exclusion list ApplicationWatch 95 96 capturing 203 210 directory 212 file 211 hard coded 247 INI file 215 package definition 127 registry 214 SetupCapture 209 SOE Snapshot 209 245 types 211 using wildcard ...

Page 296: ...n Changes report 208 Installation Quality Assurance process 60 Installation Sequence report 207 installation tests about 173 not appearing 173 running 174 INSTALLLEVEL 234 InstallShield MSI conversion log 121 converting 119 selecting parts to convert 121 InstallShield Pro converting to Windows Installer 118 InstallTailor about 105 captured changes about 106 captured changes editing 108 command lin...

Page 297: ...work logon 18 new features Refer to Release Notes notes in Metrics tab 84 process 61 project 57 Notes variable 75 Novell ZENworks converting to Windows Installer 113 O object in help text 71 OCX file isolating 89 ODBC Data Sources test case 184 ODBC capturing 207 OnDemand Software 114 operating system clean 218 service pack 218 OS Conditions test case 176 OS Snapshot See SOE Snapshot other EXE tas...

Page 298: ...signing to project 57 best practices 59 copying task 62 creating 61 defined 13 deleting 65 duplicating 65 editing 61 editing in project 57 exporting to file 65 from external database 54 65 gray font color 59 importing from file 66 multiple releases 59 name 61 notes 61 owner group 61 predefined 59 rearranging 66 restricting changes 61 Process Documentation report 85 Process Templates Setup about 58...

Page 299: ...ture 44 Software Manager 43 user 41 Windows NT authentication 39 security group See group Security Setup report 85 self repair isolated file 94 sequence patch about 129 specifying 136 serial numbers about 47 adding 49 Also see licenses deleting 51 evaluation 50 server side service performing operations 143 user account 143 service pack on clean machine 218 service requiring password 245 Services t...

Page 300: ...tting Started Guide T task actual hours 82 adding to process 62 adding tool 63 assigning user 81 completing 20 77 completing automatically 74 77 copying 62 creating subtask 66 defined 13 entering time 82 failed status 84 help 64 70 hierarchy 66 name 62 not available 77 rearranging 66 running 20 77 status 84 type 62 Wise Task Manager 141 TaskFiles directory 26 template merge module editing 36 Windo...

Page 301: ...7 creating 239 creation utility 239 selecting 226 Virtual OS directory 26 Virtual OS file defined 32 Virtual Package Editor about 88 command line options 285 virtual software archive 32 virtual software layer capturing in 219 running Test Expert 164 virtual software package 30 virtual software project 32 VSA file 32 W wamdb idx about 27 Web application adding as tool 68 allow connection attempts 5...

Page 302: ...s tab 21 78 Workbench configuration process 59 Workbench database defined 23 external 60 global 60 multiples 60 setting permissions 46 Workbench directory 26 Workbench reports 85 Workbench tool See tool workbench tool task type 63 WorkbenchDSN variable 75 WOS file about 237 Also see Virtual OS creating 239 defined 32 WPF file creating 123 defined 32 WPR file 65 WPS Administrator group 41 WSE file ...

Search results

Summary of Contents for SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

Reviews:

Related manuals for SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

Brands by name

Popular brands

Symantec SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0, Reference

Search results

Summary of Contents for SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

Reviews:

Related manuals for SOFTWARE MANAGER 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

Brands by name

Popular brands