Class vnic:LanConnTempl (CONCRETE)

Class ID:161
Encrypted: false - Exportable: true - Persistent: true
Privileges: [admin, ls-network, ls-network-policy]
SNMP OID: .1.3.6.1.4.1.9.9.719.1.133.51

A vNIC template is a policy that defines how a vNIC on a server connects to the LAN.

You can bind a vNIC associated with a service profile to a vNIC template. When you bind the vNIC to a vNIC template, Cisco UCS Manager configures the vNIC with the values defined in the vNIC template. If the existing vNIC configuration does not match the vNIC template, Cisco UCS Manager reconfigures the vNIC. You can only change the configuration of a bound vNIC through the associated vNIC template. You cannot bind a vNIC to a vNIC template if the service profile that includes the vNIC is already bound to a service profile template.


Naming Rules
RN FORMAT: lan-conn-templ-[name]

    [1] PREFIX=lan-conn-templ- PROPERTY = name




DN FORMAT: 

[0] org-[name]/lan-conn-templ-[name]

                



Containers Hierarchies
top:Root This class represents the root element in the object hierarchy. All managed objects in the system are descendants of the Root element.
 ├
org:Org
 
 ├
vnic:LanConnTempl


Contained Hierarchy
vnic:LanConnTempl
 ├
fabric:ANetGroupRef
 ├
fault:Inst An abnormal condition or defect at the component, equipment, or sub-system level which may lead to a failure, as defined in ISO/CD 10303-226.
 ├
vnic:DynamicConPolicyRef Policy Reference objects referring to VF connection policy.
 
 ├
fault:Inst An abnormal condition or defect at the component, equipment, or sub-system level which may lead to a failure, as defined in ISO/CD 10303-226.
 ├
vnic:EtherIf A logical Ethernet Interface connected to a single Layer 2 network. Multiple vnic:EtherIf instances can belong to a single network adapter. For example, to create a service profile with one network adapter configured in trunk mode, add a vnic:Ether MO, which represents the network adapter. Then add a vnic:EtherIf MO as a child of vnic:Ether for each VLAN that you want to expose to the network adapter.
 
 ├
fabric:NetflowIPv4Addr Represents the source ip-address of the SVI on a given fabric. this is in turn used by the exporter vNICs on sereno. Separate vNICs are used per fabric interconnect for exporting flow records to the external collector using the same user specified VLAN. A different source ip is used for each of these vNIC.
 
 ├
fault:Inst An abnormal condition or defect at the component, equipment, or sub-system level which may lead to a failure, as defined in ISO/CD 10303-226.
 
 ├
vnic:IPv4If Represents a network end-point configured with an IPv4 Interface. An IP interface can be provisioned using a user-specified static address, a pool of IP addresses or through DHCP. Optionally, the IPv4 interface may be provisionned with a default gateway, static routes and DNS servers.
 
 
 ├
vnic:IPv4Dhcp Represents an IPv4 interface which is configured at run-time through DHCP.
 
 
 ├
vnic:IPv4Dns Represents the IP address of a DNS server, which is used to resolve host names to IP addresses.
 
 
 ├
vnic:IPv4StaticRoute Represents a statically configured IPv4 route entry. A static route is configured by specifying a destination network and next hop router.
 
 
 ├
vnic:IfRole An abstract base class representing the role(s) assigned to the IP interface
 
 
 ├
vnic:IpV4Addr An abstract base class for IP v4 addresses.
 
 
 ├
vnic:IpV4PooledAddr Represents the IPv4 address of an IP interface, where the IP address is obtained from a pool of IP addresses.
 
 
 
 ├
fault:Inst An abnormal condition or defect at the component, equipment, or sub-system level which may lead to a failure, as defined in ISO/CD 10303-226.
 
 
 
 ├
vnic:IpV4History A temporary object used to hold the history of ipv4 address of MOs.
 
 
 ├
