Click to edit Master title style

Date : Jan 2012

Narendra Nalamwar Setup Capture

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Session Objectives
Summary:
⁻ Source Validation.
⁻ SetupCapture Overview
⁻ Global Exclusion list
⁻ Capturing Multiple Setups and Reboot
⁻ Editing WSI
⁻ Compile IRP–> ISM–>MSI
⁻ Testing - Installation and un-installation of MSI

Day Wise Duration:

Day 1- All the above topics shall be covered.

Target Audience:
IT Engineers with understanding of basic Windows installer concept and
Repackaging.

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

 Click to edit Master title style
Source Validation

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Source Validation
• Once the source received with the associated documentation you must perform
appropriate checks to ensure the software you are about to package is the correct
version and that steps in the installation document are valid options.

• Make sure the source you have is the correct version.

• Install source manually on associated Operating System (s) (XP, Windows 7)

accepting the installation options as outlined in the installation document.

• Perform a low level test on the software to ensure no issues exist.

• During the source validation, Check if application is Legacy Setup / Vendor MSI.
Accordingly follow the re-packaging steps.

• If no issues or concerns have been discovered with the source or documentation

proceed with the packaging of the application.

4 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

 Click to edit Master
Setup Capture Overview
title style

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Introduction
• SetupCapture – is a technique to record all the changes performed
by an installation media (setup.exe) and saves this to a new Windows
Installer package. It also captures the first use changes that an
application makes to a computer.

• Tools used for SetupCapture :

» Install Shield
» Wise Package Studio
» Win Install
» Picture Taker
» Install Watch

6 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (Repackager)
RePackger Tool(Install Shield) :
All Program -> Admin Studio -> Admin Studio <Version> Tools -> Repackager

Repackager Tool

7 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (Repackager)

Click on following
option start with
Capturing

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (Repackager)

Select the repackaging method

Snapshot and Installation Monitoring

9 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (snapshot method)

Snapshot – Multiple Steps 1st snapshot

Install Setup 2nd Snapshot

10 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (First Snapshot over)

1st snapshot completed.

Install source as per install instructions and take the 2nd snapshot

11 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (Install EXE and Snapshot)

Run repackager tool again to take the 2nd Snapshot

i.e. Analyze system status changes

12 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (2nd Snapshot)

Product details and location to store files

This will take the second snapshot of the OS, capture all the changes made after installing
the application and save the files at the above location

13 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (Snapshot over)

INC,IRP file is created and this can be used to get final ISM or MSI

14 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Output after Setup Capture
• Installshield output after setup capture is
– Application files and folders
– Standard.NIR and Options.INI
– AppID.INC and AppID.IRP

15 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Setup Capture (Snapshot over)
After the second snapshot we get the following files and folders

• Standard.nir –It contains registry additions and modifications

• Options.ini – Configuration information for the conversion of the .inc

file to an ISM\MSI package

• AppID.inc – It contains the locations of files, .ini files, and shortcuts

• AppID.irp –It contains information about the .inc file to be referred and
all other information

• Application folders – PROGRAMFILESFOLDER, WINDOWSFOLDER,

COMMONFILESFOLDER etc and files

16 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit IRP (inclusion\exclusion\build ISM)

IRP file can be modified and build to get ISM or MSI

17 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

IRP Modification (include\exclude file\folder)

Files\Folders (including sub folders) can be excluded or included in IRP

18 Application
COMMERCIAL Management Centre Pune
IN CONFIDENCE © Copyright 2011 ECS Europe Limited
IRP Modification (incl\excl registries)

Registries (including sub keys) can be excluded or included in IRP

19 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

IRP Modification (build options)

Give ISM location, MSI options and Template to create ISM file

20 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

IRP Modification (build options)

• Select ISM name and location for build

• MSI and ISM both can be build in one go if required

• Specific template can be used to create ISM file

• If building ISM and MSI both, different media options can be selected

Best method is to just create ISM from the IRP file, edit this newly created ISM
file for any customization and then compile (build) MSI from the ISM file

21 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

IRP modification (Package Information)

ProductName, Manufacturer, ProductVersion can be set in IRP

22 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

IRP Modification (build settings)

23 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

IRP Build (ISM created)

24 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM

• IRP file is now build to ISM file

• ISM file can be edited for all customizations

• New Files\Folders\Registries can be added in ISM

• ISM file has 9 sections in it

25 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Practical – Setup Capture Lab 1

