Before you can load a custom Knowledge Module (KM) in the BMC ProactiveNet Performance Management environment and configure it through BMC ProactiveNet Central Monitoring Administration, you must build and package the KM.
The PCIG tool builds and packages custom KMs and creates Product Package Files (PPFs), which are required for the build and package (BAP) image. The PCIG tool is supported only in Linux and Windows platforms.
For information about building a KM, see Building a PATROL Knowledge Module Developers Guide.
This topic describes how to use the PCIG tool to create new PPFs.
You can find the PCIG tool installer in the installation utility\bmc_products\tools\pcig directory of the BMC PATROL Installation Utility installer. To start using the PCIG tool for creating a BAP image for custom KMs, perform the following steps :
You can create a BAP image for custom KMs by running the following command:
-p <product_name>—Name of the KM package in the format, [A-Za-z0-9]. It also specifies the output name of the PPF file that will be created. The maximum number of character allowed in the product name is 10.
-r <release>—The version of the package to be used with BMC ProactiveNet in the format, vv.mm.rr .
-s <source_path>—The path required to package member files. The files under source_path are copied to dest_path/products/product_name and zipped, and their respective entries are added under the files section of the ppf. The ppf and cat file are located at dest_path/Products/product_name, and a copy of the PPF is also placed in dest_path/Index/.
-l <os_list>—(Optional.) Comma separated list of OS types. The supported values are: AIX, SOLARIS, HP, LINUX, WINDOWS, ALL, ALL-UNIX. If you have not specified any operating system type, by default, ALL is considered as the value.
-t <product name in BMC ProactiveNet Central Monitoring Repository>—(Optional.) Product name (within double quotes) to be used in the BMC ProactiveNet Central Monitoring Repository. If you have not specified the product name, by default the name of the KM package (value of the -p switch) is considered as the value.
-c—(Optional.) Print copyright details
Here is an example of creating a BAP image for a custom KM, XOM:
Here a BAP image for XOM KM will be created with the name "PATROL for XOM", and the version 1.0.00. After you run the above command, the bmc_products folder will be created in the parent directory (temporary folder).
The bmc_products folder contains files required for building and packaging the KM. To list the files created for building and packaging the KM, run the
find bmc_products -type f command.
Run the following command to see the values created in the PPF file:
The BAP image of the custom KM will be created in a zipped file, and you can import this into BMC Performance Management Repository.
For information on importing a component into BMC Central Monitoring Repository, see .