salt.states.dvs module¶

Manage VMware distributed virtual switches (DVSs) and their distributed virtual portgroups (DVportgroups).

codeauthor: Alexandru Bleotu <alexandru.bleotu@morganstaley.com>

Examples

Several settings can be changed for DVSs and DVporgroups. Here are two examples covering all of the settings. Fewer settings can be used

DVS¶

'name': 'dvs1',
'max_mtu': 1000,
'uplink_names': [
    'dvUplink1',
    'dvUplink2',
    'dvUplink3'
],
'capability': {
    'portgroup_operation_supported': false,
    'operation_supported': true,
    'port_operation_supported': false
},
'lacp_api_version': 'multipleLag',
'contact_email': 'foo@email.com',
'product_info': {
    'version':
    '6.0.0',
    'vendor':
    'VMware,
    Inc.',
    'name':
    'DVS'
},
'network_resource_management_enabled': true,
'contact_name': 'me@email.com',
'infrastructure_traffic_resource_pools': [
    {
        'reservation': 0,
        'limit': 1000,
        'share_level': 'high',
        'key': 'management',
        'num_shares': 100
    },
    {
        'reservation': 0,
        'limit': -1,
        'share_level': 'normal',
        'key': 'faultTolerance',
        'num_shares': 50
    },
    {
        'reservation': 0,
        'limit': 32000,
        'share_level': 'normal',
        'key': 'vmotion',
        'num_shares': 50
    },
    {
        'reservation': 10000,
        'limit': -1,
        'share_level': 'normal',
        'key': 'virtualMachine',
        'num_shares': 50
    },
    {
        'reservation': 0,
        'limit': -1,
        'share_level': 'custom',
        'key': 'iSCSI',
        'num_shares': 75
    },
    {
        'reservation': 0,
        'limit': -1,
        'share_level': 'normal',
        'key': 'nfs',
        'num_shares': 50
    },
    {
        'reservation': 0,
        'limit': -1,
        'share_level': 'normal',
        'key': 'hbr',
        'num_shares': 50
    },
    {
        'reservation': 8750,
        'limit': 15000,
        'share_level': 'high',
        'key': 'vsan',
        'num_shares': 100
    },
    {
        'reservation': 0,
        'limit': -1,
        'share_level': 'normal',
        'key': 'vdp',
        'num_shares': 50
    }
],
'link_discovery_protocol': {
    'operation':
    'listen',
    'protocol':
    'cdp'
},
'network_resource_control_version': 'version3',
'description': 'Managed by Salt. Random settings.'

Note: The mandatory attribute is: name.

Portgroup¶

'security_policy': {
    'allow_promiscuous': true,
    'mac_changes': false,
    'forged_transmits': true
},
'name': 'vmotion-v702',
'out_shaping': {
    'enabled': true,
    'average_bandwidth': 1500,
    'burst_size': 4096,
    'peak_bandwidth': 1500
},
'num_ports': 128,
'teaming': {
    'port_order': {
        'active': [
            'dvUplink2'
        ],
        'standby': [
            'dvUplink1'
        ]
    },
    'notify_switches': false,
    'reverse_policy': true,
    'rolling_order': false,
    'policy': 'failover_explicit',
    'failure_criteria': {
        'check_error_percent': true,
        'full_duplex': false,
        'check_duplex': false,
        'percentage': 50,
        'check_speed': 'minimum',
        'speed': 20,
        'check_beacon': true
    }
},
'type': 'earlyBinding',
'vlan_id': 100,
'description': 'Managed by Salt. Random settings.'

Note: The mandatory attributes are: name, type.

Dependencies¶

pyVmomi Python Module

pyVmomi¶

PyVmomi can be installed via pip:

pip install pyVmomi

Note

Version 6.0 of pyVmomi has some problems with SSL error handling on certain versions of Python. If using version 6.0 of pyVmomi, Python 2.7.9, or newer must be present. This is due to an upstream dependency in pyVmomi 6.0 that is not supported in Python versions 2.7 to 2.7.8. If the version of Python is not in the supported range, you will need to install an earlier version of pyVmomi. See Issue #29537 for more information.

Based on the note above, to install an earlier version of pyVmomi than the version currently listed in PyPi, run the following:

pip install pyVmomi==5.5.0.2014.1.1

The 5.5.0.2014.1.1 is a known stable version that this original ESXi State Module was developed against.

salt.states.dvs.dvs_configured(name, dvs)¶

Configures a DVS.

Creates a new DVS, if it doesn't exist in the provided datacenter or reconfigures it if configured differently.

dvs: DVS dict representations (see module sysdocs)

salt.states.dvs.portgroups_configured(name, dvs, portgroups)¶

Configures portgroups on a DVS.

Creates/updates/removes portgroups in a provided DVS

dvs: Name of the DVS
portgroups: Portgroup dict representations (see module sysdocs)

salt.states.dvs.uplink_portgroup_configured(name, dvs, uplink_portgroup)¶

Configures the uplink portgroup on a DVS. The state assumes there is only one uplink portgroup.

dvs: Name of the DVS
upling_portgroup: Uplink portgroup dict representations (see module sysdocs)

Generated on June 18, 2020 at 04:09:58 UTC.

You are viewing docs for the latest stable release, 3001. Switch to docs for the previous stable release, 3000.3, or to a recent doc build from the master branch.

saltstack.com