Specify Paths of Configuration Documents

The path to a configuration document does not refer to the path to the file on the host's file system, but to the topological path between the consumer deployable and the configuration document.

By default, if a path is not specified, it is assumed that the configuration document is connected by a composition link to the deployable. In other words, it is assumed that the deployable component CI owns the configuration document CI.

To specify a different path:

1. Define a TQL query as specified in Define TQL Queries.

2. Reference the TQL query from the configuration document using the <DocumentCILocation> element, like this:

   <TextConfigurationDocument name="cmdb.properties">
      <DocumentCILocation>
         <ReferenceLocation>YourQueryName</ReferenceLocation>
      <DocumentCILocation>
      <Condition>
         ...
      </Condition>
   </TextConfigurationDocument>
   

   In this example, YourQueryName is a reference to the query name in the <Queries> section.

When you build the TQL query to specify the path:

• The TQL query must define a path between the deployable component and the configuration document. This path must be simple (no cycles).

• The TQL query must include the following two end nodes with these specific and case-sensitive names:

  • Deployable – the deployable component CI in the path
  • Configuration_document – the CI in the path that specifies the configuration document
• Conditions are not permitted on the Deployable and Configuration_document nodes.
• Cardinalities between all nodes must be 1..1.
• Only a regular link type is supported. No compounds, joins, or sub-graphs are allowed.