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...
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.
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...
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...
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: •...
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.
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.
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.
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...
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...
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...
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...
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...
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...
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...
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...
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...
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 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...
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...
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...
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...
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...
(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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
<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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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 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...
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.
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...
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...
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...
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...
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...
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...
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...
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...
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...
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. •...
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...
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...
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...
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...
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...
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...
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...
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.
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...
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...
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...
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...
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...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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 •...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
, 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
(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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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.
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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.
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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 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...
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...
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...
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.
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)
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...
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...
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...
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...
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...
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...
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...
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...
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...
• 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...
) 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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.
.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...
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...
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...
(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...
) 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
, 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...
. 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...
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...
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...
.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...
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...
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...
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...
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...
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...
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...
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.
• 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...
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...
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...
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...
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...
(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...
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...
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.
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...
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...
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...
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...
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...
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...
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...
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...
) 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
</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...
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 "{BIND:cplFile FullPath}"" workingDir=""/> </Create> ADS-0950-UG00 AdminStudio 9.5 User Guide...
{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...
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...
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...
-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...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
, 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
• 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...
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...
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...
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...
• 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...
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...
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...
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...
[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...
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...
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...
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...
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...
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...
. 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...
• 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...
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...
, 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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.
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”...
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...
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...
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...
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...
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...
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...
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...
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...
• 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...
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...
• 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
& 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
(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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
, 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...
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...
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...
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...
.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...
) 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...
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...
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...
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...
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...
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...
) 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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
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...
Need help?
Do you have a question about the ADMINSTUDIO 9.5 and is the answer not in the manual?
Questions and answers