Custom Transform Files - Creating Custom Transform Files for the Feature Release 2 MSI Package n 1...

download Custom Transform Files - Creating Custom Transform Files for the Feature Release 2 MSI Package n 1 Introduction

of 20

  • date post

    09-May-2020
  • Category

    Documents

  • view

    2
  • download

    0

Embed Size (px)

Transcript of Custom Transform Files - Creating Custom Transform Files for the Feature Release 2 MSI Package n 1...

  • QQuuiicckk SSttaarrtt TTrraaiinniinngg GGuuiiddee ttoo CCrreeaattiinngg CCuussttoomm TTrraannssffoorrmm FFiilleess ffoorr tthhee FFeeaattuurree RReelleeaassee 22 MMSSII PPaacckkaaggee

    Citrix Systems, Inc.

  • Quick Start Training Guide to Creating Custom Transform Files for the Feature Release 2 MSI Package

    n ii

    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 Creating Custom Transform Files for the Feature Release 2 MSI Package

    n iii

    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 Creating Custom Transform Files for the Feature Release 2 MSI Package

    n 1

    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.

    Citrix Farm Server1 Citrix Farm Server2

    Named Pipe CommunicationManaged Applications on Farm Server1:

    SQL App. Regedt32

  • Quick Start Training Guide to Creating Custom Transform Files for the Feature Release 2 MSI Package

    n 2

    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.

    http://www.microsoft.com/msdownload/platformsdk/sdkupdate/

  • Quick Start Training Guide to Creating Custom Transform Files for the Feature Release 2 MSI Package

    n 3

    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 Creating Custom Transform Files for the Feature Release 2 MSI Package

    n 4

    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 Creating Custom Transform Files for the Feature Release 2 MSI Package

    n 5

    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