Guest

Cisco VPN Client

VPN Client MSI Installation Package Customization Using an MSI Transform Microsoft Orca

Cisco - VPN Client MSI Installation Package Customization Using an MSI Transform Microsoft Orca

Document ID: 51628

Updated: Jan 14, 2008

   Print

Introduction

This document demonstrates how to customize the Cisco Systems VPN Client MSI Installation package using an MSI transform.

Microsoft Orca is one of the applications used to create or modify transforms. There are applications from InstallShield and Wise Solutions that allow you to create or modify transforms easily. Users should not attempt to use Orca unless they are experienced Orca users. A transform is a way for a user to modify a vendor's MSI package.

Prerequisites

Requirements

Readers of this document should have knowledge of these topics:

  • The user must be familiar with creating transforms.

  • The Cisco Systems MSI only supports Microsoft Windows Installer 2.0.

Components Used

The information in this document is based on these software and hardware versions:

  • Cisco VPN Client Software Version 4.x

  • Microsoft Orca leavingcisco.com Version 2. 03672.0

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Conventions

For more information on document conventions, refer to the Cisco Technical Tips Conventions.

Create a Transform

Follow the instructions provided in these sections to create a transform.

Start Orca

Select Start > Programs and click Orca.

Open an MSI File

Complete these steps:

  1. From the File menu, select Open.

  2. Browse to the directory that you want to work in (c:\Acme Widgets).

  3. Select the Cisco Systems VPN Client file (vpnclient_setup.msi).

  4. Click Open (see Figure 1).

Add a File

You need to add a file if you wish to add new functionality to the MSI Package or add new features to the application that is being installed by the MSI. Complete these steps:

  1. Select File from the left pane.

  2. From the Table menu, select Add Row to display the Add Row dialog box.

  3. Select the filename (for example, logo.bmp).

  4. Select Component and enter the component name (for example, CsCoFile_VpnGUIResources).

  5. Select FileSize and enter the file size (for example, 172278).

  6. Select Attributes and enter 8192. 8192 means that the file is uncompressed.

  7. Select Sequence and enter 183. Currently 183 is the next available sequence number.

  8. Click OK.

    Figure 1

    create-transform-orca-1.gif

Add Media

Complete these steps.

  1. Select Media from the left pane (see Figure 2).

  2. From the Tables menu select Add Row to display the Add Row dialog box.

  3. Select DiskId and add the next number in the DiskId sequence.

  4. Select LastSequence and add the sequence number of the last file added to the File Table.

  5. Click OK.

    Figure 2

    create-transform-orca-2.gif

Add a Property

Add a new Property when you wish to define a new directory or registry entry that you want to add to the MSI Installer or the application being installed by the MSI package. Complete these steps:

  1. Select Property in the left pane, (see Figure 3).

  2. From the Table menu, select Add Row to display the Add Row dialog box.

  3. Select Property name.

  4. Select Value and enter Property Value.

  5. Click OK.

    Figure 3

    create-transform-orca-3.gif

Save the Transform

Complete these steps.

  1. From the Transform menu, select Generate Transform.

  2. Browse to the directory where you want to save the transform.

  3. Enter the transform name.

  4. Click Save.

Modify a Transform

Complete the steps in these sections to modify a transform.

Modify a Transform

Complete these steps.

  1. Select Start > Programs and click Orca.

  2. From the File Menu, select Open.

  3. Browse to the directory that contains the Cisco System VPN Client file (vpnclient_setup.msi).

  4. Select the vpnclient_setup.msi file.

  5. From the Transform Menu, select Apply Transform.

  6. Browse to the directory that contains the Transform you want to modify.

  7. Select Transform and click Open.

Replace an Existing File

Complete these steps.

  1. From the left pane, select File.

  2. In the right pane, click on the file you want to replace.

  3. Select FileSize and then enter the file size (for example, 17228).

  4. Select Attributes and then enter 8192. 8192 means the file is uncompressed.

Modify a Property

Complete these steps.

  1. Select Property in the left pane.

  2. In the right pane, select the property you want to modify.

  3. Select Value and enter the new value.

Related Information

Updated: Jan 14, 2008
Document ID: 51628