Overview  Containers  Contained  Inheritance  Events  Faults  FSMs  Properties Summary  Properties Detail  Naming 

Class fabric:VCon (CONCRETE)

Class ID:789
Encrypted: false - Exportable: true - Persistent: true
Privileges: [See Containers Hierarchies]
SNMP OID: .1.3.6.1.4.1.9.9.719.1.45.109

Represents a virtual network interface connection (vCon), which is a virtual representation of a physical adapter.

When a vNIC/vHBA placement policy is assigned to a service profile, and the service profile is associated with a server, the vCons in the vNIC/vHBA placement policy are assigned to the physical adapters.
vNICs or vHBAs can be assigned to a vCon. Cisco UCS Manager uses the vCon assignment to determine how to assign the vNICs and vHBAs to the physical adapter during service profile association.

Naming Rules 
RN FORMAT: vcon-[id]

    [1] PREFIX=vcon- PROPERTY = id




DN FORMAT: 

[0] org-[name]/vcon-profile-[name]/vcon-[id]

[1] org-[name]/tier-[name]/ls-[name]/vcon-[id]

[2] org-[name]/ls-[name]/vcon-[id]


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
 
 		 ├
 		fabric:VConProfile A vNIC/vHBA placement policy. vNIC/vHBA placement policies are used to determine what types of vNICs or vHBAs can be assigned to the physical adapters on a server. Each vNIC/vHBA placement policy contains four virtual network interface connections (vCons) that are virtual representations of the physical adapters. When a vNIC/vHBA placement policy is assigned to a service profile, and the service p...
 
 		 
 		 ├
 		fabric:VCon
Privileges: admin, ext-lan-policy, ls-config-policy, ls-network, ls-network-policy, ls-server-policy, ls-storage-policy
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
 
 		 ├
 		ls:Server Logical Server Definition. Holds and Regulates Specification of: identity connectivity applied to the physical compute node like compute:Blade upon association. Logical Server can serve the following purposes: associatable instance initialization template persistent ...
 
 		 
 		 ├
 		fabric:VCon
Privileges: admin, ext-lan-policy, ls-compute, ls-config, ls-config-policy, ls-network, ls-network-policy, ls-server, ls-server-policy, ls-storage-policy
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
 
 		 ├
 		ls:Tier Tier
 
 		 
 		 ├
 		ls:Server Logical Server Definition. Holds and Regulates Specification of: identity connectivity applied to the physical compute node like compute:Blade upon association. Logical Server can serve the following purposes: associatable instance initialization template persistent ...
 
 		 
 		 
 		 ├
 		fabric:VCon
Privileges: admin, ext-lan-policy, ls-compute, ls-config, ls-config-policy, ls-network, ls-network-policy, ls-server, ls-server-policy, ls-storage-policy


Contained Hierarchy
fabric:VCon
Inheritance
fabric:VCon
Events


Faults


Fsms


Properties Summary
Defined in: fabric:VCon
reference:Object equipmentDn  (fabric:VCon:equipmentDn)
           NO COMMENTS
fabric:VConFabricPref
          scalar:Enum8 		fabric  (fabric:VCon:fabric)
           Specifies fabric assignment preference - which vnics terminating on which fabrics should be allocated on this connection
fabric:VConEntityId
          scalar:Enum8 		id  (fabric:VCon:id)
           Identifies this virtual connection.
fabric:VConInstType
          scalar:Enum8 		instType  (fabric:VCon:instType)
           NO COMMENTS
fabric:VConPlacementPref
          scalar:Enum8 		placement  (fabric:VCon:placement)
           NO COMMENTS
mo:PropAclMask
          scalar:Uint64 		propAcl  (fabric:VCon:propAcl)
           NO COMMENTS
fabric:VConSelectPref
          scalar:Enum8 		select  (fabric:VCon:select)
           Specifies whether this connection is reserved for vncis with strict vcon assignment. That is, this connection wil not be used for vnics that are auto-placed.
fabric:VConSharePref
          scalar:Enum8 		share  (fabric:VCon:share)
           NO COMMENTS
fabric:VConTransportPref
          scalar:Bitmask8 		transport  (fabric:VCon:transport)
           Specifies preference of vnics with given transport type. This can be used to restrict eth/fc vnics being placed.
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

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

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" />

equipmentDn

Type: reference:Object
Refers: adaptor:Unit
Units: null
Encrypted: false
Access: oper
Category: TopLevelRegular
Property Validators:

Comments:
NO COMMENTS

fabric

Type: fabric:VConFabricPref
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:

Comments:
Specifies fabric assignment preference - which vnics terminating on which fabrics should be allocated on this connection
Constants
NONE 0 NO COMMENTS
any 0 NO COMMENTS
A 1 NO COMMENTS
B 2 NO COMMENTS
DEFAULT any(0) NO COMMENTS

id

Type: fabric:VConEntityId
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Naming Property -- [NAMING RULES]
Access: naming
Category: TopLevelRegular
Property Validators:

Comments:
Identifies this virtual connection.
Constants
1 1 NO COMMENTS
2 2 NO COMMENTS
3 3 NO COMMENTS
4 4 NO COMMENTS
DEFAULT 1(1) NO COMMENTS

instType

Type: fabric:VConInstType
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:

Comments:
NO COMMENTS
Constants
auto 1 NO COMMENTS
manual 2 NO COMMENTS
policy 3 NO COMMENTS
DEFAULT auto(1) NO COMMENTS

placement

Type: fabric:VConPlacementPref
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:

Comments:
NO COMMENTS
Constants
physical 1 if physical is selected: for VCon 1: adaptor 1 is selected for VCon 2: adaptor 2 or 1 (in single adaptor) is selected for VCon 3: adaptor 3, or 1 (in single and dual) is selected for VCon 4: adaptor 4, 2 (in dual) or 1 (in single is selected) sharing constraints are ignored
auto 2 if auto is selected if adaptor is not exlusively allocated: for VCon 1: adaptor 1 is selected for VCon 2: adaptor 2 or 1 (in single adaptor) is selected for VCon 3: adaptor 3, or 1 (in single and dual) is selected for VCon 4: adaptor 4, 2 (in dual) or 1 (in single is selected) sharing constraints are honored
DEFAULT physical(1) if physical is selected: for VCon 1: adaptor 1 is selected for VCon 2: adaptor 2 or 1 (in single adaptor) is selected for VCon 3: adaptor 3, or 1 (in single and dual) is selected for VCon 4: adaptor 4, 2 (in dual) or 1 (in single is selected) sharing constraints are ignored

propAcl

Type: mo:PropAclMask
Primitive Type: scalar:Uint64
Units: null
Encrypted: false
Access: implicit
Category: TopLevelRegular
Property Validators:

Comments:
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

select

Type: fabric:VConSelectPref
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:

Comments:
Specifies whether this connection is reserved for vncis with strict vcon assignment. That is, this connection wil not be used for vnics that are auto-placed.
Constants
assigned-only 1 RESERVED FOR STRICTLY ASSIGNED VNICS
unassigned-only 2 NON-SELECTABLE CONSTANT
dynamic-only 4 NON-SELECTABLE CONSTANT
exclude-usnic 7 EXCLUDES PLACEMENT OF USNIC VNICS
usnic-only 8 NON-SELECTABLE CONSTANT
exclude-dynamic 11 EXCLUDES PLACEMENT OF DYNAMIC VNICS
exclude-unassigned 13 EXCLUDES PLACEMENT OF UNASSIGNED VNICS
all 15 ALLOWS ALL VNICS TO BE PLACED
DEFAULT all(15) ALLOWS ALL VNICS TO BE PLACED

share

Type: fabric:VConSharePref
Primitive Type: scalar:Enum8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:

Comments:
NO COMMENTS
Constants
exclusive-only 1 NO COMMENTS
exclusive-preferred 2 NO COMMENTS
same-transport 3 NO COMMENTS
different-transport 4 NO COMMENTS
shared 5 NO COMMENTS
DEFAULT shared(5) 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.

transport

Type: fabric:VConTransportPref
Primitive Type: scalar:Bitmask8
Units: null
Encrypted: false
Access: admin
Category: TopLevelRegular
Property Validators:

Comments:
Specifies preference of vnics with given transport type. This can be used to restrict eth/fc vnics being placed.
Constants
fc 1 NO COMMENTS
ethernet 2 NO COMMENTS
defaultValue 3 NO COMMENTS
Overview  Containers  Contained  Inheritance  Events  Faults  FSMs  Properties Summary  Properties Detail  Naming