An Oracle ECM Architect Blog

  • February 9, 2011

Changes to File Store Provider in UCM PS3

Kevin Smith
Technical Director

In the recent PS3 release of UCM ( there are some significant changes to the File Store Provider (FSP) configuration. For new PS3 installs (not upgrades from PS2) the FSP default storage rule includes a dispersion rule that will change the web-layout and vault paths by adding dispersion directories to the paths to limit the number of files in the vault and web-layout directories. What that means is that if you install a new PS3 UCM instance and migrate content in from a previous version of UCM the web URL will change. That is a critical problem for web sites and just general document management.

Read the rest of this post where I describe the issue in detaill and provide instructions for how to modify a PS3 instance to use the old format for the web-layout path.In PS2 ( the FSP configuration was the same as in 10gR3. Before you could use the storage rule feature of FSP you had to upgrade the FSP by clicking the Upgrade button on the FSP provider page. To see the FSP page go to the Providers page (Administration -> Providers) and click on the Info link for the DefaultFileStore Provider.


In PS2 you will see that the FSP has an Upgrade button.


In PS3 the FSP is automatically upgraded as part of the base install and you can use the Edit button to view the FSP configuration.


After clicking on the Edit button you will see the Edit File Store Provider page and you can click the Edit Rule button to see the default storage rule.


The default storage rule is displayed and you can see that it now include a dispersion rule.


The default dispersion rule will result in vault and web-layout paths that have extra directory levels to spread the files across more directories. The impact on the Vault path is not important since that is not visible to the users, but the changes to the web-viewable path affects the web URL. Here is an example URL for a content item with the dispersion rules in place.


The storage rule page does not allow you to edit the dispersion rule, web-viewable path or web URL file path. Accordiing to product management this is going to be addressed in a patch. Until then if you want to remove the dispersion rule from the vault and web-layout paths you will need to manually edit the FSP provider.hda file.

If you have already imported content into your PS3 instance follow these steps to remove the displersion rule from the vault and web-layout paths. if you do this before importing any content then you can save yourself the effort of the export and import.

  1. Create an archive and export all the content. Delete all the existing content as part of the export.
  2. Stop the UCM managed server.
  3. Edit the following file:


  4. To change the vault path, replace




  5. To change the web-layout path and web URL, replace




    and replace




  6. Restart the UCM managed server.
  7. Import all the content from the Archive created in step #1.
  8. Validate the web-viewable URL no longer contains the dispersion directories.
  9. Check in a new content item and validate the web-viewable URL no longer contains the dispersion directories.

Join the discussion

Comments ( 10 )
  • guest Wednesday, May 18, 2011
    What is mdaw, and why are there two of them?
  • guest Wednesday, May 18, 2011
    mdaw comes from the Dispersion rule
    This uses certain digits of the dRevClassID and :b encodes it.
    Once you get a lot of content checked in your will see something like this in your vault or weblayout using the new storage rule.
    .../ucm/cs/weblayout/groups/public/documents/digitalmedia/mdaw> ll
    total 32
    drwxrwxr-x 3 oracle dba 4096 Mar 30 16:53 mda0
    drwxrwx--- 3 oracle dba 4096 Mar 31 14:11 mda1
    drwxrwx--- 3 oracle dba 4096 Apr 5 13:57 mda2
    drwxrwx--- 3 oracle dba 4096 Apr 9 15:35 mda5
    drwxrwxr-x 3 oracle dba 4096 Mar 30 10:17 mdaz
    drwxrwx--- 3 oracle dba 4096 Apr 27 08:38 mde0
    drwxrwx--- 3 oracle dba 4096 Apr 27 12:49 mde1
    drwxrwx--- 3 oracle dba 4096 Apr 26 16:11 mdez
  • guest Friday, May 20, 2011
    Which document describes the usage of the brackets, e.g. [-9:-6:0:b] in the dispersion rule. I wonder how to get the first character of the a string, [-3:0:0] won't work? Thanks.
  • Kevin Friday, May 20, 2011
    There is a description of the dispersion rule syntax in the System Admin Guide. See section Limiting the Number Files in a Directory. http://download.oracle.com/docs/cd/E21764_01/doc.1111/e10792/c02_settings.htm#BEICFCEI
  • guest Tuesday, July 12, 2011

    How do I proceed using UCM10g? Any dispersion rules available? We have millions of content items and more than 100,000 items per folder. Thanks in advance

  • Kevin Monday, July 18, 2011

    In UCM 10g you can create your own dispersion rule using portions of the dID to generate directoryt levels in the vault and weblayout paths.

    Update the FSP paths as follows:





    Web URL:


    The syntax for the usage of the dID variable, e.g., $dID[-12:-10:0], is explained in the 10g FSP manual. The example above will create a layout with at most 10,000 files or sub-directories per directory.

  • guest Tuesday, August 2, 2011

    Ok, but where should I change the value of the variable env.VaultDir?

  • Bryan Tuesday, October 25, 2011

    I am trying to do complete the steps you listed... but I'm getting an error on import

    "Import error for archive 'all_content' in collection 'ucmdev': Unable to execute service INSERT_NATIVE and function docRefinery.

    The path metadata for rule 'default' and storage class 'web' is missing."

    Not sure where to go from here. I know all my dev content is gone... and that worries me a bit.

  • guest Thursday, April 18, 2013

    We will be upgrading to 11g PS5 from 10g. Is it possible to import existing content from 10g without the dispersion rule so url for existing content does not change, but apply the dispersion for any new content?


  • Kevin Smith Tuesday, April 23, 2013

    Yes, I don't know if it exists in PS5, but in PS6 there is a storage rule called "Web Asset" that does not have a dispersion rule. If this exists in PS5 you could use it when importing your content. If it does not exist in PS5 then you can add a rule of your own that does not have a dispersion rule and will keep the same path as the 10g UCM system.

    Either way you will need to use an import map in Archiver to set the storage rule field for the content you are migrating into 11g. If you don't do this it will get 11g default storage rule which has a dispersion rule.

    BTW, is later version of 11g the default value for the xStorageRule field is no longer "default" but is now DispByContentId.

Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.