Working with the Library.xml File

To modify the documents shown on the "home" page of the PPM Documentation Library:

  1. Copy the <PPM_Home>/pdf/Library.xml file to a "working" location, where the <PPM_Home> placeholder represents the path where your PPM instance was installed. For example: xyzserver/E$/PPMServer.

    Remember that you should have a backup copy of this file stored in a safe location.

  2. Edit the temporary version of the XML file as desired, ensuring that it conforms to the DTD, as described in Working with the Library.xml File.

    Remember that this file must include at least one group in each section (left and right), and at least one document must be included in each group.

    You must include the <document> element for each document you want displayed.

    In rare cases, an existing group or subgroup may not include any documents, making it feasible to remove the <group> or <subhead> elements.

    Alternatively, when there are several documents within a group, you may want to divide the group into subgroups. Conversely, when a collection of subgroups contains very few documents, you may want to remove the subgrouping.

    For example, assume that your site licensed only Deployment Management, does not use the Document Management module, and did not upgrade from a prior version of PPM. One possible presentation of this information is as follows.

    <?xml version="1.0" ?>
    <!DOCTYPE library SYSTEM "Library.dtd">
    <library>
    <leftsection>
        <group>
    <head>
    <htitle>General Interest</htitle></head>
          <document>
    <dtitle>What's New and What's Changed</dtitle>
    <dfn>en/WhatsNew.pdf</dfn>
    </document>
          <document>
    <dtitle>Getting Started</dtitle>
    <dfn>en/GetStart</dfn>
    </document>
          <document>
    <dtitle>Master Index</dtitle>
    <dfn>en/MasterIndex.pdf</dfn>
    </document>
    </group>
        <group>
    <head>
    <htitle>User's Guides</htitle></head>
          <document>
    <dtitle>HP Deployment Management User's Guide</dtitle>
    <dfn>en/DeployUG.pdf</dfn>
    </document>
        </group>
      </leftsection>
      <rightsection>
        <group>
    <head>
    <htitle>System Administration Guides</htitle></head>
          <document>
    <dtitle>System Administration Guide and Reference</dtitle>
    <dfn>en/SysAdmin.pdf</dfn>
    </document>
          <document>
    <dtitle>Upgrade Guide</dtitle>
    <dfn>en/Upgrade.pdf</dfn>
    </document>
          <document>
    <dtitle>System Requirements and Compatibility Matrix</dtitle>
    <dfn>NONE</dfn>
    <dhtm>en/DLC.htm</dhtm>
    </document>
        </group>
        <group>
    <head>
    <htitle>Configuration Guides</htitle></head>
          <document>
    <dtitle>HP Deployment Management Configuration Guide</dtitle>
    <dfn>en/DeployCG.pdf</dfn>
    </document>
          <document>
    <dtitle>Creating Portlets and Modules</dtitle>
    <dfn>en/ConfigSI.pdf</dfn>
    </document>
          <document>
    <dtitle>Customizing the Standard Interface</dtitle>
    <dfn>en/CustomSI.pdf</dfn>
    </document>
        </group>
        <group>
    <head>
    <htitle>General Guides and Reference Manuals</htitle></head>
          <document>
    <dtitle>Commands, Tokens, and Validations Guide and Reference</dtitle>
    <dfn>en/CmdTokVal.pdf</dfn>
    </document>
          <document>
    <dtitle>Reports Guide and Reference</dtitle>
    <dfn>en/Reports.pdf</dfn>
    </document>
          <document>
    <dtitle>Security Model Guide and Reference</dtitle>
    <dfn>en/Security.pdf</dfn>
    </document>
          <document>
    <dtitle>HP-Supplied Entities Guide</dtitle>
    <dfn>en/Entities.pdf</dfn>
    </document>
        </group>
      </rightsection>
    </library>
  3. Save and close the file.

  4. Copy the updated XML file to its original location on the PPM Server, overwriting the existing file.

    You should also place a copy of this updated file in a safe location where it does not overwrite the original (or any previously updated) file.

  5. Ensure that each of the files you specified exists in the applicable directory on the PPM Server (typically, <PPM_Home>/pdf/en).

  6. Verify your changes by opening the PPM Documentation Library page.

    Caution: Test the updated PPM Documentation Library using both Microsoft Internet Explorer and Mozilla Firefox.

    Given the flexibility of the XML elements, you might prefer to organize the documents similar to the following:

    This example uses the following Library.xml file.

    <?xml version="1.0" ?>
    <!DOCTYPE library SYSTEM "Library.dtd">
    <library>
    <leftsection>
        <group>
    <head>
    <htitle>User Guides</htitle></head>
    <subhead>
    <stitle>PPM Center Product Overview</stitle></subhead>
          <document>
    <dtitle>Getting Started</dtitle>
    <dfn>en/GetStart</dfn>
    </document>
          <document>
    <dtitle>Creating Portlets and Modules</dtitle>
    <dfn>en/ConfigSI.pdf</dfn>
    </document>
          <document>
    <dtitle>What's New and What's Changed</dtitle>
    <dfn>en/WhatsNew.pdf</dfn>
    </document>
          <document>
    <dtitle>HP-Supplied Entities Guide</dtitle>
    <dfn>en/Entities.pdf</dfn>
    </document>
          <document>
    <dtitle>Master Index</dtitle>
    <dfn>en/MasterIndex.pdf</dfn>
    </document>
          <subhead><stitle>HP Deployment Management</stitle></subhead>
          <document>
    <dtitle>HP Deployment Management User's Guide</dtitle>
    <dfn>en/DeployUG.pdf</dfn>
    </document>
          <document>
    <dtitle>HP Deployment Management Configuration Guide</dtitle>
    <dfn>en/DeployCG.pdf</dfn>
    </document>
    </group>
      </leftsection>
      <rightsection>
        <group>
    <head>
    <htitle>Reference Guides</htitle></head>
          <document>
    <dtitle>Commands, Tokens, and Validations Guide and Reference</dtitle>
    <dfn>en/CmdTokVal.pdf</dfn>
    </document>
          <document>
    <dtitle>Reports Guide and Reference</dtitle>
    <dfn>en/Reports.pdf</dfn>
    </document>
          <document>
    <dtitle>Security Model Guide and Reference</dtitle>
    <dfn>en/Security.pdf</dfn>
    </document>
    </group>
        <group>
    <head>
    <htitle>System Administration Guides</htitle></head>
          <document>
    <dtitle>System Administration Guide and Reference</dtitle>
    <dfn>en/SysAdmin.pdf</dfn>
    </document>
          <document>
    <dtitle>Upgrade Guide</dtitle>
    <dfn>en/Upgrade.pdf</dfn>
    </document>
          <document>
    <dtitle>Customizing the Standard Interface</dtitle>
    <dfn>en/CustomSI.pdf</dfn>
    </document>
          <document>
    <dtitle>System Requirements and Compatibility Matrix</dtitle>
    <dfn>en/SysReqs.pdf</dfn>
    <dhtm>en/DLC.htm</dhtm>
    <dupd>
    <month>05</month>
    <day> 18</day>
    <year>2008</year>
    </dupd>
    </document>
    </group>
      </rightsection>
    </library>