background image

ConflictManager Reference

Summary of Contents for CONFLICTMANAGER

Page 1: ...ConflictManager Reference ...

Page 2: ...S 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 DOCUMENTATION IS...

Page 3: ...ivers 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 Before...

Page 4: ...at 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 know...

Page 5: ...rtise 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 training ...

Page 6: ...ing Registry Keys From Conflict Detection 23 Conflict Resolution Rules 24 Predefined Rule Sets 25 Creating a New Rule Set 26 Chapter 3 Conflict Detection and Resolution 28 About Conflict Detection and Resolution 28 Prerequisites for Conflict Detection and Resolution 28 Process for Resolving Conflicts 29 Detecting Conflicts 30 Stopping Conflict Detection 31 Viewing Conflicts 31 When Conflict Detect...

Page 7: ...Manager Reference 7 ConflictManager Reports 48 Generating a ConflictManager Report 49 Saving a ConflictManager Report Directly to a File 50 Using the Report Viewer 50 Interpreting the Conflict Level 51 Index 52 ...

Page 8: ...ewer version of the same file version 2 0 0 1 When the two packages are installed on the same computer Package 1 might conflict with the newer version of report dll that is installed by Package 2 This conflict could cause a General Protection Fault a hung application or some other problem ConflictManager helps you avoid software conflicts It detects conflicts that would be virtually impossible to ...

Page 9: ...Manager or ConflictManager With Enterprise Management Server multiple databases might open When you start ConflictManager from a task that specifies the database in its command line options the specified database is opened If ConflictManager cannot find the default Software Manager database the Database Setup wizard starts Do the following z If the Applications in Use dialog box appears close the ...

Page 10: ...are performed within the active database To close a database 1 Select File menu Close Database The Close Database dialog box appears 2 Mark the check box next to the database or databases to close and click OK See About the Software Manager Database and Multiple Software Manager Databases in the Software Manager Help About the ConflictManager Window When you start ConflictManager you see the main ...

Page 11: ...assigned to that group This lets you reduce the number of conflicts that appear See Package Groups in the Software Manager Help The Groups pane initially appears on the left side of the window below the Summary pane but you can move or hide it Applications Packages Pane Displays the applications and packages in the Software Manager database Expand an application to display its packages Select a pa...

Page 12: ...t List and Conflict Details panes rereads the package data and redisplays the conflict information This can be useful if packages have been added to the Software Manager database since you started this ConflictManager session Viewing Package Attributes In ConflictManager you can view package attributes but except for meta data you cannot edit them To edit package attributes use Software Manager Se...

Page 13: ...conflicting readme txt files you can exclude that file or any other files you don t care about from the conflict detection z Duplicate executable files only exe dll and ocx in all other directories Example If two packages install sslib dll in the Program Files directory it is considered a conflict z When multiple packages install the same system resource such as registry keys Autoexec bat Config s...

Page 14: ...cessary z If only one file has a hash value or neither file has a hash value then ConflictManager compares other file information version size date time and so on See About Conflicts on page 13 Generating the hash values can slow the package import However using hash value comparisons results in faster conflict detection and analysis because once it compares the hash values ConflictManager does no...

Page 15: ...en To designate a conflict as hidden or to remove the hidden designation click the Application Name column and then right click the conflict in the Conflict Details pane The Conflict Settings dialog box contains a check box Display Conflicts Marked as Hidden that lets you show hidden conflicts See Hiding Conflicts on page 34 Resolve Formatted Registry Values for Conflict Detection Registry entries...

Page 16: ...ws Installer components that have matching key files but one or both contain additional non advertising resources z Windows Installer components that have additional resources that conflict with a file in a WiseScript installation Registry Registry keys and named values that are set differently by multiple packages Autoexec bat Changes to Autoexec bat that are made by multiple packages These confl...

Page 17: ...information file version number or date time to different directories Error More serious conflicts that deserve careful inspection Errors can occur in the following situations z When multiple packages install files of the same name and different hash values to the same directory z When multiple packages install files of the same name and same hash value to the same directory but the component GUID...

