Cisco Catalyst SD-WAN Solution Integrations Guide, Releases 26.x and Later

PDF

Verify that a third-party custom application is operating on a device, using the CLI

Want to summarize with AI?

Log in

Verify that a third-party custom application is running correctly on a device by using CLI commands to check the IOx service status and application state.


This task verifies that a deployed third-party custom application is functioning correctly on a device in the SD-WAN or SD-Routing solutions.

This verification method is applicable to devices in the SD-WAN or SD-Routing solutions.

Before you begin

Deploy a configuration group with a Custom Application feature to one or more devices. See Deploy a configuration group with a custom application feature.

Follow these steps to verify that a third-party custom application is operating on a device using the CLI:

Procedure

1.

On a device running the Cisco IOx application, run this command.

Example:

Device# show iox-service
2.

Based on the output of the command in the previous step, do one of these:

  • If the command output shows that the IOxman service is running, then proceed to the next step.

  • If the command output shows that the IOxman service is not running, this indicates that the Cisco IOx application is not operating correctly. Reinstall the application. See Deploy a configuration group with a custom application feature.

3.

On the same device, run this command. If the output shows the state as running for the application you are checking, this indicates that the application is operating correctly.

Example:

Device# show app-hosting detail appid application-id

The command output displays the application state. If the state shows as RUNNING for the specified application ID, the third-party custom application is operating correctly on the device.

The application name that you enter in the Custom Application feature determines the application ID that appears in the command output. See Create a configuration group profile with a custom application feature. In this example, the application ID is abc.

The command output is truncated here.

Device# show iox-service
IOx Infrastructure Summary:
IOx service (CAF)              : Running
IOx service (HA)               : Not Supported
IOx service (IOxman)           : Running
IOx service (Sec storage)      : Running
Libvirtd 5.5.0                 : Running
Dockerd v19.03.13-ce           : Running

Device# show app-hosting detail appid abc
App id                 : abc
Owner                  : iox
State                  : RUNNING
...