VMware THINAPP 4.6 - MIGRATING APPLICATIONS TECHNICAL... User manual

ThinApp User’s Guide

ThinApp 4.6

This document supports the version of each product listed and

supports all subsequent versions until the document is replaced

by a new edition. To check for more recent editions of this

document, see http://www.vmware.com/support/pubs.

EN-000400-00

VMware, Inc.

3401 Hillview Ave.

Palo Alto, CA 94304

www.vmware.com

2VMware, Inc.

ThinApp User’s Guide

You can find the most up-to-date technical documentation on the VMware Web site at:

http://www.vmware.com/support/

The VMware Web site also provides the latest product updates.

If you have comments about this documentation, submit your feedback to:

docfeedback@vmware.com

intellectual property laws. VMware products are covered by one or more patents listed at

http://www.vmware.com/go/patents.

VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks

and names mentioned herein may be trademarks of their respective companies.

VMware, Inc. 3

Contents

AboutThisBook 9

1InstallingThinApp 11

ThinAppRequirements 11

OperatingSystems,Applications,andSystemsThatThinAppSupports 11

ApplicationsThatThinAppCannotVirtualize 12

RecommendationsforInstallingThinApp 12

UsingaCleanComputer 12

UsingtheEarliestOperatingSystemRequiredforUsers 13

InstallThinAppSoftware 13

CheckingThinAppInstallationFiles 13

2CapturingApplications 15

PhasesoftheCaptureProcess 15

PreparingtoCaptureApplications 15

CapturingApplicationswiththeSetupCaptureWizard 16

CreateaSystemImageBeforetheApplicationInstallation 16

RescantheSystemwiththeInstalledApplication 16

DefiningEntryPointsasShortcutsintotheVirtualEnvironment 17

SetEntryPoints 17

SetUserGroups 18

DefiningIsolationModesforthePhysicalFileSystem 18

SetFileSystemIsolationModes 20

StoringApplicationChangesintheSandbox 20

CustomizetheSandboxLocation 20

SendAnonymousStatisticstoVMware 20

CustomizeThinAppProjectSettings 21

DefiningPackageSettings 21

CustomizePackageSettings 22

OpeningProjectandParameterFiles 22

BuildVirtualApplications 23

AdvancedPackageConfiguration 23

ModifyingSettingsinthePackage.iniFile 23

ModifyingSettingsinthe##Attributes.iniFile 24

GuidelinesforPackagingMicrosoftOffice2007 24

RequirementsforPackagingMicrosoftOffice2007 25

CapturingMicrosoftOffice2007 25

ConfigureMicrosoftOffice2007 27

CapturingInternetExplorer6onWindowsXP 28

RequirementsforCapturingInternetExplorer6onWindowsXP 28

CaptureInternetExplorer6onWindowsXPbyUsingtheSetupCaptureWizard 28

ExtractingandRegisteringThinDirect 29

CapturingMultipleApplicationInstallerswithThinAppConverter 29

ThinAppConverterProcess 29

SystemRequirementsforRunningThinAppConverter 30

PreparingtheConfigurationFileforThinAppConverter 30

PredefinedEnvironmentVariables 37

ThinApp User’s Guide

4VMware, Inc.

3DeployingApplications 39

ThinAppDeploymentOptions 39

DeployingThinAppwithDeploymentTools 39

DeployingThinAppintheVMwareViewEnvironment 39

DeployingThinApponNetworkShares 40

DeployingThinAppUsingExecutableFiles 40

EstablishingFileTypeAssociationswiththethinreg.exeUtility 40

ApplicationSyncEffectonthethinreg.exeUtility 40

Runthethinreg.exeUtility 41

Optionalthinreg.exeParameters 41

BuildinganMSIDatabase 43

CustomizingMSIFileswithPackage.iniParameters 43

ModifythePackage.iniFiletoCreateMSIFiles 43

ControllingApplicationAccesswithActiveDirectory 45

Package.iniEntriesforActiveDirectoryAccessControl 45

StartingandStoppingVirtualServices 46

AutomaticStartupforVirtualServices 46

UsingThinAppPackagesStreamedfromtheNetwork 47

HowThinAppApplicationStreamingWorks 47

RequirementsandRecommendationsforStreamingPackages 48

StreamThinAppPackagesfromtheNetwork 49

UsingCapturedApplicationswithOtherSystemComponents 49

PerformingPasteOperations 49

