| Charles Chan | caebcf3 | 2021-09-20 22:17:52 -0700 | [diff] [blame] | 1 | Component Configuration |
| 2 | ======================= |
| Wailok Shum | 2f05cd3 | 2021-09-30 22:18:19 +0800 | [diff] [blame] | 3 | |
| 4 | Different from network configurations, |
| 5 | component configurations are attributes and feature flags specific to ONOS components. |
| 6 | |
| Carmelo Cascone | 4398998 | 2021-10-12 00:01:19 -0700 | [diff] [blame] | 7 | For more details, please check the ONOS Wiki `Component Configuration <https://wiki.onosproject.org/display/ONOS/Component+Configuration>`_ |
| Wailok Shum | 2f05cd3 | 2021-09-30 22:18:19 +0800 | [diff] [blame] | 8 | |
| 9 | Enable/Disable Phased Recovery |
| 10 | ------------------------------ |
| Carmelo Cascone | 4398998 | 2021-10-12 00:01:19 -0700 | [diff] [blame] | 11 | Phased recovery is an experimental feature that aims at minimizing traffic |
| 12 | disruption when recovering from a switch failure. When enabled, a recovering |
| 13 | switch is programmed before pointing traffic from other switches towards it. |
| Charles Chan | 0bc8bf5 | 2021-10-07 12:53:55 -0700 | [diff] [blame] | 14 | |
| Wailok Shum | 2f05cd3 | 2021-09-30 22:18:19 +0800 | [diff] [blame] | 15 | To check current status: |
| 16 | |
| 17 | .. code-block:: console |
| 18 | |
| 19 | onos > cfg get org.onosproject.segmentrouting.phasedrecovery.impl.PhasedRecoveryManager phasedRecovery |
| 20 | name=phasedRecovery, type=boolean, value=false, defaultValue=false, description=Enabling phased recovery. |
| 21 | |
| 22 | |
| 23 | We can see that the default value of phased recovery is false. |
| 24 | Which means it is disabled by default. |
| 25 | |
| 26 | To enable phased recovery: |
| 27 | |
| 28 | .. code-block:: console |
| 29 | |
| 30 | onos > cfg set org.onosproject.segmentrouting.phasedrecovery.impl.PhasedRecoveryManager phasedRecovery true |
| 31 | onos > cfg get org.onosproject.segmentrouting.phasedrecovery.impl.PhasedRecoveryManager phasedRecovery |
| 32 | name=phasedRecovery, type=boolean, value=true, defaultValue=false, description=Enabling phased recovery. |
| 33 | |
| Carmelo Cascone | 4398998 | 2021-10-12 00:01:19 -0700 | [diff] [blame] | 34 | Now the value is true and we have successfully enabled phased recovery. |
| Wailok Shum | 2f05cd3 | 2021-09-30 22:18:19 +0800 | [diff] [blame] | 35 | |
| 36 | To disable phased recovery, change the value to ``false``. |
| 37 | |
| 38 | |
| 39 | .. tip:: |
| Carmelo Cascone | 4398998 | 2021-10-12 00:01:19 -0700 | [diff] [blame] | 40 | Simply run ``cfg get`` in the ONOS CLI to view all available component configurations supported by ONOS. |
| Wailok Shum | 2f05cd3 | 2021-09-30 22:18:19 +0800 | [diff] [blame] | 41 | The default values are fine-tuned for SD-Fabric, and therefore we use them for most of the cases. |