About CCBuilder

CCBuilder is the GUI-based desktop app for compiling and browsing SNMP MIB files. CCBuilder is the primary tool for building and testing SNMP Data Collector (sDC) configuration files.

sDCs built and tested with CCBuilder can also be uploaded to Quantellium.

CCBuilder is installed as part of the “Full” and “Client” installation modes. To start CCBuilder, select FineConnection MonitorONE G2 | CCBuilder from the Windows Start menu.

sDC stands for SNMP Data Collector. In other network monitor software they are also called “sensors” or “probes”. An sDC compiles and sends SNMP requests and processes the received responses. Results are used in Threshold equations or displayed in graphs or tables.

Discovering the MIB support of a device

CCBuilder can be used to find out which MIBs are supported by a device’s SNMP agent. It uses the FineConnection MIB repository by default to translate SNMP responses into readable text. To discover the MIB support of an agent:

  1. Launch CCBuilder (Start menu | FineConnection MonitorONE G2 | CCBuilder)
  2. Right-click on the ISO node and select Inspect
  3. Enter the requested IP and SNMP parameters in the input fields (see the screenshot)
  4. Click Ok
  5. CCBuilder starts with building the MI tree. This can take some time.

1
2
3
4
5
6
7
8

The row numbers below correspond to the hot spot numbers on the image.

  1. The MIB tree after an inspection of a device
  2. Each time you click a node in the tree, CCBuilder sends an SNMP request to the SNMP agent. The answer to the request is shown here. In this way, testing of a device is made easy.
  3. If you right-click on a node in the tree, you will see a number of options. With the options you can quickly create a graph or table of the clicked node or build more complex data collectors. One of the options is Build | Graph.
  4. This is the Targets pane. A target is a raw SNMP oid selected from the tree or a calculated value (a processed SNMP OID value). sDCs consist of one or more Targets.
  5. These speed buttons allow you to modify Target properties (hide, colorize, use as legend, etc). Before a Target can be modified, it must be selected first.
  6. With the Start button you can test the functioning of the built sDC. You need some knowledge and experience with CCBuilder and SNMP before you can create complex sDCs. We recommend practicing with simple sDCs first (one Target oid).
  7. In addition to interactive sDCs, you can also use CCBuilder to create and upload sDCs for Quantellium. Quantellium sDCs differ at some points from the interactive sDCs. To create a Quantellium sDC, right-click on a node of the MIB tree and select Build | Quantellium. Use the Upload cfg button to upload the sDC configuration to the Quantellium host. In Quantellium, an sDC must be assigned to a Class before it can be used.
  8. After compiling one (or more) MIB files, you can view compilation result logs by selecting the Compiler / Status pane. Click on one of the big buttons Logfile, OID list or Trap list to view detailed registered information.

Compiling MIB files

All applications of the MonitorONE G2 suite use the FineConnection MIB repository. The repository contains more than one hundred thousand pre-compiled MIB objects. Most come from generic rfc MIB files, but there are also a number of pre-compiled company-specific MIBs from well-known suppliers.

The repository is part of the FineConnection website.That is why internet access is a requirement for the proper functioning of the software.

In addition to a MIB browser, CCBuilder is also a MIB compiler. By compiling your own MIBs, you can query almost all equipment that supports SNMP.

MIB files are often nested. They contain references to other MIB files. CCBuilder has built-in algorithms to deal with these references. It is therefore recommended to compile Vendor MIB packs instead of individual files. Follow these steps:

  1. Close CCBuilder (if it is active)
  2. Copy your MIB files to “..{BaseDataDirectory}FCMSCCBuilderCustomMIBS
  3. Start CCBuilder. Compiling starts immediately!
  4. Depending on the number of files in your package, it may take a while before CCBuilder appears!
  5. Open and view the log files to determine if the compilation was successful (screenshot below)

Fix any errors found (add missing MIB files) and repeat compiling by restarting CCBuilder. The compiled MIB objects appear in the MIB tree. Use Inspect to test if a device supports the newly compiled MIB objects .

Deleting unused MIB files / Cleaning up de MIB tree

Starting CCBuilder can be slow if you have added a large number of MIB files to the CustomMIBS folder. Every time you start CCBuilder, all MIBs are recompiled. After you use the MIB tree to browse data collectors or collect data and no longer need it, you can safely remove all or unused MIB files to restore the original speed and performance of CCBuilder. Do not forget to also remove the “_tmp” folders!