Novell ADMINSTUDIO 9.5 User Manual Download

Page: 524 / 1842

Chapter 8: Converting Legacy Installations Using the Repackager Interface

Creating Repackager Projects

524

ADS-0950-UG00

AdminStudio 9.5 User Guide

•

Command Line

—You can use the Command Line to bulk convert multiple ZENworks projects to Windows

Installer packages. See

Converting Multiple Novell ZENworks Projects Using the Command Line

Note •

In order to convert an .aot file, the ZENworks Desktop Management Agent 6.5 or later (zenlite.dll) must be

installed on the workstation where Repackager is installed. If this agent is not installed, Repackager can only
convert ZENworks .axt files. See

About .axt and .aot Application Object Template Files

for more information.

Converting a Novell ZENworks Project Using the Repackager Interface

Using Repackager, you can convert Novell ZENworks 3.0, 3.1 or 4.0 projects (

.axt/.aot

) to Windows Installer

packages (

.msi

About .axt and .aot Application Object Template Files

In ZENworks Desktop Management, the

snAppShot

utility generates application object template files—with either

.axt

.aot

extension—that contain the details that are required for the Application Launcher to be able to

distribute an application to a workstation:

•

registry entries to be added

•

files to be copied

•

changes to be made in the

.ini

files and system text files (

autoexec.bat

and

config.sys

)

Because an

.axt

file is a text file that can be edited with a text editor in order to modify it after it has been created,

it can be opened and converted by Repackager.

However, in order to convert a

.aot

file (which is not a text file), the ZENworks Desktop Management Agent 6.5 or

later (

zenlite.dll

) must be installed on the workstation where Repackager is installed. If this agent is not installed,

Repackager can only convert ZENworks

.axt

files.

Note •

For information on installing the ZENworks Desktop Management agent (version 6.5 or later) to a

workstation, see one of the following:

•

Novell ZENworks 6.5 Desktop Management Installation Guide

http://www.novell.com/documentation/zenworks65/dminstall/data/front.html

•

Novell ZENworks 7 Desktop Management Installation Guide

http://www.novell.com/documentation/zenworks7/index.html?page=/documentation/zenworks7/dm7install/
data/front.html

Task:

To convert a Novell ZENworks project (.axt/.aot) to a Repackager project (which can subsequently be
built into a Windows Installer package):

Launch Repackager.

On the

File

menu, click

Open

Summary of Contents for ADMINSTUDIO 9.5

Page 1: ...AdminStudio 9 5 User Guide Version 9 5...

Page 2: ...t FLEXcertified FLEXnet Connect FLEXnet Connector FLEXnet Manager FLEXnet Publisher Globetrotter InstallShield InstallShield Developer InstallShield DevStudio InstallShield Professional and Package Fo...

Page 3: ...ng Help 75 Contacting Us 77 2 Using the Process Assistant 79 Using the Process Assistant 80 Home Page 81 Package Page 82 Customize Page 82 Adding Transforms to an MSI Package 83 Resolve Conflicts Page...

Page 4: ...t Packages 105 Creating a New Group 106 Test Page 106 Distribute Page 107 Distributing Transforms With an MSI Package 108 3 Using the AdminStudio Interface 109 Configuring the AdminStudio Interface 11...

Page 5: ...ew Tools from the Workflow Templates Tab 124 Creating and Using Projects 125 Creating Workflows with the New Workflow Project Wizard 125 Filtering Projects 126 Executing Projects 126 Running Associate...

Page 6: ...155 4 Managing Users Directory Services and User Logins 157 Managing Users and Groups 157 Creating a New User Account 158 Importing Directory Services Users and Groups 158 Disabling a User or Group A...

Page 7: ...ult System Roles 193 Default System Users 194 Creating a New Role 195 Editing an Existing User Role 195 Copying an Existing Role 196 Deleting a Role 196 Roles Reference 197 Role Administration Page 19...

Page 8: ...s 223 Extended Attribute Description File 223 Integrating Package Extended Attribute Data with an Application Request 225 Viewing Package History 226 Deleting Packages 228 Importing Data 228 Importing...

Page 9: ...Using the Merge Wizard 262 Automatically Importing Packages 263 Automatically Importing Packages in a Remote Application Catalog 264 Linking to a Remote Application Catalog 264 Editing a Link to a Rem...

Page 10: ...ger Interface 303 Menus and Toolbar 303 Product View Icons 306 Merge Modules View Icons 309 Context Menus 310 Output Window 314 User Permissions in Application Manager 315 Application Manager Views 31...

Page 11: ...cation Catalog Properties Dialog Box 339 Associate with Workflow Manager Application Dialog Box 340 Change Enterprise Server Password Dialog Box 340 Command Line Parameters Dialog Box 341 Connect Appl...

Page 12: ...ormation Panel 369 Target Package Information Panel Software Repository 369 Target Package Information Panel Transforms Patches 370 Import Options Panel 370 Additional non MSI Import Options Panel 370...

Page 13: ...ables 389 ConflictSolver Tables 389 MSI Tables 390 MSM Tables 394 OS Snapshot Tables 399 Workflow Tables 399 Security Tables 400 Workflow Manager Tables 400 Application Catalog Replication Tables 402...

Page 14: ...porting Multiple Windows Installer Packages Simultaneously 433 Importing Multiple Merge Modules Simultaneously 434 Simultaneously Importing Windows Installer Packages and Merge Modules 434 Using the C...

Page 15: ...aging Using the Snapshot Method 466 Performing Multiple Step Snapshot Repackaging 467 Step 1 Selecting the Repackaging Method 467 Step 2 Initial Analysis 469 Step 3 Install Setup and Make Manual Syste...

Page 16: ...cy Installations Using the Repackager Interface 522 Converting Repackager 3 x Output Files 523 Converting a Microsoft SMS Project to a Repackager Project 523 Converting Novell ZENworks Projects 523 Co...

Page 17: ...rtcuts 557 Excluding All Shortcuts in a Directory 557 Excluding Shortcuts from Subdirectories 557 Specifying the External Configuration File 558 Modifying External Configuration Files 559 Configuring...

Page 18: ...599 Deleted Registry Entries View 600 Repackaged Output View 601 Package Information View 605 Advanced Settings View 606 SmartScan Wizard 608 Welcome to the SmartScan Wizard Panel 609 Original Instal...

Page 19: ...ons 652 ThinApp Virtual Operating System 653 Components of a ThinApp Application 653 Benefits of Deploying ThinApp Applications 655 Prerequisites for Building a ThinApp Application 655 About Citrix Vi...

Page 20: ...ary Folder 703 Error 9006 Error Decompressing Package 703 Error 9007 File With Extension Not Found 704 Error 9008 Error Extracting Icon 704 Error 9009 Unknown Provider 705 Error 9010 Invalid Target Fi...

Page 21: ...tries 725 Error 9114 Error Writing Citrix Shortcuts 725 Error 9115 Error Saving Citrix Profile 726 Error 9116 Error Creating Empty Citrix Profile 726 Error 9117 Error Creating Intermediate Folder 726...

Page 22: ...Rules Engine 742 Error 9401 Error Initializing App V Writer 742 Error 9402 Error Initializing App V Package 742 Error 9403 Error Writing App V File Entries 743 Error 9404 Error Writing App V Folder En...

Page 23: ...nts of an App V Application 768 About the Microsoft App V Assistant 770 Process for Authoring an App V Application Using the Microsoft App V Assistant 771 Supported InstallShield Project Types 773 How...

Page 24: ...ng a Windows Installer Package to Assist in the Distribution of an App V Application 806 Specifying Package Feature Block Optimizations 806 Building an App V Application 808 Testing an App V Applicati...

Page 25: ...Overview of ThinApp Isolation Options 861 Setting Isolation Options for Folders 863 Inheritance of Isolation Options from Folders to Files 864 Modifying Shortcuts to the ThinApp Application s Executa...

Page 26: ...ions 917 ThinApp Not Found 917 ThinApp Application Configuration File package ini 917 BuildOptions 918 Compression 923 Isolation 923 MainApp exe 924 Test exe 927 Creating Citrix Profiles 927 Overview...

Page 27: ...e Registry Settings 959 About the Windows Registry 959 Adding or Deleting Registry Keys and Values 960 Setting Registry Isolation Options 960 Inheritance of Isolation Options in the Registry 961 Modif...

Page 28: ...hield Editor Help Library 1002 12 Customizing Installations Using Tuner 1003 Working with Transforms 1004 Creating New Transform Files 1005 Opening Existing Transforms 1006 Opening Recently Accessed T...

Page 29: ...ns 1027 Removing INI Files 1028 Removing Sections from INI Files 1029 Removing INI File Section Keys 1029 ODBC Resources 1029 Adding New Data Sources 1030 Adding New ODBC Data Source Attributes 1030 A...

Page 30: ...1043 Removing Custom Setup Properties 1043 Modifying Setup Properties 1043 Preparing Packages for Distribution 1044 Copying the Installation to a Network Location 1044 Copying the Installation to an F...

Page 31: ...1067 Shortcuts View 1068 Shortcuts View Shortcut Properties 1069 Shortcuts View Shortcut Target 1071 Shortcuts View Shortcut Locations 1072 INI Files View 1073 ODBC Resources View 1074 NT Services Vi...

Page 32: ...ice and Conflict 1095 Connecting to Existing Application Catalogs 1095 Best Practices for Conflict Detection 1096 Plan Your Import 1096 Plan Your Conflict Detection 1098 Perform Conflict Detection 109...

Page 33: ...ly in Windows Installer Packages 1123 Using Transforms for Conflict Resolution 1123 Reimporting Packages after Successful Conflict Resolution 1124 Generating Reports 1124 Generating Package Reports 11...

Page 34: ...71 WTS02 1171 WTS03 1172 WTS04 1173 WTS05 1174 User Defined ACEs 1174 Types of User Defined ACEs 1175 Creating User Defined ACEs 1176 Creating a Custom Source Only Packages ACE 1176 Creating a Custom...

Page 35: ...iew for OS Snapshots 1212 Other Setup Types View 1212 Tables View for Other Setup Types 1213 NCP Views 1213 Conflicts View for Marimba NCP Files 1214 Tables View for Marimba NCP Files 1214 Patches Tab...

Page 36: ...Dialog Box 1240 Rules Viewer Dialog Box 1240 Wizards 1240 Conflict Wizard 1240 Welcome Panel 1241 Source Type Panel 1242 MSI Source Information Panel 1242 Source Package Panel 1242 Choose Action Pane...

Page 37: ...g Test Results in ConflictSolver 1272 Deleting Test Results 1273 Customizing Test Results 1274 Changing the Severity of a Specific Error 1274 Suppressing the Display of Specific Errors 1279 Adding Ad...

Page 38: ...Viewing Patch Impact Analysis Results 1329 Viewing Patch and Patch Impact Information in Application Manager and ConflictSolver 1331 Generating the Patch Report 1335 Reference 1336 Patch Impact Analys...

Page 39: ...ress Panel 1357 Completing the Application Isolation Wizard Panel 1357 Advanced Options Dialog Box 1357 Manifest Options Tab 1358 Digital Signature Tab 1359 Manifest and Assembly Design Dialog Box 136...

Page 40: ...solation Tests 1387 Filtering Results of Lockdown and Runtime Tests 1388 Using MSI Doctor to Verify Package Deployment Status 1389 View Product Feature or Component Deployment Status Properties 1391 V...

Page 41: ...1415 ODBC Data Sources View 1416 ODBC Drivers View 1416 Services View 1416 Lockdown and Runtime Tests View 1417 Runtime Execution Details View 1417 Files View 1418 Folders View 1419 Registry Entries...

Page 42: ...geSoft Package and Environmental Settings Panel 1460 Marimba Panels 1461 Patches Panel 1461 Marimba Integration Panel 1462 Advanced Marimba Options Dialog Box 1463 Network Location Panel 1463 SMS Dist...

Page 43: ...Manager Server 1514 Viewing the Status of a Distributed Package 1514 Modifying the Distribution Settings of a Package 1514 Deleting Packages 1515 Configuration Manager Web Console Reference 1517 Micro...

Page 44: ...on Panel 1562 Web Service URL Panel 1563 Select Application Catalog Panel 1563 Deployment Conflict Test Selection Panel 1564 Review Panel 1565 Progress Panel 1566 Summary Panel 1566 Options Dialog Box...

Page 45: ...nse Requirements and Access Restrictions 1613 Configuring a Connection to the FLEXwrap License Server 1614 Specify the Output Folder and Build Package 1616 Next Steps 1616 Setting Licensing Options 16...

Page 46: ...Command Line 1640 Stopping the License Server 1641 Checking the Status of the FLEXwrap License Server 1641 Checking the License Server Status from the FLEXwrap Server Configuration Tool 1641 Checking...

Page 47: ...Page 1692 Information Included in Package Reports 1696 Package Summary Information View 1697 Files View 1698 Registry View 1699 Shortcuts View 1700 ODBC Drivers View 1701 ODBC DS View 1702 Extended At...

Page 48: ...om Jobs 1748 Selecting Contextual Packages in a Custom Job 1749 Dynamic Group Content Identification 1749 Conflict Resolution and the Software Repository 1750 User Permissions and Job Manager 1751 Dir...

Page 49: ...ng Configuration Options 1773 Job Manager Reference 1775 Jobs Queue Page 1776 Add Job Page 1777 Edit Job Page 1780 Delete Job Template Page 1782 Schedule Job Page 1782 Job Alerts Page 1783 Job Status...

Page 50: ...Contents 50 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 51: ...User Guide ADS 0950 UG00 51 Part 1 Getting Started This part of the AdminStudio 9 5 User Guide includes the following chapters AdminStudio 9 5 Help Library Using the Process Assistant Using the AdminS...

Page 52: ...52 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 53: ...tent Part 1 Getting Started Using the Process Assistant Explains how to use the Process Assistant a procedure based alternative interface to the standard AdminStudio interface Using the AdminStudio In...

Page 54: ...er Packages to Virtual Applications Explains how to use Repackager s Windows Installer Converter to create virtual applications Creating Customized Virtual Applications Explains how to use the Install...

Page 55: ...versions of components such as DLLs with which it was originally developed and tested Ensuring Package Quality Using QualityMonitor Explains how to use QualityMonitor to run a series of built in tests...

Page 56: ...ow to use the Predeployment Test tool to determine if a Windows Installer msi package will succeed or fail when it is installed in production by finding issues with disk space install conditions and c...

Page 57: ...y to Detect the Presence of a Virtual Machine New Support for Setting Permissions for Files Folders and Registry Keys Unicode Support Support for 64 Bit COM Extraction New InstallShield Prerequisites...

Page 58: ...t user Support for Reducing the Time for Installing Large Packages Use the new Fast Install setting in the General Information view to select one or more options that may help reduce the time that is...

Page 59: ...his view also has support for dynamic searches as you are typing a string in the search box InstallShield hides all of the rows that do not contain it The top of the view has a new group box area you...

Page 60: ...e either integrated or classic for an application pool Enable 32 Bit Applications This setting lets you specify whether you want to allow 32 bit applications in the selected application pool to be run...

Page 61: ...t can be already present on the target system Previously the only option that InstallShield offered for setting permissions was to use the traditional Windows Installer handling With this option the p...

Page 62: ...ing and viewing Unicode characters from multiple character sets at the same time Support for 64 Bit COM Extraction InstallShield now supports 64 bit COM extraction If you are using InstallShield on a...

Page 63: ...project Support for HTML Controls on Dialogs During InstallScript and InstallScript MSI Installations InstallShield includes support for HTML controls on dialogs in InstallScript and InstallScript MSI...

Page 64: ...the Services node In addition the previously available service related settings are now consolidated in the same grid with the new settings In earlier versions of InstallShield these previously avail...

Page 65: ...ol Events When you are adding a control to a dialog in your project you can select one of the new events that is now available for Windows Installer 5 MsiPrint You can add this event to a push button...

Page 66: ...Ability to Specify Global Setting to Identify Build Location Microsoft App V Assistant OS Requirements List Now Includes Windows 7 and Windows Server 2008 R2 Microsoft App V Assistant Now Uses UTF 8...

Page 67: ...you specify an existing writable location where all virtual packages should be built You may want to use this global setting if you are converting msi packages that are in a read only location to vir...

Page 68: ...usions for Windows 7 The process exclusions used by the Repackager Installation Monitoring method has been updated to include the process exclusions for Windows Vista and Windows 7 Enhanced Support fo...

Page 69: ...FLEXwrap Distribution Wizard Professional The Professional Edition is designed for professional packagers It includes application management testing and conflict resolution tools as well as additional...

Page 70: ...Studio Enterprise Edition includes the following note Edition This feature is included with AdminStudio Enterprise Edition Virtualization Pack AdminStudio offers a Virtualization Pack that includes Mi...

Page 71: ...dition you purchased and click the Activate button After a few seconds you will receive a message that activation was successful 5 Click Finish AdminStudio will launch Note If you want to evaluate the...

Page 72: ...days By clicking Continue to Evaluate AdminStudio dialog box that opens when you launch AdminStudio you can begin evaluating the AdminStudio 9 5 Enterprise Edition client tools To evaluate the AdminS...

Page 73: ...nd the InstallShield App V Assistant However an App V application built using an evaluation version of AdminStudio will display the following message every time it is launched Figure 1 1 Evaluation Ve...

Page 74: ...About AdminStudio from the Help menu 4 Click Activate The Upgrade and Activate dialog box opens 5 Select the I have an AdminStudio Enterprise Server evaluation serial number option and click OK The E...

Page 75: ...box opens prompting you to enter the serial number of the edition that you want to upgrade to 6 Enter the serial number of the edition you purchased and click the Activate button After a few seconds...

Page 76: ...n that is essential for users to read Caution Cautions indicate that this information is critical to the success of the desired feature or product functionality Tip Tips are used to indicate helpful i...

Page 77: ...enter Setup exe s v qn Command line statements and parameters are presented in a monospace typeface Environment Variables Set the value of the windir environment variable Environment variables are pre...

Page 78: ...Chapter 1 AdminStudio 9 5 Help Library Contacting Us 78 ADS 0950 UG00 AdminStudio 9 5 User Guide http www flexerasoftware com...

Page 79: ...nflicts between Windows Installer packages Using the Process Assistant decreases the time required for new AdminStudio users to prepare software packages for deployment and also enables veteran system...

Page 80: ...e steps involved in preparing a package for deployment Navigating in the Process Assistant You move through the Process Assistant using the navigation bar at the bottom of the page Figure 2 1 Process...

Page 81: ...e you can also select an installation program and when you click Start the Process Assistant will open the Page that is most appropriate for the file selected For example if you select Windows Install...

Page 82: ...aller msi package 7 Click Repackage to launch the Repackaging Wizard Customize Page On the Customize Page you can customize your installation by directly modifying the Windows Installer package or by...

Page 83: ...orm conflict detection to identify these conflicts before you deploy packages and resolve the problems before they affect your end users On the Resolve Conflicts page you select the Windows Installer...

Page 84: ...nabled and you want to add the package that you are importing to the Software Repository select the Add package to the Software Repository option on the Organize Package Page of the ConflictSolver Pro...

Page 85: ...ional and Enterprise Editions The ConflictSolver Process Assistant a procedure based alternative interface to the ConflictSolver Application Manager interface guides you through the process of identif...

Page 86: ...o Yes to enable the transform fields and then select transform files To locate and select a transform file click the New button If the package requires multiple transforms you can repeat the procedure...

Page 87: ...a source package in conflict detection 4 Click Continue The Validation Page opens Current and New Packages On the Select a Package Page you choose the package that you are going to process using the...

Page 88: ...Assistant Figure 2 2 Draft Group visible on the Select a Package Page By placing these newly imported packages into the Draft group you are indicating that these packages are in the process of being...

Page 89: ...Checking packages for validation at the time of import is often unnecessary Also conflict detection at the time of package importation will become an exponentially slow operation as the size of your A...

Page 90: ...file and listing any values that have previously been entered 3 To edit an attribute click the attribute link A dialog box opens and prompts you to enter text make a selection from a list or upload a...

Page 91: ...in the context of the whole database Note For a full listing and description of all Microsoft ICEs see ICE Reference in the Microsoft MSDN Library Validation Error Severity Ratings When ConflictSolver...

Page 92: ...et of Microsoft ICEs In the overwhelming majority of cases this is the file you will want ConflictSolver to use when performing validation However there may be times you want to compare your base pack...

Page 93: ...determine if an installation package is built according to Windows Installer standards an ACE is a custom action included with ConflictSolver that is also used to enforce Windows Installer standards...

Page 94: ...le MSI table that is not being executed with an associated DuplicateFiles action If a package contains data in the DuplicateFile table but not the necessary actions to use this data a warning is gener...

Page 95: ...e table If so open the MSI file in InstallShield and add the appropriate action to the InstallExecuteSequence table or remove the unused data from the MoveFile table ACE32 Checks entries in the Regist...

Page 96: ...xists in the RemoveRegistry MSI table that is not being executed with an associated RemoveRegistryValues action If a package contains data in the RemoveRegistry table but not the necessary actions to...

Page 97: ...he conflict indicates its status 5 Select the conflict you want to resolve and click Resolve Alternatively click Resolve All to resolve all resolvable conflicts for the selected conflict category 6 Fo...

Page 98: ...a transform file MST The original Windows Installer package MSI remains untouched You can override this option for an individual package by going to that package s Conflict View and clicking Edit and...

Page 99: ...ge you are checking for conflicts Typically target packages are a group of applications and operating systems that are installed on workstations at your organization You would perform conflict detecti...

Page 100: ...ckages ConflictSolver uses Application Conflict Evaluators ACEs Some ACE failures can be resolved automatically by ConflictSolver These automatic resolution techniques are defined in Conflict Applicat...

Page 101: ...this option if you want to review and approve the suggested resolution for each conflict before ConflictSolver performs any resolutions When the conflict detection process is completed the Resolution...

Page 102: ...ation Lists all validation errors and warnings found during the most recent validation execution for that package Note Validation information is persisted only for validations performed after the pack...

Page 103: ...d it is ready for distribution at your organization you should then move it out of the Draft group using the Organize Package Page The package will then be visible on the ConflictSolver and Applicatio...

Page 104: ...Page opens In the Destination Groups list the check boxes next to the Groups that your package is in if any are selected If you have just imported a package it is still in the Draft group which is not...

Page 105: ...ge of the Process Assistant By placing these newly imported packages into the Draft group you are indicating that these packages are in the process of being prepared for distribution and should not be...

Page 106: ...To test a package installation 1 Click on the Test icon in the navigation bar The Test Page opens 2 In the Package File field specify the name of the package that you want to test The fields on the Te...

Page 107: ...ckage Distribute Page On the Distribute Page you prepare your package for distribution Task To prepare your package for distribution 1 Click on the Distribute icon in the navigation bar The Distribute...

Page 108: ...ribute Page After you have selected the package to distribute click the New button to launch the Select Transform Files dialog box and select a transform file mst If the package requires multiple tran...

Page 109: ...mentation is presented in the following sections Table 3 1 AdminStudio interface Documentation Section Description Configuring the AdminStudio Interface Includes information on customizing the AdminSt...

Page 110: ...ge You can also launch AdminStudio applications by double clicking on the tool icon in the Tools Gallery on the Tools Tab Table 3 2 Topics on AdminStudio Interface Configuration Category Topics Launch...

Page 111: ...Note If a core AdminStudio tool is not in the Tools Gallery or available from the menu it may mean that either you are not assigned to a Role that has permission to use that Tool or that the Tool is n...

Page 112: ...d conflict identification and other AdminStudio functions The AdminStudio Shared Directory contains the following The Shared AdminStudio ini file which specifies default Application Catalog database s...

Page 113: ...ce 2 From the Tools menu select Options The Options dialog box opens 3 Select the Locations tab 4 Enter or browse to the Task Help Page Location the location where workflow task help pages are stored...

Page 114: ...s debugging is turned on a log file will be created in the same location as the exe file HKLM Software InstallShield AdminStudio DebugLogLevel 3 Levels 0 1 2 3 are supported with 3 being the highest D...

Page 115: ...Options Dialog Box opens 3 Select the Locations tab 4 Enter the Configuration Manager Web Console URL 5 Click OK to close the Options dialog box Working with Tools Topics in this section involve addi...

Page 116: ...Wizard the new tool appears in the Tools Gallery and is available for use in workflows and projects Note In AdminStudio tools are any external application or file that you can launch from a workflow o...

Page 117: ...he Tool Properties dialog box Note In AdminStudio tools are any external application or file that you can launch from a workflow or project This typically is an application but can be a simple documen...

Page 118: ...e and click Delete 4 Click OK to close the Tool Properties dialog box Note In AdminStudio tools are any external application or file that you can launch from a workflow or project This typically is an...

Page 119: ...he task with which the tool is associated and select Run Task from the context menu Note In AdminStudio tools are any external application or file that you can launch from a workflow or project This t...

Page 120: ...based on these workflows and execute them following the specific steps defined in the workflow This allows you to create specific repeatable procedures to accomplish your application migration goals T...

Page 121: ...ow Templates tab appears 2 Right click in the Workflows tree pane and select New Workflow A new Workflow is listed 3 Provide a name for the workflow Renaming Workflows Task To rename an existing workf...

Page 122: ...ect the Workflow Templates tab in the interface 2 Right click the workflow to which you want to add the task and select New Task Alternatively right click on a task and select New Task to create a sub...

Page 123: ...notes you enter as the default notes for the specific task Note There is a 255 character limit on notes Renaming Tasks Task To rename an existing task 1 Select the Workflow Templates tab in the Interf...

Page 124: ...button to open a default HTML page in an HTML editor as a starting point Note Help files must be in HTML format Deleting Tasks Task To delete an existing task 1 Select the Workflow Templates tab in t...

Page 125: ...o create a workflow using the New Workflow Project Wizard 1 Launch AdminStudio 2 Click the Projects tab 3 Right click in the Projects tree and select New Project The New Workflow Project Wizard launch...

Page 126: ...rojects tree 3 Click the first task in the project 4 Perform the task 5 When finished with the task click the box to the left of the task 6 Repeat for subsequent tasks in the project Running Associate...

Page 127: ...command line functionality available in AdminStudio Prior to creating projects you must create a workflow on which to base the project This workflow might involve few steps or it might cover as broad...

Page 128: ...launches 3 From the Welcome Panel click Next The Workflow Selection Panel appears 4 From the Workflow Selection Panel select My Workflow Example as the workflow on which you want to base the new proje...

Page 129: ...jects Workflows Projects and Permissions AdminStudio interface functionality including workflows projects and the Tools Gallery is directly influenced by user authorization and permissions For example...

Page 130: ...s Using ConflictSolver How do I change which conflicts are checked See Changing Default Conflict Types Checked How do I validate a package See Validating Packages How do I identify conflicts See Check...

Page 131: ...See Troubleshooting Guidelines for WinINSTALL Conversion How do I identify and fix SMS conversion problems See Troubleshooting Guidelines for SMS Conversion What do I do if I receive a ISDEV fatal err...

Page 132: ...e to the standard AdminStudio interface is accessible on the Assistant Tab Tools The Tools Tab includes the Tools Gallery and information on the selected tool Workflow Templates On the Workflow Templa...

Page 133: ...e entire AdminStudio Help Library from the Start Page click the Help Library link in the Resources section or click the Help button in the toolbar Figure 3 5 Help Topics and Application Tasks Areas Re...

Page 134: ...ace It guides you through the process of preparing a new application for enterprise use including packaging and feature customization conflict resolution QA testing and deployment hand off The Conflic...

Page 135: ...on the Tools Tab Note If a core AdminStudio tool is not in the Tools Gallery or available from the menu it may mean an administrator has restricted tool access based on user permissions By right clic...

Page 136: ...ls Gallery they also appear in this list If you want to add a tool directly from the Workflow Templates tab select the New Tool option to display the Add New Tool dialog box This adds the tool to the...

Page 137: ...a Workflow Phase in a Workflow Manager Workflow When an AdminStudio Project is linked to a Workflow Manager Workflow please note the following indications on the Projects tab When an integrated Admin...

Page 138: ...to Manage Enterprise Software Packaging in the AdminStudio Enterprise Server Help Library AdminStudio Menus and Toolbar The following commands and toolbar buttons are available in the AdminStudio int...

Page 139: ...hecked the AdminStudio Interface remains on top of all other windows View Start Page Select to open the AdminStudio Start Page View Process Assistant Select to open the Welcome Page of the Process Ass...

Page 140: ...e Alt H R Displays the AdminStudio Release Notes file Help Feedback Alt H F Connects to an online form through which you can provide feedback about AdminStudio Help AdminStudio on the Web Alt H W Conn...

Page 141: ...ou need technical support If you have not registered AdminStudio click the Register button to connect to the InstallShield Web site to begin the Product Registration process Registering your product o...

Page 142: ...application in the Tools Gallery Command Line Arguments Enter any command line arguments for the tool Because you may have different uses for applications you can add the same application multiple ti...

Page 143: ...tual Packages Tab Quality Tab Customer Experience Improvement Program Table 3 6 Command Line Properties Dialog Box Options Option Description Description Provide a description for the configuration Th...

Page 144: ...URL field the default Allow automatic authentication Select this option to allow automatic authentication by AdminStudio Enterprise Server Install AES If AdminStudio Enterprise Server is not installe...

Page 145: ...mats are displayed in the AdminStudio toolset Microsoft App V VMware ThinApp and or Citrix XenApp and you can choose whether to include the App V Application Launcher with App V applications Figure 3...

Page 146: ...mind you can opt out of this program by changing the selection on the Quality tab Table 3 10 Virtual Packages Tab of the Options Dialog Box Option Description Microsoft App V Select to display all Mic...

Page 147: ...ool in the Tools gallery and select Properties This dialog box contains the following tabs Properties Tab Configuration Tab Properties Tab The Properties tab of the Tool Properties dialog box contains...

Page 148: ...alog Box Configuration Tab Options Option Description Command Line List Listing of all command lines defined for this tool Add Click to open the Command Line Properties Dialog Box where you can add a...

Page 149: ...Tab of the Tool Properties dialog box you can create multiple command lines and can use AdminStudio variables in these command lines Then when you go to the Workflow tab and create a new Workflow you...

Page 150: ...pear in the AdminStudio Tools gallery You can specify the tool s executable provide command line options for the tool and provide a link to information about the tool Click Next to proceed to the Tool...

Page 151: ...ed in variables that can be accessed from tools allowing for greater interoperability in AdminStudio The New Workflow Project Wizard includes the following panels Welcome Panel Workflow Selection Pane...

Page 152: ...o needs to know what package to launch Source packages can also be non setup files For example if you are creating a simple workflow that involves editing a Notepad file the source package may be a tx...

Page 153: ...AdminStudio Log Files Log File Location AdminStudio log C Program Files AdminStudio 9 5 predeploytest log C Program Files AdminStudio 9 5 PreDeployTest Client licwrapserver log C Program Files AdminS...

Page 154: ...Chapter 3 Using the AdminStudio Interface AdminStudio Interface Reference 154 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 155: ...Managing Users Roles Permissions Application Catalogs This part of the AdminStudio 9 5 User Guide includes the following chapters Managing Users Directory Services and User Logins Managing Roles and...

Page 156: ...156 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 157: ...s in AdminStudio Enterprise Server Create a user account Create a user account for each person that you want to have access to AdminStudio Enterprise Server See Creating a New User Account Import Dire...

Page 158: ...is assigned to determine what portions of AdminStudio Enterprise Server and Workflow Manager functionality they will have access to Therefore you must assign at least one Role to a user 9 Click Updat...

Page 159: ...all of the users that start with the letter P use the asterisk wildcard character and enter P in the Filter list by box 7 From the Select Group or User to Add list select the group or user to import...

Page 160: ...nments for historical tracking and reporting purposes you cannot delete a user that is associated with a Workflow Manager Application Request In this case you would set the user s Status to Inactive o...

Page 161: ...d user performs the Workflow Step that requests that Data Element information is pulled from the Directory Service to automatically populate the field such as that user s name email address or locatio...

Page 162: ...d in the Domain list on the AdminStudio Enterprise Server login page Note In an enterprise there is usually only one Directory Service that is responsible for authenticating users However you can crea...

Page 163: ...one Directory Service Use Secure Socket Layer SSL Select Yes if this Directory Service is configured to use Secure Socket Layer SSL Connect Anonymously Select No if you do not want to permit anonymous...

Page 164: ...n 1 On the Administration tab click Directory Services The Directory Services page opens 2 Click Manage Directory Services Connections The Directory Services List page opens 3 Select the Directory Ser...

Page 165: ...e you cannot delete this Directory Service Connection Managing Directory Services Attributes When creating a Workflow Manager Template you can assign a Data Element the Data Type of Directory Service...

Page 166: ...vices attribute is used in Directory Services protocol to access information directories such as employeeNumber or documentAuthor 4 In the Attribute Alias text box enter the name that you want to use...

Page 167: ...a Directory Service Active Directory or Novell eDirectory Note For domain account login the Anonymous access option on the IIS Authentication Methods Dialog Box must be selected Using Domain Account...

Page 168: ...ies dialog box opens 4 Open the Directory Security tab and click Edit in the Anonymous access and authentication control area The Authentication Methods dialog box opens Figure 4 2 Anonymous Access op...

Page 169: ...o the following Set up a Windows Active Directory or Novell eDirectory Directory Service Connection See Adding a Directory Service Connection On your AdminStudio Enterprise Server IIS Server open the...

Page 170: ...or groups from that Active Directory Directory Service See Importing Directory Services Users and Groups Note Regarding Single Sign On note the following For Single Sign On IIS performs user authentic...

Page 171: ...nter the user name in the following location of the web config file Guest System Access add key GuestAccount value username companyname com 2 On the Administration tab click Users Groups The User Admi...

Page 172: ...he AdminStudio Enterprise Server Web Application wwwroot directory to log on the Guest account Note The web config file installed by AdminStudio Enterprise Server should contain the GuestAccount key w...

Page 173: ...gned Roles have permission to access Setting the Session Timeout Value When AdminStudio Enterprise Server is installed the session timeout value is set to 20 minutes This means that after you login to...

Page 174: ...in the system From this view you can add a new User edit an existing User or import a Directory Service User or Group Table 4 2 Users Groups and Directory Services Tabs Reference Page Subpages User Ad...

Page 175: ...r Groups from that Directory Service See Importing Directory Services Users and Groups Importing a group allows you to provide dynamic access to all of the members of that Group as the members of that...

Page 176: ...roup Status Select Active to make this user or group active in the AdminStudio Enterprise Server system or select Inactive to disable this account See Disabling a User or Group Account Email User s em...

Page 177: ...ory Service Connection see Adding a Directory Service Connection Select Group or User Specify whether you are importing a User or a Group Filter Directory Service List Select Show All to include all U...

Page 178: ...in this Directory Service to login to AdminStudio Enterprise Server using their enterprise network credentials The information and options are included Table 4 6 Directory Services Page Options Option...

Page 179: ...in to AdminStudio Enterprise Server using their enterprise network credentials Note For Single Sign On IIS performs user authentication For all other login methods AdminStudio Enterprise Server perfor...

Page 180: ...ure Socket Layer SSL Select Yes if this Directory Service is configured to use Secure Socket Layer SSL Connect Anonymously Select No if you do not want to permit anonymous connections If you select Ye...

Page 181: ...mber groups Default values are Active Directory member eDirectory uniquemember User Class Name Enter the object class name used by this Directory Service for users Default values are Active Directory...

Page 182: ...left blank and will be enabled Attribute Alias Name that you want to use to identify the Directory Service attribute in AdminStudio Enterprise Server such as Employee ID or Author Delete Click to dele...

Page 183: ...orkflow Manager Roles and Permissions Creating a New Role Editing an Existing User Role Copying an Existing Role Roles Reference AdminStudio and Workflow Manager Roles and Permissions Permissions are...

Page 184: ...rmits user to view and edit those Projects on the Projects tab that are assigned to him Create Permits user to create new Projects and assign them to users Users with the Create permission see a list...

Page 185: ...atalog dialog box Application Manager Conflict Solver Conflicts Run Analysis Permits user to perform conflict analysis on a package Resolve Permits user to resolve any automatically resolvable conflic...

Page 186: ...ies Permits user to generates a list of all of a package s files that have dependencies with files used by other products or operating systems in the Application Catalog Run Directory Monitoring Permi...

Page 187: ...Roles tab Add Permits user to add new Roles Copy Permits user to copy an existing Role Edit Permits user to modify an existing Role Email Notify Enabled Not currently in use Directory Services View P...

Page 188: ...tails of a Job that they created on the Edit Job page Users with only the View and Manage Jobs permission cannot create a new Job or edit an existing Job When a Role is assigned this permission the Vi...

Page 189: ...ion Request View Permits user to view the Properties and Issues tabs on the Application Progress page of existing Application Requests Add Permits user to create a new Application Request Edit Permits...

Page 190: ...sue Permits user to create and close Critical issues My Notifications View Permits user to view the My Notifications pages My Default Project Notifications and My Application Notifications Edit Permit...

Page 191: ...he External Data Sources subtab of the Administration tab Add Permits user to edit an existing Template and create a new Template Copy Permits user to copy an existing Template Terminology View Permit...

Page 192: ...er User Roles while default Roles created during installation have a Role Type of System System Roles A Role s Role Type is listed on the Role Administration page and cannot be changed Information abo...

Page 193: ...on Catalog that has been upgraded from AMS 2 5 all Roles will have a Role Type of User The following table lists the default System Roles Table 5 4 Default System Roles Role Name Company Name Descript...

Page 194: ...ount is created for each of these System Roles Figure 5 2 Default System Users To see what functionality is available for one of these default System users you could log on as that user and then obser...

Page 195: ...elect the permissions you want to assign to this Role For a detailed list of the available permissions see Role Permission Lists 7 Click the Update button The new Role now appears in the list on the R...

Page 196: ...in the New Role Name field to uniquely identify this Role Note You are not permitted to have two Roles in the same Company with the same name You are permitted to use the same Role name in more than...

Page 197: ...t Click to access the Role Details View where you can edit this Role Role Name Name of Role Role Company Name of company that this Role was defined for Role Description Description of the purpose of t...

Page 198: ...Option Description Copy from Company Select the name of the Company that has a Role that you want to copy Copy from Role Select the name of the Role that you want to copy You can copy either System or...

Page 199: ...e Role Details View Options Option Description Role Name Enter a name to uniquely identify this Role Role Company Select the Company whose employees can be assigned the Role Role Description Enter tex...

Page 200: ...Chapter 5 Managing Roles and Permissions Roles Reference 200 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 201: ...the following sections Table 6 1 Topics Regarding Using Application Catalogs Section Description Application Manager and ConflictSolver Describes the functionality available using Application Manager...

Page 202: ...database and organizing those packages This section compares these tools and includes the following topics Functionality Comparison Accessing the Tools Displaying ConflictSolver Options in Applicatio...

Page 203: ...Import packages Import packages into the Application Catalog Manage packages Organize packages into Groups rename packages and delete packages Merge Wizard Merge data from a source Application Catalo...

Page 204: ...those conflicts Validation Validate Windows Installer package against Microsoft ICEs Internal Consistency Evaluators Test Results View PackageExpert test results Patch Impact Analysis Wizard Launch P...

Page 205: ...Solver You can connect to Application Catalogs from both Application Manager and ConflictSolver as described in Connecting to an Existing Application Catalog However you use the AdminStudio interface...

Page 206: ...nclude binary records Application Catalogs can also store application workflow permissions Predeployment Test Microsoft Patch PackageExpert and Workflow Manager data You can use ConflictSolver and Pac...

Page 207: ...nnect to any standalone SQL Server Application Catalog or you can connect to the AdminStudio Enterprise Server Application Catalog Standalone A Standalone Application Catalog is not associated with th...

Page 208: ...be installed on your machine first then you will have the option to create a new Application Catalog database on that server that is populated with sample data If you do have access to a database ser...

Page 209: ...nnect to an existing Standalone Application Catalog from the AdminStudio client tools 1 Perform one of the following Application Manager and ConflictSolver On the Catalog menu click Connect PackageExp...

Page 210: ...and select Connect from the context menu The Connect Application Catalog dialog box opens displaying three tabs Enterprise Server Standalone and Recent 2 Open the Enterprise Server tab 3 The URL to t...

Page 211: ...log Wizard opens 2 If you want to include a few sample packages in this new Application Catalog select the Include Sample Data in New Catalog option 3 Click Next The Specify Database Information panel...

Page 212: ...the Publication Manager option under Replication on the Catalog menu is enabled Once you have created a database you cannot go back and edit the choice you made on this option Just because you select...

Page 213: ...Server 2 Launch the Enterprise Manager and Query Analyzer 3 In Query Analyzer execute a CREATE DATABASE command to create and identify the new Application Catalog database 4 Select the newly created...

Page 214: ...ication Catalog by selecting the Make this the shared default Application Catalog option on the Connect Application Catalog dialog box Figure 6 2 Default Shared Application Catalog Option on the Conne...

Page 215: ...inStudio Shared Location to the network location where you copied the Shared AdminStudio ini file such as servername AdminStudio Shared c Open the Application Catalog tab d Click Change next to the Sh...

Page 216: ...k location that is accessible to all of the users in your enterprise c Open the Shared AdminStudio ini file that you just copied to a shared network location 2 Insert the following in the Database Set...

Page 217: ...ust search one column in one table of one package Note This search is limited to string type columns The tables that are searched depend upon what is selected when the Find dialog box is opened Task T...

Page 218: ...n the Find What text box The search will be case sensitive If this option is selected then Application Manager will use appropriate wild card characters so that a partial data match is performed The s...

Page 219: ...inStudio 7 0 or later However you can upgrade them using the Legacy Upgrade Wizard a standalone utility that was included with AdminStudio 7 0 and 7 5 The Legacy Upgrade Wizard utility is installed in...

Page 220: ...Product View right click on the group to which the new group should belong and select New Group 2 Provide a name for the new group 3 Press Enter Organizing Products in Application Manager To move prod...

Page 221: ...its name and add a description or other comments To edit this information perform the following steps Task To edit group properties 1 Right click on the group from the Application Manager Product View...

Page 222: ...wing and Editing Package Extended Attributes Extended attributes are optional attributes for packages defined by an Extended Attribute Description File in XML format Because you can manually create th...

Page 223: ...in the Extended Attributes view but to do this do not edit the EA_Default xml file Instead copy the EA_Default xml file rename it make your edits to the new file and then enter the new file name and l...

Page 224: ...ag available only for File types provides the default file extension when you browse for the file Examples of this could be txt bmp doc or representing all files FileFilter Provide the file types to p...

Page 225: ...HelpText Select the type of application from the above list HelpText AttributeDetails Extended_Attribute Integrating Package Extended Attribute Data with an Application Request Note AdminStudio Workfl...

Page 226: ...if changes are made in Workflow Manager they are automatically reflected in Application Manager By design extended attributes data in Application Manager and Workflow Manager data have a one to one r...

Page 227: ...to store for each package When the number of log entries exceeds this amount the oldest entry will be deleted Action Name of the event which was logged Import Reimport Validation Conflict Detection C...

Page 228: ...on Catalog 2 Confirm the deletion Importing Data You can use the Import Wizard to import the following types of data into the Application Catalog Importing Windows Installer Packages Transforms and Pa...

Page 229: ...irtual Package with a Windows Installer Package Importing Merge Modules A merge module msm is a package containing all of the logic and files needed to install distinct pieces of application functiona...

Page 230: ...3 Click Browse and select the Windows Installer package that you want to import 4 If you want to add the selected package to the Software Repository select Add the file s to the Software Repository op...

Page 231: ...cted group and this panel will not appear 12 Select one or more destination groups into which your package will be imported You can also click New to create a new Group When you click Next the Summary...

Page 232: ...at are selected on the Duplicate Package tab of the ConflictSolver and Application Manager Options dialog box to determine if that package has already been imported PackageCode ProductCode Product Lan...

Page 233: ...ding the Product Name with the Manufacturer s name and if necessary appending the Product Name with numbers 1st Package PowerPoint 2nd Package Microsoft Corporation_PowerPoint You can edit the Duplica...

Page 234: ...cation Manager Options dialog box apply globally to all packages that you attempt to import you cannot apply different identifiers to different packages Also since these options are saved in the Admin...

Page 235: ...e list appears enabling you to select any dependencies of the file you are importing For example a dependency might be a file that the transform file references that is stored externally in a separate...

Page 236: ...date an application A patch package contains the actual updates to the application and describes which versions of the application can receive the patch A patch package does not include a database lik...

Page 237: ...Windows Installer package if the Import Wizard finds a virtual package created by AdminStudio in a subdirectory of the directory containing that Windows Installer package you are prompted to also imp...

Page 238: ...created by AdminStudio in a subdirectory of the directory containing the Windows Installer package you have selected to import If a Windows Installer package s virtual package is not in that location...

Page 239: ...ng a Virtual Package After the Import of its Source Windows Installer Package During the import of an AdminStudio created virtual package into an Application Catalog that already contains the virtual...

Page 240: ...Microsoft App V application Select the App V file with an osd extension such as MyApp osd VMware ThinApp application Select the ThinApp file with an exe extension such as MyApp exe Citrix profile Sele...

Page 241: ...yApp exe Citrix profile Select the Citrix file with a profile extension such as MyApp profile 6 Click Next The Summary panel opens 7 Click Finish to begin the import The virtual package is imported an...

Page 242: ...ociation on the context menu The Delete Virtual Package Association dialog box opens prompting you to confirm the deletion 3 Select the association that you want to delete and click OK The association...

Page 243: ...base Merge modules also contain additional tables that are unique to themselves To install the information delivered by a merge module with an application the module must first be merged into the appl...

Page 244: ...files which are files representing a particular computer system s contents To generate an OS snapshot file use the OS Snapshot Wizard to scan a computer s operating system and record the files INI fi...

Page 245: ...ck Next The Destination Group panel opens Note If you opened the Import Wizard by selecting a Group in the Application Catalog and then selecting Import Package from the context menu the NCP File will...

Page 246: ...0 0 0 TITLE Solitaire TITLE ABSTRACT AdminStudio by InstallShield Corporation ABSTRACT LICENSE HREF http www installshield com AdminStudio license html IMPLEMENTATION OS VALUE WinNT OSVERSION VALUE 4...

Page 247: ...ere you can enter a name for the package and the base directory for the package where all of its installation files are located 5 Enter a Product Name to identify this package 6 Click the Explore butt...

Page 248: ...using the Software Repository The Software Repository gives you a secure transparent storage system for your AdminStudio data especially Windows Installer packages used in the enterprise The AdminStu...

Page 249: ...st have the Software Repository enabled You can choose to enable the Software Repository feature when you are creating a new Application Catalog and you can also enable it in existing Application Cata...

Page 250: ...ion 2 Select a Software Repository Location 3 Enter a Login ID and Password of the Proxy Account that will be used to access this location Enabling the Software Repository in an Existing Application C...

Page 251: ...Repository Using the ConflictSolver Process Assistant Adding a Package to the Software Repository by Overwriting Original Package Software Repository Auto Import Method Importing a Package into the So...

Page 252: ...to the Software Repository option on the Organize Package page In order to select this option you must be connected to an Application Catalog that has the Software Repository enabled Adding a Package...

Page 253: ...reRepository Y SuppressDuplicatePackageImport N Identifying Software Repository Packages in Application Manager In Application Manager packages that are managed within the Software Repository have a d...

Page 254: ...ry package in the Application Manager Product View Using Version Management Features For those packages which are part of the Software Repository you can store multiple versions of a package Instead o...

Page 255: ...con is displayed on the Application Manager Product View to indicate that the package is checked out If the current user is not the user who checked out the package then the path portion of the proper...

Page 256: ...s directory Software Repository Integration into Other AdminStudio Tools The Software Repository feature is integrated into several other AdminStudio tools InstallShield Editor ConflictSolver PackageE...

Page 257: ...er file is displayed and you can edit this entry or click Browse and select a different package In the Software Repository Only the name of the Windows Installer file is displayed not the full path an...

Page 258: ...Windows Installer packages in a specific folder into your Application Catalog at scheduled intervals Replicating Application Catalogs Use Application Catalog Replication s Publication and Subscription...

Page 259: ...base Server and Subscriber Database Server and Subscriber and Subscriber Database Server How It Works The source Application Catalog s data is merged into the currently open Application Catalog This i...

Page 260: ...are satisfied with domain security and have both source and target Application Catalog databases or source directory and target Application Catalog database on an accessible domain Replication could b...

Page 261: ...it a very secure way to replicate data because the subscriber need not have access to the remote database AdminStudio encapsulates functionality from SQL Server to support Snapshot type replication Us...

Page 262: ...ion Catalog 5 Click Next to advance to the Groups panel 6 Select the groups you want to merge You can also select to Replace duplicate application data 7 Click Next The Progress panel opens where you...

Page 263: ...ation Catalog which would disrupt the automatic import process Instead you can perform validation after the package has been imported See Validating After Import Tip When you link to a package in a Re...

Page 264: ...Updating a Linked Package Deleting a Link to a Remote Application Catalog Viewing Remote Package Links on the Application Manager Product View Linking to a Remote Application Catalog Using the Remote...

Page 265: ...ort to occur by selecting the hour minutes seconds or AM PM setting and then clicking the up and down arrows to adjust the setting 13 From the Starting on list click on the arrow to open the Calendar...

Page 266: ...the changed packages option is selected and Whenever you click Start on the Package Auto Import dialog box Preferred Authentication Modes AdminStudio has preferred authentication modes when connectin...

Page 267: ...lication Catalog 4 If you want to specify options that directly affect the way the linked packages will be updated select the Options tab 5 On the Options tab select one or more of the following Refre...

Page 268: ...modified If you have selected this option Application Manager will go and check if any of the linked packages have been modified in the Application Catalog If the linked package has been modified then...

Page 269: ...you would like to delete and click Remove Viewing Remote Package Links on the Application Manager Product View Note To use the Package Auto Import feature you must have AdminStudio Administrator permi...

Page 270: ...t directory at scheduled intervals Follow these procedures to configure a link to a network directory Task To link to a network directory 1 On the Catalog menu select Package Auto Import The Package A...

Page 271: ...when you select this entry on the Package Auto Import dialog box and then click Start 10 From the Run the process list select Daily or Weekly 11 Select the time of day that you want the automatic imp...

Page 272: ...n the directory hierarchy For example if you are monitoring a directory named Marketing and that directory has a subdirectory named Graphics that contains packages when those packages are imported int...

Page 273: ...ete a link to a remote package 1 On the Catalog menu click Package Auto Import The Package Auto Import dialog box appears 2 Select the monitored Network Directory that you would like to delete and cli...

Page 274: ...oration One location can publish software packages to IT teams at other sites keeping all teams current while enabling each to manage their software independently The following topics are included in...

Page 275: ...Replication Simplifies Software Package Management Using Application Catalog Replication simplifies software management by allowing you to selectively distribute subsets of data from a master Applicat...

Page 276: ...t replication method Snapshot replication operates within the SQL Server Job Refresh model which means that the replication refresh process is run automatically Using AdminStudio to perform Snapshot r...

Page 277: ...rties dialog box Managing Publisher and Subscriber Application Catalogs In AdminStudio Application Catalog Replication data is replicated between Publisher and Subscriber databases You manage the Publ...

Page 278: ...ibe to More Than One Publication for more information Configuring the AdminStudio Shared Location for Replication When Publishing data using Application Catalog Replication the Publication Server need...

Page 279: ...Create Publication The Publisher an AdminStudio user who wants to make part of his Application Catalog available for Publication creates a Publication on the local Publisher Database Server The Publi...

Page 280: ...to see if the Subscription on the Publisher Database Server has been updated If it has been updated the Subscription on the Subscriber Database Server will be updated Step 6 Data is Copied to Applicat...

Page 281: ...ubscriptions are preceded by a red X Note You use the Enable Disable button on the Subscription Manager dialog box to set the status of each Subscription to be either Enabled or Disabled When you disa...

Page 282: ...nterprise Manager If they are not accessible copy the scripts to an accessible location and update the sp_addpublication stored procedure with the revised path names 6 Execute the script 7 Return to S...

Page 283: ...lication Manager lists the last time that each of the Publications was updated published to the Publisher Database Server and the next scheduled update time for that Publication From the Publication M...

Page 284: ...n the Name text box enter a name to identify this new Publication This name will be listed on the Publication Manager dialog box Caution The Publication Name cannot be a T SQL reserved word 5 In the D...

Page 285: ...ysadmin privileges in SQL Enterprise Manager to the connected database server can establish the Publisher Subscriber relationship between the databases and are therefore listed on this panel You can r...

Page 286: ...the Publication data from your Application Catalog to the Publisher Database Server making it available for Subscription After its initial Publication the Publication is also automatically re publishe...

Page 287: ...the day or date that you want this Publication to begin being automatically updated on the day or date you selected from the Run the process every list For example if you want the Publication to be au...

Page 288: ...on Properties dialog box appears 2 Click the Access List tab The Access List tab lists users who have the necessary privileges to access the Publication those users who have been assigned sysadmin pri...

Page 289: ...overs the following tasks Managing Subscriptions Creating a New Subscription Enabling Disabling a Subscription Manually Updating a Subscription Deleting a Subscription Managing Subscriptions You use t...

Page 290: ...n from the Subscription Manager When the list on the Subscription Manager is refreshed the Subscription will no longer be listed Creating a New Subscription To create a Subscription use the Subscripti...

Page 291: ...utomatic updates to begin not the first day that the Publication should be updated If it is Monday and you want the Publication to be updated every Friday to have the Publication begin being updated o...

Page 292: ...ting all of your Subscriptions Each Subscription s status Enabled or Disabled is displayed in the Last Run Status column Note The Subscription Manager option under Replication on the AdminStudio Catal...

Page 293: ...elect the Publication that you want to update 2 Click Run The Publication is replicated from the Publisher Database Server replacing the earlier version Note You can only update a subscribed Publicati...

Page 294: ...Studio to configure this database as a Publisher by creating a Publication Lastly you use SQL Server Management Studio to create one or more Subscriptions and Subscriber databases Perform the followin...

Page 295: ...Subscriber Types verify that SQL Server 2005 is the only option selected This document is targeted for SQL 2005 users only 6 On the Articles panel select Tables Stored Procedures and Views and click...

Page 296: ...Publisher Database in a text editor 2 Replace this code identityrangemanagementoption N auto pub_identity_range 10000 identity_range 1000 threshold 80 with this code identityrangemanagementoption N a...

Page 297: ...select the server under Subscriber on the left side and select New database under Subscription Database on the right side as shown below 5 When prompted enter a name for the new database such as AS S...

Page 298: ...8 ADS 0950 UG00 AdminStudio 9 5 User Guide Step 5 Starting the Snapshot Agent To start the Snapshot Agent perform the following steps Task To start the Snapshot Agent 1 Right click on AS Publication a...

Page 299: ...egrity of the Subscriber Database To verify the existence and integrity of the Subscriber database perform the following steps Task To verify the existence and integrity of the Subscriber database 1 R...

Page 300: ...pics are included in this section OS Snapshot Best Practices Configuring OS Snapshot Analysis Options Capturing an OS Snapshot Caution OS Snapshots should only be used for comparison in ConflictSolver...

Page 301: ...S Snapshot often takes a significant amount of time to capture the base OS state Consider that many typical OS installations exceed 500MB and contain tens of thousands of files translating into a leng...

Page 302: ...e OS Snapshot file 4 Optionally click Edit to configure analysis options See Configuring OS Snapshot Analysis Options 5 Click Start to perform the OS Snapshot 6 On completion of the OS Snapshot review...

Page 303: ...ger interface and includes the following topics Menus and Toolbar Product View Icons Merge Modules View Icons Context Menus Output Window Note By default Application Manager displays all conflict dete...

Page 304: ...lication Catalogs to maintain consistency between the copied packages You can also choose to manually refresh the Application Catalog so that it remains consistent with other linked Application Catalo...

Page 305: ...the Registry Report Reports Crystal Reports Conflicts Creates the pre defined Crystal Reports Conflicts Report Reports Crystal Reports Files Creates the pre defined Crystal Reports Files Report Report...

Page 306: ...io Help AdminStudio on the Web Connects to the AdminStudio Web site Help About Application Manager Displays the About dialog box with version information Help Library Launches the online Help Library...

Page 307: ...ng from the original import directory or its last modified date does not match the last modified date stored in the Application Catalog When this icon is selected a message appears in the Product View...

Page 308: ...persisted against the product and identifies the patch that caused the impact Dependencies Click to display the Dependencies associated with the package See Dependencies View for more information Ext...

Page 309: ...s View Icons Name Icon Description Merge Modules Indicates both the All Merge Modules view the root node of the merge modules explorer containing a list of all merge modules in the Application Catalog...

Page 310: ...wo options Package Select this option to launch the Import Wizard to import Windows Installer packages transform files merge modules or patch files msp into the Application Catalog Patches Select this...

Page 311: ...Microsoft application patches into the Application Catalog Reimport the package Reimports the package from its source location if known and present Note Supported for Windows Installer packages only...

Page 312: ...groups and removes it from the Application Catalog All Extended Attributes Removes all extended attributes from the selected package Persisted Conflict Information Removes persisted conflict informati...

Page 313: ...gistry Report Crystal Reports Conflicts Creates the pre defined Crystal Reports Conflicts Report Crystal Reports Files Creates the pre defined Crystal Reports Files Report Crystal Reports Registry Cre...

Page 314: ...Cuts the selected patch from the Application Catalog You can use the paste command to paste it to a new location Copy Copies the selected patch You can use the paste command to paste it to a new locat...

Page 315: ...the appropriate record in the Tables View and that record will be highlighted Table 6 24 Application Manager Permissions Permission Explanation Import Applications Can import packages or merge module...

Page 316: ...View The Application Catalog View is displayed on the right side of Application Manager whenever the Application Catalog node is selected The following information is displayed Table 6 25 Application...

Page 317: ...6 26 Application Manager Product View Field Description Manufacturer The manufacturer of the package Subscribed Database If this package is associated with a subscribed database the name of that datab...

Page 318: ...and then imports the merged msi file into the Application Catalog In this instance the Original File field lists the name and path of the original Windows Installer package that the patches were appl...

Page 319: ...lictSolver and Application Manager Options Dialog Box controls whether product nodes constituent views appear if no data is contained in that view If you select the option products containing views wi...

Page 320: ...or process If you click on the attribute name you can either provide the value in the Group Properties Dialog Box for Text attributes or browse for a file in a Browse dialog for File attributes Note Y...

Page 321: ...nges View Information Column Description Component Name of component that makes an entry in the INI File FileName Name of INI File that the component listed in the Component column makes an entry in D...

Page 322: ...information is displayed Table 6 30 Shortcuts View Information Column Description Component Name of the component that the shortcut listed in the Name column is associated with Name Name of the shortc...

Page 323: ...E rules to use for conflict identification it is important to understand the data available for packages so you can construct the necessary rule Table 6 32 Information Displayed in the History View It...

Page 324: ...Extended Attributes View shown when a Product is selected See Extended Attributes View in the Application Manager Product View section Files View for OS Snapshots When you expand an OS Snapshot in the...

Page 325: ...hanged by the product The following information is displayed for each Registry Entry csFilePath Path FileSize Size of the OS Snapshot file Version Version of the OS Snapshot file Language Language tha...

Page 326: ...package a package containing non MSI based setup files in the Application Manager Product View details about that setup are displayed in the right pane of the user interface The following information...

Page 327: ...mation is included Files A listing of the individual files making up the setup are listed allowing you to view or delete files by making a selection from the context menu To view the contents of a fil...

Page 328: ...Extended Attributes View in the Application Manager Product View section Files View for Marimba NCP Files When you expand a Marimba NCP File in the Application Manager Product View you can click on Fi...

Page 329: ...ies created or changed by the NCP file The following information is displayed for each registry entry Table 6 41 INI File Changes View Information Column Description FileName Name of the file csFullPa...

Page 330: ...eated by the NCP file Tables View for Marimba NCP Files The Tables View for an NCP file is identical to the Tables View shown when a Product is selected See Tables View in the Application Manager Prod...

Page 331: ...age with the Windows Installer package which originated it you have the convenience of being able to easily locate the virtual package s originating Windows Installer package modify the original Windo...

Page 332: ...Menu Options When the root group in the Patches Tab is selected the following items are available on the context menu Refresh Refresh the patch listing to reflect the most recent modifications Import...

Page 333: ...atches Group View displays a list of all of the patches in that group including the following information If you select a patch in this list detailed patch properties are displayed in the area to the...

Page 334: ...new group Rename Rename the selected group Delete Delete the selected group Cut Copy the selected group to the clipboard so that you can remove it from its current location and paste it into another l...

Page 335: ...er location Copy Copy the selected patch to the clipboard so that you can paste a copy of it into another location Paste Insert the patch on the clipboard into the selected location Generate Report Ge...

Page 336: ...and identifiers for each module Double click on a merge module to see information about it in the Merge Module View Merge Module View When you select a merge module in the merge modules explorer deta...

Page 337: ...Dependency View When you expand a merge module in the merge modules explorer you can click on Dependency to display any dependencies in the merge module The following information is displayed for each...

Page 338: ...following dialog boxes Application Catalog Properties Dialog Box Associate with Workflow Manager Application Dialog Box Command Line Parameters Dialog Box Command Line Parameters Dialog Box Table 6 50...

Page 339: ...files that are executed when the setup is run You only import the msi file into the Application Catalog not all of the files necessary for installation With the Software Repository when you import an...

Page 340: ...kages from the list in the dialog box Note This dialog and its corresponding command are only available if you select the Integrate with Workflow Manager option on the Extended Attributes Tab of the C...

Page 341: ...list of recently opened Application Catalogs When you select an Application Catalog and click OK either the Application Catalog opens or you are prompted for login information if you need authenticati...

Page 342: ...nt and then try again For example if you are connecting to http 120 12 1 15 the NetBios equivalent would be http wfmportal Table 6 54 Connect Application Catalog Enterprise Server Tab Options Option D...

Page 343: ...se SQL Server login identification for authentication Login ID and Password If you chose Server Authentication enter the appropriate Login ID and Password Catalog Do one of the following If you are co...

Page 344: ...Application Catalog Replication a database that receives replicated data When this option is not selected or when an existing database is upgraded the Application Catalog is defined as a Publisher da...

Page 345: ...art Select this option if you do not have access to a database server Microsoft SQL Server 2005 Express will be installed on your machine first then you will have the option to create a new Applicatio...

Page 346: ...t match you can use the Partial Match option on the Find dialog box Create a new Application Catalog Select this option to create a new empty Application Catalog on an existing SQL Server database ser...

Page 347: ...ou would like to search or select All Tables When you select a table from this list the Look In Columns list is populated with all of the columns in that table If a group is selected when you opened t...

Page 348: ...in the Properties area of the Group view displayed whenever a group is selected in the main Application Manager Product View Find Button Click to initiate the search The Find dialog box will close an...

Page 349: ...ges in a Remote Application Catalog is initiated when you click the Close button to exit the Package Auto Import dialog box Occurrence Lists how often the Application Catalog or Network Directory is g...

Page 350: ...plication Catalog on the Package Auto Import Dialog Box and clicking Properties Note See also the Package Auto Import Properties Network Directory Dialog Box Groups Tab The Groups tab displays the pac...

Page 351: ...o see if any of the linked packages have been modified If the linked package has been modified Application Manager will inform you that the source package has been modified but that it will not update...

Page 352: ...and down arrows to adjust the setting Starting on Click on the arrow to open the Calendar and then select the first day that you want automatic importing to begin Table 6 62 Package Auto Import Proper...

Page 353: ...able 6 63 Publication Manager Dialog Box Properties Properties Description Name Name of the Publication Description Description of the Publication Status The status of the last attempted update of the...

Page 354: ...Description Enter a description of the purpose or intended subscribers to this Publication This description will be listed on the Publication Manager Schedule In this field you specify how often you...

Page 355: ...log this dialog box opens prompting you to identify the AdminStudio Enterprise Server URL that you would like to connect to Subscription Manager Dialog Box The Subscription Manager lists all Publicati...

Page 356: ...The status of the last attempted update of the Publication Succeeded or Failed If the update is currently being executed Executing appears in this column Last Action Text describing the last action t...

Page 357: ...es Description Run the process every Select how frequently you want this Publication or Subscription to be automatically updated Day Week or Month on This list offers different selections depending up...

Page 358: ...plication Catalog Figure 6 9 Virtual Package Association Dialog Box If you select a virtual package in the Application Manager tree and then select Associate Package from the context menu the Virtual...

Page 359: ...Location Panel Creating Application Catalog Panel Welcome Panel The first panel of the Application Catalog Wizard welcomes you to the Wizard This panel and others in the Wizard have four buttons locat...

Page 360: ...Description Server The list of available SQL Servers on the network You can also manually enter the name of the SQL Server to which you want to connect Authentication Select one of the following opti...

Page 361: ...er database in Application Catalog Replication a database that receives replicated data When this option is not selected or when an existing database is upgraded the Application Catalog is defined as...

Page 362: ...s such as InstallShield Professional or ISMP installations The Import Wizard consists of the following panels Welcome Panel File Selection Panel Associate Virtual to MSI Packages Panel MST Source Info...

Page 363: ...ation Catalog Windows Installer packages msi Merge modules Marimba Native Channel Packager files ncp Microsoft App V applications osd Citrix profiles profile ThinApp applications exe OS snapshots osc...

Page 364: ...lar computer system s contents To generate an OS snapshot file use the OS Snapshot Wizard to scan a computer s operating system and record the files INI files shortcuts and registry entries present Na...

Page 365: ...re other files in that directory that could be associated with the selected file the Additional Dependencies of the Import File list appears enabling you to select any additional files to be managed b...

Page 366: ...kage are selected to be included in the import If you do not want to import a selected mst file clear the selection You can also add additional transform files Task To add transform files 1 Click the...

Page 367: ...ere an Administrative Install of selected Windows Installer package will be performed 6 Click Next to continue MSM Source Information Panel If you are importing a Merge Module by selecting a Merge Mod...

Page 368: ...ard searches the selected package s folder and subfolders for virtual packages created by AdminStudio If a virtual package is found that appears to have been created by AdminStudio then it will be lis...

Page 369: ...r Product Views Target Package Information Panel Software Repository This panel opens if you are attempting to import a package that has been identified as a duplicate to a package that is already in...

Page 370: ...ct custom tables that are not part of a standard Windows Installer package and direct Application Manager to import them Indicate which custom tables you want to import by selecting the check box next...

Page 371: ...lected in the previous panels Depending on the import type and how the Import Wizard was invoked clicking Back returns you to the Destination Group panel MSM Source Information panel OS Snapshot Infor...

Page 372: ...s Remote Application Catalog Monitor Windows Installer packages in a Remote Application Catalog and automatically import re import those packages at scheduled intervals Application Manager can link to...

Page 373: ...ctory that was chosen to be the monitored directory Note If you select this option when packages in subdirectories are imported into your Application Catalog they will be placed in groups that maintai...

Page 374: ...y to the source Application Catalog Merging could be used in an organization where multiple people test packages After the packages have been tested all of the tested applications could be consolidate...

Page 375: ...w Select the Application Catalog that contains the data that you want to merge If the Application Catalog that you select requires additional authentication the Select Application Catalog Dialog Box o...

Page 376: ...se of the OS Snapshot Wizard The Next button advances you to the Project Information panel Project Information Panel The Project Information panel gathers information necessary for taking the OS Snaps...

Page 377: ...hortcuts Registry data Additionally you can restrict directory analysis to specific directories which can significantly improve OS Snapshot Wizard performance Click New to add a directory restriction...

Page 378: ...ata Options Panel Publication Access List Panel Publication Packages Panel Publication Summary Panel Welcome Panel The first panel of the Publication Wizard welcomes you to the Wizard This panel and o...

Page 379: ...listed on the Publication Manager Schedule In this field you specify how often you would like this Publication to be automatically updated When a Publication is updated all of its data is replaced by...

Page 380: ...the Publication Summary panel if you did not select that option Publication Packages Panel On the Publication Packages panel the Groups and Packages in the Application Catalog you are connected to ar...

Page 381: ...me Panel Subscription Details Panel Subscription Selection Panel Subscription Summary Panel Table 6 80 Publication Wizard Publication Summary Panel Options Option Description Generate publication as s...

Page 382: ...Brings up help about the specific Wizard panel Table 6 82 Subscription Details Panel Properties Properties Description Database From the Catalogs list select the Publisher Application Catalog you wan...

Page 383: ...n Catalogs in Controlled SQL Database Environments Click Finish to complete the creation of this Subscription Upgrade Wizard When you attempt to open an AdminStudio 5 0 5 5 6 0 7 0 or 7 5 Application...

Page 384: ...opy of AdminStudio 7 0 or 7 5 available to you contact Technical Support AdminStudio Database Schema Tables The AdminStudio Database Schema stores all data used by the Application Catalog The data is...

Page 385: ...in the original MSM table However there are two additional columns added to the Application Catalog tables a RowID column for use as a Primary Key and a ModuleRowID_ column for use as a Foreign Key i...

Page 386: ...ge table the table that is the primary table containing product information cssp_ These are the tables that contain the stored procedures used to access data from Application Catalog tables The ASData...

Page 387: ...ackage cstblGroups and cstblGroupPackages Any Application Catalog table which is not referenced explicitly in the discussion for the other AdminStudio processes should be considered a general user adm...

Page 388: ...e the necessary server privileges to perform these operations Package Auto Import Process The Package Auto Import process will ultimately generate a series of Import operations and so the user perform...

Page 389: ...n Catalog Following is a complete listing of tables in an Application Catalog System Tables ConflictSolver Tables MSI Tables MSM Tables OS Snapshot Tables Workflow Tables Security Tables Workflow Mana...

Page 390: ...stblExtendedAttributeData N A cstblIgnoreTableList N A cstblPackageHistoryLog N A cstblTransformFile N A Table 6 87 MSI Tables Table Name Corresponding Windows Installer Table csmsiActionText ActionTe...

Page 391: ...s csmsiComponent Component csmsiCondition Condition csmsiControl Control csmsiControlCondition ControlCondition csmsiControlEvent ControlEvent csmsiCreateFolder CreateFolder csmsiCustomAction CustomAc...

Page 392: ...lExecuteSequence csmsiInstallUISequence InstallUISequence csmsiIsolatedComponent IsolatedComponent csmsiLaunchCondition LaunchCondition csmsiListBox ListBox csmsiListView ListView csmsiLockPermissions...

Page 393: ...e ODBCDataSource csmsiODBCDriver ODBCDriver csmsiODBCSourceAttribute ODBCSourceAttribute csmsiODBCTranslator ODBCTranslator csmsiPatch Patch csmsiPatchPackage PatchPackage csmsiProgId ProgId csmsiProp...

Page 394: ...tyle TextStyle csmsiTypeLib TypeLib csmsiUIText UIText csmsiUpgrade Upgrade csmsiVerb Verb csmsisys_Columns _Columns csmsisys_Tables _Tables csmsisys_Validation _Validation Table 6 88 MSM Tables Table...

Page 395: ...ss csmsmComboBox ComboBox csmsmCompLocator CompLocator csmsmComplus Complus csmsmComponent Component csmsmCondition Condition csmsmControl Control csmsmControlCondition ControlCondition csmsmControlEv...

Page 396: ...IniLocator IniLocator csmsmInstallExecuteSequence InstallExecuteSequence csmsmInstallUISequence InstallUISequence csmsmIsolatedComponent IsolatedComponent csmsmLaunchCondition LaunchCondition csmsmLis...

Page 397: ...smModuleSignature ModuleSignature csmsmModuleSubstitution ModuleSubstitution csmsmMoveFile MoveFile csmsmMsiAssembly MsiAssembly csmsmMsiAssemblyName MsiAssemblyName csmsmMsiDigitalCertificate MsiDigi...

Page 398: ...csmsmRemoveIniFile RemoveIniFile csmsmRemoveRegistry RemoveRegistry csmsmReserveCost ReserveCost csmsmSelfReg SelfReg csmsmServiceControl ServiceControl csmsmServiceInstall ServiceInstall csmsmSFPCat...

Page 399: ...dation Table 6 89 OS Snapshot Tables Table Name Corresponding Windows Installer Table csoscFile N A csoscIniFile N A csoscShortcut N A csoscRegistry N A Table 6 90 Workflow Tables Table Name Correspon...

Page 400: ...dio An Application Catalog contains the following Workflow Manager tables Table 6 91 Security Tables Table Name Corresponding Windows Installer Table assysRolePermissions N A assysRoles N A assysRoleT...

Page 401: ...geCore N A AMS_LanguageList N A AMS_LanguageLongString N A AMS_LanguageStrings N A AMS_LanguageSymbols N A AMS_LanguageUsages N A AMS_Person N A AMS_PersonRole N A AMS_Policy N A AMS_Preference N A AM...

Page 402: ...cation Description Table Names Pre Existing Conflict Data cstblConflictConfiguration cstblConflictACE cstblConflictPackages cstblConflictResults cstblConflictTransformList cstblConflictResultsDestPkgs...

Page 403: ...file in XML format Because you can manually create the description file you have the flexibility to include information about each package that may be specific to your organization such as the users...

Page 404: ...pe is Selection this column contains the list of possible selections The value of this column can be up to 512 characters long FileFilter text N This column contains the standard file filter used for...

Page 405: ...can be up to 20 characters long UniqueID int N Numeric identifier of the database version LastUser text Y Not currently used LastUsed datetime Y Not currently used ExtendedAttributesFile text Y The fi...

Page 406: ...e up to 20 characters long SchemaVersion text N Not currently used DeleteMode int N Used internally Table 6 98 cstbl ConflictSolver Supporting Tables Category Table Database Subscription Tables cstblS...

Page 407: ...int Y N The Primary Key used to uniquely identify a record ServerName text N Name of the server where the subscribed database is located This name can be up to 255 characters long DatabaseName text N...

Page 408: ...ble Description RowID int Y N The Primary Key used to uniquely identify a record PkgRowID_ int N Foreign Key identifier into the cstblPackage table to which these conflict persistence results are asso...

Page 409: ...N Number of errors that were resolved since the last run of the Conflict Wizard over this package SaveToMST int N Flag to indicate whether you want to save the conflict resolutions in a transform mst...

Page 410: ...haracters long Table 6 103 cstblConflictPackages Columns Column Type Key Nullable Description RowID int Y N The Primary Key used to uniquely identify a record PkgRowID_ int N Foreign Key identifier in...

Page 411: ...lank Value can be up to 1024 characters long CARDQuery text N For conflicts that have an automatic resolution this column will contain data specific for that resolution For non resolvable ACEs this fi...

Page 412: ...mList Columns Column Type Key Nullable Description RowID int Y N The Primary Key used to uniquely identify a record PkgRowID_ int N Foreign Key identifier into the cstblPackage table to which these co...

Page 413: ...record PackageCode text N The value of the equivalent MSI PackageCode Code can be up to 100 characters long ProductCode text N The value of the equivalent MSI ProductCode Code can be up to 100 charac...

Page 414: ...he package MSI file was last modified Flags int N Used internally DisplayedProductName text N Name of package that is displayed in the Application Manager and ConflictSolver Product View Name can be u...

Page 415: ...ollowing columns Table 6 109 cstblGroups Columns Column Type Key Nullabl e Description RowID int Y N The Primary Key used to uniquely identify a record GroupName text N Name of group Name can be up to...

Page 416: ...to uniquely identify a record TableName text N Name of ignored table Name can be up to 255 characters long Comments text Y Any user comments Comments can be up to 4000 characters long Table 6 112 cst...

Page 417: ...record PkgRowID_ int N Foreign Key identifier into the package associated with this extended attribute data Name_ text N Private Key into the extended attribute schema table Name can be up to 255 cha...

Page 418: ...olumn is 0 Otherwise it contains the PackageRowID MemberGroupCode int N Foreign Key identifier into the cstblGroup table If this is a package the value in this column is 1 Otherwise it contains the Gr...

Page 419: ...ob queue entry QueueName Varchar 32 N Y The name of the job queue entry LastAction Varchar 200 N Y The last status message generated by the job execution Initially empty until the job actually runs Pr...

Page 420: ...tep UserName Varchar 255 N N The user name that created this job step and derived as part of the Enterprise Server login process MetaData Varchar 4096 N N Job step specific XML data Created Datetime N...

Page 421: ...me for the job step type Table 6 119 AsJobQueueStepDetail Table Column Type Key Nullab le Description JobQueueId_ Int Y N Primary key into the AsJobQueue table JobQueueId column Identifies the job que...

Page 422: ...ion record SentTo Varchar 400 N N Self explanatory Subject Varchar 100 N Y Self explanatory Message Varchar 800 N Y Self explanatory StatusId_ Int N N Foreign key into the AsQueueStatus table StatusId...

Page 423: ...ePacks cspchServicePacks Table 6 122 AsSchedule Table Columns Column Type Key Nullabl e Description JobQueueId_ Int Y N Foreign key in the AsJobQueue table JobQueueId column The job for which this sch...

Page 424: ...following miscellaneous tables are included in the AdminStudio Database Schema cstblPackageProperties cstblPackageVersionHistory cstblPatchProperties cstblTransformProperties sysManagedCatalog cssysSo...

Page 425: ...e S mysql sql1 U admin P admin D mycatalog IF c mypackages mymsi msi c mypackages mytrans mst The name of the Application Catalog This parameter is only used for SQL Server Application Catalogs and is...

Page 426: ...equired parameter when using a SQL Server based Application Catalog The only exception to this requirement is if you want to take advantage of AdminStudio s integrated security In this case do not use...

Page 427: ...g individual command line parameters Application Manager can also use a configuration file when specified using the C configuration_file_name parameter This INI file can contain the values for all req...

Page 428: ...SQL LogFile c temp importlog txt MSIFile 3 MSMFile 1 SQL Server ConflictSolverSQL2K UserID Admin Password mypassword Database AdminStudio70 MSIFile 1 File server Data1 msi Transform1 server Data1a ms...

Page 429: ...importlog txt MSIFile 3 MSMFile 1 OtherSetupFile 1 MSIFile 1 File server Data1 MSI Transform1 server Data1a MST Transform2 server Data1b MST Patch1 server Data1p MSP Patch2 server Data2p MSP AdminInst...

Page 430: ...ile is denoted in subsequent INI file sections Note If you are only importing Windows Installer packages you can omit this parameter from your configuration file Table 6 126 Parameter Explanation SQL...

Page 431: ...lue of n Transform1 Transform2 Transform3 etc Patchn Use this parameter to specify the name and location of a patch to apply to the Windows Installer package prior to import Each subsequent patch incr...

Page 432: ...ne to use a configuration file iscmide exe C configuration_file_name Replace configuration_file_name with the name and location of the configuration file to use Importing This section includes topics...

Page 433: ...parameters If you are importing multiple Windows Installer packages and applying transforms or patches to them use a configuration file in which you can specify the names and locations of the packages...

Page 434: ...ile_name with the name and location of the configuration file to use Using the Command Line to Import All Packages in a Directory It is possible from the command line to import all packages in a direc...

Page 435: ...t may be necessary or beneficial to create a log file during package merge module import from the command line You may want to see the results of the import or determine why certain packages were not...

Page 436: ...lver executable ISCMIDE exe Typically it is in the AdminStudio Installation Directory ConflictSolver directory When you have located it click OK and then click Next 3 Type a name for the shortcut and...

Page 437: ...wever this functionality can be invoked from the main AdminStudio interface The following Application Catalog Replication command line options are supported by AdminStudio Table 6 131 Replication Comm...

Page 438: ...Chapter 6 Managing Application Catalog Databases Reference 438 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 439: ...llations This part of the AdminStudio 9 5 User Guide includes the following chapters Repackaging Legacy Installations Using the Repackaging Wizard Creating Customized Virtual Applications Customizing...

Page 440: ...440 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 441: ...ckaging Wizard Section Description About Repackaging Introduces you to repackaging explains various repackaging methods lists Repackaging Best Practices explains how to include the InstallScript Engin...

Page 442: ...ing it into a Windows Installer msi package which you can then customize and distribute according to your organization s needs Repackaging an installation into a Windows Installer package provides the...

Page 443: ...rd to convert the following installations InstallShield Professional 1 x to 5 1 x InstallShield Professional 5 5 to 7 x InstallShield InstallScript MSI InstallShield DevStudio 9 x InstallScript Instal...

Page 444: ...rtScan Wizard Repackager project with feature delineation including registry entries and shortcuts IS InstallScript MSI Repackaging Wizard Installation Monitoring or Single Step Snapshot Repackager pr...

Page 445: ...the necessary files for the setup because the files may already be installed on the system Note For more information see About Repackaging on Clean Systems Launch Repackager Remotely or Install Repack...

Page 446: ...ckaging tools will ignore the Windows Installer specific data in the Registry This will result in an incomplete package Also Repackager is not intended for repackaging operating system installations o...

Page 447: ...ith your setup all the major releases of the InstallScript engine are available in the InstallScript_Engines folder on the AdminStudio installation CD For more information see the Update to the Latest...

Page 448: ...the Snapshot method the Repackaging Wizard takes a reference snapshot of a system as a baseline configuration performs the installation and then takes a second snapshot The difference between the two...

Page 449: ...be captured as follows C Program Files CompanyName ApplicationName ProgramName exe When using the InstallShield Professional Logging Method the executable path name would be captured using a path vari...

Page 450: ...io 9 x InstallScript installation on the Repackaging Wizard s Collect Product Information Panel Repackager will automatically detect the InstallScript installation and will display the InstallShield P...

Page 451: ...n Installation of AdminStudio Creating a Shortcut to Repackager on the Clean Machine Launching Remote Repackager on the Clean Machine Sharing Directories on a Machine with an Installation of AdminStud...

Page 452: ...red location 4 Click Browse The Browse for Folder dialog box opens 5 Select the shared Repackager directory on the production machine that you configured in Sharing Directories on a Machine with an In...

Page 453: ...zard link The Welcome panel of the Repackaging Wizard opens 3 Continue using the Repackaging Wizard to capture a legacy setup following the instructions in Repackaging Legacy Installations Using the R...

Page 454: ...alled on it 2 On the AdminStudio installation DVD locate the standalone Repackager installation in the Tools directory Tools StandaloneRepackager exe 3 Copy StandaloneRepackager exe to the clean machi...

Page 455: ...you can choose to use the InstallShield Professional Logging Method instead of the Snapshot or Installation Monitoring methods Caution It is highly recommended that you repackage applications on a cle...

Page 456: ...the following steps Step 1 Selecting the Repackaging Method Step 2 Excluding Processes Optional Step 3 Collecting Product Information Step 4 Adding Additional Setup Programs Optional Step 5 Set Targe...

Page 457: ...zard AdminStudio 9 5 User Guide ADS 0950 UG00 457 Task To select a repackaging method 1 From the Repackager interface launch the Repackaging Wizard by clicking on the link or by selecting Repackaging...

Page 458: ...many services running on a machine may have nothing to do with the installation being repackaged If you want to modify the default excluded processes list perform the following steps If you do not wan...

Page 459: ...installation you want to repackage and enter any command line arguments to be used when the installation is run Task To enter product information 1 On the Method Selection Panel click Next The Collect...

Page 460: ...o repackage you can specify command line parameters pertaining only to that setup You can also specify the order in which the setups are run should it be necessary If you want to add additional setup...

Page 461: ...d line Argument s fields c Click OK to return to the Additional Setup Programs dialog box 4 If you want to delete a listed setup program perform the following steps a Select the program that you want...

Page 462: ...ation and Capture Settings Panel See Repackaging Using the InstallShield Professional Logging Method 2 Click the Browse button next to the Project path to store files field and select the directory wh...

Page 463: ...inue with Step 7 Beginning the Repackaging Process Task To set capture settings 1 On the Set Target Project Information and Capture Settings Panel click Edit The Analysis Options dialog box opens Note...

Page 464: ...ess 1 To begin the repackaging process click Start on the Set Target Project Information and Capture Settings Panel The Repackaging Panel opens and the Repackaging Wizard captures the initial system s...

Page 465: ...mplete the repackaging process click Process The Repackaging Wizard then analyzes the system and setup data that it collected Following repackaging the Summary Panel is displayed providing confirmatio...

Page 466: ...kaging in a single step You specify at least one setup program to repackage Repackager first takes an initial system snapshot Repackager then runs the setup program s you selected Then Repackager take...

Page 467: ...is Step 3 Install Setup and Make Manual System Changes Step 4 Entering Product Information Step 5 Set Target Project Information Step 6 Set Capture Settings Optional Step 7 Beginning the Repackaging P...

Page 468: ...r and DevStudio 9 x InstallScript installations is not offered as a choice on the Method Selection panel See Repackaging Using the InstallShield Professional Logging Method for more information on usi...

Page 469: ...is step the Repackaging Wizard takes an initial snapshot of your system Task To perform initial analysis 1 On the Snapshot Method panel click Next The Repackaging Panel of the Repackaging Wizard opens...

Page 470: ...ual system changes 1 Launch the installation program of the application you are repackaging 2 Follow the prompts until the installation has completed 3 When the installation is complete make any addit...

Page 471: ...cause you have already installed the application you are repackaging 2 In the Product Information area modify the Product Name Version and Company Name as necessary 3 If you want to associate Web site...

Page 472: ...ard output files and source files You can also enter the name of a new folder in the Project path to store files field and you will be prompted to create it when you exit this panel 3 Continue with St...

Page 473: ...Settings Panel click Edit The Analysis Options dialog box opens Note Options set in this dialog box apply to the current and subsequent repackaging sessions 2 Select the capture types that you want t...

Page 474: ...lected directory is now listed on the Analysis Option dialog box 5 If you want to modify an existing restriction or delete a restriction select the directory and click Edit or Delete 6 Click OK to ret...

Page 475: ...oject Information and Capture Settings Panel The Repackaging Panel opens and the Repackaging Wizard captures the system state changes When the Repackaging Wizard has finished analyzing the system stat...

Page 476: ...ing Single Step Snapshot Repackaging To repackage an installation using the Single Step Snapshot method perform the following steps Step 1 Selecting the Repackaging Method Step 2 Collecting Product In...

Page 477: ...Wizard by clicking on the link or by selecting Repackaging Wizard from the Tools menu The Welcome Panel opens 2 Click Next The Method Selection Panel opens Note The InstallShield Professional Logging...

Page 478: ...e prompted before the selected setup program is launched select the Prompt before running the setup program s option If you do not select this option the setup program will automatically be launched a...

Page 479: ...ogram File field and select the installation program that you are repackaging 3 In the Command line Argument s field enter any command line arguments to be used when the installation is run 4 In the P...

Page 480: ...ding the Repackager project file irp the Repackaging Wizard output files and source files You can also enter the name of a new folder in the Project path to store files field and you will be prompted...

Page 481: ...Settings Panel click Edit The Analysis Options dialog box opens Note Options set in this dialog box apply to the current and subsequent repackaging sessions 2 Select the capture types that you want t...

Page 482: ...lected directory is now listed on the Analysis Option dialog box 5 If you want to modify an existing restriction or delete a restriction select the directory and click Edit or Delete 6 Click OK to ret...

Page 483: ...ens and the Repackaging Wizard captures the initial system status Depending upon whether you chose the Prompt before running the setup program s option on the Snapshot Method Panel either the installa...

Page 484: ...Process The Repackaging Wizard then analyzes the system and setup data that it collected Following repackaging the Summary Panel is displayed providing confirmation that the repackaging was successful...

Page 485: ...setups to obtain additional information that would not be captured by the Installation Monitoring or Snapshot methods Path Variables and the Feature Tree See InstallShield Professional Logging Method...

Page 486: ...ogging Method instead of the method you chose on the Method Selection Panel Caution When you are attempting to repackage a setup using the InstallShield Professional Logging Method you are permitted t...

Page 487: ...the InstallShield Editor or DevStudio 9 x InstallScript installation that you are repackaging 6 In the Command line Argument s field enter any command line arguments to be used when the installation i...

Page 488: ...re files field and select the directory where you want the Repackaging Wizard to place its output including the Repackager project file irp the Repackaging Wizard output files and source files You can...

Page 489: ...ogic and user interface information is lost because those methods only record the installation activities for the specific platform used during repackaging Therefore it is recommended that you use Ins...

Page 490: ...dentified this setup as being an InstallScript MSI setup and prompting you to use InstallScript Scan to convert this setup 8 Select Yes and click Next The InstallScript MSI Conversion Output Panel ope...

Page 491: ...of custom actions or other features that are not supported in application virtualization To repackage a Windows Installer msi package perform the following steps Task To repackage a Windows Installer...

Page 492: ...duct Information Panel opens Note The Installation Monitoring method is recommended but you may also choose the Snapshot method when repackaging a Windows Installer package The Installation Monitoring...

Page 493: ...select All Files All files in the selected directory are listed 6 Click Open and select the Windows Installer package msi that you are repackaging A message appears warning you that MSI setups should...

Page 494: ...roject path to store files field and select the directory where you want the Repackaging Wizard to place its output including the Repackager project file irp the Repackaging Wizard output files and so...

Page 495: ...nstallation is complete you are prompted to make any additional changes to the system such as deleting files and shortcuts that you want to be recorded in this repackaged installation 13 When you are...

Page 496: ...on that is displayed when you press the F1 key or click the Help button while working in a dialog box Reference information is organized as follows Table 7 8 Organization of Repackager Reference Secti...

Page 497: ...an then convert this file to an InstallShield Editor project ism for further editing or convert it directly to a Windows Installer package msi The Repackaging Wizard includes the following panels Welc...

Page 498: ...ackaging Wizard Reference 498 ADS 0950 UG00 AdminStudio 9 5 User Guide Figure 7 1 Repackaging Wizard Welcome Panel Method Selection Panel From the Method Selection panel select the method s you want t...

Page 499: ...allation and the InstallShield Professional Setup panel will not appear System Changes Captured by Repackager Regardless of the repackaging method used Repackager captures system changes made to the f...

Page 500: ...u are using the InstallShield Professional Logging Method to repackage an InstallShield Editor or DevStudio 9 x InstallScript installation the following additional information is also collected Path V...

Page 501: ...for repackaging the installation s Table 7 10 Snapshot Method Panel Options Option Description Single Step Repackaging in a single step requires you specify at least one setup program to repackage The...

Page 502: ...d Product Information Setup Programs Area The Setup Programs area contains information about the setup you are repackaging Repackager uses this information to launch the setup correctly following pre...

Page 503: ...are the same product name version number and company name in the repackaged installation However as you locate each additional setup to repackage you can specify command line parameters pertaining onl...

Page 504: ...S Snapshot or Installation Monitoring significant platform specific or custom installation maintenance and uninstallation logic and user interface information is lost because those methods only record...

Page 505: ...essional Setup Panel If you want to use the InstallShield Professional Logging Method select the Use InstallShield Professional Logging instead of repackaging check box Using the InstallShield Profess...

Page 506: ...the same machine as the Repackager executable most likely on your administrator machine You can also review or edit current capture settings by clicking Edit which displays the Analysis Options dialo...

Page 507: ...achine as the Repackager executable most likely on your administrator machine You can also review or edit current settings by clicking Edit to open the Analysis Options dialog box On the Analysis Opti...

Page 508: ...Depending on settings configured before starting repackaging the analysis may stop following the initial phase and again after setup has been run After the setups have been completed you are prompted...

Page 509: ...packaging Panel 3 Following repackaging the Summary Panel is displayed Summary Panel The final panel displayed by Repackager is the Summary panel Figure 7 12 Repackaging Wizard Summary Panel This pane...

Page 510: ...n Panel of the Repackaging Wizard displays a list of additional setup programs you want to add to the final Windows Installer package Figure 7 13 Repackaging Wizard s Additional Setup Programs Dialog...

Page 511: ...ram and any command line arguments for the setup Excluded Processes Dialog Box During Installation Monitoring Repackager captures all of the activity of each service or process running on the machine...

Page 512: ...rocess and click the Delete button Analysis Options Dialog Box The Analysis Options dialog box accessible by clicking Edit from the Set Target Project Information and Capture Settings Panel or the Ins...

Page 513: ...dline1 exe2 cmdline2 exeN cmdlineN b project file path and name ism Specifies the build release destination folder If project file path and name is not specified Repackager uses the folder where the i...

Page 514: ...ignored Note If user chooses to use the Multiple Step Snapshot repackaging method then the is parameter will be ignored Even if the setup is an InstallScript MSI setup is will still be ignored when us...

Page 515: ...Repackager Before you continue processing in Repackager be patient and ensure all processes and applications have restarted This may take a minute or two After the applications and processes have been...

Page 516: ...aits until these are finished before prompting you to continue repackaging However in some cases the processes or applications launched by the Repackaging Wizard will launch other applications and pro...

Page 517: ...an isolated Windows Installer package and to configure the exclusions used when repackaging a legacy installation Information about the Repackager interface is presented in the following sections Tabl...

Page 518: ...reduces versioning conflicts by modifying an application so it always loads the versions of components such as DLLs with which it was originally developed and tested This section reviews isolation co...

Page 519: ...ce 1 Launch AdminStudio 2 Click the Tools tab 3 From the Tools Gallery click the Repackager icon on the left side The Repackager Start Page opens and you can begin the repackaging process Note You can...

Page 520: ...lors tab of the Options dialog box opens 3 Configure the display colors for Excluded SmartScan and Setup Intent items 4 Click OK Specifying Additional Merge Module Directories If you have custom merge...

Page 521: ...s in the Repackager output window during the Build process Task To set the display of ICE validation warnings during builds 1 From the Repackager interface select Options from the Tools menu The Optio...

Page 522: ...g WinINSTALL Projects Converting Wise Installation Projects Converting InstallShield Professional Log Files Table 8 2 Methods of Creating Repackager Projects Method Installation Source Repackaging Wiz...

Page 523: ...ager Interface Converting a Microsoft SMS Project to a Repackager Project To convert a Microsoft SMS project to a Repackager project perform the following steps Task To convert a Microsoft SMS project...

Page 524: ...e Application Launcher to be able to distribute an application to a workstation registry entries to be added files to be copied changes to be made in the ini files and system text files autoexec bat a...

Page 525: ...ion 4 Browse to locate the ZENworks project you want to convert 5 Select the project and click OK The legacy project is converted to a Repackager project Files ini files shortcuts and registry entries...

Page 526: ...heck box 3 When the repackaging process is complete the Cancel button changes to a Close button Click Close to close this dialog box You will find the converted files in the location specified in the...

Page 527: ...sion to Repackager projects Converting Wise Installation Projects Task To convert a Wise Installation project wse to a Repackager project which can subsequently be built into a Windows Installer packa...

Page 528: ...Interface Working With Repackager Projects After creating a Repackager project by Repackaging Legacy Installations Using the Repackaging Wizard or by Converting Legacy Installations Using the Repacka...

Page 529: ...at you want to convert to an InstallShield Editor project 2 Select Repackaged Output from the View List The Repackaged Output View opens 3 In the Editor Project field enter the name and location of th...

Page 530: ...s and a particular SQL script you could create a project template that has all of those settings Then any time that you wanted to create a new project you could base it off of your custom template Thi...

Page 531: ...e as described in Configuring Advanced Conversion Options 10 Select Repackaged Output on the View List The Repackaged Output View opens 11 Click the Build button The build process begins and its progr...

Page 532: ...ct ism and a Windows Installer package msi 1 In the Repackager interface open the Repackager project that you want to convert to an InstallShield Editor project and build a Windows Installer package 2...

Page 533: ...including the msi file and all other necessary files Create msi file external compressed cab file Select this option if you want to create an msi file and want to compress the rest of the necessary f...

Page 534: ...In order to select one of these virtualization options you must have already selected the Create a Windows Installer package msi after creating the Editor project option 5 A project template contains...

Page 535: ...ging b Product Name The name of the product you are repackaging c Version The product s version number d Product URL The URL for product information This appears in Add Remove Programs in the Control...

Page 536: ...tput window a link to the build log file is provided and the location of the msi file is listed For example Output file C 1516261 WinZip msi About the Context msi File When some Windows Installer pack...

Page 537: ...your Repackager project perform the following steps Task To configure advanced conversion options 1 Select Advanced Settings from the Repackager View List The Advanced Settings View opens 2 Under Pac...

Page 538: ...or a subfolder of CommonFilesFolder are marked as shared files This ensures that these components can coexist with DLLs installed by previous setups Map registry data to the appropriate COM tables Se...

Page 539: ...tion during Repackager project build 1 In the Repackager interface open a Repackager project 2 Select Repackaged Output from the View List The Repackaged Output view opens 3 In the Editor Project fiel...

Page 540: ...ject option must be selected If it is not selected the virtualization options are disabled 5 Select one or more of the virtual application options Create a Microsoft App V application Create a VMware...

Page 541: ...dvanced Conversion Options 9 Select Repackaged Output on the View List The Repackaged Output View opens 10 Click the Build button The build process begins and its progress is reported in the output wi...

Page 542: ...ger interface 2 From the Project menu select Properties The General tab of the Project Properties dialog box opens The following properties are listed Project Location The full path of the directory w...

Page 543: ...ewing properties in the General tab click OK Using the Setup Intent Wizard to Detect File Dependencies in a Repackager Project To detect file dependencies that may not be included in your Repackager p...

Page 544: ...r Setup Capture Report The following information is available to be displayed in this report Captured files Captured shortcuts Captured ini file entries Captured Registry entries The report also indic...

Page 545: ...re specify whether you want to just display summary information 4 Specify whether you want to display excluded items in the report 5 Select the file format for the report You can generate an HTML repo...

Page 546: ...ated Windows Installer package msi in InstallShield Editor From the Repackager Project menu select Edit Windows Installer Package If installed InstallShield Editor opens the package in Direct MSI Edit...

Page 547: ...ons for Windows XP systems the assemblies can be updated following deployment without necessitating application reinstallation Reasons to Isolate Applications You would want to isolate an application...

Page 548: ...applications on a computer Applications that require these assemblies specify their dependence within a manifest Multiple versions of shared assemblies can be used by different applications running s...

Page 549: ...assembly option on the Manifest Options tab of the Isolation Options dialog box the manifest will be added to the same component as the assembly About Digital Certificates Digital certificates identif...

Page 550: ...an create a Certificate Store a storage location which will have numerous certificates which enables all users or computers with adequate permissions to retrieve the certificate as needed Using a Cert...

Page 551: ...Selecting the Assembly Type Specifying the Assembly Naming Conventions Note For more information on assemblies and manifests see About Assemblies and About Manifests Selecting the Assembly Type On the...

Page 552: ...ect the Create new component for each assembly option Assemblies created during application isolation will follow the naming convention as specified Note The modifications you make on the Isolation Op...

Page 553: ...ager isolates applications and the available isolation options see Isolating Windows Installer Packages Configuring Exclusions Repackaging exclusions refer to exclusions made during repackage time usi...

Page 554: ...y files In some cases you may want to avoid capturing specific data types during repackaging For example your organization may never want to capture shortcuts You can disable capture of shortcuts duri...

Page 555: ...age 1 Select Files and Folders from the View List The Files and Folders View opens 2 Expand the directory tree and select the directory containing the files you want to exclude 3 Right click the direc...

Page 556: ...t and Windows Installer package 1 Select Registry Entries from the View List The Registry Entries View opens 2 Expand the Registry tree and select the registry key containing the value you want to exc...

Page 557: ...1 Select Shortcuts from the View List The Shortcuts View opens 2 Expand the Shortcuts tree to display the shortcut you want to exclude 3 Right click the shortcut and then click Exclude Excluding All...

Page 558: ...e 3 Right click the directory and then click Exclude All Specifying the External Configuration File To specify an external configuration file which you want to use as a filter when converting legacy s...

Page 559: ...Exclusions Editor opens 5 Make necessary modifications using the Exclusions Editor 6 When you finish editing the configuration file click OK 7 Click OK to close the Project Properties dialog box When...

Page 560: ...during the capture of OS snapshots However to maximize the usefulness of OS snapshots you should avoid editing the default snapshot exclusion list ISSnapshot ini Exclusions and Repackager Exclusions...

Page 561: ...file 4 Save the file by selecting Save on the File menu 5 If you were creating a custom exclusions file specify a name and location for this exclusions file and click Save Launching Exclusions Editor...

Page 562: ...guring file exclusions for Repackager you are only configuring Repackager to automatically mark the file as excluded this can be changed from within Repackager on a file by file basis However when con...

Page 563: ...formation dialog box enter or browse to the directory Path containing the files you want to exclude 4 Enter an asterisk in the Excluded Files field 5 Click OK to close the File Exclusion Information d...

Page 564: ...en an exclusions file by performing the steps listed in Launching Exclusions Editor 2 Select the appropriate exclusion and click Delete 3 Confirm the exclusion by clicking OK The deleted exclusion is...

Page 565: ...he following steps Task To add a specific ini file section to the exclusion list 1 Launch the Exclusions Editor and open an exclusions file by performing the steps listed in Launching Exclusions Edito...

Page 566: ...xclusions for Repackager you are only configuring Repackager to automatically mark the ini file and or sections as excluded this can be changed from within Repackager on an ini file by ini file basis...

Page 567: ...e Edit Registry Key dialog box opens 6 Provide the Value Name you want to exclude and click OK to close the dialog box The exclusion information is reflected in the list on the Registry tab 7 Save the...

Page 568: ...eps listed in Launching Exclusions Editor 2 Open the Registry tab 3 Select the registry key that you want to delete and click Delete 4 Confirm the deletion by clicking OK The deleted exclusion is remo...

Page 569: ...Exclusion Information dialog box The new exclusions appear on the Files tab 6 Save the exclusions file as described in Launching Exclusions Editor Important It is strongly recommended that you leave...

Page 570: ...ord if required 4 In the Original target folder field enter the directory where the product was installed during the repackaging process In most cases this will be a subdirectory of ProgramFilesFolder...

Page 571: ...ime when customizing a package By using this template all future InstallShield Editor ism project files generated by Repackager will contain the company specific default settings that were specified i...

Page 572: ...ackager Interface Creating an InstallShield Editor Template to Use Within Repackager 572 ADS 0950 UG00 AdminStudio 9 5 User Guide 3 Under Behavior and Logic select the Property Manager node and add th...

Page 573: ...s Using the Repackager Interface Creating an InstallShield Editor Template to Use Within Repackager AdminStudio 9 5 User Guide ADS 0950 UG00 573 4 You can also optionally set Shallow Folder Structure...

Page 574: ...Using the Repackager Interface Creating an InstallShield Editor Template to Use Within Repackager 574 ADS 0950 UG00 AdminStudio 9 5 User Guide 5 After making all required changes save the project as...

Page 575: ...Guide ADS 0950 UG00 575 6 This new template should now be available along with other project types in the InstallShield Editor 7 From within the Repackager interface you can start using this customize...

Page 576: ...s each of the dialog boxes and Wizard panels that you might encounter when using the Repackager interface The help topics in this section are the same detailed documentation that is displayed when you...

Page 577: ...rojects into Repackaging projects Create a package exclusion list Build a Repackager project into an InstallShield Editor project and Windows Installer package The Interface consists of several menus...

Page 578: ...to navigate to different views in the Repackager project The corresponding view is displayed when you select an item in the tree You can also use the Forward Back Navigate Up and Navigate Down buttons...

Page 579: ...Chapter 8 Converting Legacy Installations Using the Repackager Interface Repackager Interface Reference AdminStudio 9 5 User Guide ADS 0950 UG00 579 Figure 8 3 Repackager Start Page...

Page 580: ...staller project wse File Save Ctrl S Saves the current project File Save As Saves the current project using the name and location you specify File 1 2 3 4 Allows you to open the four most recently acc...

Page 581: ...ild F7 Builds the Repackager project into an InstallShield Editor project and a Windows Installer package Build Stop Build Ctrl Break Terminates an in process build Tools Repackaging Wizard Launches t...

Page 582: ...Support Central Accesses the AdminStudio Support Web site Help Web Community Accesses the AdminStudio Web Community Help ReadMe Displays the AdminStudio ReadMe file Help Feedback Accesses the feedbac...

Page 583: ...er Dialog Box This dialog box available by selecting About Repackager from the Help menu displays version information for Repackager Figure 8 4 About Repackager Dialog Box Create Report Dialog Box The...

Page 584: ...using shared assemblies See Digital Signature Tab Note The modifications you make on the Isolation Options dialog box will be recorded in the isolationconfig ini file which is stored in the AdminStud...

Page 585: ...assemblies in the WinSxS folder Default Note Manifests for shared assemblies must be digitally signed This can be done in the Digital Signature Tab Note A 2048 bit key is required to sign a Windows X...

Page 586: ...ld and navigate to the certificate file you are using to sign assemblies A digital certificate identifies you and or your company to end users and assures them the data they are about to receive has n...

Page 587: ...s exclusion views Files ini Files Registry Data and Shortcuts Figure 8 7 Colors Tab of the Options Dialog Box Merge Modules Tab On the Merge Modules tab you can specify additional directories containi...

Page 588: ...ns Dialog Box To display any ICE validation warnings that occur during the Repackager Build process select the Display ICE validation warnings option By default this option is not selected Password Re...

Page 589: ...displays information about the current Repackager project irp Figure 8 10 Project Properties Dialog Box General Tab The following options are displayed Table 8 9 Project Properties Dialog Box Tabs Ta...

Page 590: ...he current Repackager project file Registry Data File The name and location of the file containing captured registry data The path is relative to the current Repackager project file Conversion Options...

Page 591: ...ll import all captured data into the Repackager project Use settings from the shared location Repackager will use the settings contained in isRepackager ini in the AdminStudio Shared directory configu...

Page 592: ...le in Repackager Captured Installation View Files and Folders View Registry Entries View Shortcuts View INI Files View Deleted Files View Deleted Registry Entries View Repackaged Output View Package I...

Page 593: ...f no ini file changes were captured the ini File view is not displayed From the Captured Installation view you can also create a report or scan for setup intent Additionally you must specify the origi...

Page 594: ...Folders View The upper pane displays the number of files captured and how many of these files will be excluded from the Windows Installer package when built The lower left pane provides a tree from wh...

Page 595: ...rectory or Exclude All to exclude all of the files in the selected directory and all of its subdirectories To include a captured file that had previously been excluded select the file you want to incl...

Page 596: ...Exclude to exclude the registry entries in the selected hive or key only or Exclude All to exclude all of the registry entries in the selected hive or key and all of its keys and subkeys To include a...

Page 597: ...attributes for that shortcut These attributes are Note Shortcuts can be excluded from the Windows Installer package you are building on an individual shortcut basis or by directory Table 8 15 Shortcu...

Page 598: ...ude all of the shortcuts in the selected directory and all of its subdirectories To include a shortcut that had previously been excluded select the shortcut you want to include and select Include To i...

Page 599: ...include and select Include To include INI files within a directory that had previously been excluded select the directory containing the INI files you want to include and select either Include to incl...

Page 600: ...Windows Installer package when built The lower left pane provides a tree displaying the registry keys and subkeys captured When you select a key from the tree the lower right pane displays any regist...

Page 601: ...automatically following conversion Figure 8 16 Repackager Repackaged Output View The following properties are available for configuration Table 8 18 Repackaged Output View Options Option Description E...

Page 602: ...nt to compress all files inside a setup exe file including the msi file and all other necessary files Create msi file external compressed cab file Select this option if you want to create an msi file...

Page 603: ...is selected and one of the following values is chosen Create single compressed msi file Create msi file external compressed cab file Create uncompressed msi file Run automated tests against the Window...

Page 604: ...installation project Use a customized template When building an InstallShield Editor project select this option to specify a customized InstallShield Editor Project Template to use For example if you...

Page 605: ...Figure 8 17 Repackager Package Information View You can configure the following options Table 8 19 Package Information View Options Option Description Company Name The name of the company that develop...

Page 606: ...e Table 8 20 Package Conversion Options Option Description Use Editor path variables instead of physical source paths When storing files in the InstallShield Editor project ism the Wizard uses path va...

Page 607: ...09 validation errors Mark components destined for the CommonFiles folder as shared Executable files installed to the CommonFilesFolder or a subfolder of CommonFilesFolder are marked as shared files Th...

Page 608: ...ched to their corresponding features Automatic Launch of the SmartScan Wizard For your convenience if a Repackaging project is opened either by using Open on the File menu or by using the Repackaging...

Page 609: ...ditional files ini files shortcuts or registry data such as for language specific setups or platform specific setups This primarily involves OS dependent and language dependent files that may be inclu...

Page 610: ...installations only AND the SmartScan Wizard has not already been run on this project Original InstallShield Professional Setup Panel On this panel you specify the InstallShield Professional setup exec...

Page 611: ...lShield Professional project If you want to use this feature and component information select the Add feature tree option Original target folder By default this field is populated with information fou...

Page 612: ...proceed to the Scanning Media Panel which first scans the original media then displays the results Scanning Media Panel Following the actual scan of the original setup media the SmartScan Wizard disp...

Page 613: ...n a system that does not already have these files The Setup Intent Wizard allows you to scan a setup to identify files that may not have been captured during repackaging effectively recognizing the in...

Page 614: ...the scan is complete the Results Panel opens listing new files that your setup required Results Panel The final panel in the Setup Intent Wizard allows you to view and select new files detected by the...

Page 615: ...formation about VMware images from Application Folder VMware Virtual Machines vmls Virtual Machines vmls is a text file that contains information about individual VMware images and where the configura...

Page 616: ...Repackager They are only available when you launch the Exclusions Editor by opening the following file AdminStudio Installation Directory Repackager AnalysisOptions exe Note See Launching Exclusions...

Page 617: ...les Tab This Files tab contains a list of paths and files currently excluded from the capture process Specific files file extensions and the entire contents of specified directories can be excluded Fi...

Page 618: ...le exclusions in the OS Snapshot Wizard indicate ini files and sections that will be excluded from the captured OS snapshot Figure 8 27 Exclusions Editor INI Files Tab The INI Files tab contains a lis...

Page 619: ...ard indicate registry keys that will be excluded from the captured OS snapshot The Registry tab contains a list of keys and values to be excluded during registry analysis For keys that have specific v...

Page 620: ...file or files you want to exclude Then click the Browse button next to the Excluded Files field and select the file or files you want to exclude In the Excluded Files field you can specify files to e...

Page 621: ...de the section s to be excluded Sections must be enclosed in square brackets and separated by vertical bars if more than one section in an ini file is to be excluded for example Groups Settings You ca...

Page 622: ...Registry Key dialog box opens Figure 8 32 Edit Registry Key Dialog Box You can modify the Key Name and or Value Name excluded during analysis Click OK to return to the Registry Tab About Exclusions Ed...

Page 623: ...General Section Properties Properties Description AddlMMSearchPath Use to specify additional directories containing custom merge modules to use during repackaging ALLUSERS If this option is set to Y a...

Page 624: ...Y by default BuildRelease Identifies which InstallShield Editor Release configuration to build BuildStaticScannedFiles Any files identified when running the Setup Intent Wizard will be included in th...

Page 625: ...tion directory and can use a Windows Installer property such as ProgramFilesFolder MyProgram ISProSetup If one of the original setups that was repackaged was created by InstallShield Professional 5 5...

Page 626: ...conditions will store a grouping of the operating system For example if the filter is NT4 the condition will be VersionNT This is set to N by default OtherComponentFileExtensions Specify additional ex...

Page 627: ...tor project file ProjectTemplate The name and location of the default InstallShield Editor project template ism used in the conversion process ServiceControlEvents When this option is set to Y the Ser...

Page 628: ...default UseAdvertisedShortcuts Create advertised shortcuts where applicable This option is set to Y by default UseHKCUProxy Set this option to Y to copy all registry entries in HKEY_CURRENT_USER to HK...

Page 629: ...ociated with Repackager Some are output files and some contain default information for Repackager to function These files are described in the tables below Files Used By the Repackaging Wizard The fol...

Page 630: ...ile from the Repackaging Wizard It contains the locations of files ini files and shortcuts detected by Repackager as having been created modified or removed during repackaging Also it contains a link...

Page 631: ...t file from the Repackaging Wizard when the Install Monitoring method is used It contains API call logs for installation monitoring Default ini AdminStudio Installation Directory Repackager Contains t...

Page 632: ...application in the second you may need to exclude more from the Repackager project Table 8 30 Files Used by the Repackager Interface File Location Description irp Saved in the same location as the in...

Page 633: ...eld Editor 2 Open your Windows Installer package in Direct Edit Mode 3 In the Installation Designer expand the Behavior and Logic tree and select the Custom Actions node The Custom Actions View opens...

Page 634: ...ger The WinINSTALL Preinstall and Postinstall scripts are not converted Troubleshooting Guidelines for SMS Conversion Use the following troubleshooting guidelines to identify and fix SMS conversion pr...

Page 635: ...udio is fully installed browse to the following directory AdminStudio INSTALLDIR Editor Support 0409 2 Locate the IsMsiPKg itp and IsMsiPKgLarge itp files in this directory 3 Rename IsMsiPKg itp to Is...

Page 636: ...Chapter 8 Converting Legacy Installations Using the Repackager Interface Repackager Interface Reference 636 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 637: ...ies the options you have when creating a virtual application and suggests which option you should choose depending upon your source files and the degree of customization you want to perform About Micr...

Page 638: ...s Installer Converter to convert a directory of Windows Installer packages into individual virtual packages Testing Windows Installer Packages for Virtualization Compatibility Explains how to use the...

Page 639: ...Packages Testing Windows Installer Packages for Virtualization Compatibility Windows Installer Package or InstallShield Project Convert it to a virtual application with Modified package contents regi...

Page 640: ...cation s installation it is possible that a previously installed version of the same component could be overwritten causing the existing application to break Because of these possible problems extensi...

Page 641: ...separate so that the virtual application has no impact on the other applications In application virtualization a container or isolation environment is created around the application a controlled virt...

Page 642: ...ects files and registry settings are contained within this isolation environment Critical application resources are managed locally by the isolation environment thus minimizing resource dependencies b...

Page 643: ...tions that need to work together into one virtual package Microsoft App V When creating a Microsoft App V application Windows Installer Converter converts the installation data from the original Windo...

Page 644: ...that are colocated in the same directory with a Windows Installer package file are identified and examined to determine if they can be applied to that Windows Installer package Those that are confirme...

Page 645: ...operating system middle ware plug ins and other applications Because App V applications are not installed on the client there is minimal impact on the host operating system or other applications As a...

Page 646: ...ng Windows Installer Packages to Virtual Applications About Microsoft Application Virtualization 646 ADS 0950 UG00 AdminStudio 9 5 User Guide Figure 9 4 Using the Windows Installer Converter to Create...

Page 647: ...ine a computer with only the operating system necessary service packs and the App V Sequencer installed on it A new clean machine would need to be recreated for each application that is sequenced Inst...

Page 648: ...on the same machine where you sequenced it The Windows Installer Converter includes a launch utility that allows you to launch and test the App V application locally immediately after conversion befo...

Page 649: ...9 5 Components of an App V Application The following table describes the components of an App V application Table 9 4 Components of an App V Application File Size Definition SFT Up to 4 GB The larges...

Page 650: ...ication However if you use the Windows Installer Converter to generate an App V application you need to use a text editing application such as Notepad to edit each osd file and enter the published loc...

Page 651: ...ollowing guidelines Ensure that named elements are nested within the SOFTPKG root element Ensure that element names are in all uppercase letters Be aware that attribute values are case sensitive Type...

Page 652: ...ctory settings files folders shortcuts registry settings isolation options and build options See Getting Started With Application Virtualization and the InstallShield Help Library for information on t...

Page 653: ...ckager or InstallShield Editor to build a ThinApp virtual package the resources you generate are called ThinApp applications When package conversion is complete a Conversion completed message appears...

Page 654: ...e than 1 shortcut ProductName exe FeatureName exe Package DAT The ThinApp application consists of two or more executable files and a Package DAT file Launching the application Each of the executables...

Page 655: ...s to manage or maintain and ThinApp can transparently stream large applications from any network attached storage devices without server software Sandboxing prevents modifications ThinApp redirects al...

Page 656: ...About Citrix XenApp and Citrix Profiles Citrix XenApp is an application delivery system for Windows applications When you use Repackager or InstallShield Editor to prepare a Windows Installer package...

Page 657: ...is run it checks for errors or updates and they are delivered automatically Note For more information see Benefits of Deploying Citrix Profiles About Citrix Profiles profile When you use Windows Insta...

Page 658: ...rofile An XML file that defines the profile CAB File alphanumeric_string cab Compressed cabinet file that provides the isolation environment contents for the application Hashes File Hashes txt Hash ke...

Page 659: ...tions from interfering with others running on the same machine Because applications do not interact the need to perform any conflict analysis and regression testing prior to deployment is eliminated T...

Page 660: ...rmission which supports regulatory compliance and security objectives You can provide authorized access to appropriate users such as employees customers and partners while verifying the ongoing securi...

Page 661: ...Evaluation see Testing Windows Installer Packages for Virtualization Compatibility 5 Click Browse and select the Windows Installer package that you want to convert to a virtual package All of the tra...

Page 662: ...ting system and or language requirements Specify whether to digitally sign the virtual package Important If you are using standalone Repackager or if you have not installed InstallShield Editor on thi...

Page 663: ...p application be sure to include all of its component files For information on the files that comprise a ThinApp application see Components of a ThinApp Application 11 Click Finish to close the Window...

Page 664: ...essages are listed in the Error List You can click on the error number to view a help topic that includes information on how to resolve that error if possible For a complete list of error and warning...

Page 665: ...odel This section explains how to use the Windows Installer Converter to convert a directory of Windows Installer packages into individual virtual packages It is recommended that each of these Windows...

Page 666: ...tion of the virtual packages appears in the Output window 7 Review the virtual package files For information on the files that comprise an App V Application see Components of an App V Application When...

Page 667: ...which packages you want to convert Those that are deemed suitable for conversion will be pre selected You can then decide to proceed with conversion of the selected packages or wait until a later dat...

Page 668: ...User Guide 6 Proceed with package conversion as described in Converting a Single Application to a Virtual Package Converting a Suite of Applications into a Virtual Package or Converting a Directory of...

Page 669: ...f the messages and provides links to a help topic for each message 9 To save the HTML report select Save As from the File menu 10 Select those packages that you want to convert and click Convert Conve...

Page 670: ...refore the testing capability of Windows Installer Converter can be significantly increased as you develop and share additional XML based rules The more rules that you have the more tests Windows Inst...

Page 671: ...n on conversion and not during a pre conversion evaluation About Custom Rules A rule takes some action if some condition is met For example if packaging Office 2007 fully isolate registry keys shared...

Page 672: ...owing Fingerprint and Action are specified Table 9 9 Sample Custom Rule for Windows Installer Converter Rules Engine Rule title Adobe Distiller Exclude AdobePDFSettings description Exclude AdobePDFSet...

Page 673: ...com AdminStudio Rules xsd xmlns xsi http www w3 org 2001 XMLSchema instance xsi schemaLocation http adminstudio com AdminStudio Rules xsd AdminStudio Rules xsd AdminStudioRules 2 Add a Rule element a...

Page 674: ...automate my knowledge severity Warning Action Rule AdminStudioRules 6 Build any virtual package and you will see your Warning message Custom Rules Reference This section includes descriptions of the R...

Page 675: ...pose of the Rule Author Person who authored the Rule Provider Identifies the type of virtual package this Rule applies to Any Rule will run for any provider type AppV Rule will only run for App V pack...

Page 676: ...if you define a Registry child element with only the type REG_SZ attribute then that item will be satisfied if there are any registry entries in the package with that type string Similarly if you def...

Page 677: ...ead to the conversion process hive The hive attribute is the C constant name of the registry hive Most likely the hive would be one of the following HKEY_CLASSES_ROOT HKEY_CURRENT_CONFIG HKEY_CURRENT_...

Page 678: ...s not required Note You should not use an id attribute unless you are going to bind to it because it adds overhead to the conversion process name The name attribute is the name of the file with its ex...

Page 679: ...tings on first use severity Fix Exclude Registry hive HKEY_CURRENT_USER key Software Adobe Acrobat Distiller AdobePDFSettings Exclude Action maxVersion The maxVersion attribute identifies the maximum...

Page 680: ...Rules Engine Table 9 19 Action Element Child Elements Element Name Description Message The Message element specifies the message that is displayed in the Build Output window For more information see...

Page 681: ...wing is a sample FullyIsolate element FullyIsolate Registry hive HKEY_LOCAL_MACHINE key System CurrentControlSet Services Tcpip FullyIsolate Table 9 20 Message Element Attributes Attribute Description...

Page 682: ...l match File and Registry items using the same rules as Fingerprint matching This action is subject to the limitations of the virtualization technology for instance you can only set isolation objects...

Page 683: ...Notepad exe For example if you have the File attribute and it finds the file C Windows Notepad exe the Bind command for filename would return Notepad exe The Bind command for folder would return C Wi...

Page 684: ...accurately test your App V applications on your local machine or any other system that has the App V client installed before moving it to the App V server App V Application Launcher Utility Location...

Page 685: ...ation the Launch App V Application dialog box opens where you are prompted to select the shortcut you want to launch from a list of all of the shortcuts Figure 9 11 Launch App V Application Dialog Box...

Page 686: ...ctory Repackager msi2vp exe The syntax for running the Windows Installer Converter on the command line is Microsoft App V application To build a Microsoft App V application enter msi2vp exe s i path t...

Page 687: ...ller Converter is only available when purchased on the AdminStudio desktop licensing model m app1 msi app2 msi app3 msi Virtual Suite option Use the m parameter followed by the path to the packages th...

Page 688: ...inStudio Shared folder called isrepackager context ini It is identical in syntax to the familiar isrepackager ini file which is used for exclusion settings Data that matches the settings in the contex...

Page 689: ...a virtual application s files folders shortcuts registry settings isolation options and build options See Getting Started With Application Virtualization and the InstallShield Help Library for informa...

Page 690: ...App V Assistant ThinApp Assistant or Citrix Assistant Using the InstallShield Editor Assistants you can configure a virtual application s files folders shortcuts registry settings isolation options a...

Page 691: ...n creating and deploying virtual applications click the Learn more links on this panel Important To create a ThinApp application you must have ThinApp installed on the current machine If you do not th...

Page 692: ...0 AdminStudio 9 5 User Guide Figure 9 15 Windows Installer Converter Conversion Mode Panel This panel includes the following options Table 9 27 Windows Installer Converter Conversion Mode Panel Option...

Page 693: ...al suite of packages using ThinApp Windows Installer Converter creates a program shortcut for every application in the suite and all shortcuts are presented to end users Citrix When creating a virtual...

Page 694: ...package be located in the same folder as the Windows Installer msi package so that they can be accessed when the virtual package is built Only those transform files that are in this folder will be lis...

Page 695: ...17 Windows Installer Converter Select a Directory Panel After you select the directory the number of packages that Windows Installer Converter finds in that directory are listed Select a Suite of Pack...

Page 696: ...Converter creates a program shortcut for every application in the suite and all shortcuts are presented to end users Citrix When creating a virtual suite of packages using Citrix XenApp Windows Insta...

Page 697: ...atibility before proceeding with conversion When testing is complete the results for each package are displayed Figure 9 19 Windows Installer Converter Test Package s Panel The number of errors and wa...

Page 698: ...e menu After reviewing the test results you can decide which packages you want to convert Those that are deemed suitable for conversion will be pre selected You can then decide to proceed with convers...

Page 699: ...ield Editor button This wizard will close and the package will open in InstallShield Editor in either Direct Edit Mode or in Direct MST Mode if any transforms have been selected You would then click o...

Page 700: ...Installer Converter ignores services and user defined custom actions For more information see Application Features Requiring Pre or Post Conversion Actions Table 9 29 Error List Tab of Package Conver...

Page 701: ...s for The error messages for Windows Installer Converter App V Assistant VMware ThinApp Assistant and Citrix Assistant Error 9000 Unknown Exception The following table documents this message Error 900...

Page 702: ...e that the package is accessible to the user If the error persists and the package is on a network share copy the package locally to avoid any network connection issues and try again If this does not...

Page 703: ...n Type Error Message Process cancelled by user Cause The user clicked the Cancel button to stop the build Resolution Restart the build process Table 9 35 Error 9005 Error Creating Temporary Folder Cat...

Page 704: ...e a return error code from Windows Installer this error could have been caused by the package not being authored properly In the Windows Installer package check to see if the AdminExecuteSequence tabl...

Page 705: ...is unknown ProviderName Cause This is an unexpected internal error Resolution Invalid data may have been modified via the Direct Editor causing this error Delete the Release you are building and then...

Page 706: ...ame Cause This is an unexpected error that occurred when the specified Windows Installer table was being processed Resolution Perform preliminary investigational steps and then contact AdminStudio Tec...

Page 707: ...Execute Failed Category Description Type Error Message ShellExecute failed CommandLine Cause You encounter this error when the specified command line failed to launch a process Resolution Check to see...

Page 708: ...entry as follows to identify the full path of the missing driver Name DriverName Description Value Path to Driver Manually Installing the Driver Install the missing driver on your machine and then reb...

Page 709: ...rrently supported Resolution Repackage the application and then rebuild the Citrix profile Table 9 48 Warning 9018 Custom Actions Ignored Category Description Type Warning Message Custom action Custom...

Page 710: ...The Repackaging Wizard monitors system changes as an application is installed and then that data is converted into a Repackager project 2 Build the Repackager project to generate a revised Windows In...

Page 711: ...able 9 51 Error 9021 Unable to Extract COM Data Category Description Type Error Message Unable to extract COM data for FileName Cause This Windows Installer package has an entry in the TypeLib or Self...

Page 712: ...The Complus table contains information needed to install COM applications While Citrix XenApp supports communicating with COM applications it does not support installing COM services Therefore this ap...

Page 713: ...an operating system other than Windows XP launches this Citrix profile the application may not function properly To resolve this issue perform one of the following tasks Option 1 Set Requirements on t...

Page 714: ...cription Type Error Message The conversion process does not support data in the MSI table MoveFile Cause You encounter this error when the Windows Installer package that you are converting includes a...

Page 715: ...ype of driver For example when installing a printer you can install the printer software within the isolation environment but not the printer drivers Therefore to resolve this issue you need to instal...

Page 716: ...an up step that does not impact the function of the application you do not need to address this issue However if the existence of the files listed in the RemoveFile table prevents the application from...

Page 717: ...nt is just a clean up step that does not impact the function of the application you do not need to address this issue However if the existence of the registry keys listed in the RemoveRegistry table p...

Page 718: ...uring the conversion process the ISComPlusApplication table is not read Resolution The ISComPlusApplication table contains information about COM applications While Citrix XenApp supports communicating...

Page 719: ...ipt to update a database An application running as a Citrix profile cannot update a database To resolve this issue you need to update the database prior to using the converted Citrix profile using one...

Page 720: ...unter this error when the Windows Installer package that you are converting includes a ISXmlFile table During the conversion process the ISXmlFile table is not read Resolution The ISXmlFile table modi...

Page 721: ...tion of Package Object Failed Category Description Type Error Message Create operation on Citrix package object failed ObjectName Cause Unexpected internal error Resolution First check to see if the p...

Page 722: ...e Citrix Finalization Failed Cause Unexpected internal error Resolution First check to see if the product was installed properly Then perform preliminary investigational steps and contact AdminStudio...

Page 723: ...ror Initializing Citrix Package Category Description Type Error Message Unexpected error initializing Citrix package Cause Unexpected internal error Resolution First check to see if the product was in...

Page 724: ...ermining source file path for FileName Cause Unexpected internal error Resolution First check to see if the product was installed properly Then perform preliminary investigational steps and contact Ad...

Page 725: ...Error 9113 Error Writing Citrix INI File Entries Category Description Type Error Message Unexpected error writing Citrix INI file entries Cause Unexpected internal error Resolution Perform preliminar...

Page 726: ...as occurred while saving the Citrix profile Resolution Perform preliminary investigational steps and then contact AdminStudio Technical Support Table 9 83 Error 9116 Error Creating Empty Citrix Profil...

Page 727: ...Profile Category Description Type Error Message Unexpected error initializing Citrix profile Cause The initial values on the new profile could not be set Resolution Check the package name description...

Page 728: ...cal Support Table 9 88 Error 9121 Failed to Copy File into Citrix Profile Category Description Type Error Message Failed to copy file into Citrix profile Error Name File Name Cause Specified file coul...

Page 729: ...0 Error 9124 No Shortcuts Created for this Profile Category Description Type Error Message No shortcuts were created for this profile Cause A Citrix profile must include at least one valid shortcut Re...

Page 730: ...supplied certificate Cause The certificate that is being used in invalid Resolution Obtain a valid certificate and rebuild the profile Table 9 93 Error 9127 Could Not Create Script Execution Category...

Page 731: ...ists in the profile but with different command line parameters A new unique shortcut NewShortcutName 1 will be created in the profile Cause There are two shortcuts defined in this profile that have th...

Page 732: ...be resolved at build time This can result in errors if your application requires a specific value Resolution Repackage this application and rebuild the profile or use a constant value in the Windows...

Page 733: ...Modify the shortcut to use a different icon Table 9 100 Warning 9134 Failure to Extract Icon from Executable Category Description Type Warning Message Failed to extract icon from executable filename...

Page 734: ...o decompress it One limitation of an administrative installation is that it does not decompress a file if the feature it is contained in has a default install level of 0 If there are any files in any...

Page 735: ...ion The DuplicateFile table contains a list of files that need to be duplicated during installation either to a different directory than the original file or to the same directory but with a different...

Page 736: ...e Category Description Type Warning Message The extension for the target for shortcut ShortcutName is not exe Excluding shortcut Cause Shortcuts that do not have a filename extension of exe are exclud...

Page 737: ...n Type Error Message ThinApp ToolName was not found Cause One of the ThinApp tools required to build a ThinApp application was not found Resolution Reinstall ThinApp Table 9 109 Error 9204 Duplicate S...

Page 738: ...ShortcutName shortcut already exists but with a different target A new unique shortcut will be created Cause Two shortcuts differed in the target pointed to only Resolution No action is required Table...

Page 739: ...ed while running the vftool exe step of the ThinApp build process Resolution The cause of this error may be discernible by the progress messages that were displayed just before this error occurred Als...

Page 740: ...me Resolution Contact AdminStudio Technical Support Table 9 116 Error 9301 Unhandled Exception During AdviseRegistry Operation Category Description Type Error Message An unhandled exception occurred d...

Page 741: ...Alter File Action Category Description Type Error Message An unhandled exception occurred during the alter file action with the description FileName Resolution Contact AdminStudio Technical Support T...

Page 742: ...is message Table 9 121 Error 9306 Unhandled Exception During Execution of Rules Engine Category Description Type Error Message An unhandled exception occurred during the execution of the rules engine...

Page 743: ...ocuments this message Table 9 124 Error 9403 Error Writing App V File Entries Category Description Type Error Message Unexpected error writing App V file entries Resolution Contact AdminStudio Technic...

Page 744: ...documents this message Table 9 127 Error 9406 Error Writing App V INI File Entries Category Description Type Error Message Unexpected error writing App V INI file entries Resolution Contact AdminStudi...

Page 745: ...ted error saving App V data Resolution Contact AdminStudio Technical Support Table 9 131 Error 9410 Error Determining Source File Path Category Description Type Error Message Unexpected error determin...

Page 746: ...roperly Resolution Contact AdminStudio Technical Support Table 9 134 Error 4313 App V OSD Save Category Description Type Error Message The Microsoft App V OSD file could not be saved The OSD file gene...

Page 747: ...ror Message Dependency application was not found ApplicationName Cause A specified App V dependency application file was not found Resolution Check the path of the specified App V dependency applicati...

Page 748: ...ns an invalid value for the HREF field of the CODEBASE tag HREF_Field_Value Cause The CODEBASE tag of the dependency application s OSD file may have an empty or non existent HREF attribute Resolution...

Page 749: ...e Resolution Contact AdminStudio Technical Support Table 9 141 Warning 9500 Shortcut Missing Category Description Type Warning Message The target for shortcut FileName does not exist Excluding shortcu...

Page 750: ...nversion Cause An MSI file that is part of a suite conversion was not found Resolution Make sure the input file for the suite conversion process exists Table 9 144 Warning 10002 Suite File is Duplicat...

Page 751: ...reference is broken in the installation Resolution Use InstallShield to locate the file in the installation and either fix the link or delete it Table 9 146 Warning 10004 INI File Missing Category Des...

Page 752: ...be virtualized Cause Conversion will fail when the application being virtualized is VMware Action This error message is displayed VMware cannot be virtualized Table 9 149 Warning 11003 Control Panel A...

Page 753: ...s when running from a virtual package Use QuickTime 7 4 5 instead Cause QuickTime 7 4 1 cannot be virtualized correctly Resolution Obtain QuickTime 7 4 5 and repeat the conversion process Table 9 152...

Page 754: ...caused by a configuration on a particular machine or operating system attempt to build this Citrix profile on another machine or operating system Check individual files To determine if this is error l...

Page 755: ...t to launch the converted package on Citrix XenApp If you receive any application errors you need to repackage this application by performing the following steps To successfully convert a package with...

Page 756: ...dio 9 5 User Guide COM While Citrix XenApp supports communicating with COM applications it does not support installing COM services Therefore an application that contains COM services cannot be deploy...

Page 757: ...soft App V VMware ThinApp and Citrix XenApp virtual application formats Information about creating virtual applications is organized into the following sections About Virtualization About the AdminStu...

Page 758: ...has dependencies on components that are shared by multiple applications Applications access these shared system resources such as the registry or Windows system files When an installation author reco...

Page 759: ...ity and access to local services as a locally installed application would have The following diagram provides an example of how application virtualization would solve the conflicts shown in the previo...

Page 760: ...following topics About the Virtualization Assistant Tabs Using the More Options Other Places and Help Links Sections in a Virtualization Assistant Navigating in a Virtualization Assistant Opening the...

Page 761: ...neously Any changes that you make in one are reflected instantly in the other For example if you remove a file in one of the virtualization Assistants that file is no longer available in your project...

Page 762: ...ick the Next or Back arrow buttons to move forward or backward Press CTRL TAB to move to the next page and CTRL SHIFT TAB to move to the previous page To move back to the Home page and view the overvi...

Page 763: ...V Applications Edition The Microsoft App V Assistant is included in the Virtualization Pack Microsoft Application Virtualization App V enables applications to run as network services removing the need...

Page 764: ...tant Page Description Microsoft App V Assistant Home Page Displays a diagram that illustrates the process of creating an App V application Package Information Page Enter the package name enter a comme...

Page 765: ...installed they can communicate with the local operating system middleware plug ins and other applications Because App V applications are not installed on the client there is minimal impact on the hos...

Page 766: ...UG00 AdminStudio 9 5 User Guide Benefits of Using the Microsoft App V Assistant Instead of using the App V Sequencer to create App V applications you can use the InstallShield Microsoft App V Assista...

Page 767: ...y the operating system necessary service packs and the App V Sequencer installed on it A new clean machine would need to be re created for each application that is sequenced Installation directory mus...

Page 768: ...en running a virtual application in its virtual environment you may at some point want to examine its contents to evaluate or debug it However the standard diagnostic tools that you use to examine ins...

Page 769: ...n an App V application All of the application s assets including files registry entries fonts COM and virtual services reside in this file The maximum size of this file is 4 GB OSD File An XML based f...

Page 770: ...an App V package from an ism file InstallShield creates the App VPackage folder in the following location InstallShield Project Folder project name product configuration release name DiskImages Disk1...

Page 771: ...any operating system requirements and identify the deployment server Files Folders Shortcuts Registry Settings Specify the files folders application shortcuts and registry settings that will be inclu...

Page 772: ...me enter a comment specify any operating system requirements and identify the deployment server Managing Files in an App V Application Files Page View existing files and folders add and delete files S...

Page 773: ...from that temporary package Creating a new transform You can create a new transform in InstallShield and then build an App V application from that transform file When you create a new transform file i...

Page 774: ...dows Services Are Integrated into an App V Application When you use the App V Assistant to convert a Windows Installer package to an App V application references to Windows services that are encounter...

Page 775: ...mount point See Microsoft App V Sequencer App V Assistant Items are shown in relation to the Windows Installer installation directory Also since the location of some directories is defined during ins...

Page 776: ...these items if they were installed For example on the Files page of the App V Assistant installation variables such as ProgramFilesFolder or CommonFilesFolder identify the installed location of their...

Page 777: ...pp 006 My Application 6 0 MyApp myapp exe Also all other references to this file such as those in the Registry INI files and in Window Services are rewired to point to the actual file location in the...

Page 778: ...d specify whether to include diagnostic tools with the virtual package This page also lets you specify upgrade information for your App V package if appropriate Table 10 5 Steps to Take to Create an A...

Page 779: ...an App V application is configured on a client machine it is mounted on the computer s Q drive in the folder you specify in this field Default value By default the Root Folder Name is based on the Pro...

Page 780: ...Yes select the operating systems that this application supports and clear those that this application does not support Specifying Upgrade Package Information InstallShield enables you to specify whet...

Page 781: ...HTTP Specifies that Hypertext Transport Protocol controls the exchange of a package HTTPS Specifies that Secure Hypertext Transport Protocol controls the exchange of a package Host Specify the virtua...

Page 782: ...ation cannot load a DLL you could use these diagnostic tools to troubleshoot the problem Caution If you choose to include these diagnostic tools the versions of regedit exe and cmd exe that are part o...

Page 783: ...p V application so that you can browse the virtual file system at runtime from within the virtual environment select the File System Diagnostics option If the File System Diagnostics option is selecte...

Page 784: ...dding Deleting and Moving Files and Folders in an App V Application The directories in the destination tree on the Files page of the Microsoft App V Assistant represent how your application will look...

Page 785: ...s The folder with the check mark is INSTALLDIR which represents the main product installation directory 2 Browse through the folder tree to find the folder that you would like to add files to 3 Select...

Page 786: ...lication perform the following steps Task To add an existing folder to an App V application 1 In the Microsoft App V Assistant open the Files page The files and folders are listed in the App V applica...

Page 787: ...folder Yes If you wish to use the default isolation options for all the files and folders under this folder then select the dynamic file link option by clicking Yes The Dynamic File Link Settings dia...

Page 788: ...te from the context menu You are prompted to confirm the deletion 3 Click Yes The selected file or folder is deleted Caution If you choose to delete a folder you are also deleting all of the files and...

Page 789: ...s that are already displayed are preceded by a check mark and those that are not displayed do not have a check mark 2 To add a folder to the tree listing select a folder that is not currently listed i...

Page 790: ...ry is specified on the InstallShield App V Assistant s Primary Application Directory dialog box as described in Explicitly Setting the Primary Application Directory that directory will be used 2 Value...

Page 791: ...primary application directory 1 In the Microsoft App V Assistant open the Files page 2 In the More Options list click Primary Application Directory The Primary Application Directory dialog box opens...

Page 792: ...lation Options When using the Microsoft App V Assistant you can set options that uses isolation environments use to control application compatibility and accessibility The isolation option that is ass...

Page 793: ...the application is upgraded and streamed from the App V server to the client select this check box If Override check box is not selected then the App V client determines whether to overwrite the file...

Page 794: ...Example of Inheritance of Isolation Options from Folders to Files Option Description File Type When an App V application performs a WRITE operation to a resource a file or folder the resource s File T...

Page 795: ...layed Figure 10 10 List of Shortcuts for an Application Caution You must define at least one shortcut to enable users to launch the application from the isolation environment On the Applications page...

Page 796: ...ssistant creates App V applications for all of the executable shortcuts that exist in your project or Windows Installer package If you build an App V application that does not contain any shortcuts us...

Page 797: ...pp V Assistant creates App V applications for all of the executable shortcuts that exist in your project or Windows Installer package These shortcuts are listed in a checklist on the Applications page...

Page 798: ...page All of the shortcuts that exist in the project are listed Those that are currently included are selected Those that are currently excluded are not selected 2 To exclude a shortcut select the sho...

Page 799: ...he following steps Task To rename an App V application 1 Open the Applications page All of the shortcuts that exist in the project are listed 2 Select the shortcut that you want to rename and click Re...

Page 800: ...e A value name and value pair is a two part data structure under a key The value name identifies a value for storage under a key and the value is the actual data associated with a value name When a va...

Page 801: ...always inherited The isolation environment will apply the most specific reference to that resource For example suppose you have an isolation option for the Microsoft registry key and one for Microsoft...

Page 802: ...The primary App V application and the dependency App V applications in the dynamic suite will run and interact with one another as if they were all installed locally on a computer You would only need...

Page 803: ...ory If the primary App V application will not run unless it can locate this dependency App V application leave the Mandatory option selected If a dependency App V application that is configured as man...

Page 804: ...V application for that release However the releases that are selected on the Build Options page have no bearing upon which release is built when you click the Build button on the toolbar When you ini...

Page 805: ...age option Including Additional Windows Installer Packages in an App V Application Sometimes a primary Windows Installer package uses other Windows Installer packages indirectly such as driver files c...

Page 806: ...The App V client must be installed on the local machine before you can install an App V application The installation will detect and warn if the App V client is not available and the installation will...

Page 807: ...pplication use Note When application files are streamed to a client either at launch or during application use they are saved in the App V cache and do not need to be streamed again during subsequent...

Page 808: ...V application For more information see Creating and Building Releases 3 Open the Build Options page of the Microsoft App V Assistant 4 In the Releases tree select the same release that is selected on...

Page 809: ...the Windows Installer package or transform file by selecting Save on the File menu 4 On the Build Options page of the Microsoft App V Assistant select the Build App V application option The Build Virt...

Page 810: ...App V Application Launcher You can use the InstallShield App V Application Launcher to locally test a newly built App V application before moving it to a deployment server To open the App V Applicati...

Page 811: ...tory of each App V application Rather than looking for the sft file in the location that you specified on the Package Information page the App V Application Launcher looks for the sft file that is loc...

Page 812: ...try Page Dynamic Suite Composition Page Build Options Page Microsoft App V Assistant Home Page The Microsoft App V Assistant Home page displays a diagram that illustrates the process of creating an Ap...

Page 813: ...he Package Information page you specify the package name and enter a comment to document this virtual package From this page you can also choose to include diagnostic tools with the virtual package Fi...

Page 814: ...omputer s Q drive in the folder you specify in this setting The default value for the Root Folder Name setting is based on the ProductName and ProductVersion properties of the App V application s asso...

Page 815: ...ge have any specific operating system requirements option to Yes this list becomes enabled To specify operating system requirements select the operating systems that this application supports and clea...

Page 816: ...cation server or the load balancer in front of a group of virtual application servers that will stream the software package to an Application Virtualization Desktop Client You must complete this item...

Page 817: ...Specify the relative path on the virtual application server where the software package is stored and from which it will be streamed Note This information is required to create a package if the sft fi...

Page 818: ...G00 AdminStudio 9 5 User Guide Files Page On the Files page of the Microsoft App V Assistant you can perform the following tasks View Files and Folders Add Files and Folders Delete Files and Folders S...

Page 819: ...u are prompted to choose whether you want to create a dynamic file link to the source folder Figure 10 17 Dynamic File Link Option Dialog Box Indicate whether you want to create a dynamic file link by...

Page 820: ...specifies how the isolation environment will provide access to system resources requested by the application You set isolation options on the Isolation Options dialog box which is opened by selecting...

Page 821: ...shortcuts are listed in a checklist on the Applications page Figure 10 18 App V Assistant Applications Page Shortcut Requirements For each App V application you are required to define at least one sho...

Page 822: ...t would be included in the Windows Installer package that is built from this InstallShield project See Excluding an App V Application Deleting a Shortcut When you delete a shortcut it is removed from...

Page 823: ...nt and those defaults are adequate for most environments However you can override the default settings for selected registry keys to exert control over application interactions with client operating s...

Page 824: ...e Composition DSC is a Microsoft Application Virtualization feature that enables applications to be virtualized separately from the plug ins and middleware applications that they rely on while still e...

Page 825: ...n Mandatory Indicates whether to selected dependency App V application is required in order for the primary App V application to run If the dependency App V application is mandatory If the primary App...

Page 826: ...mary App V application the published location of the dependency App V application It is not necessary to select more than one osd file All of them contain the same reference to the location of the dep...

Page 827: ...ditions are true The Build Options page includes a releases tree and you select the release that you want to build To build the App V application you click the Build button on the toolbar Windows Inst...

Page 828: ...ve Down buttons Table 10 14 App V Application Build Options Option Description Build App V application Direct Edit Direct MST Modes Only When you directly edit a Windows Installer package it is not ne...

Page 829: ...recently selected on the Installation Designer Releases view The output of that build would depend upon what releases were selected on the Build Options page Active release selected A Windows Install...

Page 830: ...tion is disabled However you do need to run the build process to build an App V application for this Windows Installer package To enable the Build button to build just the App V application select the...

Page 831: ...generated when this InstallShield project or Windows Installer package was built click Open App V application folder in the More Options list Dialog Boxes The Microsoft App V Assistant includes the fo...

Page 832: ...ion is launched for the first time Note The App V client must be installed on the local machine before you can install an App V application The installation will detect and warn if the App V client is...

Page 833: ...ostic tools to troubleshoot the problem Caution If you choose to include these diagnostic tools the versions of regedit exe and cmd exe that are part of the operating system on the build machine are a...

Page 834: ...on about the upgrade File System Diagnostics Select this option if you want to include the Windows Command Prompt application with your App V application so that you can browse the virtual file system...

Page 835: ...p V package name select this check box Table 10 18 File Isolation Options Dialog Box Option Description File Type When an App V application performs a WRITE operation to a resource a file or folder th...

Page 836: ...ource a file or folder the resource s File Type setting determines whether changes to that resource are saved for all users of the App V application on that machine or only for the logged in user Sele...

Page 837: ...the App V Application Launcher select Test launch App V application s in the More Options list on the Build Options page Package Optimizations Dialog Box You can use the App V Assistant Package Optim...

Page 838: ...App V Assistant will perform a static analysis of the shortcuts in the application and decide which files should be in feature block 1 and which should be in feature block 2 This option provides a rel...

Page 839: ...ication on the Primary Application Directory dialog box which is opened by clicking Primary Application Directory in the More Options list on the Files page The Primary Application Directory dialog bo...

Page 840: ...e primary application directory Note This step is not used when converting Windows Installer packages that have been repackaged using AdminStudio Repackager Note All Windows Installer packages created...

Page 841: ...ser interface or the command line both the Windows Installer package and the App V application are built When you use the standard InstallShield command line build you do not need to add any additiona...

Page 842: ...tion Features Requiring Pre or Post Conversion Actions Creating ThinApp Applications Edition The ThinApp Assistant is included in the Virtualization Pack Important ThinApp support requires a separate...

Page 843: ...ThinApp applications can be deployed on a machine without modifying the local operating system or file system They run in a sandbox or virtual environment which protects the local operating system fr...

Page 844: ...ding USB Flash CD ROM and off line laptops No infrastructure changes needed ThinApp applications can be deployed using any existing software deployment systems including Active Directory and SMS ThinA...

Page 845: ...Files Folders Shortcuts Registry Settings Specify the files folders shortcuts and registry settings that will be included in the ThinApp application Isolation Options Override the default isolation op...

Page 846: ...ol access to the ThinApp application via Active Directory and specify whether to include diagnostic tools with the ThinApp application Managing Files in an App V Application Files Folders Page View ex...

Page 847: ...or Direct MST mode To enable the Build function for a ThinApp application select the Build ThinApp application option Building an App V Application Build on the Toolbar OR Build Virtual Package Butto...

Page 848: ...ation consists of two or more executable files and a Package DAT file Launching the application Each of the executables is used to launch the ThinApp application or a specific feature of the ThinApp a...

Page 849: ...ly applied to the base Windows Installer msi package to create a temporary package and then the ThinApp application is generated from that temporary package Creating a new transform You can create a n...

Page 850: ...ws Vista and Terminal Server What is a Sandbox Cache When you run a ThinApp application additional files or registry keys may be produced Depending upon the isolation options some of this run time dat...

Page 851: ...is created when the ThinApp application is built Note For information on sandboxes and sandbox caches see About Sandboxes Task To specify sandbox information 1 In the ThinApp Assistant open the Gener...

Page 852: ...signed see About Controlling Access to ThinApp Applications To specify control access via Active Directory on the General Settings page perform the following steps Task To specify control access via A...

Page 853: ...istrators and Everyone Groups use same credentials Special groups like Administrators and Everyone have the same SID on every Active Directory domain and Workgroup Other groups you create will have a...

Page 854: ...rom within the virtual environment select the Registry Diagnostics option 4 If you want to include the Windows Command Prompt application with your ThinApp application so that you can browse the virtu...

Page 855: ...Display of Predefined Folders Adding Deleting and Moving Files and Folders in a ThinApp Application The directories in the destination tree on the Files Folders page of the ThinApp Assistant represent...

Page 856: ...lders are the supported MSI standard folders The folder with the check mark is INSTALLDIR which represents the main product installation directory 2 Browse through the folder tree to find the folder t...

Page 857: ...tion perform the following steps Task To add an existing folder to a ThinApp application 1 In the ThinApp Assistant open the Files Folders page The files and folders are listed in the ThinApp Applicat...

Page 858: ...older Yes If you wish to use the default isolation options for all the files and folders under this folder then select the dynamic file link option by clicking Yes The Dynamic File Link Settings dialo...

Page 859: ...the context menu You are prompted to confirm the deletion 3 Click Yes The selected file or folder is deleted Caution If you choose to delete a folder you are also deleting all of the files and subfol...

Page 860: ...hat are already displayed are preceded by a check mark and those that are not displayed do not have a check mark 2 To add a folder to the tree listing select a folder that is not currently listed in t...

Page 861: ...from Folders to Files Caution Modify isolation options only if you have advanced knowledge of Microsoft operating system objects ThinApp and registry settings Overview of ThinApp Isolation Options Thi...

Page 862: ...box N A System elements cannot be modified Created in Sandbox N A System elements cannot be read Table 10 27 Use Scenarios for ThinApp Isolation Options Option Use Scenario Write Copy You would use Wr...

Page 863: ...modify 3 Select the folder and click Isolation Options on the context menu The Isolation Options dialog box opens Full You would use Full isolation when a ThinApp application needs to run on a machin...

Page 864: ...Windows and one for C Windows System32 When the application requests C Windows System32 Notepad exe then the C Windows System32 isolation rule will be applied because C Windows System32 is a more spe...

Page 865: ...delete include exclude or rename ThinApp application executables which are derived from the shortcuts in its Windows Installer package App V Applications and the Virtual Environment App V Shortcut Re...

Page 866: ...plication to run In this scenario this executable file would be a large file or Several executable files exe and a Package DAT file Each of the executables is used to launch the ThinApp application or...

Page 867: ...ation shortcuts to enable users to launch a ThinApp application from within the virtual environment By default the ThinApp Assistant creates ThinApp applications for all of the executable shortcuts th...

Page 868: ...stant creates ThinApp applications for all of the executable shortcuts that exist in your project or Windows Installer package These shortcuts are listed in a checklist on the Applications page Figure...

Page 869: ...ge All of the shortcuts that exist in the project are listed Those that are currently included are selected Those that are currently excluded are not selected 2 To exclude a shortcut select the shortc...

Page 870: ...me a ThinApp application 1 Open the Applications page All of the shortcuts that exist in the project are listed 2 Select the shortcut that you want to rename and click Rename A box appears around the...

Page 871: ...o part data structure under a key The value name identifies a value for storage under a key and the value is the actual data associated with a value name When a value name is unspecified for a value t...

Page 872: ...reg file click the Import a reg file option on the More Options list to open the Registry Import Wizard Inheritance of ThinApp Isolation Options in the Registry Isolation options for registry keys ar...

Page 873: ...Assist in the Distribution of a ThinApp Application Setting ThinApp Log Monitor Tracing Options Setting AppLink Options Setting AppSync Options Important You must create at least one Release on the R...

Page 874: ...s by selecting Save on the File menu It not necessary to build the package because it is already built Therefore InstallShield s Build function is disabled However you do need to run the build process...

Page 875: ...application This simplifies the deployment of a ThinApp application by enabling you to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Config...

Page 876: ...fields are automatically populated Note If the application was built with the Disable Log Monitor Tracing option on the Build Options page selected it will not be listed 2 Delete Click to delete trac...

Page 877: ...ngs for the current ThinApp application on the AppLink Settings dialog box which is opened by clicking the AppLink Settings option in the More Options menu of the ThinApp Assistant Build Options page...

Page 878: ...he Build Settings page of the ThinApp Assistant click the AppLink Settings option in the More Options menu The AppLink Settings dialog box opens 2 Click the Browse button to open the Add AppLink Refer...

Page 879: ...ut select either its Package DAT file if the ThinApp application was built with AdminStudio or its primary executable file if the ThinApp application was built with ThinApp Important On the Add AppLin...

Page 880: ...ollowing tasks Distribute runtime components separately You can use AppSync to distribute runtime components separately from the applications that use them For example the Java Runtime Environment JRE...

Page 881: ...ThinApp application is updated By default the following is entered The application has been successfully updated 4 By default a package will connect to the Web server once per day to see if an update...

Page 882: ...ious setting As long as a package has not expired this parameter checks for new versions and downloads will occur in the background The user can continue to use the old version If the application is t...

Page 883: ...Building an App V Application for an InstallShield Project Building an App V Application for a Windows Installer Package Building a ThinApp Application for an InstallShield Project To build a ThinApp...

Page 884: ...ication see Components of an App V Application Building a ThinApp Application for a Windows Installer Package To build a ThinApp application for a Windows Installer package perform the following steps...

Page 885: ...and Warnings ThinApp Assistant Reference Reference information about the ThinApp Assistant is organized into the following sections Pages Dialog Boxes Building App V Applications Using the Command Lin...

Page 886: ...App Assistant Home page displays a diagram that illustrates the process of creating a ThinApp application Figure 10 35 ThinApp Assistant Home Page Click the following icons in the navigation bar at th...

Page 887: ...ns Creating ThinApp Applications AdminStudio 9 5 User Guide ADS 0950 UG00 887 Applications Page Registry Page Build Options Page Go to next page Jump back to previous page ThinApp Assistant Home Page...

Page 888: ...re 10 36 ThinApp Assistant General Settings Page The General Settings page includes the following options Table 10 32 General Settings Page Option Description Sandbox Name When a ThinApp application i...

Page 889: ...f you want to control the access of users to a ThinApp application by specifying Active Directory groups select this option and enter the names of those groups At build time ThinApp would then assign...

Page 890: ...ThinApp Assistant you can perform the following tasks View Files and Folders Add Files and Folders Delete Files and Folders Set Isolation Options Modifying the Display of Predefined Folders View File...

Page 891: ...le link to the source folder Figure 10 38 Dynamic File Link Option Dialog Box Indicate whether you want to create a dynamic file link by selecting one of the following No For more flexibility with Thi...

Page 892: ...provide access to system resources requested by the application The default settings for isolation options are built into the ThinApp Assistant and those defaults are adequate for most environments Ho...

Page 893: ...irements For each ThinApp application you are required to define at least one shortcut You define application shortcuts to enable users to launch a ThinApp application from within the virtual environm...

Page 894: ...by step instructions see the following topics Creating a New App V Application Including an Existing App V Application Excluding or Deleting an Existing App V Application Renaming an App V Application...

Page 895: ...le click the Import a reg file option on the More Options list to open the Registry Import Wizard Note You cannot set isolation options on root registry keys Editing the registry on the Registry page...

Page 896: ...ecting Releases to Build Enabling App V Application Building When in Direct Edit Mode Clearing the ThinApp Cache Opening the App V Application Folder Building an App V Application Supporting AppSync a...

Page 897: ...Chapter 10 Creating Customized Virtual Applications Creating ThinApp Applications AdminStudio 9 5 User Guide ADS 0950 UG00 897 Figure 10 41 Build Settings Page When in Basic MSI Project Mode...

Page 898: ...in InstallShield Because you do not have to select a release for a Windows Installer package there is no releases tree Because a Windows Installer package has already been built InstallShield s standa...

Page 899: ...ild a Windows Installer package with your ThinApp application This enables you to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Configurati...

Page 900: ...indows Installer Converter See Converting a Suite of Applications into a Virtual Package Building a Windows Installer Package to Assist in the Distribution of a ThinApp Application You can choose to b...

Page 901: ...not selected Only a Windows Installer package would be built Note To build more than one release at a time perform a batch build See Performing Batch Builds About Creating Releases You cannot create...

Page 902: ...or detailed instructions see one of the following topics Building an App V Application for an InstallShield Project Building an App V Application for a Windows Installer Package Supporting AppSync and...

Page 903: ...cation s virtual environment at runtime You have the following options Launching the Diagnostic Tools Within the Virtual Environment If you selected the Registry Diagnostics or File System Diagnostics...

Page 904: ...you have advanced knowledge of Microsoft operating system objects ThinApp and registry settings The Folder Isolation Options dialog box includes the following options Table 10 35 ThinApp Isolation Opt...

Page 905: ...e environments or Windows Vista With Write Copy isolation ThinApp makes copies of registry keys and files written by the application and performs all of the modifications in a user specific sandbox Wi...

Page 906: ...box includes the following options Table 10 37 ThinApp Isolation Options Option Visibility of System Elements Modifications to Virtual Elements Modifications to System Elements New Elements If System...

Page 907: ...ser environments and expects it can modify files and keys without impacting other users Application expects write permission to Global locations and was not designed for locked down desktop environmen...

Page 908: ...package containing Photoshop Linking packaged applications to service packs You can link packaged applications to service packs By using AppLink you can upgrade or roll back your service packs by cha...

Page 909: ...ions and Order of Import ThinApp uses a last import wins policy to determine what happens when two packages are imported that have the same files or registry keys Browse Button Click the Browse button...

Page 910: ...imported package containing a script with that name Caution Because VB Script name collisions could cause scripts from other packages not to be executed it is important to use unique name for VB Scri...

Page 911: ...me filename exe In that case the main ThinApp application needs that linked application to be found at the specified absolute path location at runtime which is unlikely Therefore it is recommended tha...

Page 912: ...lowing are examples of how packages can be added to the AppLink References list AdminStudio More than one When built with AdminStudio a ThinApp application that has more than one shortcut consists of...

Page 913: ...to your applications Application Sync enables you to distribute service packs and roll back to previous versions if necessary On the AppSync Settings dialog box which is opened by clicking AppSync Set...

Page 914: ...pplication Sync works over both the HTTP unsecure and HTTPS secure protocol Part of HTTPS is that the identity of the Web server is checked You can include a user name and password in the URL that wil...

Page 915: ...t the sandbox is not cleared Select this option to clear the sandbox Table 10 43 Expiration Tab of the AppSync Settings Dialog Box Option Description Use Application Expiration Select this option to r...

Page 916: ...very launch of an application overriding any previous setting As long as a package has not expired this parameter checks for new versions and downloads will occur in the background The user can contin...

Page 917: ...lication Therefore some additional pre or post conversion actions must be taken in order for the ThinApp application to be created properly One action you could take to try to include ignored features...

Page 918: ...E Application Data ThinApp SandboxName The SandboxName entry in the package ini file is used to name the directory where sandbox files are stored at runtime SandboxName MyApplicationV3 By default Admi...

Page 919: ...ppy flash to go into the sandbox By default the application can read and write to removable disk with no changes The value for SandboxRemovableDisk can be set to either 0 off or 1 on SandboxRemovableD...

Page 920: ...ced users VirtualizeExternalOutOfProcessCOM Enable this option if you want all out of process COM objects to be loaded outside of the virtual environment By doing this the application may indirectly m...

Page 921: ...The default is determined by the ChildProcessEnvironmentDefault option which can be set to Virtual or External If this option is not present the default is the Virtual environment It is possible to o...

Page 922: ...utable makes its first network connection It does not scan the executable if the executable does not make any network connections Because a large number of desktops have Norton AntiVirus installed Thi...

Page 923: ...resulting in the smallest application footprint but increasing build time Note This option corresponds to the Compression Type options on the Build Options page Table 10 46 Isolation Section of packa...

Page 924: ...irtual element Merged System elements are visible modifications to virtual elements are made in the sandbox modifications to system elements are made on the system new elements are created on the syst...

Page 925: ...unning Possible values are 1 logging is disabled or 0 logging is enabled DisableTracing 1 Note This option corresponds to the Disable Log Monitor Tracing option on the Build Options page Icon By defau...

Page 926: ...ows will use the default application icon myapp exe Source ProgramFilesDir myapp app exe Icon NULL 2 The path to another exe file In this case Tlink will load the icons from a different exe file If a...

Page 927: ...cation Microsoft App V Assistant Reference Overview of the Citrix Assistant You can use the Citrix Assistant to help you author a Citrix profile for an application The Citrix profile can then be deplo...

Page 928: ...he operating systems and language requirements that client workstations must meet in order for this application to operate properly You can also specify pre launch and post exit scripts to execute Man...

Page 929: ...and then those applications are deployed to users throughout the enterprise These deployed applications run within isolation environments that prevent them from interfering with other software runnin...

Page 930: ...application is run it checks for errors or updates and they are delivered automatically Note For more information see Benefits of Deploying ThinApp Applications About the Citrix Assistant You can use...

Page 931: ...al Applications About Citrix Profiles When you use the Citrix Assistant to prepare a Windows Installer package for deployment on the Citrix XenApp the resources you generate are called profiles A prof...

Page 932: ...the entire Microsoft Office suite in a single profile Benefits of Deploying Citrix Profiles Converting a Windows Installer package to a Citrix profile and deploying it on a Citrix XenApp offers the fo...

Page 933: ...rver silos Deploying applications on Citrix XenApp prevents the build up of application specific server silos because you can safely install and reliably run multiple application versions and incompat...

Page 934: ...permission to it Enables User Based Application Access Rather Than Machine Based Access Users can access their applications anywhere on the network regardless of where they are or what device they ar...

Page 935: ...f the Citrix profile You also need to specify whether this package can run executables that are not included with the Citrix profile and whether to include diagnostic tools with the Citrix profile The...

Page 936: ...rsion 1 In the Citrix Assistant open the Profile Information page 2 In the Name field enter a name for this Citrix profile The name you enter here determines the file name of the generated Citrix prof...

Page 937: ...egistry or file system for the application while it is running in its isolation environment For example if you were running a Citrix profile and got an error message stating that the application canno...

Page 938: ...in the isolation environment select the Registry Diagnostics option 4 If you want to include the Windows Command Prompt application with your Citrix profile so that you can browse the virtual file sys...

Page 939: ...lication perform the following steps Task To specify operating system requirement and service pack levels 1 In the Citrix Assistant open the Profile Requirements page 2 For the Does your Citrix profil...

Page 940: ...in the box Range of Service Pack Levels To run properly this application requires that this operating system have a specified range of Service Packs installed If you select this option specify the Mi...

Page 941: ...ng the profile users who do not meet those requirements will be given access to run applications locally and they will probably encounter application errors Table 10 52 Citrix XenApp User Access Scena...

Page 942: ...and manage all of the Before Profile Launch and After Profile Exit script files you are including with your Citrix profile Files can be marked to run inside or outside of the isolation environment Onl...

Page 943: ...cript file s exe bat cmd or com that you want to add and click Open The file is added to the Script Execution tree on under the appropriate node Tip Use the Shift key to select multiple contiguous fil...

Page 944: ...long with the script enter them in the Command line parameters box Delete a script To delete a script from the profile select it and click the Delete button 7 When you have set all desired options for...

Page 945: ...supported MSI standard folders The folder with the check mark is INSTALLDIR which represents the main product installation directory 2 Browse through the folder tree to find the folder that you would...

Page 946: ...le perform the following steps Task To add an existing folder to a Citrix profile 1 In the Citrix Assistant open the Profile Files page The files and folders are listed in the Citrix Profile tree orga...

Page 947: ...s folder Yes If you wish to use the default isolation options for all the files and folders under this folder then select the dynamic file link option by clicking Yes The Dynamic File Link Settings di...

Page 948: ...context menu You are prompted to confirm the deletion 3 Click Yes The selected file or folder is deleted Caution If you choose to delete a folder you are also deleting all of the files and subfolders...

Page 949: ...file or folder you had selected when you selected it from the Predefined Folders list 3 To remove a folder from the tree listing select that folder name in this list which is preceded by a check mark...

Page 950: ...e access to system resources requested by the application The default settings for isolation environments are set on the Citrix XenApp and those defaults are adequate for most environments However in...

Page 951: ...der registry key that is inside the isolation environment If the item is not found there then the isolation environment will use the copy of this file folder registry key that is on the system Selecti...

Page 952: ...ed in Table 10 53 Isolation Options Default Ignore Isolate Strictly Isolate Redirect 5 Click OK Files and folders that have an isolation setting other than default are marked with a special icon Inher...

Page 953: ...ns for shortcuts Therefore if you specify an Icon File on the Shortcuts view of the Installation Designer be sure to select an icon that includes only 16 colors When you select each shortcut details a...

Page 954: ...folder appears in the first pane of the Start menu Start MyApplicationFolder ApplicationName When you select this option the Place under Programs folder and Start menu folder fields are enabled Place...

Page 955: ...itrix profile you are required to define at least one shortcut Profile shortcuts enable users to access the isolation environment and launch the application If you build a Citrix profile that does not...

Page 956: ...elect a file within this profile 3 Select the file that you want to create a shortcut to 4 Click Open A new shortcut is listed and it is named the same name as the selected file 5 To include this shor...

Page 957: ...xcluding an App V Application Deleting a Shortcut When you delete a shortcut it is removed from both the Citrix profile and the InstallShield project See Deleting an App V Application If you have any...

Page 958: ...in in the InstallShield project Excluding a shortcut When you exclude a shortcut it will not be created in the Citrix profile but it will remain in the InstallShield project This means that the shortc...

Page 959: ...d users to uninstall the application easily without interfering with other applications on the system System wide file associations for documents created by an application License information Default...

Page 960: ...es page 2 Browse through the registry tree to find the key that you would like to modify 3 Select the folder or key and click Isolation Options on the context menu The Isolation Options dialog box ope...

Page 961: ...Modifying Build Settings On the Build Settings page you choose which releases of this InstallShield project you want to build a Citrix profile for when the project is built specify whether you want to...

Page 962: ...ses to build 1 Open the Build Settings page 2 Select the releases in the Releases tree that you want to build a Citrix profile for Important When you select a release on the Build Settings page you ar...

Page 963: ...ents etc In addition to being able to convert a single Windows Installer package to a virtual application you can also use the Citrix Assistant to convert an application suite of multiple Windows Inst...

Page 964: ...nt 3 Select the Build Citrix Profile option After you select this option the Build Citrix Profile selection on the Build menu becomes enabled as does the Build toolbar button Building a Citrix Profile...

Page 965: ...taller package and a Citrix profile For a description of the files that comprise a Citrix profile see Components of an App V Application Building a Citrix Profile for a Windows Installer Package To bu...

Page 966: ...itrix Assistant Reference Reference information about the Citrix Assistant is organized into the following sections Pages Dialog Boxes Building App V Applications Using the Command Line App V Applicat...

Page 967: ...lays a diagram that illustrates the process of creating a Citrix profile for deployment on Citrix XenApp Figure 10 57 Citrix Assistant Home Page Click the following icons in the navigation bar at the...

Page 968: ...fy the Name Description and Version of the Citrix profile you are creating and you specify the package Security Settings to determine whether this package can run executables that are not included wit...

Page 969: ...able 10 56 Profile Information Page Option Description Name Enter a name for this Citrix profile The name you enter here determines the file name of the generated Citrix profile Note Do not include th...

Page 970: ...rmit any executable files to run other than those included in the Citrix profile For example if the client is running an Internet Explorer plug in included in the Citrix profile the enhanced security...

Page 971: ...ecific operating system requirements Select one of the following Yes Select this option if the application does not support one of the listed operating systems When you select this option the check bo...

Page 972: ...er to run properly Enter the required Service Pack Level in the box At least Service Pack Level To run properly this application requires that this operating system have at least the specified Service...

Page 973: ...following tasks View Files and Folders Add Files and Folders Delete Files and Folders Set Isolation Options Modifying the Display of Predefined Folders Language List If you set the Does your Citrix p...

Page 974: ...application will look when it is installed on to your customer s machine Blue folders are the supported MSI standard folders The folder with the check mark is INSTALLDIR which represents the main pro...

Page 975: ...ix profile by selecting the file or folder you want to delete and selecting Delete from the context menu For more information see Deleting Files and Folders Caution If you choose to delete a folder yo...

Page 976: ...hortcuts Page You define profile shortcuts to enable users to launch a Citrix profile from within the isolation environment By default the Citrix Assistant creates shortcuts to all of the executable e...

Page 977: ...om being created in the Citrix profile you can choose to either delete or exclude it depending upon whether you want it to remain in the InstallShield project Excluding a shortcut When you exclude a s...

Page 978: ...xisting App V Application Renaming an App V Application Profile Registry Page On the Profile Registry page you can view existing registry items and add or delete registry items You can also override t...

Page 979: ...d Registry View See Editing the Registry For information on how to override a registry key s default isolation options see Setting App V Application Registry Isolation Options Important While you cann...

Page 980: ...select the releases that you want to build a Citrix profile for on the Releases tree of the Build Settings page By selecting a release you are specifying that whenever that particular release is buil...

Page 981: ...uild a Citrix profile For more information see Creating and Building Releases Digitally Signing a Citrix Profile You can digitally sign your Citrix profile to assure end users that neither your instal...

Page 982: ...is already built Therefore InstallShield s Build function is disabled However you do need to run the build process to build a Citrix profile for this Windows Installer package To enable the Build butt...

Page 983: ...md or bat extensions are allowed to execute Figure 10 65 Custom Execution Dialog Box For step by step instructions on using this dialog box see Adding Pre Launch and Post Exit Scripts Diagnostic Tools...

Page 984: ...nostics options on the Diagnostic Tools dialog box shortcuts to those tools are automatically added to the profile When the user runs this Citrix profile application two additional shortcuts will be a...

Page 985: ...ve advanced knowledge of Microsoft operating system objects and registry settings The File Isolation Options dialog box includes the following options Table 10 59 File Isolation Options Option Descrip...

Page 986: ...g Box Strictly Isolate Always look for this file in the isolation environment not on the system Note This is useful when running two versions of an application on the same machine Redirect Always use...

Page 987: ...Always look for this file on the system not in the isolation environment Isolate Look for this folder in both the isolation environment and on the system If the folder exists in both places list both...

Page 988: ...ry key Figure 10 69 Registry Isolation Options Dialog Box Caution Modify isolation options only if you have advanced knowledge of Microsoft operating system objects and registry settings The Registry...

Page 989: ...ate Always look for this registry key in the isolation environment not on the system Note This is useful when running two versions of an application on the same machine Redirect Always use the followi...

Page 990: ...irement Options Option Description No Service Pack Requirement Select this option if this application supports all versions of this operating system regardless of the number of Service Packs installed...

Page 991: ...d when creating a Citrix profile Therefore some additional pre or post conversion actions must be taken in order for the application profile to run on Citrix XenApp One action you could take to try to...

Page 992: ...Chapter 10 Creating Customized Virtual Applications Creating Citrix Profiles 992 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 993: ...ditor contains integrated Application Manager and ConflictSolver functionality allowing you to perform conflict identification before leaving InstallShield Editor InstallShield Editor s documentation...

Page 994: ...nterface Getting a Copy of a Software Repository Package Opening and Editing a Software Repository Package Adding a Package to the Software Repository via the InstallShield Editor Build Process Using...

Page 995: ...cation Catalog from InstallShield Editor AdminStudio Professional and Enterprise Editions Open the File menu point to Application Manager and click Add to open the Import Wizard Using this Wizard you...

Page 996: ...lections from the Application Manager submenu on the InstallShield Editor File menu you can access packages stored in a AdminStudio Application Catalog Software Repository InstallShield Editor can per...

Page 997: ...InstallShield Editor 3 On the File menu point to Application Manager and click Open The Open Application Manager Catalog dialog box opens listing the package tree in the AdminStudio Application Catalo...

Page 998: ...age in the Software Repository is not modified Opening and Editing a Software Repository Package Edition The Software Repository feature is available in AdminStudio Enterprise Edition Task To open and...

Page 999: ...on Manager meaning that no one else can check it out until you check it back in If you were to open Application Manager and select this package you would see the Checked Out icon in the Product View 6...

Page 1000: ...ted package to belong to 1 Select one of the following Duplicate Package options New Package Version Overwrite Existing Version New Package History Version Ignore if Exists 2 Build the setup Upon comp...

Page 1001: ...n Repackager to convert a Windows Installer package to a Microsoft App V application ThinApp application or Citrix profile You would use this tool if you wanted to convert a Windows Installer package...

Page 1002: ...stallShield Editor includes InstallShield 2009 Premier Edition s multilingual runtime language support which enables you to create a single installation that displays end user text in multiple languag...

Page 1003: ...sented in the following sections Table 12 1 Tuner User Documentation Section Description Working with Transforms Explains how to create a transform file to customize a Windows Installer based installa...

Page 1004: ...preadsheet A third department may need the entire suite of applications Instead of manually setting up every person in the company you can take the original setup of the entire suite and create a cust...

Page 1005: ...ion go to the Provide a list of additional transforms to be applied area and click the New button A new entry appears in the list When an entry appears in the list click the Browse button to the right...

Page 1006: ...pair ARPHELPTELEPHONE 1 111 111 1111 to set the value of the Help Telephone field of Add Remove Programs See Using Response Transforms for more information You might pass a property value pair during...

Page 1007: ...t one of the following options Reload the last project saved when restarting Tuner Make this my default Tuner Start Page Screen Make Welcome my default Tuner Start Page Screen Creating Generic Transfo...

Page 1008: ...any name as the default name and a specific directory for installation which is different from the one suggested by the manufacturer Further you may want to configure a specific feature such as clip a...

Page 1009: ...ure Follow this procedure when validating an installation In practice you should prevalidate the base MSI file to ensure compliance to MSI standards before you begin creating a customization project A...

Page 1010: ...ghlighted in red This feature makes it very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows Installer package and store them in your transform For more infor...

Page 1011: ...invalid packages 5 Click the Transform Validation button on the toolbar or click the Start button in the view Viewing the Postvalidation Results As each ICE is run Errors Warnings and Info messages a...

Page 1012: ...made using the Direct Editor can also affect your installation s functionality Evaluation Files and Internal Consistency Evaluators When you prevalidate the base Windows Installer package or postvalid...

Page 1013: ...the drop down menu Your selections are The feature is not installed By default the feature will not be installed during setup The feature is installed on the local drive By default the feature will b...

Page 1014: ...cell Setting the Default Destination Task To specify the Default Destination Path for an installation 1 Under Organization select the Product Properties view from the checklist The Product Properties...

Page 1015: ...tures from Displaying During Custom Installation Task To prevent a feature from being displayed to your end users during a custom installation 1 Under Organization in the checklist select the Features...

Page 1016: ...D or network INSTALLSTATE_SOURCE The feature will be run from the source whether it is from the installation CD or from the network The feature is advertised INSTALLSTATE_ADVERTISED The feature will b...

Page 1017: ...s From the Files and Folders view you can perform all file operations in Tuner This includes viewing files in the source MSI package adding new files preventing files from being installed and removing...

Page 1018: ...the Files and Folders view all files from the base Windows Installer package are displayed as well as the files added in the transform By default this option is enabled Preventing Installation of Fil...

Page 1019: ...er If you add additional files after saving the transform the contents of the CAB file are extracted and recompressed along with the new files Because this mechanism relies on the presence of the CAB...

Page 1020: ...name the key If you want to change the name later right click on the key and select Rename 5 Right click on the new key and select whether the key is to be created on installation deleted on uninstall...

Page 1021: ...name the value later right click on the value name and select Rename Note When creating binary values Tuner automatically converts whatever input you provide into a binary value Modifying the Value Da...

Page 1022: ...u want to remove a value from a specific key right click on the value in the Destination Computer Registry Data pane and select Delete 4 If you want to remove an entire key right click on the key in t...

Page 1023: ...ask To create a shortcut 1 Select Shortcuts from the checklist The Shortcuts View opens 2 In the Shortcuts folder tree navigate to the folder in which you want to put the shortcut 3 Right click on the...

Page 1024: ...r tree navigate to the folder containing the appropriate shortcut 3 Select the Target property from the Properties Grid 4 Select the appropriate Target from the list The Target Type that is selected a...

Page 1025: ...te to remove it Determining the Path of Changed Shortcuts Task To determine the actual path of a changed shortcut 1 Go to the Direct Editor and select the Directory table 2 Find the shortcut Target di...

Page 1026: ...ropriate destination folder in the INI File tree and select New IniFile 3 To rename the new INI file select IniFile ini and select Rename from the context menu 4 To rename the new INI section select N...

Page 1027: ...cted enter a Key name Value and Action for the default INI key value See Modifying INI File Keys Values and Actions 5 Add additional Keys to this new INI file section as necessary See Adding New Keys...

Page 1028: ...right click on the INI file you want to delete and select Remove Option Description Key The name of the key This should be entered in the exact way you want it to appear in the target INI file Value T...

Page 1029: ...ct the INI File section that contains the key you want to delete from the INI Files tree 3 Right click the key you want to remove and select Delete ODBC Resources Open Database Connectivity ODBC Resou...

Page 1030: ...useless Adding New ODBC Data Source Attributes Task To add a new ODBC data source attribute 1 Select ODBC Resources from the checklist The ODBC Resources View opens 2 Select the ODBC Data Source to wh...

Page 1031: ...ODBC driver that contains the attribute you want to modify from the ODBC Resources tree The property grid for that ODBC driver appears 2 In the properties sheet edit the appropriate attribute Removin...

Page 1032: ...change parameters for NT Services included in the base Windows Installer package Topics in this section include the following Setting NT Service Arguments Setting NT Service Dependencies Setting the...

Page 1033: ...s on a load ordering group the service can start if at least one member of the load ordering group is running after an attempt is made to start all load ordering group members Setting the NT Service D...

Page 1034: ...needed If this service does not belong to a group leave this value blank Setting the NT Service Overall Install Result Task To set the NT service overall install result 1 Select NT Services from the...

Page 1035: ...d provide the name under which this service will run 3 Click the current Password value in the properties grid and provide the password associated with the Start Name Setting the NT Service Type Task...

Page 1036: ...You can enable or disable these dialogs by either the check box to the left of the dialog name or by using the Show and Hide buttons Topics in this section include the following Hiding Dialogs During...

Page 1037: ...r setup authoring application was used the names of dialogs and properties may not be the same The same general procedure still applies Task To use a transform to suppress display of the license accep...

Page 1038: ...K to dismiss the dialog 6 Select the CustomSetup dialog from the Dialogs list and click Hide 7 When the Dialog Properties dialog box opens change the _BrowseProperty value to INSTALLDIR 8 Click OK to...

Page 1039: ...ue of this property also determines whether the installation should continue Therefore if you remove the LicenseAgreement dialog from a sequence you need to use the Dialog Properties dialog box to set...

Page 1040: ...access the server remotely In other words if a server is not available or if you added an invalid server the entry will be ignored if the resource is needed Modifying Server Locations Task To modify a...

Page 1041: ...operating systems in many ways Depending on how the Windows Installer setup is configured the user has the option of removing repairing or changing the installation with the click of a button Windows...

Page 1042: ...necessary to edit property values that are not available elsewhere The Setup Properties view exposes the entries in the properties table the underlying structure of Windows Installer packages You can...

Page 1043: ...w from the checklist 2 Double click in the comment column for the property to which you want to add or edit the comment 3 Add or edit the comment as appropriate Removing Custom Setup Properties Task T...

Page 1044: ...he Installation to an FTP Server Creating a Package Definition File PDF Creating an SMS File Instructing SMS to Create a Management Information Format File at Deployment Time Deploying Windows Install...

Page 1045: ...create a Package Definition File PDF 1 From the checklist select Package and then select SMS from the second column The SMS View of the Package View opens 2 Select the Create Package Definition File c...

Page 1046: ...ckage Definition MIFFilename Sample MIF Name Orca Publisher Microsoft Version 1 20 1827 1 Language English Programs Typical Automated Test Typical Name Typical CommandLine msiexec i Orca msi UserInput...

Page 1047: ...a MIF extension Deploying Windows Installer Setup Packages with Systems Management Server 2 0 Task To deploy Windows Installer setup packages with SMS 2 0 Perform the steps detailed in the Microsoft...

Page 1048: ...ing Table Columns in the Direct Editor When you initially open the Direct Editor the selected table s columns are listed in a compact format so that the maximum number of columns are displayed To auto...

Page 1049: ...ation tab is automatically selected and all of the Errors Warnings and Info messages that were generated are listed in table format Each table row lists an icon to indicate whether it is an Error a Wa...

Page 1050: ...sections User Interface Reference This book describes the user interface components such as menu items the toolbar views and dialog boxes you will encounter throughout Tuner Menus and Toolbar View Bar...

Page 1051: ...ew Ctrl N Takes you to the Create a New Transform File area of the Tuner Start Page view File Open Ctrl O Takes you to the Open a Recent Transform File area of the Tuner Start Page view File Close Clo...

Page 1052: ...Takes you to the Tuner Start Page Go Help Takes you to the Help view Go Package Validation Takes you to the Prevalidation view Go Organization Takes you to the Product Properties and Features views Go...

Page 1053: ...ge based on the current packaging settings Project Packaging Wizard Ctrl F7 Launches the Packaging Wizard Project Stop Halts in progress validation or packaging Tools Customize Allows you to customize...

Page 1054: ...right of the checklist you can then customize the part of the Windows Installer package pertaining to that view The Customization Steps Checklist is a subset of the entire checklist The checklist can...

Page 1055: ...g distribution information and displays a summary of the files copied You can copy these results to the clipboard by right clicking and selecting Copy Organization View This allows you to specify both...

Page 1056: ...g it off the toolbar Properties Dialog Box This dialog box displays properties of the transform you are currently creating or editing including the name and location of the base Windows Installer file...

Page 1057: ...code pages Table 12 9 Validation Options Option Description Same Language If selected the package against which the transform is applied must be the same language as the package used to create the tra...

Page 1058: ...er package as these properties are usually custom in nature This is especially true for properties that must be set prior to hiding a dialog from the UI sequence Product Version is Higher If selected...

Page 1059: ...alue from the drop down list Once you have provided a value for a null property or if the property does not require configuration it is denoted with Tuner Views The following views are available in Tu...

Page 1060: ...sform View This view is displayed when you click Create a new transform or select New from the File menu This view contains the following options Additional Tools View Direct Editor Table 12 11 Tuner...

Page 1061: ...m first that transform is attempting to modify the property s value instead of creating it That will result in an error One simple example of where this may be a problem is with the default company na...

Page 1062: ...ugh the installation making changes as necessary When you reach the end of the installation sequence and click Install the installation will exit and the Tuner interface will open your transform which...

Page 1063: ...kage for your transform is valid If it fails the validation test then unexpected and unwanted results can occur during installation To begin the prevalidation process select the evaluation file that y...

Page 1064: ...that can will or will not be installed Each subview of the Organization View is described below Product Properties View This view gives you a way to specify the default path on the user s computer in...

Page 1065: ...ProgramFilesFolder which can vary depending on the system s locale and user settings If ProgramFilesFolder ProductName is specified as the default value for the Destination Folder property then this...

Page 1066: ...ts subfeatures expanded by default Not Visible This feature will not be displayed to the end user in the Custom Setup dialog Although an end user obviously cannot select or deselect an invisible featu...

Page 1067: ...on The key files were set by the setup author and cannot be modified using Tuner Destination Computer View Tasks The following tasks are performed in the Destination Computer View Defining a New Folde...

Page 1068: ...registry keys so adverse results do not occur You must specify whether the key is to be created at install removed at uninstall or both These mutually exclusive options are available by right clicking...

Page 1069: ...w the name of the icon now appears in the icon value cell and a picture of the icon appears next to the Change Icon button To remove the icon click Clear Icon Description A brief description of the sh...

Page 1070: ...ed Window Launches the program in full screen view Minimized Window Launches the program in a minimized window visible only on the taskbar Working Directory Default directory for the Save As and Open...

Page 1071: ...same fashion Destination Folder To point the shortcut to a folder rather than a file select Destination Folder in the Target Type property and then select a folder name from the Target property drop...

Page 1072: ...lecting New Folder To remove a folder that you have added right click on it and select Delete The following predefined folders are available for shortcuts Table 12 19 Predefined Shortcut Folders Prede...

Page 1073: ...wer right pane provides information about the selected key Editing INI Files in Tuner To edit an INI File in Tuner simply expand the appropriate IniFile node in the tree Then select the appropriate se...

Page 1074: ...SQL Server Microsoft Access and Visual FoxPro Connection information may include the name of the database where the server that hosts it is located and logon password information You can add new ODBC...

Page 1075: ...Options Option Description Name This property contains the name of the service to install This property may have the same value as the Display Name but is used by the installer in a different way Dis...

Page 1076: ...rts the system with the last known good configuration If the last known good configuration caused the failure the startup operation fails Overall Install This property s value specifies how the instal...

Page 1077: ...o have access this feature Server Locations View If you install from a network server and if you install features to run from the server or that will be advertised for installation on their first use...

Page 1078: ...at appear during the installation administrative patch or maintenance sequences You can do so from the Dialogs view This view contains a list of each of the four installation modes installation admini...

Page 1079: ...upport Product maintenance applets display this value Corresponds to the ARPHELPLINK property in the Setup Properties view Help Telephone Contains the telephone number that users can call for assistan...

Page 1080: ...art off with an invalid base package but the postvalidation does not have any errors If this happens the properties you changed in your transform can bring the overall package and transform up to a va...

Page 1081: ...a third party tool such as Microsoft SMS Tuner provides several different packaging options that can be used individually or in conjunction with one another Note that Tuner does not actually perform...

Page 1082: ...nsform If you want to do this provide the Install MIF Filename Uninstall MIF Filename and serial number For more information about Microsoft SMS consult the SMS documentation Additional Tools View Tun...

Page 1083: ...row is active you can double click on it to open that row s associated table The Direct Editor is launched and the table and or table cells that are causing the problem are highlighted in red This fe...

Page 1084: ...what to do when there are conflicts arising from duplicate values When import occurs Tuner merges the contents of the INI file with existing INI file data Welcome Panel The Import INI File Wizard allo...

Page 1085: ...mport Panel To launch the Import REG File Wizard go to the Registry View right click on one of the registry hives or on a registry key you have added and select Import REG File from the context menu T...

Page 1086: ...ent machines To invoke the Packaging Wizard select Packaging Wizard from the Project menu or select the Packaging Wizard button from the toolbar The Packaging Wizard consists of the following four pan...

Page 1087: ...nition File PDF or an SMS file in the SMS View Select the file type s you want to create If you create an SMS file Tuner can instruct SMS to create a Management Information Format MIF file when SMS de...

Page 1088: ...Chapter 12 Customizing Installations Using Tuner Tuner Reference 1088 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1089: ...cludes the following chapters Identifying and Resolving Application Conflicts Using ConflictSolver Identifying and Resolving Package Errors Using PackageExpert Analyzing the Impact of Installing Micro...

Page 1090: ...1090 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1091: ...onflictSolver can resolve the issues automatically You can also create your own custom rules to ensure packages conform to your internal standards and practices The ConflictSolver user documentation i...

Page 1092: ...has been divided into two tools ConflictSolver and Application Manager This section compares these tools and includes the following topics Functionality Comparison Accessing the Tools Displaying Conf...

Page 1093: ...ge enterprise Software Repository Import packages into and check in and check out packages from the Software Repository Associate a package with a Workflow Manager package Launch applications Launch P...

Page 1094: ...interface Displaying ConflictSolver Options in Application Manager By default all functionality for interacting with the Application Catalog including conflict detection and resolution is available i...

Page 1095: ...nflict ACE Rules Conflict ACE Rules are used to detect conflicts between two Windows Installer packages You can use Conflict ACE Rules to detect conflicts between one or more Windows Installer source...

Page 1096: ...sequence of steps to quickly and efficiently perform conflict detection See Perform Conflict Detection Plan Your Import Planning your import consists of the following steps Check and Configure Your I...

Page 1097: ...ages than between internal packages and an external MSI package Performing a Bulk Import To perform a bulk import use the following command line iscmide exe I C c mypackages myconfig ini If you are us...

Page 1098: ...against a package already imported into the Application Catalog Therefore we recommend that you import all packages that you want to conflict check into the Application Catalog and select the Interna...

Page 1099: ...e found then pre import all Merge Modules that are used by your packages ideally using the bulk import process If you are not performing conflict detection on merge modules you do not need to import m...

Page 1100: ...the package node and select Check out from the context menu The package is checked out 2 Open ConflictSolver select the package node and select Scan for dependencies from the context menu 3 Select th...

Page 1101: ...hich would cause the Installer to incorrectly register components Warnings Database authoring that can cause incorrect behavior Warnings can also report unexpected side effects of database authoring A...

Page 1102: ...t Wizard to import an MSI package Behind the scenes the Validation Wizard checks the package for validation errors and if the package fails validation it will not be imported into the Application Cata...

Page 1103: ...eld Editor Note If you use the Validate Package function to validate a package after you have imported it into the Application Catalog instead of performing validation before it is imported you can vi...

Page 1104: ...oduct View to ensure that the package is built according to Windows Installer standards The Validate Package function includes the following tasks and options Validating an Imported Package Viewing IC...

Page 1105: ...E Error Information After an imported package has been validated detailed information on all of the ICE Errors and Warnings that were found can be viewed on the Validation View Each ICE error that was...

Page 1106: ...n ICE error it is listed in gray on the Validation View and is not executed in subsequent validations You might choose to suppress an ICE error that is a known issue at your organization which does no...

Page 1107: ...Error You can permanently delete an ICE error from subsequent execution and reporting for that package ICE errors that are deleted are no longer listed in the Validation View and will not be listed in...

Page 1108: ...tions from the Tools menu The Options dialog box opens 2 Open the Validate tab 3 In the MSI Input files and MSM Input files areas click the Browse button next to the Cub File field to locate the valid...

Page 1109: ...r a per user context only The target file must be a file installed in a user specific directory The keypath of the component containing the target file must be a user specific registry value Table 13...

Page 1110: ...following It creates a catch all component if not yet created named ShortcutsComponent It also creates an HKCU registry entry in the Registry table and that entry is used as the keypath for the Shortc...

Page 1111: ...ollowing ConflictSolver conflict identification and resolution options Changing Default Conflict Types Checked Select the ACE rules that will be selected by default during conflict detection Changing...

Page 1112: ...played 6 Expand the tree and select the Conflict Types ACE rule conflicts you want to check for from the list 7 When performing conflict analysis using multiple source packages and one or more target...

Page 1113: ...he specified transform if selected or in the original package By selecting the Perform resolutions against a transform file option in the Resolution tab of the Options dialog box you can set the defau...

Page 1114: ...pplication Catalog Identifying Conflicts with an External Package The ConflictSolver Wizard allows you to run conflict checks against external MSI packages and packages imported into the ConflictSolve...

Page 1115: ...click on it to view that row s associated table The Tables View is launched and the table and or table cells that are causing the problem are highlighted in red If a row is grayed out it indicates th...

Page 1116: ...Select the Conflict Rules that you want to evaluate in conflict analysis By default the Conflict Rules ACEs that are selected on the Rules tab of the Options dialog box will be selected 13 Click Next...

Page 1117: ...uct The Summary view displays an overall summary of the conflicts identified including the products this product was checked against for conflicts the ACE rules used and resolution options You can cha...

Page 1118: ...ask To delete persisted conflict data from a package 1 Right click on the package in the Product View point to Delete and select Persisted Conflict Information 2 Confirm the deletion Conflict Persiste...

Page 1119: ...t You can resolve these conflicts by clicking Resolve or Resolve All on the Conflicts View However the Conflict Resolution Process differs depending upon options you select on the Resolution Tab of th...

Page 1120: ...tion requires that the package be modified if a package is stored in the Software Repository and is currently checked out by another user it cannot be modified and therefore cannot be resolved This re...

Page 1121: ...ACE18 ACE19 and ACE20 You first need to view conflicts identified and then select to resolve them Table 13 7 Resolved Package Re Import Options Resolved Packages Re import Options Package in Software...

Page 1122: ...n will proceed Make a selection and click OK to continue Note CARDs can be resolved in multiple ways if the Maximize user flexibility in selecting resolutions option is selected on the Resolution tab...

Page 1123: ...lick OK to close the Options dialog box With this setting disabled all conflict resolutions are by default performed directly on the base Windows Installer package In either case you can override this...

Page 1124: ...entified all accessible from the Reports menu The included reports are Table 13 9 Pre Defined Reports List Reports Description Package Provides a report including the following information Product Inf...

Page 1125: ...es created or changed by the package These registry entries are also listed on the Registry View for that package Crystal Reports The following reports in Crystal Report format are available Crystal R...

Page 1126: ...nflicts found during the most recent Conflict Wizard execution or the most recent import if conflict identification was performed These conflicts are also listed on the Conflicts View for that package...

Page 1127: ...orts Format Three Crystal Reports are shipped with AdminStudio Conflicts Provides a report of all conflicts found during the most recent Conflict Wizard execution or the most recent Import if conflict...

Page 1128: ...ollowing steps Step 1 Creating an ODBC File DSN Step 2 Creating the Base Report Step 3 Configuring Basic Settings Step 4 Creating Page Column Headings Step 5 Adding Database Fields Step 6 Adding Param...

Page 1129: ...ckage 9 Create a link between Component and Package table by dragging the PackageCode field from the Component table and dropping into the PackageCode field in the Package table 10 Click OK on the Vis...

Page 1130: ...copy it press Ctrl V and drop the mouse adjacent to the first text object Change the text from Product to Component 4 Repeat the above step and add the columns named File Name Path INI Section INI Ke...

Page 1131: ...rameter named ProductVersion of type String 5 Click Close ConflictSolver automatically passes values for these parameters In ConflictSolver when the report is selected from the main menu item these pa...

Page 1132: ...ewing the report The above formula also filters the Application Catalog records based on the IniFile FileName and if ProductName ProductVersion are passed they are used else only the IniFile FileName...

Page 1133: ...lictSolver to identify conflicts between Windows Installer based setups and between Windows Installer based setups and operating system images OS Snapshots ConflictSolver can automatically solve some...

Page 1134: ...ACE13 Table 13 12 ACE Index ACE Rule Rule Type Conflict Type Brief Description of ACE ACE02 Conflict Component Checks to see if components in different packages that have matching ComponentIds also h...

Page 1135: ...ld import all merge modules you are likely to use at your organization ACE13 Conflict Shortcuts Checks for the existence of the same shortcut within different packages in components with different Com...

Page 1136: ...packages but the file has a different size version or language ACE23 fails ACE24 Conflict Registry Checks to see if registry entries with the same registry hive key and value name have the same data...

Page 1137: ...es action ACE35 Best Practice Recommende d Rules Checks to see if data exists in the RemoveRegistry MSI table that is not being executed with an associated RemoveRegistryValues action ACE36 Best Pract...

Page 1138: ...he component COMPONENT1 in the package PACKAGE1 are either new to or missing from the component COMPONENT1 in the package PACKAGE2 Summary Table 13 13 ACE02 Summary Topic Description Conflict Type Con...

Page 1139: ...se Delete from the menu d If you need to add a new file to match the other component right click anywhere in the Files list choose Add from the menu and add the correct file 3 Select Save As from the...

Page 1140: ...s Description Checks to see if components that have NULL KeyPath values are valid by checking for an entry for the component in the CreateFolder table Result If a component does not have a key file an...

Page 1141: ...they originated in a merge module Table 13 17 ACE06 Summary Topic Description Conflict Type Best Practice Rule Components Description Checks whether the executable module EXE DLL OCX HLP CHM TLB SYS o...

Page 1142: ...ILENAME is identical and installed by merge modules in both the component COMPONENTNAME in the package PACKAGENAME and the component COMPONENTNAME in the package PACKAGENAME but the components have di...

Page 1143: ...hey originated in a merge module See table above Resolution Type Automatic CARD07 only if both the source and target files originated in a Merge Module For all other errors confirm the error by runnin...

Page 1144: ...ied a Expand the listing under the component and select Files The list of files included with that component is displayed b To delete a file with the wrong version select the file right click and choo...

Page 1145: ...using the conflict and select the new merge module in its place 5 Select Save As on the File menu and save the changes as a Windows Installer Transform mst file 6 Open ConflictSolver and reimport this...

Page 1146: ...ally if an ACE10 error is valid but consider checking the Registry Value field as its contents may prove useful in helping you decide Resolution This conflict requires a manual resolution Follow these...

Page 1147: ...log database Before running ACE12 you should import all merge modules you are likely to use at your organization into the Application Catalog database ACE12 reports an Error if the file in question or...

Page 1148: ...is displayed 4 Select the file that was displayed in the error message right click and select Delete from the menu 5 Take note of the feature that the component is associated with and then navigate t...

Page 1149: ...nd find the component that needs to be modified by referring to the component name displayed in the error message 3 In the Component s Property grid change the value in the Component Code field to mat...

Page 1150: ...file INI_FILE_NAME in the component COMPONENT1 in the package PACKAGE1 conflicts with the same INI file entry in the component COMPONENT1 in the package PACKAGE2 Summary Cause The same INI file is fou...

Page 1151: ...he other package 4 Select Save As on the File menu and save the changes as a Windows Installer Transform mst file 5 Open ConflictSolver and reimport this package with its newly created transform file...

Page 1152: ...onent that needs to be modified by referring to the component name displayed in the error message 3 In the Component s Property grid change the value in the Component Code field to match the Component...

Page 1153: ...ent ComponentIds The ACE17 Error String is displayed in the following format The verb VERB_NAME in extension EXTENSION_NAME in the component COMPONENT1 in the package PACKAGE1 conflicts with the same...

Page 1154: ...for the Component Name displayed in the conflict c Once the entry is found take note of the value displayed in the ComponentId column This is the Component Code that should be used for the component...

Page 1155: ...see if it is unique The ACE20 Error String is displayed in the following format The upgrade code UPGRADE_CODE in the package PACKAGE1 is the same as the upgrade code in the package PACKAGE2 Summary T...

Page 1156: ...the possibility that conflicts will not be detected Summary Cause An entry in the IniFile table of the first MSI package duplicates a file name in a component in the File table of the second MSI packa...

Page 1157: ...he File menu and save the changes as a Windows Installer Transform mst file 5 Open ConflictSolver and reimport this package with its transform file into your Application Catalog and then use the Confl...

Page 1158: ...ng data from the INI File Changes View In order to retrieve the INI file from the other MSI package you may need to extract it from the MSI file itself or a cabinet file if the files are not uncompres...

Page 1159: ...ted as either source or target packages However if you specify only Marimba NCP or OS Snapshot files as your source packages ACE23 and ACE24 will be the only ACEs that you can select on the Summary Pa...

Page 1160: ...en navigate to the Components view and select the component that contains the file causing the conflict In order to quickly find the component name go to the File Table via the Direct Editor view and...

Page 1161: ...eld Editor 2 Once the project is open navigate to the Registry view and find the registry value causing the conflict Replace that value with the same registry value and data type found in the target p...

Page 1162: ...rted into the Application Catalog It is recommended that all Merge Modules be imported into the Application Catalog Note ACE26 and ACE36 optional Best Practice ACEs both check for conflicts with Merge...

Page 1163: ...r InstallExecuteSequence table Summary Table 13 38 ACE26 Summary Topic Description Conflict Type Best Practice Rule Merge Module Integrity Description Checks the Merge Modules in a package to confirm...

Page 1164: ...ge any hard coded paths in the Value field of the Environment table to relative paths Resolution Consider whether a DuplicateFiles or RemoveDuplicateFiles action is needed for your InstallExecuteSeque...

Page 1165: ...OMPONENT_NAME component in SOURCE_PRODUCT_NAME is installing the SOURCE_PATH_NAME SOURCE_KEYPATH_FILE file which is also being installed by TARGET_PRODUCT_NAME with a different ComponentId More precis...

Page 1166: ...ct Type Conflict Rule Components Description Checks for KeyPath conflicts across components It identifies components with different ComponentIDs installing the same key file to the same directory Resu...

Page 1167: ...hange any hard coded paths in the Value field of the Registry table to relative paths Resolution Consider whether a MoveFiles action is needed for your InstallExecuteSequence table If so open the MSI...

Page 1168: ...n the RemoveIniFile MSI table that is not being executed with an associated RemoveIniFiles action The package contains data RemoveIniFile in the RemoveIniFile table but not the necessary actions to us...

Page 1169: ...pe Best Practice Rule Recommended Rules Description Checks to see if data exists in the RemoveIniFile MSI table that is not being executed with an associated RemoveIniFiles action Result If a package...

Page 1170: ...the ModuleSignature table while ACE36 checks the ModuleDependency table These ACEs are provided to encourage you to import Merge Modules into the Application Catalog and by doing so improve the effec...

Page 1171: ...splayed in the following format The product PRODUCT_NAME VERSION is currently configured to be installed as per user This value affects deployment of this package in a terminal server environment Summ...

Page 1172: ...ment then you do not need to run this ACE WTS03 checks for any file entries installed to per user specific locations The WTS03 warning string is displayed in the following format The component COMPONE...

Page 1173: ...VERSION has a per user ODBC Data Source NAME VALUE This value affects deployment of this package in a terminal server environment Summary Result If any file entries are installed to per user specific...

Page 1174: ...tSolver you can also create your own company specific business rules to use when detecting conflicts For example your organization may want to identify and change any VBScript custom actions that have...

Page 1175: ...mple you could use a Source and Target Packages ACE to determine if the installation of a Source package onto a Target system would overwrite or conflict with an existing entry in the ini file in the...

Page 1176: ...urce and Target Packages ACE Creating a User Provided DLL Based ACE Creating a Custom Source Only Packages ACE You can create a user defined ACE to apply to Source Only Packages One common task you ma...

Page 1177: ...then inserted into the string in the following format ColumnName The Token list is provided for your convenience if you prefer you can type the tokens directly in the text boxes You could also use the...

Page 1178: ...user created ACE is now available for use in subsequent conflict identification Creating a Custom Source and Target Packages ACE You can create a custom ACE to apply to Source and Target Packages For...

Page 1179: ...the Source or Target package Note If no prefix is used ConflictSolver assumes the Source prefix You can also use the Target ProductName and Source ProductName pseudo tokens to insert the name of the S...

Page 1180: ...e not limited to the formatting options that the Expression Builder provides to you If you know how to write Where clauses in SQL you can use significantly more powerful expressions by entering them d...

Page 1181: ...e to exit the Rules Viewer This new Custom ACE is now available for use in subsequent conflict identification Creating a User Provided DLL Based ACE To demonstrate how to create a DLL Based ACE an ACE...

Page 1182: ...Task To create a DLL Based ACE 1 Launch Windows Explorer and navigate to the following directory AdminStudio Installation Directory ConflictSolver ACESDK 2 Copy this folder and its contents and store...

Page 1183: ...ble for use in subsequent conflict identification Editing User Defined ACEs Task To edit a user defined ACE 1 From the Conflicts menu select Rules Viewer The Rules Viewer dialog box opens 2 Select the...

Page 1184: ...ry will be removed when you close the Rules Viewer dialog box Viewing ACE Metrics When ACEs are run ConflictSolver generates metrics and logs them in the AceLog txt file located in the following direc...

Page 1185: ...kgRowID_ 5 AND ft PkgRowID_ IN 4 Records returned 0 Query Time 0 10 seconds Time taken to execute ACE07 0 74 seconds ACE08 SELECT cs Component AS SrcComponent fs RowID AS SrcRowID ft RowID AS TargetRo...

Page 1186: ...Application Conflict Evaluators ACEs when conflict detection is performed Before a CARD is run you are given the opportunity to review how the CARD will resolve the conflict and decide whether or not...

Page 1187: ...omponents that have NULL KeyPath values are valid by checking for an entry for the component in the CreateFolder table A CreateFolder entry is created for the component CARD05 for ACE05 Checks for the...

Page 1188: ...ory_ column with a run time translation of the targets component csFullPath path MsiDBUtils GetDirectoryTargetPathKey SELECT Directory_ FROM Component WHERE ComponentId Source ComponentId CARD04 Confl...

Page 1189: ...D06 resolves ACE06 which checks whether the executable module EXE DLL OCX HLP CHM TLB SYS or DRV within the component is the key file If the executable module is not the key file ACE06 fails Resolutio...

Page 1190: ...Id from the target package SELECT ComponentId FROM Component WHERE Component Source Package ComponentId CARD18 Conflict CARD18 resolves ACE18 which checks the Package Code to see if it is unique If th...

Page 1191: ...he Details pane and the Output Window Both the ConflictSolver Navigation window and the Output Window are dockable Navigation window The ConflictSolver Navigation window consists of two tabs the Produ...

Page 1192: ...ion Catalog Catalog Disconnect Closes the currently open Application Catalog Catalog Remove Catalog Properties View Application Catalog properties Catalog Log Out Catalog Exit Closes ConflictSolver Ed...

Page 1193: ...ch Conflicts Resolve External Package Conflicts F6 Displays the Conflict Resolution dialog box through which you resolve conflicts discovered by ConflictSolver between an external package and packages...

Page 1194: ...ary and displays the Index tab Help Search Launches the online Help Library and displays the Search tab Help Support Central Connects to the AdminStudio Support Web site Help Web Community Connects to...

Page 1195: ...d Application Manager Product Views Table 13 59 ConflictSolver and Application Manager Product View Icons Name Icon Description Application Catalog The Application Catalog that you are connected to Wh...

Page 1196: ...ch files associated with a product is either missing from the original import directory or its last modified date does not match the last modified date stored in the Application Catalog When this icon...

Page 1197: ...or Files Components Click to display the Files View or the Files and Components View listing all of the files and components in the MSI package merge module OS snapshot or NCP file Click to display th...

Page 1198: ...menu Table 13 60 ConflictSolver Group Context Menu Commands Command Description Conflict Wizard Launches the Conflict Wizard directly to the Target Information Panel Patch Impact Analysis Wizard Laun...

Page 1199: ...plication Catalog Scan for Dependencies If dependency information has not already been generated by the Patch Impact Analysis Wizard select this option to generate dependency information for an MSI pa...

Page 1200: ...hes the Patch Impact Analysis Wizard which you can use to identify conflicts between Microsoft patches and packages and OS Snapshots in your Application Catalog Generate Report Select to generate a Pa...

Page 1201: ...Error Information Conflicts Tab After the Conflict Wizard is run to identify conflicts between a Windows Installer package and packages already cataloged in ConflictSolver or if conflicts are checked...

Page 1202: ...es version 6 0 72 9589 of the same file If you double click on a row in this window the conflicting file on the target product that is being impacted by the patch will be displayed and highlighted in...

Page 1203: ...bed database the name of that database is listed here If it is not the following statement appears Not associated with any subscribed database Conflict Results If any persisted conflict data exists th...

Page 1204: ...g nodes are listed Figure 13 2 Product View Nodes When you select one of these nodes a constituent view opens in the right pane Conflicts View Validation View Test Results View Patch Impact View Produ...

Page 1205: ...ve been deleted from ConflictSolver since conflict identification The number of packages that have been imported into ConflictSolver since conflict identification Table 13 67 Conflicts View Summary In...

Page 1206: ...in the list Run Again and Reimport Buttons Click Run Again to perform conflict identification on the package again using the specified packages if they still exist in ConflictSolver and ACE rules Bec...

Page 1207: ...pear prompting for approval or additional information If the Preview and approve all resolutions option is selected the Resolution Details dialog box appears listing the changes that are going to be m...

Page 1208: ...e column title Viewing ICE Error Information To easily view the full text of the ICE error description select an ICE Error or Warning number and then select Properties from the context menu The Proper...

Page 1209: ...Summary View The information displayed on the Patch Impact View is dependent upon the selection made in the Impact category list The Summary View which is displayed when Summary is selected from the I...

Page 1210: ...If the Only Display View Nodes With Data option on the ConflictSolver Options Dialog General tab is selected if you scan for dependencies and no dependencies are found the Dependencies node will stil...

Page 1211: ...bles View The Tables view provides a way to view the data for a given package in the Application Catalog Select the specific table you want to view from the Tables list at the top of the view Most tab...

Page 1212: ...ased setup files in the Product View details about that setup are displayed in the right pane of the user interface The following information is included Table 13 73 OS Snapshot View Information Field...

Page 1213: ...sting of the individual files making up the setup are listed allowing you to view or delete files by making a selection from the context menu To view the contents of a file select View from the contex...

Page 1214: ...group in the Patches tab is selected The Patches Group View lists all groups that have been created in the Patches tab All new patches are imported into the New Patches group and then you can organiz...

Page 1215: ...hes tab is selected All new patches are imported into the New Patches group You can then organize the patches into other groups according to your business needs See Organizing Your Application Catalog...

Page 1216: ...the Title Summary and Release Date of the patch Context Menu Options When a group other than the root group or the New Patches group in the Patches Tab is selected the following items are available on...

Page 1217: ...t from its current location and paste it into another location Copy Copy the selected patch to the clipboard so that you can paste a copy of it into another location Paste Insert the patch on the clip...

Page 1218: ...mpact Information Dialog Box is provided which lists information on individual tabs for each of the categories If a category does not include any products its tab is not displayed Click Run Again to r...

Page 1219: ...Box Resolution Operations Dialog Box Resolution Options Dialog Box Rules Viewer Dialog Box About ConflictSolver Dialog Box The About InstallShield ConflictSolver dialog box can be accessed by selecti...

Page 1220: ...s including the Output Window the Rules Viewer dialog box and the Conflicts tab of the Options dialog box Associated Table Select the table in the Application Catalog which will be queried in the user...

Page 1221: ...use a user defined ACE to identify packages that create a desktop icon To define a user defined ACE you use an SQL Where clause Custom Source and Target Packages ACEs allow you to compare columns or...

Page 1222: ...ting desktop icon Note Tokens allow you to insert values at run time from the installation package into the string such as specifying a file name To use token replacement in the error string use the a...

Page 1223: ...erformance enclose table names in square brackets DLL Information Tab From the DLL Information tab you can edit specific information about the ACE CARD DLL file and the ACE and CARD Function Names tha...

Page 1224: ...ACE Rules tab selected The dialog box contains the following tabs which are only displayed if they have data Note This dialog box is similar in function to the Patch Impact Information dialog box Conf...

Page 1225: ...t on which conflict identification was performed The date and time of the last conflict identification The number of conflicts detected The number of detected conflicts which can be resolved automatic...

Page 1226: ...alog boxes could appear prompting for approval or additional information If the Preview and approve all resolutions option is selected the Resolution Details Dialog Box appears listing the changes tha...

Page 1227: ...en the Properties dialog box select an ICE on the Validation View and select Properties from the context menu The full Description of the ICE is displayed along with the ICE number You can add a comme...

Page 1228: ...tion Panel Select the table column used in this Where clause Comparison Operator Pick an operator to use for comparison in the Where clause You can pick from the following Equal To Not Equal To Greate...

Page 1229: ...ns Dialog Box The Options dialog box accessible by selecting Options from the Tools menu provides a way to configure how ConflictSolver handles validation and conflict identification as well as some g...

Page 1230: ...dio buttons to toggle the ACE tree listing between Conflict ACEs and Best Practice ACEs Show best practice rules Show conflict detection rules In both the Conflict ACE and Best Practice ACE trees if y...

Page 1231: ...ictSolver will generate a unique displayed product name and allow the import to proceed without prompting the user The identifiers you can select on the Duplicate Package Tab are as follows Table 13 8...

Page 1232: ...box ConflictSolver will not identify these two packages as duplicate even though they have the same ProductCode because they have a different set of transformations Therefore the Product Name Change d...

Page 1233: ...ute Description File Each new Application Catalog automatically points to this file and displays the name and location of the file in this tab Note You can also configure ConflictSolver to integrate w...

Page 1234: ...ectory specified for Crystal Reports reports You can directly enter the path or use the Browse button to select it Reports must be in Crystal Report rpt format Turn off display of conflict detection a...

Page 1235: ...olve any errors that are found Import Binary Data Binary data in the package will be imported Import Custom Tables By default custom Windows Installer tables will be imported into ConflictSolver Table...

Page 1236: ...n Process for more information Maximize user flexibility in selecting resolutions Some CARDs can resolve a conflict in more than one way For example ACE06 checks whether the executable module within t...

Page 1237: ...m being used during validation meaning that all of the ICEs in the default CUB file will be used except those entered in the ICE Rules field MSM Input Files There are two options that you can configur...

Page 1238: ...cords you want to save for each package Import Reimport Specify whether to log and whether to display an entry each time a package is imported or reimported Validation Specify whether to log and wheth...

Page 1239: ...this option is not selected this dialog box does not appear If you do not want this dialog box to appear select the Don t show this dialog again check box on the dialog box This is equivalent to unse...

Page 1240: ...nabled When you click Edit the ACE Rule Properties Dialog Box appears where you can reconfigure the ACE You can also delete user defined ACEs by selecting them and clicking Delete Wizards The followin...

Page 1241: ...Services File Extensions and Product Properties The Conflict Wizard consists of the following panels Welcome Panel Source Type Panel MSI Source Information Panel Source Package Panel Choose Action Pa...

Page 1242: ...form file from the Transforms list by selecting the transform and clicking the Delete button Source Package Panel When you select the Internal Application Catalog package option on the Conflict Wizard...

Page 1243: ...are selected on the Rules Tab of the Options dialog box will be selected The following Best Practice ACE rules are available Table 13 98 Choose Action Panel Options Options Description Evaluate sourc...

Page 1244: ...kages in ConflictSolver that you want to compare the source package s against Each package selected will be compared against the packages you specified in the Source Package Panel for internal compari...

Page 1245: ...ected in the previous panels of the Wizard Click Finish to run the Conflict Wizard using the options specified Rules Wizard The Rules Wizard allows you to create user defined ACE rules for later use b...

Page 1246: ...ueried in the user defined ACE This also determines which columns are available in the Expression Builder dialog box and which tokens are available for the Error and Display strings on the Custom Opti...

Page 1247: ...ges ACE to determine if the installation of a Source package onto a Target system would overwrite or conflict with an existing entry in the ini file in the System directory of the Target system To def...

Page 1248: ...Packages ACEs Source ColumnName and Target ColumnName For more information see Token Grammar Display String This string appears in the Conflict Details area of the Conflicts View after conflicts have...

Page 1249: ...if you initially select a Rule Type of Custom Source and Target Packages and then insert tokens in the Error String and Display String fields the Source prefix will be used But before you finish creat...

Page 1250: ...n for final review Click Finish to accept this configuration and make the ACE available for conflict identification Click Back to return to either the Where Clause Panel or the DLL Based ACEs Panel Va...

Page 1251: ...n to locate the transform If the package requires multiple transforms you can repeat the procedure as necessary The order in which transforms are applied can be changed by selecting a transform and cl...

Page 1252: ...Chapter 13 Identifying and Resolving Application Conflicts Using ConflictSolver ConflictSolver Reference 1252 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1253: ...r requirement PackageExpert s tests are currently organized into two major categories ICE Tests The ICE tests perform checks against the structure of a Windows Installer package to enforce Microsoft b...

Page 1254: ...with installation requirements of the Windows Vista operating system and are intended to enable the successful deployment of packages on Vista In addition you can add your own XML based manual tests...

Page 1255: ...ase Step 2 Run Tests Select a package or group folder and select Test Package from the context menu Step 3 Resolve Errors PackageExpert can automatically resolve some errors while others require you t...

Page 1256: ...solution Method Setting Default Test Configuration On the Configuration view you specify which tests you want PackageExpert to run for all subsequent test runs These settings can be changed at any tim...

Page 1257: ...arrow next to the menu item and select Configuration from the list 2 Select the tests that you want PackageExpert to run for subsequent test runs Tip You can select or unselect all of the tests in a...

Page 1258: ...ackageExpert and ConflictSolver and can customize those results by excluding errors or changing the severity of errors Testing Packages You can use PackageExpert to test packages that are stored on a...

Page 1259: ...ffect the package s underlying Windows Installer file it is not deleted To test a package that is stored on a local file system perform the following steps Task To test an external package 1 Select th...

Page 1260: ...ially numbered are listed under the Test Category node To view specific information about an error message select it and view the Error Details in the right pane For more information on test results s...

Page 1261: ...that is found a message node is listed under the appropriate Test Category node If one test finds more than one file or component in the package that produces an error multiple message nodes sequenti...

Page 1262: ...t the package that you want to test point to Test and select one of the following options from the context menu Test Select to have PackageExpert test the package but not resolve the automatically res...

Page 1263: ...t Results You can view test results in both PackageExpert and ConflictSolver In PackageExpert you can change the severity of a message exclude messages from the listing and add ad hoc test results For...

Page 1264: ...found a message node is listed under the appropriate Test Category node Figure 14 5 Nodes in the PackageExpert Test Resolve View If one test finds more than one file or component in the package that p...

Page 1265: ...Selected When a message node is selected Error Details for that error message are displayed in the right pane Additional details about the test are provided as is a link to a help topic explaining th...

Page 1266: ...age View When a package is selected in the package tree the test results for all Test Categories are displayed and are listed in the order of severity Group View When a group in an Application Catalog...

Page 1267: ...nnected to an Application Catalog two graphics illustrating the following statistics appear Percentage of Application Catalog Tested The percentage of the number of packages in the Application Catalog...

Page 1268: ...g Packages and Viewing Results 1268 ADS 0950 UG00 AdminStudio 9 5 User Guide Test Category View When a Test Category node is selected test results for all of the tests in that category are listed and...

Page 1269: ...message node in the package tree is selected detailed information on that specific message is displayed in the top half of the pane including the exact text of the selected error message and a help t...

Page 1270: ...same location as the msi file When testing an Application Catalog package you can choose to publish the package s test results in the local xml file to the Application Catalog Task To publish test res...

Page 1271: ...ct from an Application Catalog and reconnect to it during the same PackageExpert session You can choose to publish the test results for all packages or only those packages that you select Toggling Bet...

Page 1272: ...ndicate the mode you chose Viewing Test Results in ConflictSolver You can test packages from the ConflictSolver interface and view a summary of the results in the Test Results view The Test Results vi...

Page 1273: ...list of messages can be filtered by All Ran No Error Ran or Resolved by making a selection from the View list Deleting Test Results You can delete a package s local test results and for packages in t...

Page 1274: ...at your organization by changing the severity of messages and by suppressing the display of a specific instance of an error Changing the Severity of a Specific Error Suppressing the Display of Specif...

Page 1275: ...verity of a message is presented in the following topics Changing the Severity of a Message Editing a Result Filter Deleting a Result Filter Changing the Severity of a Message To change the severity o...

Page 1276: ...ty that you want to change this message to Error Warning or Information 3 In the Description box enter an explanation for why you changed the severity level of this message 4 Click Save This error now...

Page 1277: ...lowing steps Task To edit an existing filter 1 In the PackageExpert toolbar click the down arrow next to the second menu item and select Filter The Filter view opens listing all of the defined severit...

Page 1278: ...severity level or will return to the list after being excluded perform the following steps Task To delete a result filter and reset to original severity 1 In the PackageExpert toolbar click the down a...

Page 1279: ...that test For example suppose the ISICE07 test produced five error messages You consider messages 1 2 4 and 5 to be valid errors However suppose that message 3 concerns a particular component of the p...

Page 1280: ...e Test Resolve view select the specific message that you want to suppress and select Filter Result from the context menu The Test Result Filter Editor dialog box opens 2 From the Filter Severity list...

Page 1281: ...owing steps Task To edit an existing filter 1 In the PackageExpert toolbar click the down arrow next to the second menu item and select Filter The Filter view opens listing all of the defined Exclude...

Page 1282: ...econd menu item and select Filter The Filter view opens listing all of the defined exclusion filters in the Exclusion List 2 Select the filter that you want to delete and click Delete You are prompted...

Page 1283: ...Custom Test Results Editor dialog box the new message will be displayed in the package tree and will be documented in the Error Details area in the right pane as shown in the following Figure Figure...

Page 1284: ...ill be listed in the Category list You can create a new category by entering a category name in the Category box 4 In the Name list either enter a new name for the test or if the same test has generat...

Page 1285: ...ed in Specifying the Resolution Method You can choose to resolve all errors for a package all errors in a Test Category or just one specific error Task To automatically resolve errors 1 In the Test Re...

Page 1286: ...ckageExpert you can add a Manual Test to the package tree by creating an xml file and placing it in the PackageExpert installation directory By adding Manual Tests to Package Expert you can document i...

Page 1287: ...ual Test Figure 14 17 Manual Test Selections on the Context Menu When you select Perform Manual Test the instructions defined in the xml file are listed on the Manual Test Perform dialog box As you pe...

Page 1288: ...n and monitor whether these tests are performed A Manual Test is an xml file that contains both instructions or links to those instructions on exactly how to perform a Manual Test to evaluate the qual...

Page 1289: ...ns referencing a local file Direct images info gif Direct Step Steps Perform Resolve Incomplete state Ran severity Warning The Example test resolution process is incomplete Incomplete Complete state R...

Page 1290: ...Resolve view and open a package in PackageExpert 4 Select the Desktop Icons node and select Perform Manual Test from the context menu The Manual Test Perform dialog box opens listing the manual steps...

Page 1291: ...s The test resolution process is complete and the desktop icons removed Sample Manual Test PackageExpert includes two sample Manual Tests Example of a Manual Test The Desktop Icons Manual Test is a fu...

Page 1292: ...ncomplete state Ran severity Warning The Example test resolution process is incomplete Incomplete Complete state Resolved severity Informational The Example test resolution process completed successfu...

Page 1293: ...the beginning and the end of the steps that have to be completed to perform this test Step Marks the beginning and the end of each step in this test Resolve Marks the beginning and the end of the inst...

Page 1294: ...Expert Home Page If no packages are open the initial view of the PackageExpert interface is the PackageExpert Home page On the Home Page the following quick links are provided Open a Package Open a Wi...

Page 1295: ...t are currently open as listed under the File System node Note When you open a package under the File System node it remains open through multiple PackageExpert sessions until you explicitly remove it...

Page 1296: ...the Configuration View where you specify which tests you want to run for all subsequent test runs Filter Select to open the Filter View where you can edit or delete existing filters Options Select to...

Page 1297: ...iews Configuration Select to open the Configuration View where you specify which tests you want to run for all subsequent test runs Filter Select to open the Filter View where you can edit or delete e...

Page 1298: ...est results in this category include at least one message with a status of Error Test Category With Warnings Test results in this category includes at least one message with the status of Warning and...

Page 1299: ...e package tree 2 Right click point to Test Results and click Local on the context menu Out of Sync Package This package is in an Application Catalog and PackageExpert is currently displaying the Packa...

Page 1300: ...ear in the Output Window Figure 14 21 Test Execution Messages in the PackageExpert Output Window Table 14 10 PackageExpert Run Status Status Description Ready No tests or automated resolutions are cur...

Page 1301: ...pon what is selected in the package tree File System Node Selected Package Selected Group Selected Application Catalog Selected Test Category Selected Message Node Selected File System Node Selected W...

Page 1302: ...in that group are displayed Figure 14 22 Group Summary Information Table 14 13 Test Resolve View Package Selected Item Description Package Name The name of the selected package is displayed in the ba...

Page 1303: ...talog node is selected and you are connected to an Application Catalog summary information about the Test Results of the packages in the Application Catalog are displayed Figure 14 23 Application Cata...

Page 1304: ...st is checking for and how errors are resolved Figure 14 25 Message Node Detailed Information Configuration View On the Configuration view you specify which tests you want to PackageExpert to run for...

Page 1305: ...lusion List From the Filter view you can Edit or Delete an existing filter Note Filters are created by selecting a test result in the Test Resolve view and selecting Filter Result from the context men...

Page 1306: ...owing dialog boxes Connect Application Catalog Dialog Box Custom Test Results Editor Dialog Box Manual Test Perform Dialog Box Manual Test Resolve Dialog Box Select a Package Dialog Box Test Result Fi...

Page 1307: ...ows the AdminStudio Administrator to configure the default Application Catalog and then subsequent installations of AdminStudio will automatically connect to the default Application Catalog if they us...

Page 1308: ...log Server Authentication Choose to use SQL Server login identification for authentication Login ID and Password If you chose Server Authentication enter the appropriate Login ID and Password Catalog...

Page 1309: ...on the Custom Test Results Editor dialog box enter the following information Table 14 16 Custom Test Results Editor Dialog Box Options Option Description Category Either enter a new name for a test c...

Page 1310: ...4 27 Example of a Message Added to Document Ad Hoc Testing When you click Save on the Custom Test Results Editor dialog box the new message will be displayed in the package tree and will be documented...

Page 1311: ...erform dialog box come from the XML file associated with this Manual Test As you manually perform each listed step you then right click on the step and set its status to either Pass or Fail See Adding...

Page 1312: ...Resolve dialog box come from the XML file associated with this Manual Test The first time you open this dialog box all of the steps are marked Incomplete Perform each of the listed steps marking each...

Page 1313: ...s to change it Description Contains the instructions for performing this resolution procedure Save Click to save the status changes that you have made Table 14 19 Select a Package Dialog Box Options O...

Page 1314: ...to modify and selecting Filter Result from the context menu Note You are filtering a specific instance of a message generated by a test not all messages generated by that test For example suppose the...

Page 1315: ...r Select to identify this test result as a problem that would cause incorrect behavior when this package is installed or used Warning Select to identify this test result as a problem that could cause...

Page 1316: ...Chapter 14 Identifying and Resolving Package Errors Using PackageExpert PackageExpert Reference 1316 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1317: ...is presented in the following sections Table 15 1 OS Security Patch Wizard Patch Impact Analysis Wizard Help Library Section Description About Microsoft Operating System Patches Explains what Microsof...

Page 1318: ...ies as A flaw in a product that makes it infeasible even when using the product properly to prevent an attacker from usurping privileges on the user s system regulating its operation compromising data...

Page 1319: ...letin Summary lists each patch released that month grouped by status level with a link to each patch s associated Security Bulletin as shown in the following figure Figure 15 2 Microsoft Security Bull...

Page 1320: ...rd to import Microsoft operating system patch information into the AdminStudio Application Catalog When you select the patch to import you are prompted to review the imported data and to add informati...

Page 1321: ...system patch files that you want to import into the Application Catalog perform the following steps Task To identify and download Microsoft OS patch files 1 Open the Microsoft Security Bulletin Summa...

Page 1322: ...minStudio 9 5 User Guide 2 Expand the listing of the patch status that you want to review In this example if you expanded the Critical status the following Executive Summary of Microsoft Security Bull...

Page 1323: ...Patches AdminStudio 9 5 User Guide ADS 0950 UG00 1323 In the Security Bulletin the Affected Software table lists the software affected by this patch and provides a link to the download page for that...

Page 1324: ...page opens Importing a Microsoft Operating System Security Patch Into the Application Catalog To import a Microsoft operating system security patch file into the Application Catalog perform the follo...

Page 1325: ...de patch the Patch File Branch Selection panel opens Continue with Step 5 below If the patch you are importing is not a dual mode patch the Patch Bulletin Information panel opens Skip to Step 7 below...

Page 1326: ...log Associated KB Article The KB article number is extracted from the patch file and automatically entered in this field Important The Knowledge Base article identification information is used by Appl...

Page 1327: ...he Branch listed in this column is the name of the patch s INF file minus its extension Because all obvious identifiable information within the INF file like Name is often identical this Branch inform...

Page 1328: ...sis 1 On the ConflictSolver Patches tab select Patch Impact Analysis Wizard from the Conflicts menu or select a patch and select Patch Impact Analysis Wizard from the context menu If you had a patch s...

Page 1329: ...ducts you select here against the patches you selected on the Source Patches Panel for impacts You can use the Select All or Clear All buttons to make your selections 8 Click Next The Summary Informat...

Page 1330: ...version 5 1 2600 1361 of RPCRT4 dll an operating system file and Corel Draw Coreldraw 12 0 0 458 v1 0 installs a file that is dependent upon the same operating system file RPCRT4 dll Therefore this wa...

Page 1331: ...ver or Application Manager and click the Patches tab The All Patches View opens 2 Expand the listing All of the patches that have been imported into the Application Catalog are listed Newly imported p...

Page 1332: ...n the ConflictSolver Dependencies View which is accessed by selecting the Dependencies node under a product in the Product View you can view a list of all of the files of a selected product that have...

Page 1333: ...ssociated Patches View the Patch View on the Patches tab for that patch opens listing general information on the selected patch See Viewing Patch Content Information for more information Viewing Patch...

Page 1334: ...entified Task To view patch impacts 1 Launch ConflictSolver and click the Patches tab The Patches Group View opens 2 Select the patch that you want to examine The Patch View for that patch opens 3 Exp...

Page 1335: ...iendly Task To generate a Patch Report 1 Launch ConflictSolver or Application Manager and click on the Patches tab The Patches Group View opens 2 Expand the patch listing and select the patch that you...

Page 1336: ...etermine how specific MSI packages or OS Snapshots would be affected when a Microsoft OS patch is installed The Patch Impact Analysis Wizard consists of the following panels Welcome Panel OS Snapshot...

Page 1337: ...are included Source Patches Panel On the Source Patches Panel you select the patches that you want to include in your analysis The following options are included Table 15 4 OS Snapshot Panel Options...

Page 1338: ...The OS Security Patch Wizard consists of the following panels Welcome Panel Patch File Selection Panel Patch File Branch Selection Panel Patch Bulletin Information Panel Patch Properties Click to acce...

Page 1339: ...t Operating System Patch Files Microsoft operating system patches can be downloaded from the Microsoft TechNet Security Center at http www microsoft com technet security default mspx When you click Ne...

Page 1340: ...ely identify each patch branch On the Patch File Branch Selection panel the following information is listed for each branch of the patch Table 15 7 Information Displayed for Each Branch of a Dual Mode...

Page 1341: ...data that was extracted from the patch file Review and edit the information and click Next to continue The following information is included File Count Number of files included in the patch Registry C...

Page 1342: ...s the Patch Properties dialog box from several locations Source Patches Panel of the Patch Impact Analysis Wizard Select a patch and then click the Patch Properties button Application Manager Patches...

Page 1343: ...edge Base Article Contents Tab The Contents tab lists all of the files and registry data contained in the selected patch The following options are listed Table 15 10 Patch Properties Dialog Box Conten...

Page 1344: ...products updated by this patch and each product s associated Service Packs This tab includes the following options Table 15 11 Products Tab Options Option Description Products All of the products upd...

Page 1345: ...tion Isolation Wizard Explains the reasons you would isolate applications and introduces you to the Application Isolation Wizard Launching the Application Isolation Wizard Explains how to open the App...

Page 1346: ...be updated following deployment without necessitating application reinstallation Reasons to Isolate Applications You would want to isolate an application if You want to resolve incompatibilities betwe...

Page 1347: ...put View Repackager builds an isolated version of the Windows Installer package immediately after building the non isolated version Both methods of isolating a package are performed using the same App...

Page 1348: ...ication use the private files rather than shared versions the Application Isolation Wizard populates the IsolatedComponent table with the necessary logic to use private files stored in the same folder...

Page 1349: ...is option from the Advanced Options dialog box the manifest will be added to the same component as the assembly Table 16 2 Manifest Types Manifest Type Description Application Application manifests ar...

Page 1350: ...ey and when used in combination with a private key can be used by end users to verify the authenticity of the signor You can create a certificate file from the constituent PVK and SPC files and import...

Page 1351: ...s This simplification is particularly useful when isolating applications as typically the code signing information will be identical for all shared assemblies Ultimately the certificate store removes...

Page 1352: ...in conjunction with Windows Installer isolated components the Manifest and Assembly Design dialog box appears If you are only using Windows Installer isolated components to isolate the application th...

Page 1353: ...application isolation will follow the naming convention as specified Modifying the Default Isolation Recommendations You can modify default isolation recommendations for the following When Only Using...

Page 1354: ...t the new assembly then add or remove files in the assembly 4 Click OK When you return to the Summary Information panel verify your settings before isolating Filtering File Listings when Manually Conf...

Page 1355: ...m Isolation ensures that applications always use the specific shared and support files with which they were installed This prevents the overwriting of previous versions of shared components and ensure...

Page 1356: ...s and digital signature information Summary Information Panel From this panel review a summary of your selections prior to isolation For granular control over the isolation process click Modify If you...

Page 1357: ...olation Wizard was successful If the Application Isolation Wizard was successful the names and locations of the original and output packages are provided If the Wizard was not successful this panel in...

Page 1358: ...igitally signed This can be done in the Digital Signature Tab Note A 2048 bit key is required to sign a Windows XP assembly manifest being installed to the WinSxS folder Assembly Naming Conventions Sp...

Page 1359: ...ck the Browse button next to the field and navigate to the certificate file you are using to sign assemblies A digital certificate identifies you and or your company to end users and assures them the...

Page 1360: ...e Summary Information panel Isolated Components Design Dialog Box If you are only using Windows Installer isolated components to isolate the application this dialog box is displayed when you click Mod...

Page 1361: ...onent for this assembly Caution If this assembly contains files that originate from multiple components this option must be selected for successful application isolation If you are planning to deploy...

Page 1362: ...sion Division NewComponents 0 Each configuration corresponds to a user interface setting in the Application Isolation Wizard as described below Table 16 9 Application Isolation Wizard Command Line Opt...

Page 1363: ...of the Advanced Options dialog box Provide the name of the certificate from the certificate store TimeStampAssemblies No corresponding UI setting Set this value to 0 to disable timestamping during sha...

Page 1364: ...lone yes assembly xmlns urn schemas microsoft com asm v1 manifestVersion 1 0 assemblyIdentity type win32 name InstallShield Development LocalAssembly1 version 1 0 0 1 processorArchitecture x86 file na...

Page 1365: ...r User Documentation Section Description About QualityMonitor Explains the purpose and benefits of using QualityMonitor Creating New QualityMonitor Project Files Explains how to create a new QualityMo...

Page 1366: ...g to ensure they run correctly When failures occur QualityMonitor can help identify where problems exist and ultimately direct you to the solution Creating New QualityMonitor Project Files You can cre...

Page 1367: ...ualityMonitor View opens 2 Click Open on the File menu The Open QualityMonitor Project dialog box opens 3 Select the Open QualityMonitor project iqm file option 4 Enter or browse to the file you want...

Page 1368: ...is displayed 2 Under Deployment Tests select one of the following tests to open its corresponding View Class IDs File Associations Help Files Prog IDs Services Shortcuts Type Libraries ODBC Data Sourc...

Page 1369: ...open its corresponding View Class IDs File Associations Help Files Prog IDs Services Shortcuts Type Libraries ODBC Data Sources ODBC Drivers 3 In the Test Items list select the Test Items you want to...

Page 1370: ...Monitor project The QualityMonitor Product Information View opens and a view of Test Items is displayed 2 Under Deployment Tests select one of the following tests to open its corresponding View Class...

Page 1371: ...tcuts Type Libraries ODBC Data Sources ODBC Drivers 3 In the Comments box at the top right of the View enter comments Your comments are automatically saved Viewing Test Item Details When a Test Item f...

Page 1372: ...est Details If this Test Item has Failed a brief explanation of the reason the Test Item failed the test is listed 4 When finished viewing test details click OK to close the dialog box Clearing Test C...

Page 1373: ...ride the status of a Test Case in the View List from its current state In most cases this will be setting a Test Case which QualityMonitor has marked as Failed because one or more individual Test Item...

Page 1374: ...g View Class IDs File Associations Help Files Prog IDs Services Shortcuts Type Libraries ODBC Data Sources ODBC Drivers 3 Right click on the Test Item point to Set Status and select the status from th...

Page 1375: ...jects can be instantiated programatically This includes Class IDs Prog IDs and Type Libraries COM data is tested silently returning results in the Test Case Progress area and the queue See Checking Cl...

Page 1376: ...s toolbar button When you select one of these options a dialog box with a progress bar and an option to cancel will be displayed From the Command Line You can also run all deployment tests silently by...

Page 1377: ...r project The QualityMonitor Product Information View opens 2 Expand the Deployment Tests node and select File Associations from the View List The File Associations View opens 3 Right click on the Tes...

Page 1378: ...Right click on the Test Item you want to run and select Run from the context menu You can also use the Shift or Ctrl keys to select multiple Test Items to run or click Run All to run all available Tes...

Page 1379: ...run all available Test Items 4 When the Test Progress dialog box opens click Run to launch the shortcut The Test Result dialog box opens 5 Following an attempt to launch the shortcut the Test Result...

Page 1380: ...nd MsiAssemblyName tables QualityMonitor reads through the manifest assembly files and performs the baseline Class IDs Prog IDs or Type Libraries testing for each entry in the files Task To check shor...

Page 1381: ...the lower portion of the ODBC Data Sources View Only those data sources that belong to the current logged in user are listed on the ODBC Data Sources View 3 Select the Test Item you want to run and cl...

Page 1382: ...message associated with it on the Test Item Information dialog box To access this dialog box select the Test Item and then select Test Item Information from the context menu Specifying Exclusions for...

Page 1383: ...or Type Library 4 Click Add The Add Exclusions dialog box opens 5 Next to the File Name box click Browse and select the Application exe Application Extension dll Type Library tlb or ActiveX object oxc...

Page 1384: ...g Lockdown and runtime tests are available through the Lockdown and Runtime Tests View You are provided with a list of available shortcuts in the package and all of the executables in the package You...

Page 1385: ...Select the shortcut or executable to run 5 Click Run 6 When the application launches use the application in a normal way performing various operations 7 Exit the application The name of the executable...

Page 1386: ...u are then prompted to enter a User Name and Password 6 Enter the User Name in the format of DOMAINNAME UserName The default value is the current User Name 7 When the application launches use the appl...

Page 1387: ...the Lockdown and Runtime Tests View an additional node called Isolation Tests is added to the tree under the executable or shortcut node When you select this Isolation Tests node the filenames of the...

Page 1388: ...the results that are listed Task To filter test results 1 To filter the list by Test Item status select an option from the View these test items list Passed Failed Pending or All 2 To select errors t...

Page 1389: ...if any files are missing or if any files do not match the version or size specified in the MSI file See the components status segregated by features Configure or reinstall features Reinstall component...

Page 1390: ...rom Source Feature or Component is configured to run from a source location rather than being installed on the local machine On Demand Feature is configured to be installed when needed Not applicable...

Page 1391: ...right 3 Select Properties from the context menu The Product Properties Feature Properties or Component Properties dialog box appears displaying property information for the selected Product Feature o...

Page 1392: ...On the Files tab the following icons are used to identify verification errors On the Registry tab all registry entries for the selected item are listed Registry data is verified by checking the existe...

Page 1393: ...installation type Minimum Only the essential features will be installed Typical Most commonly used features will be installed Complete All of the program s features will be installed 6 Click OK The P...

Page 1394: ...ew List All components associated with the selected feature s are listed 3 Select the component that you want to re install and select Re install from the context menu The component is automatically r...

Page 1395: ...ests tree and select Save as template from the context menu b Specify a name and a location for the Test Case template and select Save The template is saved in xml format in the location you specify 3...

Page 1396: ...new name for the Test Case Test Reports QualityMonitor allows you to create an HTML test report for the current project This can be done by selecting Generate Report from the File menu and providing...

Page 1397: ...display QualityMonitor displays the test names as they are executed and provides an option for the user to cancel r Report File Generates a report file c report htm with the test results Works only wh...

Page 1398: ...ontained in this section provide detailed reference on each user interface element dialog box or view in QualityMonitor This is the same documentation displayed when you click F1 from the QualityMonit...

Page 1399: ...tests in the current project Execute Run F5 or Alt E R Runs the selected deployment lockdown and runtime or user defined test Execute Run As Shift F5 Runs the selected lockdown and runtime test in the...

Page 1400: ...onitor About QualityMonitor Dialog Box Add Exclusions Dialog Box Component Properties Dialog Box Feature Properties Dialog Box Install or Configure Feature Dialog Box Install or Configure Product Dial...

Page 1401: ...lect a Component in the Component list on the right side of the Deployment Status View and select Properties from the context menu The following information is listed Table 17 7 Add Exclusions Dialog...

Page 1402: ...n and compares the file size specified in the Windows Installer msi package to that of the file on the system Missing or modified files are identified Registry QualityMonitor verifies the Registry dat...

Page 1403: ...this operation you may need the source from which the selected Feature was installed Install or Configure Product Dialog Box The Install or Configure Product dialog box is displayed when you select t...

Page 1404: ...commonly used Features will be installed Complete All of the program s Features will be installed Installed Data Dialog Box The Installed Data dialog box appears when you are using MSI Doctor to veri...

Page 1405: ...o indicate that a registry key or value name is incorrect or missing Note Only the registry keys and value names are verified the values themselves are not verified Note To save all the deployment sta...

Page 1406: ...have the following options Always Show this view for all the executables run irrespective of the presence of records in the IsolatedComponent table and in MsiAssembly SXS records Never This view will...

Page 1407: ...his project file is opened again in QualityMonitor the results are checked against the exclusion list before being displayed in the Class IDs View Prog IDs View or Type Libraries View The following op...

Page 1408: ...e this MSI file is located Registered to Registered user of Product Product ID Status Installation status of this Product such as The product is installed for the current user Help Link Main help link...

Page 1409: ...r Isolation Tests View All of the errors that were generated for that Lockdown and Runtime Test Case are listed If you want to exclude specific errors from future Lockdown and Runtime tests select tho...

Page 1410: ...rm any necessary manual actions Following execution of Test Items the Test Result Dialog Box appears Test Result Dialog Box The Test Result dialog box opens following execution of each Test Case requi...

Page 1411: ...s View User Defined Tests View Test Case View Deployment Status View Welcome to QualityMonitor View The Welcome to QualityMonitor View is the view that is displayed before a project is created or open...

Page 1412: ...items will increase Deployment Tests View The Deployment Tests View provides a summary of all Deployment Tests Deployment tests help you with up to several Test Cases to run on your Windows Installer...

Page 1413: ...one of the following Click the Execute All Deployment Tests button Select All Deployment Tests from the Execute menu Click the Execute All Deployment Tests toolbar button When you select one of these...

Page 1414: ...IDs COM objects can be instantiated programatically At the bottom of the view you can see all Test Items associated with the Test Case and can run these items either individually or simultaneously You...

Page 1415: ...to run or click Run All to run all available Test Items When testing is finished results are recorded in the Test Case Progress area Also the Status of each test item Passed Failed or Pending is list...

Page 1416: ...he view you can see all ODBC drivers associated with the Test Case and can run these items either individually or simultaneously You can also view individual Test Item details At the top of the view y...

Page 1417: ...nto Runtime Execution Details View Files View Folders View Registry Entries View Isolation Tests View If you want to execute tests in the context of a different user under a different user account cli...

Page 1418: ...that generated failures plus those test cases that have not yet been completed Passed Failed Pending Percentage of total test cases that passed the test failed the test or have not yet been executed I...

Page 1419: ...is Lockdown and Runtime Test was executed View these test items Select one of the following to filter the file listing All Passed Failed or Pending Set Filter Click on this button to open the Runtime...

Page 1420: ...ed is also listed Passed Failed Pending Percentage of total test items that passed the test failed the test or have not yet been executed Comments Enter comments to document any special considerations...

Page 1421: ...the Test Cases has not yet completed QualityMonitor sets the status to Pending If no failures were generated QualityMonitor sets the status to Passed Depending on your business practices and standard...

Page 1422: ...es at least one portable executable file You can specify when you would like the Isolation Tests node on the General tab of the Options Dialog Box On the General tab select an option from the Show Iso...

Page 1423: ...ures in the MSI package are listed in the Deployment Status tree with an icon indicating its status Table 17 21 Test Case View Options Option Description Test Case Status Specify the status of the sel...

Page 1424: ...thin that feature are listed The following information is displayed Table 17 23 Deployment Status View Options Option Description Component Name Name of all components in the MSI package or selected f...

Page 1425: ...ent This part of the AdminStudio 9 5 User Guide includes the following chapters Preparing Packages for Distribution Using Distribution Wizard Distributing Packages Using Configuration Manager Web Cons...

Page 1426: ...1426 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1427: ...ve Install Creating Administrative Installations for Packages Altiris Preparing for Altiris Distribution FTP Location Distributing Packages to FTP Servers LANDesk Preparing for LANDesk Distribution Ma...

Page 1428: ...Installer Package msi you want to distribute If you launched the Distribution Wizard from the Application Manager by selecting a package and selecting Distribute Package from the context menu the nam...

Page 1429: ...on Type panel select FTP Location and click Next The Installation Package Information panel opens 4 On the Installation Package Information panel click the Browse button and locate the Windows Install...

Page 1430: ...file in this location named packageName Config Note You can edit AltirisTemplate config to customize it for your organization The file which is installed with AdminStudio is located in the Templates f...

Page 1431: ...Integration panel specify the network location where you want to copy the MSI package and all of its setup files The Network Directory could be a URL or a UNC path This field will default to the last...

Page 1432: ...the Retain the ManageSoft wrapped msi package on local managed device cache option if you do not want the Distribution Wizard to delete the ManageSoft wrapped msi package from the local cache after in...

Page 1433: ...h a Channel such as an installation setup on the Transmitter web site so that the Marimba Transmitter can download a Channel to a local machine Here is a review of terms associated with Marimba distri...

Page 1434: ...ectory where you want to place the contents of the new Channel Specify the directory where you want to place the MSI file or click Browse to select it This directory will be called the Channel Directo...

Page 1435: ...t the Distribution Wizard Distributing Packages to Network Locations To distribute a package to a network directory select the Network Location option on the Distribution Wizard Distribution Type pane...

Page 1436: ...ssociated with the package click the New button in the Additional Transforms area and navigate to the transform you want to add Repeat as necessary 6 After specifying the package location click Next T...

Page 1437: ...s Typical Automated Typical Setup CommandName Typical Installation CommandLine msiexec i CMDLINE UserInputRequired TRUE SynchronousSystemExitRequired TRUE SupportedPlatforms Win 9x Win NT i386 Automat...

Page 1438: ...se button and locate the Windows Installer Package msi you want to distribute 5 If there are transforms associated with the package click the New button in the Additional Transforms area and navigate...

Page 1439: ...n Wizard Note Any associated transforms are merged into the Windows Installer package before the package is distributed to Tivoli Preparing for ZENworks Configuration Management 10 Distribution AdminS...

Page 1440: ...cted Windows Installer package are automatically listed in the Windows Installer Transform Files mst list even if they are not applicable to the selected package To prevent the inclusion of non applic...

Page 1441: ...ndicate that you want to perform this operation silently with no user interface This is the common operating behavior for installing software with ZENworks Running an operation silently implies that i...

Page 1442: ...les This group lists the rest of the existing bundles on the server 12 After making your selection click Next to proceed The Bundle Information panel opens 13 Enter information to specify attributes f...

Page 1443: ...ssing is complete the Finish button becomes enabled Click Finish to exit this wizard See Also Distribution Wizard for ZENworks Configuration Management Folder From the Folder list select the folder pa...

Page 1444: ...d locate the Windows Installer Package msi you want to distribute 5 If there are transforms associated with the package click the New button in the Additional Transforms area and navigate to the trans...

Page 1445: ...eld specify the path that ConsoleOne will use to access the msi package ConsoleOne uses the package file to populate information in the Application Object This field defaults to the directory specifie...

Page 1446: ...lank Specifying Multiple Parameters in the Context Field If you would like to enter multiple parameters in the Context field you would enter the login name in the Login Name field without parameters j...

Page 1447: ...ble 18 6 How to Specify Multiple Parameters in the Context Field If you enter AdminStudio assumes that one unqualified parameter in the Context field such as myorg The following parameter is passed to...

Page 1448: ...udio 9 5 Distribution Wizard The Distribution Wizard supports the distribution of a setup along with any transforms and files via ZENworks server distribution You would select this option if you want...

Page 1449: ...create the Distribution Object Specify the following information a In the Login Name field enter a valid Login Name for the Novell server where you want to create the Distribution Object This is a req...

Page 1450: ...in panel c In the Path to copy to Distributor s file system field specify the desired path on the Distributor where you want to copy the setup files d In the Path to reference in the Distribution obje...

Page 1451: ...u enter multiple unqualified parameters in the Context field AdminStudio uses a formula to determine how to pass these parameters to the server Table 18 9 How to Specify Multiple Parameters in the Log...

Page 1452: ...to determine how to pass these parameters to the server two unqualified parameters in the Context field such as dept01 myorg the first entry identifies an organizational unit ou the second entry ident...

Page 1453: ...ctive Directory you need to first deploy the same version of the InstallScript engine that was used to build the InstallScript MSI installation Installing the InstallScript Engine Sometimes the isscri...

Page 1454: ...the InstallScript engine that was used to create the application s InstallScript MSI installation 2 Create a transform for the InstallScript MSI that includes the following changes a Add the property...

Page 1455: ...k Location Panel SMS Distribution Panel Tivoli Integration Panel ZENworks Login Panel ZENworks Desktop Application Panel ZENworks Server Distribution Object Panel ZENworks Server Distribution Distribu...

Page 1456: ...r ManageSoft Distribution Marimba A new Marimba channel is created and files are copied to it for distribution See Using Marimba Channel Publishing for Package Deployment Network Location Distribute i...

Page 1457: ...r Distribution Create an MSI distribution object to distribute to ZENworks servers See Preparing for ZENworks Server Distribution Table 18 13 Altiris Integration Panel Field Description Network Direct...

Page 1458: ...tiris Server Location Enter the http address for the location of the Altiris Server The Distribution Wizard remembers the last Altiris Server Location that is entered and displays it the next time thi...

Page 1459: ...If you select LANDesk on the Distribution Type panel the LANDesk Integration panel is displayed Specify the following options on the LANDesk Integration panel SUMMARYSTREAM Id Comments property from t...

Page 1460: ...tings Panel Options Option Description Configure MSI Package Source Choose one of the following options Install From Cache Configure the ManageSoft wrapped package to be installed from a locally manag...

Page 1461: ...bution Wizard This panel opens when you have selected Marimba from the Distribution Type panel of the Distribution Wizard In the Patches msp area Table 18 17 ManageSoft Package and Environmental Setti...

Page 1462: ...field is populated based on the msi and mst package name s selected If no transforms are applied this field is populated with the msi file name base name only with msi removed If a transform is appli...

Page 1463: ...estination channel URL and subdirectory on the transmitter This is an optional field However if you specify a value in this field you must also specify the channel copier URL Advanced Click to access...

Page 1464: ...to this location Click Next to proceed Tivoli Settings Panel AdminStudio 9 5 Distribution Wizard The Tivoli Settings panel appears when you select Tivoli on the Distribution Type panel You use the Ti...

Page 1465: ...ble location with the installation Source Image Path Specify the path of the directory where product images are stored When distribution occurs these product images are retrieved and distributed to th...

Page 1466: ...case sensitive Set feature and subfeatures to source The feature and subfeatures will be run from the source media Set feature to advertised The feature will be marked as advertised when the setup is...

Page 1467: ...DIR Image folder path package install_msi_product image_dir SOURCE_DIR Source folder path package install_msi_product source_dir CAPTION MSI file path package install_msi_product caption PACKAGE_FILE...

Page 1468: ...achine_data shortcut log_mode disabled fatal_exit error report_log n ui_level none product_code PRODUCTCODE product_name PRODUCTNAME product_version VERSION all_users ALLUSERS properties TRANSFORMS FE...

Page 1469: ...shortcut log_mode disabled fatal_exit error report_log n ui_level none product_code B7298620 EAC6 11D1 8F87 0060082EA63E product_name Windows 2000 Administration Tools product_version 5 0 0 0000 all_u...

Page 1470: ...to the server would be cn jsmith o myorg Table 18 24 ZENworks Login Panel Options Option Description Login Name Enter a valid Login Name for the Novell server where you want to create the Distributio...

Page 1471: ...unqualified parameters in the Context field AdminStudio uses a formula to determine how to pass these parameters to the server Table 18 25 How to Specify Multiple Parameters in the Login Name Field If...

Page 1472: ...first entry identifies an organizational unit ou the second entry identifies the organization parameter o Therefore the following parameters are passed to the server ou dept01 o myorg more than two un...

Page 1473: ...used only by ConsoleOne to access the msi package It is not used by Novell Application Launcher for distribution of the application For distribution Application Launcher uses the path defined in the S...

Page 1474: ...e Context field you can enter multiple qualified parameters in any order separated by either periods or commas ou dept01 o myorg ou office03 more than two unqualified parameters in the Context field s...

Page 1475: ...e Context Field If you enter AdminStudio assumes that one unqualified parameter in the Context field such as myorg The following parameter is passed to the server o myorg two unqualified parameters in...

Page 1476: ...to Distributor s file system Specify the desired path on the Distributor as the location where you want to copy the setup files Path to reference in the Distribution object Specify the desired path as...

Page 1477: ...n Description Windows Installer Package msi Specify or browse to the Windows Installer package msi that you want to distribute If you launched the Distribution Wizard from the Application Manager by s...

Page 1478: ...r ZENworks Configuration Management AdminStudio 9 5 Distribution Wizard for ZENworks Configuration Management You can use the Distribution Wizard for ZENworks Configuration Management to distribute a...

Page 1479: ...e Do not show the Welcome panel again option If this option is selected the Login panel will be the first panel opened for this wizard Click Next to continue See Also Preparing for ZENworks Configurat...

Page 1480: ...er the server URL machine name or IP address of the ZENworks Configuration Management server using the following format http www servername com or http 111 22 333 44 If you need to specify a specific...

Page 1481: ...nsforms from the list Install Parameters You can customize how this package is installed by entering parameters in this field These parameters are applied to msiexec exe to perform the desired action...

Page 1482: ...peration silently with no user interface This is the common operating behavior for installing software with ZENworks Running an operation silently implies that it does not require any user input Cauti...

Page 1483: ...to preconfigure all user input For more information see Using Response Transforms You can also apply any of the following additional parameters after the package name p Reinstalls a file if it is mis...

Page 1484: ...nsform to your advertised product Transforms allow the synchronization of applications across different languages For example if you upgrade the English version of your product you could apply a trans...

Page 1485: ...CX file specified in filename TRANSFORMS Use the TRANSFORMS command line parameter to specify any transforms that you would like applied to your base package Your transform command line call might loo...

Page 1486: ...eate a new bundle from these Windows Installer package files To create a new bundle to reference this Windows Installer package select this option Update an existing bundle using these Windows Install...

Page 1487: ...older list select the folder path that will be used by ZENworks Application Launcher when displaying the bundle on either the device s desktop or Start menu All of the folders defined on the ZENworks...

Page 1488: ...ement ZENworks error messages Any error messages with a numeric prefix that appear on this panel are generated by ZENworks Configuration Management To resolve these errors contact your ZENworks Config...

Page 1489: ...guration Manager collections Configure program options for packages and target multiple distribution points for packages Refresh source files on the distribution points if source files are changed Cre...

Page 1490: ...elping you improve your application management efforts while simplifying your overall Configuration Manager management requirements You can use Configuration Manager Web Console to perform all of your...

Page 1491: ...ver Step Description 1 Install Client Agent Software on Client Computers Install the Advertised Programs Client Agent on the Client computers to enable them to receive and run programs from Configurat...

Page 1492: ...and version the location of the package source folder and group permissions for the distribution folder 5 Specify Distribution Points Select the Distribution Points that will receive the software 6 Cr...

Page 1493: ...n Manager software distribution Figure 19 1 Configuration Manager Web Console and Configuration Manager Server Integration Setting Configuration Options In the Package Configuration area of Configurat...

Page 1494: ...Manager Server you need to do the following Learn About Configuration Manager Web Console Review the About Microsoft System Center Configuration Manager and Configuration Manager Web Console section...

Page 1495: ...d select the Configuration Manager site you want to use for software distribution 5 In the User Name field enter the user name of a user who has access to the Configuration Manager Server 6 Click Upda...

Page 1496: ...the package Setting Package Settings Options General information about the package along with data source data access distribution settings and reporting information Setting Access Accounts Options Sp...

Page 1497: ...k box the Use Existing Package Definition option is automatically selected and the existing Package Definitions available on the Configuration Manager Server are listed b Select the Use Existing Packa...

Page 1498: ...fy programs that will run on the clients to execute the distribution of the application and the types of clients on which the program can run directories operating system versions etc See Setting Prog...

Page 1499: ...se up to 127 characters Option Description This Package contains source files This package has source files that are required to run its programs when they are advertised to clients By default this ch...

Page 1500: ...nager package share Users will access the package through the common Configuration Manager package share SMSPKGx where x is the drive letter on distribution points By default this option is selected S...

Page 1501: ...ties they will be sent in the order in which they were created in the Configuration Manager Administrator console Sending priority for a package is carried over in packages sent from a parent site to...

Page 1502: ...this view to create new users and groups If you select a user s icon under Access Accounts in the tree you can review but not change that user s permissions and can delete the user Option Description...

Page 1503: ...r for more information Task To set Distribution Points options 1 Perform the steps described in Selecting a Package for Distribution 2 On the Configuration Manager Package Configuration Page select Di...

Page 1504: ...Package Configuration Page select Programs in the tree The Programs View opens 3 To create a new program select Programs in the tree enter a name in the Name text box and click Create The new program...

Page 1505: ...s not have a file name extension specified Configuration Manager tries pif com exe and bat If the file name has an extension but is not an executable Configuration Manager tries to apply a local assoc...

Page 1506: ...and the Configuration Manager logs user off actions are done forcefully after providing the user with a grace period Applications that are running on clients when this occurs will not have an opportu...

Page 1507: ...ptional For example you can notify users that they should shut down all other applications before running this program Option Description Program can run Specify whether the program requires that a us...

Page 1508: ...ailable only when Program can run is set to Only when no user is logged on or Whether or not a user is logged on By default this check box is cleared This option should be used only when the program r...

Page 1509: ...gram that must run before this program Program The program that must run first Note If the depended upon program fails on a client the depending program will not run Also if the program that runs firs...

Page 1510: ...ograms in Control Panel To use this option enter the name of the Uninstall Registry Key the program creates in the following registry key HKEY_LOCAL_MACHINE Software Microsoft Windows CurrentVersion U...

Page 1511: ...t Advertisement ID Number uniquely identifying the advertisement Status Advertisement s status 3 To create a new advertisement enter a name in the Name text box and click Create The new advertisement...

Page 1512: ...r clients in the Greenwich mean time zone 10 00 A M for clients in the Eastern time zone and 7 00 A M for clients in the Pacific time zone and so on This check box is cleared by default which enables...

Page 1513: ...run the installation program before it is scheduled to run automatically select this option so that the assigned program appears in Advertised Programs Wizard in the Control Panel on client computers...

Page 1514: ...of a Distributed Package Viewing the Status of a Distributed Package Click Package Administration on the Configuration Manager Web Console Home page to see the status of a distributed package delete...

Page 1515: ...s described in Setting Package Configuration Options Deleting Packages From the Configuration Manager Web Console you can delete a package from the Application Catalog from the Configuration Manager S...

Page 1516: ...ect Yes or No to indicate your deletion preferences 6 Click OK to confirm your selections Package Status Delete from Catalog Delete from Configuration Manager Not Distributed Choose Yes to confirm the...

Page 1517: ...g pages and views are documented Configuration Manager Package Configuration Page Package Settings View Access Accounts View Distribution Points View Programs View Advertisements View Connect to Confi...

Page 1518: ...ibute Package Page where you can select a package to distribute using distribution providers Package Administration Click to access the Package Administration Page where you can view the status of dis...

Page 1519: ...previous versions of Configuration Manager This page contains the following fields Table 19 6 Distribute Package Page Options Option Description Application Name Lists the names of all applications av...

Page 1520: ...nfiguration Page where appropriate fields are populated with the information in the Package Definition you selected Table 19 8 Configuration Manager Package Configuration Page Views View Description P...

Page 1521: ...This list is populated with the files available from Configuration Manager Web Console Installation Directory SMS Web Console Application Distribution Providers SMS Icons Name The name of the package...

Page 1522: ...ck box is selected Always obtain files from source directory Configuration Manager will obtain package source files the files needed to run the package programs such as exe and dll files from the path...

Page 1523: ...een 0 and 59 minutes inclusive Table 19 12 Package Settings View Distribution Settings Tab Options Option Description Sending priority The priority of this package when sent to distribution points in...

Page 1524: ...ties in the General tab for status MIF file matching By default this option is selected Use these fields for status MIF matching Configuration Manager will use the following values specified for statu...

Page 1525: ...rm the following steps To create a Windows User Access Account 1 Enter a User Name using the syntax of Domain User 2 Under Account Type select User or Group 3 Select this user s permission level from...

Page 1526: ...ing the program name run time disk space and any comments associated with the program Create New Program To create a new program enter a name in the Name text box and click Create The new program will...

Page 1527: ...cified Configuration Manager tries pif com exe and bat If the file name has an extension but is not an executable Configuration Manager tries to apply a local association For example if the command li...

Page 1528: ...s user off actions are done forcefully after providing the user with a grace period Applications that are running on clients when this occurs will not have an opportunity to save their states or data...

Page 1529: ...hould shut down all other applications before running this program Table 19 19 Programs View Environment Tab Options Option Description Program can run Specify whether the program requires that a user...

Page 1530: ...t to Only when no user is logged on or Whether or not a user is logged on By default this check box is cleared This option should be used only when the program requires access to network resources oth...

Page 1531: ...e that contains the program that must run before this program Program The program that must run first Note If the depended upon program fails on a client the depending program will not run Also if the...

Page 1532: ...nt Configuration Manager looks up the program s uninstall command line in the UninstallString or QuietUninstallString property in this registry key By default this check box is cleared An advertisemen...

Page 1533: ...9 21 Advertisements View Options Option Description Advertisement Listing List of all existing advertisements displaying the following Name Name of the advertisement Program The program to run on the...

Page 1534: ...ement start time The date and time when the program is advertised and available to run on clients By default the current date and time is specified Greenwich Mean Time Sets the time independent of tim...

Page 1535: ...l on client computers Advertisement will expire Advertises the program to clients only for a limited time By default this option is cleared This feature is not supported on 16 bit clients the program...

Page 1536: ...onfiguration Manager Server Select the collection that you want to use for the Advertisement definition and click OK Distribution Settings Page On the Distribution Settings page which opens when you c...

Page 1537: ...ation Manager Package Name Name of the package Version Version of the package Language Language that the package was written for Description Description of package Status Lists the distribution status...

Page 1538: ...5 REMOVAL_FAILED 6 Last Copied Date and time GMT when the package source files were last successfully copied to the distribution point Source Version The number of times an administrator has updated...

Page 1539: ...er of users user groups or client computers that experienced an error in processing the advertisement or its associated program or that attempted to run the advertised program but failed before the pr...

Page 1540: ...onfiguration Manager Not Distributed Choose Yes to confirm the deletion from the Application Catalog or choose No to decline the deletion If you choose Yes the package will be deleted from the Applica...

Page 1541: ...nformation is lost even if you do not delete it from Configuration Manager If you delete a package from the Application Catalog but not from Configuration Manager the package would still be available...

Page 1542: ...Chapter 19 Distributing Packages Using Configuration Manager Web Console Configuration Manager Web Console Reference 1542 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1543: ...iption About the Predeployment Test Tool This section provides an overview of the Predeployment Test tool and explains how it works Configuring the Predeployment Test Environment This section explains...

Page 1544: ...incorporates custom actions A test ready msi package does not make any system changes when it is installed it is used to collect data on whether that package would succeed or fail if it was installed...

Page 1545: ...dy package jobs that have been run Each time a test ready package is installed on a machine in your network test results are added to its corresponding job on the Predeployment Test Results Web site J...

Page 1546: ...nt Test Results Web site See Setting the Predeployment Test Results Web Site Address Application Catalog Configure a connection to an Application Catalog to store the Predeployment Test results You wi...

Page 1547: ...ing options With Windows NT authentication using the Network Login ID Use Windows network authentication when connecting to this database With Database Server authentication using Login ID and passwor...

Page 1548: ...atalog database on the Predeployment Test Results Web site the database file must have ASP NET permissions assigned to it Files in the AdminStudio Shared directory inherit ASP NET permissions from tha...

Page 1549: ...s network authentication when connecting to this database With Database Server authentication using Login ID and password entered by user Use database server login identification for authentication wh...

Page 1550: ...make any system changes when it is deployed This test ready msi package incorporates Type 1 msi custom actions which are executed when the package is deployed Each custom action performs a test and s...

Page 1551: ...e the wizard was run By default this field is set to http serveraddress PreDeployTestService PreDeployTestService asmx 8 In the Job Identifier field enter a title to identify the Predeployment Test re...

Page 1552: ...i package automatically selected as the distribution source You can then use the distribution method of your choice to distribute the test ready package Setting Predeployment Test Command Line Paramet...

Page 1553: ...izard to use The connection string must be the complete OLE DB connection string including provider information Command Line Arguments for Distributing Test Ready Packages All test service settings ar...

Page 1554: ...ibution method of your choice to distribute the test ready package Note If you have already completed the Predeployment Test Preparation Wizard and did not select the Distribute the test ready Windows...

Page 1555: ...ayed to assist in troubleshooting To have a test ready package launch the Diagnostic Tool set the PD_RUN_DIAGNOSTICS property This property can be set in the property table or on the command line when...

Page 1556: ...lick Exit The installation of the test ready package now finishes and the results of the diagnostic tests are entered in the Predeployment Test Web Service Application Catalog and if you specified the...

Page 1557: ...d Failed or Incomplete results On the Job Summary Report click the All Results Passed Failed or Incomplete link If the total number of tests in one of the result type categories is 0 the result type c...

Page 1558: ...age Job Page you can change the Job Status of a job from Failed to Passed or delete the job from the Application Catalog Changing the Status of a Job from Failed to Passed Task To change the Job Statu...

Page 1559: ...To delete a job 1 Open the Job Summary Report or Job Details Report for a job and click Manage Job The Manage Job Page opens 2 Click Delete this job from the Application Catalog Managing a Job Globall...

Page 1560: ...ent Test icon on the AdminStudio Start Page or in the Tools Gallery You can also launch it from the Test Page of the Process Assistant Predeployment testing is a three step process Table 20 5 Predeplo...

Page 1561: ...anel Web Service URL Panel Select Application Catalog Panel Deployment Conflict Test Selection Panel Review Panel Progress Panel Summary Panel Welcome Panel The first panel of the Predeployment Test P...

Page 1562: ...package you are distributing is managed by the Software Repository Not in the Software Repository The full name and path of the Windows Installer file is displayed and you can edit this entry or clic...

Page 1563: ...the HTTP Web Service URL where you want to post the Predeployment Test results This field automatically displays the Web Service URL that was entered the last time the wizard was run By default this...

Page 1564: ...tion Catalog you would have to rebuild all of your test ready packages With registered catalogs you just change the Application Catalog registered with the test service and then all of the new test ru...

Page 1565: ...his panel you can review the settings you specified in this wizard and then initiate the testing Directory Creation Permissions Checks to determine if the necessary directory creation permissions exis...

Page 1566: ...ready msi package select the Distribute the test ready Windows Installer msi package now option and click Finish The Distribution Wizard will be launched with the generated test ready msi package aut...

Page 1567: ...includes the following topics Predeployment Custom Properties Predeployment Test Identifiers Predeployment Test Results XML File Changes Made During Test Ready Package Creation Predeployment Test Web...

Page 1568: ...value is then used by the custom actions to determine the tests to run during the analysis The list of tests in the PDTestsToRun property populates the list shown on the Deployment Conflict Test Selec...

Page 1569: ...raw msi Source Original Instrumentation NewPackageCode FAD3134F 5474 4778 9E34 204662673F6D NewProductCode 59293687 ABCF 4e96 9CF5 5F3A08E2166A TestResults Deployment Test ID AppSearch Result Total 0...

Page 1570: ...IR65 Folder C Program Files Corel Graphics9 custom palettes cmyk nature Result 0 Message Key DIR66 Folder C Program Files Corel Graphics9 custom palettes cmyk people Result 0 Message Key DIR67 Folder...

Page 1571: ...Folder C Program Files Corel Graphics9 draw fill_out outlines Result 0 Message Key DIR95 Folder C Program Files Corel Graphics9 draw fill_out outlines arrows Result 0 Message Key DIR96 Folder C Progr...

Page 1572: ...cs9 scripts Result 0 Message Key DIR125 Folder C Program Files Corel Graphics9 shared help Result 0 Message Key DIR126 Folder C Program Files Corel Graphics9 trace Result 0 Message Key DIR127 Folder C...

Page 1573: ...art Menu Programs CorelDRAW 9 Setup and Notes Result 0 Message Key Directory16 Folder C Program Files Corel Graphics9 Config Result 0 Message Key Directory17 Folder C Program Files Corel Graphics9 Cus...

Page 1574: ...selected source Windows Installer msi package and makes the following changes to create a test ready package These changes are made to ensure that the test ready package does not make any system chang...

Page 1575: ...e On the Predeployment Test Results By Job Report click the Job Name link Test Result Summary Report Lists the all the computers that this job was run on All Results or all the computers that had eith...

Page 1576: ...The following information is included Predeployment Test Results By Machine Report Lists all of the machines in the network where test ready packages have been installed On the Predeployment Test Resu...

Page 1577: ...not shown File Name Name of the original msi package that was used to create the test ready package Product Version Version of the original msi package No of times run Number of times this job has bee...

Page 1578: ...izard when this test ready package was created Click on this link to view the Job Summary Report for this job MSI Name Name and location of the test ready msi package associated with this job Product...

Page 1579: ...at was used to create the test ready package Total tests run on each machine The total number of Deployment and Conflict tests associated with this test ready package Computer Name Unique identifier o...

Page 1580: ...mmary of Test Name Click to view the Job Summary Report for this test ready package job Table 20 18 Job Details Report Data Item Description Job Name Name of the test ready package job Corresponds to...

Page 1581: ...listed Test Name Name of the deployment or conflict test that was included with this test ready package Message Summary message generated when this deployment or conflict test was run on this compute...

Page 1582: ...ame Unique identifier of an individual computer in the network Conflicting Item in Product The item in a product installed on the computer that the test ready package was installed on that conflicted...

Page 1583: ...mmary Report Data Item Description Job Name Name identifying a test ready package that was installed on this machine The Job Identifier is entered on the Web Service URL Panel of the Predeployment Tes...

Page 1584: ...g a source package against a target package If a file with the same name and destination directory is found in both the source and target packages but the file has a different size version or language...

Page 1585: ...a Machine Name link Table 20 21 Predeployment Test Results by Machine Report Data Option Description Machine Name Name that identifies the machine on the network Click this link to view the Machine Re...

Page 1586: ...te and time when the installation of the test ready package began and ended Result Icon indicating whether the test ready package successfully installed on the machine Passed or Failed Deployment Test...

Page 1587: ...g the Network Login ID Use Windows network authentication when connecting to this database With Database Server authentication using Login ID and password entered by user Use database server login ide...

Page 1588: ...of the job that you are viewing MSI Name Name and directory path of the test ready package that was used to run this job Product Code Product code of the test ready package Job Status Status of this...

Page 1589: ...other directory you must assign ASP NET permissions to that database file or the directory that it is in Task To assign ASP NET permissions to a file or folder 1 In Windows Explorer select the file or...

Page 1590: ...t select the name of your computer and click OK to return to the Select Users or Groups dialog box The name of your computer is now listed in the From this location field 6 In the Enter the object nam...

Page 1591: ...oyment Test Reference AdminStudio 9 5 User Guide ADS 0950 UG00 1591 a On the Select Users or Groups dialog box click Advanced The Advanced View of the Select Users or Groups dialog box opens b Click F...

Page 1592: ...lled on your machine ASP NET is automatically installed when you install AdminStudio Re install AdminStudio using the original installation CD 8 Click OK to return to the Security tab of the Propertie...

Page 1593: ...different ComponentIds ACE23 Files Identifies file duplication between source and target packages ACE23 checks to see if files with the same name and destination directory have the same size version...

Page 1594: ...COMPONENTNAME in the package PACKAGENAME Confirm this error by running this package against ACE12 Not Merge Module Not Merge Module Error Yes The file FILENAME in the component COMPONENTNAME is identi...

Page 1595: ...LENAME in the merge module installed component COMPONENTNAME in the package s is identical to the file in the component COMPONENTNAME in the package PACKAGENAME Confirm this error by running the PACKA...

Page 1596: ...if an ACE10 error is valid but please consider checking the Registry Value field as its contents may prove useful in helping you decide Resolution This conflict requires a manual resolution Follow th...

Page 1597: ...E23 checks to see if files with the same name and destination directory have the same size version and language when comparing a source package against a target package If a file with the same name an...

Page 1598: ...m the operating system 4 Select Save As from the File menu and save the changes as a Windows Installer Transform mst file 5 Open ConflictSolver and reimport this package with its transform file into y...

Page 1599: ...Open ConflictSolver and reimport this package with its transform file into your Application Catalog and then use the Conflict Wizard to check it against ACE23 again ACE24 ACE 24 checks to see if regis...

Page 1600: ...the target package 3 Select Save As from the File menu and save the changes as a Windows Installer Transform mst file 4 Open ConflictSolver and reimport this package with its transform file into your...

Page 1601: ...ee Using the FLEXwrap Server Configuration Tool to Manage the FLEXwrap License Server You can also use the FLEXwrap Server Configuration Tool to FLEX enable individual existing executable files exe Se...

Page 1602: ...led package to the users in your enterprise you can manage the licensing of that application using FLEXnet Manager Managing FLEXwrap License Files Explains how to manage FLEXwrap license files using t...

Page 1603: ...se any additional licenses that are required enabling you to only purchase the number of licenses that your organization actually needs Enable application usage during server down time You can choose...

Page 1604: ...gs and the location of the log and options files The license file lic is read by the License Server and when the Allow application to run if the license server is unavailable option is selected on the...

Page 1605: ...e list to show only those executables which can be launched separately using a Shortcut For example if you were license injecting a Windows Installer package that installs a suite of applications such...

Page 1606: ...Windows Installer package you perform the following steps Table 21 3 Wrapping a Windows Installer Package Icon Step Description Step 1 Select Files Identify the executables exe files in a Windows Ins...

Page 1607: ...Windows Installer folder to a subfolder of the output folder you specified 2 Extracts executables Uncompresses this package s cab files if any to extract the executables exe files that you selected 3...

Page 1608: ...application the Wrapper launches which is transparent to the user Wrapper obtains location of License Server The Wrapper obtains the location of the License Server from the server location file lf Wra...

Page 1609: ...reporting to generate usage reports No license is obtained Neither of the above options was selected Wrapper follows the option that was selected under Action to take when license limit is reached on...

Page 1610: ...to run if the License Server cannot be connected Using the FLEXwrap Assistant The procedures listed in this section explain how to use the FLEXwrap Assistant to license enable Windows Installer packag...

Page 1611: ...e a Windows Installer package 1 Launch the FLEXwrap Assistant The FLEXwrap Home Page opens 2 Click the Select Files icon in the navigation bar The Select Files Page opens 3 Click the Browse button and...

Page 1612: ...lect the Enable overdraft licenses option and enter a value in the Overdraft limit box See Using Overdraft Support to Determine Application Usage for a description of your overdraft support options 3...

Page 1613: ...se only one license regardless of whether multiple users are accessing the application from the same computer User All concurrent requests from the same user use only one license regardless of whether...

Page 1614: ...icense Server Task To define license requirements and set access restrictions 1 After you have performed the steps described in Defining License Requirements and Access Restrictions and the Configure...

Page 1615: ...ime for any reason such as if you wanted to install the same wrapped application to multiple servers across different locations at the same organization 3 To allow this wrapped application to be able...

Page 1616: ...ose of Packaging Comments for more information 4 Click Build Package to create a new Windows Installer package with built in licensing and store it in the directory that you specified Next Steps After...

Page 1617: ...msi file Because the original unwrapped executables are installed along with the wrapped executables it is possible for a user to rename the executable files with the fwr extension back to having an...

Page 1618: ...se agreement for this application expires on a specific date and you want to make sure that no one in your organization can launch the application after that date This enables you to comply with the t...

Page 1619: ...havior During Server Down Time By selecting the Allow application to run if the license server is unavailable option on the Configure Connection Page you can choose to allow the wrapped application to...

Page 1620: ...u want to be able to specify the server location when this application is installed select the Allow host name and port redefinition at install time option on the Configure Connection Page If this opt...

Page 1621: ...nvalidated Warning The Windows Installer package you selected is digitally signed If you choose to continue and use the FLEXwrap Assistant to modify this package you lose this package s digital signat...

Page 1622: ...current licenses available for the license injected application s set the license limits set the overdraft license limits and set the queuing behavior Define Access Page Define the handling options fo...

Page 1623: ...then each executable creates its own license file with identical options to other selected executables Only show executable files with associated components with shortcuts By default only the applicat...

Page 1624: ...le for peak usage Set an expiration date for the licenses Select this option to make the licenses for this package expire on a certain date By default this option is not selected Licenses expire on Sp...

Page 1625: ...he default selection if grouping concurrent license requests Site All concurrent requests from the same site use only one license Restrict access by hostids listed below Select this option to allow ac...

Page 1626: ...icense file on the local machine By default this is unselected Allow host name and port redefinition at install time In order to accommodate the use case of having multiple servers across different lo...

Page 1627: ...to a subfolder of this output folder By default the files will be copied to the path specified on the FLEXwrap Assistant Options dialog box which is opened by selecting Options on the Tools menu Updat...

Page 1628: ...Table 21 10 Permitted Hostid Dialog Box Options Option Description Hostid Type Select the type of hostid that you want to use to restrict application usage The following types of hostids are supporte...

Page 1629: ...e Package Page to imitate the creation of a wrapped package the Output Window opens and displays the messages that are generated during the process including error messages To copy these comments so t...

Page 1630: ...ich is transparent to the user Wrapper obtains location of License Server The Wrapper obtains the location of the FLEXwrap License Server from the server location file lf or the SWRAP_LICENSE_FILE env...

Page 1631: ...ense Server For detailed information on using the FLEXwrap Server Configuration Tool see Managing FLEXwrap License Files Supported Platforms Applications that run on Microsoft Windows 95 or later can...

Page 1632: ...Server not be run as root The license file generator swsetup32 exe and swcrypter exe however should be protected from execution by your general user community License Server daemons need to be install...

Page 1633: ...LEXnet Manager For more information see Managing FLEXwrap License Files and Using the FLEXwrap Server Configuration Tool to Manage the FLEXwrap License Server About the FLEXwrap LMTOOLS FLEXwrap LMTOO...

Page 1634: ...ing services operations are performed on a service which allows starting lmgrd processes local to the system on which LMTOOLS is running For details on configuring services see Configuring FLEXwrap Li...

Page 1635: ...ated automatically Manually If you manually update your FLEXwrap evaluation license file with your production FLEXwrap license information by editing the file you will have to use the FLEXwrap License...

Page 1636: ...you received from AdminStudio Support Key License key provided by AdminStudio Support Count The number of concurrent licenses available for this FLEX enabled application Expiration The date these lic...

Page 1637: ...still be the old one Starting the License Server There are three options for starting the FLEXwrap License Server Note When you purchase FLEXwrap you specify the hostid to which the License Server wi...

Page 1638: ...run as a service 1 Launch the FLEXwrap Server Configuration Tool from the Start menu The FLEXwrap Server Configuration dialog box opens 2 On the File menu click Open and select the FLEXwrap license f...

Page 1639: ...ontrol tab of the FLEXwrap Server Configuration dialog box Task To start the FLEXwrap License Server manually from the FLEXwrap interface 1 Launch the FLEXwrap Server Configuration Tool from the Start...

Page 1640: ...ted by this lmgrd 5 Click the Start Server button All licenses lic in the directory of the opened license are loaded Manually Starting the FLEXwrap License Server from the Command Line You can manuall...

Page 1641: ...king the Status of the FLEXwrap License Server You can check the status of the FLEXwrap License Server on either the Server Control tab of the FLEXwrap Server Configuration dialog box or on the Server...

Page 1642: ...e is displayed Checking the License Server Status from the LMTOOLS Interface You can use the FLEXwrap LMTOOLS utility to check the status of the FLEXwrap License Server Task To check the status of the...

Page 1643: ...e tracked Enter the following at the command prompt C set LM_PROJECT my_project The project name is written to the report log when a license checkout occurs You can then filter summarize and sort on t...

Page 1644: ...pplication to be wrapped and add this FEATURE line to the FLEXwrap license file 2 Start the FLEXwrap License Server Make the FLEXwrap License Server serve licenses for the new feature by issuing a rer...

Page 1645: ...r Failsafe Mode for instructions After you perform these steps no additional setup needs be done by your end users The following diagram provides an overview of the basic steps for wrapping an executa...

Page 1646: ...pped Application Table 21 16 FLEXwrap Server Configuration Tool Options when Wrapping an Executable Option Description Set License Limit Restrict usage of a software application to a specified number...

Page 1647: ...ration dialog box displays the path to this license file and a list of programs if any that have been licensed with FLEXwrap 4 Click New The FLEXwrap Application Information dialog box opens 5 In the...

Page 1648: ...ions The most important advanced option to consider is whether you want the wrapped application to be able to run without being able to check out a license from a running License Server License Failsa...

Page 1649: ...application option 4 Click OK If you selected the Encrypt application check box the Wrapping and Encryption Wizard dialog box opens in which you can specify where you would like a backup copy of the a...

Page 1650: ...the FLEXwrap Application Information dialog box The Wrapping Wizard dialog box opens and you are prompted to select how you want the Wrapper to find the FLEXwrap License Server 12 Select the Host and...

Page 1651: ...n 16 Click Finish A command window and a FLEXwrap dialog box appear 17 Click Check Now to scan repair the registry 18 When the dialog box displays Done click Quit The Wrapping Wizard dialog box should...

Page 1652: ...reports using FLEXnet Manager Task To create an options file 1 Create a plain text file called swrap opt and save it in the same directory with your license file 2 Type a REPORTLOG line in the options...

Page 1653: ...hen lmgrd starts the swrap daemon the daemon will read the options file and append license usage information to the report log Saving the New License File and Wrapped Application Task To save the new...

Page 1654: ...lication up to its license limit and then invoke one more If you have set up license failsafe mode the additional instance of the wrapped application should run If you did not set up license failsafe...

Page 1655: ...relies on the Wrapper contacting the License Server License Server Fail Safe Mode The Wrapper is unable to contact the License Server either because the License Server is not running or because of a n...

Page 1656: ...hing necessary to ensure that the wrapped application can always run Setting Up License Server Failsafe Mode In the case where the Wrapper cannot contact the License Server if port host is the only in...

Page 1657: ...FLEXwrap License Server runs on a different machine from the machine where the wrapped binary resides remove the network dependency by copying the FLEXwrap license file to a drive local to the wrapped...

Page 1658: ...e FLEXwrap software and are used throughout this documentation Table 21 17 FLEXwrap Terminology Term Description Application In this documentation an application consists of one binary file to be put...

Page 1659: ...er The combination of one running lmgrd process and one running swrap vendor daemon process that allows wrapped applications to request and obtain licenses License server failsafe mode A mode of opera...

Page 1660: ...s the field name and explanation of each license parameter Wrapper The FLEXwrap binary which is run when an end user attempts to run a wrapped application swrap_nt exe GUI apps or swrap_ntc exe consol...

Page 1661: ...you have only one license for the suite then while one user was using Word that same user could use products Paint or Mail but a different user could not use any products even Paint or Mail which are...

Page 1662: ...will wait until a license is available When one becomes available the binary will run w_queue 2 Exit Never No queueing Duplicate Grouping FLEXwrap allows you to specify that simultaneous uses of the...

Page 1663: ...GHUP Connection Timeout If the License Server becomes unavailable due to a License Server node failure a License Server process failure or a network communication problem the application will lose its...

Page 1664: ...ld want to specify vi as the argv 0 parameter Another reason to use the argv 0 parameter would be for programs that do an internal restart by calling the exec function When the function which causes t...

Page 1665: ...cryption so they cannot be manually edited without corrupting the FEATURE line Those in lower case are not part of the encryption so they can be changed manually without regenerating the license Table...

Page 1666: ...gular license failsafe mode the wrapped application specified on the FEATURE line can run without obtaining a license if the Wrapper can connect to the License Server To set up License Server failsafe...

Page 1667: ...applications do not work properly unless their name is binary In those cases specify binary as the argv w_queue 1 2 If license cannot be obtained and failsafe is not set 1 Queue automatically 2 Ask i...

Page 1668: ...sed Applications Tab The Licensed Applications tab lists all of the licensed applications in the currently selected License File The following options are included Table 21 20 Server Configuration Too...

Page 1669: ...lete a licensed application from the list Table 21 21 Server Configuration Tool Dialog Box Certificate Tab Option Description Key License key provided by AdminStudio Support Count The number of concur...

Page 1670: ...included Options Tab On the Options tab you can set the path for the Daemon and the Options File Table 21 22 Server Configuration Tool Dialog Box Server Info Tab Option Description Server Name Name o...

Page 1671: ...ion Tool Dialog Box Options Tab Option Description Daemon Path If your swrap daemon is located in the same folder as the FLEXwrap Server Configuration tool lmgrd exe you can leave the Daemon Path fiel...

Page 1672: ...log or select an existing debug log If you do not specify a debug log when you start the License Server at least two console windows will appear one for the lmgrd output one for the swrap output and o...

Page 1673: ...ins a license it will run binary orig or binary fwr in the directory from which the Wrapper ran If you want it to run a different binary specify the full path to the binary name here This will become...

Page 1674: ...display advanced options Suite If you want to treat the selected executable files as a suite enter a suite name in this field A suite is a group of independent programs which must for licensing purpos...

Page 1675: ...ou to specify that simultaneous uses of the wrapped application by the same user or host or user host combination etc will not require a license The default is that each process requires its own licen...

Page 1676: ...st license Exiting Terminate signal Some applications require a special shutdown signal in order to perform application specific cleanup FLEXwrap will normally send a SIGHUP to the application but if...

Page 1677: ...h to wrap and click Next Ver 5 signature 20 digits with embedded start date Select this option if you want to generate 20 digit license keys with an embedded start date The default length of the licen...

Page 1678: ...s are included Identify Location of Original Binary Panel On this panel you are prompted to identify the location where you want FLEXwrap to save a copy of the original binary prior to wrapping Table...

Page 1679: ...Ready to Wrap Panel To begin wrapping the selected package click Finish Encryption Wizard The Encryption Wizard includes the following panels Select Application Panel Location for Original Binary Pan...

Page 1680: ...d to identify the location where you want FLEXwrap to save a copy of the original binary prior to encryption Ready to Encrypt Panel To begin encryption of the selected package click Finish Wrapping an...

Page 1681: ...e prompted to identify the path to the License Server You can choose to enter a host and port number or a path to the location of the license file The following options are included Table 21 27 Wrappi...

Page 1682: ...0 AdminStudio 9 5 User Guide Original Binary Location Panel On this panel you are prompted to identify the location where you want FLEXwrap will save a copy of the original binary prior to encryption...

Page 1683: ...nd Dialog Box When the Wrapping Wizard is finished this dialog box opens informing you that FLEXwrap must now scan the Registry and repair any file associations that were improperly modified during th...

Page 1684: ...ens when an invalid license key was entered in the License Packs Key field on the Certificate Tab of the FLEXwrap Server Configuration Dialog Box You should check to see whether the Key was entered co...

Page 1685: ...UG00 1685 Part 6 Using AdminStudio Enterprise Server Tools This part of the User Guide includes the following chapters Generating and Viewing Reports in Report Center Automating Tasks Using Job Manag...

Page 1686: ...1686 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1687: ...by entering an SQL query in the Report Wizard See Generating a Custom SQL Query Report for AdminStudio Generating and Viewing AdminStudio Reports You can use Report Center to obtain a centralized vie...

Page 1688: ...ewed on this page Generating a Package Report Explains how to generate a Package Report on a selected package Also explains how to filter the package tree by specified criteria in order to find a spec...

Page 1689: ...wing AdminStudio Reports AdminStudio 9 5 User Guide ADS 0950 UG00 1689 About the Package Report Tab of the Report Center You generate most AdminStudio reports on the Select Package page on the Package...

Page 1690: ...ges meeting that criteria are listed and the Show All packages button is enabled Package or Group Summary Area In the top half of the right side of the interface either a summary of group statistics w...

Page 1691: ...ion Product Version Version of package that is recorded in the package s Windows Installer file Manufacturer Company that authored the package Import Date The date and time the package was imported in...

Page 1692: ...The Package Summary information is listed Note To filter the package tree by specific criteria perform a search as described in Searching for a Package on the Select Package Page 3 Click View Report T...

Page 1693: ...g fields are available 2 Enter values in the criteria fields that you want to search on You can search for packages in the Application Catalog based on metadata in three categories Package Attributes...

Page 1694: ...Installer ProductVersion property for this package Package Code Enter the GUID that identifies a particular Windows Installer msi package The Package Code associates an msi file with an application or...

Page 1695: ...sion 2 0 but has a different UpgradeCode than Product B Setup File Name Name of the Windows Installer msi file that was imported into the Application Catalog Comments Enter the text of any comments as...

Page 1696: ...ODBC DS View Extended Attributes View Validation View Conflicts View History View Dependencies View Table 22 7 Application Request Attributes Search Fields Metadata Description Name Enter the name of...

Page 1697: ...Information Item Description Product Name Name assigned to the package Manufacturer Company that authored the package Import Date The date and time the package was imported into the Application Catal...

Page 1698: ...e 22 5 Package Report Files View For each file the following information is listed In Software Repository Indicates whether or not this package and its associated files are managed by the Software Rep...

Page 1699: ...d Figure 22 6 Package Report Registry View For each registry entry the following information is listed File Size Size of the installed file Component Component that the file is associated with Table 2...

Page 1700: ...Shortcuts View For each shortcut the following information is listed Value The string of data that defines the value of the key Component Package component that the registry entry is associated with...

Page 1701: ...s that implement functions involving ODBC Each database type has its own ODBC driver Figure 22 8 Package Report ODBC Drivers View For each ODBC driver the following information is listed Table 22 12 P...

Page 1702: ...tion on how to connect to that database Figure 22 9 Package Report ODBC Data Sources View For each ODBC DS the following information is listed Table 22 13 Package Report ODBC DS Information Item Descr...

Page 1703: ...ch Extended Attribute the following information is listed Validation View The Validation view lists all of the ICE rule errors and warnings that were generated when the package was validated against M...

Page 1704: ...e 22 15 Package Report Validation Information Item Description ICE Rule Name of ICE Rule that generated an error or warning message Description Error or warning message Error Level Indicates the sever...

Page 1705: ...lved errors that were found when conflict analysis was performed on this package Figure 22 12 Package Report Conflicts View For each error the following information is listed Table 22 16 Package Repor...

Page 1706: ...en performed on this package since it was imported into the Application Catalog Figure 22 13 Package Report History View For each action the following information is listed Table 22 17 Package Report...

Page 1707: ...ing systems in the Application Catalog Figure 22 14 Package Report Dependencies View For each dependency the following information is listed Table 22 18 Package Report Dependencies Information Item De...

Page 1708: ...play more items Instead you can use the Page Scrolling controls in the toolbar Figure 22 16 Page Scrolling Controls on Package Report The total number of pages of the Package Report is listed in the t...

Page 1709: ...er the amount of information displayed on one page does not change Searching for Information in a Package Report You can use the Find box in the Package Report tool bar to search for specific informat...

Page 1710: ...lar to the original report except that it is a multiple page PDF Figure 22 18 Archived Package Report Note In an archived Package Report PDF the navigation links at the top of the report Files Registr...

Page 1711: ...Task To delete an archived Package Report from the Archived Reports list 1 In the Archived Reports list on the All Reports page right click on the archived report you want to delete and then click Del...

Page 1712: ...ort The Enter SQL Query Panel opens 4 Enter an SQL Query to retrieve the data for this report Click the Test Query button to verify the query syntax Tip To assist you in writing queries to retrieve da...

Page 1713: ...tuation Rule When no wildcards are used If you do not enter a wildcard character in the Search box then Report Center performs a LIKE search which searches for any occurrence of that text anywhere in...

Page 1714: ...eport Viewing an Existing Custom Report from the All Reports Page To view a report click View to launch the Report View Report View The Report View which is opened by clicking View next to an existing...

Page 1715: ...groups and packages in the AdminStudio Enterprise Server Application Catalog are displayed in a tree control If a search has been applied using the fields in the Search Packages area only those packag...

Page 1716: ...mary Information When a package in the package tree is selected summary information about that package is listed Figure 22 20 Package Summary on the Select Package Page Table 22 22 Group Summary Infor...

Page 1717: ...ou want to search on and click Search The packages that meet any of the criteria are then listed in the package tree in alphabetical order and are no longer grouped Package Attributes You can search f...

Page 1718: ...gh F Upgrade Code Enter the GUID that identifies the family of products that are in the same upgrade path The UpgradeCode is a Windows Installer property and is represented as a string GUID a text str...

Page 1719: ...on INI File Enter any changes to an ini file that are made when the product is installed Shortcut Enter any shortcuts that are created when the product is installed Table 22 26 Application Request At...

Page 1720: ...the Package Summary Information view and it lists the following information Table 22 27 Package Report Package Summary Information Item Description Product Name Name assigned to the package Manufactur...

Page 1721: ...associated files are managed by the Software Repository Table 22 28 Package Report Files Information Item Description File Name of file included with this package Target Directory Name of directory w...

Page 1722: ...ifies the source database type and provides information on how to connect to that database For each ODBC DS the following information is listed Table 22 30 Package Report Shortcuts Information Item De...

Page 1723: ...error or warning the following information is listed Driver Description Name of this ODBC data source s associated ODBC driver Component Component that this ODBC data source is affiliated with Table 2...

Page 1724: ...n Catalog For each dependency the following information is listed Table 22 35 Package Report Conflicts Information Item Description ACE Rule Name of ACE Rule that generated the message Description Mes...

Page 1725: ...You can combine the LIKE operator with a wildcard character and the following rules apply Table 22 38 Select Report Type Panel Options Option Description Custom Report Select to create a custom report...

Page 1726: ...next to the Report Name on the All Reports page Summary Panel On the Summary Panel of the Reports Wizard the following information is listed Click Finish to generate the Report The report is generated...

Page 1727: ...es AsJob AsJobQueue AsJobStep cstblPackage The cstblPackage table is the core table that contains information about imported packages This table contains a unique Package ID the RowID column that is r...

Page 1728: ...int N The value of the equivalent MSI ProductLanguage FileName text N UNC path to the MSI package Name can be up to 255 characters long Comments text N User description of the package Comments can be...

Page 1729: ...s Columns Column Type Key Nullable Description RowID int Y N The Primary Key used to uniquely identify a record GroupName text N Name of group Name can be up to 72 characters long Description text N D...

Page 1730: ...32 N N The user provided name for the job UserName Varchar 255 N N The user name that created this job and derived as part of the Enterprise Server login process JobType Varchar 5 N N A string identi...

Page 1731: ...column This value identifies which job is associated with this job queue entry UserName Varchar 255 N N The name of the user who added this job to the job queue and derived as part of the Enterprise...

Page 1732: ...s associated JobIOrder Int N N The ordinal number in which the job step is executed when the job itself is executed StepId_ Int N N Foreign key into the AsJobStepMaster table which identifies the type...

Page 1733: ...ase Table Schema Diagram The following diagram illustrates the relationship between Workflow Manager tables AMS_Issues Table Stores all the issues and their properties AMS_AuditTrail Table Stores audi...

Page 1734: ...Chapter 22 Generating and Viewing Reports in Report Center Report Center Reference 1734 ADS 0950 UG00 AdminStudio 9 5 User Guide Figure 22 21 Workflow Manager Database Table Schema Diagram...

Page 1735: ...this Application Request was created UploadBy This column stores the Person ID of the user who created this Application Request More information about this user can be found from AMS_Person table usi...

Page 1736: ...m Table Column Information Column Description ApplicationItemID Primary key of this table ApplicationID This value in this column indicates the Application that this Item belongs to User can find furt...

Page 1737: ...be found from AMS_Company table FName This column contains the First Name of the User LName This column contains the Last Name of the User UserName The value in this column is used to login into Workf...

Page 1738: ...rties Table 22 51 AMS_ApplicationStatus Table Column Information Column Description StatusID Primary Key of this table Status_Text Name of the Status such as Completed IsActive If the value of this co...

Page 1739: ...rolled back Status This column stores the status of the issue as integer values they are as follows 0 New Created Issue which are not read 1 Issue is already read 2 Issue is already responded 3 Issue...

Page 1740: ...r This ID is the AMS_WFMajorItemTpl table primary key hence this ID can be used as join in AMS_WFMajorItemTpl table to get more information about this Workflow Phase WFMinorItemId This column stores t...

Page 1741: ...MM SS AM PM when the audit was created ChangedBy This column stores the ID for the User whose actions created the audit This ID is AMS_Person table primary key hence this ID can be used as join in AMS...

Page 1742: ...in Workflow Data Entry Step 204 EmailWFAdvance When email is sent to user for Workflow Step advancement 205 EmailIssueRespond When any issue is responded 291 DataSubmit_Begin User opens data submissio...

Page 1743: ...22 56 AMS_Contracts Table Column Information Column Description ContractID This column stores the primary key value for this table which can identify each contract project uniquely ContractName This...

Page 1744: ...This column stores the Template ID of the Template that used to create the Workflow for the Application Request created from this project More Information about this Template can be found from AMS_Te...

Page 1745: ...ion About Job Manager Describes the purpose of Job Manager and the types of tasks that you can automate Directory Monitoring and Job Manager Describes how the Directory Monitoring Job Step can be incl...

Page 1746: ...is deployed in your enterprise such as checking against specific ICE or ACE rules and against a specific operating system Dynamic group content identification You can create a Job that will perform ac...

Page 1747: ...is used primarily to enhance the quality of any future Patch Impact Analysis operation that may be performed on this package Directory Monitoring You can use the Directory Monitoring Job Step to esta...

Page 1748: ...CE and ACE rules in the conflict analysis based upon requirements specific to that target environment In Template Jobs Target packages are selected when a Template is created Source packages are selec...

Page 1749: ...Job Step that performed the import Figure 23 1 Contextual Packages Group Dynamic Group Content Identification You can create a Custom or Template Job that will perform actions on whatever packages are...

Page 1750: ...When defining a Resolution Job Step you have to indicate the reimport option for resolved packages When defining a Resolution Job Step you have the choice of three re import options for resolved packa...

Page 1751: ...those packages into the Application Catalog This is equivalent to using the Application Manager Package Auto Import Wizard to automatically import packages from a network directory Note See About Aut...

Page 1752: ...have the choice of either creating a Job based on a Template or a new Custom Job Template Job A Job based on a Template consists of a series of pre defined Job Steps See Creating a New Job Based on a...

Page 1753: ...cting one of the following options from the Execution list Immediate Execute this Job immediately Scheduled Execute this Job at the Date and Time selected Note You can also choose to set this job to r...

Page 1754: ...lication Catalog Validation Verifies the internal data integrity of a Windows Installer package Conflict Detection Performs conflict detection on selected packages using Conflict ACE Rules Import Impo...

Page 1755: ...4 View opens 3 Select the target packages or groups of packages that you want to use in the conflict detection process and click Next The Step 4 of 4 View opens 4 Select the set of Conflict ACE Rules...

Page 1756: ...imported reimported package or packages from the previous Steps To make these packages available for selection when defining subsequent Job Steps they are listed in the Contextual Packages group in t...

Page 1757: ...p as a Source for a subsequent Job Step that Step s action will be performed on all of the newly imported or reimported packages 10 Schedule this Job by selecting one of the following options from the...

Page 1758: ...Name Execution options Step Type Scan for Dependencies Job Step Selected packages and groups Directory Monitoring Job Step Directory to monitor Option to monitor subdirectories Validation Job Step Se...

Page 1759: ...ueue page click the date and time listed in the Schedule column for the Job you want to reschedule The Schedule Job page opens 2 Select either For Immediate Execution or For Scheduled Execution If you...

Page 1760: ...eld enter the email addresses that you want to be notified when a Job is completed or when it fails Separate multiple email addresses with a semicolon 4 In the Subject box enter text to describe the p...

Page 1761: ...I specific property from package ProductName MSI specific property from package Manufacturer MSI specific property from package ProductLanguage MSI specific property from package FileName Base file pa...

Page 1762: ...led before it was executed or before its execution was complete Failed Job was unable to run either because of a software error a network communication problem a hardware failure or any other reason D...

Page 1763: ...The System Administrator could create a Template that uses those specific target applications and could include very specific ICE and ACE rules in the conflict analysis based upon requirements specifi...

Page 1764: ...The Job Template List page lists all defined Templates From this page you can Add a new Template Edit an existing Template or Delete a Template Task To create a new Template 1 Login to AdminStudio En...

Page 1765: ...the Step Step Type Required Selections Scan for Dependencies Click Next to save this Job Step Source packages will be selected when a Job based on this Template is created Directory Monitoring 1 Click...

Page 1766: ...on the Add Job page Editing an Existing Template You can edit an existing Template by selecting the Template on the Job Template List page to open the Edit Template page Task To edit an existing Temp...

Page 1767: ...Queue page opens 3 Click the Manage Templates tab The Job Template List page opens 4 Click Delete in the Action column of the Template that you want to delete The Delete Template page opens prompting...

Page 1768: ...Checks for the existence of the same file in components with different ComponentIds ACE03 Checks to see if components in different packages that have matching ComponentIds also contain the same files...

Page 1769: ...Setting Configuration Options About Job Manager Engine The Job Manager Engine s Manage Application Catalogs View lists the Catalog Name of each of the Application Catalogs that it is connected to the...

Page 1770: ...it is still automatically minimized and its icon is shown in the Windows system tray If you want to view the Job Manager Engine interface click on the Job Manager Engine system tray icon The Manage A...

Page 1771: ...be connected to one Job Manager Engine at a time Pausing Shutting Down and Restarting Application Catalog Jobs From the Manage Application Catalogs View of Job Manager Engine you can Pause Shutdown an...

Page 1772: ...down Application Catalog and click Run Restart the restart operation will need to relaunch and initiate the background thread for the Application Catalog and therefore a Shutdown Application Catalog t...

Page 1773: ...hoose to install Job Manager Engine on a different server you can set the following configuration options from the Job Manager Engine interface Conflict Detection Configuration Validation Configuratio...

Page 1774: ...n the following location on the machine where AdminStudio is installed C AdminStudio Shared ConflictSolver CustomConflictFile ace Only one user defined ACE file can be active at one time Table 23 10 V...

Page 1775: ...ver the mail will attempt to come in to your server on Port 25 This is the standard SMTP Simple Mail Transport protocol port Port 2525 is an alternate port used by forward services This is a non stand...

Page 1776: ...b set for immediate execution will be automatically assigned a Pending job status Complete Job has been executed Canceled Job was canceled before it was executed or before its execution was complete F...

Page 1777: ...entify the Job Template Select this option and select a Template from the list to create a Template Job Package List Select the package s or group s to be used by the Job Template If you select a grou...

Page 1778: ...idation Verifies the internal data integrity of a Windows Installer package Conflict Detection Performs conflict detection on selected packages using Conflict ACE Rules Best Practice Detection Perform...

Page 1779: ...e Step 2 of 2 View opens 2 Select the packages or groups of packages that you want to validate 3 Click Finish to save this Job Step Conflict Detection 1 Click Next The Step 2 of 4 View opens 2 Select...

Page 1780: ...u have finished editing the Job click Save Best Practice Detection 1 Click Next The Step 2 of 2 View opens 2 Select the packages or groups of packages that you want to perform Best Practice conflict d...

Page 1781: ...bdirectories Validation Job Step Selected packages and groups Conflict Detection Job Step Selected source packages and groups Selected target packages and groups Set of conflict detection rules to use...

Page 1782: ...he Schedule column for the Job you want to reschedule The Schedule Job page opens The Schedule Job page includes the following options Table 23 18 Schedule Job Page Options Option Description Execute...

Page 1783: ...s current status is listed as a hyperlink in the Status column If you click on this hyperlink the Job Status page opens displaying the Job Name and Job Status and the status of each of the Job Steps i...

Page 1784: ...a network communication problem a hardware failure or any other reason Click Back to return to the Jobs Queue page Job Template List Page The Job Template List page lists all defined Templates From th...

Page 1785: ...About Automatically Importing Packages from a Network Directory for more information Validation Verifies the internal data integrity of a Windows Installer package Conflict Detection Performs conflic...

Page 1786: ...ource packages will be selected when a Job based on this Template is created Conflict Detection 1 Click Next The Step 2 of 3 view opens 2 Select the target packages or groups of packages that you want...

Page 1787: ...Ids and checks those components to see if the versions of the files in each component match ACE07 Checks for the existence of the same file in components with different ComponentIds ACE03 Checks to se...

Page 1788: ...ries with the same registry hive key and value name have the same data type and value ACE10 Checks for the existence of identical Root Key Name registry combinations in components with different Compo...

Page 1789: ...e the connection of Job Manager Engine to an Application Catalog Note When you delete an Application Catalog from Job Manager Engine it will first shut down the Application Catalog allowing any curren...

Page 1790: ...e following location on the machine where AdminStudio is installed AdminStudio Installation Directory ConflictSolver Support Custom ACE File You use user defined custom ACEs to extend the functionalit...

Page 1791: ...crosoft to ensure an installation package works correctly with the Windows Installer engine The file specified in this field is file containing Internal Consistency Evaluators ICEs used for validation...

Page 1792: ...Chapter 23 Automating Tasks Using Job Manager Job Manager Reference 1792 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1793: ...udio Client Tools Help Library You can also view the AdminStudio Public API Reference on HelpNet at http helpnet flexerasoftware com Robo BIN Robo dll tpc robo projects as90api html ASAPIIntro htm Not...

Page 1794: ...Chapter 24 AdminStudio Public API Reference 1794 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Page 1795: ...0003 Application File Missing 750 10004 INI File Missing 751 11000 Excluding TCPIP Registry Entries 751 11001 Fail on VMware 752 11003 Control Panel Applet Citrix 752 11004 Control Panel Applet ThinAp...

Page 1796: ...731 9131 Unable to Resolve Installer Variable 732 9132 16 Color Shortcut Icon Not Found 732 9133 Shortcut Icon Not Found 732 9134 Failure to Extract Icon from Executable 733 9135 Shortcut Target is 16...

Page 1797: ...1157 ACE23 1110 1159 1593 ACE24 1110 1160 1593 ACE25 1162 ACE26 1162 ACE27 1163 ACE28 1164 ACE29 1165 ACE30 1165 ACE31 1166 ACE32 1167 ACE33 1168 ACE34 1168 ACE35 1169 ACE36 1170 ACEs 1133 1134 1138 1...

Page 1798: ...onal server locations 1039 configuring 1039 Additional Setup Programs dialog box 460 510 Repackaging Wizard 460 510 ad hoc import 228 ad hoc test results about 1282 adding 1282 administration copying...

Page 1799: ...Studio Workflow Manager See Workflow Manager Advanced Client 1491 advanced conversion options 537 configuring Repackager 537 Advanced Marimba Options dialog box 1463 Advanced Options dialog 370 1357 1...

Page 1800: ...ication 403 tables included excluded in 402 wizards 359 Application Catalogs merge replication using SQL Server 294 Application Configuration view 1077 Tuner 1077 Application Conflict Evaluators 1133...

Page 1801: ...ext menus 310 copying packages to multiple groups 221 creating a shortcut to a specific Application Catalog 436 deleting groups 221 deleting packages 228 Dependency view 337 editing groups 221 Exclusi...

Page 1802: ...Changes 321 325 328 Merge Module 324 336 Merge Modules 322 OS Snapshot 324 Other Setup Types 326 Product 317 Products 338 Registry 321 325 329 Shortcuts 322 326 330 Tables 323 326 330 Application Man...

Page 1803: ...heritance of isolation options in the registry 801 integration of Windows Services 651 launching 768 location of generated files 541 650 770 managing files and folders 784 Manifest file 650 methods to...

Page 1804: ...RTSP protocol 781 RTSPS protocol 781 selecting releases to build 804 setting isolation options 792 setting isolation options for folders and files 793 setting isolation options on files 835 setting i...

Page 1805: ...siness rules 1174 1176 C C 424 432 433 434 C1083 error 1181 CAB file 658 CAB files 1019 Tuner 1019 CAPS Client Access Points 1491 Captured Installation view 592 capturing OS snapshots 300 302 CARD 113...

Page 1806: ...to build 962 Service Packs Requirement dialog box 990 setting isolation options 949 setting isolation options for folders and files 952 setting isolation options on files 985 setting isolation option...

Page 1807: ...ient Access Points CAPS 1491 Client Agent 1491 code signing 1350 certificate name in the store 1350 credentials 1350 Collect Product Information panel 501 Repackaging Wizard 501 collection 1491 COM ap...

Page 1808: ...Administration Page 1537 package definition file 1519 package settings 1498 programs 1504 reference 1517 saving a package on Configuration Manager Server 1514 Select a Configuration Manager Collectio...

Page 1809: ...abase 1101 ConflictSolver tab on InstallShield Editor Options dialog 1001 connecting to an existing Application Catalog 1095 Consolidated Patch Report 1335 context menus 1198 Crystal Reports 1127 cssy...

Page 1810: ...ckager 3 x output 523 SMS projects 523 WinINSTALL projects 527 Wise Installation projects 527 copying 221 packages to multiple Application Manager groups 221 roles 196 Create a new transform file opti...

Page 1811: ...ce 1412 running silently 1412 description file 223 Application Manager extended attributes 223 Description property 1014 editing for features 1014 description property 1015 Destination Group panel 371...

Page 1812: ...izard 1478 Distribution Type panel 1456 Distribution Wizard 1456 Distribution Wizard 1427 1428 1429 1431 1433 1435 1436 1437 1438 1444 1448 1453 1455 1456 1457 1459 1460 1461 1462 1463 1464 1465 1466...

Page 1813: ...crosoft App V support 73 batch convert option 73 evaluation files 1008 1012 evaluation license file obtaining 1635 Exclude Element 674 Excluded Processes dialog box 511 excluding files 554 exclusion l...

Page 1814: ...33 extended attributes tables 406 Extended Attributes view 319 324 327 328 Application Manager 319 324 327 328 external configuration file 558 559 modifying Repackager 559 specifying in Repackager 558...

Page 1815: ...ular license failsafe modes 1655 specifing license parameters 1660 starting the license server 1637 stopping the license server 1641 terminology 1658 testing a wrapped application 1654 tracking projec...

Page 1816: ...Import Conflict Options panel 1085 Import Registry File panel 1085 Welcome panel 1085 Import Registry File panel 1085 Import REG File Wizard 1085 Import Tab 314 1200 Import tab 1234 in ConflictSolver...

Page 1817: ...ard 503 InstallScript Scan 441 489 InstallShield about the virtualization Assistants 760 App V Assistant 763 Citrix Assistant 927 integration of App V Assistant 760 integration of virtualization Assis...

Page 1818: ...he Software Repository 1750 contextual packages 1749 creating a new Custom Job 1753 creating a new Job 1752 creating a new Template 1764 Custom Jobs 1749 deleting a Job 1762 deleting a Template 1767 d...

Page 1819: ...58 Application Isolation Wizard 1358 Manifest Options tab 1358 Advanced Options dialog 1358 Manifests 1362 manifests 548 1349 1364 application 548 1349 assembly 548 1349 checking in QualityMonitor 138...

Page 1820: ...mm 513 mode 513 Modify button 1042 disabling in Add Remove Programs 1042 modifying INI file actions 1027 modifying INI file keys 1027 modifying INI file values 1027 MoveFileData ACE 1166 mp 513 ms 51...

Page 1821: ...ODBC driver attributes 1030 editing ODBC data source attributes 1031 editing ODBC driver attributes 1031 removing existing ODBC data sources from 1031 removing ODBC data source attributes from 1032 o...

Page 1822: ...onfiguration Manager Web Console 1496 Package Administration Page Configuration Manager Web Console 1537 package and transform file tables 406 Package Auto Import 263 264 267 268 269 270 Application M...

Page 1823: ...alog 1270 reference 1293 resolving a manual test 1289 1290 resolving errors 1285 run status 1300 running a manual test 1289 sample manual test 1291 Select a Package dialog box 1313 setting default tes...

Page 1824: ...387 deleting roles 196 Job Manager 1751 limiting tool accessiblity 120 minimum for AdminStudio 387 persisted conflicts 1118 deleting 1118 persistence 1118 person disabling their user account 159 Pers...

Page 1825: ...duct code conflicts 1110 Product Info and Update URL 1078 Product Information view 1412 Product Name Change dialog 273 product properties 1014 1015 default destination 1014 default organization 1014 d...

Page 1826: ...URL 1078 publishing 279 Application Catalog 279 282 database 282 PunchThrough Element 674 pv 513 PVKFile 1362 Q Q 424 435 QualityMonitor 1365 1367 1371 1375 1376 1377 1378 1379 1380 1381 1382 1384 139...

Page 1827: ...3 Repack ini file 632 Repack log 629 Repackaged Output view 528 601 605 building InstallShield Editor projects 528 building MSI packages 528 creating virtual applications 640 Repackager 441 446 451 51...

Page 1828: ...ckage conversion options 537 606 Package Information view 605 Password Required dialog box 588 Project Properties dialog box 589 Registry Entries view 595 remote repackaging on Windows NT4 451 Repacka...

Page 1829: ...bscribing to more than one Publication 281 tables included and excluded 402 updating a subscription manually 281 293 Replication Command Line Options dialog 424 Report Center 1687 1714 available repor...

Page 1830: ...ncies 1210 ConflictSolver 1210 scanning for dependencies 1100 option disabled 1100 packages in software repository 1100 Scanning Media panel 612 SmartScan Wizard 612 Scanning panel 611 Scanning projec...

Page 1831: ...s 557 1022 1023 1024 1025 1069 1071 1072 1379 changing icon for 1023 changing location for 1024 changing target for 1024 checking 1379 creating 1023 creating a hot key for 1024 determining path of cha...

Page 1832: ...1465 Specifying duplicate package identifiers in Application Manager 232 SQL Express 208 SQL Server merge replication 294 preferred authentication mode 266 SQL Server Enterprise Manager 281 using to c...

Page 1833: ...71 viewing 1371 Test Item Information dialog 1410 Test Items 1368 1369 1370 1374 adding comments 1370 manually setting status 1374 running individual 1368 running multiple 1369 Test Packages panel 697...

Page 1834: ...ization for linked applications 910 selecting application shortcuts 864 Setting AppLink options 877 setting AppSync Expiration settings 881 setting folder isolation options 904 setting isolation optio...

Page 1835: ...3 ThinAppPackage directory 848 TimeStampAssemblies 1362 Tivoli 1438 using Distribution Wizard to prepare packages for 1438 Tivoli Integration panel 1464 Distribution Wizard 1464 Tivoli Settings panel...

Page 1836: ...venting installation of files from the Windows Installer package 1018 removing added files 1019 removing custom setup properties 1043 removing existing ODBC data sources 1031 removing INI file keys 10...

Page 1837: ...ACE rules 1174 1176 user defined ACEs 1175 1183 1184 deleting 1184 editing 1183 User Defined Tests view 1423 Test Case view 1423 users adding to a publication access list 288 deleting 160 People Admin...

Page 1838: ...porting into Application Catalog after import of Windows Installer package 239 manually associating with Windows Installer package 241 testing prior to conversion 666 Virtual Suite conversion type 643...

Page 1839: ...4 converting a group of applications to a virtual suite 643 converting to App V applications 639 converting to Citrix profiles 639 custom rules 683 custom rules reference 674 Edit Windows Installer Pa...

Page 1840: ...Options panel in Import INI File 1084 Import Conflict Options panel in Import REG File 1085 Import INI File 1084 Import INI File panel in Import INI File 1084 Import REG File 1085 Import Registry Fil...

Page 1841: ...Nworks Configuration Management Server Login 1479 ZENworks Desktop Application Panel Distribution Wizard 1472 ZENworks Desktop Application panel 1472 ZENworks Desktop Management Agent installing 524 Z...

Page 1842: ...Index 1842 ADS 0950 UG00 AdminStudio 9 5 User Guide...

Search results

Summary of Contents for ADMINSTUDIO 9.5

Reviews:

Related manuals for ADMINSTUDIO 9.5

Brands by name

Popular brands

Novell ADMINSTUDIO 9.5, User Manual

Search results

Summary of Contents for ADMINSTUDIO 9.5

Reviews:

Related manuals for ADMINSTUDIO 9.5

Brands by name

Popular brands