How To
Summary
When you enable the NXAPI feature on Cisco MDS or IBM C-Type switches running NX-OS version 8.4(2) the command may hang and eventually fail.
Objective
Provide a workaround to this problem.
Environment
Any IBM C-Type or Cisco MDS family switch running NX-OS version 8.4(2)
Steps
The NXAPI feature is used on Cisco and IBM C-Type switches to provide an API to the switch. The API allows for NX-OS commands to be run programmatically and output retrieved. IBM products such as IBM Storage Insights use this API. The command to enable the feature is 'feature nxapi' The command normally completes in a few seconds. On some switches, this command may hang for several minutes and then eventually fail. A possible cause for this is the /var system directory is full of log files. You can check for this condition using this command:
show system internal flash
and you will see sample output:
Mount-on 1K-blocks Used Available Use% Filesystem
/var 51200 51200 0 100 none
If this directory is full, you will need to empty files. To do this you need to open a ticket with your switch vendor and escalate to the Cisco TAC for assistance in removing the files
Additional Information
This is a known bug with Cisco NX-OS version 8.4(2) You can find the full Cisco bug notice here. The link contains a full description of the bug as well as versions of NX-OS it is fixed in. The link requires an account with Cisco to view the bug.
Document Location
Worldwide
[{"Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"STAPUZ","label":"Cisco MDS 9132T 32G Fabric Switch"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"STTQV4","label":"Cisco MDS 9148S 16G Multilayer Fabric Switch"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"STMKRM","label":"Cisco MDS 9222i Multi-Service Switch"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"ST5PVM","label":"Cisco MDS 9396S 16G Multilayer Fabric Switch"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"STTQ3Y","label":"Cisco MDS 9513 Multiplayer Director"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"STTQW4","label":"Cisco MDS 9706 Multilayer Director"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"ST2GRX","label":"Cisco MDS 9718 Multilayer Director"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSU6LN","label":"Cisco MDS 9710 Multilayer Director"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"STQQS2","label":"IBM Storage Networking SAN32C-6"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"},{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"STQRS3","label":"IBM Storage Networking SAN48C-6"},"ARM Category":[{"code":"","label":""}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]
Was this topic helpful?
Document Information
Modified date:
27 February 2023
UID
ibm16552964