AccessingPrinters 49

AccessingDrivers 49

AccessingtheLocalDisk,theRemovableDisk,andNetworkShares 49

AccessingtheSystemRegistry 50

AccessingNetworkingandSockets 50

UsingSharedMemoryandNamedPipes 50

UsingCOM,DCOM,andOut‐of‐ProcessCOMComponents 50

StartingServices 50

UsingFileTypeAssociations 50

SampleIsolationModeConfigurationDependingonDeploymentContext 51

ViewofIsolationModeEffectontheWindowsRegistry 51

4UpdatingandLinkingApplications 53

ApplicationUpdatesThattheEndUserTriggers 53

ApplicationSyncUpdates 53

ApplicationLinkUpdates 56

ApplicationUpdatesThattheAdministratorTriggers 60

ForcinganApplicationSyncUpdateonClientMachines 61

UpdatingApplicationswithRuntimeChanges 61

AutomaticApplicationUpdates 62

DynamicUpdatesWithoutAdministratorRights 63

UpgradingRunningApplicationsonaNetworkShare 63

FileLocks 63

UpgradeaRunningApplication 63

SandboxConsiderationsforUpgradedApplications 64

UpdatingtheThinAppVersionofPackages 64

relinkExamples 64

VMware, Inc. 5

Contents

5ConfiguringPackageParameters 65

Package.iniFileStructure 66

ParametersThatApplytoPackage.inior##Attributes.iniFiles 66

ConfiguringtheThinAppRuntime 66

NetRelaunch 66

RuntimeEULA 67

VirtualComputerName 67

Wow64 68

QualityReportingEnabled 68

ConfiguringIsolation 68

DirectoryIsolationMode 68

RegistryIsolationMode 69

ConfiguringFileandProtocolAssociations 70

FileTypes 70

Protocols 70

ConfiguringBuildOutput 70

ExcludePattern 70

Icon 71

OutDir 71

RetainAllIcons 72

ConfiguringPermissions 72

AccessDeniedMsg 72

AddPageExecutePermission 72

PermittedGroups 73

UACRequestedPrivilegesLevel 73

UACRequestedPrivilegesUIAccess 74

ConfiguringObjectsandDLLFiles 74

ExternalCOMObjects 74

ExternalDLLs 75

ForcedVirtualLoadPaths 75

IsolatedMemoryObjects 75

IsolatedSynchronizationObjects 76

NotificationDLLs 77

NotificationDLLSignature 77

ObjectTypes 77

SandboxCOMObjects 77

VirtualizeExternalOutOfProcessCOM 78

ConfiguringFileStorage 78

CachePath 78

UpgradePath 79

VirtualDrives 79

ConfiguringProcessesandServices 81

AllowExternalKernelModeServices 81

AllowExternalProcessModifications 81

AllowUnsupportedExternalChildProcesses 82

AutoShutdownServices 82

AutoStartServices 82

ChildProcessEnvironmentDefault 82

ChildProcessEnvironmentExceptions 83

ConfiguringSizes 83

BlockSize 83

CompressionType 83

MSICompressionType 84

OptimizeFor 85

ThinApp User’s Guide

6VMware, Inc.

ConfiguringLogging 85

DisableTracing 85

LogPath 86

ConfiguringVersions 86

CapturedUsingVersion 86

StripVersionInfo 86

Version.XXXX 87

ConfiguringLocales 87

AnsiCodePage 87

LocaleIdentifier 87

LocaleName 87

ConfiguringIndividualApplications 88

CommandLine 88

Disabled 88

ReadOnlyData 88

ReserveExtraAddressSpace 89

Shortcut 89

Shortcuts 90

Source 90

WorkingDirectory 90

ConfiguringDependentApplicationswithApplicationLink 91

ApplicationLinkPathnameFormats 91

RequiredAppLinks 92

OptionalAppLinks 93

ConfiguringApplicationUpdateswithApplicationSync 93

AppSyncClearSandboxOnUpdate 93

AppSyncExpireMessage 94

AppSyncExpirePeriod 94

AppSyncURL 94

AppSyncUpdateFrequency 94

AppSyncUpdatedMessage 95

AppSyncWarningFrequency 95

AppSyncWarningMessage 95

AppSyncWarningPeriod 95

ConfiguringMSIFiles 96

MSIArpProductIcon 96

MSIDefaultInstallAllUsers 96

MSIFilename 97

