Merge "word-smithing install guide"
diff --git a/profiles/seba/configuration.md b/profiles/seba/configuration.md
index a98975c..780ea1a 100644
--- a/profiles/seba/configuration.md
+++ b/profiles/seba/configuration.md
@@ -128,7 +128,7 @@
device_type: openolt
host: 10.90.0.122
port: 9191
- switch_datapath_id: of:0000000000000002 # the openflow switch to with the OLT is connected
+ switch_datapath_id: of:0000000000000002 # the openflow switch to which the OLT is connected
switch_port: "1" # the port on the switch on which the OLT is connected
outer_tpid: "0x8100"
uplink: "65536"
diff --git a/profiles/seba/install.md b/profiles/seba/install.md
index c3c8dc8..43176f8 100644
--- a/profiles/seba/install.md
+++ b/profiles/seba/install.md
@@ -21,7 +21,7 @@
The main reason to install the SEBA Profile by installing its standalone
components is if you're developing on it and you need granular control.
-There are the components included in the `seba` chart:
+These are the components included in the `seba` chart:
- [VOLTHA and etcd-operator](../../charts/voltha.md)
- [seba-services](../../charts/seba-services.md)
diff --git a/profiles/seba/troubleshoot/no-onus.md b/profiles/seba/troubleshoot/no-onus.md
index 5412c69..02297db 100644
--- a/profiles/seba/troubleshoot/no-onus.md
+++ b/profiles/seba/troubleshoot/no-onus.md
@@ -1 +1,68 @@
# ONUs are not getting discovered
+
+If ONUs are not getting discovered you can debug it following these steps.
+
+## Check ONOS CLI
+
+Check if the ONU is displayed in the ``ports`` command in the ONOS CLI. The portName corresponds to the serial number of the ONU.
+```shell
+onos> ports
+id=of:0000626273696d62, available=true, local-status=connected 4m4s ago, role=MASTER, type=SWITCH, mfr=VOLTHA Project, hw=, sw=, serial=bbsim:50060, chassis=626273696d62, driver=voltha, channelId=172.17.0.16:43266, managementAddress=172.17.0.16, protocol=OF_13
+ port=2064, state=enabled, type=fiber, speed=0 , adminState=enabled, portMac=08:00:00:01:08:10, portName=BBSM00000100
+```
+
+If the port corresponding to the ONU is not displayed or has ``adminState=disabled``, then check the VOLTHA CLI.
+
+## Check VOLTHA CLI
+
+Check if the ONUs shows up in the ``devices`` in VOLTHA CLI, and it is represented in the ``ports`` of the ``logical_device`` in the VOLTHA CLI.
+
+```shell
+(voltha) devices
+Devices:
++------------------+-------------------+------+------------------+---------------+-------------+-------------+----------------+----------------+---------------+------------------------+-------------------------+--------------------------+----------------------+------------------------------+
+| id | type | root | parent_id | serial_number | admin_state | oper_status | connect_status | parent_port_no | host_and_port | reason | proxy_address.device_id | proxy_address.channel_id | proxy_address.onu_id | proxy_address.onu_session_id |
++------------------+-------------------+------+------------------+---------------+-------------+-------------+----------------+----------------+---------------+------------------------+-------------------------+--------------------------+----------------------+------------------------------+
+| 000129f21f7b4032 | openolt | True | 0001626273696d62 | bbsim:50060 | ENABLED | ACTIVE | REACHABLE | | bbsim:50060 | | | | | |
+| 0001969090d72daf | brcm_openomci_onu | True | 000129f21f7b4032 | BBSM00000100 | ENABLED | ACTIVE | REACHABLE | 536870913 | | initial-mib-downloaded | 000129f21f7b4032 | 1 | 1 | 1 |
++------------------+-------------------+------+------------------+---------------+-------------+-------------+----------------+----------------+---------------+------------------------+-------------------------+--------------------------+----------------------+------------------------------+
+(voltha) logical_devices
+Logical devices:
++------------------+------------------+------------------+-----------------+---------------------------+--------------------------+
+| id | datapath_id | root_device_id | desc.serial_num | switch_features.n_buffers | switch_features.n_tables |
++------------------+------------------+------------------+-----------------+---------------------------+--------------------------+
+| 0001626273696d62 | 0000626273696d62 | 000129f21f7b4032 | bbsim:50060 | 256 | 2 |
++------------------+------------------+------------------+-----------------+---------------------------+--------------------------+
+(voltha) logical_device 0001626273696d62
+(logical device 0001626273696d62) ports
+Logical device ports:
++-----------+------------------+----------------+-----------+------------------+----------------------------+---------------+----------------+---------------+---------------------+------------------------+
+| id | device_id | device_port_no | root_port | ofp_port.port_no | ofp_port.hw_addr | ofp_port.name | ofp_port.state | ofp_port.curr | ofp_port.curr_speed | ofp_port_stats.port_no |
++-----------+------------------+----------------+-----------+------------------+----------------------------+---------------+----------------+---------------+---------------------+------------------------+
+| nni-65536 | 000129f21f7b4032 | 65536 | True | 65536 | [0L, 0L, 0L, 1L, 0L, 0L] | nni-65536 | 4 | 4128 | 32 | 65536 |
+| uni-2064 | 0001969090d72daf | 2064 | | 2064 | [8L, 0L, 0L, 1L, 8L, 16L] | BBSM00000100 | 4 | 4160 | 64 | |
++-----------+------------------+----------------+-----------+------------------+----------------------------+---------------+----------------+---------------+---------------------+------------------------+
+```
+
+If the port corresponding to the ONU is not displayed then check the physical OLT. If the port corresponding to the UNI appears in the ``logical_device``, then check the port status of the ONU device:
+
+```shell
+(voltha) device 0001969090d72daf
+(device 0001969090d72daf) ports
+Device ports:
++---------+----------+--------------+-------------+-------------+------------------+-------------------------------------------------------+
+| port_no | label | type | admin_state | oper_status | device_id | peers |
++---------+----------+--------------+-------------+-------------+------------------+-------------------------------------------------------+
+| 100 | PON port | PON_ONU | ENABLED | ACTIVE | 0001969090d72daf | [{'port_no': 2064, 'device_id': u'000129f21f7b4032'}] |
+| 2064 | uni-2064 | ETHERNET_UNI | ENABLED | ACTIVE | 0001969090d72daf | |
++---------+----------+--------------+-------------+-------------+------------------+-------------------------------------------------------+
+```
+If the ``oper_state`` of the port is not ``ACTIVE`` then check the following.
+
+### ONU ``oper_state`` is DISCOVERED
+
+A common reason for the ONU's ``oper_state`` to remain in the ``DISCOVERED`` state is if the ONU's vendor-id is not recognized by any of the ONU adapters in VOLTHA.
+
+### ONU ``oper_state`` is UNKNOWN
+
+The ONU can get into this state if it has been admin disabled.