Table Of ContentQuick Start Training Guide to
Creating Custom Transform Files for
the Feature Release 2 MSI Package
Citrix Systems, Inc.
Notice
The information in this publication is subject to change without notice.
THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE OR NON-INFRINGEMENT. CITRIX SYSTEMS, INC. (“CITRIX”), SHALL NOT BE LIABLE FOR
TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED HEREIN, NOR FOR DIRECT,
INCIDENTAL, CONSEQUENTIAL, OR ANY OTHER DAMAGES RESULTING FROM THE FURNISHING,
PERFORMANCE, OR USE OF THIS PUBLICATION, EVEN IF CITRIX HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES IN ADVANCE.
This publication contains information protected by copyright. Except for internal distribution, no part of this
publication may be photocopied or reproduced in any form without prior written consent from Citrix.
The exclusive warranty for any Citrix products discussed in this publication, if any, is stated in the product
documentation accompanying such products. Citrix does not warrant products other than its own.
Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.
© 2002 Citrix Systems, Inc.
All rights reserved. Printed in the U.S.A.
Version History
May 2002 Original
Quick Start Training Guide to � ii
Creating Custom Transform Files for
the Feature Release 2 MSI Package
TABLE OF CONTENTS
Introduction.......................................................................................................................................................1
Prerequisites ......................................................................................................................................................1
How to Obtain the Orca Editor and the Windows Installer 2.0 Update.......................................................................2
Orca Editor ....................................................................................................................................................2
Windows Installer 2.0......................................................................................................................................4
The Orca Editor .................................................................................................................................................5
Modifying an MST File for a New Farm Using an Access Database......................................................................5
Modifying an MST File for a New Farm Using a Third Party Database..................................................................8
Installing Your Customized Package .................................................................................................................. 10
If Installation Fails ........................................................................................................................................ 11
Additional Information ..................................................................................................................................... 14
Citrix Resources ........................................................................................................................................... 14
Microsoft Resources...................................................................................................................................... 14
For Advanced Users .................................................................................................................................. 15
Updates to Appendix B of the MetaFrame Administrator’s Guide .......................................................................... 16
Quick Start Training Guide to � iii
Creating Custom Transform Files for
the Feature Release 2 MSI Package
Introduction
This document will help you create your own transform files (MST) for the MetaFrame XP 1.0, Feature Release 2 MSI
package.
An MST file is essentially an answer file for MSI packages. In this document, you will become familiar with Microsoft’s
Orca editor, distribute packages with Msiexec from a command line, and use the Windows Installer Verbose Log
Analyzer.
You will learn how to modify two of the Citrix-provided transform files to install the first server in a new farm with an
Access and SQL data store.
Prerequisites
• One workstation or member server (Windows 2000 workstation, Windows 2000 member server, or Windows XP
Pro) for editing and creating an MST file.
• One Windows 2000 Server with Service Pack 2 on which to install Feature Release 2 (FR2).
• Microsoft’s Orca Editor
• Windows Installer 2.0
• Access to Feature Release 2 (either network or CD access)
• Access to Appendix B of the MetaFrame XP 1.0 Feature Release 2 Administrators Guide
NOTE: You can perform all of the steps in this exercise on the same server.
Named Pipe Communication
Managed Applications on
Farm Server1:
SQL App.
Regedt32
Citrix Farm Server1 Citrix Farm Server2
Quick Start Training Guide to � 1
Creating Custom Transform Files for
the Feature Release 2 MSI Package
How to Obtain the Orca Editor and
the Windows Installer 2.0 Update
Orca Editor
The Orca Editor is Microsoft’s MSI file editor. Other editors are available on the Internet but we used Orca. The Orca
Editor allows you to edit the MSI file directly, create new files, or change existing MST files. Follow these steps to
download and install the editor. For our purposes, we installed the Orca Editor on a Windows workstation.
1. Go to the MSDN Platform SDK download Web site at
http://www.microsoft.com/msdownload/platformsdk/sdkupdate/. You may be prompted to install the SDK Update
ActiveX Control. If you do, install it.
2. In the left window pane, select Windows Installer SDK.
3. In the right window pane, select Install this SDK! After you select the link, you are redirected to the Confirm
Install Selections Web page. Your server is scanned for any existing components.
Quick Start Training Guide to � 2
Creating Custom Transform Files for
the Feature Release 2 MSI Package
4. After your server is scanned for any existing software, a screen similar to the following appears.
5. Click the Continue button on the right side of the screen to start the download. This download will include the
following components:
• Windows Installer SDK Documentation
• Windows Installer development files (.h, .lib)
• Sample MSI files
• Sample scripts for working with MSI
• Orca Database Editing Tool
• MSIVal2 tool database validation tool
• Code samples
Before the download starts, you will be notified that the Installer has privileged access to your server and to download
the SDK only from the Microsoft Web site. If you are downloading from the Microsoft Web site, click OK (see bitmap
below).
Quick Start Training Guide to � 3
Creating Custom Transform Files for
the Feature Release 2 MSI Package
6. Accept the license agreement.
7. Select the directory where you want to install the program (the default is c:\Program Files\Microsoft SDK).
8. Click Install Now. The SDK components download to your server.
9. When installation is complete, close your Web browser.
10. From the directory where you installed the SDK, switch to the Bin subdirectory (for example, C:\Program
Files\Microsoft SDK\Bin).
11. Double click the Orca.msi file to install it.
12. The installation program adds an Orca entry to your Start, Programs menu.
Windows Installer 2.0
MetaFrame XP 1.0, Feature Release 2 requires Windows Installer 2.0. The update, Instmsiw.msi, is in the support\msi20
directory on the server CD. To verify which version you have installed, type msiexec at a command prompt. A dialog
box similar to the following appears.
Double-click the MSI package to install it on the server where you will install FR2.
NOTE: Make sure you install the MSI package before you contine.
Quick Start Training Guide to � 4
Creating Custom Transform Files for
the Feature Release 2 MSI Package
The Orca Editor
Regardless of which database you use for your data store, Citrix recommends that you do the Access exercise to become
familiar with the new tools and processes.
Modifying an MST File for a New Farm
Using an Access Database
The Orca Editor is Microsoft’s editing tool for MSI packages and MST files. When you install the editor on your system,
you will see an entry in your Start, Programs menu that looks like this:
Double-click the new entry to start the editor. When you start the editor, the following dialog box appears:
The Orca Editor is very similar in look and usage to the Registry Editor. When you open an MSI file, the “keys” are
opened in the left window pane and the properties and values are listed in the right window pane. To change a value,
double-click a property and type a new value.
Quick Start Training Guide to � 5
Creating Custom Transform Files for
the Feature Release 2 MSI Package
For the first exercise, we will modify an MST file (localdb_access_create.mst) that ships with FR2. This file will install
the first server in a new farm using an Access database.
To get started, open Orca Editor. Select File, Open from the pull down menu (or the Open Folder shortcut) and select the
Mfxp01 MSI file. This file is in the MetaFrame directory on the CD. When you select the FR2 MSI package, the
following dialog box appears:
Note that the left pane is populated with the various data tables that make up the MSI package. Next we want to apply an
existing transform file to the MSI package and modify it for our needs. To do this, select Apply Transform from the
Transform pull-down menu. You need to select a transform that you want to apply to the MSI file. Select the
localdb_access_create.mst file from the Support\Install directory on your FR2 server CD. Once you do this, scroll down
through the left window pane to the Property table. Note the colored vertical bar next to Property.
Quick Start Training Guide to � 6
Creating Custom Transform Files for
the Feature Release 2 MSI Package
This marker informs you that this is the table you need to change to create a custom transform file. Double click
Property. The following dialog box appears:
The right window pane is now populated with properties and values. Notice that some of the values have a colored
outline. The Citrix sample MST files do this to show you which properties need to be changed. These properties and
acceptable values are described in Appendix B of the Feature Release 2 Administrators Guide. Take time to review
Appendix B and familiarize yourself with the available properties, their definitions, and acceptable values.
Now that you have reviewed Appendix B, you need to change the required entries for creating a new farm with an
Access database. To change the values, double-click the existing value and enter the appropriate new value.
The values to change for the first server in a farm using an Access database are listed below.
CTX_MF_NEW_FARM_NAME – Specify the name of your new farm here.
CTX_MF_USER_NAME – This is the user name for the initial Citrix administrator credentials.
CTX_MF_DOMAIN_NAME – This is the machine or domain name for the above entry.
CTX_MF_SERVER_TYPE – Specify the version of MetaFrame to install: XPs, XPa, or XPe.
CTX_MF_PRODUCT_CODE – Add the appropriate product code for the CTX_MF_SERVER_TYPE selection.
Quick Start Training Guide to � 7
Creating Custom Transform Files for
the Feature Release 2 MSI Package