MSIInstallDirectory 97

MSIManufacturer 97

MSIProductCode 98

MSIProductVersion 98

MSIRequireElevatedPrivileges 99

MSIUpgradeCode 99

MSIStreaming 99

ConfiguringSandboxStorageandInventoryNames 100

InventoryName 100

RemoveSandboxOnExit 100

SandboxName 101

SandboxNetworkDrives 101

SandboxPath 101

SandboxRemovableDisk 102

VMware, Inc. 7

Contents

6LocatingtheThinAppSandbox 103

SearchOrderfortheSandbox 103

ControllingtheSandboxLocation 105

StoretheSandboxontheNetwork 105

StoretheSandboxonaPortableDevice 105

SandboxStructure 106

MakingChangestotheSandbox 106

ListingVirtualRegistryContentswithvregtool 106

7CreatingThinAppSnapshotsandProjectsfromtheCommandLine 107

MethodsofUsingthesnapshot.exeUtility 107

CreatingSnapshotsofMachineStates 107

CreatingtheTemplatePackage.inifilefromTwoSnapshotFiles 108

CreatingtheThinAppProjectfromtheTemplatePackage.iniFile 108

DisplayingtheContentsofaSnapshotFile 109

Samplesnapshot.exeCommands 109

CreateaProjectWithouttheSetupCaptureWizard 109

Customizingthesnapshot.iniFile 110

8ThinAppFileSystemFormatsandMacros 111

VirtualFileSystemFormats 111

ThinAppFolderMacros 111

ListofThinAppMacros 112

Processing%SystemRoot%inaTerminalServicesEnvironment 113

9CreatingThinAppScripts 115

CallbackFunctions 115

ImplementScriptsinaThinAppEnvironment 116

.batExample 116

TimeoutExample 116

ModifytheVirtualRegistry 117

.regExample 117

StoppingaServiceExample 117

CopyingaFileExample 117

AddaValuetotheSystemRegistry 118

APIFunctions 119

AddForcedVirtualLoadPath 119

ExitProcess 119

ExpandPath 120

ExecuteExternalProcess 120

ExecuteVirtualProcess 121

GetBuildOption 121

GetFileVersionValue 121

GetCommandLine 122

GetCurrentProcessName 122

GetOSVersion 123

GetEnvironmentVariable 124

RemoveSandboxOnExit 124

SetEnvironmentVariable 124

SetfileSystemIsolation 125

SetRegistryIsolation 125

WaitForProcess 125

ThinApp User’s Guide

8VMware, Inc.

10 MonitoringandTroubleshootingThinApp 127

ProvidingInformationtoTechnicalSupport 127

LogMonitorOperations 127

TroubleshootActivitywithLogMonitor 128

PerformAdvancedLogMonitorOperations 128

LogFormat 130

TroubleshootingSpecificApplications 134

TroubleshootRegistrySetupforMicrosoftOutlook 134

ViewingAttachmentsinMicrosoftOutlook 134

StartingExplorer.exeintheVirtualEnvironment 135

TroubleshootingJavaRuntimeEnvironmentVersionConflict 135

Glossary 137

Index 141

VMware, Inc. 9

TheThinAppUser’sGuideprovidesinformationabouthowtoinstallThinApp™,captureapplications,deploy

applications,andupgradeapplications.You canrefertothisguidetocustomizeparametersandperform

scripting.

Intended Audience

ThisbookisintendedforanyonewhoinstallsThinAppanddeployscapturedapplications.Typicalusersare

systemadministratorsresponsibleforthedistributionandmaintenanceofcorporatesoftwarepackages.

VMware ThinApp Documentation

ThecompletedocumentationsetforVMwareThinAppconsistsofthefollowingdocuments.

ThinAppUser’sGuide.Conceptualandproceduralinformationtohelpyoucompleteatask.

ThinApp4.6ReleaseNotes.Late‐breakingnewsanddescriptionsofknownissuesandworkarounds.

MigratingApplicationswithThinAppDuringanUpgradefromMicrosoftWindowsXPtoWindows7.

ProceduralinformationforusingThinApptomigrateapplicationsfromWindowsXPtoWindows7.

Document Feedback

VMwarewelcomesyoursuggestionsforimprovingourdocumentation.Ifyouhavecomments,sendyour

feedbacktodocfeedback@vmware.com.

Technical Support and Education Resources

