Server Drive Remapping and using the Driveremap.exe Utility in MF XP FR2
This document describes the Drive Remapping mechanism, the Driveremap.exe utility, its parameters and usage. See MetaFrame/Presentation Server Drive Remapping Best Practices for additional best practices.
Previous versions of MF XP performed the drive remapping as part of the product install. This was changed with the Feature Release 2 (FR2) installation package to be a separate utility that can be executed as a stand alone executable that can be run before the product installation. For example, if you are going to just run the .MSI installer package on a server that does not have previous versions of MetaFrame XP installed, you would run driveremap.exe before that Installation process. The previous filename was drvremap.exe, it has now changed to driveremap.exe in FR2. The utility can be found in the root of the directory of the Server portion of the FR2 package, or in c:Program FilesCitrixSystem32 after installing MetaFrame XP with FR2. On an upgrade to FR2 from MetaFrame XP with or without FR1, the utility is placed in the %systemroot%system32 directory.
The description of Server Drive remapping is presented in the MetaFrame XP with FR2 Administrators Guide on page 88 and page 211.
When to use:
The utility can be used to remap server drives prior to installing MetaFrame XP FR2 when MetaFrame XP is not present on the server. It is not recommended to run the utility after installing MetaFrame XP FR2 to remap the server drives.
Reversing Remapped Drives
You can unmap drives by running the DriveRemap User Interface, or from the command line, to map back to the original drive letters. For example, if you have mapped C: to M:, you can run the utility and map M: back to C: or even to a different available drive letter.
To do this from the command line:
driveremap /u /drive:M /drive:C
NOTE: It is recommended to reboot the server in this example.
The utility now has a user interface to select drive remapping letters. The user interface is available from the FR2 Autorun installation screens and when executing driveremap.exe with no command line parameters.
1. To run from the Autorun GUI:
- Select, "Install or Update Metaframe" from the main Autorun menu.
- Select the "Remap Drives" option.
2. From the Explorer Interface or Command Line with no Parameters:
- Double-click the executable from the CD, or after copying it to the local drive on the server.
- OR at a command line type, driveremap with no parameters then Enter .
The following parameters can be used with driveremap.exe at a command line.
Displays a dialog box with the available command line options.
Specifies the drive letter to use for the first remapped drive.
Allows for an Unattended or Silent install where no dialog boxes are displayed and no user input is required.
Surpresses the "Restart Computer" dialog box and does not restart the system.
For Japanese IME. Changes the drive letter specified in SoftwareMicrosoftWindowsCurrentVersionImeJapanIMEJPDictionaries for all of loaded hives under HKEY_USERS.
The utility can be used to remap server drives prior to installing MetaFrame XP FR2 when MetaFrame XP is not present on the server. It is not recommended to run the utility after installing MetaFrame XP FR2 and any applications to remap the server drives.
The following command will remap the servers drives starting with the first available drive to M: and not display any dialog boxes or require any input.
driveremap /u /drive:M /noreboot
Note: When running Driveremap.exe without the "noreboot" option, the final dialog box asking the user whether or not to restart the server never appeared. The Windows Task Manager showed Driveremap.exe running in an endless loop. See knowledgebase article CTX107122 or download Hotfix XE102W015.
The following command will remap back the drive letters to start at C: and then prompt for a reboot.
driveremap /u /drive:M /drive:C
The usage of this utility is currently not present as an option in the MSI packages or when using the Citrix Unattend.exe methods of FR2 installation.
However, the /u option is available to allow the usage of the utility in a script or batch file without prompting for input.
o The drive letter must be in Upper case when using the version of this utility that ships with FR2. A newer version that is not case-sensitive is available. See knowledgebase article CTX107122 or download Hotfix XE102W015.
o If the server is a member of an Active Directory Domain, driveremap.exe will hang, during its processing of "Fixing ADS links...", with the version of this utility that ships with FR2. A dialog box may pop up with the error text, "Unknow Window error". The current workaround is to move the server into a workgroup, remap the drives, and then rejoin the ADS domain. A newer version that does not require the use of the workaround is available. See knowledgebase article CTX107122 or download Hotfix XE102W015.
o When running driveremap.exe with no parameters, the drive letter choices in the pull down list may be greyed out.This happens because some aspect of being able to remap the existing drive letters cannot be done.
Some reasons for this are:
§ Non-contiguous drive letters, for example - C, D, X. the mapped drive letters are spread over the interval [a..z] and no reasonable interval shifting can be performed. Shifting C to M is a shift of 10. Drive letter X would not be able to shift 10 letters and wrap around the alphabet. Even Network Drives are taken into account.
Change the drive letters to C:, D:, E: and re-run the utility.
§ At the command prompt, if you silently remap to a letter that is IN USE, such as a mapped network drive, nothing will happen. The process just returns to the prompt. To see if mappings take place, launch Windows Explorer.
§ Citrix Server drive remapping is not supported on Windows 2000 Dynamic Disks.
These issues are From the SP2-FR2_readme.txt that can be found in root of the FR2 package and in the list of FR2 Docs after installation.
o INSTALLATION OF "TURNKEY" NFUSE CLASSIC MAY FAIL IF UPGRADING ON SERVER WITH REMAPPED DRIVES
If you are upgrading to MetaFrame XP, Feature Release 2 from MetaFrame 1.8 for Windows 2000 and the server has remapped drives, the installation of NFuse Classic may fail. To fix the problem, you must update the servers COM+ catalog. See article CTX240747 on the online Citrix Knowledge Base at http://www.citrix.com/support for more information.
o UPGRADING FROM METAFRAME 1.8 ON A SERVER WITH MAPPED DRIVES DOES NOT UPDATE ICA WIN32 PASS-THROUGH CLIENT
If you upgrade from MetaFrame 1.8 to MetaFrame XP on a server with changed server drive letters, the ICA Win32 pass-through Client. To avoid this issue, be sure the server is operating in install mode before running Setup. To update the pass-through client, install the "stand-alone" version of the pass-through client. (Clarification: Run the Win32 client executable and do not install to the default location. Install to the directory of the pass-through client on the server.)