• Perform Setup Capture for the given legacy application

>>WinRAR

• Make ISM file out of it for editing

26 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

 Click to edit Master
Edit ISM & Build MSI title style

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM
• Installation Information – Describe and identify your installation

• Organization – Customize features\Components for installation

• Application Data – Files\Folders and Merge Modules to be used

• System Configuration – Shortcuts, Registries, INI,ODBC settings

• Behavior and Logic – Standard and Custom action, Properties

• User Interface – User Interface (Dialogs)

• Media – Release setup, Path Variables

• Additional tools – Direct Editor (Tables), Debugger

28 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (General Information)

ISM can be edited to add customizations ( General Info, ARP etc.)

29 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Summary Info, ARP, Product Properties)

30 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Add\modify Features, Components
• Features can be created\deleted from GUI

• Components can be created manually or by using wizard

• Component created manually needs to associated to respective
feature

31 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Feature, component view)

Feature
Components

Component
Resources

New Feature, Components, resource can be added, deleted or modified

32 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (File\Folder View)

33 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Redistributables)
• Merge Modules can be added to package
What is a Merge Module?

34 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Shortcut, ODBC, INI settings)

35 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Add Shortcut, Drivers, DSN, INI File

Add Advertised\Normal shortcuts

Select existing
DSN\Driver\Translator or
add New ones

Add INI file and sections

or Import existing INI file

36 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Property Manager
• Used to add\remove\set\modify properties in MSI package

• Same can be done from PROPERTY table as well

37 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Tables)
Installer tables can be accessed from Direct Editor

38 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Build MSI options)

39 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Build MSI options)

40 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Build MSI- Media Options)

Media options can be selected (internal CAB, external CAB, loose files)
Setup.exe can be created to execute MSI (optional)

41 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit ISM (Build MSI)

42 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit MSI (Customization and Validation)

• Once ISM is build it will generate the MSI file

• MSI file can be edited same way as ISM

• MSI file can be modified\customized in the same way as ISM

• Once all customizations are done MSI needs to be validated

• All Validation errors need to be resolved in MSI as changes in ISM will require
it to be re-build in MSI

43 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Edit MSI (Validation)
• Build -> Validate -> Full MSI Validation Suite

44 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Practical – Setup Capture Lab 2

• Edit the ISM created in the previous practical

• Add new component with file as “notepad.exe” and going to INSTALLDIR

folder

• Add Shortcut for notepad.exe, add ODBC Driver, DSN, Registry, INI,
Environment Variable to ISM

• Build ISM to get final MSI

• Validate the MSI

45 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Lab 3
• Do the SetupCapture of the following Application.

» Filezilla Client

46 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

 Click to edit Master title style
Capturing Multiple Setups and Reboot

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Capturing Reboot

• If application contains reboot, it needs to be captured.

• Reboot should be given before second snapshot (post scan) begins

• After reboot, restart Setup Capture by loading Install shield repackger

tool. In this case all the previous settings should be re-entered, with the
exception of the ‘Use initial scan’ option which should be selected as
shown below.

48 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Lab 2
• Do the SetupCapture of the following Application.

» Contains Multiple Setups

» Contains Reboot

» Contains Post Install Instructions

49 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Questions

1. What are different methodologies of SetupCapture?

2. What is meant by pre-install and post-install configuration?

3. Name the file which contains the default exclusion list during
SetupCapture?

4. Is it possible to capture REBOOT by using SetupCapture tool? How?

5. Is it possible to capture Multiple setups by using SetupCapture tool?

How?

50 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

 Click to edit Master title style
Installation and un-installation of MSI

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Testing - MSI Installation
• This needs to be done on Capturing VM
• Create “temp” folder on C:
• Copy MSI from network to “C:\temp” folder
• Start DOS Command Prompt and install the application.
• Launch all shortcuts and make sure they are behaving same as that of
the source
• Delete an exe file and check if self repair is working
• Check “Add-Remove Programs” entry

52 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Testing - MSI Un-Installation
• Once installation is tested, un-installation test needs to be carried out
• Start DOS Command Prompt and un-install application.
• make sure application shortcuts are deleted
• INSTALL dir is deleted
• “Add-Remove Programs” entry is deleted

53 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

Lab 4
• Test MSIs created in Lab2 and 3

54 COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited

COMMERCIAL IN CONFIDENCE © Copyright 2011 ECS Europe Limited