Configuring ICAM

Cisco Nexus 9000 Platform switches support the Intelligent CAM Analytics and Machine-learning (iCAM) feature. iCAM enables you to:

View traffic and usage analytics per supported function, Ternary Content-Addressable Memory (TCAM) resources, and TCAM entries.
Allows you to plan better by understanding the Ternary Content-Addressable Memory (TCAM) usage per feature, enabling you to use TCAM space effectively.
Verify, detect, plan, and predict your environment against Cisco-verified scale numbers for the different supported functions (Layer 2 switching, unicast routing, multicast routing, and VXLAN).
Maintain historical usage, functional scale analytics of different supported functions, including entries and resource usage of FIB and ACL TCAM.
Predict scale (usage level) monitoring for different supported functions in addition to predicted scale for ACL and FIB TCAM entries.
View health monitoring data (such as CPU, memory, power supply) and information on Intelligent Traffic Director (ITD) services.

The iCAM feature:

Works on most Cisco Nexus 9000 Series switches, line cards and, fabric modules (FMs).
Does not require additional hardware or software.
Provides useful traffic telemetry and analytics. This topic provides an overview on the different capabilities of iCAM.

For more information, see the Cisco Nexus 9000 Series NX-OS iCAM Configuration Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-installation-and-configuration-guides-list.html/

Configuring ICAM

Configuring ICAM

POST http://<mgmt0_IP>/api/mo/sys/fm.json

{
  "fmEntity": {
    "children": [
      {
        "fmIcam": {
          "attributes": {
            "adminSt": "enabled"
}}}]}}

{
    imdata:[]
}

<System>
  <fm-items>
    <icam-items>
      <adminSt>enabled</adminSt>
    </icam-items>
  </fm-items>
</System>

Note: This example was added in Release 9.3(3).

CLI Commands

The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.

feature icam

Verifying a DME Configuration

The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.

MO	DN
fmEntity	sys/fm
fmIcam	sys/fm/icam

fmIcam Properties

The following table contains information about the fmIcam properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
adminSt	fm:AdminState (scalar:Enum8)	Admin status	SELECTION: 1 - enabled 2 - disabled DEFAULT: disabled

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Deleting ICAM

Deleting ICAM

POST http://<mgmt0_IP>/api/mo/sys/fm.json

{
  "fmEntity": {
    "children": [
      {
        "fmIcam": {
          "attributes": {
            "adminSt": "disabled"
}}}]}}

{
    imdata:[]
}

<System>
  <fm-items>
    <icam-items>
      <adminSt>disabled</adminSt>
    </icam-items>
  </fm-items>
</System>