| Charles Chan | caebcf3 | 2021-09-20 22:17:52 -0700 | [diff] [blame] | 1 | Troubleshooting Guide |
| 2 | ===================== |
| Charles Chan | bf55e74 | 2021-10-04 17:46:46 -0700 | [diff] [blame^] | 3 | |
| 4 | Frequently Used Commands |
| 5 | ------------------------ |
| 6 | In this section, we are going to introduce a few commands we frequently used when troubleshooting SD-Fabric. |
| 7 | |
| 8 | ONOS |
| 9 | ^^^^ |
| 10 | To execute following ONOS CLI commands, |
| 11 | |
| 12 | - Create K8s port forwarding by `kubectl -n tost port-forward onos-tost-onos-classic-0 8101` |
| 13 | - Login to ONOS CLI by `ssh -p 8101 karaf@localhost`. Default password is `karaf` |
| 14 | |
| 15 | ONOS basics |
| 16 | """"""""""" |
| 17 | - `flows`: List flow tables. `-s` for simplified output. |
| 18 | - `groups`: List group tables. `-s` for simplified output. |
| 19 | - `devices`: List device information. `-s` for simplified output. |
| 20 | - `ports`: List port information. `-e` to list enabled ports only. |
| 21 | - `links`: List discovered links |
| 22 | - `hosts`: List discovered hosts. `-s` for simplified output. |
| 23 | - `netcfg`: List network configuration |
| 24 | - `interfaces`: List interface configuration |
| 25 | |
| 26 | trellis-control |
| 27 | """"""""""""""" |
| 28 | - `sr-pr-list`: List current recovery phase of each device |
| 29 | - `sr-device-subnets`: List device-subnet mapping |
| 30 | |
| 31 | fabric-tna |
| 32 | """""""""" |
| 33 | - `slices`: List network slices |
| 34 | - `tcs`: List traffic classes of given slice |
| 35 | |
| 36 | up4 |
| 37 | """ |
| 38 | - `read-interfaces`: List all interfaces installed in the data plane |
| 39 | - `read-pdrs`: List all PDRs installed in the data plane |
| 40 | - `read-fars`: List all FARS installed in the data plane |
| 41 | - `read-flows`: List all UE data flows installed in the data plane) |
| 42 | |
| 43 | Stratum |
| 44 | ^^^^^^^ |
| 45 | To execute following BF SDE commands, |
| 46 | |
| 47 | - Login to Stratum switch by `ssh root@<switch_ip>`. Default password is `onl` |
| 48 | - Attach to Stratum docker container by `docker attach \`docker ps | grep stratum-bfrt | awk \'{print $1}\'\`` |
| 49 | |
| 50 | - Hit `enter` for the prompt |
| 51 | - Use `<Ctrl-P><Ctrl-Q>` to exit the container. Do not use `<Ctrl-C>` since it will terminate the process. |
| 52 | |
| 53 | BF SDE |
| 54 | """""" |
| 55 | - `pm.show`: List port configurations. `-a` to list all ports. |
| 56 | |
| 57 | K8s troubleshooting |
| 58 | ------------------- |
| 59 | .. |
| 60 | TODO Hung-Wei |
| 61 | |
| 62 | onos-diagnostics |
| 63 | ---------------- |
| 64 | .. |
| 65 | TODO Hung-Wei |
| 66 | |
| 67 | FAQ |
| 68 | --- |
| 69 | .. |
| 70 | TODO Hung-Wei |