[THIN] KB: CTX105646 - Cpatch.exe � The Citrix Patch Handling Utility

  • From: "Jim Kenzig Kenzig.com" <jkenzig@xxxxxxxxx>
  • To: thin@xxxxxxxxxxxxx
  • Date: Sun, 9 Jan 2005 16:35:54 -0800 (PST)

 CTX105646 - Cpatch.exe #65533; The Citrix Patch Handling Utility 

This document was published at: 
http://support.citrix.com/kb/entry.jspa?externalID=CTX105646 


Document ID: CTX105646, Created on: Jan 7, 2005, Updated: Jan 7, 2005 
Products: Citrix MetaFrame XP 1.0 for Microsoft Windows 2000, Citrix MetaFrame 
XP 1.0 for Microsoft Windows 2003 
 
Introduction

The Citrix patch handling utility (cpatch.exe) is useful for installation and 
removal of Citrix patches, such as service packs and hotfixes, packaged as an 
.msp file using MSI 3.0. The utility is also useful for obtaining information 
regarding installed patches

The Citrix patch handing utility is automatically installed on your MetaFrame 
XP 1.0 server when Service Pack 4 and any post Service Pack 4 hotfixes are 
applied.

Note that products, hotfixes, service packs, or any other patch packaged using 
MSI versions earlier than 3.0 are not supported.

Usage

To display the Citrix patch handling utility usage, open a command (cmd.exe) 
window and execute cpatch with no command-line options:

>cpatch

Citrix Patch handling utility
Options...
/l [ProductCode] List the Citrix Patches installed for [ProductCode].
If no ProductCode is specified patches for all the

Citrix products are enumerated.
/u [PatchCode]/[PatchFile]/[HotfixName]
Remove a Citrix patch from all the applicable products.
/p [PatchPackage] Apply [PatchPackage] to all applicable products
/a [PatchPackage] [ProductLocation]
Apply [PatchPackage] to the administrative install
for Product located at [ProductLocation].
/r Lists the Citrix products installed on this server.
/i [PatchCode]/[PatchFile]/[HotfixName]
Displays information about a Citrix patch.


Obtaining Information Regarding Installed Patches

The /r option is used to list the Citrix products installed on the server:

>cpatch /r

******************Product Information******************
ProductName = Citrix MetaFrame XP Server for Windows with Feature Release 3
ProductCode = {05095D7E-4BA8-405F-A751-5C5C18BF5045}
ProductLanguage = 1033
ProductVersion = 1.3.0


The /l option is used to list which Citrix patches are installed for specific 
products as well as obtain information regarding the patch, such as the 
PatchName, PatchCode, InstalledBy, InstalledDate/Time, and specific file size 
or version of files updated with the patch.

To list all Citrix patches applied to all Citrix products, use /l without 
specifying a product code as follows:

>cpatch /l

To list all Citrix patches applied to a specific product, use the product code 
from the output of the /r option. Sample output follows this example:

>cpatch /l {05095D7E-4BA8-405F-A751-5C5C18BF5045}

******************Hotfix Information******************
HotfixName = MFXPServicePack4
HotfixLocalPackage = C:\WINNT\Installer\837cbc.msp
PatchCode = {FD875D10-3027-4D3C-953A-999745109989}
ProductName = Citrix MetaFrame XP Server for Windows with Feature Release 3
ProductVersion= 1.3.0
ProductCode= {05095D7E-4BA8-405F-A751-5C5C18BF5045}
ProductLanguage= 1033
InstalledBy = ALANS-VM-W2K\Administrator
InstallDate = 20041216
InstalledOn = 1103213291
Install Date = Dec 16, 2004
Install Time = 11:08:11
HotfixSequence = 2.3.1495.1
MoreInfoURL = http://www.citrix.com/support
CreationTimeUTC = 12-14-2004 23:19
Classification = Service Pack
PatchState = 1
ReplacesCount = 0
Valid = 1
FileCount = 151
FileName = E0010404.kbd FileSize = 7769
FileName = zlc_font.dll FileVersion = 2.3.1495.1
?


Because the output may be very lengthy for large and/or numerous patches, 
piping the output into the more command may be used to pause after one screen 
full of information is displayed:

>cpatch /l | more

Or the output may be redirected to text file:

>cpatch /l > C:\cpatch.txt

In certain instances, you may only desire to see information for one particular 
patch, rather than all patches, or all patches applied to a particular product. 
In this instance the /i switch is useful. The /i switch may be used with the 
patch file name, patch code, or patch name to display information about one 
patch only.

>cpatch /i mfxpsp4.msp

>cpatch /i FD875D10-3027-4D3C-953A-999745109989}

>cpatch /i MFXPServicePack4

Installing Patches

To install a patch, use the /p option and the patch will be installed to the 
applicable product:

>cpatch /p mfxpsp4.msp

Follow the patch installation wizard to complete the installation.

Removing Patches

To remove a patch, use the /u option and the patch will be removed from the 
applicable product. You may either specify the PatchCode or PatchName (from the 
cpatch /l output), or the patch file name.

>cpatch /u {FD875D10-3027-4D3C-953A-999745109989}

>cpatch /u MFXPServicePack4

>cpatch /u mfxpsp4.msp

Follow the patch un-installation wizard to complete the removal


Other related posts:

  • » [THIN] KB: CTX105646 - Cpatch.exe &#65533; The Citrix Patch Handling Utility