Thefollowingsectionsdescribethetechnicalsupportresourcesavailabletoyou.To accessthecurrentversion

ofthisbookandotherbooks,gotohttp://www.vmware.com/support/pubs.

Online and Telephone Support

Touseonlinesupporttosubmittechnicalsupportrequests,viewyourproductandcontractinformation,and

Customerswithappropriatesupportcontractsshouldusetelephonesupportforthefastestresponseon

priority1issues.Gotohttp://www.vmware.com/support/phone_support.

Support Offerings

TofindouthowVMwaresupportofferingscanhelpmeetyourbusinessneeds,goto

http://www.vmware.com/support/services.

About This Book

ThinApp User’s Guide

10 VMware, Inc.

VMware Professional Services

VMwareEducationServicescoursesofferextensivehands‐onlabs,casestudyexamples,andcoursematerials

designedtobeusedason‐the‐jobreferencetools.Coursesareavailableonsite,intheclassroom,andlive

online.Foronsitepilotprograms andimplementationbestpractices,VMwareConsultingServicesprovides

offeringsto helpyouassess,plan,build,andmanageyourvirtualenvironment.To accessinformationabout

educationclasses,certificationprograms,andconsultingservices,gotohttp://www.vmware.com/services.

Legal Notice

ThinAppusestheregularexpressionlibraryoriginallywrittenbyHenrySpencer.

WrittenbyHenrySpencer.Notderivedfromlicensedsoftware.

Permissionisgrantedtoanyonetousethissoftwareforanypurposeonanycomputersystem,andto

redistributeitinanyway,subjecttothefollowingrestrictions:

1Theauthorisnotresponsiblefortheconsequencesofuseofthissoftware,nomatterhowawful,evenif

theyarisefromdefectsinit.

2Theoriginofthissoftwaremustnotbemisrepresented,eitherbyexplicitclaimorbyomission.

3Alteredversionsmustbeplainlymarkedassuch,andmustnotbemisrepresented(byexplicitclaimor

omission)asbeingtheoriginalsoftware.

4Thisnoticemustnotberemovedoraltered.

Other manuals for THINAPP 4.6 - MIGRATING APPLICATIONS TECHNICAL...

Table of contents

Other VMware Software manuals

VMware

VMware VCENTER CONFIGURATION MANAGER 5.3 - SOFTWARE CONTENT REPOSITORY TOOL... User manual

VMware

VMware APPSPEED SERVER 1.5 - VCENTER APPSPEED INSTALLATION... Installation and operation manual

VMware

VMware ESX 4.0 - GETTING STARTED UPDATE 1 General instructions

VMware

VMware VCM 5.3 - CONFIGURATION MANAGER SECURITY ENVIRONMENT... Quick guide

VMware

VMware VCENTER CAPACITYIQ 1.5 User manual

VMware

VMware FUS3-ENG-M-10-CP - Fusion For Mac OS X User manual

VMware

VMware VCENTER APPLICATION DISCOVERY MANAGER 6.0 User manual

VMware

VMware SUSE LINUX ENTERPRISE SERVER User manual

VMware

VMware VSPHERE 4.0 - SOFTWARE COMPATIBILITY MATRIX User manual

VMware

VMware SUSE LINUX ENTERPRISE SERVER User manual

VMware

VMware VLM3-ENG-CP - Lab Manager - PC User manual

VMware

VMware VSHIELD APP 1.0.0 UPDATE 1 - API Manual

VMware

VMware VS4-ENT-PL-A - vSphere Enterprise Plus User manual

VMware

VMware VSHIELD APP 1.0 - API Operating instructions

VMware

VMware VIEW MANAGER 4.X - EXTENDING VIRTUAL MACHINE DELECTION WITH... User manual

VMware

VMware VCLOUD REQUEST MANAGER 1.0.0 User manual

VMware

VMware 454885-B21 - Lab Manager Standard Foundation... User manual

VMware

VMware 4817V62 - vSphere - PC Instruction Manual

VMware

VMware VFABRIC TC SERVER User manual

VMware

VMware VCENTER CONVERTER EN-000158-02 User manual

VMware

VMware VCENTER CHARGEBACK 1.5 - API User manual

VMware

VMware SPRINGSOURCE HYPERIC HQ User manual

VMware

VMware VCLOUD REQUEST MANAGER User manual

VMware

VMware VmWare ESX Server 2.12 Deployment Quick reference guide

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual