Novell ADMINSTUDIO 9.5 User Manual

Hide thumbs Also See for ADMINSTUDIO 9.5:
Table of Contents

Advertisement

AdminStudio 9.5
User Guide
Version 9.5

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ADMINSTUDIO 9.5 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Novell ADMINSTUDIO 9.5

  • Page 1 AdminStudio 9.5 User Guide Version 9.5...
  • Page 2 AdminStudio 9.5 User Guide Part Number: ADS-0950-UG00 Product Release Date: 11/23/2009 Copyright Notice Copyright © 2001–2009 Flexera Software, Inc. and/or InstallShield Co. Inc. All Rights Reserved. This product contains proprietary and confidential technology, information and creative works owned by Flexera Software, Inc. and/or InstallShield Co.
  • Page 3: Table Of Contents

    1 AdminStudio 9.5 Help Library ........
  • Page 4 Modifying Command-Line Configurations for an Existing Tool ..........117 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 5 Options Dialog Box ................143 AdminStudio 9.5 User Guide...
  • Page 6 Logging in as a Guest............... . .172 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 7 Connecting AdminStudio Client Tools to a Standalone Application Catalog ......209 AdminStudio 9.5 User Guide...
  • Page 8 Importing Other Setup Types ..............247 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 9 Setting a Publication Schedule..............287 AdminStudio 9.5 User Guide...
  • Page 10 Marimba NCP Files Views..............327 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 11 Task Scheduling Dialog Box ..............357 AdminStudio 9.5 User Guide...
  • Page 12 ISSnapshot.ini File ............... . .377 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 13 ..............415 AdminStudio 9.5 User Guide...
  • Page 14 About Repackaging on Clean Systems ............446 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 15 InstallScript MSI Identified Panel ..............503 AdminStudio 9.5 User Guide...
  • Page 16 Converting a Novell ZENworks Project Using the Repackager Interface....... .524...
  • Page 17 Repackager Interface Reference .............576 AdminStudio 9.5 User Guide...
  • Page 18 Edit Registry Key Dialog Box ..............622 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 19 Testing App-V Applications Using the App-V Application Launcher ....... . .684 AdminStudio 9.5 User Guide...
  • Page 20 Warning -9031: RemoveFile Table ............. . .716 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 21 Warning -9137: Destination Directory Cannot Be Found..........734 AdminStudio 9.5 User Guide...
  • Page 22 Fix 11000: Excluding TCPIP Registry Entries............751 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 23 App-V Applications and the Virtual Environment...........796 AdminStudio 9.5 User Guide...
  • Page 24 Creating ThinApp Applications ............. . .842 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 25 Setting AppLink Options ..............877 AdminStudio 9.5 User Guide...
  • Page 26 How Requirements are Applied at Runtime ............941 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 27 Building Citrix Profiles Using the Command Line ...........991 AdminStudio 9.5 User Guide...
  • Page 28 Preventing Installation of Files from the MSI ............1018 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 29 Setting the NT Service Type ..............1035 AdminStudio 9.5 User Guide...
  • Page 30 Properties Dialog Box ............... .1056 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 31 Import REG File Wizard ............... . .1085 AdminStudio 9.5 User Guide...
  • Page 32 Changing Default Conflict Types Checked ............1111 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 33 ACE13 ..................1149 AdminStudio 9.5 User Guide...
  • Page 34 CARD06................. . .1189 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 35 Conflict Information Dialog Box ..............1224 AdminStudio 9.5 User Guide...
  • Page 36 About PackageExpert ..............1254 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 37 Custom Test Results Editor Dialog Box ............1309 AdminStudio 9.5 User Guide...
  • Page 38 Assemblies ................1348 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 39 Manually Setting Test Case Status..............1373 AdminStudio 9.5 User Guide...
  • Page 40 General Tab ................1406 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 41 Distributing Packages to Network Locations ..........1435 AdminStudio 9.5 User Guide...
  • Page 42 Publishing Process Panel ..............1488 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 43 Overview of Predeployment Test Tool Results ............1545 AdminStudio 9.5 User Guide...
  • Page 44 ACE10 ..................1595 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 45 Configure Connection Page ..............1626 AdminStudio 9.5 User Guide...
  • Page 46 FLEXwrap Server Configuration Dialog Box ........... . .1668 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 47 AdminStudio Tables ............... . .1727 AdminStudio 9.5 User Guide...
  • Page 48 About Job Manager Engine ..............1769 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 49 Index ..............1795 AdminStudio 9.5 User Guide...
  • Page 50 Contents ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 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 AdminStudio Interface AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 52 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 53: Part 1: Getting Started

    AdminStudio 9.5 Help Library AdminStudio enables systems administrators to rapidly prepare error-free applications to deploy into their enterprise environment through a structured process built on application management best practices. AdminStudio Start Page provides quick access to AdminStudio tools, product information, recently opened files, and InstallShield resources.
  • Page 54: Part 3: Repackaging And Customizing Installations

    Chapter 1: AdminStudio 9.5 Help Library Table 1-1 • AdminStudio Help Library (cont.) Topic Content Managing Roles and Explains how to create and edit roles to manage access to Permissions AdminStudio functionality. Managing Application Catalog Explains how to use Application Manager to import...
  • Page 55: Part 5: Preparing Installations For Deployment

    Chapter 1: AdminStudio 9.5 Help Library Table 1-1 • AdminStudio Help Library (cont.) Topic Content Identifying and Resolving Explains how to use PackageExpert to automate the operation Package Errors Using of specific tests and resolutions against Windows Installer PackageExpert (.msi) software packages. PackageExpert can check the integrity of your Windows Installer packages, and identify and resolve any issues relating to Windows Vista OS deployment.
  • Page 56 Note • In October 2009, Acresso Software changed its name to Flexera Software, Inc. AdminStudio 9.5 includes the new name Flexera Software. The AdminStudio Editor features functionality from InstallShield 2010 Service Pack 1. Because InstallShield 2010 Service Pack 1 was released prior to the name change, it still contains references to Acresso Software.
  • Page 57 What’s New in AdminStudio 9.5 InstallShield 2010 SP1 AdminStudio 9.5 now includes InstallShield 2010 SP1, which offers many new features and enhancements that will help you use the latest technologies and save time on everyday tasks. InstallShield 2010 SP1 includes the following new features and enhancements: •...
  • Page 58 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 • Windows Installer 4.5 Prerequisites for Windows Vista Systems • Dependency Scanning and COM Extraction Now Exclude Protected Windows 7 Files and Registry Entries Ability to Target Windows 7 and Windows Server 2008 R2 Systems InstallShield now enables you to specify that your installation requires Windows 7 or Windows Server 2008 R2.
  • Page 59 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 in a hierarchical format. You can now select multiple properties in this view (by using the mouse and the SHIFT or CTRL button) and then delete them all at once.
  • Page 60 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 New Tool for Scanning an IIS Web Site, Recording Its Settings, and Importing Those Settings into an InstallShield Project InstallShield includes an IIS scanner ( ), a new command-line tool for scanning an existing IIS Web site IISscan.exe...
  • Page 61 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 Two new Windows Installer properties are available when you add an MSI DLL custom action to your project to detect virtual machines: IS_VM_DETECTED and IS_VM_TYPE. The custom action should be configured to call the ISDetectVM function in the file, which is installed with InstallShield.
  • Page 62 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 • The custom option and the SetObjectPermissions function let you configure permissions for a new user that is being created during the installation. The traditional handling does not allow you to do this; the user must already exist on the target system at run time.
  • Page 63 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 • Flash application files can consist of videos, movies, sounds, interactive interfaces, games, text, and more— anything that is supported by the type of file. .swf • InstallShield lets you use , and files as billboards.
  • Page 64 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 installation on Windows 7 and Windows Server 2008 R2 systems. The PCA dialog box indicated that the program might not have installed correctly. This dialog box was displayed if the installation did not create the application uninstallation key.
  • Page 65 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 Windows Installer 5 includes support for setting Shell shortcut properties. Earlier versions of Windows Installer ignore those properties. Ability to Specify a Custom .png Shortcut Icon for the Start Screen on Windows Mobile 6.5 Professional–Powered Devices...
  • Page 66 Chapter 1: AdminStudio 9.5 Help Library What’s New in AdminStudio 9.5 Dependency Scanning and COM Extraction Now Exclude Protected Windows 7 Files and Registry Entries file that is installed with InstallShield has been updated with exclusions for files and registry keys Filters.xml...
  • Page 67 .sft located by the App-V client based on the information in the and manifest files. In AdminStudio 9.5, the .osd wrapper MSI can now search for the file in the same directory as the wrapper MSI, and, if found, it will use this .sft...
  • Page 68: Adminstudio Editions

    Repackager now provides improved functionality when capturing side-by-side assemblies. Enhanced User Folder Handling In Windows 7, user data folders have been moved. Therefore, in AdminStudio 9.5, the handling of Repackager user data has been improved to accommodate these changes. Enhanced International Language Support AdminStudio provides enhanced international language support: •...
  • Page 69 Chapter 1: AdminStudio 9.5 Help Library AdminStudio Editions To meet the needs of organization of every size, AdminStudio 9.5 is available in the following editions. Table 1-2 • AdminStudio Editions Edition Description Standard Standard Edition provides basic repackaging and editing capabilities. Standard Edition includes: •...
  • Page 70 Chapter 1: AdminStudio 9.5 Help Library AdminStudio Editions Table 1-2 • AdminStudio Editions (cont.) Edition Description Enterprise The Enterprise Edition is the enterprise-class solution. It includes Web-based server access with additional security, reporting, and automation tools. Enterprise Edition includes all Professional Edition tools plus: •...
  • Page 71: Activating Adminstudio

    Chapter 1: AdminStudio 9.5 Help Library Activating AdminStudio Activating AdminStudio When you launch AdminStudio or one of its tools for the first time, you are notified that you are using a time-limited trial version, and you are given the opportunity to evaluate the product or to activate it by entering a valid Serial Number for an AdminStudio Edition.
  • Page 72: Evaluating Adminstudio

    You can choose to evaluate AdminStudio for 21 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 AdminStudio Enterprise Server Web tools, you need to contact AdminStudio Sales and obtain an evaluation serial number.
  • Page 73 Chapter 1: AdminStudio 9.5 Help Library Evaluating AdminStudio • When you run AdminStudio in this trial mode, all of its features are fully available. • Each time you open AdminStudio while you are in evaluation mode, this dialog box shows you how many days are left in your trial period.
  • Page 74 Chapter 1: AdminStudio 9.5 Help Library Evaluating AdminStudio Task: To evaluate the AdminStudio Enterprise Server Web tools: Follow the steps in Evaluating AdminStudio Enterprise Edition Client Tools. Contact an AdminStudio Sales Representative and obtain an AdminStudio Enterprise Server Evaluation Serial Number.
  • Page 75: Upgrading Your Product Edition

    Chapter 1: AdminStudio 9.5 Help Library Upgrading Your Product Edition Upgrading Your Product Edition An upgrade feature has been built-in to AdminStudio that allows you to activate features in a higher Edition without re-installing the application. You just need to enter a Serial Number for the upgrade that you purchased, and the features of that Edition are immediately unlocked and are available to you.
  • Page 76 Chapter 1: AdminStudio 9.5 Help Library Using Help • Reader Alert Conventions • Style Conventions Reader Alert Conventions Reader alerts are used throughout this documentation to notify you of both supplementary and essential information. The following table explains the meaning of each alert.
  • Page 77: Contacting Us

    Chapter 1: AdminStudio 9.5 Help Library Contacting Us Table 1-4 • Style Conventions (cont.) Style Example Description Code #define HWND_BROADCAST 0xffff Code snippets appear in a monospace typeface. User- Type Text that is to be entered as a literal value...
  • Page 78 Chapter 1: AdminStudio 9.5 Help Library Contacting Us http://www.flexerasoftware.com ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 79: Using The Process Assistant

    Select an existing non-MSI or legacy application to convert to Windows Installer format and launch the repackaging process. Package Page Select an existing non-MSI or legacy application to convert to Windows Installer format and launch the repackaging process. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 80: Using The Process Assistant

    To navigate from one task page of the Process Assistant to another, click on buttons in the navigation bar: • To navigate directly to a specific page, click the appropriate icon in the navigation bar at the bottom of the page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 81: Home Page

    Because this package is already in Windows Installer format, the repackaging step would not be necessary. • Setup program file (*.exe)—The Package Page opens and you are prompted to repackage this setup program file into Windows Installer format. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 82: Package Page

    Mode (to create a transform) or Direct Edit Mode (to modify the original file). .msi Customize the package using InstallShield Editor. After customization is complete, click Import on the Customize Page to import the converted package into the Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 83: Adding Transforms To An Msi Package

    Delete a transform file from the Transforms list by selecting the transform and clicking the Delete button From the ConflictSolver Operation list, select Detect conflicts for this package or Resolve conflicts for this package. Click Perform to launch conflict detection for this package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 84: Importing Applications Into The Application Catalog

    Conflict Application Resolution Definition (CARD) rules. ACEs that can be automatically resolved by CARDs are referred to as Best Practice ACEs: ACE02, ACE04, ACE05, ACE06, ACE07, ACE15, ACE18, ACE19, ACE20. CARDs resolve errors found by the corresponding ACE of the same number. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 85: Conflictsolver Process Assistant

    Detect Conflicts Check the selected package against target packages to determine if conflicts Page would occur if all of these packages were installed on the same system. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 86: Select A Package Page

    Should that package require patches, set the Would you like to include patch files? option to Yes to enable the patch file fields, and then select the patch files that you want to include using the New, Move Up, Move Down, and Delete buttons, as described above. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 87: Current And New Packages

    After you have selected a package, you can use it in the Validation, Best Practices, Detect Conflicts, Resolve Conflicts, Reporting, and Organize Package tasks of the ConflictSolver Assistant. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 88: Draft Packages

    Page of the Process Assistant. The package will then be visible on the Application Manager View. Note • While it is possible to move a package out of the Draft group before conflict detection and resolution have been performed, it is not recommended. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 89: Creating A New Group

    A patch package does not include a database like a regular installation package (.msi file). Patches contain at minimum two database transforms. One transform updates the information in the installation database of the application. The other transform adds information that the installer uses for patching files. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 90: Extended Attributes Page

    If you do not want ConflictSolver to check for a particular ICE error during subsequent validations of a package, you can choose to suppress it by selecting the ICE error and selecting Suppress from the context menu. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 91: Microsoft Internal Consistency Evaluators (Ices)

    Informational—Information from the ICE that do not indicate a problem with the database. Often they are information about the ICE itself, such as a brief description. They can also provide progress information as the ICE runs. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 92: Configuring Validation Options

    Warnings and Info check boxes on the tab of the ConflictSolver Validate Options dialog box. It is strongly recommended you do not suppress warning messages so you can ensure proper validation of packages before importing them into ConflictSolver. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 93: Best Practices Page

    (EXE, DLL, OCX, HLP , CHM, fails. exists, and it adds new TLB, SYS, DRV) per components for remaining component in a Windows EXE, DLL, OCX, HLP , CHM, Installer package. TLB, SYS, and DRV files. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 94 IniFile table has InstallShield Editor and identify any hard coded any hard coded paths, a change any hard coded paths paths. warning is generated. in the Value field of the IniFile table to relative paths. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 95 InstallExecuteSequence action. generated. 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 RemoveFile table. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 96 If any of a package’s required Import the package’s missing required Merge Modules have Merge Modules do not exist Merge Modules into the been imported into the in the Application Catalog, a Application Catalog. Application Catalog. warning is generated. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 97: Resolving Best Practice Ace Errors

    Select the CARD resolutions that you want to resolve, and click Approve to execute them. If the Preview and approve all resolutions option is not selected, the Resolution Details dialog box will not appear, and all selected conflict resolutions will be executed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 98: Configuring Conflict Detection

    CARD Resolution Options dialog box, and you are prompted to select which file to use. If this option is not selected, the CARD will perform its default resolution. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 99: Detect Conflicts Page

    Select the default conflicts you want to check for from the Predefined and Custom ACE Rules area. Conflict rules (ACEs) associated with unselected boxes will not be performed by default during conflict identification. However, you can override these in the Conflict Options Panel of the Conflict Wizard. Click OK. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 100: Resolve Conflicts Page

    These topics can provide valuable information regarding what is causing the conflict, so you can use Tuner or InstallShield Editor to solve it. Once you have resolved detected conflicts manually, you can re-import the package into ConflictSolver. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 101: Configuring Resolution Options

    CARD Resolution Options dialog box, and you are prompted to select which file to use. If this option is not selected, the CARD will perform its default resolution. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 102: Reporting Page

    Product Information—Lists all information that appears on the Product View for a package. • Registry—Lists any registry entries created or changed by the package. These registry entries are also listed on the Registry View for that package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 103: Organize Package Page

    Draft package, and 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 Application Manager Product View. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 104: Current And New Packages

    After you have selected a package, you can use it in the Validation, Best Practices, Detect Conflicts, Resolve Conflicts, Reporting, and Organize Package tasks of the ConflictSolver Assistant. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 105: Draft Packages

    Process Assistant. The package will then be visible on the ConflictSolver and Application Manager Product View. Note • While it is possible to move a package out of the Draft group before conflict detection and resolution have been performed, it is not recommended. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 106: Test Page

    From the Test selection list, select the tests that you want to run: • Execute all deployment—Deployment tests are performed against the installed product, ensuring that the product has been installed correctly and all key functionality works in the installed environment. See Deployment Testing ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 107: Distribute Page

    From the Distribution Type list, select the type of distribution you want to perform. A description of each type appears when it is selected. Click Distribute to complete the distribution process. See Also Preparing Packages for Distribution Using Distribution Wizard Distributing Transforms With an MSI Package AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 108: Distributing Transforms With An Msi Package

    The order in which transforms are applied can be changed by selecting a transform and clicking the Move Up ) and Move Down ( ) buttons. • Delete a transform file from the Transforms list by selecting the transform and clicking the Delete button ( ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 109: Using The Adminstudio Interface

    A list of questions frequently asked by AdminStudio users, with links to the Questions appropriate help topics. AdminStudio Interface This section contains an exhaustive description of each dialog box, Wizard, Reference and UI element in AdminStudio. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 110: Configuring The Adminstudio Interface

    Tools Gallery on the AdminStudio Start Page. Figure 3-1: Tools Gallery on Start Page You can also launch AdminStudio applications by double-clicking on the tool icon in the Tools Gallery on the Tools Tab. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 111 Role that has permission to use that Tool, or that the Tool is not available in your Edition of AdminStudio. Note • You can also launch AdminStudio tools from the Process Assistant. See Using the Process Assistant more information. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 112: Specifying The Shared Adminstudio Application Catalog

    To maintain consistency when creating workflows, InstallShield recommends that you set the AdminStudio Shared Directory the same for each AdminStudio user. Task: To specify the location of the AdminStudio Shared Directory: Launch the AdminStudio Interface. From the Tools menu, select Options. The Options dialog box opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 113: Setting The Workflow Task Help Page Location

    On the Updates tab, select the frequency that AdminStudio will check for software updates: • Once every 15 days • Once every 30 days • Once every 60 days • Never Click OK to close the Options dialog box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 114: Configuring Adminstudio To Stay On Top

    URL to make the URL in the AdminStudio Enterprise Server URL field the default. If you want to Allow automatic authentication by AdminStudio Enterprise Server, select this option. Click OK to close the Options dialog box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 115: Specifying The Configuration Manager Web Console Url

    • Modifying Command-Line Configurations for an Existing Tool • Deleting Command-Line Configurations from an Existing Tool • Associating Tools with Tasks • Running Associated Tools in Projects • Deleting Existing Tools • Limiting Tool Accessibility AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 116: Adding New Tools To The Tools Gallery

    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 document or batch file necessary to completing the project. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 117: Adding Command-Line Configurations For An Existing Tool

    Select the command-line configuration you want to edit and click Modify. The Command-Line Properties dialog box appears. Modify the description and/or command line. Click OK to dismiss the Command-Line Properties dialog box. Click OK in the Tool Properties dialog box to apply the changes. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 118: Deleting Command-Line Configurations From An Existing Tool

    <New Tool...> from the list to add the tool. In the Tool Configuration list, select the configuration you want to use with the tool. If the configuration is not listed, click Configure to create the new configuration. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 119: Running Associated Tools In Projects

    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 document or batch file necessary to completing the project. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 120: Limiting Tool Accessibility

    The following topics relate to creating and executing workflows: • Creating New Workflows • Renaming Workflows • Filtering Workflows • Deleting Workflows • Creating New Tasks • Modifying Task Properties ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 121: Creating New Workflows

    Provide a new name for the workflow. Filtering Workflows Task: To display a specific workflow: From the Interface, click the Workflow Templates tab. From the drop-down menu above the Workflows tree, select the workflow you want to display. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 122: Deleting Workflows

    Click on the Workflow Templates tab. From the Workflows tree, select the task you want to modify. The Task Properties view for the selected task is displayed. Change Task Properties as necessary for the task. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 123: Creating Notes For A Task

    From the toolbar, click Move Up or Move Down to change the order in which tasks are performed. Click Move Right to make a task a subtask of another task; click Move Left to promote a task. Repeat the previous steps as necessary. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 124: Associating Help Files With Tasks

    From the Tool list in the Task Properties view, select <Add Tool ...>. The Add New Tool dialog box opens. In the Add New Tool dialog box, enter properties about the tool. Click OK. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 125: Creating And Using Projects

    In the Target File Name field, provide a name for the output file. Depending on the task being executed, the appropriate extension will be added to the file name. Click Finish. The new Workflow is now listed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 126: Filtering Projects

    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 document or batch file necessary to completing the project. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 127: Deleting Projects

    Right-click in the Workflows tree pane and select New Workflow. A new Workflow is listed. Name the workflow My Workflow Example. Right-click My Workflow Example and select New Task. Name the task Repackage a Legacy Setup. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 128 Set the Target File Name to . This value is written to the variable used in WorkflowProjectEx TargetFileName the command line set for InstallShield Editor when creating the workflow. Click Finish. The new Workflow Project is now listed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 129: Workflows, Projects, And Permissions

    If you are executing projects, you can only launch tools you have permissions to use, regardless of whether they are associated with a task in the workflow. For more information, see Managing Roles and Permissions. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 130: Frequently Asked Questions

    Repackaging Legacy Installations Using the Repackaging Wizard. • Why is a “clean” system important for repackaging? See About Repackaging on Clean Systems. • Should I repackage a Windows Installer (.msi) setup? See Repackaging Wizard Best Practices. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 131: Adminstudio Interface Reference

    The AdminStudio interface reference is organized into the following areas: • AdminStudio Start Page • Assistant Tab • Tools Tab • Workflow Templates Tab • Projects Tab • Enterprise Server Tab • AdminStudio Menus and Toolbar • Dialog Boxes • Wizards AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 132: Adminstudio Start Page

    Center to generate reports. You can also manage Users, Roles, and Permissions. Tools Gallery You can launch each tool in the AdminStudio suite by clicking on the appropriate icon in the Tools Gallery. Figure 3-4: Tools Gallery on the AdminStudio Start Page ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 133 The Resources section contains a number of links to connect you to helpful InstallShield information and InstallShield’s responsive customer support. Contact Us To provide feedback about InstallShield or join our Customer Experience Improvement Program, click one of the links listed here. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 134: Assistant Tab

    The ConflictSolver Process Assistant, which is integrated into the main Process Assistant but which can also be launched separately, guides you through the process of identifying and resolving conflicts between Windows Installer Packages. Note • For more information, see Using the Process Assistant, ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 135: Tools Tab

    AdminStudio tools. If you single-click on an AdminStudio tool icon in the Tools Gallery on the Tools tab, additional information about the selected tool is displayed in the Content Pane. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 136: Workflow Templates Tab

    Browse button to open a default page in an HTML editor. Notes Add any notes you want associated with this task. This field can only hold 255 characters, so additional information should be added to your help file. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 137: Projects Tab

    • Generating and Viewing Reports in Report Center • Automating Tasks Using Job Manager • Distributing Packages Using Configuration Manager Web Console • Managing Roles and Permissions • Managing Users, Directory Services, and User Logins AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 138: Workflow Manager Tab

    Software Repository. Catalog Change AES Change the password of the current user to log in Password to the AdminStudio Enterprise Server. Catalog Logout Log out of the AdminStudio Enterprise Server. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 139 Start the Update Service to determine if there any Updates updates or messages available for AdminStudio. Tools Options Alt+T+O Displays the Options dialog box, from which you can configure the location of shared resources and the frequency AdminStudio checks for updates. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 140 Create a new Task. Menu Context Rename Rename selected Workflow or Task. Menu Context Delete Delete selected Workflow or Task. Menu Context New Project Ctrl-P Create a new Project. Menu Context Del Project Delete selected Project. Menu ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 141: Dialog Boxes

    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 offers you expert technical support, new product announcements and special offers, plus notification of product upgrades. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 142: Add New Tool Dialog Box

    HTML editor: Add to Tools Gallery When this box is checked, the tool will be added to the Tools Gallery. If Check Box unchecked, it is only available for the task where it was added. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 143: Command Line Properties Dialog Box

    AdminStudio checks for updates. The dialog box consists of the following tabs: • Application Catalog Tab • Locations Tab • Updates Tab • Virtual Packages Tab • Quality Tab: Customer Experience Improvement Program AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 144: Application Catalog Tab

    Enter or browse to the directory where you want to store all HTML pages that Location serve as workflow task instructions. Configuration Manager Enter the URL for the Configuration Manager Web Console Web site. Web Console URL ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 145: Updates Tab

    On the Virtual Packages tab, you can control which of the available virtual package formats 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-7: Virtual Packages Tab of the Options Dialog Box AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 146: Quality Tab: Customer Experience Improvement Program

    Your membership status in the Customer Experience Improvement Program is specified on the Quality tab of the AdminStudio Options dialog box. If you initially select to participate but later you change your mind, you can opt- out of this program by changing the selection on the Quality tab. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 147: Tool Properties Dialog Box

    Option Description Target Enter the location of this tool’s executable. Alternatively, click Browse and navigate to it. Name in Tools Gallery Provide a name for the tool as it will appear in the Tools gallery. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 148: Configuration Tab

    TargetDir—The directory where output from the selected project is stored. • TargetFileName—The name of the output file. • ProjectName—The name of the current project. Modify Click to open the Command Line Properties Dialog Box, where you can modify the selected command line. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 149 A command Line entered by the user in Properties Tab of the Tool Properties dialog box play no role in the Workflow and Project tab. This command line is used only when you run the tool from the Tools Tab. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 150: Wizards

    Provide a name for the tool as it will appear in the Tools Gallery. Command Line Enter any default command line arguments for this tool. Arguments Working Directory If this tool requires a working directory, enter it here or click Browse to locate it. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 151: Command-Line Configurations Panel

    The New Workflow Project Wizard assists you in creating a new project based on an existing workflow. The values you specify in this Wizard are stored in variables that can be accessed from tools, allowing for greater interoperability in AdminStudio. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 152: Workflow Selection Panel

    If any workflow tasks use the TargetDir or TargetFileName variables, you must specify the target directory and package name. For example, if the workflow specifies to save a task's output, AdminStudio needs to know where to save it and what to call it. Click Finish to close the Wizard. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 153: Log Files

    Log Files AdminStudio tools generate the following log files: Table 3-14 • 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\AdminStudio\9.5\FLEXWrap\Server debug.log C:\Program Files\AdminStudio\9.5\FLEXWrap\Server distributer.log C:\Program Files\AdminStudio\9.5\Common islc.log C:\Program Files\AdminStudio\9.5\Repackager AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 154 Chapter 3: Using the AdminStudio Interface AdminStudio Interface Reference ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 155 Part 2 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 Permissions • Managing Application Catalog Databases AdminStudio 9.5 User Guide...
  • Page 156 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 157: Managing Users, Directory Services, And User Logins

    You can create a user account for each person that you want to have access to AdminStudio Enterprise Server, or you can import users or groups of users from a Windows Active Directory or Novell eDirectory Directory Service. You can also configure various login methods to best suit your needs: AdminStudio account login, domain account login, single sign-on login, and guest account login.
  • Page 158: Creating A New User Account

    AdminStudio Enterprise Server supports Windows Active Directory and Novell eDirectory directory services. Note • For more information on AdminStudio Enterprise Server support for Directory Services, see...
  • Page 159: Disabling A User Or Group Account

    Cannot be assigned any work. • Is not listed on the User Administration page. • Does not get any email notifications. • Cannot be selected as a Customer Contact or Servicer Contact. • Cannot be viewed by Customers. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 160: Deleting A User Account

    Select the User or Group that you want to delete to open its User Details view. Click Delete. You are prompted to confirm the deletion. Click OK. The deleted User or Group is no longer listed on the User Administration page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 161: Managing Directory Services Configurations

    Chapter 4: Managing Users, Directory Services, and User Logins Managing Directory Services Configurations Managing Directory Services Configurations AdminStudio Enterprise Server can be integrated with Windows Active Directory and Novell eDirectory. This enables you to set up automatic login with AdminStudio Enterprise Server based upon Directory Services authentication.
  • Page 162 AdminStudio Enterprise Server uses Port 389. Important • The value for the Directory Service Port should be the port on the given server to which AdminStudio Enterprise Server should connect to send LDAP queries. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 163 Enter the object class names for groups for this Directory Service. Default values are: • Active Directory: group • eDirectory: groupofnames Group Name Enter an attribute used by this Directory Service to name groups. The default Attribute value for both Active Directory and eDirectory is AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 164: Editing An Existing Directory Service Connection

    Click Manage Directory Services Connections. The Directory Services List page opens. Select the Directory Service connection that you want to edit. The Edit Directory Service Connection page opens. Edit these entries as described in Adding a Directory Service Connection. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 165: Deleting A Directory Service Connection

    If the user is not connected using Directory Service authentication, then the fields will be left blank and enabled. On the Directory Services Attributes Administration Page, which is accessed by clicking Manage Directory Services Attributes on the Directory Services page, Administrators can map their customizations for the directory service. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 166: Managing User Logins

    This section explains the four methods of logging into AdminStudio Enterprise Server, and how to set the session timeout value. • Login Methods • Using AdminStudio Enterprise Server Account Login • Using Domain Account Login • Using Single Sign-On Login • Using Guest Account Login • Setting the Session Timeout Value ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 167: Login Methods

    For Single Sign-On, IIS performs user authentication. For all other login methods, AdminStudio Enterprise Server performs authentication. Note • Single Sign-on is not supported for Novell eDirectory users and groups. Note • For single sign-on login, the Anonymous access option...
  • Page 168: Iis Authentication Methods Dialog Box

    On the Action menu, select Properties. The Web Site Properties dialog box opens. 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 option on the IIS Authentication Methods Dialog Box ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 169: Using Adminstudio Enterprise Server Account Login

    Creating a New User Account Using Domain Account Login To Set Up To set up Domain Account login, you do the following: • Set up a Windows Active Directory or Novell eDirectory Directory Service Connection. See Adding a Directory Service Connection. •...
  • Page 170: Using Single Sign-On Login

    For Single Sign-On, IIS performs user authentication . For all other login methods, AdminStudio Enterprise Server performs authentication. • Single Sign-on is not supported for Novell eDirectory users and groups. To Login When a user with single sign-on opens AdminStudio Enterprise Server, the IIS Web Server checks to see if the user’s domain User Name and Password are valid in the Active Directory Domain Server, and then automatically...
  • Page 171: Using Guest Account Login

    GuestAccount web.config the AdminStudio Enterprise Server database, then AdminStudio Enterprise Server displays an error message when a user tries to log on as a Guest User. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 172: Logging In As A Guest

    Guest account. • If Directory Service authentication is not used at your site, AdminStudio Enterprise Server opens the AdminStudio Enterprise Server Login page by default. The user then selects the Guest Access option and clicks Login. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 173: Setting The Session Timeout Value

    To change the session timeout value: Open the directory of the AdminStudio Enterprise Server installation and open in a text wwwroot web.config editor. Locate the line that contains sessionState timeout <sessionState timeout="20" mode="InProc" stateConnectionString= "tcpip=127.0.0.1:42424" sqlConnectionString="data source=127.0.0.1; Trusted_Connection=yes" cookieless="false" /> AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 174: Users/Groups And Directory Services Reference

    Directory Services User/Group Add View, where you can import a User/Group Import User or Group from an Directory Service. Status To filter the list of users by Status, make a selection from this list: Active, Inactive or All. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 175 • Import Directory Service Users or Groups—Set up a Windows Active Directory or Novell eDirectory Directory Service Connection and the click Directory Service User/Group Import on the User Administration page to import Users or Groups from that Directory Service. See...
  • Page 176: User Details View

    Click to save your entries and remain in the User Details view, where you can enter another new user. Delete Click to delete this user account. Cancel Click to exit this view without saving your entries. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 177: Directory Services User/Group Add View

    Roles that are assigned to that Group. You can then assign additional Roles to that User. Update Click to save your entries. The selected user or group is then opened in the User Details View. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 178: Directory Services Page

    Chapter 4: Managing Users, Directory Services, and User Logins Users/Groups and Directory Services Reference Directory Services Page AdminStudio Enterprise Server can be integrated with Windows Active Directory and Novell eDirectory. This integration enables you to integrate Directory Services Users and Groups and also to use Directory Services attributes.
  • Page 179: Add Directory Service Connection View

    On the Add Directory Service Connection view, which is opened by clicking Add on the Directory Services List Page, you enter the necessary settings to connect to an Active Directory or Novell eDirectory Directory Service. Table 4-8 • Add Directory Service Connection View Options...
  • Page 180 Enter the object class names for groups for this Directory Service. Default values are: • Active Directory: group • eDirectory: groupofnames Group Name Enter an attribute used by this Directory Service to name groups. The default value for Attribute both Active Directory and eDirectory is ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 181: Directory Services Attributes Administration Page

    Table 4-9 • Directory Services Attributes Administration Page Options Option Description Directory Name of the LDAP (Lightweight Directory Access Protocol) Directory Service attribute that Service is used in Directory Services protocol to access information directories, such as Attribute employeeNumber or documentAuthor. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 182: Add Directory Service Attributes View

    Data Element appears in the Workflow, information will be pulled from the Directory Service to populate those fields, such as: However, if the user is not connected using Directory Service authentication, then the fields will be left blank and will be enabled. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 183: Managing Roles And Permissions

    Workflow Manager are controlled by Roles. This section includes the following topics: • Role Permission Lists • AdminStudio Client Tools Permissions • AdminStudio Enterprise Server Tools Permissions • Workflow Manager Permissions • System Roles AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 184: Role Permission Lists

    Add—Permits user to add a new tool to the Tools tab. • Edit—Permits user to edit the properties of an existing tool on the Tools tab. Tools Tab • Delete—Permits user to delete an existing tool on the Tools tab. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 185 Extended Attribute view. • Delete History—Permits user to delete a package’s history log (which contains a record of any operation that materially changes a software package or the data associated with it). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 186 Analysis—Permits user to use the ConflictSolver Patch Impact Analysis Wizard to analyze the impact of installing an OS Security patch on user machines. • Software Repository Overwrite—Permits user to import a duplicate package into the Software Repository, overwriting the existing version. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 187: Adminstudio Enterprise Server Tools Permissions

    • View—Permits user to open the Administration/System Settings tab. • Edit—Permits user to edit the fields on the Administration/System Settings tab: AdminStudio Enterprise Server User Account and the Workflow Manager/ AdminStudio Enterprise Server Serial Numbers. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 188 Templates and Jobs, and also to edit existing Templates and Jobs. If this user has this permission and also has the Configuration permission, this user can modify the selections on the Conflict Detection Options page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 189: Workflow Manager Permissions

    Related Applications tab. • Delete Related Application Links—Permits user to delete Related Application links. • Edit Application Due Period—Permits user to edit the Application Due Period field on the Properties tab of the Application Progress page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 190 View—Permits user to view a list of existing Requestor companies and view Requestor company details. • Add—Permits user to add new Requestor companies. • Edit—Permits user to update Requestor company details. • Delete—Permits user to delete an existing Requestor company. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 191 External Email Address Administration pages. • Deployment Sites View—Permits user to see the Deployment Site Administration page. • Add—Permits user to add a new Deployment Site. • Edit—Permits user to edit an existing Deployment Site. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 192: System Roles

    Service Company administrator or by accounts created by a Service Company administrator. Note • The AMSSuper Role is not listed on the page unless you are logged on using the Role Administration account. suams ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 193: Default System Roles

    Tech Lead for Servicer Company Application User Requester (Workflow Manager only) Application User for Requester Company Project Manager Requester (Workflow Manager only) Project Manager for Requester Company UA Tester Requester (Workflow Manager only) User Acceptance Tester for Requester Company AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 194: Default System Users

    By default, the password for each of these default System Users is the same as the text prior to the @ sign (such as techlead for techlead@servicer.com), except the password for pm@requester.com and pm@servicer.com is projectmanager. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 195: Creating A New Role

    It is not recommended that you change a Role’s Role Company. In the Role Permissions List, edit the permissions assigned to this Role. Click the Update button. You are returned to the Role Administration page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 196: Copying An Existing Role

    Select the user-defined Role that you want to delete. The Role Details View opens. Click Delete. You are prompted to confirm the deletion. Click OK. The Role Details View closes and the Role you deleted is no longer listed on the Role Administration page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 197: Roles Reference

    For more information, see System Roles. Click to access the Role Details View, where you can add a new Role. Copy Click to access the Copy Role View, where you can copy an existing Role. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 198: Copy Role View

    New Role Name Enter a name to identify this new Role. Copy Click to create this new Role and close the Copy Role view. Cancel Click to exit this view without creating a new Role. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 199: Role Details View

    Click to save your entries and close the Role Details view. Delete Click to delete this user-defined Role. Note • If you are editing a System Role, the Delete button will be disabled. Cancel Click to exit this view without saving your entries. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 200 Chapter 5: Managing Roles and Permissions Roles Reference ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 201: Managing Application Catalog Databases

    Edition • Import support for Marimba Native Channel Packager (.ncp) files is available in AdminStudio Enterprise Edition. Using the Software Explains how to manage a software package’s associated installation files using Repository the Software Repository. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 202: Application Manager And Conflictsolver

    This section compares these tools and includes the following topics: • Functionality Comparison • Accessing the Tools • Displaying ConflictSolver Options in Application Manager • Creating and Connecting to Application Catalogs in Application Manager and ConflictSolver ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 203: Functionality Comparison

    Software Repository. • Associate a package with a Workflow Manager package • Launch applications—Launch Predeployment Test Preparation Wizard, InstallShield Editor, and Distribution Wizard. • Reports—View Package, File, and Registry reports. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 204: Accessing The Tools

    Both Application Manager and ConflictSolver can be opened from the Start Page, the Tools Gallery, or from a menu shortcut. You can toggle between Application Manager, ConflictSolver, and ConflictSolver Process Assistant by clicking a button in the toolbar: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 205: Displaying Conflictsolver Options In Application Manager

    Using the AdminStudio Quick Start Evaluation Experience • Connecting to an Existing Application Catalog • Creating New Application Catalogs • Specifying a Default AdminStudio Application Catalog • Searching an Application Catalog • Disconnecting from an Application Catalog AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 206: About Adminstudio Application Catalogs

    Application Catalog. If the shared Application Catalog is changed, users will automatically open up the new shared Application Catalog. For more information, see Specifying a Default AdminStudio Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 207: Standalone Application Catalog Vs. The Adminstudio Enterprise Server Application Catalog

    AdminStudio Enterprise Tools are always connected to the AdminStudio Enterprise Server database. For more information on using Application Catalogs, see the following: • Connecting AdminStudio Client Tools to a Standalone Application Catalog • Connecting AdminStudio Client Tools to the AdminStudio Enterprise Server Application Catalog AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 208: Using The Adminstudio Quick Start Evaluation Experience

    From AdminStudio and the AdminStudio client tools, you usually connect to an Application Catalog by selecting Connect on the Catalog menu. AdminStudio supports SQL Server databases. Note • Starting with AdminStudio 9.01, Oracle databases are not supported. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 209: Connecting Adminstudio Client Tools To A Standalone Application Catalog

    Authentication or Server Authentication. If you selected Server Authentication, enter the appropriate Login ID and Password. In the Catalog box, enter the name of the Application Catalog you want to open. Click Test to test the connection to the database. Click OK. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 210: Connecting Adminstudio Client Tools To The Adminstudio Enterprise Server Application Catalog

    If you selected AdminStudio Enterprise Server User, enter your AdminStudio Enterprise Server User Name and Password (provided by your System Administrator). Click Login. After a successful login, the Provider, Server, and Catalog name of the Enterprise Server database is listed. Click OK. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 211: Creating New Application Catalogs

    Click Test to test the connection to the database. Click Next. The Select Software Repository Location panel opens, prompting you to select the location where the Software Repository will store imported packages and their associated files. For more information, Using the Software Repository. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 212: Creating New Application Catalogs Using Scripts

    Application Catalog database using SQL Server to AdminStudio users. Consequently, the Database Administrator must manually create the database using scripts and provide the necessary read and write access for users to that database. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 213 In Query Analyzer, execute a command to create and identify the new Application Catalog CREATE DATABASE database. Select the newly created database in Query Analyzer. Execute the following scripts in order: AMS_System_Schema.SQL AMSCreateIndex.SQL AMS_SamplePackagingTemplate.SQL AS_Schema.SQL CustomReportWizard.SQL AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 214: Specifying A Default Adminstudio Application Catalog

    Methods to Set the Default Application Catalog for Your Enterprise You can set a default Application Catalog for all AdminStudio users in your enterprise in two ways: • Using the AdminStudio Interface • Editing the Shared AdminStudio.ini File ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 215: Using The Adminstudio Interface

    AdminStudio Shared directory to the same shared network directory that the System Administrator configured. Launch AdminStudio. On the Tools menu, click Options. The AdminStudio Options dialog box opens. Open the Locations tab. Set the AdminStudio Shared Location to the shared network location provided by your System Administrator. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 216: Editing The Shared Adminstudio.ini File

    AdminStudio Shared folder on the Options dialog. In this situation, the location of the AdminStudio Shared location would be set during installation. Note • The Roles assigned to a user determine that user’s permissions: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 217: Searching An Application Catalog

    Select the node in the tree (Application Catalog, Groups, a specific group, a specific package, an OS snapshot, etc.) that you want to search. On the Edit menu, click Find. The Find dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 218: Disconnecting From An Application Catalog

    When you have disconnected from an Application Catalog in ConflictSolver or Application Manager, the following message appears: ConflictSolver requires a connection to the AdminStudio Application Catalog. Select Connect from the Catalog menu to establish a connection. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 219: Upgrading An Existing Application Catalog

    Managing Application Catalogs Upgrading an Existing Application Catalog When you attempt to open an AdminStudio 5.0, 5.5, 6.0, 7.0, or 7.5 Application Catalog in AdminStudio 9.5, you are prompted to upgrade it to use the AdminStudio 9.5 schema. Log files for the upgrade are created in the following directory: AdminStudio Shared Directory\ConflictSolver\Logs Note •...
  • Page 220: Adding Groups

    • You cannot drop a node on itself. • You cannot drop a node on its parent. It is already a child of the parent. • You cannot drop a group on its child groups. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 221: Deleting Application Manager Groups

    While holding down the Ctrl key, drag the package to the group into which you want it copied. Note • You can also right-click on a package and use the copy and paste commands to copy the item. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 222: Moving Products, Os Snapshots, And Groups

    Using Extended Attributes • Extended Attribute Description File • Integrating Package Extended Attribute Data with an Application Request Note • You can also edit a package’s extended attributes in the ConflictSolver Process Assistant. See Extended Attributes Page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 223: Using Extended Attributes

    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 location in the Extended Attribute Description File field on the Extended Attributes tab of the ConflictSolver and Application Manager Options dialog box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 224 255 characters. HelpText Text that appears below the value field for either Text or Selection attributes. You can use it to provide additional information to help users know what to input. This cannot exceed 512 characters. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 225: Integrating Package Extended Attribute Data With An Application Request

    Application Manager with Application Requests in Workflow Manager. This is accomplished by right- clicking on the package name in the Application Manager Product View and selecting Associate with Workflow Manager Application from the context menu. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 226: Viewing Package History

    In AdminStudio, any operation that materially changes a software package or the data associated with the package is tracked, and can be viewed in the Application Manager History view. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 227 Date and time logged event occurred. User User who performed the logged event. Description Description providing details of the logged event. Note • If a package was replicated into another Application Catalog, its history data would not be replicated. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 228: Deleting Packages

    Software Repository along with the rest of the imported package’s associated files. See Using the Software Repository Performing an Ad-Hoc Import of Transform Files or Patch Files. Important • You can only perform an ad-hoc import if you are connected to a Software Repository-enabled Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 229: Importing Windows Installer Packages, Transforms, And Patches

    Windows Installer package. Tasks associated with importing Windows Installer packages, transforms, and patches include: • Importing Windows Installer Packages • Using Duplicate Package Identifiers • Performing an Ad-Hoc Import of Transform Files or Patch Files AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 230: Importing Windows Installer Packages

    The order in which transforms are applied can be changed by selecting a transform and clicking the Move Up and Move Down buttons. If you need to delete a transform you have added, select the transform and click the Delete button. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 231 You can also import a Windows Installer package by right-clicking the group into which you want to import the package and selecting Import Package from the context menu. The MSI Source Information panel is displayed in the Import Wizard, and you can proceed with the steps above. However, since you have already AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 232: About Windows Installer Packages (.Msi)

    Microsoft Office MSI package so that: • Accounting’s installation would include only Word and Excel • Marketing’s installation would include only Word and PowerPoint, and • Development’s installation would include only Word and Access. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 233 Select the identifiers that you would like to use for product imports by selecting one or more of the following options: • PackageCode Property— Identifier of the package the product was installed from. No two non-identical .msi files should ever have the same package code. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 234: Performing An Ad-Hoc Import Of Transform Files Or Patch Files

    Application Catalog. Then, Application Manager will: • Determine which of the packages in the Application Catalog the transform or patch file is associated with, and • Store the files in the Software Repository along with that package’s other associated files. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 235 Review the information in the Summary panel. If you are satisfied with the import options, click Finish to start the import. Progress messages appear in the Output Window. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 236: About Transforms (.Mst)

    Import Wizard searches for and finds a virtual package created by AdminStudio, you are prompted to also import that virtual package. See Importing a Virtual Package During the Import of its Source Windows Installer Package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 237: Importing A Virtual Package During The Import Of Its Source Windows Installer Package

    On the Catalog menu, select Import Package. The Welcome panel of the Import Wizard opens. Click Next. The File Selection panel opens. Click Browse and select the Windows Installer package that has associated virtual packages that you want to import. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 238 If you opened the Import Wizard by selecting a group folder and then selecting Import from the context menu, the Destination Group panel will not open. Select the group or groups where you want to import this package, as described in Importing Windows Installer Packages, and click Next. The Summary panel opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 239: Importing A Virtual Package After The Import Of Its Source Windows Installer Package

    If a virtual package was created by a method other than the AdminStudio 9.x conversion process, this metadata file will not have been created. Therefore, when importing this type of virtual package, the Import Wizard will not prompt AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 240 Application Catalog in the destination group you selected. In Application Manager, select the virtual package that you have just imported. The Virtual Package view opens, and the associated Windows Installer package is listed in the Associated Packages list. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 241: Importing A Virtual Package Without Its Source Windows Installer Package

    Therefore, it is preferable to use the Import Wizard to import both the Windows Installer and virtual packages at the same time so that AdminStudio can create the proper associations. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 242: Deleting A Virtual Package Association

    To import multiple patches, you can repeat the procedure as necessary. The order in which merge modules are applied can be changed by selecting a merge module in the list and clicking the Move Up and Move Down arrows. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 243: About Merge Modules (.Msm)

    To import an OS Snapshot into an Application Catalog: Open Application Manager. On the Catalog menu, click Import Package. The Welcome panel opens. Click Next. The File Selection panel opens. Select the OS Snapshot ( ) file that you want to import .osc AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 244: About Os Snapshots (.Osc)

    OS Snapshot. See Configuring Exclusions Using the Exclusions Editor more information. Caution • OS Snapshots should only be used for comparison in Application Manager. You should never attempt to convert an OS Snapshot into an MSI package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 245: Importing Marimba Ncp Files

    The Marimba NCP file that should be imported into an Application Catalog is always named manifest.ncp. If you attempt to import another file with an .ncp extension into an Application Catalog, the import will fail. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 246: About Marimba Native Channel Packager Files (.Ncp)

    ACE23 and ACE24. However, reporting, validation, and conflict resolution are not supported for the NCP package type. • Extended attributes are supported for NCP packages. • You can import NCP files from the command line. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 247: Importing Other Setup Types

    Review the information in the Summary panel. If you are satisfied with the import options, click Finish to start the import. A report of the import process appears on the Import tab of the Output window. The Other Setup Type package appears under the specified group in the Application Manager Product View. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 248: About Other Setup Types

    When a package is managed within the Software Repository, the Windows Installer file and all of its associated files and subfolders are imported into a subfolder of the Software Repository location identified for that Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 249: Enabling The Software Repository In Application Catalogs

    If a package is not added to the Software Repository when it is imported, the only way to add it to the Software Repository after that is to import it again, and to choose to overwrite the existing package version. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 250: Enabling The Software Repository In A New Application Catalog

    ConflictSolver, or Application Manager. On the Catalog menu, click Properties. The Application Catalog Properties dialog box opens. Open the Software Repository tab. Select the Enable Software Repository check box. The Software Repository Location option is enabled. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 251: Methods To Import Packages Into The Software Repository

    Data, and when the File Selection panel opens, select the Add the file(s) to the Software Repository option. If you are importing Merge Modules on the Merge Modules tab, this option is on the MSM Source Information panel. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 252: Adding A Package To The Software Repository Using The Conflictsolver Process Assistant

    Packages, but this time: Choose the Add the file to the Software Repository option on the File Selection panel Choose the The package should overwrite the existing package version option on the Target Package Information panel: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 253: Software Repository Auto Import Method

    Package is managed within the Software Repository. Package is managed within the Software Repository and is checked out. Merge Module is managed within the Software Repository. Note • These icons are not displayed in when viewing these packages in ConflictSolver. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 254: Using Version Management Features

    New Package Version or you can Overwrite Existing Version. The Software Repository version management features are described in the following topics: • Checking-Out and Checking-In Packages • Cancel Check Out • Getting a Copy of the Latest Version of a Package ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 255: Checking-Out And Checking-In Packages

    Unless a user is assigned to a Role with advanced Software Repository permissions, only the user who checked out the package will have the Cancel Check Out enabled. After the user confirms the operation, the local package files are deleted. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 256: Getting A Copy Of The Latest Version Of A Package

    You can add a package to the Software Repository via the InstallShield Editor build process. For more information on InstallShield Editor’s integration with AdminStudio, see InstallShield Editor Integration with Application Manager and the Software Repository. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 257 If the package is not in the Software Repository, the full name and path of the Target .MSI Package is displayed, but if the package is in the Software Repository, only the name of the Target .MSI Package is displayed (not the full path). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 258: Sharing Application Catalog Data

    Wizards to distribute an Application Catalog database where it is needed across a large enterprise or multi- national corporation. Data is replicated between a Publisher Database Server and a Subscriber Database Server, which do not need to be available on the same network. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 259 Application Catalog are automatically re-imported. When using the Network Directory option, if a modified version of a previously imported package is placed in the monitored Network Directory, the package is automatically re- imported. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 260 (or source directory and target closer to the user (which Application Catalog database) improves performance), and on an accessible domain. allows the user to subscribe to only the data that they need (which makes it easier to work with). ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 261 Publication to subscribe to. Replication is very efficient. It operates within the SQL Server Job Refresh Model, which means that the replication/ subscription process is run automatically. Automatically imported data coexists with data in the local Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 262: Merging Application Catalogs Using The Merge Wizard

    Click Next. The Progress panel opens, where you can view the merge progress. Click Finish to exit the Wizard. Note • For a comparison of the three methods for sharing Application Catalog Data in AdminStudio, see Sharing Application Catalog Data. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 263: Automatically Importing Packages

    In other words, both the Remote Application Catalog and all of the MSI files that have been imported into it must be able to be accessed by linked users via a shared network drive. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 264: Automatically Importing Packages In A Remote Application Catalog

    Click Add. The Package Auto Import Wizard Welcome panel opens. Click Next. The Package Auto Import Type Selection panel opens, prompting you to specify whether you want to monitor packages in a Remote Application Catalog or monitor a Network Directory. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 265 Click Close to close the Package Auto Import dialog box. Initial and Subsequent Automatic Imports Import is initiated automatically when you set up the Remote Application Catalog connection, and then subsequent imports occur automatically at the scheduled date and time. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 266 SQL login information. Therefore, each time you want to refresh the data from this Application Catalog, you will have to supply AdminStudio with the login information. Therefore, it is recommended that you use NT authentication mode to login to SQL Server Application Catalogs. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 267: Editing A Link To A Remote Application Catalog

    From the Starting on list, click on the arrow to open the Calendar and then select the first day that you want automatic importing to begin. Click OK to close the Package Auto Import Properties dialog box and then click Close to close the Package Auto Import dialog box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 268: Manually Updating A Linked Package

    As the linked packages are being re-imported, output messages will be displayed in the Package Auto Import tab of the Application Manager Output window. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 269: Deleting A Link To A Remote Application Catalog

    Import Wizard If a linked product in the local Application Catalog has been updated in the Remote Application Catalog and needs to be re-imported, an exclamation point is displayed on the icon ( AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 270: Automatically Importing Packages From A Network Directory

    , Application Manager would monitor that person's local directory rather than the directory C:\MyAppCatalogs that was chosen to be the monitored directory. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 271 Note • To modify Network Directory link settings, select the link on the Package Auto Import Dialog Box and click Properties. See Editing a Link to a Remote Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 272: Editing A Link To A Network Directory

    AM/PM setting and then clicking the up and down arrows to adjust the setting. From the Starting on list, click on the arrow to open the Calendar and then select the first day that you want automatic importing to begin. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 273: Forcing An Import Of Packages In A Network Directory

    ProductCode, Product Language, ProductVersion or List of Transform Files), the Target Package Information Panel opens, proposing an automatically generated new name for the package and prompting you to accept the new name or enter one of your choosing. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 274: Replicating Application Catalogs

    Describes how to create, edit, publish, and delete a Publication. This section Publications also explains how to set a Publication schedule and how to edit a Publication access list. Creating and Managing Describes how to create, enable/disable, manually update, and delete a Subscriptions Subscription. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 275: About Application Catalog Replication

    IT groups on local Application Catalogs. The verified applications could then be distributed globally from the master Application Catalog to all the distributed work groups of the enterprise. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 276: Creating And Managing Publisher And Subscriber Application Catalogs

    Managing Publisher and Subscriber Application Catalogs Creating Publisher and Subscriber Application Catalogs When creating a new SQL Server Application Catalog, you must choose (by selecting a check box) whether to define the Application Catalog as a Subscriber. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 277 Subscriptions to Publications on an AdminStudio Application Catalog configured as a Subscriber. See Managing Subscriptions. To see a diagram illustrating how data is replicated from the Publisher database to the Subscriber database, see Publication/Subscription Lifecycle. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 278: Configuring The Adminstudio Shared Location For Replication

    SQL Server Agent on the Subscriber database can login to the Distributor database via the Distributor SQL Server Agent using the login. distributor_admin Configure a Distributor database for the servers that are publishing data. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 279: Publication/Subscription Lifecycle

    Publication will be updated. Step 3: Publish Publication The Publisher generates the initial Publication by clicking the Run button on the Publication Manager dialog box. The Publication is now available for Subscription. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 280 The actual data made available for replication. Subscriber Person who subscribes to a publication. Subscriber Database Server A Database Server that receives the replicated data. Subscription A request to receive a Publication from a Distributor. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 281: Specialized User Scenarios

    Publication Wizard or the Generate subscription as script option on the Subscription Summary Panel of the Subscription Wizard so that the Wizard would generate an SQL script of the code necessary to create this Publication or Subscription rather than actually create it. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 282: Creating And Managing Publications

    Publication access list. This section covers the following tasks: • Managing Publications • Creating a New Publication • Publishing a Publication • Setting a Publication Schedule • Editing a Publication • Editing a Publication Access List • Deleting a Publication ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 283: Managing Publications

    Publication—Select a Publication and click Delete to delete the Publication data from the Publisher Database Server, making it no longer available for Subscription. When the list on the Publication Manager is refreshed, the Publication will no longer be listed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 284: Creating A New Publication

    Publication begin being updated on the upcoming Friday, you would select the current day of the week (Monday), but if you didn’t want the Publication to be updated until the Friday after next, you would select Saturday. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 285 To choose to publish this Publication immediately upon completion of the Publication Wizard (instead of publishing it manually or waiting until its scheduled update), select the Publish the publication immediately after creation option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 286: Publishing A Publication

    Generate publication as script option was selected, check with your Database Administrator to see if the script has been run. Click Run. The Publication data is replicated from your Application Catalog to the Publisher Database Server, making it available for Subscription. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 287: Setting A Publication Schedule

    Properties dialog box appears. Click the Details tab. In the Description text box, enter text to describe the purpose of this Publication. This description will be listed on the Publication Manager and Subscription Manager dialog boxes. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 288: Editing A Publication Access List

    Publication Manager dialog box. Task: To delete a Publication: On the Publication Manager dialog box, select the Publication that you want to delete. Click Delete. A dialog box opens asking you to confirm the deletion. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 289: Creating And Managing Subscriptions

    The Subscription Manager lists the last time that each of the Subscriptions was updated, the next scheduled update time for that Subscription, and whether the Subscription is enabled (active) or disabled. From the Subscription Manager, you can perform the following tasks: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 290: Creating A New Subscription

    Subscribers or Publishers. Click New. The Welcome Panel of the Subscription Wizard opens. Click Next. The Subscription Details Panel opens, listing Application Catalogs that you have recently accessed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 291 You might want to use this option if your organization has a controlled SQL database environment that prefers to have their database administrators make major changes to their databases. See Replicating Application Catalogs in Controlled SQL Database Environments for more information. Click Finish to complete the creation of this Subscription. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 292: Enabling/Disabling A Subscription

    Subscription will still be listed in the Subscription Manager, but will not be automatically updated. To enable a disabled Subscription, select it and click Enable. Note • This button toggles between Enable and Disable, depending upon the Status of the selected Subscription. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 293: Manually Updating A Subscription

    On the Subscription Manager, select the Subscription that you want to delete. Click Delete. A dialog box opens asking you to confirm the deletion. Click OK. The Subscription’s name is deleted from the Subscription Manager List. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 294: Using Microsoft Sql Server To Perform Merge Replication Of Application Catalogs

    Open AdminStudio and create a new AdminStudio Application Catalog on an SQL Server 2005 database server, such as the AdminStudio Application Catalog database server). Close AdminStudio, and verify in SQL Server Explorer/Management Studio the existence of the newly created database. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 295 Under Script File Properties, enter a valid path to store the script generated by this Wizard. On the Complete the Wizard panel, enter a name for the Publication that you are creating (such as ), and click Finish. ASPublication AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 296 Step 1: Creating the Publisher Database) Verify that the script runs without any errors or warnings. Verify that a new publication is listed under Replication/Local Publications, as shown below. If no publication is listed, then refresh the Replication node. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 297 Verify that there are no errors or warnings in the report. Close the Wizard. Refresh the Publication node under Local Publications and expand it. There should be a new Subscription listed under the AS-Publication publication. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 298 Step 5: Starting the Snapshot Agent To start the Snapshot Agent, perform the following steps: Task: To start the Snapshot Agent: Right-click on AS-Publication and select View Snapshot Agent Status from the context menu. The Snapshot Agent opens: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 299 Launch AdminStudio and try to connect to this catalog. Launch Application Manager and try to import a package in this catalog. Note • To create more subscribers, repeat Step 4: Creating a Subscription and a Subscribing Database. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 300: Taking Os Snapshots

    Only Use OS Never attempt to convert an OS Snapshot file into a Windows Installer package to Snapshot for Import install an operating system. AdminStudio does not support this use of OS into Application Snapshots. Manager ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 301: Configuring Os Snapshot Analysis Options

    Configure the types of data you want to capture (Files, INI files, Shortcuts, and/or Registry data), and specify if you want to restrict the snapshot to a specific drive. Click OK to return to the Project Information panel. Click Start. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 302: Capturing An Os Snapshot

    This section contains information on the all of the dialog boxes and wizards that are used when managing, connecting to, import data into, or sharing application catalogs. • Application Manager Views • Dialog Boxes • Wizards • AdminStudio Database Schema Tables • Application Manager Command-Line Functionality ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 303: Application Manager Interface

    Context Menus. Table 6-15 • Menus & Toolbars Menu Command Shortcut Button Description Catalog Connect Ctrl+O Displays the Connect Application Catalog dialog box, where you can open an existing Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 304 You can also select Other Setup Types to import other non-MSI based setups. Catalog Exit Closes Application Manager. Edit Find Ctrl+F Use to search for data in various tables in the Application Catalog. View Toolbar Ctrl+0 Toggles the Toolbar. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 305 Windows Installer packages, report locations, the default validation file, and duplicate package identification options. Help Contents Launches the online Help Library and displays the Contents tab. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 306: Product View Icons

    A group containing a product with unresolved conflicts. See Resolving Conflicts. Product A product that has been imported into the Application Catalog database. The product could be an MSI file, an Other Setup Type package, or a Marimba NCP File. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 307 Virtual package is managed within the Software Repository. This icon is only displayed in Application Manager. Virtual package is managed within the Software Repository and is checked out. This icon is only displayed in Application Manager. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 308 INI File Click to display the INI File Changes View, listing any INI file changes made by Changes the product. Merge Click to display any merge modules included the product. Modules ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 309: Merge Modules View Icons

    Exclusion Select to display any exclusions in the merge module. Files Select to display any files in the merge module Products Select to display any products in the Application Catalog that use the merge module. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 310: Context Menus

    Cuts the selected group from the Application Catalog. You can then paste it using the Paste command. Paste Pastes a cut group from Application Manager. Properties Opens the Group Properties dialog box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 311 Open this package in InstallShield Editor, where you can directly edit the package or InstallShield create a transform. Editor Note • Supported for Windows Installer packages only. Distribute Launch the Distribution Wizard. Package Note • Supported for Windows Installer packages only. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 312 Workflow Manager with which to associate the Manager extended attribute data for the selected product. Application Note • Supported for Windows Installer packages only. Note • AdminStudio Workflow Manager is a Web-based application management system that has integrated functionality with AdminStudio. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 313 Table 6-21 • Individual Merge Modules Context Menus Command Description Import Merge Module Launches the Import Wizard directly to the MSM Source Information panel. Delete Removes the selected merge module from the Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 314: Output Window

    Import process are displayed in this tab. Package Auto Import When the Package Auto Import Wizard is run to automatically import packages in a Remote Application Catalog or Network Directory, messages about the import process are displayed in this tab. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 315: User Permissions In Application Manager

    Can change the XML file used to configure the extended attribute definition Attributes Change Database Can open another Application Catalog Additionally, AdminStudio Administrators can restrict access to the Application Manager completely by disabling the Application Manager tool permission. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 316: Application Manager Views

    If you double-click on a package, the Product View for that package is opened. Application Catalog Operations that have been performed recently on the Application Catalog are History listed, with the most recently performed listed first. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 317: Group View

    Identifies the location of this package. It can be either a hard-coded path or a UNC path. If the package is part of the Software Repository, the following statement appears: Managed within the Software Repository AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 318 You are also informed if the last modified date for the package in the Application Catalog does not match the last modified date of the package in its external location. You are given the opportunity to reimport the package to keep it synchronized in the Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 319: Extended Attributes View

    These attributes are dynamically populated based on an external Extended Attribute Description File (in XML format). You can specify the name and location of this file from the Extended Attributes Tab of the ConflictSolver and Application Manager Options Dialog Box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 320: Files/Components View

    FileName Name of file. FileSize Size of the file listed in the FileName column. Version Version of the file listed in the FileName column. Path Installation location of the file listed in the FileName column. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 321: Ini File Changes View

    Default value of Key. Key of the Registry Entry that this component is making. Name Name of the Registry Entry that this component is making. Value Value of the Registry Entry that this component is making. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 322: Shortcuts View

    The number which uniquely identifies the Merge Module listed in the Title column. Version The version of the Merge Module listed in the Title column. Language The language that the Merge Module listed in the Title column was written for. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 323: History View

    Most tables are derived directly from standard MSI tables, as described in the Windows Installer SDK online help. When building your own ACE rules to use for conflict identification, it is important to understand the data available for packages so you can construct the necessary rule. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 324: Os Snapshot View

    OS Snapshot. The following information is displayed for each of the files included in the OS Snapshot: Table 6-34 • Files View Information Column Description FileName Name of the file. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 325: Ini File Changes View For Os Snapshots

    The following information is displayed for each Registry Entry: Table 6-36 • Registry View Information Column Description Root Default value of Key. Key of the Registry Entry that this component is making. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 326: Shortcuts View For Os Snapshots

    Table 6-38 • Other Setup Types View Information Field Description Main Directory The original location of the non-MSI based setup files when they were imported into the Application Catalog. Imported On The date and time the setup was imported. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 327: Extended Attributes View For Other Setup Types

    Version of the software package File Name and path of the NCP file that was imported Imported On Date when the file was imported Description After the NCP file is imported, you can edit this with additional information. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 328: Extended Attributes View For Marimba Ncp Files

    INI File Changes View for Marimba NCP Files When you expand an Marimba NCP File in the Application Manager Product View, you can click on INI File Changes to display any INI file changes made by the NCP file. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 329: Registry View For Marimba Ncp Files

    Key of the Registry Entry that this NCP file is making. Name Name of the Registry Entry that this NCP file is making. Value Value of the Registry Entry that this NCP file is making. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 330: Shortcuts 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 Product View section. Virtual Package View When you select a virtual package in the Application Catalog, the Virtual Package view opens. Figure 6-7: Virtual Package View ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 331 Importing a Virtual Package After the Import of its Source Windows Installer Package • Manually Associating a Virtual Package with a Windows Installer Package Description You can edit this field and add additional information about the virtual package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 332: Patches Tab Views

    • Import Patches—Opens the OS Security Patch Wizard so that you can import patches into the Application Catalog. • Group—Create a new group. • Rename—Rename the selected group. • Properties—Open the Group Properties dialog box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 333: New Patches Group View

    When the New Patches group in the Patches Tab is selected, the following items are available on the context menu: • Group—Create a new group. • Rename—Rename the selected group. • Properties—Open the Group Properties dialog box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 334: Group View Of A Selected Group

    The following information is included: Table 6-48 • Patch View Information Option Description Microsoft Security Bulletin ID. Click this link to view this bulletin on the Microsoft Web site. Title Title of patch. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 335 Paste—Insert the patch on the clipboard into the selected location. • Generate Report—Generate a Patch Impact Analysis Report for that patch. See Generating the Patch Report. • Properties—Open the Patch Properties dialog box for that patch. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 336: Merge Module Views

    Click the plus sign next to the Merge Module to view these Merge Module constituent views: • Merge Module / Components View • Merge Module / Dependency View • Merge Module / Exclusion View • Merge Module / Files View • Merge Module / Products View ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 337: Merge Module / Components View

    When you expand a merge module in the merge modules explorer, you can click on Exclusion to display any exclusions in the merge module. The following information is displayed for each exclusion included in this merge module: • ModuleLanguage • ExcludedID • ExcludedLanguage • ExcludedMaxVersion • ExcludedMinVersion AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 338: Merge Module / Files View

    Manufacturer of the product associated with this Merge Module. Dialog Boxes Application Manager includes the 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 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 339: Application Catalog Properties Dialog Box

    Table 6-52 • Application Catalog Properties / Software Repository Tab Options Option Description Enable Software Select this option to enable the Software Repository feature for this Repository Application Catalog. Software Repository Specify the directory location of the Software Repository for this Application Location Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 340: Associate With Workflow Manager Application Dialog Box

    AdminStudio Enterprise Server Application Catalog (which is the same password you use to log in to the AdminStudio Enterprise Server). The Change AES Password selection is enabled when you are connected to the AdminStudio Enterprise Server Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 341: Command-Line Parameters Dialog Box

    If the Application Catalog is made the default, all other AdminStudio users that use the same shared directory will automatically connect to the default Application Catalog when AdminStudio is launched. Therefore, you should only set this option if you want to affect all AdminStudio users who access that shared directory. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 342: Enterprise Server Tab

    IP address, and you receive Error 0x800A1518 when you attempt to login, change the AdminStudio Enterprise Server URL to the NetBios equivalent and then try again. For example, if you are connecting to http:// , the NetBios equivalent would be 120.12.1.15 http://wfmportal ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 343: Standalone Tab

    Application Catalog Only when AdminStudio is launched. Therefore, you should only set this option if you want to affect all AdminStudio users who access that shared directory. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 344: Recent Tab

    If you are opening a standalone SQL Server Application Catalog, you will be prompted for login information. • If you are opening the AdminStudio Enterprise Server Application Catalog, you are prompted for AdminStudio Enterprise Server login information before the Application Catalog will open. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 345: Default Application Catalog Dialog Box

    • must not contain any of the following characters: [ ] { } ( ) , ; ? * ! @ AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 346: Extended Attribute Property Dialog Box

    A specific column in a specific table in the selected Package Also, if you want to search for a partial match rather than an exact match, you can use the Partial Match option on the Find dialog box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 347 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 search will be case insensitive. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 348: Login Required Dialog Box

    Provide a name for the group. This name cannot exceed 40 characters. Description Enter any descriptive information about the group. This cannot exceed 80 characters. Comments Provide any comments about the group. Comments cannot exceed 255 characters in length. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 349: Package Auto Import Dialog Box

    This button is disabled for Remote Application Catalog entries until the linked packages have been imported into the Application Catalog for the first time. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 350: Package Auto Import Properties (Remote Application Catalog) Dialog Box

    The Groups tab displays the packages within a Remote Application Catalog that you can link to. Select or deselect the check boxes to link/unlink to the packages. Any package that is already linked to will display the check box as selected. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 351 To disable automatic import, leave this option unselected. When this option is selected, the scheduling fields are enabled. Run the Process From this list, select Daily or Weekly to specify how often you want automatic import to be performed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 352: Package Auto Import Properties (Network Directory) Dialog Box

    Run the process—Select whether you want to run the monitoring process Daily or Weekly. • At—Specify the time that you want to run the monitoring process. • Starting on—Select the initial day that you want to begin the monitoring process. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 353: Publication Manager Dialog Box

    Click to delete the selected Publication from the Publication Manager. Caution • If an attempt to create a Publication fails, it could be because your Publication server does not have a Distributor server configured. For more information, see Initial Configuration Checklist. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 354: Publication Processing Dialog Box

    Publication: those users who have been assigned privileges to this database server through the SQL Enterprise Manager. sysadmin You can remove users from the list. See Publication Access List Panel for more information. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 355: Select Application Catalog Dialog Box

    Application Catalog at any one time: the one that has been executed (updated) the most recently. For information on how to use the Disable feature on the Subscription Manager to subscribe to more than one Application Catalog, Specialized User Scenarios. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 356 Subscription’s data. When a disabled Subscription is selected, the Run button is disabled. For more information, see Specialized User Scenarios. Delete Click to delete the selected Subscription from the Subscription Manager. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 357: Task Scheduling Dialog Box

    (Monday), but if you didn’t want the Publication to be updated until the Friday after next, you would select Saturday. Click OK to exit the Task Scheduling dialog box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 358: Test Connection Dialog Box

    Package function to associate it with any Windows Installer package in the Application Catalog, even one that is not its source package. Therefore, it is preferable to use the Import Wizard to import both the Windows Installer and virtual packages at the same time so that AdminStudio can create the proper associations. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 359: Application Catalog Wizard

    This allows you to immediately test AdminStudio features using the packages in New that have already been imported. Catalog Next Advances you to the next panel in the Wizard. Back Moves you to the previous panel in the Wizard. Cancel Terminates the Wizard. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 360: Specify Database Information Panel

    Login ID and Password—If you chose Server Authentication, enter the appropriate Login ID and Password. Catalog Select the catalog from those available on the Server. Test Click this button to test whether a connection can be made to the database. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 361: Select Software Repository Location Panel

    Table 6-69 • Select Software Repository Location Panel Options Option Description Enable Software Repository Select this option to enable the Software Repository feature for this new Application Catalog. Software Repository Location Specify the directory location of the Software Repository for this Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 362: Creating Application Catalog Panel

    Target Package Information Panel (Transforms/Patches) • Import Options Panel • Additional non-MSI Import Options Panel • Destination Group Panel • Summary Panel When run, Application Manager displays its progress messages in the Import tab of the Output Window. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 363: Welcome Panel

    Advances you to the next panel in the Wizard. Back Moves you to the previous panel in the Wizard. Cancel Terminates the Wizard. Help Brings up help specific to the Import Wizard panel currently displayed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 364: File Selection Panel

    ThinApp Applications (.exe) A virtual application that runs within a ThinApp virtual environment. Other Non-MSI Setup Types Non-MSI setup types (such as InstallShield Professional or ISMP installations). ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 365: Associate Virtual To Msi Packages Panel

    Windows Installer package, modify the original Windows Installer package, and then regenerate the virtual package. Select the package that you want to associate with the virtual package you are importing and click Next to continue. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 366: Mst Source Information Panel

    If you specify an update.exe patch file that was created by Developer/DevStudio/InstallShield Editor, Application Manager will extract the .msp file in the Temp folder and then perform the import. You can also add additional patch files: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 367: Msm Source Information Panel

    If you need to delete a merge module you have added, clear its check box. If you want to store this merge module in the Software Repository, select the Add the file(s) to the Software Repository option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 368: Virtual Package Import Panel

    Installer package is complete, you can use the Import Wizard to import virtual packages separately, as described in Importing Virtual Packages. You would then be prompted to associate the virtual package with its already-imported source Windows Installer package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 369: Target Package Information Panel (Software Repository)

    ConflictSolver and Application Manager views. However, changing this “display” name does not change the Product Name that appears in the title bar of the ConflictSolver and Application Manager Product Views. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 370: Target Package Information Panel (Transforms/Patches)

    Click the Explore button to select the base directory of this package where all of its associated files can be found. Include entire Select this option to include the selected directory and all of its subdirectories. directory hierarchy ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 371: Destination Group Panel

    Package Auto Import Wizard Note • To use the Package Auto Import feature, you must have AdminStudio 9.5 Administrator permission. For all other users, the Package Auto Import options will be disabled. The Package Auto Import feature allows you to copy packages between various Application Catalogs and maintain consistency between the copied packages.
  • Page 372: Package Auto Import Type Selection Panel

    Select the Application Catalog you want to link to from the Catalogs list. • Click Browse to open the Select Application Catalog Dialog Box and connect to an existing Application Catalog as described in Connecting to an Existing Application Catalog. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 373: Folder Panel

    Select the group in the Application Catalog where you want these packages to be imported, and click Next. Note • Packages that are imported using Remote Application Catalog monitoring are imported into the Package Auto Import group in the Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 374: Schedule Panel

    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 consolidated into one centralized Application Catalog. Another reason to merge Application Catalogs would be a need to have the same data available in multiple geographic locations. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 375: Source Application Catalog Panel

    Application Catalog, the source Application Catalog’s package will overwrite the duplicate. Progress Panel The Progress panel displays messages from the merge process. When the merge is complete, review the log as necessary and click Finish to exit the Wizard. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 376: Os Snapshot Wizard

    If you want to review or change current capture settings, click Edit to display the Analysis Options dialog box. Analyzing Panel The Analyzing panel appears while the OS Snapshot Wizard analyzes your system. Following the snapshot, the Summary panel appears. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 377: Os Snapshot Summary Panel

    It is strongly recommended that you not modify this file, as it increases the likelihood of either inadvertently omitting necessary pieces of the OS snapshot, or including registry entries or files that should not be part of the snapshot. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 378: Publication Wizard

    Button Description Next Advances you to the next panel in the Wizard. Back Moves you to the previous panel in the Wizard. Cancel Terminates the Wizard. Help Brings up help about the specific Wizard panel. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 379: Publication Details Panel

    Publication. If you do not select this option, all groups and all packages within those groups will be included in the Publication. Merge Module Select this option if you would also like to include all Merge Modules in the Application Data Catalog in the Publication. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 380: Publication Access List Panel

    Groups that the Publisher has included. However, if the Publisher adds a new package to one of these same Groups after he has created the Publication, the new package is not automatically added to the existing Publication, making ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 381: Publication Summary Panel

    The Subscription Wizard for Application Catalog Replication walks you through the process of creating an SQL Server Subscription to an Application Catalog database. The Subscription Wizard consists of the following panels: • Welcome Panel • Subscription Details Panel • Subscription Selection Panel • Subscription Summary Panel AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 382: Subscription Details Panel

    When a Subscription is updated, all of its data is replaced by replicated data from the Publisher database. This field is not directly editable. Click the Change button to access the Task Scheduling dialog box, where you can specify how frequently the Subscription will be automatically updated. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 383: Subscription Selection Panel

    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 Catalog in AdminStudio 9.5, you are prompted to upgrade it to use the AdminStudio 9.5 schema.
  • Page 384: Adminstudio Database Schema Tables

    • Application Catalog Replication Tables • cssys: AdminStudio System Tables • cstbl: AdminStudio Supporting Tables • as: Job Manager Tables • cspch: OS Security Patch Wizard Tables • pdt: Predeployment Test Tables • Miscellaneous Tables ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 385 For a detailed list of supporting tables, see cstbl: AdminStudio Supporting Tables. wftbl These are AdminStudio workflow tables (tables used to store workflow, steps, projects, tools, etc.) ams_ AdminStudio Workflow Manager stores the data in tables whose names begin with ams_. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 386 A Foreign Key is a column or combination of columns used to establish and enforce a link between two tables. In the Application Manager database, the column is the Foreign Key for MSI packages into the PkgRowID_ table—the table that is the primary table containing product information. cstblPackage ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 387: Database Server Permissions

    For this process, the user will need to be able to write entries into the cstblValidationResults and cstblValidationConfiguration tables. Dependency For this process, the user will need to be able to write entries into the Scanning Process cstblPackageExeDependencies table. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 388 A number of processes within AdminStudio generate data which can subsequently be deleted by the AdminStudio user. Any discussion of the minimum privileges required for a specific AdminStudio process will also imply the privileges to delete this same data. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 389: Adminstudio Msi Table Mapping

    Table 6-85 • System Tables Table Corresponding Windows Installer Table cssysExtendedAttributeSchema cssysSchemaInfo cssysTables ConflictSolver Tables An Application Catalog contains the following ConflictSolver Tables: Table 6-86 • ConflictSolver Tables Table Corresponding Windows Installer Table cstblPackage cstblGroups cstblGroupPackages AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 390: Msi Tables

    An Application Catalog contains the following MSI Tables: Table 6-87 • MSI Tables Table Name Corresponding Windows Installer Table csmsiActionText ActionText csmsiAdminExecuteSequence AdminExecuteSequence csmsiAdminUISequence AdminUISequence csmsiAdvtExecuteSequence AdvtExecuteSequence csmsiAdvtUISequence AdvtUISequence csmsiAppId AppId csmsiAppSearch AppSearch csmsiBBControl BBControl csmsiBillboard Billboard ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 391 ComboBox csmsiCompLocator CompLocator csmsiComplus Complus csmsiComponent Component csmsiCondition Condition csmsiControl Control csmsiControlCondition ControlCondition csmsiControlEvent ControlEvent csmsiCreateFolder CreateFolder csmsiCustomAction CustomAction csmsiDialog Dialog csmsiDirectory Directory csmsiDrLocator DrLocator csmsiDuplicateFile DuplicateFile csmsiEnvironment Environment csmsiError Error csmsiEventMapping EventMapping csmsiExtension Extension AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 392 Icon csmsiIniFile IniFile csmsiIniLocator IniLocator csmsiInstallExecuteSequence InstallExecuteSequence csmsiInstallUISequence InstallUISequence csmsiIsolatedComponent IsolatedComponent csmsiLaunchCondition LaunchCondition csmsiListBox ListBox csmsiListView ListView csmsiLockPermissions LockPermissions csmsiMedia Media csmsiMIME MIME csmsiModuleComponents ModuleComponents csmsiModuleDependency ModuleDependency csmsiModuleExclusion ModuleExclusion csmsiModuleSignature ModuleSignature csmsiMoveFile MoveFile csmsiMsiAssembly MsiAssembly ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 393 ODBCAttribute csmsiODBCDataSource ODBCDataSource csmsiODBCDriver ODBCDriver csmsiODBCSourceAttribute ODBCSourceAttribute csmsiODBCTranslator ODBCTranslator csmsiPatch Patch csmsiPatchPackage PatchPackage csmsiProgId ProgId csmsiProperty Property csmsiPublishComponent PublishComponent csmsiRadioButton RadioButton csmsiRegistry Registry csmsiRegLocator RegLocator csmsiRemoveFile RemoveFile csmsiRemoveIniFile RemoveIniFile csmsiRemoveRegistry RemoveRegistry csmsiReserveCost ReserveCost csmsiSelfReg SelfReg AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 394: Msm Tables

    _Validation MSM Tables An Application Catalog contains the following MSM tables: Table 6-88 • MSM Tables Table Name Corresponding Windows Installer Table csmsmActionText ActionText csmsmAdminExecuteSequence AdminExecuteSequence csmsmAdminUISequence AdminUISequence csmsmAdvtExecuteSequence AdvtExecuteSequence csmsmAdvtUISequence AdvtUISequence csmsmAppId AppId ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 395 CCPSearch csmsmCheckBox CheckBox csmsmClass Class csmsmComboBox ComboBox csmsmCompLocator CompLocator csmsmComplus Complus csmsmComponent Component csmsmCondition Condition csmsmControl Control csmsmControlCondition ControlCondition csmsmControlEvent ControlEvent csmsmCreateFolder CreateFolder csmsmCustomAction CustomAction csmsmDialog Dialog csmsmDirectory Directory csmsmDrLocator DrLocator csmsmDuplicateFile DuplicateFile csmsmEnvironment Environment AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 396 File csmsmFileSFPCatalog FileSFPCatalog csmsmFont Font csmsmIcon Icon csmsmIniFile IniFile csmsmIniLocator IniLocator csmsmInstallExecuteSequence InstallExecuteSequence csmsmInstallUISequence InstallUISequence csmsmIsolatedComponent IsolatedComponent csmsmLaunchCondition LaunchCondition csmsmListBox ListBox csmsmListView ListView csmsmLockPermissions LockPermissions csmsmMedia Media csmsmMIME MIME csmsmModuleAdminExecuteSequence ModuleAdminExecuteSequence csmsmModuleAdminUISequence ModuleAdminUISequence csmsmModuleAdvtExecuteSequence ModuleAdvtExecuteSequence ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 397 ModuleInstallExecuteSequence csmsmModuleInstallUISequence ModuleInstallUISequence csmsmModuleSignature ModuleSignature csmsmModuleSubstitution ModuleSubstitution csmsmMoveFile MoveFile csmsmMsiAssembly MsiAssembly csmsmMsiAssemblyName MsiAssemblyName csmsmMsiDigitalCertificate MsiDigitalCertificate csmsmMsiDigitalSignature MsiDigitalSignature csmsmMsiFileHash MsiFileHash csmsmMsiPatchHeaders MsiPatchHeaders csmsmODBCAttribute ODBCAttribute csmsmODBCDataSource ODBCDataSource csmsmODBCDriver ODBCDriver csmsmODBCSourceAttribute ODBCSourceAttribute csmsmODBCTranslator ODBCTranslator csmsmPatch Patch csmsmPatchPackage PatchPackage AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 398 RegLocator csmsmRemoveFile RemoveFile csmsmRemoveIniFile RemoveIniFile csmsmRemoveRegistry RemoveRegistry csmsmReserveCost ReserveCost csmsmSelfReg SelfReg csmsmServiceControl ServiceControl csmsmServiceInstall ServiceInstall csmsmSFPCatalog SFPCatalog csmsmShortcut Shortcut csmsmSignature Signature csmsmTextStyle TextStyle csmsmTypeLib TypeLib csmsmUIText UIText csmsmUpgrade Upgrade csmsmVerb Verb csmsmsys_Columns _Columns csmsmsys_Tables _Tables ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 399: Os Snapshot Tables

    Corresponding Windows Installer Table csoscFile csoscIniFile csoscShortcut csoscRegistry Workflow Tables An Application Catalog contains the following Workflow tables: Table 6-90 • Workflow Tables Table Name Corresponding Windows Installer Table wftblCommandLines wftblTemplateTasks wftblTemplateWorkflow wftblTemplates wftblTools wftblUserWorkflows wftblWorkflowTasks wftblGroups wftblGroupTools AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 400: Security Tables

    AdminStudio. An Application Catalog contains the following Workflow Manager tables: Table 6-92 • AdminStudio Workflow Manager Tables Table Name Corresponding Windows Installer Table asAMSAppRegistrations AMS_AppAsgnRpt AMS_AppAssignments AMS_Application AMS_ApplicationItem AMS_AuditTrail AMS_Company AMS_CompanyBU AMS_Contracts AMS_DataMajorItemTpl ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 401 Table 6-92 • AdminStudio Workflow Manager Tables (cont.) Table Name Corresponding Windows Installer Table AMS_DataMinorItemTextTpl AMS_DataMinorItemTpl AMS_Dictionary AMS_EmailContent AMS_Issues AMS_ItemRole AMS_KnowledgeCore AMS_LanguageList AMS_LanguageLongString AMS_LanguageStrings AMS_LanguageSymbols AMS_LanguageUsages AMS_Person AMS_PersonRole AMS_Policy AMS_Preference AMS_Queries AMS_Roles AMS_ServiceCompanyJoin AMS_Templates AMS_WFMajorItemTpl AMS_WFMinorItemTpl AMS_UploadedFiles AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 402: Application Catalog Replication Tables

    Custom Tables All custom tables are excluded. Miscellaneous asAMSAppRegistrations asAMSWorkflowProjects cstblSubscribedDatabases cstblSubscribedData cstblPackageRelationships cstblIgnoreTableList cstblPackageHistoryLog cssysExtendedAttributeSchema cssysSchemaInfo cssysTables csmsisys_Validation csmsisys__Tables csmsisys__Columns tables wftblCommandLines wftblTemplateTasks wftblTemplateWorkflow wftblTemplates wftblTools wftblUserWorkflows wftblWorkflowTasks wftblGroups wftblGroupTools ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 403: Tables Included In Replication

    The cssysExtendedAttributeSchema table contains data about the Database Schema’s extended attributes. This table contains the following columns: Table 6-95 • cssysExtendedAttributeSchema Columns Column Type Nullable Description RowID The Primary Key—used to uniquely identify a record. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 404 Help text can be up to 512 characters long. Remarks This table is populated when the user changes the entries on the Extended Attributes Tab of the ConflictSolver and Application Manager Options Dialog Box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 405: Cssysschemainfo

    RowID The Primary Key—used to uniquely identify a record. TableName text The name of the table. This name can be up to 72 characters long. DateCreated datetime Date the table was created. TableType Used internally. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 406: Cstbl: Adminstudio Supporting Tables

    • cstblConflictPackages • cstblConflictResults • cstblConflictTransformList • cstblConflictResultsDestPkgs Package and Transform File • cstblPackage Tables • cstblTransformFile • Groups Table cstblGroups Misc. Tables • cstblPackageRelationships • cstblIgnoreTableList • cstblPackageHistoryLog • Extended Attributes Tables cstblExtendedAttributeData ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 407: Cstblsubscribeddatabases

    This table contains the data that associates the packages in the subscribed and local databases. This table contains the following columns: Table 6-100 • cstblSubscribedData Columns Column Type Nullable Description RowID The Primary Key—used to uniquely identify a record. SubscribedDatabaseRowID_ Private Key identifier into a subscribed database entry. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 408: Cstblconflictconfiguration

    Path can be up to 512 characters long. ConflictRunDate datetime Date the run of the Conflict Wizard was performed. NoOfErrors Number of automatically-resolvable errors that were identified in this run of the Conflict Wizard. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 409: Cstblconflictace

    Name of the ACE that was run. Name can be up to 72 characters long. Category text The category name of the ACE that was run. Category can be up to 72 characters long. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 410: Cstblconflictpackages

    Conflict Wizard. Comments can be up to 4000 characters long. Flags Used internally. Remarks This information is duplicated from the ACE file to use for display purposes in ConflictSolver and for the Run Again function in the Conflict View. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 411: Cstblconflictresults

    Name of table associated with the ACE that contains the conflicting data. Name can be up to 255 characters long. Category Category of the ACE. It matches an entry in the ACE file. State Identifies the status of the ACE: Resolved or Unresolved. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 412: Cstblconflicttransformlist

    The Primary Key—used to uniquely identify a record. PkgRowID_ Foreign Key identifier into the cstblPackage table to which these conflict persistence results are associated. If the value is -1, it indicates that the data is associated with an external package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 413: Cstblpackage

    The value of the equivalent MSI Manufacturer. Name can be up to 255 characters long. ProductLanguage The value of the equivalent MSI ProductLanguage. FileName text UNC path to the MSI package. Name can be up to 255 characters long. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 414: Cstbltransformfile

    Name of transform file. File can be up to 255 characters long. ProductLanguage text Name of language of product in string form. Language can be up to 128 characters long. Remarks This table is used only if the imported package includes transforms. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 415: Cstblgroups

    The Primary Key—used to uniquely identify a record. PkgRowID_ Foreign Key identifier into the first package associated with this duplicate relationship. SecondPkgRowID_ Foreign Key identifier into the second package associated with this duplicate relationship. Relationship Used internally. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 416: Cstblignoretablelist

    Not currently used. Type Indicates what type of log entry this represents. CreateDate datetime Date the history log was created. UserID text Not used. Remarks Currently only used to store information about the import configuration options. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 417: Cstblextendedattributedata

    Table 6-114 • cstblGroupPackages Columns Column Type Nullable Description RowID The Primary Key—used to uniquely identify a record. ParentGroupCode Foreign Key identifier into the cstblGroup table. Parent group containing either the package or the group entry (Group Row ID). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 418: As: Job Manager Tables

    The user name that created this job and derived as part of the Enterprise Server login process. JobType Varchar(5) A string identifying the two job types of Custom ( ) and cust Template ( ) jobs. temp ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 419: Asjobqueue

    This value identifies which job is associated with this job queue entry. UserName Varchar(255) The name of the user who added this job to the job queue and derived as part of the Enterprise Server login process. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 420: Asjobstep

    JobIOrder The ordinal number in which the job step is executed when the job itself is executed. StepId_ Foreign key into the table which AsJobStepMaster identifies the type of job. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 421: Asjobstepmaster

    The last message generated by this particular job step. StatusId_ Foreign key into the table – AsQueueStatus StatusId column. Describes the specific status of this particular job step. ReportData Varchar(4000 Extended job step specific data which describes how the job was processed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 422: Asnotification

    Table 6-121 • AsQueueStatus Table Columns Nullabl Column Type Description StatusId The primary key identifier of particular job status value. StatusName Varchar(32) A specific name for a given job status. Description Varchar(250) A descriptive name for the job status ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 423: Asschedule

    OS Security Patch Wizard Tables The following OS Security Patch Wizard tables are included in the AdminStudio Database Schema: • cspchBulletin • cspchPatchFileData • cspchPatchOperation • cspchPatchPackage • cspchPatchProducts • cspchPatchRegistryData • cspchProducts • cspchProductServicePacks • cspchServicePacks AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 424: Pdt: Predeployment Test Tables

    Tip • By default, all packages are imported into the root group. If you want to import packages to specific groups, you must use a configuration file ( parameter), and specify a group for each package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 425 -IF"msi_file_name[; msp1; msp2...]" and optionally a semicolon-delimited list of transforms or -IF"msi_file_name[; mst1; msp1; msp2...]" patches to be applied before importing the package. iscmide.exe -F"c:\mycatalogs\conflict.mdb" -IF"c:\mypackages\mymsi.msi; c:\mypackages\mytrans.mst;" iscmide.exe -F"c:\mycatalogs\conflict.mdb" -IF"c:\mypackages\mymsi.msi; c:\mypackages\mypatch.msp; c:\mypackages\mytrans.mst;" iscmide.exe -F"c:\mycatalogs\conflict.mdb" -IF"c:\mypackages\mymsi.msi AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 426 -F parameter is ignored. iscmide.exe -S"mysql\sql1" This parameter is only used for SQL Server Application -U"admin" Catalogs, and is a required parameter when using a SQL -P"admin" Server–based Application Catalog. -D"mycatalog" -IF"c:\mypackages\mymsi.msi; c:\mypackages\mytrans.mst;" ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 427: Specifying User Interface Mode Via Command Line

    In addition to supporting individual command-line parameters, Application Manager can also use a configuration file (when specified using the parameter). This INI file can contain the values for all -C"configuration_file_name" required parameters during the import process. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 428 File=\\server\Data1.msi Transform1=\\server\Data1a.mst Transform2=\\server\Data1b.mst Group=OfficeApps [MSIFile-2] File=\\server\Data2.msi Group=OfficeApps\Secondary [MSIFile-3] File=\\server\Data3.msi [MSMFile-1] File=\\server\CrystalReports.msm Configuration File for SQL Server Application Catalog for a Trusted User [General] DatabaseType=SQL LogFile=c:\temp\importlog.txt MSIFile=3 MSMFile=1 [SQL] Server=ConflictSolverSQL2K Database=AdminStudio70 [MSIFile-1] File=\\server\Data1.msi Transform1=\\server\Data1a.mst Transform2=\\server\Data1b.mst Group=OfficeApps ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 429 Configuration File for Applying Transforms and/or Patches During Command-Line Import [General] DatabaseType=Access LogFile=c:\temp\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 AdminInstallLocation=\\Server\Shared\Data1 [MSIFile-2] File=\\server\Data2.MSI Patch1=\\server\Data1p.MSP AdminInstallLocation=\\Server\Shared\Data2 [MSIFile-3] File=\\server\Data3.MSI Transform1=\\server\Data3a.MST Patch1=\\server\Data1p.MSP AdminInstallLocation=\\Server\Shared\Data3 [OtherSetupFile-1] SetupName=AdminStudio for Macintosh SetupDirectory=C:\AdminStudio\MacFiles FullDirectory=1 AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 430 Use the Database parameter to provide the catalog name for the SQL Server. It corresponds to the -D command-line parameter. If a value is not specified, the default SQL Server Application Catalog for the specified login will be used. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 431 ([MSMFile-1], [MSMFile-2], etc.). Each section must contain the name and location of the file. Table 6-128 • Parameter Explanation: [MSMFile-n] Section Parameter Description File Use this parameter to specify the name and location of the merge module (.msm) you are importing. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 432: Using A Configuration File With Command-Line Options

    Importing Multiple Merge Modules Simultaneously • Simultaneously Importing Windows Installer Packages and Merge Modules • Using the Command Line to Import All Packages in a Directory • Running Import Silently • Creating a Log File During Command-Line Import ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 433: Applying Transforms And Patches During Command-Line Import

    Use the following command line to call your configuration file, in which you can specify multiple Windows Installer packages to import. iscmide.exe -C"configuration_file" Replace with the name and location of the configuration file containing the names and configuration_file locations of the packages you want to import. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 434: Importing Multiple Merge Modules Simultaneously

    Application Manager for each MSI file. If this is not acceptable, use a configuration file instead. • No transforms are applied to the imported packages. If you need to apply transforms, use a configuration file instead. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 435: Running Import Silently

    Using the following command line, you can connect to a specific SQL Server Application Catalog: iscmide.exe -S"sql_server_name" -U"user_id" -P"password" Replace with the specific SQL Server name (including path information). Replace sql_server_name user_id with the UserID and password for the server. password AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 436: Creating Shortcuts To Specific Standalone Application Catalogs

    SQL Server name, UserID, password, and Application Catalog name using the -S or -O, -U, -P , and -D parameters. See Application Manager Command-Line Functionality Connecting to a Specific Standalone Application Catalog Using Command-Line Options. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 437: Application Catalog Replication Command Line Functionality

    Optional, if not present we attempt to connect to the default database. Otherwise, we will prompt the user for a connection of an existing database. Silent launch without splash dialog box. -h[number] Parent window handle. (Optional) AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 438 Chapter 6: Managing Application Catalog Databases Reference ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 439 Part 3 Repackaging and Customizing Installations 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 and Authoring Installations Using InstallShield • Customizing Installations Using Tuner AdminStudio 9.5 User Guide...
  • Page 440 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 441: Repackaging Legacy Installations Using The Repackaging Wizard

    Explains how to use the Repackaging Wizard to convert the following Installations Using the installations: Repackaging Wizard • InstallShield Professional 1.x to 5.1.x • InstallShield Professional 5.5 to 7.x • InstallShield InstallScript MSI • InstallShield DevStudio 9.x InstallScript • InstallShield Editor InstallScript AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 442: About Repackaging

    Catalog database, ensuring the proper installation and functioning of your installations. • Can implement application repair and feature advertising—Finally, once converted to a Windows Installer package, the installation can take advantage of Windows Installer functionality such as application repair and feature advertisement. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 443: Supported Legacy Installation Types

    You can use the Repackager interface to convert the following installations: Interface • Repackager 3.x output (.inc) • Microsoft SMS projects (.ipf) • Novell ZENworks 3.0, 3.1, or 4.0 projects (.axt/.aot) • WinINSTALL projects (.txt) (6.0, 6.5, 7.x) • Wise installation projects (.wse) • InstallShield Professional log files (.isl) Converting Legacy Installations Using the Repackager Interface.
  • Page 444: Repackaging Options Comparison

    Repackager project with no feature .inc delineation Microsoft SMS projects ( Select Open on the File menu to .ipf have Repackager automatically Novell ZENworks 3.0, 3.1, or 4.0 convert file to a Repackager project projects ( .axt/.aot WinINSTALL projects ( ) (6.0, .txt 6.5, 7.x)
  • Page 445: Repackaging Wizard Best Practices

    You should repackage using the provided exclusions and then use the Repackager interface to visually remove unwanted items from the capture. Because this occurs post-capture, you do not need to recapture the legacy setup if you inadvertently exclude items from the Windows Installer package you are building. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 446: About Repackaging On Clean Systems

    Windows Installer packages. Note • For more information on setting up a clean system to repackage on, see Configuring Repackager to Ensure Optimal Installation Capture. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 447: Alternate-Language Repackaging On Clean Machines

    InstallShield Repackager reads logged output of InstallShield Editor and DevStudio 9.x Professional InstallScript installations to obtain additional information that would not be captured Logging Method by repackaging, such as path variables and a feature tree. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 448: Installation Monitoring Method

    In order to avoid repackaging errors when using the Snapshot method, you should exclude these directories. Excluding Directories and Subdirectories for more information. Note • Anti-virus software does not affect repackaging using the Installation Monitoring method. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 449: Installshield Professional Logging Method

    You access the InstallShield Professional Logging Method through the Repackaging Wizard, but InstallShield Professional Logging Method is not offered as a choice on the Method Selection Panel of the Repackaging Wizard. Only Installation Monitoring and Snapshot are listed: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 450: Configuring Repackager To Ensure Optimal Installation Capture

    To ensure that you capture all changes made by the installation, you should, ideally, install the application onto a “clean machine” (a computer with only the operating system installed), as described in About Repackaging on Clean Systems. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 451: Launching Repackager Remotely

    Locate a production machine with network access that has AdminStudio installed on it. Tip • Check to make sure that this installation of AdminStudio has already been activated before proceeding. Open Windows Explorer and locate the following directory: C:\Program Files\AdminStudio\9.5\Repackager AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 452 Shortcut to Repackager on the Clean Machine). The Repackager Start Page opens. Important • Because you are running Repackager remotely, the online help topics cannot be viewed. However, you can view a version of AdminStudio Help Library online at: http://helpnet.flexerasoftware.com ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 453 On the Set Target Project Information and Capture Settings panel of the Repackaging Wizard, do not set the Project path to store files field to a location on the clean machine; instead choose a network location. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 454: Installing Repackager On A Clean Machine

    Click Install to begin the installation process. The Installing Repackager panel opens. When installation is complete, the InstallShield Wizard Completed panel opens. Click Finish to exit the Wizard. A Repackager shortcut will be added to the Windows Start menu under AdminStudio, AdminStudio Tools. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 455: Repackaging Legacy Installations Using The Repackaging Wizard

    Repackager reads logged output of InstallShield Editor and DevStudio 9.x Professional Logging InstallScript installations, allowing you to get additional information that would not Method be captured by standard repackaging. Repackaging Using the InstallShield Professional Logging Method. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 456: Repackaging Using The Installation Monitoring Method

    • Step 6: Set Capture Settings (Optional) • Step 7: Beginning the Repackaging Process Step 1: Selecting the Repackaging Method In this step, you launch the Repackaging Wizard and select the Installation Monitoring repackaging method. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 457 From the Repackager interface, launch the Repackaging Wizard by clicking on the link or by selecting Repackaging Wizard from the Tools menu. The Welcome Panel opens. Click Next. The Method Selection Panel opens. Select Installation Monitoring. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 458: Step 2: Excluding Processes (Optional)

    ) button to add a new blank line to this list, and enter the name of the process that you want to exclude. To delete a process from this list, select the process and click the Delete ( ) button. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 459: Step 3: Collecting Product Information

    If you want to associate Web sites with this installation, click the More link to open the Additional Product Information dialog box, enter the Product URL and Support URL for the application you are repackaging, and click OK. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 460: Step 4: Adding Additional Setup Programs (Optional)

    If you want to add a setup program, perform the following steps: Click New. The Setup Information dialog box opens. Click the Browse ( ) button next to the Program File field and select the setup program that you want to add. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 461: Step 5: Set Target Project Information

    In this step, you identify the location where you want files created by Repackager to be stored. For the Installation Monitoring repackaging method, it is recommended that this location not be located on your clean machine, but rather on the same machine as the Repackager executable (most likely on your administrator machine). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 462: Step 6: Set Capture Settings (Optional)

    From the Set Target Project Information and Capture Settings Panel, you can specify the following capture types for the repackaging session: • Files and deleted files • .ini files and .ini files with non-.ini extensions • Shortcuts ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 463 (INI files with) Non-.ini extensions • Shortcuts • Registry data • Deleted registry data Click OK to return to the Set Target Project Information and Capture Settings Panel. Continue with Step 7: Beginning the Repackaging Process. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 464: Step 7: Beginning The Repackaging Process

    Follow the prompts until the installation has completed. When the installation 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. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 465 Following repackaging, the Summary Panel is displayed, providing confirmation that the repackaging was successful. Click Finish. Repackager launches and opens the Repackager project file ( ) that you just created. *.irp Continue with the instructions in Working With Repackager Projects. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 466: Repackaging Using The Snapshot Method

    After making the necessary modifications, you would then run the Repackager again to analyze system status changes. • Repackager compares the final snapshot to the initial snapshot to determine the system changes that were made, and then records that information in a script file. Performing Multiple Step Snapshot Repackaging. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 467: Performing Multiple Step Snapshot Repackaging

    To select a repackaging method: From the Repackager interface, launch the Repackaging Wizard by clicking on the link or by selecting Repackaging Wizard from the Tools menu. The Welcome Panel opens. Click Next. The Method Selection Panel opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 468 Select Snapshot and click Next. The Snapshot Method panel opens. On the Snapshot Method panel, select Multiple Steps. The Analyze the initial system status option is enabled. Select the Analyze the initial system status option. Continue with Step 2: Initial Analysis. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 469: Step 2: Initial Analysis

    On the Snapshot Method panel, click Next. The Repackaging Panel of the Repackaging Wizard opens, displaying the progress of the initial system status capture. When Repackager finishes capturing the initial system status, the Summary panel opens, prompting you to install the application you are repackaging. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 470: Step 3: Install Setup And Make Manual System Changes

    Analyze system status changes option now enabled and selected. Continue with Step 4: Entering Product Information. Step 4: Entering Product Information In this step, you will enter product information for the application that you just installed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 471: Step 5: Set Target Project Information

    Enter the Product URL and Support URL for the application you are repackaging. Click OK. Continue with Step 5: Set Target Project Information. Step 5: Set Target Project Information In this step, you identify the location where you want files created by Repackager to be stored. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 472: Step 6: Set Capture Settings (Optional)

    If you want to modify the default capture settings, perform the following steps. • If you do not want to modify the default capture settings, click Next and continue with Step 7: Beginning the Repackaging Process. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 473 INI files • (INI files with) Non-.ini extensions • Shortcuts • Registry data • Deleted registry data If you want to restrict directory analysis to specific directories, click New. The Choose Directory dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 474: Step 7: Beginning The Repackaging Process

    Click OK to return to the Set Target Project Information and Capture Settings Panel. Continue with Step 7: Beginning the Repackaging Process. Step 7: Beginning the Repackaging Process In this step you will begin the repackaging process. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 475 Summary Panel opens, providing confirmation that the repackaging was successful and listing the location of your new Repackager project. Click Finish. Repackager launches and opens the Repackager project file ( ) that you just created. *.irp AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 476: Performing Single Step Snapshot Repackaging

    Step 3: Set Target Project Information • Step 4: Set Capture Settings (Optional) • Step 5: Beginning the Repackaging Process Step 1: Selecting the Repackaging Method In this step, you launch the Repackaging Wizard and select the Snapshot repackaging method. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 477 The InstallShield Professional Logging Method, which should be used to repackage InstallShield Editor and DevStudio 9.x InstallScript setups, is not offered as a choice on the Method Selection panel. See Repackaging Using the InstallShield Professional Logging Method for more information on using that method. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 478: Step 2: Collecting Product Information

    Step 2: Collecting Product Information. Step 2: Collecting Product Information In this step, you will specify the installation you want to repackage and enter any command-line arguments to be used when the installation is run. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 479 If you want to associate Web sites with this installation package, perform the following steps: Click the More link. The Additional Product Information dialog box opens. Enter the Product URL and Support URL for the application you are repackaging. Click OK. Continue with Step 3: Set Target Project Information AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 480: Step 3: Set Target Project Information

    If you want to modify the default capture settings, perform the following steps. • If you do not want to modify the default capture settings, click Next and continue with Step 7: Beginning the Repackaging Process. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 481 INI files • (INI files with) Non-.ini extensions • Shortcuts • Registry data • Deleted registry data If you want to restrict directory analysis to specific directories, click New. The Choose Directory dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 482: Step 5: Beginning The Repackaging Process

    Click OK to return to the Set Target Project Information and Capture Settings Panel. Continue with Step 7: Beginning the Repackaging Process. Step 5: Beginning the Repackaging Process In this step you will begin the repackaging process. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 483 Install the application by following the prompts until the installation has completed. When the installation 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. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 484 Repackager project that was just created. Click Finish. Repackager launches and opens the Repackager project file ( ) that you just created. *.irp Continue with the instructions in Working With Repackager Projects. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 485: Repackaging Using The Installshield Professional Logging Method

    To repackage an InstallShield Editor or DevStudio 9.x InstallScript installation using the InstallShield Professional Logging Method, perform the following steps: Task: To repackage using the InstallShield Professional Logging Method: Launch the Repackaging Wizard from Repackager. The Welcome Panel opens. Click Next. The Method Selection Panel opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 486 Editor or DevStudio 9.x InstallScript installation and the InstallShield Professional Setup Panel will not open. You can avoid this extra and possibly troublesome step by selecting Installation Monitoring on the Method Selection Panel. On the Method Selection Panel, click Next. The Collect Product Information Panel opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 487 Enter the Product URL and Support URL for the application you are repackaging. Click OK. Click Next. Because you specified an InstallShield Editor or DevStudio 9.x InstallScript installation in the Program File field, the InstallShield Professional Setup Panel opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 488 To begin the repackaging process, click Start on the Set Target Project Information and Capture Settings Panel. The selected InstallShield Editor or DevStudio 9.x InstallScript installation is launched. Follow the prompts until the installation has completed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 489: Repackaging An Installscript Msi Setup To A Basic Msi Setup

    Click Next. If you selected Snapshot on the Method Selection Panel, the Snapshot Method Panel appears. (If you selected Installation Monitoring, skip to Step 6.) Select Single Step and click Next. The Collect Product Information Panel opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 490: Running The Repackaging Wizard From The Command Line

    To run the Repackaging Wizard from the command line, perform the following steps. Task: To run the Repackaging Wizard from the command line: Open a command-line prompt. Type followed by any command-line options you want to pass. See Repackaging Wizard Repack.exe Command-Line Options. Press Enter. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 491: Repackaging A Windows Installer (.Msi) Package

    To repackage a Windows Installer package: From the Repackager interface, launch the Repackaging Wizard by clicking on the link or by selecting Repackaging Wizard from the Tools menu. The Welcome Panel opens. Click Next. The Method Selection Panel opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 492 For instructions on using the Snapshot method, see Repackaging Using the Snapshot Method Click the Browse ( ) button next to the Program File field to open the Choose Setup Program File dialog box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 493 MSI setups should not typically be repackaged. Click Yes to close the message. Several fields in the Collection Product Information panel have been populated with the commands necessary to repackage a Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 494 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 status. Then, the selected setup program will be launched. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 495 When you are ready to complete 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 confirmation that the repackaging was successful. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 496: Repackaging Wizard Reference

    This section lists the command-line options that are supported by the Command-Line Options Repackaging Wizard. Reboot Handling in the This section describes how the Snapshot Method and Installation Monitoring Repackaging Wizard Method handle required reboots during repackaging. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 497: Repackaging Wizard

    Additional Repackaging Wizard Dialog Boxes Welcome Panel The Welcome panel appears when you first launch the Repackaging Wizard, providing some introductory information about the use of the Wizard, including that it is for use with traditional (non-Windows Installer-based) installations. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 498: Method Selection Panel

    Chapter 7: Repackaging Legacy Installations Using the Repackaging Wizard Repackaging Wizard Reference Figure 7-1: Repackaging Wizard Welcome Panel Method Selection Panel From the Method Selection panel, select the method(s) you want to use for repackaging. Figure 7-2: Repackaging Wizard Method Selection Panel ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 499 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 following: • Application Paths • Environment Variables AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 500: Snapshot Method Panel

    Snapshot Method Panel The Snapshot Method Panel, which is only displayed if you use the snapshot technology, allows you to specify the way in which you perform repackaging. Figure 7-3: Repackaging Wizard Snapshot Method Panel ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 501: Collect Product Information Panel

    Setup Programs area is disabled. If you are performing a system status change analysis, the Repackaging Panel appears when you click Next. Collect Product Information Panel The Collect Product Information panel gathers information necessary for repackaging the installation(s). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 502 Program File The name and location of the setup executable. Click the Browse button to locate this file. This is a required field. Command-Line Any command-line arguments to be used when the setup is run. Argument(s) ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 503: Installscript Msi Identified Panel

    Additional Product Information dialog box, where you can enter the Product URL and Support URL for the application you are repackaging. InstallScript MSI Identified Panel This panel opens if the Repackaging Wizard identifies an installation as an InstallScript MSI installation created with InstallShield Editor, InstallShield DevStudio, or InstallShield Developer. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 504 Yes—Use InstallScript Scan to automatically extract the MSI package and convert it to Basic MSI, while preserving the original components and installation logic. This is the default selection. • No—Repackage the installation using the repackaging method selected on the Method Selection Panel (Installation Monitoring or Snapshot). Click Next to proceed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 505: Installshield Professional Setup Panel

    Set Target Project Information and Capture Settings Panel The location where you want files created by Repackager stored is defined in the Project path to store files field on the Set Target Project Information Panel. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 506: Installscript Msi Conversion Output Panel

    InstallScript MSI Conversion Output Panel On this panel, specify the location where you want Repackager to store the files it creates during InstallScript Scan analysis. The converted Windows Installer MSI package will be saved to this location. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 507: Repackaging Panel

    Analysis Options dialog box, you can specify capture types for the repackaging session, and, for snapshot-mode captures, you can restrict directory analysis to specific directories. Click Start to begin repackaging and display the Repackaging Panel. Repackaging Panel The Repackaging panel appears while Repackager analyzes your system. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 508 After the setups have been completed, you are prompted to click the Process button to complete the repackaging process. Figure 7-10: Repackaging Wizard Repackaging Panel 2 When you click Process, the repackaging is performed and its progress is displayed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 509: Summary Panel

    The final panel displayed by Repackager is the Summary panel. Figure 7-12: Repackaging Wizard Summary Panel This panel provides confirmation that repackaging was successful, and provides the location of the source setup program(s), the Windows Installer package, and the InstallShield Editor project. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 510: Additional Repackaging Wizard Dialog Boxes

    Brings up the Setup Information dialog box to enter information about the setup programs. Edit Displays the Setup Information dialog box to edit information about the currently selected setup. Delete Removes the currently selected setup. Moves the selected setup up in the setup programs list. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 511: Setup Information Dialog Box

    Therefore, you may choose to exclude those processes by adding them to the list on the Excluded Processes dialog box. Figure 7-15: Repackaging Wizard Excluded Processes Dialog Box AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 512: Analysis Options Dialog Box

    Additionally, for snapshot-mode captures, you can restrict directory analysis to specific directories, which can significantly improve repackaging performance. Click New to add a directory restriction, Edit to modify an existing restriction, or Delete to remove a restriction. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 513: Repackaging Wizard Command-Line Options

    This option allows you to select the configuration file type for exclusions. -cs <configuration type> Possible values are: • Shared—Use shared settings from those stored in the AdminStudio directory. Shared • Custom—Use a custom configuration file (in conjunction with AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 514 -o <.inc path name> from the Product Name unless overridden with the -of switch. -of <inc file name> Specifies the .inc file name that should be used instead of the product name. Use -o to specify the path. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 515: Reboot Handling In The Repackaging Wizard

    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 launched, you can continue repackaging by clicking Process. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 516 As in Snapshot repackaging, it is generally a good idea to wait a minute or two before clicking Process. In both circumstances, waiting helps ensure the setup is fully installed and that captured data contains the necessary information to properly rebuild the setup as an MSI installation. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 517: Converting Legacy Installations Using The Repackager Interface

    Explains how to launch the Repackager interface and how to set options. Interface Creating Repackager Explains how to create a Repackager project file (.irp), which can then be built Projects into an InstallShield Editor project (.ism) or a Windows Installer package (.msi). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 518 F1 key or click the Help button while working in a dialog box. Note • For information on other Repackager features, see Repackaging Legacy Installations Using the Repackaging Wizard Converting Windows Installer Packages to Virtual Applications. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 519: About The Repackager Interface

    Note • You can also launch Repackager directly from the Windows Start menu by pointing to All Programs, AdminStudio, AdminStudio 9.5 Tools, and clicking Repackager. Caution • It is highly recommended that you repackage applications on a “clean” system. See...
  • Page 520: Selecting Data Display Colors

    From the Tools menu, select Options. The Colors tab of the Options dialog box opens. Open the Merge Modules tab. Enter the directory paths to the custom merge modules. To specify multiple directories, separate the folder paths with commas. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 521: Controlling The Display Of Ice Validation Warnings

    Windows Installer package. You can also exclude files, shortcuts, registry entries, and files from the resulting Windows Installer package, without .ini affecting the original setup data. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 522: Converting Legacy Installations Using The Repackager Interface

    You can use the Repackager interface to convert the following installations: Interface • Repackager 3.x output (.inc) • Microsoft SMS projects (.ipf) • Novell ZENworks 3.0, 3.1, or 4.0 projects (.axt/.aot) • WinINSTALL projects (.txt) (6.0, 6.5, 7.x) • Wise installation projects (.wse) • InstallShield Professional log files (.isl) Converting Legacy Installations Using the Repackager Interface.
  • Page 523: Converting Repackager 3.X Output Files

    .ini project are visible through the appropriate views in the Repackager Interface. Converting Novell ZENworks Projects You can convert Novell ZENworks 3.0, 3.1, or 4.0 projects ( ) to Windows Installer packages ( ) one at .axt/.aot .msi...
  • Page 524: Converting A Novell Zenworks Project Using The Repackager Interface

    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. ADS-0950-UG00...
  • Page 525: Converting Multiple Novell Zenworks Projects Using The Command Line

    Repackager is installed, the Files of type filter will be Novell ZENworks (*.axt/*.aot). If this agent is not installed, the Files of type filter will be Novell ZENworks (*.axt) and you will be unable to select .aot files as the legacy setup source.
  • Page 526 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 file as the location of the input .ini .aot/.axt files. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 527: Converting Wininstall Projects

    (in the location specified in the log file), but if it cannot, it will allow you to browse to it before continuing. If you do not have access to the original setup media, the conversion will fail. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 528: Working With Repackager Projects

    ) from your Repackager project ( .ism .irp You can also choose to build just an InstallShield Editor project, so that you can open it in InstallShield Editor and make some modifications prior to building. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 529 If you do not want to Create a Windows Installer package (.msi) after creating the Editor project, clear this option. If you want to create a Windows Installer Package, see Building a Windows Installer Package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 530 Name—The name of the company that developed the product you are repackaging. Product Name—The name of the product you are repackaging. Version—The product’s version number. Product URL—The URL for product information. This appears in Add/Remove Programs in the Control Panel. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 531: Building A Windows Installer Package

    You can simultaneously build an InstallShield Editor project ( ) and a Windows Installer package ( ) from .ism .msi your Repackager project ( ). However, before you do so, you must configure options in your Repackager .irp project necessary for the build. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 532 In the Editor Project field, enter the name and location of the InstallShield Editor Project file you want to create. Select the Create a Windows Installer package (.msi) after creating the Editor project option, and select the following additional options: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 533 .msi and setup.exe files. To reduce 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, select the Create an AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 534 Select Package Information from the View List. The Package Information View opens, where you can specify information for the Windows Installer package that you build from the Repackager project. Much of this information may be prepopulated based on settings used in the Repackaging Wizard. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 535 URL—A URL for support information. This also appears in Add/Remove Programs in the Control Panel, and is often changed during repackaging to provide an internal support URL. Select Advanced Settings from the View List. The Advanced Settings View opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 536: About The Context.msi File

    However, this type of information is occasionally necessary in \Windows\Installer order to successfully convert a Windows Installer package to a virtual package. To address this issue, when Repackager builds a Windows Installer package, it now produces two files: .msi packagename.msi packagename.context.msi ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 537: Configuring Advanced Conversion Options

    Use the language captured by When selected, the target package's language will be the language the Repackager as the detected by Repackager (as displayed in the Captured Installation language of the setup view). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 538 Under InstallShield SmartScan, select the InstallShield SmartScan options you want to use during conversion: Option Description Include files from InstallShield Files identified in the Media Scan Wizard will be included in the legacy media scan package (unless you have manually excluded them from the project). ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 539: Automatically Generating A Virtual Application During Repackager Project Build

    In the Editor Project field, enter the name and location of the InstallShield Editor Project file you want to create. Select the Create a Windows Installer package (.msi) after creating the Editor project option, and select the associated compression, isolation, and automated test options as described in Building a Windows Installer Package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 540 Create a Citrix XenApp profile Note • If you would like to further customize the virtual application using the InstallShield Microsoft App-V Assistant, ThinApp Assistant, or Citrix Assistant, you can click the Modify the Editor project link below to ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 541 If you chose the Citrix XenApp profile option, a folder named was created in the CitrixProfile location you specified in the Editor Project field. This folder contains the Citrix profile for this package and all of its associated files: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 542: Viewing Repackager Project Properties

    File—The name and location of the captured data file ( ), which was either created .inc by the Repackaging Wizard or during conversion of a Novell ZENworks project, Microsoft SMS project, or WinINSTALL project. The path is relative to the current Repackager project file. ADS-0950-UG00...
  • Page 543: Using The Setup Intent Wizard To Detect File Dependencies In A Repackager Project

    Repackaging Wizard). You can then save the Repackager project and transfer it to another machine. Creating a Setup Capture Report for a Project You can generate an HTML or text document that summarizes the data that was captured when a setup was repackaged. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 544 Captured Registry entries The report also indicates which of the files, shortcuts, file entries, or Registry entries, if any, have been marked .ini for exclusion. Those marked for exclusion are not included in the Repackager project. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 545: Saving Repackager Projects

    Saving Repackager Projects Edition • To save a Repackager project, perform the following steps: Task: To save the current Repackager project: Select Save from the File menu. Click the Save button ( ) on the toolbar. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 546: Opening Installshield Editor From Repackager

    Information about application isolation is presented in the following topics: • About Application Isolation • About Assemblies • About Manifests • About Digital Certificates • Setting Isolation Options • Building an Isolated Windows Installer Package ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 547: About Application Isolation

    Repackager, you can also use Application Isolation Wizard to isolate a Windows Installer package. Application Isolation Wizard is a stand-alone tool which accepts a Windows Installer package as input and outputs a new, isolated Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 548: About Assemblies

    Application manifests are XML files that describe an isolated application. This descriptive information includes the relationship between the application and its dependent files. Typically, the naming convention for a manifest is: ApplicationName.Extension.manifest For example, if the application was , the manifest file is called: HelloWorld.exe ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 549: About Digital Certificates

    Digital Signature tab of the Isolation Options dialog box to digitally sign your shared assembly and ensure end users of its content's authenticity. The .spc (Software Publishing Credentials) file and .pvk file you enter in the Digital Signature tab compose the digital certificate for shared assemblies. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 550: Setting Isolation Options

    DLLs—with which it was originally developed and tested. On the Isolation Options Dialog Box, which is opened by selecting Isolation Options from the Tools menu, you can specify the following Repackager isolation options: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 551: Specifying Manifest Options

    Manifests for shared assemblies must be digitally signed. See Setting Digital Signature Options for Shared Assemblies. Note • The modifications you make on the Isolation Options dialog box will be recorded in the file, which is stored in the directory. isolationconfig.ini AdminStudio Shared AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 552: Specifying The Assembly Naming Conventions

    For more information, see About Digital Certificates. Task: To set digital signature options: Open the Repackager interface. From the Tools menu, select Isolation Options. The Manifest Options tab of the Isolation Options dialog box opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 553: Building An Isolated Windows Installer Package

    Packages. Configuring Exclusions Repackaging exclusions refer to exclusions made during repackage time using the Repackaging Wizard. Any files, registry entries, .ini files, or shortcuts excluded at this point are not included in the Repackager project. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 554: Configuring Exclusions Using Repackager

    These individual project exclusions allow you a fine-level of control as you prepare to build your Windows Installer package from the Repackager project. Excluding Files To exclude a captured file from the InstallShield Editor project and Windows Installer package, perform the following steps. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 555: Excluding All Files In A Directory

    Expand the directory tree to display the directory containing the files and subdirectories you want to exclude. Right-click the directory and then click Exclude All. Excluding Registry Keys To exclude a registry key from the InstallShield Editor project and Windows Installer package, perform the following steps. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 556: Excluding Registry Values

    Expand the INI Files tree to display the .ini file you want to exclude. Right-click the .ini file and then click Exclude. Excluding .ini File Sections To exclude a section in a captured .ini file from the InstallShield Editor project and Windows Installer package, perform the following steps. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 557: Excluding Shortcuts

    Right-click the directory and then click Exclude. Excluding Shortcuts from Subdirectories To exclude all captured shortcuts within a directory or its subdirectories from the InstallShield Editor project and Windows Installer package, perform the following steps. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 558: Specifying The External Configuration File

    Select the Use settings from the shared location or the Use settings from a custom file option. The Browse button for that option is activated. Click Browse and select the configuration file you want to use. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 559: Modifying External Configuration Files

    The Repackager best practice is to capture everything using the Repackaging Wizard, and then exclude visually in the Repackager Interface. This way, you avoid having to run the Repackaging Wizard again if you accidentally exclude necessary files. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 560: Exclusions And Repackager

    , using either interface. isrepackager.ini However, if you want to create a new, custom exclusions file, you must launch the Exclusions Editor outside of Repackager. • Launching Exclusions Editor Outside of Repackager • Launching Exclusions Editor Within Repackager ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 561 Note • Note that when opening the Exclusions Editor from within Repackager, there is no File menu displayed, meaning that you can only edit an existing exclusions file; you cannot create a new exclusions file. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 562: Excluding Files

    . If you want to exclude multiple file types from the same directory (or .bak *.bak from all directories), separate each exclusion with a pipe ( Click OK to close the File Exclusion Information dialog box. The new exclusion appears in the Files tab. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 563: Excluding Directories

    Launch the Exclusions Editor and open an exclusions file by performing the steps listed in Launching Exclusions Editor: Select the appropriate exclusion and click Edit. The File Exclusion Information dialog box opens. In the File Exclusion Information dialog box, modify the Path and Excluded Files information. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 564: Removing File Exclusions

    Launch the Exclusions Editor and open an exclusions file by performing the steps listed in Launching Exclusions Editor: Open the INI Files tab. Click New. The INI File Exclusion Information dialog box opens. Enter or browse to the file you want to exclude. .ini ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 565: Excluding Sections From .Ini Files

    .ini file and/or sections as excluded; this can be changed from within Repackager on an .ini file by .ini file basis. However, when configuring .ini file exclusions for the OS Snapshot Wizard, .ini files in the exclusion list are not captured in the OS snapshot file. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 566: Editing Existing .Ini File Exclusions

    When configuring .ini file exclusions 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 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 567: Excluding Registry Data

    Launch the Exclusions Editor and open an exclusions file by performing the steps listed in Launching Exclusions Editor: Open the Registry tab. Select the registry key that you want to edit and click Edit. The Edit Registry Key dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 568: Removing Registry Exclusions

    During repackaging, the real-time virus detection feature of anti-virus software could automatically update various cached files in its directories. Therefore, in order to avoid repackaging errors when using the Snapshot repackaging method, you should exclude the software directories containing your anti-virus software. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 569: Scanning Installshield Professional Setups For Additional Data

    The SmartScan Wizard is also able to group files, shortcuts and registry entries into features corresponding to InstallShield Professional components. Any items (files, folders, shortcuts, or registry entries) that are attached to a component directly or indirectly (through File Groups), are attached to their corresponding features. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 570 After you have scanned an InstallShield Professional project and included data from it in your Repackager project, you can save the project. When you reopen it, this collected data no longer retains the “scanned” color, since it is now part of the Repackager project. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 571: Creating An Installshield Editor Template To Use Within Repackager

    To create a customized InstallShield Editor template: Create a new Basic MSI Project in the InstallShield Editor. On the Installation Designer tab, select the General Information node under Installation Information, and enter your company-specific information as required. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 572 Chapter 8: Converting Legacy Installations Using the Repackager Interface Creating an InstallShield Editor Template to Use Within Repackager Under Behavior and Logic, select the Property Manager node and add the required properties like , etc. ALLUSERS ISSCRIPTDRIVEN ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 573 Chapter 8: Converting Legacy Installations Using the Repackager Interface Creating an InstallShield Editor Template to Use Within Repackager You can also optionally set Shallow Folder Structure to Yes in the Releases view under Media. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 574 Chapter 8: Converting Legacy Installations Using the Repackager Interface Creating an InstallShield Editor Template to Use Within Repackager After making all required changes, save the project as an InstallShield Editor Template ( ) type. .ist ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 575 From within the Repackager interface, you can start using this customized template by selecting the Use a customized template option in the Repackaged Output view, and selecting the InstallShield Editor template that you just created. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 576: Repackager Interface Reference

    F1 key or click the Help button while working in a dialog box. • Repackager Interface • SmartScan Wizard • Setup Intent Wizard • VMware Repackaging Wizard • Exclusions Editor Interface • Options.ini File ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 577: Repackager Interface

    Open the Repackaging Wizard and repackage legacy setups. • Open the Exclusions Editor and configure exclusions. • Convert Novell ZENworks, Microsoft SMS, and WinINSTALL projects into Repackaging projects. • Create a package exclusion list. • Build a Repackager project into an InstallShield Editor project and Windows Installer package.
  • Page 578: Repackager Start Page

    • Advanced Settings View Output Window When you open Repackager 3.x output, Novell ZENworks projects, Microsoft SMS projects, WinINSTALL projects, or Wise installation projects in the Repackager Interface, conversion information appears in the Output window. This window can be toggled from the View menu.
  • Page 579 Chapter 8: Converting Legacy Installations Using the Repackager Interface Repackager Interface Reference Figure 8-3: Repackager Start Page AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 580: Menus And Toolbar

    Allows you to open: • An existing Repackager project ( .irp • Repackager 3.x output ( .inc • Novell ZENworks 3.0, 3.1, or 4.0 project .axt/.aot • Microsoft SMS project ( .ipf • WinINSTALL converted project ( .txt (6.0, 6.5, or 7.x) •...
  • Page 581 Options Displays the Options dialog box. Tools Isolation Displays the Isolation Options dialog box, Options where you can specify assembly and digital signature isolation options. Help Contents Launches the Help Library, displaying the Contents tab. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 582: Dialog Boxes

    Back button. Dialog Boxes Repackager includes the following dialog boxes to assist you in your project creation: • Create Report Dialog Box • Isolation Options Dialog Box • Options Dialog Box • Password Required Dialog Box ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 583: About Repackager Dialog Box

    The Create Report dialog box, available by selecting Create Report from the Project menu, allows you to configure a report for the current Repackager project, or a specific subset of captured data. Figure 8-5: Create Report Dialog Box AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 584: Isolation Options Dialog Box

    Options—Configure the certificate information required when using shared assemblies. Digital Signature Tab. Note • The modifications you make on the Isolation Options dialog box will be recorded in the , which is stored in the directory. isolationconfig.ini file AdminStudio Shared ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 585 On the Digital Signature tab, you can configure the certificate information required when using shared assemblies.This required digital signature provides an extra layer of protection, allowing you to obtain information about the company who created a global assembly. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 586 VeriSign, with specific information about your company and software. SPC File Specify the name and location of your software publishing credentials file ( .spc Specify the name and location of your private key file ( .pvk ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 587: Options Dialog Box

    (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 containing custom merge modules to use during repackaging. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 588: Password Required Dialog Box

    Professional setup which requires a password. Provide the password for the setup and click OK to proceed. For InstallShield Professional 6.x and 7.x setups, the SmartScan Wizard can bypass password protection, and will not prompt you for a password even if one is required to run the installer. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 589: Project Properties Dialog Box

    The following options are displayed: Table 8-10 • General Tab Options Option Description Project Location The full path of the current Repackager project file ( .irp Project File The name of the current Repackager project file. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 590 The name and location of the captured data file ( ), which was either created by .inc the Repackaging Wizard or during conversion of a Novell ZENworks project, Microsoft SMS project, or WinINSTALL project. The path is relative to the current Repackager project file.
  • Page 591: Wininstall Conversion Dialog Box

    When you convert a WinINSTALL project to a Repackager project, this dialog box appears to allow you to set WinINSTALL-specific variables. These variables are: Table 8-12 • WinINSTALL Variables Variable Description @Server The machine name of the server where the WinINSTALL directory is located. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 592: Repackager Views

    Anything longer than this limit will be truncated in the view. The full value can be viewed in InstallShield Editor. Captured Installation View From the Captured Installation View, you can review summary information about the setup you are converting into a Windows Installer package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 593 InstallShield Professional media (if the original setup was created with InstallShield Professional) for additional files. Edition • The Setup Capture Report and Scan for Setup Intent features are included with AdminStudio Standard, Professional, and Enterprise Editions. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 594: Files And Folders View

    Table 8-13 • File Attributes Attribute Description Name The file's name. Size The file's size in bytes. Version The file's version. Short Name The short name for the file (if the file's author defined it). Language The file's language. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 595: Registry Entries View

    From the Registry Entries view, you can examine information about each captured registry entry, selectively exclude registry values or registry keys from the package you are creating, or reinclude registry values that you previously excluded. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 596: Shortcuts View

    Include All (to include all of the registry entries in the selected hive or key and all of its keys and subkeys). Shortcuts View From the Shortcuts view, you can examine information about each captured shortcut, selectively exclude shortcuts from the package you are creating, or reinclude shortcuts that you previously excluded. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 597 The name of the file containing the shortcut's icon. Icon Index The index number for the icon in the icon file. Note • Shortcuts can be excluded from the Windows Installer package you are building on an individual shortcut basis or by directory. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 598: Ini Files View

    From the INI Files view, you can examine information about each captured file, selectively exclude files or .ini .ini file sections from the package you are creating, or reinclude files or sections that you previously .ini .ini excluded. Figure 8-15: Repackager INI Files View ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 599: Deleted Files View

    The short name for the file (if the file's author defined it). Language The file's language. Excluding Files and Subdirectories To specify which files and subdirectories you want to include in the package, use the Exclude, Exclude All, Include, and Include All buttons: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 600: Deleted Registry Entries View

    To include a registry entry in the package that had previously been excluded, select the registry entry you want to include and click Include. • To include all registry entries and subdirectories within a directory, select the directory containing the shortcuts and subdirectories you want to include and click Include All. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 601: Repackaged Output View

    ) file. .ism Windows Installer The name and location of the Windows Installer package ( ). If a Windows .msi package Installer package has not yet been built from this Repackager project, (not is listed. built) AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 602 Create uncompressed .msi file + setup.exe—Select this option if you want to create an uncompressed .msi file along with a setup.exe file. All of the rest of the necessary files, in uncompressed format, would be shipped with the .msi and setup.exe files. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 603 Create a Microsoft If this option is selected, after building a Windows Installer (.msi) file, a Microsoft App-V application App-V application will also be built. Note • This option requires that you build a Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 604 Editor—Open this Repackager project’s associated Windows Installer package in InstallShield Editor. Once you have built the Windows Installer package and/or InstallShield Editor file, you can launch InstallShield Editor from the Repackaged Output area of the view. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 605: Package Information View

    The URL for product information. This appears in Add/Remove Programs in the Control Panel. Support URL A URL for support information. This also appears in Add/Remove Programs in the Control Panel, and is often changed during repackaging to provide an internal support URL. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 606: Advanced Settings View

    If this option is unchecked, the default UI sequence is displayed when the setup is installed. Replace files with merge Following best practice rules, Repackager replaces components with modules wherever possible comparable merge modules whenever possible. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 607 ODBC resources are supported correctly by Windows Installer. Map NT Service events to the If selected, NT Service–related registry data is mapped to ServiceControl ServiceControl table table instead of the Registry table. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 608: Smartscan Wizard

    InstallShield Professional 5.5 or later installation, and • the file has not already been repackaged using the InstallShield Professional Logging Method (available for InstallShield Editor and DevStudio 9.x InstallScript installations only), and ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 609: Welcome To The Smartscan Wizard Panel

    The first panel in the SmartScan Wizard is the Welcome panel. Figure 8-19: SmartScan Wizard Welcome Panel When you click Next, you advance to the Original InstallShield Professional Setup Panel, where you specify the InstallShield Professional setup you want to scan. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 610: Original Installshield Professional Setup Panel

    InstallShield Professional setup executable that you want to scan. If you enter an invalid path name, the Next button will be disabled. Specify password if Specify a password of the path of the original setup executable, if required. required ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 611: Scanning Panel

    The Setup Feature Tree Panel lists the features and components that were configured in the original InstallShield Professional project. If you want to use this feature and component information, select the Add feature tree option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 612: Scanning Media Panel

    Following the actual scan of the original setup media, the SmartScan Wizard displays a log of files to be included in the project. Figure 8-23: SmartScan Wizard Scanning Media Panel Click Finish to add these to the project. Any default exclusions based on the exclusions file will be applied. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 613: Setup Intent Wizard

    The first panel in the Setup Intent Wizard informs you the purpose of the Wizard, and warns you the source files for your project must be present for successful scanning. Figure 8-24: Setup Intent Wizard Welcome Panel AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 614: Scanning Project Panel

    Select the files you want to include in your project which were not identified during repackaging. Click Finish to exit the Setup Intent Wizard and return to the Repackaging project (with selected files automatically added to the project), or click Back to return to the Scanning Project Panel. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 615: Vmware Repackaging Wizard

    On the VMware Virtual Machines panel, you select a VMware virtual machine available on the current workstation. Repackager automatically launches the selected virtual machine operating system within a VMware session so that you can begin repackaging in that environment. Note • AdminStudio supports VMware 3.0 and later. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 616: Exclusions Editor Interface

    File Open | Allows you to browse to an Exclusions Editor settings file and Custom open it. You would create a custom exclusion file based upon Exclusions your company's requirements. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 617: Files Tab

    Figure 8-26: Exclusions Editor Files 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. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 618: Ini Files Tab

    The INI Files tab contains a list of the files and sections within files excluded during analysis. If all .ini .ini sections are excluded, an asterisk ( ) is used in the Excluded Sections column. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 619: Registry Tab

    Value column. For keys that have all values excluded, an asterisk (*) represents the entire key in the Value column. Figure 8-28: Exclusions Editor Registry Tab AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 620: File Exclusion Information Dialog Box

    To exclude all files with a certain extension in the selected directory, enter an asterisk ( ) plus the extension, such as: *.txt • To exclude all files in the selected directory, enter an asterisk ( Click OK to return to the Files Tab. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 621: Ini File Exclusion Information Dialog Box

    Figure 8-31: Choose Registry Key Dialog Box Navigate through the tree until you find the key you want to exclude and click OK to return to the Registry Tab. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 622: Edit Registry Key Dialog Box

    Repackager and is used during the conversion of Repackager output into an Options.ini InstallShield Editor project ( ). It includes basic project settings which are required by Repackager. Information .ism about this file is presented in the following sections: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 623 Control Panel. ARPSupportURL This populates the Support URL field in Add/Remove Programs in the Control Panel. AutoUpgrade Upgrades the InstallShield Editor template project file (if used) if needed. This option is set to Y by default. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 624 Set this option to Y to use path variables. If enabled, the repackaged setup is significantly more portable between computers (with dependencies to the system where the setup was repackaged removed). This option is set to Y by default. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 625 This option is set to Y by default. MMPathVersion When including merge modules, if this option is set to Y, compare path and version information. This option is set to Y by default. NewInstallDir Value for INSTALLDIR variable. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 626 When this option is set to Y, one component will be created for every file in your setup. Otherwise, new components will only be created for each portable executable file. This option is set to N by default. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 627 Stream (accessible from the package's properties). SkipMMIfShortcut Merge Modules that have files pointed to by shortcuts should be skipped even if they are not in the exclusion list. This option is set to Y by default. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 628 Shortcuts that refer to executables listed in this section will be ignored during conversion. Options.ini File Defaults This section lists the default settings in the file that is shipped with Repackager: Options.ini [MMExclusions] [General] UseSrcFolder=Y EnablePathVariables=Y UseHKCUProxy=N LimitedUI=Y SISAuthor=InstallShield Repackager OtherFilesNewComponents=N UseMergeModules=Y SharedCommonFiles=Y ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 629: Files Associated With Repackager

    Repackager. During the Snapshot and Install resource and stores it in the Windows Monitoring modes of repackaging, the entries directory. in this file are filtered out from the repackaged output. Repack.ini File for more information. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 630 This is an output file from the Repackaging directory (specified in the Set Target Wizard when the Snapshot method is used. It Project Information and Capture contains registry additions and modifications Settings Panel). detected during repackaging using the Snapshot method. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 631 Wizard when the Install Monitoring method is WindowsDrive\InstallHook used. It contains API call logs for installation monitoring. Contains the default configuration for Default.ini AdminStudio Installation Directory\Repackager Repackager, including default exclusion information. WindowsFolder Log file created by the Repackaging Wizard. Repack.log AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 632: Repack.ini File

    In the first scenario, you may need to recapture your application; in the second, you may need to exclude more from the Repackager project. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 633: Using Installshield To Chain Multiple Windows Installer Packages Together

    WinINSTALL LE tool available as a free download in Windows 2000 to convert to 7.x files. • Repackager tool cannot convert WinINSTALL .NAI files—It can only convert WinINSTALL projects that have been converted to text ( .txt AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 634: Troubleshooting Guidelines For Sms Conversion

    32,767. If it is, this error occurs because Windows Installer supports 32,767 files in the File table but the package being built exceeds this limit. See Authoring a Large Package in Windows Installer Help for more information. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 635 IsMsiPKg.itp Note • Transforms and patches cannot be created between two packages with different column types. Note • For more information, see the Authoring a Large Package File Table topics in the Windows Installer Help. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 636 Chapter 8: Converting Legacy Installations Using the Repackager Interface Repackager Interface Reference ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 637: Converting Windows Installer Packages To Virtual Applications

    Introduces you to the Citrix XenApp virtualization technology and describes Packages the components of a Citrix profile. Converting a Single Explains how to use the Windows Installer Converter to convert a single Application to a Virtual Windows Installer package into a virtual package. Package AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 638: Getting Started With Application Virtualization

    Getting Started With Application Virtualization AdminStudio provides support for the conversion of Windows Installer packages to the following virtual application formats: • Microsoft App-V applications • VMware ThinApp applications • Citrix profiles, which can be deployed on Citrix XenApp ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 639 Setting operating system and/or Assistant requirements language requirements • Specifying deployment server For detailed information on how to use the Microsoft App-V Assistant, ThinApp Assistant, and Citrix Assistant, see Creating Customized Virtual Applications in the InstallShield Help Library. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 640: About Application Virtualization

    Because of these possible problems, extensive compatibility testing needs to be performed before an application can be distributed in the enterprise environment. The following diagram provides an example of two conflicting installed applications. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 641 The following diagram provides an example of how application virtualization would solve the conflicts shown in the previous example. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 642: Types Of Virtual Package Conversion

    Application virtualization greatly reduces the scope for conflicts between applications and, therefore, simplifies compatibility testing. Types of Virtual Package Conversion When performing application virtualization, Windows Installer Converter supports several modes of conversion. You have three options when performing virtual package conversion with Windows Installer Converter: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 643 The file contains the shortcut .profile information, and the file contains all of the files necessary to run the applications in the suite. However, .cab AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 644 Repackager project. See Automatically Generating a Virtual Application During Repackager Project Build. • Command Line—You can run the Windows Installer Converter from the command line. See Running the Windows Installer Converter from the Command Line. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 645: About Microsoft Application Virtualization (App-V)

    V applications that are available on the App-V server. Benefits of Using the Windows Installer Converter Instead of using the App-V Sequencer to create App-V applications, you can use the Windows Installer Converter, as shown in the following diagram: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 646 Chapter 9: Converting Windows Installer Packages to Virtual Applications About Microsoft Application Virtualization Figure 9-4: Using the Windows Installer Converter to Create an App-V Package ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 647 This information is often not readily available, and may require you to open the installation in an editing tool, such as InstallShield, in order to find it, or to run the installation one time prior to sequencing. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 648: Components Of An App-V Application

    Components of an App-V Application When you use Windows Installer Converter to build an App-V virtual package, the resources you generate are called App-V applications. The components of an App-V application are shown in the following diagram: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 649 Table 9-4 • Components of an App-V Application File Size Definition Up to 4 GB The largest and most important file in an App-V application. All of the application’s assets—including files, registry entries, fonts, COM, and virtual services—reside in this file. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 650 InstallShield builds for that App-V application. 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 file and enter the published location of its file .osd .sft ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 651: How Windows Services Are Integrated Into An App-V Application

    Windows Installer package’s use of a Windows service is indicated by a Registry entry for Windows services (perhaps as the result of being repackaged), Windows Installer Converter does not need to make any changes to support the application’s use of the Windows service within the virtual environment. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 652: About Thinapp Virtual Packages

    Also, ThinApp applications can be run safely from restricted user accounts without local installation. Information about ThinApp applications is presented in the following sections: • ThinApp Virtual Operating System • Benefits of Deploying ThinApp Applications • Components of a ThinApp Application ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 653: Thinapp Virtual Operating System

    ThinApp application. • Location of application data—This executable file contains all of the files, registry keys, DLLs, ThinApp components, and third party libraries that are required for the application to run. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 654 Figure 9-7: Interm Subdirectory of the ThinAppPackage Directory The data in this directory is then compiled into ThinApp application as part of the build process. The data in the directory does not need to be distributed with the ThinApp application. Interm ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 655: Benefits Of Deploying Thinapp Applications

    You can use the Windows Installer Converter to convert a Windows Installer package to a Citrix profile for deployment on Citrix XenApp. Information about using the Windows Installer Converter is presented in the following topics: • About Citrix XenApp and Citrix Profiles AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 656: About Citrix Xenapp And Citrix Profiles

    Applications are centralized on Citrix XenApp 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 running on the same machine. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 657: About Citrix Profiles (.Profile)

    These files are saved in a subfolder of a folder named that is created in the same directory as the CitrixProfile Windows Installer package you converted. The profile, which is published on Citrix XenApp, consists of the following: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 658 Modifying these files directly is not recommended. To make any modifications, use the InstallShield Citrix Assistant. A profile can contain a single application or suite of applications. For more information, see: • Converting a Single Application to a Virtual Package ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 659: Benefits Of Deploying Citrix Profiles

    • Prevents application-specific server 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 incompatible applications on the same server. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 660 “decommission” applications by simply turning off a user’s 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 are using. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 661: Converting A Single Application To A Virtual Package

    Click Next. The Edit Windows Installer Package panel opens, where you are given the opportunity to use the InstallShield Editor Microsoft App-V Assistant, ThinApp Assistant, or Citrix Assistant to edit this Windows Installer package before creating the virtual package. With the Microsoft App-V Assistant you can: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 662 , which will be located in the same folder as the selected package. MSIConverterSettings.mst If you don’t want to open the selected package in InstallShield Editor, continue with the following step. To build the virtual package, click Convert. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 663: Converting A Suite Of Applications Into A Virtual Package

    Click Next to continue. The Select Conversion Target panel opens. Select Microsoft App-V Application, ThinApp Application and/or Citrix Profile and click Next. The Conversion Mode panel opens. Select Virtual Suite and click Next. The Select a Suite of Packages panel opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 664 Windows Installer package into an file that is compatible with .sft Microsoft App-V version 4.5. The installation shortcuts are converted into files, which provide access .osd to programs within the file. .sft ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 665: Converting A Directory Of Packages Into Individual Virtual Packages

    If you select the Evaluate package(s) for virtualization suitability option on the Conversion Mode panel, the package(s) is tested prior to conversion. After viewing the test results, you can choose the packages you want to convert. See Testing Windows Installer Packages for Virtualization Compatibility. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 666: Testing Windows Installer Packages For Virtualization Compatibility

    As you gain experience in virtualization conversion, you can build additional rules to address any issues that you have found, making the virtualization experience in the future even more streamlined for your organization. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 667: Using Windows Installer Converter To Test Packages For Virtualization Compatibility

    These conversion modes are explained in Types of Virtual Package Conversion. Note • If you select the Virtual Suite conversion mode, the testing option is not supported. Select the Evaluate package(s) for virtualization suitability option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 668 Converting a Suite of Applications into a Virtual Package, or Converting a Directory of Packages into Individual Virtual Packages. Click Test. The Test Package(s) panel opens and testing begins. When testing is complete, the results for each package are displayed: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 669 Select those packages that you want to convert and click Convert. Conversion begins. When package conversion is complete, a message appears in the Output window and Conversion completed the path to the generated virtual package(s) is provided. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 670: About Rules And Tests

    Warning Control Panel Applet / Warning is displayed when a Citrix application Citrix contains a control panel applet. 11004 Create Control Panel Creates a default shortcut for ThinApp Control Panel Applet Shortcut for Applets. ThinApp ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 671: Extensible Test Framework: Writing Your Own Rules For Virtualization Conversion

    You are documenting knowledge gained while packaging an application. • You gain the ability to share that knowledge with others. • When building a virtual package, you can automatically execute the rule’s fix to address the issue. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 672: Components Of A Rule

    Table 9-10 • Example of Fingerprint and Action in Sample Custom Rule Item Description Fingerprint The Fingerprint, which is named , searches the virtual Adobe Distiller AdobePDFSettings packages for a Registry key of in the Software\Adobe\Acrobat Distiller\AdobePDFSettings\* Registry hive. HKEY_CURRENT_USER ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 673: Creating Your First Custom Rule

    </Fingerprint> Add an element as a child element to the rule. An Action is what happens when the rule Fingerprint is Action satisfied. <Action description="My First Action"> <Message id="12000" text="I will automate my knowledge" severity="Warning"/> AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 674: Custom Rules Reference

    AdminStudioRules to define multiple rules, you would simply create multiple Rule elements. Here is an example of a Rule element: <Rule title="MyRuleTitle" description="MyRuleDescription" author="Author" provider="Any"> </Rule> The Rule Element has both attributes and child elements. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 675 A Fingerprint is the condition associated with the Rule. The following is a sample Fingerprint element: <Fingerprint name="Adobe Distiller AdobePDFSettings" description=""> <Registry hive="HKEY_CURRENT_USER" key="Software\Adobe\Acrobat Distiller\AdobePDFSettings\*"/> </Fingerprint> If the condition is satisfied, an Action will be taken. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 676 File child elements. For more information, see File Element. Registry The Registry element is used when searching for registry entries. A Fingerprint may have zero, one or many Registry child elements. For more information, see Registry Element. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 677 Fingerprint, this is the information that would be returned by , which RegQueryValueEx retrieves the type and data for the specified value name associated with an open registry key. field is a valid binding target. See Rule Data Binding. valueData AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 678 This field is a valid binding target. See Rule Data Binding. minVersion The minVersion attribute identifies the minimum file version. It is inclusive. • If the minVersion is 1.0, it will match files that have a minimum version of 1.0. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 679 An Action element with no child elements will do nothing. The following is a sample Action element: <Action description="Exclude AdobePDFSettings"> <Message id="11006" text="Excluding the registry key Software\Adobe\Acrobat Distiller\ AdobePDFSettings. Adobe Distiller will recreate these settings on first use." severity="Fix"/> <Exclude> <Registry hive="HKEY_CURRENT_USER" key="Software\Adobe\Acrobat Distiller\AdobePDFSettings\*"/> </Exclude> </Action> AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 680 <Message id="12001" text="Excluding TCPIP registry entries from the Citrix profile" severity="Fix"/> Using the Message element is the only way an Action can communicate with the user. All of the other Action child elements are completely silent. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 681 Full isolation means that the virtual application will not be able to see the specified resource if it exists on the target machine. The following is a sample FullyIsolate element: <FullyIsolate> <Registry hive="HKEY_LOCAL_MACHINE" key="System\CurrentControlSet\Services\Tcpip\*"/> </FullyIsolate> AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 682 The Create element creates the items defined by the child elements if they do not already exist. There is a minimum level of information required to create an item. The following is a sample Create element: <Create> <Shortcut name="{BIND:cplFile FileName}" target="%SystemFolder%\rundll32.exe" arguments="shell32.dll,Control_RunDLL &quot;{BIND:cplFile FullPath}&quot;" workingDir=""/> </Create> ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 683: Rule Data Binding

    {Bind:R1 hive} = HKEY_CURRENT_USER {Bind:R1 key} = Environment {Bind:R1 valueName} = TEMP {Bind:R1 valueType} = REG_SZ {Bind:R1 valueData} = %USERPROFILE%\LocalSettings\Temp For example, suppose you have the Registry attribute and it finds the following registry entry: AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 684: Testing App-V Applications Using The App-V Application Launcher

    App-V Application Launcher Utility Location When an App-V application is built, the App-V Application Launcher utility ( ) is placed in the AppVLauncher.exe same folder as the App-V application (the same directory that contains the files). .sft .osd ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 685 File streaming must be enabled—If you attempt to launch the App-V Application Launcher without having App-V file streaming enabled, an error message will open prompting you to enable the file streaming option. Click Yes to enable it. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 686: Running The Windows Installer Converter From The Command Line

    The command line parameters are described in the following table. Table 9-26 • Windows Installer Converter Command Line Options Parameter Description Use the parameter to indicate you want to perform this conversion silently, with no user interface and no user input required. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 687: Capturing Virtualization Context

    -v appv|thinapp|citrix -v appv|thinapp|citrix virtual package formats. Capturing Virtualization Context Sometimes it is necessary to repackage a Windows Installer package before you can successfully virtualize it (as described in Virtualization Conversion Error Messages). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 688: Windows Installer Converter Reference

    • Virtual Suite—Convert multiple Windows Installer packages, perhaps a group of applications that need to work together, into one virtual package. • Batch Convert—Convert a directory full of Windows Installer packages into individual virtual packages. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 689: Welcome Panel

    Users will be able to run the application in an isolation environment that does not conflict with their operating system or existing applications. • You can also use the Pre-Conversion Evaluation feature of Windows Installer Converter to test packages for virtualization readiness prior to conversion. On the Welcome panel, click Next to continue. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 690: Select Conversion Target Panel

    InstallShield Help Library for information. Select Conversion Target Panel On the Select Conversion Target panel, select the virtual application formats that you would like to build: Microsoft App-V Application, ThinApp Application, and/or Citrix Profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 691: Conversion Mode Panel

    ThinApp Application option will be disabled. For more information, see the VMware Web site. Conversion Mode Panel On the Conversion Mode panel, you identify the package input/output mode and whether you want to test those packages prior to conversion. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 692 This panel includes the following options: Table 9-27 • Windows Installer Converter / Conversion Mode Panel Option Description Single Application Select this option if you want to convert one Windows Installer package into a virtual package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 693: Select Windows Installer Package

    On the Select Windows Installer Package panel, which opens when you select Single Application on the Conversion Mode panel, click Browse and select the Windows Installer package that you want to convert .msi to a virtual application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 694: Select A Directory Panel

    Use the Delete button ( ) to delete a transform from the list. Select a Directory Panel Edition • The Batch Convert option of Windows Installer Converter is only available when purchased on the AdminStudio desktop licensing model. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 695: Select A Suite Of Packages Panel

    Files—Packages that are needed directly by the primary package and are used only by that package—such as driver files or client components. These packages are not part of the common desktop environment in the Enterprise. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 696 • Use the button ( ) to delete a package from the list. Delete Click Convert when ready to begin conversion. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 697: Test Package(S) Panel

    Windows Installer Converter discovered an issue and resolved it. Warning The virtual package will probably run, but may not. Error The virtual package probably won’t run, but under some circumstances it may. Fatal Error The virtual package will not run. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 698: Edit Windows Installer Package Panel

    If you are an advanced user who wants a higher degree of customization, you can use the InstallShield Editor Microsoft App-V Assistant, ThinApp Assistant, or Citrix Assistant to make customizations before building the virtual application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 699: Package Conversion Panel

    The Package Conversion panel displays status messages in the Output window during the conversion process, and notifies you when package conversion is complete. When you click Error List, the Error List tab opens and displays the error and warning messages that were generated. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 700 Virtualization Conversion Error Messages. When package conversion is complete, click Finish. Note • The Windows Installer Converter ignores services and user-defined custom actions. For more information, Application Features Requiring Pre- or Post-Conversion Actions. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 701: Virtualization Conversion Error Messages

    AdminStudio Technical Support. Error -9001: Unknown COM The following table documents this message: Table 9-31 • Error -9001: Unknown COM Category Description Type: Error Message: Internal error. Resolution: Contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 702: Error -9002: Error Opening Package

    Check to see if the user has proper access to the location the profile is being built to. If this does not solve the problem, perform these additional investigational steps and then contact AdminStudio Technical Support. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 703: Error -9004: Process Cancelled By User

    , and free some disk space on the drive, and then rebuild the C:\TMP profile. Error -9006: Error Decompressing Package The following table documents this message: Table 9-36 • Error -9006: Error Decompressing Package Category Description Type: Error Message: An error occurred while decompressing the package 'PackageName'. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 704: Error -9007: File With Extension Not Found

    Table 9-38 • Error -9008: Error Extracting Icon Category Description Type: Error Message: An error occurred while extracting the icon 'IconKeyName' Cause: This is an unexpected error that occurred when an icon listed in the Icon table was being extracted. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 705: Error -9009: Unknown Provider

    Invalid data may have been modified via the Direct Editor causing this error. Verify the Name field on the Citrix Assistant / ThinApp Assistant Profile Information page and make sure the name does not contain any invalid file name characters. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 706: Error -9011: Error Reading Msi Table

    Table 9-43 • Error -9013: Type Library Not Found Category Description Type: Error Message: Type library not found: 'TypeLibraryName' Cause: You encounter this error when a type library file was not found when trying to extract COM information. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 707: Error -9014: Shellexecute Failed

    Table 9-45 • Error -9015: Unable to Determine Full Path for Driver Category Description Type: Warning Message: Unable to determine the full path for driver 'DriverName' Cause: You encounter this error when a driver referenced in the ODBCDataSource table is not being installed by the package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 708: Warning -9016: Contents Of Table Ignored

    Contents of table 'TableName' will be ignored Cause: This error message identifies a known limitation of Citrix conversion. Resolution: If the contents of the table is deemed critical, repackage the application, and then rebuild the Citrix profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 709: Warning -9017: .Net 1.X Assembly Not Supported

    If a Type 51 custom action is encountered (which sets a property from a formatted text string), it is automatically resolved. If a Type 35 custom action is encountered, it is only resolved if it is referenced in the Directory table. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 710: Warning -9019: Conditionalized Components

    Then rebuild the Citrix profile. You can also evaluate the conditions on the listed components and remove the components you know are not needed for your target machines. Then rebuild the Citrix profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 711: Error -9020: Directory With Null Parent

    Registry and does not have to rely on COM extraction. Resolution: To resolve this issue, you need to repackage your Windows Installer package with COM table mapping turned off. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 712: Error -9022: Complus Table

    The FileSFPCatalog table associates specified files with the catalog files used by system file protection. If this file is necessary for the function of the application, you need to use Repackager to repackage the application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 713: Warning -9026: Launchcondition Table

    Citrix profile. Warning -9027: LockPermissions Table The following table documents this message: Table 9-55 • Warning -9027: LockPermissions Table Category Description Type Warning Message: The conversion process does not support data in the MSI table 'LockPermissions'. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 714: Error -9028: Movefile Table

    Repackager project to generate a revised Windows Installer package. • Option 3: Write a Pre-Launch Script—Write a pre-launch script that performs the file moving operations identified in the MoveFile table upon application launch. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 715: Error -9029: Msidriverpackages Table

    Ignoring the ODBCTranslator table should not prevent your application from functioning properly. However, if it does, you need to use Repackager to repackage the application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 716: Warning -9031: Removefile Table

    The RemoveIniFile table contains the information an application needs to delete from a .ini file. If the removal of this entry is necessary for the function of the application, you need to use Repackager to repackage the application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 717: Warning -9033: Removeregistry Table

    ISCEInstall table. During the conversion process, the ISCEInstall table is not read. Resolution: The ISCEInstall table is used to install Windows mobile applications. The conversion of mobile applications to Citrix profiles is not supported. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 718: Error -9037: Iscomplusapplication Table

    ISPalmApp table. During the conversion process, the ISPalmApp table is not read. Resolution: The ISPalmApp table is used to install Palm mobile applications. The conversion of mobile applications to Citrix profiles is not supported. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 719: Error -9039: Issqlscriptfile Table

    The ISVRoot table installs a Web site. An application running as a Citrix profile in an isolation environment cannot create a Web site. Therefore, creating Citrix profiles for applications that create Web sites during installation is not supported. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 720: Error -9041: Isxmlfile Table

    Error -9100: CreateInstance of Package Object Failed The following table documents this message: Table 9-69 • Error -9100: CreateInstance of Package Object Failed Category Description Type: Error Message: CreateInstance of the Citrix package object failed. Cause: Unexpected internal error. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 721: Error -9101: Create Operation Of Package Object Failed

    Description Type: Error Message: Failed to write package header information. Cause: Unexpected internal error. Resolution: First check to see if the product was installed properly. Then, perform preliminary investigational steps and contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 722: Error -9103: Citrix Finalization Failed

    Error -9105: Error Initializing Citrix Writer The following table documents this message: Table 9-74 • Error -9105: Error Initializing Citrix Writer Category Description Type: Error Message: Unexpected error initializing Citrix writer Cause: Unexpected internal error. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 723: Error -9106: Error Initializing Citrix Package

    Description Type: Error Message: Unexpected error writing Citrix file entries. Cause: Unexpected internal error. Resolution: First check to see if the product was installed properly. Then, perform preliminary investigational steps and contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 724: Error -9108: Error Determining Source File Path

    Error -9110: Error Writing Citrix Registry Entries The following table documents this message: Table 9-79 • Error -9110: Error Writing Citrix Registry Entries Category Description Type: Error Message: Unexpected error writing Citrix registry entries Cause: Unexpected internal error. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 725: Error -9113: Error Writing Citrix Ini File Entries

    A catastrophic error has occurred while writing shortcuts to the profile. Resolution: Verify that shortcuts point to a valid file. Try to narrow down issue by only keeping one shortcut and then try to rebuild. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 726: Error -9115: Error Saving Citrix Profile

    Error Message: Unexpected error creating intermediate folder Cause: AdminStudio is unable to create the intermediate folder used for the build. This error could occur if the user does not have permission to write to C:\TMP ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 727: Error -9118: Error Initializing Citrix Profile

    AdminStudio Technical Support. Error -9120: Error Deleting File From Profile The following table documents this message: Table 9-87 • Error -9120: Error Deleting File From Profile Category Description Type: Error AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 728: Error -9121: Failed To Copy File Into Citrix Profile

    Table 9-89 • Error -9122: Target Does Not Exist in Citrix Profile Category Description Type: Warning Message: The target for shortcut 'ShortcutName' does not exist in the Citrix profile. Excluding shortcut. Cause: Actual file that shortcut points to is not included in the package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 729: Error -9124: No Shortcuts Created For This Profile

    Table 9-91 • Error -9125: Error Writing Citrix File Type Associations Category Description Type: Error Message: Unexpected error writing Citrix file type associations Cause: Unable to write file type associations. Resolution: Perform preliminary investigational steps and then contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 730: Error -9126: Failed To Sign Profile Using Certificate

    AdminStudio Technical Support. Warning -9128: Duplicate Shortcut The following table documents this message: Table 9-94 • Warning -9128: Duplicate Shortcut Category Description Type: Warning Message: 'ShortcutName' shortcut already exists in the profile. Excluding duplicate shortcut. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 731: Warning -9129: Duplicate Shortcut Names

    There are two shortcuts defined in this profile that have the same name, even though they have different targets. Resolution: On the Citrix Assistant Profile Shortcuts page, rename one of these shortcuts and then rebuild the profile. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 732: Warning -9131: Unable To Resolve Installer Variable

    You can modify the shortcut to use a different icon or add a 16-color image to the one currently used. Warning -9133: Shortcut Icon Not Found The following table documents this message: Table 9-99 • Warning -9133: Shortcut Icon Not Found Category Description Type: Warning ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 733: Warning -9134: Failure To Extract Icon From Executable

    Citrix Isolation Environment. Cause: The file this shortcut points to is a 16-bit application. Resolution: Replace file with a newer 32-bit version. Can also test and see if the application works properly in the Citrix environment. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 734: Warning -9136: Some Files May Not Be Decompressed

    Warning Message: The destination directory for the 'FileName' file cannot be found. You should consider Repackaging this application before proceeding with the conversion process. Cause: This is an internal error. Resolution: Contact AdminStudio Technical Support. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 735: Warning -9138: Ignoring A Duplicatefile Table Entry

    Table 9-105 • Error -9200: ThinApp Must Be Installed Category Description Type: Error Message: A licensed or demo version of ThinApp must be installed on this machine in order to successfully build ThinApp applications. (www.vmware.com) Cause: ThinApp is not installed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 736: Error -9202: No Applications Were Created

    No applications were created. Cause: Either the Windows Installer package had no shortcuts or all shortcuts were excluded. Resolution: Make sure that the source Windows Installer package has at least one shortcut to an .msi file. .exe ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 737: Error -9203: Thinapp Tool Is Missing

    Table 9-110 • Error -9205: Identically-Named Shortcut Already Exists, But With Different Command Line Parameters Category Description Type: Warning Message: 'ShortcutName' shortcut already exists, but with different command line parameters. A new, unique shortcut will be created. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 738: Error -9206: Identically-Named Shortcut Already Exists, But With A Different Target

    Resolution: The cause of this error may be discernible by the progress messages that were displayed just before this error occurred. Also, make sure none of the files/folders in the build folder hierarchy are locked. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 739: Error -9208: Error Occurred During Build Process (Vftool.exe)

    Also, make sure none of the files/folders of the build folder hierarchy are locked. Error -9300: Unhandled Exception During AdviseFile Operation The following table documents this message: Table 9-115 • Error -9300: Unhandled Exception During AdviseFile Operation Category Description Type: Error AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 740: Error -9301: Unhandled Exception During Adviseregistry Operation

    The following table documents this message: Table 9-117 • Error -9302: Unhandled Exception During Command Action Category Description Type: Error Message: An unhandled exception occurred during the command action with the description 'CommandActionName' Resolution: Contact AdminStudio Technical Support. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 741: Error -9303: Unhandled Exception During Alter File Action

    The following table documents this message: Table 9-120 • Error -9305: Unhandled Exception During Create Action Category Description Type: Error Message: An unhandled exception occurred during the create action with the description 'CreateName' Resolution: Contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 742: Error -9306: Unhandled Exception During Execution Of Rules Engine

    Error -9402: Error Initializing App-V Package The following table documents this message: Table 9-123 • Error -9402: Error Initializing App-V Package Category Description Type: Error Message: Unexpected error initializing App-V package. Resolution: Contact AdminStudio Technical Support. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 743: Error -9403: Error Writing App-V File Entries

    Error -9405: Error Writing App-V Registry Entries The following table documents this message: Table 9-126 • Error -9405: Error Writing App-V Registry Entries Category Description Type: Error Message: Unexpected error writing App-V registry entries. Resolution: Contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 744: Error -9406: Error Writing App-V Ini File Entries

    Error -9408: Error Writing App-V File Type Data The following table documents this message: Table 9-129 • Error -9408: Error Writing App-V File Type Data Category Description Type: Error Message: Unexpected error writing App-V file type data. Resolution: Contact AdminStudio Technical Support. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 745: Error -9409: Error Saving App-V Data

    Table 9-132 • Error -9411: OSD File Template Could Not Be Extracted Category Description Type: Error Message: The Microsoft App-V OSD file template could not be extracted. The OSD file generation will not operate properly. Resolution: Contact AdminStudio Technical Support. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 746: Error -9412: Osd File Could Not Be Saved

    The user specified a dependent App-V application that is either on the local drive or on a mapped drive. This is determined by examining the HREF attribute of the CODEBASE tag in the dependency application’s OSD file. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 747: Error -9415: Dependency Application Was Not Found

    This may be caused if the directories specified in the Windows Installer package have changed after a valid Primary Application Directory was specified. Resolution: Specify a valid Primary Application Directory using the supplied browse folder in InstallShield. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 748: Error -9417: Dependency Application's Osd File Contains An Invalid Href Value

    App-V runtime can find them. This error occurs if there was an unexpected failure in that process. Resolution: Contact AdminStudio Technical Support. Error -9419: Error Inserting Watermark The following table documents this message: Table 9-140 • Error -9419: Error Inserting Watermark Category Description Type: Error ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 749: Warning -9500: Shortcut Missing

    Error -10000: Process Cancelled By User The following table documents this message: Table 9-142 • Error -10000: Process Cancelled By User Category Description Type: Error Message: Process cancelled by user. Cause: User clicked Cancel to cancel the profile conversion process. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 750: Warning -10001: Suite File Missing

    Specify unique Windows Installer files as part of the suite conversion process. Warning -10003: Application File Missing The following table documents this message: Table 9-145 • Warning -10003: Application File Missing Category Description Type: Error Message: Application file not found 'ApplicationName' ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 751: Warning -10004: Ini File Missing

    Table 9-147 • Fix 11000: Excluding TCPIP Registry Entries Category Description Type: Message: Excluding TCPIP registry entries from the Citrix profile. Action: Windows Installer Converter will exclude all TCPIP registry entries from the Citrix profile. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 752: Fatal Error 11001: Fail On Vmware

    Table 9-150 • Fix 11004: Control Panel Applet - ThinApp Category Description Type: Message: Generating shortcut for the Control Panel Applet located at 'DirectoryPath' Action: Windows Installer Converter will create a default shortcut for ThinApp Control Panel applets. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 753: Fatal Error 11005: Quicktime 7.4.1 Causes Fatal Error

    Table 9-153 • Fix 11007: Adobe Distiller Exclude AdobePDFSettings Category Description Type: Message: Excluding shortcut to .URL file. App-V does not launch these files properly. Action: Windows Installer Converter will exclude the shortcut to the .URL file. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 754: Steps To Take Before Calling Technical Support

    One action you could take to try to include ignored features in a Citrix profile is to first repackage the application using the Repackaging Wizard, and then convert the repackaged application to a Citrix profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 755 Install the service on each of the user desktop machines. The Citrix profile of this application should now be able to run in an isolation environment on machines that already have the service installed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 756 Windows Installer Feature Manual Conversion Steps 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 deployed on Citrix XenApp. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 757: Creating Customized Virtual Applications

    Creating Microsoft App-V Applications • Creating ThinApp Applications • Creating Citrix Profiles Note • You can also convert a Windows Installer package to a virtual application using Repackager. See Converting Windows Installer Packages to Virtual Applications. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 758: About Virtualization

    Because of these possible problems, extensive compatibility testing needs to be performed before an application can be distributed in the enterprise environment. The following diagram provides an example of two conflicting installed applications. Figure 10-1: Example of Conflicts Between Two Installed Applications ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 759 Critical application resources are managed locally by the isolation environment, thus minimizing resource dependencies between applications. Application virtualization greatly reduces the scope for conflicts between applications and, therefore, simplifies compatibility testing. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 760: About The Adminstudio Virtualization Interface

    You can work within these Assistants to create a project and configure its options and requirements. You can also use the Project Assistant or the Installation Designer to define the traditional Windows Installer version of your product installation. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 761: Using The More Options, Other Places, And Help Links Sections In A Virtualization Assistant

    Places—The view in the Installation Designer that corresponds to the current virtualization Assistant page. Clicking the link launches the full Installation Designer and activates that view. • Help Links—This list provides links to help topics pertinent to the current virtualization Assistant page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 762: Navigating In A Virtualization Assistant

    Windows Installer package. To open a view in the Installation Designer, click the Installation Designer tab. Note • The Installation Designer and the virtualization Assistants run simultaneously. Any changes that you make in one are reflected instantly in the other. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 763: Showing Or Hiding The Virtualization Assistants

    Using the Microsoft App-V Assistant to Create an App-V Application • Microsoft App-V Assistant Reference Note • You can also convert a Windows Installer package to a virtual application using Repackager. See Converting Windows Installer Packages to Virtual Applications. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 764: Overview Of Microsoft Application Virtualization And The Microsoft App-V Assistant

    For information on Microsoft Application Virtualization and the App-V Assistant, see the following topics: • About Microsoft Application Virtualization (App-V) and the App-V Assistant • Components of an App-V Application • About the Microsoft App-V Assistant ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 765: About Microsoft Application Virtualization (App-V) And The App-V Assistant

    • App-V Client—The App-V Client is the system component that enables the end user to interact with the App- V applications that are available on the App-V server. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 766 Instead of using the App-V Sequencer to create App-V applications, you can use the InstallShield Microsoft App-V Assistant, as shown in the following diagram: Figure 10-3: Using the App-V Assistant to Create an App-V Package ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 767 This information is often not readily available, and may require you to open the installation in an editing tool, such as InstallShield, in order to find it, or run the installation one time prior to sequencing. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 768: Components Of An App-V Application

    Components of an App-V Application When you use the Microsoft App-V Assistant to build an App-V virtual package, the resources you generate are called App-V applications. The components of an App-V application are shown in the following diagram: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 769 App-V application from the App-V Server and running the application in its own virtual environment. ICO File Shortcuts on the client’s desktop that point to an OSD file and launch App-V applications. Manifest File XML file that lists all of the OSD files in an App-V application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 770: About The Microsoft App-V Assistant

    Process for Authoring an App-V Application Using the Microsoft App-V Assistant • Supported InstallShield Project Types • How Transforms are Included in an App-V Application • How Windows Services Are Integrated into an App-V Application • Quick Start for Microsoft App-V Sequencer Users ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 771: Process For Authoring An App-V Application Using The Microsoft App-V Assistant

    The following diagram illustrates the App-V application creation process: Figure 10-5: Creating an App-V Application Note • You can also convert a Windows Installer package to a virtual application using Repackager. See Converting Windows Installer Packages to Virtual Applications. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 772 App-V application. Settings Setting App-V Registry Page Set isolation options for selected registry keys. Application Registry Isolation options specify how the virtual Isolation Options environment will provide access to registry keys requested by the App-V application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 773: Supported Installshield Project Types

    • 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 in InstallShield, you specify the root AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 774: How Windows Services Are Integrated Into An App-V Application

    App-V application. You will see the Windows service start up in the Task Manager as a separate process, but App-V will be running the service within the virtual environment. Upon shut down, App-V will first shut down the App-V application and then shut down the Windows service. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 775: Quick Start For Microsoft App-V Sequencer Users

    When viewing the files and folders of an App-V Sequencer project, they are displayed in relation to the Primary Application Directory. In the following graphic, the executable file is displayed in a subdirectory of myapp.exe , the Primary Application Directory: SoftcoMyApp.006 Figure 10-6: Microsoft App-V Sequencer Interface AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 776 For example, if is specified as the C:\Program Files installation directory, would be installed in the following location: myapp.exe C:\Program Files\Softco\My Application 6.0\MyApp\myapp.exe ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 777 To enable you to more clearly compare the Microsoft App-V Sequencer to the App-V Assistant, the following figure shows the location of selected folders and files in both interfaces. Figure 10-8: Comparison of Sequencer Interface to Microsoft App-V Assistant Interface AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 778: Using The Microsoft App-V Assistant To Create An App-V Application

    Package Information page. On this page, you can also specify any operating system requirements, identify the deployment server, and 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. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 779: Specifying Package Information

    [ProductName] [ProductVersion] entering a unique value in the Root Folder Name field. In the Comments field, enter a description of the purpose of this App-V application and any special information that you wish to document. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 780: Specifying Operating System Requirements

    If you want InstallShield to include the version number in the package name, select the Append version number to package name check box. • To avoid creating an upgrade package, clear the Enable Upgrade check box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 781: Specifying The Deployment Server

    Any Application Virtualization Desktop Client session that is running on this computer during your assignment of this variable must be closed and then opened so that the resumed session will be aware of its new application source. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 782: Including Diagnostic Tools With An App-V Application

    If you choose to include these diagnostic tools, the versions of that are part regedit.exe cmd.exe of the operating system on the build machine are added to the App-V application. However, these tools may not be compatible with other operating systems. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 783 The names of these shortcuts will reflect the application name, such as: [ProductName] Registry [ProductName] File System When the user launches one of these shortcuts, that diagnostic tool is launched inside the context of the application’s virtual environment. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 784: Managing Files In An App-V Application

    Adding an Existing Folder (and its Contents) to an App-V Application • Creating a New Folder • Moving Files and Folders • Deleting Files and Folders Adding Files to an App-V Application To add files to an App-V application, perform the following steps: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 785 Adding a File by Dragging and Dropping Files From Your System You can also add files or folders to your App-V application on the Files page by dragging them from a directory on your computer to the desired location in the tree. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 786 Browse through the folder tree to find the folder that you would like to add a folder into. Select the folder and click the Add Folders button. The Browse for Folder dialog box opens, listing all of the directories available to your computer. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 787 To create a new folder: Right-click on a folder in the Microsoft App-V application tree and select New Folder. A new folder is created as a subfolder of the selected folder: Enter a name for the new folder. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 788: Controlling The Display Of Predefined Folders

    These predefined folders are dynamic, meaning that they do not use hard-coded paths. The value for each destination folder is obtained from the operating system of the target machine. You can control which predefined folders are listed in this tree. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 789 Predefined Folders list. To remove a folder from the tree listing, select that folder name in this list (which is preceded by a check mark. Note • You cannot turn off the display of the [ProgramFilesFolder] AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 790: Specifying The Primary Application Directory

    . Typically, this would be: ProgramFilesFolder C:\Program Files You can specify the Primary Application Directory for an App-V application by clicking Primary Application Directory in the More Options list on the Files page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 791 (if one has already been specified). Click the browse ( ) button. The Browse for Directory dialog box opens, listing all of the currently available destination directories for this App-V application. Select one of the listed directories and click OK. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 792: Setting Isolation Options For Folders And Files

    • Application Data—Changes to the resource are saved for all users of this App-V application on this machine. • User Data—Changes to the resource are saved only for the logged-in user. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 793: Setting Isolation Options For Folders And Files

    Browse through the folder tree to find the file or folder that you would like to modify. Select the file or folder and click Isolation Options on the context menu. The Isolation Options dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 794: Inheritance Of Isolation Options From Folders To Files

    , then the isolation rule will be C:\Windows\System32\Notepad.exe C:\Windows\System32 applied because is a more specific reference to than C:\Windows\System32 C:\Windows\System32\Notepad.exe C:\Windows Figure 10-9: Example of Inheritance of Isolation Options from Folders to Files ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 795: Modifying Shortcuts To The App-V Application's Executable Files

    Excluding vs. Deleting App-V Application Shortcuts • Renaming an App-V Application Caution • If you delete a shortcut on the Applications page, the shortcut is also deleted from the InstallShield project, and, subsequently, from the Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 796: App-V Applications And The Virtual Environment

    Select the file that you want to create a shortcut to. Click Open. A new shortcut is listed, and it is named the same name as the selected file. To include this shortcut in the App-V application, make sure that its check box is selected. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 797: Including An Existing App-V Application

    App-V application and the InstallShield project. See Deleting an App-V Application. Caution • If you delete a shortcut on the Applications page, the shortcut is also deleted from the InstallShield project, and, subsequently, from the Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 798 Open the Applications page. All of the shortcuts that exist in the project are listed. Select the shortcut and click Delete. Caution • If you delete a shortcut on the Applications page, the shortcut is also deleted from the InstallShield project, and, subsequently, from the Windows Installer package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 799: Excluding Vs. Deleting App-V Application Shortcuts

    The Windows registry is a system-wide database that contains configuration information used by applications and the operating system. The registry stores all kinds of information, including the following: • Application information such as company name, product name, and version number • Path information that enables your application to run AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 800: Adding Or Deleting Registry Keys And Values

    Open the Registry page. Browse through the registry tree to find the key that you would like to modify. Select the key and click Isolation Options on the context menu. The Isolation Options dialog box opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 801: Inheritance Of Isolation Options In The Registry

    Microsoft Microsoft\Windows registry key. When the application requests , then the Microsoft\Windows\CurrentVersion Microsoft\Windows isolation rule will be applied because is a more specific reference to Microsoft\Windows than is Microsoft\Windows\CurrentVersion Microsoft AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 802: Performing Dynamic Suite Composition

    To add a dependency App-V application, click the New ( ) button. The Open dialog box opens. Open the directory where the dependency App-V application that you want to add is located. That application’s files are listed. .osd .sft ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 803: Modifying Build Options

    Windows Installer package. Important • You must create at least one Release (on the Releases view of the Installation Designer) before you will be able to select a Release on the Build Options page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 804: Selecting Releases To Build

    Therefore, InstallShield’s Build function is disabled. However, you do need to run the build process to build an App-V application for this Windows Installer package. To do this, perform the following steps: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 805: Specifying Whether To Compress The Data Files In An App-V Package

    The order of the packages can be changed by selecting a package in the list and clicking the Move Up ) and Move Down ( ) buttons. • Use the Delete button ( ) to delete a package from the list. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 806: Building A Windows Installer Package To Assist In The Distribution Of An App-V Application

    App-V application by enabling you to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Configuration Management. To build a Windows Installer package with your App-V application, select the Generate an installation package as part of the build output check box on the Advanced Settings dialog box.
  • Page 807 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 application use. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 808: Building An App-V Application

    Active release selected—A Windows Installer package and an App-V application would be built. • Active release not selected—Only a Windows Installer package would be built. To build more than one release at a time, perform a batch build. See Performing Batch Builds. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 809 The properties and directories are updated in the project. • The Releases view contains four or more releases that enable you to build different combinations of releases (for example, compressed or uncompressed, with or without an InstallShield prerequisite for the App-V client). AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 810: Testing An App-V Application Using The App-V Application Launcher

    File streaming must be enabled—If you attempt to launch the App-V Application Launcher without having App-V file streaming enabled, an error message will open prompting you to enable the file streaming option. Click Yes to enable it. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 811: Microsoft App-V Assistant Reference

    Reference information about the Microsoft App-V Assistant is organized into the following sections: • Pages • Dialog Boxes • Building App-V Applications Using the Command Line • App-V Application Conversion Error and Warning Messages • Application Features Requiring Pre- or Post-Conversion Actions AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 812: Pages

    Click the following icons in the navigation bar at the bottom of the page to navigate through the Microsoft App-V Assistant interface: Table 10-10 • Navigation Bar Icons Icon Destination Package Information Page Files Page Applications Page Registry Page Build Options Page Go to next page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 813: Package Information Page

    On the 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. Figure 10-15: App-V Assistant Package Information Page AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 814 Enter a short description of the purpose of this App-V application and any special information that you wish to document. Note • The description you enter in this text box will appear in the OSD file ABSTRACT element. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 815 App-V Diagnostic Tools Dialog Box. Upgrade Settings To specify upgrade information for your App-V package, click the Upgrade Settings link in the More Options area. For more information, see App-V Package Upgrade Settings Dialog Box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 816 Specify the port on which the virtual application server or the load balancer will listen for an Application Virtualization Desktop Client's request for the package. • This information is required to create a package, but you can change it. • The default port is 554. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 817 Note • This information is required to create a package if the .sft file will be stored in a subdirectory of CONTENT; otherwise, this information is not required. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 818: 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 • Set Isolation Options • Modifying the Display of Predefined Folders Figure 10-16: App-V Assistant Files Page ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 819 Delete from the context menu. For more information, see Deleting Files and Folders. Caution • If you choose to delete a folder, you are also deleting all of the files and subfolders that the folder contains. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 820 Options for Folders and Files. Modifying the Display of Predefined Folders You can specify which of the Windows Installer predefined folders are listed in the Microsoft App-V application tree. See Controlling the Display of Predefined Folders. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 821: Applications Page

    Assistant 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, users will not be able to launch the application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 822 On the Applications page, you can create, delete, include, exclude, or rename an App-V application. For step-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 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 823: Registry Page

    By default, all new registry keys are isolated. Tip • To import an existing registry ( ) file, click the Import a .reg file option on the More Options list to open .reg the Registry Import Wizard. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 824: Dynamic Suite Composition Page

    App-V applications that are dependent upon them. This reduces redundancy in the local App-V cache and simplifies the construction and testing of the primary App-V applications. You specify the App-V applications that you want to include in a dynamic suite on the Dynamic Suite Composition page of the App-V Assistant. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 825 App-V application. • If the dependency App-V application is not mandatory—If the primary App-V application will run even if it cannot locate this dependency App-V application, clear the Mandatory option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 826 .sft The selected reference App-V application is now listed in the Dependency Applications list and, by default, the Mandatory option is selected. Click to delete the selected App-V application from the list. Delete Button ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 827: Build Options Page

    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 standard build functionality is disabled. To build the App-V application, select the Build App-V application option and click the Build Virtual Package button. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 828 Windows Installer Files (.msi) list. • The order of the packages can be changed by selecting a package in the list and clicking the Move Up ( and Move Down ( ) buttons. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 829 Box. You can access this dialog box by clicking the Advanced Settings link in the More Options area on the Build Options page of the Microsoft App-V Assistant. By default, this check box is not selected. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 830 This simplifies the deployment of an App-V application by enabling you to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Configuration Management. To remove an installed App-V application, you need to use the Application Virtualization Client tool, which is available in the Administrative Tools of the Windows Control Panel.
  • Page 831: Advanced Settings Dialog Box

    Launch App-V Application Dialog Box • Package Optimizations Dialog Box • Primary Application Directory Dialog Box • Registry Isolation Options Dialog Box Advanced Settings Dialog Box Edition • The Microsoft App-V Assistant is included in the Virtualization Pack. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 832 Building an installation package enables you or your end users to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Configuration Management to distribute your App-V application. When you run this Windows Installer file, the minimally required App-V application files will be “installed”...
  • Page 833: App-V Diagnostic Tools Dialog Box

    App-V Package folder, which can be used to display the registry within the virtual environment. You can use to view the existing Virtual Registry.osd registry on the computer plus the registry for the virtual package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 834: App-V Package Upgrade Settings Dialog Box

    This check box is cleared by default. Always upgrade latest built If you selected the Enable Upgrade check box and you want InstallShield package to build an upgrade that updates the latest built App-V package, select this option. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 835: File Isolation Options Dialog Box

    If Override check box is not selected, then the App-V client determines whether to overwrite the file during an upgrade. In general, if the file is marked as Application Data, the file is overwritten during an upgrade; otherwise, it is not overwritten. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 836: Folder Isolation Options Dialog Box

    If Override check box is not selected, then the App-V client determines whether to overwrite the folder during an upgrade. In general, if the folder is marked as Application Data, the file is overwritten during an upgrade; otherwise, it is not overwritten. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 837: Launch App-V Application Dialog Box

    You indicate your package optimization preference on the Package Optimizations dialog box, which is opened by clicking the Package Optimizations link in the More Options menu of the Build Options page. Figure 10-24: Package Optimizations Dialog Box AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 838 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 application use. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 839: Primary Application Directory Dialog Box

    Description Explicitly set primary If a directory is specified on the InstallShield App-V Assistant’s Primary application directory Application Directory dialog box (as described in Explicitly Setting the Primary Application Directory), that directory will be used. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 840: Registry Isolation Options Dialog Box

    App-V application will see only the registry entries for the selected key that are part of that App-V application, or will see a merged view of the registry entries for the selected key from both the local registry and from the App-V application’s registry. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 841: Building App-V Applications Using The Command Line

    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 additional command line parameters. All of the App-V application settings are saved within the InstallShield project. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 842: App-V Application Conversion Error And Warning Messages

    • Microsoft App-V Assistant Reference • ThinApp Application Configuration File: package.ini Note • You can also convert a Windows Installer package to a virtual application using Repackager. See Converting Windows Installer Packages to Virtual Applications. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 843: Overview Of The Thinapp Assistant

    The virtual operating system technology enables entire applications to be packaged into a single file that can .exe be run without an installation process, and without modifying the resident operating system. A ThinApp application can be run from a network or offline on the local machine. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 844: About The Thinapp Assistant

    • Process for Authoring an App-V Application Using the Microsoft App-V Assistant • Components of an App-V Application • Supported InstallShield Project Types • How Transforms are Included in an App-V Application • About Sandboxes ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 845: Process For Authoring A Thinapp Application Using The Thinapp Assistant

    The following diagram illustrates the ThinApp application creation process: Figure 10-27: Creating a ThinApp Application Note • You can also convert a Windows Installer package to a virtual application using Repackager. See Converting Windows Installer Packages to Virtual Applications. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 846 Add, delete, or modify the registry settings in your Application Registry ThinApp application, and override the default Settings isolation options for selected registry keys. Isolation options specify how the virtual environment will provide access to registry keys requested by the ThinApp application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 847: Components Of A Thinapp Application

    ThinApp application. • Location of application data—This executable file contains all of the files, registry keys, DLLs, ThinApp components, and third party libraries that are required for the application to run. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 848 ThinAppPackage Windows Installer file, such as: C:\FolderContainingMSI\ThinAppPackage Caution • Modifying these files directly is not recommended. To make any modifications, use the InstallShield ThinApp Assistant. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 849: How Transforms Are Included In A Thinapp Application

    All of the transforms that you add to a ThinApp application must be located in the same folder as the Windows Installer .msi package so that they can be accessed when the ThinApp application is built. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 850: About Sandboxes

    Step 2 Managing Files in an App-V Application Step 3 Setting ThinApp Isolation Options Step 4 Modifying Shortcuts to the App-V Application’s Executable Files Step 5 Modifying App-V Application Registry Settings Step 6 Modifying Build Options ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 851: Specifying Thinapp General Settings

    The Sandbox Name you enter here is also recorded in the file. Package.ini If you want changes for Network mapped drives to be saved in the sandbox, then select the Mapped Network Drive Changes go to Sandbox option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 852: Specifying Control Access Via Active Directory

    ThinApp application. Caution • If you do not select the Control Access via Active Directory option, anyone who has access to a directory containing a ThinApp application will be able to run the application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 853: Prerequisites For Building A Thinapp Application

    For example, if you were running a ThinApp application and got an error message stating that the application cannot load a DLL, you could use these diagnostic tools to troubleshoot the problem. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 854 The names of these shortcuts will reflect the application name, such as: [ProductName] Registry [ProductName] File System When the user launches one of these shortcuts, that diagnostic tool is launched inside the context of the application’s virtual environment. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 855: Managing Files And Folders In A Thinapp Application

    ThinApp application. • Adding Files to an App-V Application • Adding an Existing Folder (and its Contents) to an App-V Application • Creating a New Folder • Moving Files and Folders • Deleting Files and Folders AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 856 Adding a File by Dragging and Dropping Files From Your System You can also add files or folders to your ThinApp application on the Files & Folders page by dragging them from a directory on your computer to the desired location in the tree. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 857 Browse through the folder tree to find the folder that you would like to add a folder into. Select the folder and click the Add Folders button.The Browse for Folder dialog box opens, listing all of the directories available to your computer. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 858 To create a new folder: Right-click on a folder in the VMware ThinApp Application tree and select New Folder. A new folder is created as a subfolder of the selected folder: Enter a name for the new folder. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 859: Controlling The Display Of Predefined Folders

    These predefined folders are dynamic, meaning that they do not use hard-coded paths. The value for each destination folder is obtained from the operating system of the target machine. You can control which predefined folders are listed in this tree. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 860 Predefined Folders list. To remove a folder from the tree listing, select that folder name in this list (which is preceded by a check mark. Note • You cannot turn off the display of the [ProgramFilesFolder] ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 861: Setting Thinapp Isolation Options

    Files & Folders page or a registry key selected on the Registry page. Information about isolation options is presented in the following sections: • Available ThinApp Isolation Options • ThinApp Isolation Option Use Scenarios • ThinApp Assistant Default Isolation Options AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 862 ThinApp applications believe that they have global write permissions, while they really only modify the sandbox directory. Merged You would use Merged isolation when the ThinApp application needs write access to user- specific storage areas, like the Desktop and My Documents. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 863: Setting Isolation Options For Folders

    Open the Files & Folders page. Browse through the folder tree to find the folder that you would like to modify. Select the folder and click Isolation Options on the context menu. The Isolation Options dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 864: Modifying Shortcuts To The Thinapp Application's Executable Files

    By default, the ThinApp Assistant 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. When you select each shortcut, details about it are displayed: ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 865 Excluding or Deleting an Existing App-V Application • Renaming an App-V Application Caution • If you delete a shortcut on the Applications page, the shortcut is also deleted from the InstallShield project, and, subsequently, from the Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 866: Thinapp Applications And The Virtual Environment

    Type Description None Do not perform any type of compression. Fast Perform quick compression resulting in a smaller application footprint. Small Perform the best compression resulting in the smallest application footprint, but increasing build time. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 867: Thinapp Shortcut Requirements

    Select the file that you want to create a shortcut to. Click Open. A new shortcut is listed, and it is named the same name as the selected file. To include this shortcut in the ThinApp application, make sure that its check box is selected. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 868: Including An Existing Thinapp Application

    ThinApp application and the InstallShield project. See Deleting an App-V Application. Caution • If you delete a shortcut on the Applications page, the shortcut is also deleted from the InstallShield project, and, subsequently, from the Windows Installer package. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 869 Open the Applications page. All of the shortcuts that exist in the project are listed. Select the shortcut and click Delete. Caution • If you delete a shortcut on the Applications page, the shortcut is also deleted from the InstallShield project, and, subsequently, from the Windows Installer package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 870: Excluding Vs. Deleting Thinapp Application Shortcuts

    The Windows registry is a system-wide database that contains configuration information used by applications and the operating system. The registry stores all kinds of information, including the following: • Application information such as company name, product name, and version number • Path information that enables your application to run ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 871: Setting Thinapp Isolation Options On Registry Keys

    Open the Registry page. Browse through the registry tree to find the key that you would like to modify. Select the folder or key and click Isolation Options on the context menu. The Isolation Options dialog box opens. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 872: Inheritance Of Thinapp Isolation Options In The Registry

    When the application requests , then the Microsoft\Windows\CurrentVersion Microsoft\Windows isolation rule will be applied because is a more specific reference to Microsoft\Windows than is Microsoft\Windows\CurrentVersion Microsoft Figure 10-33: Example of Inheritance of Isolation Options from Folders to Files ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 873: Modifying Build Options

    Build Options page is not displayed. Task: To select releases to build: Open the Build Options page. Select the releases in the Releases tree that you want to build a ThinApp application for. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 874: Enabling Thinapp Application Building When In Direct Edit Mode

    To include additional Windows Installer packages in a ThinApp application, set the Would you like to include additional MSI files in the virtual package? option on the Build Options page to Yes, and then select the packages that you want to add. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 875: Building A Windows Installer Package To Assist In The Distribution Of A Thinapp Application

    ThinApp application by enabling you to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Configuration Management. To build a Windows Installer file with your ThinApp application, select the Generate a Windows Installer (MSI) file as part of the build output option on the Build Options page of the ThinApp Assistant.
  • Page 876 The file listed in this field is generated when you click Generate text trace File report. This report should be viewed with a text editor that supports UNIX-style line breaks such as Wordpad or Word (not Notepad). ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 877: Setting Applink Options

    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 changing the service pack that you capture and link to its parent application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 878 In the ThinApp Reference box, enter the relative (runtime) path to the existing ThinApp application that you want to link to. • If you want to add multiple applications, repeat the procedure as necessary. • You can also use wild cards. See Security and Authorization ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 879 To continue even if load errors occur, make the package references optional instead. Click OK to return to the AppLink References dialog box. The item you selected is now listed in the AppLink References list. Click OK to return to the Build Options page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 880: Setting Appsync Options

    Task: To configure AppSync settings for your ThinApp application, On the Build Settings page, click the AppSync Settings option in the More Options menu. The General tab of the AppSync Settings dialog box opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 881 If the ThinApp application fails to successfully check for updates within that defined frequency, it will fail to run. To require that an application has to check for updates at a specified frequency, select the Use Application Expiration option AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 882 The default message is: This application has been unable to contact its update server for Expire_Period days, so it is unavailable for use. Check your network connection and try again. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 883: Building A Thinapp Application

    Open the Build Options page of the ThinApp Assistant. In the Releases tree, select the same release that is selected on the Releases view of the InstallShield Installation Designer. This is the release that you will build a ThinApp application for. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 884 Click the Build Virtual Package button to start building the ThinApp application. The output of the build will be a ThinApp application. For information on the files includes in a ThinApp application, see Components of an App-V Application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 885: Thinapp Assistant Reference

    Application Features Requiring Pre- or Post-Conversion Actions Pages The ThinApp Assistant is comprised of the following pages: • ThinApp Assistant Home Page • General Settings Page • Files & Folders Page • Applications Page • Registry Page • Build Options Page AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 886: Thinapp Assistant Home Page

    Click the following icons in the navigation bar at the bottom of the page to navigate through the ThinApp Assistant interface: Table 10-31 • Navigation Bar Icons Icon Destination General Settings Page Files & Folders Page ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 887 Chapter 10: Creating Customized Virtual Applications Creating ThinApp Applications Table 10-31 • Navigation Bar Icons Icon Destination Applications Page Registry Page Build Options Page Go to next page. Jump back to previous page. ThinApp Assistant Home Page AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 888: General Settings Page

    & Settings\USER_NAME\Application Data\ThinApp\SANDBOX_NAME By default, AdminStudio names the Sandbox by assigning it a unique GUID. However, if you want to override this default Sandbox name, you may (optionally) enter a new name in the Sandbox Name field. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 889 For testing purposes, you can also choose to include diagnostic tools in your ThinApp application by selecting the Diagnostic Tools link in the More Options list. For more information, see ThinApp Diagnostic Tools Dialog Box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 890 Modifying the Display of Predefined Folders View Files and Folders On the Files & Folders page, you can view all of the files and folders that are currently in your ThinApp application. Figure 10-37: ThinApp Assistant Files & Folders Page ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 891 Delete from the context menu. For more information, see Deleting Files and Folders. Caution • If you choose to delete a folder, you are also deleting all of the files and subfolders that the folder contains. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 892 Setting ThinApp Isolation Options. Modifying the Display of Predefined Folders You can specify which of the Windows Installer predefined folders are listed in the VMware ThinApp Application tree. See Controlling the Display of Predefined Folders. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 893: Applications Page

    Difference Between Deleting and Excluding a Shortcut To prevent a shortcut from being created in the ThinApp application, you can choose to either delete or exclude it, depending upon whether you want it to remain in the InstallShield project. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 894: Registry Page

    You set isolation options by selecting a registry key and then selecting Isolation Options from the context menu. For an overview of the available isolation options, and for instructions on how to set them, see Setting ThinApp Isolation Options. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 895 For information on how to override a registry key’s default isolation options, see Setting App-V Application Registry Isolation Options. Important • While you cannot explicitly set an isolation option on a registry value, registry values are subject to the isolation options of their keys. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 896: Build Options Page

    When you open an InstallShield project in InstallShield: • The Build Options page includes a releases tree, and you select the release that you want to build. • To build the ThinApp application, you click the Build button on the toolbar. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 897 Chapter 10: Creating Customized Virtual Applications Creating ThinApp Applications Figure 10-41: Build Settings Page, When in Basic MSI Project Mode AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 898 Because a Windows Installer package has already been built, InstallShield’s standard build functionality is disabled. To build the ThinApp application, select the Build ThinApp application option and click the Build Virtual Package button. Figure 10-42: Build Settings Page, When in Direct Edit Mode ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 899 Windows Installer This enables you to use enterprise distribution tools such as Microsoft System Center (MSI) file as part of Configuration Manager or Novell ZENworks Configuration Management to distribute the build output your ThinApp application. To build a Windows Installer file with your ThinApp application, select this option. By default, this option is not selected.
  • Page 900 ThinApp application by enabling you to use enterprise distribution tools such as Microsoft System Center Configuration Manager or Novell ZENworks Configuration Management. A ThinApp application installed using a Windows Installer package can be uninstalled using Add or Remove Programs in the Control Panel.
  • Page 901 To enable the Build button to build just the ThinApp application, select the Build ThinApp application option on the Build Options page. After you select this option, the Build ThinApp application selection on the Build menu becomes enabled, as does the Build toolbar button. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 902: Thinapp Diagnostic Tools Dialog Box

    On the Diagnostic Tools dialog box, which is opened by selecting Diagnostic Tools in the More Options list on the General Settings page, you can choose to include the Windows Command Prompt and Registry Editor diagnostic tools with your ThinApp application. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 903 The names of these shortcuts will reflect the application name, such as: [ProductName] Registry [ProductName] File System When the user launches one of these shortcuts, that diagnostic tool is launched inside the context of the application’s virtual environment. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 904: Folder Isolation Options Dialog Box

    Elements Virtual Elements Elements Elements Location Default As defined internally by the ThinApp Assistant Write Copy Visible Sandbox Sandbox Created in Sees Virtual Element Sandbox Merged Visible Sandbox System Created in Sees Virtual Element System ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 905: Registry Isolation Options Dialog Box

    Registry Isolation Options Dialog Box On the Registry Isolation Options dialog box, you can override the default isolation options for the selected registry key. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 906 Sandbox Sandbox Created in Sees Virtual Element Sandbox Merged Visible Sandbox System Created in Sees Virtual Element System Full Not Visible Sandbox Created in Sandbox (System elements (System elements cannot be cannot be read) modified) ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 907: Applink Settings Dialog Box

    You can set AppLink settings 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. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 908 Required—If Yes is listed in this column, the linked application must be available in order for the ThinApp application to run. If the linked application cannot be found, the ThinApp application will fail to run. See Required and Optional Linked Applications for more information. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 909 Collisions 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. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 910: Add Applink Reference Dialog Box

    On the Add AppLink Reference dialog box, which is opened by clicking the Browse button on the AppLink Settings dialog box, you specify the name and location of a ThinApp application and indicate whether that application is Required or Optional. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 911 Table 10-40 • File to Specify in an AppLink Reference Tool Used to Build ThinApp # of Application Shortcuts ThinApp Application File to Specify AdminStudio or ThinApp Only one Specify the executable file ( .EXE AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 912 Table 10-41 • AppLink References Examples Example Description Plugin.exe This will import a single package located in the same directory as the parent executable. plugins\Plugin.exe This will import a single package located in the plugins subdirectory of the parent executable. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 913: Appsync Settings Dialog Box

    If the ThinApp application fails to successfully check for updates within that defined frequency, it will fail to run. Note that the update does not expire, the ThinApp application expires, and cannot be used until it is updated. successfully. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 914 By default, a package will connect to the Web server once per day to see if an updated version is available. You can set the frequency by modifying this setting. For example, to set the Frequency to 2 days, enter . For 2 weeks, enter , etc. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 915 This default setting is 30 days but you can change that setting by modifying this setting. For example: • To set the period to 30 days, enter • If you do not want the package to expire, clear the Use Application Expiration check box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 916 AppSync then updates the application to a different version, the updates stored in the sandbox take precedence over the files contained in the version that AppSync created. The order of precedence for the update files are those in the sandbox, then the virtual operating system, and then the physical machine. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 917: Building Thinapp Applications Using The Command Line

    ThinApp application configuration options that you set in the ThinApp Assistant interface are recorded in the file that is generated when the ThinApp application is built. package.ini contains the following groups of options: package.ini • [BuildOptions] • [Compression] • [Isolation] • [MainApp.exe] • [Test.exe] AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 918: Buildoptions]

    General Information page. InventoryName Used by desktop management systems to identify packages for usage reporting purposes. If you do not use a desktop management system or license-controlled system, this value has no effect InventoryName=MainApp v1.0 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 919 The value for RemoveSandboxOnExit can be set to either 0 (off) or 1 (on). RemoveSandboxOnExit=0 Reset Sandbox on Exit Note • This option corresponds to the option General Settings on the page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 920 Using this option, you can specify the Active Directory groups which are allowed to use this ThinApp application. PermittedGroups=Group1;Group2;Group3 Allow application execution to Note • This option corresponds to the the following user groups General Settings option on the page. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 921 AutoShutdownServices Use this option to specify if virtualized services keep on running when the last non-service process exits. Permitted values are: • 0—Keep on running. • 1—Stop virtualized services (Default). AutoShutdownServices=1 AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 922 You can disable ThinApp default behavior by adding the option to disable full file scans. NetRelaunch=1 NetRelaunch=1 ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 923: Compression]

    AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 924: Mainapp.exe]

    This option specifies the name of the file that contains read-only registry data to be bound. If the read-only registry also has an associated file-data, the file-data file should be in the same directory with the appended extension TestMain.exe.ro.thfd ReadOnlyData=bin\MainApp.exe.ro.tvr ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 925 This option corresponds to the option on the Build Options page. Icon By default the icon is used from the executable identified in the Source option. You can change this to specify one of the following: Icon=SomeOtherEXE.exe Icon=NULL Icon=SomeOtherIco.ico AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 926 The path to an .ico icon file. In this case, Tlink will load the icons from the specified .ico file. If a full path is not specified, the path is relative to the project directory. [myapp.exe] Source=%ProgramFilesDir%\myapp\app.exe Icon=%ProgramFilesDir%\myapp\myicon.ico ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 927: Test.exe]

    Using the Citrix Assistant, you can configure an application’s operating system and language requirements, files, folders, shortcuts, registry settings, script execution, isolation options, and build options. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 928 Add, delete, or modify the registry settings in your Citrix Application profile, and override the Citrix default isolation options Registry Settings for selected registry keys. Isolation options specify how the virtual environment will provide access to registry keys requested by the Citrix profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 929: About Citrix Xenapp

    Applications are centralized on the Citrix XenApp, 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 running on the same machine. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 930: About The Citrix Assistant

    Settings—Specify files, folders, shortcuts, and registry settings included in application. • Isolation Options—Define a set of options for running the application in isolation on the user desktop. • Build—Specify build settings and build a Citrix profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 931: About Citrix Profiles

    An XML file that defines the profile. myapp.profile Manifest File CAB File Compressed cabinet file that provides the isolation [alphanumeric_string].cab environment contents for the application. Hashes File Hash key file for digital signatures and signing profiles. Hashes.txt AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 932: Benefits Of Deploying Citrix Profiles

    (operating system with existing applications). After resolving conflicts that were found during testing, each application then had to be installed on each desktop. This process was very time consuming not only during initial installation, but also when applying patches or upgrading. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 933 Citrix XenApp helps you prevent data from leaving the data center without your explicit permission, 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 security of the environment. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 934: How Transforms Are Included In A Citrix Profile

    InstallShield (rather than the file). The Open .msi Transform wizard will open, and you will be prompted to specify the root file and which of the existing .msi ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 935: Using The Citrix Assistant To Create A Citrix Profile

    Citrix profile. The following tasks are performed on the Profile Information page of the Citrix Assistant: • Specifying the Profile Name, Description, and Version • Enabling a Citrix Profile to Run Non-Included Executables • Including Diagnostic Tools With an App-V Application AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 936: Specifying The Profile Name, Description, And Version

    In the Description field, enter a brief explanation of the purpose of this package. This information is stored as package metadata. In the Version field, enter the version number of this Citrix profile. This information is stored as package metadata. On the File menu, click Save to save your changes. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 937: Enabling A Citrix Profile To Run Non-Included Executables

    For example, if you were running a Citrix profile and got an error message stating that the application cannot load a DLL, you could use these diagnostic tools to troubleshoot the problem. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 938 The names of these shortcuts will reflect the application name, such as: [ProductName] Registry [ProductName] File System When the user launches one of these shortcuts, that diagnostic tool is launched inside the context of the application’s Citrix isolation environment. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 939: Specifying Operating System And Language Requirements

    Service Packs Requirements dialog box, and choose one of the following options: • No Service Pack Requirement—This application supports all versions of this operating system, regardless of the number of Service Packs installed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 940: Setting Language Requirements

    Yes—Select this option if the application does not support one of the listed languages. When you select this option, the check boxes are unlocked and only English is selected by default. If you selected Yes in the previous step, select only those languages that this application supports. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 941: How Requirements Are Applied At Runtime

    If an application has specific operating system or language requirements and you fail to specify them correctly when creating the profile, users who do not meet those requirements will be given access to run applications locally and they will probably encounter application errors. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 942: Adding Pre-Launch And Post-Exit Scripts

    In the More Options list, click Script Execution. The Script Execution dialog box opens. Select the Before Profile Launch or After Profile Exit node in the tree. Click Add... The Select Files to Add dialog box opens. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 943 Tip • Use the Shift key to select multiple contiguous files, and use the Ctrl key to select multiple non- contiguous files. Select a script in the tree. Several new fields and options are enabled. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 944: Managing Files And Folders In A Citrix Profile

    Citrix profile, and delete files and folders from the Citrix profile. • Adding Files to an App-V Application • Adding an Existing Folder (and its Contents) to an App-V Application • Creating a New Folder • Moving Files and Folders • Deleting Files and Folders ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 945 Adding a File by Dragging and Dropping Files From Your System You can also add files or folders to your Citrix profile on the Profile Files page by dragging them from a directory on your computer to the desired location in the tree. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 946 Browse through the folder tree to find the folder that you would like to add a folder into. Select the folder and click the Add Folders button.The Browse for Folder dialog box opens, listing all of the directories available to your computer. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 947 To create a new folder: Right-click on a folder in the Citrix Profile tree and select New Folder. A new folder is created as a subfolder of the selected folder: Enter a name for the new folder. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 948: Controlling The Display Of Predefined Folders

    These predefined folders are dynamic, meaning that they do not use hard-coded paths. The value for each destination folder is obtained from the operating system of the target machine. You can control which predefined folders are listed in this tree. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 949: Setting Isolation Options

    The default settings for isolation options are set on the Citrix XenApp, and those defaults are adequate for most environments. However, you can override the default settings for selected files, folders, or registry keys to exert control over application interactions with client operating system resources. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 950: Overview Of Citrix Isolation Options

    Citrix XenApp to be applied to this selection. This is the default selection for all files, folders, and registry keys. Caution • You should select this option unless you require specific custom handling. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 951 Root—[Registry keys only] Select the registry root of the registry key on the system that you want to redirect to. • Destination Key—[Registry keys only] Select the registry key on the system that you want to redirect to. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 952: Setting Isolation Options For Folders And Files

    , then the isolation rule will be C:\Windows\System32\Notepad.exe C:\Windows\System32 applied because is a more specific reference to than C:\Windows\System32 C:\Windows\System32\Notepad.exe C:\Windows Figure 10-52: Example of Inheritance of Isolation Options from Folders to Files ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 953: Modifying Profile Shortcut Settings

    App-V Applications and the Virtual Environment • App-V Shortcut Requirements • 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 AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 954: Shortcuts And The Isolation Environment

    Programs folder, with each folder name separated with a backslash. For example, if you entered the following in the Start menu folder field: MyApplicationFolder/ApplicationTools Then, the shortcut would be created in the following folder structure: Start Programs MyApplicationFolder ApplicationTools ApplicationName ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 955: Shortcut Requirements

    For each Citrix 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 contain any shortcuts, users will not be able to launch the application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 956: Creating A New Profile Shortcut

    .exe page are listed. • Those that are currently included are selected. • Those that are currently excluded are not selected. To include a previously excluded shortcut, select the shortcut and select the check box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 957: Excluding Vs. Deleting A Profile Shortcut

    ) files that were added on the Profile Files .exe page are listed. • Those that are currently included are selected. • Those that are currently excluded are not selected. To exclude a shortcut, select the shortcut and clear the check box. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 958: Conditions When A Shortcut Should Be Excluded Or Deleted

    Select the shortcut that you want to rename and click Rename. A box appears around the shortcut name, and the shortcut name becomes an editable field. Enter a new name for the shortcut. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 959: Modifying Profile Registry Settings

    Note that the terms key and subkey are relative. In the registry, a key that is below another key can be referred to as a subkey or as a key, depending on how you want to refer to it relative to another key in the registry hierarchy. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 960: Setting Registry Isolation Options

    Click OK. Registry keys that have an isolation setting other than default are marked with a special icon: Tip • To import an existing registry ( ) file, click the Import a .reg file option on the More Options list to .reg open the Registry Import Wizard. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 961: Modifying Build Settings

    Enabling App-V Application Building When in Direct Edit Mode Important • You must create at least one Release (on the Releases view of the Installation Designer) before you will be able to select a Release on the Build Settings page. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 962: Selecting Releases To Build

    Active release selected—A Windows Installer package and a Citrix profile would be built. • Active release 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. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 963: Digitally Signing A Citrix Profile

    ) to delete a package from the list. Note • You can also convert a suite of applications into one virtual package using Windows Installer Converter. See Converting a Suite of Applications into a Virtual Package. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 964: Enabling Citrix Profile Building When In Direct Edit Mode

    Releases view of the InstallShield Installation Designer. You must create at least one release before you will be able to build a Citrix profile. For more information, see Creating and Building Releases. Open the Build Settings page of the Citrix Assistant. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 965 Click the Build toolbar button (or select Build Citrix Profile on the Build menu) to start building the Citrix profile. The output of the build will be a Windows Installer package and a Citrix profile. For a description of the files that comprise a Citrix profile, see Components of an App-V Application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 966: Citrix Assistant Reference

    The Citrix Assistant is comprised of the following pages: • ThinApp Assistant Home Page • General Settings Page • Profile Requirements Page • Files & Folders Page • Applications Page • Registry Page • Build Options Page ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 967: Home Page

    Click the following icons in the navigation bar at the bottom of the page to navigate through the Citrix Assistant interface: Table 10-55 • Navigation Bar Icons Icon Destination General Settings Page Profile Requirements Page AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 968: Profile Information Page

    On the Profile Information page in the Citrix Assistant, you specify 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 with the Citrix profile. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 969 Do not include the version number in the package name. Description Briefly describe this package. This information is stored with the package as metadata. Version Enter the version number of this Citrix profile. This information is stored as package metadata. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 970: Profile Requirements Page

    On the Profile Requirements page of the Citrix Assistant, you can select the operating systems that client workstations must be running in order for your application to operate properly. By default, all operating systems that are supported by the Citrix client are selected. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 971 No—Select this option if this application will run on all of the listed operating systems (which are the operating systems that the Citrix client supports). When this option is selected, the operating system check boxes are locked and cannot be changed. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 972 • Yes—Select this option if the application does not support one of the listed languages. When you select this option, the check boxes are unlocked and only English is selected by default. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 973: Profile Files Page

    On the Profile Files page of the Citrix 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 AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 974 If you are editing an InstallShield project (not a Windows Installer package), and you are adding a folder to this profile, you are prompted to choose whether you want to create a dynamic file link to the source folder. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 975 The default settings for isolation environments are set on the Citrix XenApp, and those defaults are adequate for most environments. However, in the Citrix Assistant, you can override the default settings for selected files, folders, or registry keys to exert control over application interactions with client operating system resources. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 976: Profile Shortcuts Page

    Citrix currently only supports 16 color icons 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. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 977 Shortcut—When you delete a shortcut, it is removed from both the Citrix profile and the InstallShield project. This means that the shortcut would also be deleted from the Windows Installer package that is built from this InstallShield project. See Deleting an App-V Application. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 978: Profile Registry Page

    Figure 10-63: Citrix Assistant Profile Registry Page Registry items that are listed on this page will be included in the Citrix profile, and those that you delete will not. By default, all new registry keys are isolated. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 979: Build Settings Page

    Selecting Releases to Build • Digitally Signing a Citrix Profile • Including Additional Windows Installer Packages in a Citrix Profile • Enabling App-V Application Building When in Direct Edit Mode • Building an App-V Application AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 980 By selecting a release, you are specifying that whenever that particular release is built, a Citrix profile will also be built. Note • If you are editing a Windows Installer package (Direct Edit Mode) or transform file (Direct MST Mode), the Releases tree on the Build Settings page is not displayed. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 981 MSI files in the virtual package? option to Yes, and then select the packages that you want to add. • Click the New button ( ) and select the Windows Installer packages that you want to add. After each file is selected, it will be listed in the Windows Installer Files (.msi) list. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 982: Dialog Boxes

    • Script Execution Dialog Box • ThinApp Diagnostic Tools Dialog Box • File Isolation Options Dialog Box • Folder Isolation Options Dialog Box • Registry Isolation Options Dialog Box • Service Packs Requirement Dialog Box ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 983: Script Execution Dialog Box

    For example, if you were running a Citrix profile and got an error message stating that the application cannot load a DLL, you could use these diagnostic tools to troubleshoot the problem. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 984 The names of these shortcuts will reflect the application name, such as: [ProductName] Registry [ProductName] File System When the user launches one of these shortcuts, that diagnostic tool is launched inside the context of the application’s Citrix isolation environment. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 985: File Isolation Options Dialog Box

    Always look for this file on the system, not in the isolation environment. Isolate First look for this file in the isolation environment. If the file is not found there, look for this file on the system. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 986: Folder Isolation Options Dialog Box

    Folder Isolation Options Dialog Box On the Folder Isolation Options dialog box, you can override the default Citrix isolation option for the selected folder. Figure 10-68: Folder Isolation Options Dialog Box ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 987 If you select this option, also specify the following: • Source—Name of the selected folder. • Destination—The directory on the system where you want the application to look instead of looking in the selected folder in the isolation environment. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 988: Registry Isolation Options Dialog Box

    Table 10-61 • Registry Isolation Options Option Description Default Use the default isolation option for this registry key as defined on the Citrix XenApp. Note • Select this option unless you require specific custom handling. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 989 Source—Lists the name of the selected registry key. • Destination Root—Select the registry root of the registry key on the system that you want to redirect to. • Destination Key—Select the registry key on the system that you want to redirect to. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 990: Service Packs Requirement Dialog Box

    At Least Service Pack Level Select this option if, to run properly, this application requires that this operating system have at least the specified Service Pack (or higher) installed. Enter the minimum required Service Pack Level in the box. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 991: Building Citrix Profiles Using The Command Line

    Repackaging Wizard, and then convert the repackaged application to a Citrix profile. For a list of ignored features, see Application Features Requiring Pre- or Post-Conversion Actions. For a list of ignored features, see Application Features Requiring Pre- or Post-Conversion Actions. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 992 Chapter 10: Creating Customized Virtual Applications Creating Citrix Profiles ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 993: Customizing And Authoring Installations Using Installshield

    ConflictSolver: the ConflictSolver tab. Microsoft App-V, VMware ThinApp, Provides an overview of how Repackager and InstallShield Editor and Citrix XenApp Virtualization provide support for the conversion of Windows Installer packages Support to virtual applications. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 994: Adminstudio-Specific Functionality In Installshield Editor

    Application Manager options in The InstallShield Editor Options dialog box has an additional tab for the Options dialog box Application Manager and ConflictSolver configuration. AdminStudio Professional and Application Manager Tab on InstallShield Editor Options Dialog Box Enterprise Editions ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 995 AdminStudio Role permissions apply to Application Manager and ConflictSolver functionality in InstallShield Editor. If you are not assigned to a Role with sufficient permissions, you may not be able to access some of these features. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 996: Installshield Editor Integration With Application Manager And The Software Repository

    Opening and Editing a Software Repository Package • Adding a Package to the Software Repository via the InstallShield Editor Build Process • Using the Application Manager Context Menu Note • For additional information, see Using the Software Repository. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 997: Getting A Copy Of A Software Repository Package

    Package is not managed within the Software Repository. Package is managed within the Software Repository. Package is managed within the Software Repository and is checked out. Merge Module is managed within the Software Repository. Clear the Check Out option. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 998: Opening And Editing A Software Repository Package

    Catalog dialog box opens, listing the package tree in the AdminStudio Application Catalog: In Application Manager, packages that are managed within the Software Repository have a different icon than those that are not: Icon Description Package is not managed within the Software Repository. ADS-0950-UG00 AdminStudio 9.5 User Guide...
  • Page 999 When you have finished editing this package, on the File menu, point to Application Manager and click Check in As. You are now given two options: New Package Version or Overwrite Existing Version. Select one of those options to save the edited package in the Application Catalog. AdminStudio 9.5 User Guide ADS-0950-UG00...
  • Page 1000: Adding A Package To The Software Repository Via The Installshield Editor Build Process

    Software Repository package in the Application Manager tree and select Edit with InstallShield Editor from the context menu. The package is checked out to you and opened in the Direct MST Mode of InstallShield Editor. 1000 ADS-0950-UG00 AdminStudio 9.5 User Guide...

Table of Contents