mpls
LspTrace

Represents a LSP traceroute operation used to determine the path and label mappings of an LSP.



public class LspTrace

Properties
bgpPrefix Specifies the address prefix of the destination node for a testTargetType of bgp. May only be specified when testTargetType is bgp.

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=BGP Prefix (/BGP Prefix)

bgpPrefixLen Specifies the subnet mask of the destination node for a testTargetType of router. May only be specified when testTargetType is bgpPrefix.

type=int
default=32
minimum=32
maximum=128
Displayed(tab/group)=BGP Prefix Length (/BGP Prefix)

bgpPrefixType Specifies the address type for the ldpPrefix.

type=rtr.InetAddressType
access=read-only
default=ipv4

bgpSite The BGP Site to test. May only be specified when testTargetType is bgp.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=BGP Site (/BGP Site)

downMapTlv Specifies the type of downstream mapping TLV in an MPLS echo request PDU (or no downstream mapping TLV). 'dsmap(1)' specifies the Downstream Mapping TLV 'ddmap(2)' specifies the Downstream Detailed Mapping TLV 'none(3)' specifies none of the above TLVs.

type=sas.OamMplsDownMapTlvType
default=dsmap
Displayed(tab/group)=DownStream TLV (Test Parameters/DownStream TLV)

flexAlgoNum The value of flexAlgoNum specifies the Flexible Algorithm to use for the test. Zero indicates no Flexible Algorithm is specified. The supported object combinations for LSP ping tests are listed in the tmnxOamLspPingCtlTable DESCRIPTION clause. tmnxOamLspPingCtlFlexAlgo must not be changed away from default for an SAA test.

type=int
default=0
minimum=0
maximum=255
Displayed(tab/group)=Flex Algo Number (/Lsp Trace Flex Algo)

forwardingClass Specifies the forwarding class the LSP trace will use.

type=qos.FcEnum
default=be
Displayed(tab/group)=Forwarding Class (Test Parameters/Test Probe)

igpInstance Specifies the Interior Gateway Protocol (IGP) instance to be used for the test. Supported IGPs are Intermediate System to Intermediate System (IS-IS) and Open Shortest Path First (OSPF). The supported range varies with the IGP and address family, as follows. IGP Address Family Supported Range ------ -------------- --------------- IS-IS all 0..127 OSPFv2 all 0..31 OSPFv3 IPv4 unicast 64..95 OSPFv3 IPv6 unicast 0..31

type=int
default=0
minimum=0
maximum=127
Displayed(tab/group)=IGP Instance ID (/SR Test Options)

initialTimeToLive Specifies the initial outermost label time-to-live value. This enables bypassing the initial (often well known) portion of a path.

type=int
default=1
minimum=0
maximum=255
Displayed(tab/group)=Initial Time To Live (Test Parameters/Test Probe)

ldpPrefix Specifies the address prefix of the destination node for a testTargetType of router. May only be specified when testTargetType is ldpPrefix.

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=LDP Prefix (/LDP)

ldpPrefixLen Specifies the subnet mask of the destination node for a testTargetType of router. May only be specified when testTargetType is ldpPrefix.

type=int
default=32
minimum=32
maximum=128
Displayed(tab/group)=LDP Prefix Length (/LDP)

ldpPrefixType Specifies the address type for the ldpPrefix.

type=rtr.InetAddressType
access=read-only
default=ipv4

ldpSite The LDP Routing Instance to test. May only be specified when testTargetType is any Lsp.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=LDP Site (/LDP Site)

lsp The LSP to test. May only be specified when testTargetType is lsp or lspPath.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=LSP (/LSP)

lspPath The LSP path to test. May only be specified when testTargetType is lspPath.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=LSP Path (/LSP Path)

maxTimeToLive Specifies the maximum outermost label time-to-live value.

type=int
default=30
minimum=1
maximum=255
Displayed(tab/group)=Maximum Time To Live (Test Parameters/Test Probe)

mplsSite The LSP path to test. May only be specified when testTargetType is lspPath.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=MPLS Site (/MPLS Site)

mplsTpSendMode Specifies the encapsulation of the launched echo request, when testing an MPLS-TP LSP

type=mpls.MplsTpSendMode
default=notApplicable
Displayed(tab/group)=Send Mode (/MPLS-TP Site)

mplsTpSite The MPLS-TP Site to test. May only be specified when testTargetType is tpLsp.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=MPLS-TP Site (/MPLS-TP Site)

nhAddress The value of tmnxOamLspPingCtlNhAddress specifies the Interface address to the next hop in which this OAM LSP ping test will be transmitted. This is an optional parameter which can be specified only if the tmnxOamLspPingCtlPathDest parameter is specified. This parameter is mutually exclusive with tmnxOamLspPingCtlNhIntfName parameter. Either the next-hop interface name or next-hop address can be specified but not both. An attempt to set this object to a non-default value when tmnxOamLspPingCtlNhIntfName has a non-default value will result in an 'inconsistentValue' error.

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=Next Hop Interface Address (/LDP), Next Hop Interface Address (/SR Test Options), Next Hop Interface Address (/BGP Prefix), Next Hop Interface Address (/SR-TE LSP), Next Hop Interface Address (/SR-PL Options)

nhAddressType Specifies the type of Internet address stored in nhAddress.

type=rtr.InetAddressType
access=read-only
default=ipv4

nhIntfName Administrative name of the next hop interface for this OAM LSP Ping test to be sent. The interface name must be unique within the virtual router instance specified by tmnxOamLspPingCtlVRtrID. This is an optional parameter which can be specified only if the tmnxOamLspPingCtlPathDest parameter is specified. This parameter is mutually exclusive with the tmnxOamLspPingCtlNhAddress parameter. Either the next-hop interface name or next-hop address can be specified but not both. An attempt to set this object to a non-default value when tmnxOamLspPingCtlNhAddress has a non-default value will result in an 'inconsistentValue' error."

type=string
default=N/A
minimum=0
maximum=32
Displayed(tab/group)=Next Hop Interface Name (/LDP), Next Hop Interface Name (/SR Test Options), Next Hop Interface Name (/BGP Prefix), Next Hop Interface Name (/SR-TE LSP), Next Hop Interface Name (/SR-PL Options)

pathDest Specifies a unique path for this OAM Lsp Ping to traverse. This address is used as part of a hash key to select the appropriate ECMP path to the destination of an OAM LSP Ping test. This is an optional parameter.

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=Destination Path Address (/LDP), Destination Path Address (/SR Test Options), Destination Path Address (/BGP Prefix), Destination Path Address (/SR-TE LSP), Destination Path Address (/SR-PL Options)

pathDestType Specifies the type of Internet address stored in pathDest

type=rtr.InetAddressType
access=read-only
default=ipv4

prefix Specifies the address prefix of the destination node for tests whose testTargetType require a prefix. Used for OSPF- and ISIS- targeted tests. Could also be used for new target types requiring a prefix, other than BGP- and Router- tests (because of backward compatibility).

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=Prefix (/SR Test Options)

prefixLen Specifies the subnet mask of the destination node for tests whose testTargetType require a prefix. Used for OSPF- and ISIS- targeted tests. Could also be used for new target types requiring a prefix, other than BGP- and Router- tests (because of backward compatibility).

type=int
default=32
minimum=32
maximum=128
Displayed(tab/group)=Prefix Length (/SR Test Options)

prefixType Specifies the prefix address type for tests whose testTargetType require a prefix. Used for OSPF- and ISIS- targeted tests. Could also be used for new target types requiring a prefix, other than BGP- and Router- tests (because of backward compatibility).

type=rtr.InetAddressType
access=read-only
default=ipv4

profile Specifies the profile value to be used with the forwarding class specified in forwardingClass.

type=qos.Profile
default=out
Displayed(tab/group)=Forwarding Profile (Test Parameters/Test Probe)

sourceSite Source node of the LSP to test. May only be specified when testTargetType is OSPF, ISIS, or SR-Policy.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=Site (/SR Test Source Site)

srcIpAddr

