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