PPG (PON Protection Groups)
The tolt interface ppg is used to configure PON Protection Groups (PPG). PPGs will allow one PON to protect another PON and take over if there is a failure. It is not recommended to configure a PPG from the CLI. The EMS allows synchronization of the configuration data on the PONS, ONTs, Ethernet and Voice Ports. Without this support, the PPG would not work as intended.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy80MTcwMy81NDk1Mi9ja2ZpbmRlci9pbWFnZXMvcXUvMjAyNS9pbWFnZSgyMzIpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc2NTQ3NjU3OH19fV19&Signature=FEiG8~qev8J0yyAX2S94nfxRjzUZ3Uc5AQ9kJNBYOIYHlayEaTciCrrSgPZkQO7-Q2z9049s-JNnEDRxf2qWT7B2z8aFsRooJ64our6FJS5VZ~kEGmC9Cse5AuioHec15JxHrH9RymJaXp8hUh9DfoHu0VowFwYTkmqRF5Zv0LQQNTfXRvwblin5X0e48n6wknc5uVEG9Ph17AHKGa586B7BdKk7UpQxEGJcn~0FCn~jp0rmpZ6lU48r2N86pQaRWgV~WOcY2g~3xVn-Ps5AmT~Qr5cZWWoHV1PSZqYmX~zlFb93jrhJ0NmwU~GokzRX7dACWTqZ4qrpGwlGi9jd4A__&Key-Pair-Id=K2TK3EG287XSFC)
PPG Interface Attributes
|
Attribute |
Value |
Default |
Required |
Comment |
|
Name |
<string> |
N/A |
Y |
The name of the PPG assigned by the user. |
|
Admin-state |
Enabled | disabled |
Enabled |
N |
Whether the PPG is enabled. |
|
Tid-a |
<string> |
N/A |
Y |
The TID of the OLT for the a side of the ppg.. |
|
Pon-a |
MDS1-1-<pon> |
N/A |
Y |
The PON AID of the a side of the ppg. |
|
Tid-b |
<string> |
N/A |
Y |
The TID of the OLT for the b side of the ppg. |
|
Pon-b |
MDS1-1-<pon> |
N/A |
Y |
The PON aid of the b side of the ppg. |
|
Primary |
A | B |
A |
Y |
Whether the A side or B side is primary |
|
Vid |
1..4094 |
N/A |
Y |
The vlan to used for the sync channel connection between the OLTs. It must be an L2 vlan |
|
Type |
Optical-switch |
Typeb-nonrevertive |
N |
The type of protection supported. Optical switch is historical and no longer supported. Type-b-splitter is for QOIU7, type-b-nonrevertive is the type for OIU8, OLT2 and BOLT. |
|
Wait-to-restore |
0..120 |
60 |
N |
The amount of time after a switch before the system is allowed to switch again. |
|
Ip-a |
x.y.z.w |
N/A |
N |
For future, not supported today. |
|
IP-b |
x.y.z.w |
N/A |
N |
For future, not supported today. |
- Command Path – tolt>interfaces>ppg>
- Module – tolt
- Container – interfaces
- Container – ppg
- Container – config
- Types –
- *name – The name of the PPG assigned by the user
- <string>
- Admin-state – Whether the PPG is enabled..
- <enabled (default) | disabled >
- *Tid-a – The TID of the OLT for the A side of the ppg.
- <string>
- *Pon-a – The PON AID of the A side of the ppg.
- MDS1-1-<pon>
- *Tid-b – The TID of the OLT for the B side of the ppg.
- <string>
- *Pon-b – The PON AID of the B side of the ppg.
- MDS1-1-<pon>
- *Primary – Whether the A side or B side is primary.
- A (default) | B
- *Vid – The vlan to used for the sync channel connection between the OLTs. It must be an L2 vlan
- 1..4094
- Type – The type of protection supported. Optical switch is historical and no longer supported. Type-b-splitter is for QOIU7, type-b-nonrevertive is the type for OIU8, OLT2 and BOLT.
- Optical-switch type-b-splitter | type-b-nonrevertive (default)
- Wait-to-restore – The amount of time after a switch before the system is allowed to switch again.
- 0..120 (default 60)
- ip-a – For future, not supported today.
- x.y.z.w
- ip-b – For future, not supported today.
- x.y.z.w
- *name – The name of the PPG assigned by the user
Show Running Config tolt ppg example
The following command is used to show the configuration of the PPG on an OLT:
- From the MDS1-ESUA# command line, input show running-config tolt interfaces pon config MDS1-1-1, and press Enter. Output similar to the following is displayed:
MDS1-ESUA# show running-config tolt interfaces pon config MDS1-1-1<enter> tolt interfaces pon config MDS1-1-1 user-label "XGSPON Port" admin-state enabled pon-profile-name basic-XGSPON protection-groups [ ppg-pon1 ] ! MDS1-ESUA#_
PPG Actions
Create
PPGs are best created from the EMS console as it can synchronize the configuration on both OLTs. For this to work from CLI the user must first have an identical configuration on both OLTs and then create the PPG on BOTH OLTs.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy80MTcwMy81NDk1Mi9ja2ZpbmRlci9pbWFnZXMvcXUvMjAyNS9pbWFnZSgyMzYpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc2NTQ3NjU3OH19fV19&Signature=oqL~ZIAXrbszr9CXrIhvghoVs~ihbejKVLLyrmnxEsLClTYANkMDzPTrgw0wTKBVPS9RIF3EHQOLsVO1ZyFVEgyanzDVbaAoNLoZkoQIHMof5hPk4qfRhfG0E7d6vW3Zg8Bve~RceZAI-R0zWgoRVOsAlOBgmEh5EMNfjWvKZt1XIplml2onu~w7TeGbkssxjOGtTeH50lm70fGT8xWG5Qut1ISuOcz-DmZ8GZ8r8LUdxvj8AVEMlXjkENybBjNpxRbgt79nO7TFwgN-JuFAxR7QdLwEbzfxIfrZ6qQzcCOS63~U1Bg~1tqQegO1Kyeb9PIzNdYxzOsVg4v0U8AgTg__&Key-Pair-Id=K2TK3EG287XSFC)
PPG Create Attributes
|
Action/Prameter |
Value |
Default |
Required |
Comment |
|
Create |
N/A |
N/A |
N/A |
The set action is used to create PPGs. PPGs should use this action rather than creating directly. |
|
Name |
<string> |
N/A |
Y |
The name of the PPG assigned by the user. |
|
Admin-state |
Enabled | disabled |
Enabled |
N |
Whether the PPG is enabled. |
|
Tid-a |
<string> |
N/A |
Y |
The TID of the OLT for the a side of the ppg.. |
|
Pon-a |
MDS1-1-<pon> |
N/A |
Y |
The PON AID of the a side of the ppg. |
|
Tid-b |
<string> |
N/A |
Y |
The TID of the OLT for the b side of the ppg. |
|
Pon-b |
MDS1-1-<pon> |
N/A |
Y |
The PON aid of the b side of the ppg. |
|
Primary |
A | B |
A |
Y |
Whether the A side or B side is primary |
|
Vid |
1..4094 |
N/A |
Y |
The vlan to used for the sync channel connection between the OLTs. It must be an L2 vlan |
|
Type |
Optical-switch |
Typeb-nonrevertive |
N |
The type of protection supported. Optical switch is historical and no longer supported. Type-b-splitter is for QOIU7, type-b-nonrevertive is the type for OIU8, OLT2 and BOLT. |
|
Wait-to-restore |
0..120 |
60 |
N |
The amount of time after a switch before the system is allowed to switch again. |
|
Ip-a |
x.y.z.w |
N/A |
N |
For future, not supported today. |
|
IP-b |
x.y.z.w |
N/A |
N |
For future, not supported today. |
- Command Path – tolt>interfaces>ppg>create>
- Module – tolt
- Container – interfaces
- Container – ppg
- Action – create
- Types –
- Create – The set action is used to create PPGs. PPGs should use this action rather than creating directly.
- *name – The name of the PPG assigned by the user
- <string>
- Admin-state – Whether the PPG is enabled.
- <enabled (default) | disabled >
- *Tid-a – The TID of the OLT for the A side of the ppg.
- <string>
- *Pon-a – The PON AID of the A side of the ppg.
- MDS1-1-<pon>
- *Tid-b – The TID of the OLT for the B side of the ppg.
- <string>
- *Pon-b – The PON AID of the B side of the ppg.
- MDS1-1-<pon>
- *Primary – Whether the A side or B side is primary.
- A (default) | B
- *Vid – The vlan to used for the sync channel connection between the OLTs. It must be an L2 vlan
- 1..4094
- Type – The type of protection supported. Optical switch is historical and no longer supported. Type-b-splitter is for QOIU7, type-b-nonrevertive is the type for OIU8, OLT2 and BOLT.
- Optical-switch type-b-splitter | type-b-nonrevertive (default)
- Wait-to-restore – The amount of time after a switch before the system is allowed to switch again.
- 0..120 (default 60)
- ip-a – For future, not supported today.
- x.y.z.w
- ip-b – For future, not supported today.
- x.y.z.w
Tolt interface ppg create action example
The following command is used to create a PPG configuration on an OLT:
- From the MDS1-ESUA# command line, input tolt interfaces ppg create admin-state enabled name BigD-PPG-PON1 pon-a MDS1-1-1 pon-b MDS1-1-1 primary A tid-a CIRA4234500001-BIGD-BOLT tid-b CIRA243900009-BIGD-STBY vid 101, and press Enter. Output similar to the following is displayed:
MDS1-ESUA# tolt interfaces ppg create admin-state enabled name BigD-PPG-PON1 pon-a MDS1-1-1 pon-b MDS1-1-1 primary A tid-a CIRA4234500001-BIGD-BOLT tid-b CIRA243900009-BIGD-STBY vid 101 <enter> tolt interfaces pon config MDS1-1-1 action-success true reason MDS1-ESUA# System message at 2025-11-13 12:01:27... Commit performed by internal via tcp using ppg_create. ! MDS1-ESUA#_
Set
The Set action is used to update the PPG once it has already been created.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy80MTcwMy81NDk1Mi9ja2ZpbmRlci9pbWFnZXMvcXUvMjAyNS9pbWFnZSgyMzcpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc2NTQ3NjU3OH19fV19&Signature=MXDx5px2KisSPLNM01ebPXOOQ1v2pj5b78KwIqld65WgXEvTrA0pGxXg8p9Bv7VXGeUgVc9LIezTHyTzwfDV7W9D52BKf7iY6nS05ojdN2jD9l7ZDjJ1vUI131vY0mWjnVEPbKqKhL1OfYGeblG21wq7VbbM6dHzvXDp4LrzYUHuB72BSIMVCsAwozDlV560Z95sOWBzK25-ZmnU0tQt5-3KfQjFSixb9Sa6Hp8Pgxu3GjI-S7R8GQcmdurZk7WPOstw2tEMoFPM6YYIF9aqjC~P~-w-1nXfjy2UFUr21VhzbtwxPPzrC9pUO1iXpfWar5NkzwcKu2WMuCgtBWwhlw__&Key-Pair-Id=K2TK3EG287XSFC)
PPG Set Attributes
|
Action/Prameter |
Value |
Default |
Required |
Comment |
|
Set |
N/A |
N/A |
N/A |
The set action is used to create PPGs. PPGs should use this action rather than creating directly. |
|
Name |
<string> |
N/A |
Y |
The name of the PPG assigned by the user. |
|
Admin-state |
Enabled | disabled |
Enabled |
N |
Whether the PPG is enabled. |
|
Tid-a |
<string> |
N/A |
Y |
The TID of the OLT for the a side of the ppg.. |
|
Pon-a |
MDS1-1-<pon> |
N/A |
Y |
The PON AID of the a side of the ppg. |
|
Tid-b |
<string> |
N/A |
Y |
The TID of the OLT for the b side of the ppg. |
|
Pon-b |
MDS1-1-<pon> |
N/A |
Y |
The PON aid of the b side of the ppg. |
|
Primary |
A | B |
A |
Y |
Whether the A side or B side is primary |
|
Vid |
1..4094 |
N/A |
Y |
The vlan to used for the sync channel connection between the OLTs. It must be an L2 vlan |
|
Type |
Optical-switch |
Typeb-nonrevertive |
N |
The type of protection supported. Optical switch is historical and no longer supported. Type-b-splitter is for QOIU7, type-b-nonrevertive is the type for OIU8, OLT2 and BOLT. |
|
Wait-to-restore |
0..120 |
60 |
N |
The amount of time after a switch before the system is allowed to switch again. |
|
Ip-a |
x.y.z.w |
N/A |
N |
For future, not supported today. |
|
IP-b |
x.y.z.w |
N/A |
N |
For future, not supported today. |
- Command Path – tolt>interfaces>ppg>set>
- Module – tolt
- Container – interfaces
- Container – ppg
- Action – set
- Types –
- Set – The set action is used to create PPGs. PPGs should use this action rather than creating directly.
- *name – The name of the PPG assigned by the user
- <string>
- Admin-state – Whether the PPG is enabled.
- <enabled (default) | disabled >
- *Tid-a – The TID of the OLT for the A side of the ppg.
- <string>
- *Pon-a – The PON AID of the A side of the ppg.
- MDS1-1-<pon>
- *Tid-b – The TID of the OLT for the B side of the ppg.
- <string>
- *Pon-b – The PON AID of the B side of the ppg.
- MDS1-1-<pon>
- *Primary – Whether the A side or B side is primary.
- A (default) | B
- *Vid – The vlan to used for the sync channel connection between the OLTs. It must be an L2 vlan
- 1..4094
- Type – The type of protection supported. Optical switch is historical and no longer supported. Type-b-splitter is for QOIU7, type-b-nonrevertive is the type for OIU8, OLT2 and BOLT.
- Optical-switch type-b-splitter | type-b-nonrevertive (default)
- Wait-to-restore – The amount of time after a switch before the system is allowed to switch again.
- 0..120 (default 60)
- ip-a – For future, not supported today.
- x.y.z.w
- ip-b – For future, not supported today.
- x.y.z.w
Tolt Interface ppg Set Action Example
.This action can be used to modify any of the attributes of the PPG with the exception of the PPG Name.
- From the MDS1-ESUA# command line, input tolt interfaces ppg set name BigD-PPG-PON1 tid-b CIRA243900010-BIGD-STBY, and press Enter. Output similar to the following is displayed:
MDS1-ESUA# tolt interfaces ppg set name BigD-PPG-PON1 tid-b CIRA243900010-BIGD-STBY <enter> action-success false reason Changing TIDs or AIDs in PPG is not permitted MDS1-ESUA#_
Delete
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy80MTcwMy81NDk1Mi9ja2ZpbmRlci9pbWFnZXMvcXUvMjAyNS9pbWFnZSgyMzgpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc2NTQ3NjU3OH19fV19&Signature=dCm19WVRz68FQJxz3yxNMEjxInySaqSpCx85w7lTmLRqQenvvIvs9ZLpgp99Qhqr293s38j9GPNfOvRbvAXKqCCYW6YoK8-ga5JRoHB-mYtKOZh5EnElgPOI61Clpv0N7CpNHXRN2Uyjgt2f0NQN5iO5mghoyPZOV8SrLpe2O2NGZhYq2C3Imen~8mNNHK9UQM2cKkmbTHZH-~wCZeR6C74jOe5BzyzZ5gQh8goYL0uAUukyJcjushtYcEToLSlIPEL9K11psA9GOh3050raRww4UYpfIexRM54bVPMvkzaz~r5NjCvK-Sb9cf9BwlBmkVKiLpORaZrzPY2QFiLzeg__&Key-Pair-Id=K2TK3EG287XSFC)
PPG Delete Attributes
|
Action/Prameter |
Value |
Default |
Required |
Comment |
|
delete |
N/A |
N/A |
N/A |
The delete action is used to delete PPGs. PPGs should use this action rather than deleting directly. |
- Command Path – tolt>interfaces>ppg>delete>
- Module – tolt
- Container – interfaces
- Container – ppg
- Action – delete
- Types –
- delete – The delete action is used to delete PPGs. PPGs should use this action rather than deleting directly.
Tolt interface ppg delete action example
The PPG is deleted by name. This command allows deletion of any PPG.
- From the MDS1-ESUA# command line, input tolt interfaces ppg delete name BigD-PPG-PON1, and press Enter. Output similar to the following is displayed:
MDS1-ESUA# tolt interfaces ppg delete name BigD-PPG-PON1 <enter> action-success true reason MDS1-ESUA#_ System message at 2025-11-13 12:08:43... Commit performed by internal via tcp using ppg_create. MDS1-ESUA# _
Status
Show Tolt interface ppg status
The ppg status member is used to see the current status of one or more PON Protection groups in the system.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy80MTcwMy81NDk1Mi9ja2ZpbmRlci9pbWFnZXMvcXUvMjAyNS9pbWFnZSgyMzkpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc2NTQ3NjU3OH19fV19&Signature=NAug~i73tjYtV3ByFUJYtyuoW194OXo8BO7UFndqOq0dpfqUQZKeZer27KUSYFRdgRurMrFuPMLicUT1QjXudjCA9KsDDu33ScZP~afWrGAN34HiPQ7yM9z7-xLwtt1izWIhenN3U6nkcdWf7z436QtP0fKtAYueDgk7rXgTl56MQYG0I6wUAS0s~vD35oErl6nckXorOaPXLyu8F-H6l4hWGacV6f~uRZqrPxWSbrFmpLZf7YX~wrDt4QdGO51CLA07Xog9xc2QFPIwIf7nQxJYrbXmgXvmnuY-i4bHDZvr7dFh5YNnN4Rio1I3M1MG-zw~JxMFCx2QajcllAPIDw__&Key-Pair-Id=K2TK3EG287XSFC)
PPG Delete Attributes
|
Action/Prameter |
Value |
Comment |
|
Status |
|
The status member of ppg which displays the current status of the ppg(s). |
|
Name |
String |
The name of the PPG whose status is being displayed. |
|
Tid |
String |
The Target Identifier or OLT name that this status is related to. |
|
Local-branch-status |
|
Container for the status |
|
Index |
|
The index of the status entry. |
|
Idd |
|
Identifier of the status member. |
|
State |
|
The current state of this member of the PPG: |
|
Sync-channel-state |
Up |
Summary or aggregate state of sync between the active and standby PON. PONs that are in sync are ready for a rapid switchover. Indicates whether the sync channel is up or down. |
|
Ont-sync-status-list |
|
List of sync statuses for each ONT on the PON. |
|
Index |
|
Entry number in the list |
|
Aid |
|
ONT AID. |
|
Synchronized |
Ont-sync-unknown |
Cannot determine ONT state. |
- Command Path – tolt>interfaces>ppg>status>
- Module – tolt
- Container – interfaces
- Container – ppg
- Action – status
- Types –
- Status – The status member of ppg which displays the current status of the ppg(s).
- name – The name of the PPG whose status is being displayed.
- <string>
- Status – The status member of ppg which displays the current status of the ppg(s).
- Tid – The Target Identifier or OLT name that this status is related to.
- <string>
- Local-branch-status – Container for the status
- Index – The index of the status entry.
- Idd – Identifier of the status member
- State – The current state of this member of the PPG:
- Unknown - Cannot communicate, state unknown
disabled - Admin disabled
active - Enabled and is the active PON
standby - Enabled and is the standby PON
disconnected - Appears to be disconnected from the PON.
- Unknown - Cannot communicate, state unknown
- Sync-channel-state – Summary or aggregate state of sync between the active and standby PON. PONs that are in sync are ready for a rapid switchover. Indicates whether the sync channel is up or down.
- up | down
- Ont-sync-status-list – List of sync statuses for each ONT on the PON.
- Index – Entry number in the list
- Aid – ONT AID.
- Synchronized – The current synchronized state of this member of the PPG:
- Ont-sync-unknown - Cannot determine ONT state.
ont-synchronized - Configuration is synchronized for ONT
ont-unsychronized - Configuration not yet in sync for ONT
- Ont-sync-unknown - Cannot determine ONT state.
Show Tolt interface ppg status example
- From the MDS1-ESUA# command line, input show tolt interfaces ppg status | tab, and press Enter. Output similar to the following is displayed:
MDS1-ESUA# show tolt interfaces ppg status | tab <enter> SYNC CHANNEL NAME TID INDEX ID AID STATE STATE INDEX AID SYNCHRONIZED -------------------------------------------------------------------------------------------------------------------------------------- Corp-PPG CIR0A251900024-CORP-STBY 0 --ERROR-- MDS1-1-1 e-prot-state-standby up 0 MDS1-1-1-2 e-ont-synchronized 0 MDS1-1-1-3 e-ont-synchronized 0 MDS1-1-1-4 e-ont-synchronized MDS1-ESUA# _