type=InetAddress
access=read-only
default=0.0.0.0
Displayed(tab/group)=Source IP Address (/Source IP Address)

srcIpAddrPointer Specify the source IP address. This is defined when the OAM packet must be generated from a different address than the node's system interface address.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=Source IP Address (/Source IP Address)

srcIpAddrType

type=rtr.InetAddressType
access=read-only
default=ipv4

srplEndPointAddr The Segment Routing (SR) policy endpoint address to be used for the SRPL test. leave empty for non-SRPL tests.

type=InetAddress
default=
Displayed(tab/group)=Endpoint Address (/SR-PL Options)

srplEndPointAddrType The address type for srplEndPointAddr. SRPL tests support ipv4' or 'ipv6' types. For other types, use "unknown".

type=rtr.InetAddressType
access=read-only
default=unknown

srplPolicyColor specifies the Segment Routing (SR) policy color to be used for the test. A color associates an SR policy with an intent (e.g. low latency)

type=long
default=0
minimum=0
maximum=4294967295
Displayed(tab/group)=Color (/SR-PL Options)

srplSegmentList The Segment Routing (SR) policy segment list to be used for the test. 0 means "none".

type=int
default=0
minimum=0
maximum=32
Displayed(tab/group)=Segment List (/SR-PL Options)

testSubMode Specifies the type of LSP ping or LSP trace route test to perform.

type=mpls.TestSubMode
default=unspecified

testTargetType Specifies the target type of the LSP trace test. The target may either be an lsp, an lspPath, or a router.

A target of lsp signifies that the targeted test will run against a specific LSP.

A target of lspPath signifies that the targeted test will run against the specified path in an LSP. The lspPath parameter is mandatory when type is lspPath.

A target of router requires the ldpPrefix and ldpPrefixLen parameters to be configured. The targeted test will run on a router and attempt an LSP ping to a destination router(s) specified in the ldpPrefix and ldpPrefixLen.

type=sas.TestTarget
access=read-create
Mandatory on create
Displayed(tab/group)=Target Type

tpLsp The MPLS-TP LSP to test. May only be specified when testTargetType is tpLsp. Administrative name of the target MPLS-TP Labeled Switch Path (LSP) for this OAM MPLS-TP LSP Ping test. The MPLS-TP LSP name must be unique within the virtual router instance specified by vRtrID. This parameter is mutually exclusive with the IP prefix parameter associated with an LDP based MPLS-TP LSP ldpIpPrefix. Either the MPLS-TP LSP name or the LDP IP Prefix must be specified but not both.

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=MPLS-TP LSP (/MPLS-TP LSP)

tpLspPathType The MPLS-TP LSP path type to test. May only be specified when testTargetType is tpLsp.

type=mpls.MplsTpPathType
default=active
Displayed(tab/group)=MPLS-TP LSP Path Type (/MPLS-TP LSP)

vRtrID A number used to identify a virtual router instance in the system

type=int
default=1
minimum=1
maximum=10240

 
Overridden Properties
packetSize The value of packetSize specifies the size of the data portion of the Trace Route request, in octets. The size of the message does not include the SDP encapsulation, VC-Label (if applied) or any DLC headers or trailers. This parameter is optional. When the OAM message is encapsulated in an IP/GRE SDP, the IP 'DF' (Don't Fragment) bit is set. If any segment of the path between the sender and receiver cannot handle the message size, the message is discarded. MPLS LSPs are not expected to fragment the message either, as the message contained in the LSP is not an IP packet. When the data size is specified as 1, it is interpreted as the minumum valid data size for the trace type. The minimum data size (in octets) varies with TestMode, as follows: 'lspTraceRoute' with multipath DSMap 140 'lspTraceRoute' otherwise 104 This parameter is not used by 'ethCfmLinkTrace', 'icmpTraceRoute', 'ldpTreeTrace', or 'mcastTraceRoute'."

default=108
minimum=104

 
Properties inherited from sas.Trace
assurance, maxFailures, maxHistoryRows, packetInterval, packetSize, packetTimeout, packetsToSend, testType, trapGenerationPolicy
 
Properties inherited from sas.Test
accountingFiles, accountingPolicyObjectPointer, aggregatedWith, applicationId, continuousExec, continuously, executionState, fromNodeId, id, lastGeneratedTime, neDeployedTest, nePersistent, neSchedulable, neSchedulableDeployedTest, neSchedulableTest, nmUser, oneTimeValidate, probeHistory, publishTopic, sas.NmThresholdEvent-Set, suppressAccounting, targetIp, testDefinition, testPolicyUsage, testResultStorage, testSuite, testSuiteId, testSuiteTestedEntity, testType, testedEntityName, testedObject, weight
 
Properties inherited from sas.AbstractTest
administrativeState, description, displayedName, failures, globalId, id, lastRunResult, runs, weight
 
Properties inherited from ManagedObject
actionMask, children-Set, deploymentState, isFaultSquelched, name, objectFullName, selfAlarmed
 
Methods inherited from sas.Test
adhocExecuteAndWait, executeAndWait, setNeSchedulableAdminState
 
Methods inherited from sas.AbstractTest
execute, stop
 
Supported Network Elements
7450 ESS
7210 SAS M Supported for all versions
  • Required Capabilities: NetworkMode
7210 SAS T Supported for all versions
  • Required Capabilities: NetworkMode
7210 SAS K Supported for all versions
  • Required Capabilities: NetworkMode
7210 SAS Mxp Supported for all versions
  • Required Capabilities: NetworkMode
7210 SAS S/Sx
7210 SAS X
7210 SAS R
7250 IXR
7750 SR
7705 SAR Gen 2
7705 SAR Hm
7705 SAR
7705 SAR H
DC VSC
DC 7850
DC 210
DC VSA8
7950 XRS
Product Specifics
7210 SAS K 20.0
7210 SAS K 21.0
7210 SAS K 22.0
7210 SAS K 23.0
7210 SAS K 24.0
7210 SAS K 25.0
7210 SAS M 20.0
7210 SAS M 21.0
7210 SAS Mxp 20.0
7210 SAS Mxp 21.0
7210 SAS Mxp 22.0
7210 SAS Mxp 23.0
7210 SAS Mxp 24.0
7210 SAS Mxp 25.0
7210 SAS R 20.0
7210 SAS R 21.0
7210 SAS R 22.0
7210 SAS R 23.0
7210 SAS R 24.0
7210 SAS R 25.0
7210 SAS S/Sx 20.0
7210 SAS S/Sx 21.0
7210 SAS S/Sx 22.0
7210 SAS S/Sx 23.0
7210 SAS S/Sx 24.0
7210 SAS S/Sx 25.0
7210 SAS T 20.0
7210 SAS T 21.0
7210 SAS T 22.0
7210 SAS T 23.0
7210 SAS T 24.0
7210 SAS T 25.0
7250 IXR 20.0
7250 IXR 21.0
7250 IXR 22.0
7250 IXR 23.0
7250 IXR 24.0
7250 IXR 25.0
7450 ESS 20.0
7450 ESS 21.0
7450 ESS 22.0
7450 ESS 23.0
7450 ESS 24.0
7450 ESS 25.0
7705 SAR Gen 2 25.0
7705 SAR H 20.0
7705 SAR H 21.0
7705 SAR H 22.0
7705 SAR H 23.0
7705 SAR H 24.0
7705 SAR H 25.0
7705 SAR H 9.0
7705 SAR Hm 20.0
7705 SAR Hm 21.0
7705 SAR Hm 22.0
7705 SAR Hm 23.0
7705 SAR Hm 24.0
7705 SAR Hm 25.0
7705 SAR 20.0
7705 SAR 21.0
7705 SAR 22.0
7705 SAR 23.0
7705 SAR 24.0
7705 SAR 25.0
7750 SR 20.0
7750 SR 21.0
7750 SR 22.0
7750 SR 23.0
7750 SR 24.0
7750 SR 25.0
7950 XRS 20.0
7950 XRS 21.0
7950 XRS 22.0
7950 XRS 23.0
7950 XRS 24.0
7950 XRS 25.0