FIX: You Cannot Configure MCMS to Use a Virtual Directory Other Than the Default NR Directory (817925)



The information in this article applies to:

  • Microsoft Content Management Server 2002

SYMPTOMS

In Microsoft Content Management Server (MCMS) 2002, the virtual directories for MCMS cache are represented as follows:
  • http://hostname/NR/EXERES
  • http://hostname/NR/RDONLYRES
Both the virtual directories (EXERES and RDONLYRES) are children of the NR virtual directories. You cannot change the NR directory to a different name.

CAUSE

The NR virtual directory value is hard-coded in the MCMS database. By design, you cannot change this value.

RESOLUTION

Service pack information

To resolve this problem, obtain the latest service pack for Microsoft Content Management Server 2002. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

906142 How to obtain the latest Content Management Server 2002 service pack

Hotfix information

The following hotfix permits users to change the NR directory to a setting that the user can define.

Hotfix Replacement Information

This hotfix does not replace any other hotfixes.

File Information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time tool in Control Panel.
   Date         Time   Version            Size    File name
   -------------------------------------------------------------------------
   03-Mar-2003  20:44  5.0.1594.0        314,880  Aeinterfaces.dll  
   03-Mar-2003  20:45  5.0.1594.0      1,217,024  Aeserverobject.dll  
   10-Dec-2002  21:52  4.0.1381.4         65,600  Cmsupdate.exe    
   03-Mar-2003  20:46  5.0.1594.0        377,856  Dtcc.dll         
   03-Mar-2003  20:45  5.0.1594.0      1,439,232  Resolutionobjectmodel.dll  
   03-Mar-2003  20:45  5.0.1594.0        731,136  Serverconfigurationapi.dll  
   04-Mar-2003  00:34                      2,620  Update.inf
   21-Jan-2003  02:01  1.0.0.0            24,576  Urlprefixconfig.exe  
   23-Jan-2003  01:38                      4,311  Wbccommonshared.inc
   23-Jan-2003  01:23                      7,103  Commonclient.js
   21-Jan-2003  22:04                     19,035  Commonserver.inc

STATUS

Microsoft has confirmed that this Is a problem In the Microsoft products that are listed In the "Applies To" section. This problem was corrected in Content Management Server 2002 Service Pack 1.

MORE INFORMATION

The setting for the NR virtual directory name is maintained from inside the MCMS database and is therefore a global setting. All MCMS servers that are connected to the same database in a load-balanced scenario use the same virtual directory cache directories on their respective servers.
  1. Stop Internet Information Services (IIS). To do this, open a command prompt, type net stop iisadmin /y, and then press ENTER.
  2. Stop AESecurityService. To do this, open a command prompt, type net stop AESecurityService, and then press ENTER.
  3. Run Update.exe. When Update.exe is executed, you have the choice to back up existing files. Make sure that you have chosen this option so that you can roll back if you have to do so.
  4. Back up and replace the following files:
    • Microsoft Content Management Server\Server\IIS_NR\System\WBC\Internals\Main\WBCCommonShared.inc
    • Microsoft Content Management Server\Server\IIS_NR\System\WBC\Internals\Shared\CommonClient.js
    • Microsoft Content Management Server\Server\IIS_NR\System\WBC\Internals\Shared\CommonServer.inc
  5. To configure MCMS to use a directory other than the default NR virtual directory, you must use Internet Services Manager for IIS to create the new virtual directory hierarchies for the following:
    1. Under the root of the Web site that contains the MCMS entry point, create a virtual directory hierarchy that mirrors the URL prefix that is to be configured for that cluster. Map this virtual directory to C:\Program Files\Microsoft Content Management Server\Server\IIS_NR.
    2. Under the leaf of the new prefix hierarchy, create an NR virtual directory. Map this virtual directory to C:\Program Files\Microsoft Content Management Server\Server\IIS_NR.
    3. Under the leaf of the NR directory, create a RdOnlyRes virtual directory. Map this virtual directory to C:\Program Files\Microsoft Content Management Server\Server\RdOnlyRes.
    4. Under the leaf of the NR directory, create an ExeRes virtual directory. Map this virtual directory to C:\Program Files\Microsoft Content Management Server\server\ExeRes.
  6. Make sure that the virtual directories that you just created are not IIS applications:
    1. Locate each of the virtual directories that you just created in Internet Services Manager. Right-click each directory, and then click Properties.
    2. Click the Virtual Directory tab.
    3. Locate the Application Settings section on the Virtual Directory tab.
    4. Under Application Settings, locate the Application Name text box.
    5. Click Remove.
  7. Use Internet Services Manager to create an MCMS IIS application under the leaf virtual directory of the new prefix hierarchy. Map this application to C:\Program Files\Microsoft Content Management Server\Server\MCMS.
  8. Use Internet Services Manager to create a CMS virtual directory under the MCMS application that you created in step 7. Map this virtual directory to C:\Program Files\Microsoft Content Management Server\Server\IIS_CMS.
  9. Follow step 6 to make sure that this virtual directory is not an IIS application.

    Note The following steps change information in the MCMS database.
  10. Back up the MCMS database.
  11. Run the URLPrefixConfig.exe utility.
  12. In the box that you receive when you run URLPrefixConfig.exe, type the new URL prefix hierarchy for the cluster, starting and ending with a forward slash (/). The new URL prefix hierarchy for the cluster has the same name as the virtual directory hierarchy that you just created. For example, you may type the following:
    • /wireless/
    • /Canada/wireless/LongDistance/
    • /US/WA/LongDistance/
    Note To remove the setting, clear the box.
  13. Click Save.
  14. Start IIS.

Modification Type:MajorLast Reviewed:12/7/2005
Keywords:kbContentMgtServ2002sp1fix kbHotfixServer kbBug kbfix kbQFE KB817925 kbAudDeveloper