Page 18: ...Help menu Reference Manual Getting Started Guide The Getting Started Guide contains system requirements installation instructions and a tutorial You can access a PDF version of the Getting Started Guide from the Windows Start menu The installation and repository management sections of the Getting Started Guide are also available as online help In the Wise Repository Manager select Help menu Help T...

Page 19: ...efine the conflict settings on the Conflict Settings dialog box which you access by selecting Setup menu Conflict Settings This dialog box contains the following tabs Note If you change conflict settings after you run conflict detection you must rerun conflict detection to apply the changes Defining Types of Conflicts to Detect These settings are stored in the Software Manager database and affect ...

Page 20: ...d size Clear this to have the conflict detection find date and time differences when all other file information is the same 5 Ignore Component GUID mismatches if both files have the shared DLL counter set Normally installing two files with the same name to the same location when their component GUIDs do not match causes a conflict even if the shared DLL counter is set for both files When the share...

Page 21: ...e configured differently by multiple packages NT Services Find Windows NT services that are installed by multiple packages Devices Find device drivers that are installed in Win ini by multiple packages INI Files Find changes to ini files that are made by multiple packages Shortcuts Find shortcuts that are installed by multiple packages Path Additions Find changes to the PATH variable that are made...

Page 22: ...ed You can add them to the conflict settings at any time These settings are stored in the Software Manager database and affect any user who is connected to that database The upper left list box contains a composite of all directories created on the destination computer by all packages in the Software Manager database Some installed files or directories might be located in the Windows directory or ...

Page 23: ...s 5 Click OK on the Add Wildcard dialog box The Conflict Settings dialog box reappears with the directory added to the lower left list box The lower right list box contains files in that directory that should be ignored and indicates whether they are applied to subdirectories If you entered a wildcard it appears in the Filename column If you left the Wildcard field blank a single asterisk appears ...

Page 24: ...2 5 Click OK on the Conflict Settings dialog box Note If you delete a value from the lower right list box and it makes the key empty the corresponding registry key subtree is still displayed temporarily but disappears after you close the Conflict Settings dialog box Conflict Resolution Rules The ConflictManager resolution rules let you resolve file conflicts automatically Using resolution rules sa...

Page 25: ...s are added to each new database you create If you open a database created in a previous version of ConflictManager it is updated and the predefined rule sets are added See also Predefined Rule Sets on page 25 How Conflict Resolution Rules Are Applied Conflict resolution rules are applied in the order they appear from top to bottom in the list of rules on the Conflict Resolution Rules dialog box W...

Page 26: ...he actions you mark appear in the Rule description list Note When you mark an action any other actions that are incompatible with it are unavailable Aggressive using application paths Aggressive using isolated components These rule sets change as many files as possible in the active package and can change files in other conflicting packages They replace all conflicting files with the most recent v...

Page 27: ...t either is or is not 11 When you finish adding conditions that comprise the rule click Next on the Conditions page The Sort Order page appears 12 In Which sort s do you want to perform mark the check box next to each sort option to perform in the order they should be performed You can rearrange the sort order later As you mark check boxes the sort options appear in the Rule description list 13 To...

Page 28: ...Windows Installer Editor Do this to compare a package that is still in the authoring phase with those that have already been deployed without importing the package into the Software Manager database This lets you z Streamline repackaging by identifying conflicts earlier in the process z Maintain your Software Manager database as a pristine image of packages that have already been deployed in the p...

Page 29: ...t conflict information See Detecting Conflicts on page 30 and Viewing Conflicts on page 31 2 Resolve conflicts Resolving a conflict involves looking at each file that is installed by multiple packages and selecting the version to install on the destination computer You also can change the location of conflicting files so that each package can use its version of the file You can use conflict resolu...

