CCBuilder is the FCMS application that has been developed to guide you through the process of building sDC configuration files. The following examples demonstrate how to build configuration files for FC_RTTable SNMP Data Collectors (sDCs) that send SNMP queries to devices and process and display the retrieved information in tables.
1. Building an sDC that shows the contents of the entire ifTable branch of a device in a simple list.
- Start CCBuilder (Windows start menu).
- Inspect the device by right-clicking on the iso root-node and selecting Inspect.
- After Inspection has finished, right-click on the ifEntry node and select Build | Table. –> Fig1
- Select the Simple list option and press the [Ok] button. –> Fig2
- The ifEntry node has now been added to the targets pane. –> Fig3
- Click on the green [Test] button to start FC_RTTable. –>Fig4
- ..and the FC_RTTable output looks like. –> Fig5
The ifEntry node is a parent node because it has a number of child-nodes. When we selected this node, the “Instance” was automatically set to All-Instances (AI). This way, an sDC collects the information from the target node and all its child nodes!
2. Building a sDC that shows all occurrences of a single child of the ifTable in a list.
In example 1, we used the ifEntry node as a target. We could also have selected the ifTable node which is its parent of ifEntry. It would have made no difference. The result would have been the same! What if we had selected an ifEntry child node?
- Repeat steps 1..2 of example 1, right-click the ifDescr node and select Build | Table. –> Fig10
- Select the Simple list option and press the [Ok] button.
- The ifDescr node has now been added to the targets pane.
- Click on the green [Test] button..and the list looks like. –> Fig11
If “All-instances” is selected, an sDC collects the information of the target node itself and all its children!
3. Building a sDC that only shows specific ifEntry children in a list.
The device that is used for these examples, a Linux box acting as a Virtual Machine host, has multiple interfaces. It is very simple to refine the SNMP query so that only a few particular interfaces are listed. The following example does exactly this. Let’s say we are only interested in the interfaces 2 and 3.
- Repeat steps 1..2 of example 1, right-click the ifDescr node and select Build | Table.
- Select the Simple list option and press the [Ok] button. The ifDescr node has now been added to the targets pane.
- In the Targets pane, click (to select) the line containing the ifDescr target and select “Fixed” from the [Instance type] listbox. –> Fig20
- Click on the Instance speedbutton –> Fig 20a.
- Enter “.2” (without the double quotes but with the dot!) in the input form that pops up and click [Ok]. –> Fig21
- The target pane now looks like Fig22.
- Go back to the MIB tree and click the ifDescr node again but now select [Add this node to the target table] and enter “.3” into the input form and press [Ok]. –> Fig23
- The Targets pane now looks like Fig24.
- Click on the green [Test] button to start FC_RTTable. The list now looks like Fig25.
4. Building a sDC that shows the entire ifTable contents in a table with multiple rows and columns (multi-column).
In example 1 we have built a table that showed the entire ifTable contents in a simple list. Let’s now build an sDC that shows the same information but in a more convenient way!
- Repeat steps 1..3 of example 1 and select the Table (matrix) option and press the [Ok] button.
- All ifEntry child nodes have now been added to the Targets pane. –> Fig40
- Click on the green [Test] button to start FC_RTTable. –> Fig41
The table shows all columns (all ifEntry child nodes) in the table. We can use the SpeedButtons just below the targets-pane to customize a few settings. E.g. click (to select) a row in the Targets pane and click on the [Delete] button (Fig 42 red cross) to delete a column from the table. Use the [Sort] button(Fig 42 green cross) to sort the output table on the contents of a column.