Configure library layers

You configure the layers for your multi-level libraries by editing the library-layers.xml configuration file.

About this task

In the initial configuration, a single library layer (1) is available. To further define the relationships between libraries and take advantage of the multi-level library feature, you must define additional layers.

Always plan and test scenarios before implementing multi-level libraries in your deployment, because they increase the complexity of your DRM strategy.

Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment.

Procedure

  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the library-layers.xml file in the repository's /system/conf collection.
  3. Check out the file and open it for editing.
  4. Copy an existing <layer> element and edit it to create a new layer.

    Do not modify the default layer 1!

    Attribute Description
    id

    Specifies the level of the library layer.

    Note: The level must be unique within the library-layers.xml configuration file.

    Library layers start at 1, the highest level. You can add as many layers as necessary. A library or product can reference content from a library that is at the same level as a sibling library, or at a lower level as a child library.
    name Contains the descriptive name of the library layer. Related DRM dialogs use it to identify the layer.
    description Contains a short explanation about the library layer.
    isDefault Specifies the layer as the default layer.
    Note: Only one layer can be set as the default, isDefault="yes".

    The default layer is used for backward compatibility. When an existing library version is released, if it does not have a layer level associated to it, it is assigned this default layer.

    Here is an example of a multi-level setup:

    <library>
    <layer id="1" name="library" description="library default layer" isDefault="yes"/>
    <layer id="3" name="Product Library Level" description="Product Library Level" isDefault="yes"/>
    <layer id="6" name="Third Party Library" description="Third Party Library" isDefault="no"/>
    <layer id="9" name="Operating System Library" description="Operating System Library" isDefault="no"/>
</library>
  5. Save, close, and check in the file.
  6. Inform users of the changes.
    The changes are automatically applied once users close and then reopen their CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIA CCMS > Synchronize Configuration. Additionally, refresh IXIA CCMS Web so that users see the change reflected there.