blob: 222c934e20fb657e594553cfdb8ed479fd0fa013 [file] [log] [blame]
.. _troubleshooting_guide:
Troubleshooting Guide
=====================
Frequently Used Commands
------------------------
In this section, we are going to introduce a few commands we frequently used when troubleshooting SD-Fabric.
ONOS
^^^^
To execute following ONOS CLI commands,
- Create K8s port forwarding by `kubectl -n tost port-forward onos-tost-onos-classic-0 8101`
- Login to ONOS CLI by `ssh -p 8101 karaf@localhost`. Default password is `karaf`
ONOS basics
"""""""""""
- `flows`: List flow tables. `-s` for simplified output.
- `groups`: List group tables. `-s` for simplified output.
- `devices`: List device information. `-s` for simplified output.
- `ports`: List port information. `-e` to list enabled ports only.
- `links`: List discovered links
- `hosts`: List discovered hosts. `-s` for simplified output.
- `netcfg`: List network configuration
- `interfaces`: List interface configuration
trellis-control
"""""""""""""""
- `sr-pr-list`: List current recovery phase of each device
- `sr-device-subnets`: List device-subnet mapping
fabric-tna
""""""""""
- `slices`: List network slices
- `tcs`: List traffic classes of given slice
up4
"""
- `read-interfaces`: List all interfaces installed in the data plane
- `read-pdrs`: List all PDRs installed in the data plane
- `read-fars`: List all FARS installed in the data plane
- `read-flows`: List all UE data flows installed in the data plane)
Stratum
^^^^^^^
To execute following BF SDE commands,
- Login to Stratum switch by `ssh root@<switch_ip>`. Default password is `onl`
- Attach to Stratum docker container by `docker attach \`docker ps | grep stratum-bfrt | awk \'{print $1}\'\``
- Hit `enter` for the prompt
- Use `<Ctrl-P><Ctrl-Q>` to exit the container. Do not use `<Ctrl-C>` since it will terminate the process.
BF SDE
""""""
- `pm.show`: List port configurations. `-a` to list all ports.
K8s troubleshooting
-------------------
..
TODO Hung-Wei
ONOS diagnostics
----------------
..
TODO Hung-Wei
FAQ
---
..
TODO Hung-Wei