G.8032 ERPS Version 2 Commands
This chapter contains the G.8032 (2012) Ethernet Ring Protection Switching (ERPS) version 2 commands.
aps-channel level
Use this command to set the maintenance entity group (MEG) level (MEL) to carry in R-APS messages.
Command Syntax
aps-channel level <0-7>
Parameters
<0-7>
Level.
Command Mode
G.8032 configure switch mode
Examples
(g8032-config-switch)#aps-channel level 2
aps-channel vlan
Use this command to configure APS channel VLAN-ID for this ERP instance.
Command Syntax
aps-channel vlan <2-4094> (inner-vlan <2-4094>|)
no aps-channel vlan
Parameters
<2-4094>
VLANID
inner-vlan
Inner vlan
<2-4094>
VLANID
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
• (g8032-config-switch)#aps-channel vlan 10 inner-vlan 5
clear g8032 erp-instance
Use this command at the Ethernet ring node for the following operations:
1.Clearing an active local administrative command (forced switch or manual switch).
2.Triggering reversion before the wait to restore (WTR) or wait to block (WTB) timer expires in the case of revertive operation.
3.Triggering reversion in the case of non-revertive operation.
Command Syntax
#clear g8032 erp-instance INSTANCENAME
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#clear g8032 erp-instance INST1
data vlan
Use this command to configure VLANs as data channels.
Use the no form of this command to remove the same.
Command Syntax
data vlan VLAN_RANGE
no data vlan VLAN_RANGE
Parameters
VLAN_RANGE
Enter VLAN ID 2-4094 or list of VLAN ID's separated by commas. Eg 2 or 2,4,5 or 50,51,52 etc.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-config-switch)#data vlan 201,202,203
debug g8032
Use this command to debug configuration.
Command Syntax
debug g8032 (all|tx|rx|fsm|timers|events|external|hal)
no debug g8032 (all|tx|rx|fsm|timers|events|external|hal)
Parameters
all
All debugging options.
events
Protocol event.
external
External CFM and NSM events.
fsm
Instance Finite State Machine updates.
hal
HAL events.
rx
Received PDUs.
timers
Protocol timer events.
tx
Transmitted PDUs.
Command Mode
Configure mode.
Exec mode.
Applicability
This command was introduced in OcNOS version 6.0.0.
Examples
(config)#debug g8032 tx
(config)#debug g8032 all
east-interface
Use this command to set the east port associated to the protection ring.
Command Syntax
east-interface IFNAME
no east-interface
Parameters
IFNAME
Interface name, such as xe1.
Command Mode
G8032 ring config mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(config-if)#g8032 ring RING1
(g8032-ring-config)# east-interface ce1
enable-tcn-propagation
Use this command to enable or disable TCN (topology change notification) propagation for an interconnected ring.
Command Syntax
enable-tcn-propagation
no enable-tcn-propagation
Parameters
None.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced in OcNOS version 6.0.0.
Examples
(g8032-config-switch)#enable-tcn-propagation
erps-instance in subinterface
Use this command to set the erps-instance in subinterface.
Command Syntax
erps-instance (INSTANCENAME | none)
no erps-instance
Parameters
INSTANCENAME
Instance name
none
No ERPS instance will protect this subinterface
Command Mode
Subinterface mode.
Applicability
This command was introduced in OcNOS version 6.2.0.
Examples
OcNOS(config)#interface xe2.1
OcNOS(config-if)#erps-instance ?
INSTANCENAME Instance name
none No ERPS instance will protect this subinterface
OcNOS(config-if)#erps-instance erp1
OcNOS(config-if)#commit
OcNOS(config-if)#
g8032 erp-instance
Use this command to create an ERP instance and change to G.8032 configure switch mode.
Use the no form of this command to delete an ERP instance.
Command Syntax
g8032 erp-instance INSTANCENAME
no g8032 erp-instance INSTANCENAME
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
Command Mode
Configure mode
Examples
#configure terminal
(config)#g8032 erp-instance instance1
(g8032-config-switch)#
g8032 erp-instance force-switch
Use this command to configure administrative commands.
Command Syntax
g8032 erp-instance INSTANCE-NAME force-switch (east-interface | west-interface)
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
east-interface
Apply command to east interface.
west-interface
Apply command to west interface.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#g8032 erp-instance example force-switch east-interface
g8032 erp-instance manual-switch
Use this command to configure administrative commands.
Command Syntax
g8032 erp-instance INSTANCE-NAME manual-switch (east-interface | west-interface)
Parameters
INSTANCENAME
Instance name (maximum 32 characters).
east-interface
Apply command to east interface.
west-interface
Apply command to west interface.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
#g8032 erp-instance example manual-switch west-interface
g8032 ring
Use this command to create a ring and associate east and west interfaces with it. All ERP instances on this ring have the same east and west interfaces,
Use the no form of this command to delete a ring.
Command Syntax
g8032 ring RINGNAME
no g8032 ring RINGNAME
Parameters
ring
Ring.
RINGNAME
Ring name (maximum 37 characters).
Command Mode
Configure mode
Examples
#configure terminal
(config)#g8032 ring ERPS123
(config)#no g8032 ring ERPS123
g8032-profile
Use this command to associate the ERP instance to a profile.
Command Syntax
g8032-profile PROFILENAME
Parameters
PROFILENAME
Profile name.
Command Mode
G.8032 configure switch mode
Examples
(g8032-config-switch)g8032-profile prof_1
g8032 profile
Use this command to associate the ERPS profile to an instance.
Use the no form of this command to delete the ERPS profile from an instance.
Command Syntax
g8032 profile PROFILENAME
Parameters
PROFILENAME
Profile name.
Command Mode
G.8032 configure switch mode
Examples
(g8032-config-switch)g8032-profile prof_1
non-virtual-channel
Use this command to make a sub-ring function without a virtual channel.
Use the no form of this command to delete a non-virtual channel.
Command Syntax
non-virtual-channel
no non-virtual-channel
Parameters
None.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-config-switch)#non-virtual-channel
ring
Use this command to associate the ERP instance to a ring.
Command Syntax
ring RINGNAME
Parameters
RINGNAME
Ring name.
Command Mode
G.8032 configure switch mode
Examples
(g8032-config-switch)#ring ring1
ring-id
Use this command to set the ring identifier.
Command Syntax
ring-id <1-239>
Parameters
<1-239>
Ring identifier.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-config-switch)#ring-id 1
ring-type
Use this command to specify the type of the ethernet ring for this ERP instance.
Command Syntax
ring-type (major-ring | sub-ring | sub-ring-vc)
no ring-type
Parameters
major-ring
G.8032 major ring. In this type of rings nodes are connected in full circular topology
sub-ring
G.8032 sub-ring without virtual channel
sub-ring-vc
G.8032 sub-ring with virtual channel
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-config-switch)#ring-type major-ring
(g8032-config-switch)#ring-type sub-ring-vc
rpl role
Use this command to set the RPL (Ring Protection Link) role of the ring node.
Command Syntax
rpl role ((owner | neighbor | next-neighbor)(east-interface | west-interface) | non-owner )
Parameters
owner
Ring node is the RPL owner.
neighbor
Ring node is neighbor to the RPL owner.
next-neighbor
Ring node is neighbor to the neighbor of the RPL owner.
east-interface
Role assigned to east interface.
west-interface
Role assigned to west interface.
non-owner
Ring node does not own the RPL.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-config-switch)#rpl role owner east-interface
show g8032 all erp-instance
Use this command to display details about all ERP instances.
Command Syntax
show g8032 all erp-instance
Parameters
None
Command Mode
EXEC mode.
Applicability
This command was introduced in OcNOS version 6.0.0.
Example
(config)#show g8032 all erp-instance
Inst Name : instance1
State : G8032_ST_INIT
Phy Ring : -
Role : -
East Link : -
West Link : -
Attached : -
Attached To: -
Virt Chan : -
---------------------------------------------------------------
Channel | Interface | Profile
(LEVL, VID, RID) | (east,ver), (west,ver) |
========================================================
(7, 4065, 135) | (eth11,1), (eth2,2) | PROF1
========================================================
Data Traffic: 1,2,3,10,12...
show g8032 erp-instance
Use this command to display details about an ERP instance.
Command Syntax
show g8032 erp-instance INSTANCENAME
Parameters
INSTANCENAME
Instance name.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Example
(config)#show g8032 erp-instance instance1
Inst Name : instance1
State : G8032_ST_INIT
Phy Ring : -
Role : -
East Link : -
West Link : -
Attached : -
Attached To: -
Virt Chan : -
---------------------------------------------------------------
Channel | Interface | Profile
(LEVL, VID, RID) | (east,ver), (west,ver) |
========================================================
(7, 4065, 135) | (eth11,1), (eth2,2) | PROF1
========================================================
Data Traffic: 1,2,3,10,12...
show g8032 profile
Use this command to display details about a profile.
Command Syntax
show g8032 profile PROFILENAME
Parameters
PROFILENAME
Profile name.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(config)#show g8032 profile profile1
Profile : profile1
=========
Wait-To-Restore : 5 mins
Hold Off Timer : 0 secs
Guard Timer : 500 ms
Wait-To-Block : 5500 ms
Protection Type : Revertive
show g8032 ring
Use this command to display details about a ring.
Command Syntax
show g8032 ring RINGNAME
Parameters
RINGNAME
Ring name.
Command Mode
Exec mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(config)#show g8032 ring ring1
Ring : ring1
==========
East : eth1
West : eth2
ERP Inst : inst1, inst2, inst3
switching mode
Use this command to set the revertive behavior of the ring node.
Command Syntax
switching mode (non-revertive | revertive)
Parameters
revertive
Represents revertive mode operation of a G.8032 ethernet ring.
non-revertive
Represents non-revertive mode operation of a G.8032 ethernet ring.
Command Mode
G.8032 profile configure mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-profile-config)# switching mode revertive
tcn-to-instance
Use this command to associate TCN instance (topology change notification) propagation for an interconnected ring when configured in non-virtual mode.
Command Syntax
tcn-to-instance INSTANCENANME
Parameters
INSTANCENAME
Instance name.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(config)#tcn-to-instance erp1
timer
Use this command to set timers.
Command Syntax
timer (wait-to-restore <1-12> | hold-off <0-10000> | guard-time <10-2000>)
Parameters
wait-to-restore
Wait-to-restore timer used to verify that a signal failure is not intermittent.
<1-12>
Timer value in minutes.
hold-off
Hold-off timer used to filter intermittent link faults.
<0-10000>
Timer value in a multiple of 100 milliseconds.
guard-time
Guard timer that blocks latent outdated messages from causing unnecessary state changes.
<1-20000>
Timer value in a multiple of 10 milliseconds.
Command Mode
G.8032 profile configure mode
Examples
(g8032-profile-config)#timer wait-to-restore 7
(g8032-profile-config)#timer hold-off 50
(g8032-profile-config)#timer guard-time 300
s(g8032-profile-config)#timer guard-time 30
virtual-channel
Use this command on a sub-ring to attach it to a major instance.
Use the no form of this command to delete a virtual channel.
Command Syntax
virtual-channel (<2-4094>|) attached-to-instance INSTANCENAME
no virtual-channel
Parameters
<2-4094>
VLAN identifier.
INSTANCENAME
Major instance name.
Command Mode
G.8032 configure switch mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(g8032-config-switch)#virtual-channel 3 attached-to-instance inst1
west-interface
Use this command to set the west port associated to the protection ring.
Command Syntax
west-interface IFNAME
no west-interface
Parameters
IFNAME
Interface name
Command Mode
G8032 ring config mode.
Applicability
This command was introduced before OcNOS version 5.0.
Examples
(config-if)#g8032 ring RING1
(g8032-ring-config)# west-interface ce1