Page 30: ...mport it checks for conflicts between the imported package and all other packages it does not re detect conflicts between all packages To detect conflicts 1 Enterprise Management Server only If multiple databases are open select a database in the Applications Packages pane 2 Select Conflicts menu Detect The Detect Conflicts dialog box appears 3 Mark one of the following To revert changes for just ...

Page 31: ...ar z You can continue to use ConflictManager z You cannot close ConflictManager When conflict detection is complete the right end of the toolbar displays Idle and you can review conflicts See Viewing Conflicts on page 31 Stopping Conflict Detection Stop conflict detection if you need to close ConflictManager Stopping conflict detection before it finishes can leave partial records in the database I...

Page 32: ... do not appear even when the conflict filter is set to display registry conflicts 6 In the Conflict List select a conflict The conflicting resources in other packages appear in the Conflict Details pane 7 To view a conflicting resource s properties double click it in the Conflict Details pane The Properties dialog box appears Note Because they are rare the Properties dialog box is not available fo...

Page 33: ...ict attributes click the Conflicts tab and mark any combination of check boxes Errors Include conflicts that will cause problems Warnings Include conflicts that are not critical but might require some attention File Conflicts Registry Conflicts Other Conflicts Include ODBC and ini file conflicts Only display packages with conflicts Display resolved conflicts Include resolved conflicts in addition ...

Page 34: ...r conflict settings are set to detect file conflicts only then registry conflicts do not appear even when the conflict filter is set to display registry conflicts Hiding Conflicts Conflicts that are identified by ConflictManager are often found to be harmless upon further testing Normally ConflictManager will continue to display these conflicts To filter these harmless conflicts from the conflict ...

Page 35: ... Resolving and Exporting Package Types on page 44 Guidelines for Resolving File Conflicts Before you resolve a conflict analyze the conflicting file s version date time size and other information to determine the cause of the conflict You can view the file information in either the Conflict Details pane or the Resolve wizard pages If you use conflict resolution rules the rules perform the conflict...

Page 36: ...but component GUIDs do not match and none of the components are marked to be permanently installed After both packages are installed uninstalling one of them will remove the file breaking the remaining package Match GUIDs for identical files across packages Resolve wizard Copy Up or Copy Down button Rule action Replace the MSI component GUID with the matching conflicting file s GUID Or Use the MSI...

Page 37: ... it is best to isolate the files See Isolating Files on page 38 How to copy file information You can copy files using a conservative method which does not change other packages or an aggressive method which changes other packages You must export recompile and test any other packages that you change The following table describes how to copy file information using a conservative or aggressive method...

Page 38: ... is best to isolate both versions of the file in their respective packages File isolation methods When the conflicting files are listed in the registry using an application path to move them to a private application directory can cause problems ConflictManager updates the Aggressive Use the Copy Down button z Use a conflict resolution rule containing this action Replace the conflicting files with ...

Page 39: ...lated Components Both of the predefined aggressive rule sets contain this action If you create your own rules add this action and set its variable to AppPaths or Isolated Components When you select the AppPaths variable a second line is added to the action into directory Shared If you leave this line as is the application path is set to a directory named Shared under the main application directory...

Page 40: ...come page appears 3 Specify the application and package to resolve conflicts for 4 From Isolation Method select an option Selecting an isolation method activates the Move button on the File Conflicts and File Conflicts in Registry dialog boxes See Isolating Files on page 38 Do not move files Do not allow file isolation Isolated Components Isolate files using Windows Installer isolated components T...

Page 41: ...nternal version number To change the file s component click Fix Comp If the file is a KeyPath to a component in one package but not in another the file becomes a KeyPath to its own component If the file has extra non advertising resources they are moved to a new component If the file s shared DLL counter is not set it is set If the component has more than one of these issues a Fix Options dialog b...

Page 42: ...he active package select a file in each list and click Copy Up The file remains in its current location but will be used to install the package in the upper list box To open a separate dialog box listing the registry keys that contain the path to the selected file click Reg Details To undo changes click the file and click the upper or lower Revert button depending on whether the file is in the upp...

