l2tp
GroupProfile

L2TP Tunnel Group Profiles define the L2TP tunnel configuration which will be used by all L2TP tunnels in this group. The attributes configured here will be overridden by the configuration of the same attribute in the L2TP Tunnel Profile.



public class GroupProfile

Stats:
l2tp.GroupProfileStats

Properties
administrativeState Administrative state for the tunnel group template.

type=netw.AdministrativeState
default=l2tpDown
Displayed(tab/group)=Administrative State

avpHiding Specifies when avpHiding is to be used for the authentication of L2TP tunnels.

type=l2tp.AVPHidingMode
default=never
Displayed(tab/group)=AVP Hiding

challenge Specifies when challenge-response is to be used for the authentication of this L2TP tunnel.

type=l2tp.AlwaysNeverDefault
default=never
Displayed(tab/group)=Challenge

creationOrigin

type=svt.L2RouteOriginType
access=read-create
default=manual

description The description of the tunnel group template.

type=string
default=
minimum=0
maximum=80
Displayed(tab/group)=Description (/Identification)

destructTimeOut The period of time that the data of a disconnected tunnel will persist before being removed.

type=int
default=60
minimum=60
maximum=86400
units=seconds
Displayed(tab/group)=Destruct Timeout

dontFragmentBitLac Specifies if this system sets the DF (Don't Fragment) bit in the IP header of the data traffic sent from the LAC to the LNS. Setting the value of this object 'always', the DF bit is set in upstream traffic. If the value of this object is 'never', the DF bit is cleared in upstream traffic. The value 'default' specifies the value of DF bit from the L2TP Site.

type=l2tp.AlwaysNeverDefault
default=default
Displayed(tab/group)=Do Not Fragment Bit LAC

groupName The name of the tunnel group profile.

type=string
access=read-create
minimum=1
maximum=63
Mandatory on create
Displayed(tab/group)=Group Name (/Identification)

helloInterval The time interval between two consecutive tunnel Hello messages.

type=int
default=-1
minimum=-1
maximum=3600
units=seconds
Displayed(tab/group)=Hello Interval

idleTimeOut The period of time that an established tunnel with no active sessions will persist before being disconnected.

type=int
default=-1
minimum=-1
maximum=3600
units=seconds
Displayed(tab/group)=Idle Timeout

l2tp.GroupDrain-Set type=Children-Set
l2tp.L2TPv3TunnelGroupConfig-Set type=Children-Set
l2tp.MLPPPGroupProfile-Set type=Children-Set
l2tp.PPPGroupProfile-Set type=Children-Set
l2tp.TunnelProfile-Set type=Children-Set
l2tpRadiusAccPlcyPointer Specifies the RADIUS accounting policy to use in this L2TP protocol instance.

type=Pointer
default=
Displayed(tab/group)=L2TP RADIUS Accounting Policy

lnsGroup Specifies the L2TP Integrated Service Adaptor group for this L2TP tunnel.

type=int
default=0
minimum=0
maximum=4
Displayed(tab/group)=LNS Group ID

loadBalanceMethod Specifies the method to be used for load balancing session across ISA MDA in L2TP Tunnel Group. Note : load balance method can be either per session or per tunnel based. No load balance method is not supported.

type=l2tp.LoadBalanceMethodType
default=perSession
Displayed(tab/group)=Load Balance Method

localAddress Specifies the local IP address of this L2TP tunnel.

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=Local IP Address

localAddressType Specifies the address type for the local IP address of this L2TP tunnel.

type=rtr.InetAddressType
default=ipv4

localName The host name used by this system for this L2TP tunnel during the authentication phase of tunnel establishment. This object is related to the RADIUS attribute Tunnel-Client-Auth-ID.

type=string
default=
minimum=0
maximum=64
Displayed(tab/group)=Local Name

maxRetriesEstablished The number of retries allowed for this tunnel, when established, before its control connection goes down.

type=int
default=5
minimum=2
maximum=7
Displayed(tab/group)=Max Retries Established

maxRetriesNotEstablished The number of retries allowed for this tunnel when not established before its control connection goes down.

type=int
default=5
minimum=2
maximum=7
Displayed(tab/group)=Max Retries Not Established

operState Indicates the operational state of this L2TP Tunnel Group.

type=l2tp.GroupOperState
access=read-only
default=drain
Displayed(tab/group)=Operational State

password Password to be used for the authentication of the tunnels in the tunnel group. Note: Because is secure is set to "yes", the password is not visible outside of NFM-P server.

type=string
default=
minimum=0
maximum=64
Displayed(tab/group)=Password

protocolVersion specifies the L2TP protocol version supported in this Layer Two Tunneling Protocol Tunnel Group.

type=l2tp.L2TPProtocolVersion
access=read-create
default=l2tpv2
Displayed(tab/group)=L2TP Protocol Version

receiveWindowSize Specifies the Receive Window Size of the tunnels in this L2TP Tunnel Group

type=int
default=0
minimum=0
maximum=1024
Displayed(tab/group)=Receive Window Size

recoveryMethod Specifies the method to be used for the recovery of stateful information about L2TP tunnels and sessions associated with this tunnel group between this system (performing the LAC role) and its failover peer.

type=l2tp.FailoverRecoveryMethod
default=default
Displayed(tab/group)=Recovery Method (/Failover Information)

recoveryTime Specifies the period of time period of time that an endpoint asks its peer to wait before assuming the recovery process has failed

type=int
default=-2
minimum=-2
maximum=900
units=seconds
Displayed(tab/group)=Recovery Time (/Failover Information)

routerId Router Identifier of the routing protocol site where the Tunnel Group Profile resides.

type=int
access=read-only
default=1
minimum=1
maximum=10240

routingInstancePointer FDN of the routing instance object where the configuration is applicable.

type=Pointer
access=read-only
default=
Displayed(tab/group)=Routing Instance (/Identification)

serviceId NE Service ID for the VPRN service where the group profile is created. It is zero if the group profile is created for the base router.

type=long
access=read-only
default=0

sessionAssignMethod The method to be used for the authentication.

type=l2tp.SessionAssignMethod
default=none
Displayed(tab/group)=Session Assign Method

sessionLimit The maximum number of sessions in this L2TP tunnel. The default session limit is -2 from 11.0 R1.

type=long
default=131071
minimum=1
maximum=250000
Displayed(tab/group)=Session Limit

siteId NE ID where the group profile is created.

type=string
access=read-only
default=
minimum=0
maximum=64
Displayed(tab/group)=Site ID (/Identification)

  
Properties inherited from ManagedObject
actionMask, children-Set, deploymentState, isFaultSquelched, name, objectFullName, selfAlarmed
 
Methods

removePassword

Remove password associated with group profile.
Input Parameters:
deployer : Deployer - the deployment state
synchronousDeploy : boolean - (Optional) Specify whether to block until the changes have been fully deployed to the network. A value of "true" means to block. A value of "false" means to return immediately. Default: false (asynchronous)
clearOnDeployFailure : boolean - (Optional) Specify whether to clear any failed deployers. A value of "true" means to clear. A value of "false" means to leave the failed deployer. Default: false
deployRetries : int - (Optional) The number of times to attempt re-deployment during synchronous deployment. This parameter is meaningless in the asynchronous case. Default: 0
deployRetryInterval : long - (Optional) The number of milliseconds to wait between deployment retries. This parameter is meaningless in the asynchronous case. Default: 0
taskDescription : string - (Optional) A user friendly description of what the operation does. This information will be used by the task manager.
instanceFullName : string - the full name of the object.
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false

retrieveEthernetSessions

Method used to retrieve Ethernet Tunnel session(s) from NE.
Input Parameters:
ethernetTunnelSessStruct : l2tp.L2TPEthernetSessionStruct -
resultFilter : ResultFilter - (Optional) Filter for narrowing down the information returned per object
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false
Output Parameters:
result : List (generic.CommonManagedEntityInformation) -
Exceptions:
l2tp.GroupProfile.retrieveEthernetSessionsException

stopTunnels

Stop all active tunnels in a given group profile.
Input Parameters:
deployer : Deployer - the deployment state
synchronousDeploy : boolean - (Optional) Specify whether to block until the changes have been fully deployed to the network. A value of "true" means to block. A value of "false" means to return immediately. Default: false (asynchronous)
clearOnDeployFailure : boolean - (Optional) Specify whether to clear any failed deployers. A value of "true" means to clear. A value of "false" means to leave the failed deployer. Default: false
deployRetries : int - (Optional) The number of times to attempt re-deployment during synchronous deployment. This parameter is meaningless in the asynchronous case. Default: 0
deployRetryInterval : long - (Optional) The number of milliseconds to wait between deployment retries. This parameter is meaningless in the asynchronous case. Default: 0
taskDescription : string - (Optional) A user friendly description of what the operation does. This information will be used by the task manager.
aInRouterId : int - Router Identifier of the routing protocol site where the Tunnel resides.
aInGroupNameList : List (string) - The name list of the Group Profiles
aInSiteId : string -
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false
Exceptions:
l2tp.GroupProfile.stopTunnelsException
Supported Network Elements
7750 SR
7450 ESS Supported from 8.0.R1
  • Excluded chassis types: 7450-ESS6, 7450-ESS6V
  • Required Capabilities: MixedMode
Product Specifics
7450 ESS 20.0
7450 ESS 21.0
7450 ESS 22.0
7450 ESS 23.0
7450 ESS 24.0
7450 ESS 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