vnic:IpV4StaticAddr Represents a statically assigned IPv4 address.
 ├
vnic:FcOEIf a vnic can contain only one fcoeif
 ├
vnic:UsnicConPolicyRef Policy Reference objects referring to usnic connection policy.
 
 ├
fault:Inst An abnormal condition or defect at the component, equipment, or sub-system level which may lead to a failure, as defined in ISO/CD 10303-226.
 ├
vnic:VmqConPolicyRef Policy Reference objects referring to vmq connection policy.
 
 ├
fault:Inst An abnormal condition or defect at the component, equipment, or sub-system level which may lead to a failure, as defined in ISO/CD 10303-226.

Inheritance
naming:NamedObject
 ├
policy:Object
 
 ├
policy:Definition
 
 
 ├
vnic:Templ
 
 
 
 ├
vnic:LanConnTempl

Events
                



Faults
                



Fsms
                



Properties Summary
Defined in: vnic:LanConnTempl
naming:Name
          string:Basic
adminCdnName  (vnic:LanConnTempl:adminCdnName)
           NO COMMENTS
vnic:CdnSource
          scalar:Enum8
cdnSource  (vnic:LanConnTempl:cdnSource)
           NO COMMENTS
pool:Name
          string:Basic
identPoolName  (vnic:LanConnTempl:identPoolName)
           Overrides:vnic:Templ:identPoolName
           NO COMMENTS
network:MTU
          scalar:Uint32
mtu  (vnic:LanConnTempl:mtu)
           Host Interface Ethernet MTU is the initial Ethernet MTU value for the host interface when the interface is loaded. The value ranges from 576 to 9000. Ethernet MTU is defined as the max L2 payload of an Ethernet packet, and typically defaults to 1500. The user may adjust the value after the interface is loaded, if the host OS provides tools to change the value NOTE: PALO ONLY FOR NOW/ NOTE: HAS NO EFFECT ON DYNAMIC VNICS
naming:Name
          string:Basic
name  (vnic:LanConnTempl:name)
           Overrides:policy:Object:name | naming:NamedObject:name
           NO COMMENTS
naming:Name
          string:Basic
nwCtrlPolicyName  (vnic:LanConnTempl:nwCtrlPolicyName)
           Overrides:vnic:Templ:nwCtrlPolicyName
           NO COMMENTS
reference:Object operIdentPoolName  (vnic:LanConnTempl:operIdentPoolName)
           NO COMMENTS
reference:Object operNwCtrlPolicyName  (vnic:LanConnTempl:operNwCtrlPolicyName)
           NO COMMENTS
reference:Object operPeerRedundancyTemplName  (vnic:LanConnTempl:operPeerRedundancyTemplName)
           NO COMMENTS
reference:Object operQosPolicyName  (vnic:LanConnTempl:operQosPolicyName)
           NO COMMENTS
naming:Name
          string:Basic
peerRedundancyTemplName  (vnic:LanConnTempl:peerRedundancyTemplName)
           NO COMMENTS
naming:Name
          string:Basic
qosPolicyName  (vnic:LanConnTempl:qosPolicyName)
           Overrides:vnic:Templ:qosPolicyName
           NO COMMENTS
vnic:RedundancyPairType
          scalar:Enum8
redundancyPairType  (vnic:LanConnTempl:redundancyPairType)
           Overrides:vnic:Templ:redundancyPairType
           NO COMMENTS
network:SwitchId
          scalar:Enum8
switchId  (vnic:LanConnTempl:switchId)
           Overrides:vnic:Templ:switchId
           NO COMMENTS
vnic:TemplateType
          scalar:Enum8
templType  (vnic:LanConnTempl:templType)
           Overrides:vnic:Templ:templType
           NO COMMENTS
Defined in: vnic:Templ
reference:Object operStatsPolicyName  (vnic:Templ:operStatsPolicyName)
           NO COMMENTS