Page 43: ...lick the package containing the registry value to use The Properties dialog box appears 7 On the Registry Key Settings tab a Click in the Data Value field b Copy the value to the clipboard c Click Cancel 8 In the Conflict Details pane double click the package containing the registry conflict to resolve The Properties dialog box appears 9 In the Registry Key Settings tab a Select the contents of th...

Page 44: ...flicts 5 In the Conflict List select an INI item The conflicts for the item appear in the Conflict Details pane 6 In the Conflict Details pane double click the package containing the INI value to use The Properties dialog box appears 7 On the Edit INI File Settings tab a In the INI File Contents section click in the Entry column b Copy the value to the clipboard c Click Cancel 8 In the Conflict De...

Page 45: ...ase you cannot resolve conflicts in or export the transform package Patches Patch files contain binary differences instead of full files Alternatives z Apply the patch during import of the base package Then the patch s resources are added to the resources of the base package and you can resolve conflicts for the base package z Create a WiseScript wrapper that installs the patch and then performs a...

Page 46: ... export a single package 1 Enterprise Management Server only If multiple databases are open select a database in the Applications Packages pane 2 Select Packages menu Export The Export Package dialog box appears 3 Complete the dialog box Application Name Select the application to export Package Name Select the package to export Installation File Specify the path and file name of the Windows Instal...

Page 47: ...lict resolution changes plus a new package code and version which will reinstall over the previous version to update it To create a patch between the package you are exporting and the previous version use the Patch Creation tool Major Change ProductCode Version and PackageCode Select this option to ship this version of the package as an upgrade This option creates a package installation containing...

Page 48: ...e added to the Software Manager database Because the default SQL Server backup process does not include triggers you should change your backup configuration to include them File Conflicts by Package Lists all file conflicts between selected packages and the packages of all other applications The conflicts are grouped by application and package name and arranged in each group by file name File Conf...

Page 49: ...ntry therefore a report with 10 entries results in 10 pages The lower the number the faster the report generates The default value is 6000 Note If you save a report as an HTML file an HTML file is created for each page of the report Conflict Types to Display Errors are conflicts that deserve attention Warnings are conflicts that probably will not cause a problem Application and Package Name Confli...

Page 50: ...specify in the INI file A report log is also created in the same directory If you generate multiple reports save them in different directories to prevent the report log from being overwritten Using the Report Viewer After you generate a report it is displayed in a report viewer window z To save a report click Save As in the lower right of the report viewer window You can save a report in HTML XML ...

Page 51: ...ch conflict The conflict level can have one of the following values A file can have a combination of conflicts with different applications In that case the conflict level has one of the following values 1 Informational not a true conflict and not likely to cause a problem 2 Warning a possible conflict 4 File error deserves attention 8 Component error deserves attention 3 informational warning 1 2 ...

Page 52: ...ct resolution rules See resolution rules conflict settings about 19 command unavailable 8 defining 19 excluding directory 22 excluding file 22 excluding registry key 23 excluding wildcard 23 type specifying 19 conflict type 51 about 17 defining in settings 19 error 20 icons 17 informational 17 20 warning 17 20 ConflictManager window about 10 customizing 12 toolbar 11 ConflictManager about 8 conser...

Page 53: ...21 O OCX file conflict 13 ODBC conflict about 16 detecting 21 open database 9 order rule set 27 overwrite original installation file 47 47 P package attributes viewing 12 read only 35 46 reverting to original 26 testing after resolution 29 viewing conflicts 31 package definition filtering package display 33 patch cannot resolve or export 45 PATH variable conflict about 17 detecting 21 unavailable ...

Page 54: ...er database 9 active 10 closing 10 opening multiples 9 sort files in rules 25 27 SQL Server backing up triggers 48 start ConflictManager 9 status conflict detection 11 31 status package filtering package display 33 stop conflict detection 31 subscription cannot resolve or export 45 Summary pane 11 system requirements Wise product Refer to Getting Started Guide system resource conflict 13 T test re...

Reviews: