oam command

The oam command holds operations, administration, and maintenance tools.

ping subcommand

The ping subcommand is used to run ping and print the results.
Use the ping command to troubleshoot network connectivity. The command starts a flow from the specified processing unit to the destination IP and port. A successful ping returns the status code 0, and writes a report to stdout. An unsuccessful ping returns the status code 1, and writes a report the errors to stderr. The reports contain information about the source and destination. How the command and reports operate depends on whether the destination is a processing unit.
A destination that is not a processing unit must listen to the specified port for a successful response. The connection is immediately set up and then dropped. The report includes detailed information about the source, but only the IP and port of such a destination.
A destination that is a processing unit has an enforcer that handles the flow, and the destination doesn’t have to actively listen to the port. If it is listening on the port the enforcer still consumes the flow. The report includes detailed information about both the source and destination.
Consider the situation where there are two processing units and the admin suspects that there may be a network device within the path that is blocking traffic on port 9000. The admin knows that SSH (port 22) is working so they run the command
apoctl oam ping 5ee5a29939483e4c01a20d7b```
The command succeeds, and you run the following command:
apoctl oam ping 5ee5a29939483e4c01a20d7b```
Because the command fails, you now know that the problem is with the network.
apoctl oam ping 5ee5a29939483e4c01a20d7b apoctl oam ping 5ee5a29939483e4c01a20d7b --verbose

Recommended For You