naming:Name
          string:Basic
pinToGroupName  (vnic:Templ:pinToGroupName)
           NO COMMENTS
naming:Name
          string:Basic
statsPolicyName  (vnic:Templ:statsPolicyName)
           NO COMMENTS
vnic:TemplateTarget
          scalar:Bitmask8
target  (vnic:Templ:target)
           NO COMMENTS
Defined in: policy:Definition
naming:Descr
          string:Basic
descr  (policy:Definition:descr)
           NO COMMENTS
policy:InternalId
          scalar:Uint32
intId  (policy:Definition:intId)
           NO COMMENTS
scalar:Uint32 policyLevel  (policy:Definition:policyLevel)
           policyLevel is used internally by generic policy server.
policy:PolicyOwner
          scalar:Enum8
policyOwner  (policy:Definition:policyOwner)
           "local" denotes policy created by local policy client, "policy" denotes a policy created by remote policy server.
Defined in: mo:TopProps
mo:ModificationChildAction
          scalar:Bitmask32
childAction  (mo:TopProps:childAction)
          
reference:Object dn  (mo:TopProps:dn)
           The Distinguished Name (dn) unambiguously identifies an object in the system.
The dn provides a fully qualified path from the top of the object tree, all the way to the object. It is built as a sequence of relative names separated by the "/" character.
For example:
< ... dn = "sys/chassis-5/blade-2/adaptor-1" />
reference:RN rn  (mo:TopProps:rn)
           The Relative Name (rn) uniquely identifies an object within a given context.
Note that a dn is comprised of a sequence of relative names. For example, the context "sys/chassis-1/blade-1/adaptor-1/host-eth-2" can be thought of as the following expression:
dn = <root object>/{rn}/{rn}/{rn}/{rn}/{rn}.
The rn can then be used to identify the object (for instance, "adaptor-1") within the context:
<... rn ="../" />
mo:InstSaclType
          scalar:Bitmask8
sacl  (mo:TopProps:sacl)
           The system acl property for each Managed Object. br/> This property is a 8 bit mask and supports the following values :-
a: del
b: mod
c: addchild
d: cascade

By default all Managed Objects have the following permissions
a: del
b: mod
c: addchild
This property is persisted in the db. If this property has a value none
it means, the user has read only permissions on this object.
mo:ModificationStatus
          scalar:Bitmask32
status  (mo:TopProps:status)
           This property controls the life cycle of a managed object

Properties Detail

adminCdnName

Type: naming:Name
Primitive Type: string:Basic
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
    Range:  min: "0"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

cdnSource

Type: vnic:CdnSource
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS
Constants
vnic-name 0 NO COMMENTS
user-defined 1 NO COMMENTS
DEFAULT vnic-name(0) NO COMMENTS

childAction

Type: mo:ModificationChildAction
Primitive Type: scalar:Bitmask32
Units: null
Encrypted: false
Access: implicit
Category: TopLevelChildAction
Property Validators:
Comments:
Constants
deleteAll 16384u NO COMMENTS
ignore 4096u NO COMMENTS
deleteNonPresent 8192u NO COMMENTS
DEFAULT 0 This type is used to

descr

