Extending a Vendor Certification (VC) in CA Performance Management (CAPM) to add an OID or expression to a metric

Products

• CA Infrastructure Management
• CA Performance Management - Usage and Administration
• DX NetOps

Issue/Introduction

We have a custom vendor cert where the OID is wrong and needs to be changed.  How can we change the OID to reflect the correct value for our metric?

Environment

DX NetOps CAPM all releases

Resolution

Using a REST Client:

1. Go to http://DA:8581/typecatalog/certifications/snmp/extension/<VC internal name> using a "GET" method in the REST client
   
   - where <VC internal name> is the internal name of the VC you want to change
   
   
2. Copy the output to a text editor like Notepad ++
   
   
3. Make the appropriate changes to the OID's in question and then update the vendor cert by using a "PUT" method against the URL from step #1

For example, say you wish to add an expression to a metric that lacks. in this case, PhysicalMemoryUtilization from the F5 BigIP Server MIB:

What you would do is first GET the MIB:

https://<DA_HOST>:8582/typecatalog/certifications/snmp/F5BigIPServerMib

This will return the XML for the MIB which you then edit.

The expression to use is (assuming the OID is just physical):

<Expression destAttr="PhysicalMemoryUtilization">snmpProtectedDiv( sysHostMemoryUsed, sysHostMemoryTotal ) * 100.0</Expression>

Edit the XML representing the MIB retrieved by the GET request to add this expression:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--Auto-generated by the type catalog local manager.-->
<DataModel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" namespace="http://im.ca.com/certifications/snmp" xsi:noNamespaceSchemaLocation="SNMPCertificationFacet.xsd">
    <Author>CA</Author>
    <Version>1.1</Version>
    <FacetType name="F5BigIPServerMib" descriptorClass="com.ca.im.core.datamodel.certs.CertificationFacetDescriptorImpl">
        <Documentation>Support for F5 BigIP Server</Documentation>
        <FacetOf namespace="http://im.ca.com/core" name="Item"/>
        <DisplayName>F5 BigIP Server</DisplayName>
        <MIB>F5-BIGIP-SYSTEM-MIB</MIB>
        <Protocol>SNMP</Protocol>
        <AttributeGroup name="F5BigIpServerGroup" external="true" list="true">
            <Documentation/>
            <Attribute name="Index" type="ObjectID">
                <Documentation/>
                <IsKey>true</IsKey>
                <IsIndex>true</IsIndex>
                <Source>1.3.6.1.4.1.3375.2.1.7.1.1</Source>
            </Attribute>
            <Attribute name="sysHostMemoryTotal" type="Long">
                <Documentation/>
                <IsKey>false</IsKey>
                <NeedsDelta>false</NeedsDelta>
                <Source>1.3.6.1.4.1.3375.2.1.7.1.1</Source>
            </Attribute>
            <Attribute name="sysHostMemoryUsed" type="Long">
                <Documentation/>
                <IsKey>false</IsKey>
                <NeedsDelta>false</NeedsDelta>
                <Source>1.3.6.1.4.1.3375.2.1.7.1.2</Source>
            </Attribute>
            <Attribute name="sysProductVersion" type="String">
                <Documentation/>
                <IsKey>false</IsKey>
                <NeedsDelta>false</NeedsDelta>
                <Source>1.3.6.1.4.1.3375.2.1.4.2</Source>
            </Attribute>
        </AttributeGroup>
        <Expressions>
            <ExpressionGroup destCert="{http://im.ca.com/normalizer}NormalizedGenericSystemInfo" name="F5BigIpServerDS">
                <Expression destAttr="Indexes">Index</Expression>
                <Expression destAttr="Names">"F5-BigIP-Mem-Server"</Expression>
                <Expression destAttr="Descriptions">"F5-BigIP-Mem-Server-Ver: " + sysProductVersion</Expression>
                <Expression destAttr="TotalPhysicalMemory">sysHostMemoryTotal</Expression>
                <Expression destAttr="PhysicalMemoryUsed">sysHostMemoryUsed</Expression>
                <Expression destAttr="PhysicalMemoryUtilization">snmpProtectedDiv( sysHostMemoryUsed, sysHostMemoryTotal ) * 100.0</Expression>
            </ExpressionGroup>
        </Expressions>
    </FacetType>
</DataModel>

Then load this back by doing a PUT on the same URL. This will add the expression to the metric:

Additional Information

For a custom vendor cert you can update the vendor cert.  However, you can not do this to an out of the box cert.  To change an out of the box cert you must do an extension

TechDocs : DX NetOps CAPM 22.2 : Create or Extend Vendor Certifications