# September 2016, Glenn F. Matthews
# Copyright (c) 2013-2016 the COT project developers.
# See the COPYRIGHT.txt file at the top-level directory of this distribution
# and at https://github.com/glennmatthews/cot/blob/master/COPYRIGHT.txt.
#
# This file is part of the Common OVF Tool (COT) project.
# It is subject to the license terms in the LICENSE.txt file found in the
# top-level directory of this distribution and at
# https://github.com/glennmatthews/cot/blob/master/LICENSE.txt. No part
# of COT, including this file, may be copied, modified, propagated, or
# distributed except according to the terms contained in the LICENSE.txt file.
"""Platform logic for the Cisco NX-OSv virtual switch."""
import logging
from COT.platforms.generic import GenericPlatform
from COT.data_validation import (
ValueTooLowError, ValueTooHighError, validate_int,
)
logger = logging.getLogger(__name__)
[docs]class NXOSv(GenericPlatform):
"""Platform-specific logic for Cisco NX-OSv (Titanium)."""
PLATFORM_NAME = "Cisco NX-OSv"
CONFIG_TEXT_FILE = 'nxos_config.txt'
LITERAL_CLI_STRING = None
SUPPORTED_NIC_TYPES = ["E1000", "virtio"]
@classmethod
[docs] def guess_nic_name(cls, nic_number):
"""NX-OSv names its NICs a bit interestingly...
Args:
nic_number (int): Nth NIC to name.
Returns:
* mgmt0
* Ethernet2/1
* Ethernet2/2
* ...
* Ethernet2/48
* Ethernet3/1
* Ethernet3/2
* ...
"""
if nic_number == 1:
return "mgmt0"
else:
return ("Ethernet{0}/{1}".format((nic_number - 2) // 48 + 2,
(nic_number - 2) % 48 + 1))
@classmethod
[docs] def validate_cpu_count(cls, cpus):
"""NX-OSv requires 1-8 CPUs.
Args:
cpus (int): Number of CPUs
Raises:
ValueTooLowError: if ``cpus`` is less than 1
ValueTooHighError: if ``cpus`` is more than 8
"""
validate_int(cpus, 1, 8, "CPUs")
@classmethod
[docs] def validate_memory_amount(cls, mebibytes):
"""NX-OSv requires 2-8 GiB of RAM.
Args:
mebibytes (int): RAM, in MiB.
Raises:
ValueTooLowError: if ``mebibytes`` is less than 2048
ValueTooHighError: if ``mebibytes`` is more than 8192
"""
if mebibytes < 2048:
raise ValueTooLowError("RAM", str(mebibytes) + " MiB", "2 GiB")
elif mebibytes > 8192:
raise ValueTooHighError("RAM", str(mebibytes) + " MiB", "8 GiB")
@classmethod
[docs] def validate_serial_count(cls, count):
"""NX-OSv requires 1-2 serial ports.
Args:
count (int): Number of serial ports.
Raises:
ValueTooLowError: if ``count`` is less than 1
ValueTooHighError: if ``count`` is more than 2
"""
validate_int(count, 1, 2, "serial ports")