Creating and editing publication filters

Use publication filters to determine which components are published to the cell from BMC Atrium CMDB. The filters select the CIs that satisfy the filter condition from BMC Atrium CMDB. In case the filter is a "Publish me and my providers" filter, the impact providers of the CIs are also selected. For more information, see About publication filters for BMC Atrium CMDB publishing.

You can create publication filters using one of the following configuration item (CI) selection methods:

Static CI selection method: select CIs imported from BMC Atrium CMDB from a static list.
Dynamic CI selection method: select CIs imported from BMC Atrium CMDB that match a specified pattern. The specified pattern uses regular expressions.

Creating static publication filters

In the administrator console, expand the Root > Advanced Options > BMC Atrium CMDB > Publication Filter folder.
Right-click the Publication Filter folder, and select Create Publication Filter.
Enter values for Filter Name and Filter ID.
By default, the Filter ID is the same as the Filter Name, but with spaces removed. For example, if the filter name is CS Filter, the filter ID is CSFilter.
(Optional) Enter a 255-character-or-less description in the Description field.
Select Static (the default) from the CI Selection Method list.
Select (the default) or clear Include all impact providers of selected CIs.
To get the available CIs, select (the default) or clear Show only top level CIs. Top-level CIs are top-level consumers, that is, consumers that are not providers to other CIs.
Select the CI type and click Retrieve. You can further restrict the available CIs by providing a regular expression in the Name field. Regular expressions are case sensitive.
From the list of available CIs, select CIs that you want to show in the service model and click Add, or click Add All to add all the available CIs.
Click OK to close the Create Publication Filter dialog box.

Creating dynamic publication filters

In the administrator console, expand the Root > Advanced Options > BMC Atrium CMDB > Publication Filter folder.
Select and right-click the Publication Filter folder, and select Create Publication Filter.
Enter values for Filter Name and Filter ID.
By default, the Filter ID is the same as the Filter Name, but with spaces removed. For example, if the filter name is CS Filter, the filter ID is CSFilter.
(Optional) Enter a 255-character-or-less description in the Description field.
Select Dynamic from the CI Selection Method list.
Select (the default) or clear Include all impact providers of selected CIs.
Using regular expressions, type a pattern by which to match CI names.
Click the + button to add another pattern. You can use up to eleven patterns. The patterns are connected by a logical AND operator.
Click OK to close the Create Publication Filter dialog box.

Adding service model component types for publication filters

The CI types displayed in the Type list in the Create Publication Filter dialog box are managed by the pronet.admin.cmdb.RootCiTypesForPublicationFilter property in the pronet.conf file.

For example, if you want to add the BMC_ConcreteCollection CI type, in the conf/pronet.conf file, modify the pronet.admin.cmdb.RootCiTypesForPublicationFilter property to add BMC_ConcreteCollection as follows:

#Atrium CMDB CI types for import publication filter.
#RootCiTypesForPublicationFilter=<CiTypeId>,{<CiTypeName>}
pronet.admin.cmdb.RootCiTypesForPublicationFilter=BMC_Application,BMC_ApplicationService,BMC_BusinessService,BMC_BusinessProcess,BMC_ComputerSystem,BMC_DataBase,BMC_Organization,BMC_UserCommunity,BMC_ConcreteCollection

Restart TrueSight Infrastructure Management server after updating the pronet.conf file for the changes to take effect.

For a list of supported service model component types, see Service model component types. You can add additional service model component types (custom CI types or CI types that belong to core CDM or certain CMDB extensions). For more information, see Managing Classes.

Editing publication filters

In the administrator console, expand the Root > Advanced Options > BMC Atrium CMDB > Publication Filter folder.
Select and right-click the publication filter name and select Edit Publication Filter.
Make the required changes and click OK.

When a publication filter's selection criteria are modified, a publication will be executed. Hence, CIs that were previously selected but are no longer selected are removed from the cell (provided they are not selected by another publication filter).

Deleting publication filters

In the administrator console, expand the Root > Advanced Options > BMC Atrium CMDB > Publication Filter folder.
Select and right-click the publication filter name and select Delete Publication Filter.

The publication filter is deleted and the CIs that were published by the filter will no longer be published. These CIs are removed from the cell (provided they are not also selected by another publication filter).

Note

If a filter is deleted, removal from the system could take some time. The amount of time can depend on the number of CIs or other factors, such as an inability to communicate with the cell (as when the cell is not running). During this time the system cannot create another filter with the same filter ID.

Defining publication filters with selection conditions on attributes other than Name

It is possible to define dynamic publication filters with selection conditions on attributes other than Name. However, you cannot do this using the administrator console.

If at start there is a file named pw/server/log/userfilters_sample.xml, you must manually copy the file to the pw/server/log/<publishing_server> directory and rename the file to userfilters.xml.

Newly created user filters are registered for the default publication environment. To delete these filters, unregister from the environment by using the penv set -p "FilterIds=<remaining filterIds>" command. Then delete the filters from the PN:PublishFilters form, and restart the Publishing Server.

The following is a sample of the userfilters.xml file.

<?xml version="1.0" encoding="UTF-8" ?> 
<filters>

 <filter>
  <name>Server ComputerSystems</name> 
  <id>ServerComputerSystems</id> 
  <description>Server ComputerSystems</description> 
  <content version="2">
   <class>BMC_ComputerSystem</class> 
   <importtype>onlymyself</importtype> 
   <selectiontype>dynamic</selectiontype> 
   <selection>
    <condition>
     <attribute>PrimaryCapability</attribute> 
     <operator>Equal</operator> 
     <value>Server</value> 
    </condition>
   </selection>
  </content>
 </filter>

 <filter>
  <name>Cat1 - Item1</name> 
  <id>Cat1Item1</id> 
  <description>Cat1 - Item1</description> 
  <content version="2">
   <class>BMC_BusinessService</class> 
   <importtype>includeproviders</importtype> 
   <selectiontype>dynamic</selectiontype> 
   <selection>
    <and>
     <condition>
      <attribute>Category</attribute> 
      <operator>Equal</operator> 
      <value>Cat1</value> 
     </condition>
     <condition>
      <attribute>Item</attribute> 
      <operator>Equal</operator>
      <value>Item1</value> 
     </condition>
    </and>
   </selection>
  </content>
 </filter>

 <filter>
  <name>Like</name>
  <id>Like</id> 
  <description>Like</description> 
  <content version="2">
   <class>BMC_BusinessService</class>
   <importtype>includeproviders</importtype> 
   <selectiontype>dynamic</selectiontype> 
   <selection>
    <condition>
     <attribute>Category</attribute> 
     <operator>Like</operator> 
     <value>Cat%</value> 
    </condition>
   </selection>
  </content>
 </filter>

 <filter>
  <name>All but Cat1 and Cat2</name> 
  <id>Cat</id> 
  <description>All but Cat1 and Cat2</description> 
  <content version="2">
   <class>BMC_BusinessService</class> 
   <importtype>onlymyself</importtype> 
   <selectiontype>dynamic</selectiontype> 
   <selection>
    <not>
     <or>
      <condition>
       <attribute>Category</attribute> 
       <operator>Equal</operator> 
       <value>Cat1</value> 
      </condition>
      <condition>
       <attribute>Category</attribute> 
       <operator>Equal</operator> 
       <value>Cat2</value> 
      </condition>
     </or>
    </not>
   </selection>
  </content>
 </filter>

</filters>