Type: naming:Descr
Primitive Type: string:Basic
Like: naming:Described:descr
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
    Range:  min: "0"  max: "256"
        Allowed Chars:
            Regex: [a-zA-Z0-9\[\]!#$%()*+,-./:;@ _{|}˜?&]+
Comments:
NO COMMENTS

dn

Type: reference:Object
Units: null
Encrypted: false
Access: implicit
Category: TopLevelDn
Property Validators:
Comments:
The Distinguished Name (dn) unambiguously identifies an object in the system.
The dn provides a fully qualified path from the top of the object tree, all the way to the object. It is built as a sequence of relative names separated by the "/" character.
For example:
< ... dn = "sys/chassis-5/blade-2/adaptor-1" />

identPoolName

Type: pool:Name
Primitive Type: string:Basic
Overrides:vnic:Templ:identPoolName
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Policy Reference to: macpool:Pool
Property Validators:
    Range:  min: "0"  max: "32"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

intId

Type: policy:InternalId
Primitive Type: scalar:Uint32
Units: null
Encrypted: false
Access: implicit
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS
Constants
none 0u NO COMMENTS
DEFAULT none(0u) NO COMMENTS

mtu

Type: network:MTU
Primitive Type: scalar:Uint32
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
    Range:  min: (long)1500l  max: (long)9000l
Comments:
Host Interface Ethernet MTU is the initial Ethernet MTU value for the host interface when the interface is loaded. The value ranges from 576 to 9000. Ethernet MTU is defined as the max L2 payload of an Ethernet packet, and typically defaults to 1500. The user may adjust the value after the interface is loaded, if the host OS provides tools to change the value NOTE: PALO ONLY FOR NOW/ NOTE: HAS NO EFFECT ON DYNAMIC VNICS
Constants
defaultValue 1500u NO COMMENTS

name

Type: naming:Name
Primitive Type: string:Basic
Overrides:policy:Object:name  |  naming:NamedObject:name
Units: null
Encrypted: false
Naming Property -- [NAMING RULES]
Access: naming
Category: TopLevelRegular
Property Validators:
    Range:  min: "1"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

nwCtrlPolicyName

Type: naming:Name
Primitive Type: string:Basic
Overrides:vnic:Templ:nwCtrlPolicyName
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Policy Reference to: nwctrl:Definition
Property Validators:
    Range:  min: "0"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

operIdentPoolName

Type: reference:Object
Refers: macpool:Pool
Units: null
Encrypted: false
Access: oper
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS

operNwCtrlPolicyName

Type: reference:Object
Refers: nwctrl:Definition
Units: null
Encrypted: false
Access: oper
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS

operPeerRedundancyTemplName

Type: reference:Object
Refers: vnic:LanConnTempl
Units: null
Encrypted: false
Access: oper
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS

operQosPolicyName

Type: reference:Object
Refers: epqos:Definition
Units: null
Encrypted: false
Access: oper
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS

operStatsPolicyName

Type: reference:Object
Refers: stats:ThresholdPolicy
Units: null
Encrypted: false
Access: oper
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS

peerRedundancyTemplName

Type: naming:Name
Primitive Type: string:Basic
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Policy Reference to: vnic:LanConnTempl
Property Validators:
    Range:  min: "0"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

pinToGroupName

Type: naming:Name
Primitive Type: string:Basic
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
    Range:  min: "0"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

policyLevel

Type: scalar:Uint32
Units: null
Encrypted: false
Access: implicit
Category: TopLevelRegular
Property Validators:
Comments:
policyLevel is used internally by generic policy server.

policyOwner

Type: policy:PolicyOwner
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
Comments:
"local" denotes policy created by local policy client, "policy" denotes a policy created by remote policy server.
Constants
local 0 NO COMMENTS
policy 1 NO COMMENTS
pending-policy 2 NO COMMENTS
DEFAULT local(0) NO COMMENTS

qosPolicyName

Type: naming:Name
Primitive Type: string:Basic
Overrides:vnic:Templ:qosPolicyName
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Policy Reference to: epqos:Definition
Property Validators:
    Range:  min: "0"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS

redundancyPairType

Type: vnic:RedundancyPairType
Primitive Type: scalar:Enum8
Overrides:vnic:Templ:redundancyPairType
Paths: vnic:Template:redundancyPairType
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS
Constants
none 1 NO COMMENTS
primary 2 NO COMMENTS
secondary 3 NO COMMENTS
DEFAULT none(1) NO COMMENTS

rn

Type: reference:RN
Units: null
Encrypted: false
Access: implicit
Category: TopLevelRn
Property Validators:
Comments:
The Relative Name (rn) uniquely identifies an object within a given context.
Note that a dn is comprised of a sequence of relative names. For example, the context "sys/chassis-1/blade-1/adaptor-1/host-eth-2" can be thought of as the following expression:
dn = <root object>/{rn}/{rn}/{rn}/{rn}/{rn}.
The rn can then be used to identify the object (for instance, "adaptor-1") within the context:
<... rn ="../" />

sacl

Type: mo:InstSaclType
Primitive Type: scalar:Bitmask8
Units: null
Encrypted: false
Access: implicit
Category: TopLevelSacl
Property Validators:
Comments:
The system acl property for each Managed Object. br/> This property is a 8 bit mask and supports the following values :-
a: del
b: mod
c: addchild
d: cascade

By default all Managed Objects have the following permissions
a: del
b: mod
c: addchild
This property is persisted in the db. If this property has a value none
it means, the user has read only permissions on this object.
Constants
none 0 NO COMMENTS
del 1 NO COMMENTS
mod 2 NO COMMENTS
addchild 4 NO COMMENTS
cascade 8 NO COMMENTS
DEFAULT 0 NO COMMENTS

statsPolicyName

Type: naming:Name
Primitive Type: string:Basic
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Policy Reference to: stats:ThresholdPolicy
Property Validators:
    Range:  min: "0"  max: "16"
        Allowed Chars:
            Regex: [a-zA-Z0-9_.:-]+
Comments:
NO COMMENTS
Constants
defaultValue "default" NO COMMENTS

status

Type: mo:ModificationStatus
Primitive Type: scalar:Bitmask32
Units: null
Encrypted: false
Access: implicit
Category: TopLevelStatus
Property Validators:
Comments:
This property controls the life cycle of a managed object
Constants
removed 16u In a setter method: specifies that an object should be removed.
In the return value of a setter method: indicates that an object has been removed.
created 2u In a setter method: specifies that an object should be created. An error is returned if the object already exists.
In the return value of a setter method: indicates that an object has been created.
modified 4u In a setter method: specifies that an object should be modified
In the return value of a setter method: indicates that an object has been modified.
deleted 8u In a setter method: specifies that an object should be deleted.
In the return value of a setter method: indicates that an object has been deleted.
DEFAULT 0 This type controls the life cycle of objects passed in the XML API.

When used in a setter method (such as configConfMo), the ModificationStatus specifies whether an object should be created, modified, deleted or removed.
In the return value of a setter method, the ModificationStatus indicates the actual operation that was performed. For example, the ModificationStatus is set to "created" if the object was created. The ModificationStatus is not set if the object was neither created, modified, deleted or removed.

When invoking a setter method, the ModificationStatus is optional:
If a setter method such as configConfMo is invoked and the ModificationStatus is not set, the system automatically determines if the object should be created or modified.


switchId

Type: network:SwitchId
Primitive Type: scalar:Enum8
Overrides:vnic:Templ:switchId
Holder: vnic:RedundantConnectivity
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS
Constants
NONE 0 NO COMMENTS
A 1 NO COMMENTS
B 2 NO COMMENTS
A-B 5 NO COMMENTS
B-A 6 NO COMMENTS
DEFAULT A(1) NO COMMENTS

target

Type: vnic:TemplateTarget
Primitive Type: scalar:Bitmask8
Units: null
Encrypted: false
Access: create
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS
Constants
vm 1 add fcoe
adaptor 2 NO COMMENTS
DEFAULT adaptor(2) NO COMMENTS

templType

Type: vnic:TemplateType
Primitive Type: scalar:Enum8
Overrides:vnic:Templ:templType
Paths: vnic:Template:templType
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:
Comments:
NO COMMENTS
Constants
initial-template 1 NO COMMENTS
updating-template 2 NO COMMENTS
DEFAULT initial-template(1) NO COMMENTS