def test_add_map(self):
"""Validates the add_map method."""
# Determine the vios original values
vios_wrap = self.entries[0]
vios1_orig_map_count = len(vios_wrap.vfc_mappings)
# Subset the WWPNs on that VIOS
fabric_wwpns = ['10000090FA5371F2']
# Fake Virtual WWPNs
v_fabric_wwpns = ['0', '1']
# Get the mappings
fabric_map = vfc_mapper.derive_npiv_map([vios_wrap], fabric_wwpns,
v_fabric_wwpns)[0]
# Make sure the map was not there initially.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(0, len(maps))
# Now call the add action
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNotNone(resp)
self.assertIsInstance(resp, pvm_vios.VFCMapping)
# Verify the update is now found.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
self.assertEqual(vios1_orig_map_count + 1, len(vios_wrap.vfc_mappings))
# Try to add it again...it shouldn't re-add it because its already
# there. Flip WWPNs to verify set query.
fabric_map = ('10000090FA5371F2', '1 0')
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNone(resp)
self.assertEqual(vios1_orig_map_count + 1, len(vios_wrap.vfc_mappings))
# We should only find one here...the original add. Not two even though
# we've called add twice.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
def update_ibmi_settings(adapter, lpar_w, boot_type):
"""Update TaggedIO, Keylock postion and IPL Source of IBMi VM.
TaggedIO of IBMi vm will be updated to identify the load source,
alternative load source and console type. Keylock position will be set
to the value of NORMAL in KeylockPos enumration. IPL Source will be set
to the value of B in IPLSrc enumration.
:param adapter: The pypowervm adapter.
:param lpar_w: The lpar wrapper.
:param boot_type: The boot connectivity type of the VM. It is a string
value that represents one of the values in the
BootStorageType enumeration.
:return: The updated LPAR wrapper. The update is not executed against the
system, but rather the wrapper itself is updated locally.
"""
load_source = None
alt_load_source = None
client_adapters = []
if boot_type == pvm_lpar.BootStorageType.VFC:
LOG.info("Setting Virtual Fibre Channel slot as load source for VM %s",
lpar_w.name)
for vios_wrap in pvm_vios.VIOS.get(adapter, xag=[c.XAG.VIO_FMAP]):
existing_maps = pvm_vfcmap.find_maps(vios_wrap.vfc_mappings,
lpar_w.id)
client_adapters.extend([
vfcmap.client_adapter for vfcmap in existing_maps
if vfcmap.client_adapter is not None
])
else:
# That boot volume, which is vscsi physical volume, ssp lu
# and local disk, could be handled here.
LOG.info("Setting Virtual SCSI slot slot as load source for VM %s",
lpar_w.name)
for vios_wrap in pvm_vios.VIOS.get(adapter, xag=[c.XAG.VIO_SMAP]):
existing_maps = pvm_smap.find_maps(vios_wrap.scsi_mappings,
lpar_w.id)
client_adapters.extend([
smap.client_adapter for smap in existing_maps
if smap.client_adapter is not None
])
slot_nums = set(s.lpar_slot_num for s in client_adapters)
slot_nums = list(slot_nums)
slot_nums.sort()
if len(slot_nums) > 0:
load_source = slot_nums.pop(0)
if len(slot_nums) > 0:
alt_load_source = slot_nums.pop(0)
if load_source is not None:
if alt_load_source is None:
alt_load_source = load_source
lpar_w.io_config.tagged_io = pvm_bp.TaggedIO.bld(
adapter,
load_src=load_source,
console='HMC',
alt_load_src=alt_load_source)
else:
raise pvmex.IBMiLoadSourceNotFound(vm_name=lpar_w.name)
lpar_w.desig_ipl_src = pvm_lpar.IPLSrc.B
lpar_w.keylock_pos = pvm_bp.KeylockPos.NORMAL
return lpar_w
def test_add_remove_map_any_wwpn(self):
"""Tests a loop of add map/remove map when using _ANY_WWPN."""
v_wrap = self.entries[0]
len_before = len(v_wrap.vfc_mappings)
# A fake mapping to the first IO Server
p_map_vio1 = ('10000090FA5371F2', vfc_mapper._FUSED_ANY_WWPN)
vfc_mapper.add_map(v_wrap, 'host_uuid', self.lpar_uuid, p_map_vio1)
self.assertEqual(len_before + 1, len(v_wrap.vfc_mappings))
# See if we can find that mapping.
maps = vfc_mapper.find_maps(v_wrap.vfc_mappings,
self.lpar_uuid,
port_map=p_map_vio1)
self.assertEqual(1, len(maps))
# Even though we were searching for a 'FUSED' wwpn, the mapping itself
# will have nothing on it, to indicate that the API should generate
# the WWPNs. Therefore, we validate that we found the mapping without
# any WWPNs on it.
self.assertEqual([], maps[0].client_adapter.wwpns)
# Now try to remove it...
vfc_mapper.remove_maps(v_wrap, self.lpar_uuid, port_map=p_map_vio1)
self.assertEqual(len_before, len(v_wrap.vfc_mappings))
def test_add_map(self):
"""Validates the add_map method."""
# Determine the vios original values
vios_wrap = self.entries[0]
vios1_orig_map_count = len(vios_wrap.vfc_mappings)
# Subset the WWPNs on that VIOS
fabric_wwpns = ['10000090FA5371F2']
# Fake Virtual WWPNs
v_fabric_wwpns = ['0', '1']
# Get the mappings
fabric_map = vfc_mapper.derive_npiv_map([vios_wrap], fabric_wwpns,
v_fabric_wwpns)[0]
# Make sure the map was not there initially.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings, self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(0, len(maps))
# Now call the add action
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNotNone(resp)
self.assertIsInstance(resp, pvm_vios.VFCMapping)
# Verify the update is now found.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings, self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
self.assertEqual(vios1_orig_map_count + 1, len(vios_wrap.vfc_mappings))
# Try to add it again...it shouldn't re-add it because its already
# there. Flip WWPNs to verify set query.
fabric_map = ('10000090FA5371F2', '1 0')
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNone(resp)
self.assertEqual(vios1_orig_map_count + 1, len(vios_wrap.vfc_mappings))
# We should only find one here...the original add. Not two even though
# we've called add twice.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings, self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
def test_find_maps(self):
vwrap = self.entries[0]
matches = vfc_mapper.find_maps(vwrap.vfc_mappings, 10)
# Make sure we got the right ones
self.assertEqual(
['U7895.43X.21EF9FB-V63-C3', 'U7895.43X.21EF9FB-V66-C4',
'U7895.43X.21EF9FB-V62-C4', 'U7895.43X.21EF9FB-V10-C4'],
[match.client_adapter.loc_code for match in matches])
# Bogus LPAR ID
self.assertEqual([], vfc_mapper.find_maps(vwrap.vfc_mappings, 1000))
# Now try with UUID
matches = vfc_mapper.find_maps(vwrap.vfc_mappings,
'3ADDED46-B3A9-4E12-B6EC-8223421AF49B')
self.assertEqual(
['U7895.43X.21EF9FB-V63-C3', 'U7895.43X.21EF9FB-V66-C4',
'U7895.43X.21EF9FB-V62-C4', 'U7895.43X.21EF9FB-V10-C4'],
[match.client_adapter.loc_code for match in matches])
# Bogus LPAR UUID
self.assertEqual([], vfc_mapper.find_maps(
vwrap.vfc_mappings, '4BEEFD00-B3A9-4E12-B6EC-8223421AF49B'))
def test_find_maps(self):
vwrap = self.entries[0]
matches = vfc_mapper.find_maps(vwrap.vfc_mappings, 10)
# Make sure we got the right ones
self.assertEqual(
['U7895.43X.21EF9FB-V63-C3', 'U7895.43X.21EF9FB-V66-C4',
'U7895.43X.21EF9FB-V62-C4', 'U7895.43X.21EF9FB-V10-C4'],
[match.client_adapter.loc_code for match in matches])
# Bogus LPAR ID
self.assertEqual([], vfc_mapper.find_maps(vwrap.vfc_mappings, 1000))
# Now try with UUID
matches = vfc_mapper.find_maps(vwrap.vfc_mappings,
'3ADDED46-B3A9-4E12-B6EC-8223421AF49B')
self.assertEqual(
['U7895.43X.21EF9FB-V63-C3', 'U7895.43X.21EF9FB-V66-C4',
'U7895.43X.21EF9FB-V62-C4', 'U7895.43X.21EF9FB-V10-C4'],
[match.client_adapter.loc_code for match in matches])
# Bogus LPAR UUID
self.assertEqual([], vfc_mapper.find_maps(
vwrap.vfc_mappings, '4BEEFD00-B3A9-4E12-B6EC-8223421AF49B'))
def test_remove_maps_client_adpt(self):
"""Tests the remove_maps method, with the client_adpt input."""
v_wrap = self.entries[0]
len_before = len(v_wrap.vfc_mappings)
c_adpt = vfc_mapper.find_maps(v_wrap.vfc_mappings,
10)[0].client_adapter
resp_list = vfc_mapper.remove_maps(v_wrap, 10, client_adpt=c_adpt)
expected_removals = {'U7895.43X.21EF9FB-V63-C3'}
self.assertEqual(set([el.client_adapter.loc_code for el in resp_list]),
expected_removals)
self.assertEqual(len_before - 1, len(v_wrap.vfc_mappings))
# Make sure the remaining adapters do not have the remove codes.
for remaining_map in v_wrap.vfc_mappings:
if remaining_map.client_adapter is not None:
self.assertNotIn(remaining_map.client_adapter.loc_code,
expected_removals)
def test_remove_maps_client_adpt(self):
"""Tests the remove_maps method, with the client_adpt input."""
v_wrap = self.entries[0]
len_before = len(v_wrap.vfc_mappings)
c_adpt = vfc_mapper.find_maps(
v_wrap.vfc_mappings, 10)[0].client_adapter
resp_list = vfc_mapper.remove_maps(v_wrap, 10, client_adpt=c_adpt)
expected_removals = {'U7895.43X.21EF9FB-V63-C3'}
self.assertEqual(
set([el.client_adapter.loc_code for el in resp_list]),
expected_removals)
self.assertEqual(len_before - 1, len(v_wrap.vfc_mappings))
# Make sure the remaining adapters do not have the remove codes.
for remaining_map in v_wrap.vfc_mappings:
if remaining_map.client_adapter is not None:
self.assertNotIn(remaining_map.client_adapter.loc_code,
expected_removals)
def test_add_remove_map_any_wwpn(self):
"""Tests a loop of add map/remove map when using _ANY_WWPN."""
v_wrap = self.entries[0]
len_before = len(v_wrap.vfc_mappings)
# A fake mapping to the first IO Server
p_map_vio1 = ('10000090FA5371F2', vfc_mapper._FUSED_ANY_WWPN)
vfc_mapper.add_map(v_wrap, 'host_uuid', self.lpar_uuid, p_map_vio1)
self.assertEqual(len_before + 1, len(v_wrap.vfc_mappings))
# See if we can find that mapping.
maps = vfc_mapper.find_maps(v_wrap.vfc_mappings, self.lpar_uuid,
port_map=p_map_vio1)
self.assertEqual(1, len(maps))
# Even though we were searching for a 'FUSED' wwpn, the mapping itself
# will have nothing on it, to indicate that the API should generate
# the WWPNs. Therefore, we validate that we found the mapping without
# any WWPNs on it.
self.assertEqual([], maps[0].client_adapter.wwpns)
# Now try to remove it...
vfc_mapper.remove_maps(v_wrap, self.lpar_uuid, port_map=p_map_vio1)
self.assertEqual(len_before, len(v_wrap.vfc_mappings))
def update_ibmi_settings(adapter, lpar_w, boot_type):
"""Update TaggedIO, Keylock postion and IPL Source of IBMi VM.
TaggedIO of IBMi vm will be updated to identify the load source,
alternative load source and console type. Keylock position will be set
to the value of NORMAL in KeylockPos enumration. IPL Source will be set
to the value of B in IPLSrc enumration.
:param adapter: The pypowervm adapter.
:param lpar_w: The lpar wrapper.
:param boot_type: The boot connectivity type of the VM. It is a string
value that represents one of the values in the
BootStorageType enumeration.
:return: The updated LPAR wrapper. The update is not executed against the
system, but rather the wrapper itself is updated locally.
"""
load_source = None
alt_load_source = None
client_adapters = []
console_type = 'HMC'
# Set the console type as vea adapter if the host is not managed by HMC
if adapter.traits.vea_as_ibmi_console:
msg = _LI("Setting Virtual Ethernet Adapter slot as console type for "
"VM %s") % lpar_w.name
LOG.info(msg)
cna_wrap = pvm_net.CNA.wrap(
adapter.read(pvm_lpar.LPAR.schema_type,
root_id=lpar_w.partition_uuid,
child_type=pvm_net.CNA.schema_type))
cna_slot_nums = set(cna.slot for cna in cna_wrap)
cna_slot_nums = list(cna_slot_nums)
cna_slot_nums.sort()
if len(cna_slot_nums) > 0:
console_type = cna_slot_nums.pop(0)
if boot_type == pvm_lpar.BootStorageType.VFC:
msg = _LI("Setting Virtual Fibre Channel slot as load source for VM "
"%s") % lpar_w.name
LOG.info(msg)
vios_wraps = pvm_vios.VIOS.wrap(
adapter.read(pvm_vios.VIOS.schema_type,
xag=[pvm_vios.VIOS.xags.FC_MAPPING]))
for vios_wrap in vios_wraps:
existing_maps = pvm_vfcmap.find_maps(vios_wrap.vfc_mappings,
lpar_w.id)
client_adapters.extend(
[vfcmap.client_adapter for vfcmap in existing_maps])
else:
# That boot volume, which is vscsi physical volume, ssp lu
# and local disk, could be handled here.
msg = _LI("Setting Virtual SCSI slot slot as load source for VM "
"%s") % lpar_w.name
LOG.info(msg)
vios_wraps = pvm_vios.VIOS.wrap(
adapter.read(pvm_vios.VIOS.schema_type,
xag=[pvm_vios.VIOS.xags.SCSI_MAPPING]))
for vios_wrap in vios_wraps:
existing_maps = pvm_smap.find_maps(vios_wrap.scsi_mappings,
lpar_w.id)
client_adapters.extend(
[smap.client_adapter for smap in existing_maps])
slot_nums = set(s.lpar_slot_num for s in client_adapters)
slot_nums = list(slot_nums)
slot_nums.sort()
if len(slot_nums) > 0:
load_source = slot_nums.pop(0)
if len(slot_nums) > 0:
alt_load_source = slot_nums.pop(0)
if load_source is not None:
if alt_load_source is None:
alt_load_source = load_source
lpar_w.io_config.tagged_io = pvm_bp.TaggedIO.bld(
adapter,
load_src=load_source,
console=console_type,
alt_load_src=alt_load_source)
else:
raise pvmex.IBMiLoadSourceNotFound(vm_name=lpar_w.name)
lpar_w.desig_ipl_src = pvm_lpar.IPLSrc.B
lpar_w.keylock_pos = pvm_bp.KeylockPos.NORMAL
return lpar_w
def test_add_map(self):
"""Validates the add_map method."""
# Determine the vios original values
vios_wrap = self.entries[0]
vios1_orig_map_count = len(vios_wrap.vfc_mappings)
# Subset the WWPNs on that VIOS
fabric_wwpns = ['10000090FA5371F2']
# Fake Virtual WWPNs
v_fabric_wwpns = ['0', '1']
# Get the mappings
fabric_map = vfc_mapper.derive_npiv_map([vios_wrap], fabric_wwpns,
v_fabric_wwpns)[0]
# Make sure the map was not there initially.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(0, len(maps))
# Now call the add action
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNotNone(resp)
self.assertIsInstance(resp, pvm_vios.VFCMapping)
# Verify the update is now found.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
self.assertEqual(vios1_orig_map_count + 1, len(vios_wrap.vfc_mappings))
# Try to add it again...it shouldn't re-add it because its already
# there. Flip WWPNs to verify set query.
fabric_map = ('10000090FA5371F2', '1 0')
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNone(resp)
self.assertEqual(vios1_orig_map_count + 1, len(vios_wrap.vfc_mappings))
# We should only find one here...the original add. Not two even though
# we've called add twice.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
# This time, remove the backing port of the existing mapping and try
# the add again. It should return an updated mapping that contains the
# backing port. This simulates a VM migrating with a vfc mapping, but
# no volume had been previously detached.
maps[0].element.remove(maps[0].backing_port.element)
resp = vfc_mapper.add_map(vios_wrap, 'host_uuid', self.lpar_uuid,
fabric_map)
self.assertIsNotNone(resp)
self.assertIsInstance(resp, pvm_vios.VFCMapping)
self.assertIsNotNone(resp.backing_port)
self.assertIn('Port', resp.child_order)
# Pass in slot number to be set on the VFC adapter
fabric_map = ('10000090FA5371F1', '2 3')
resp = vfc_mapper.add_map(vios_wrap,
'host_uuid',
self.lpar_uuid,
fabric_map,
lpar_slot_num=3)
self.assertIsNotNone(resp)
self.assertEqual(vios1_orig_map_count + 2, len(vios_wrap.vfc_mappings))
# Verify the update is now found.
maps = vfc_mapper.find_maps(vios_wrap.vfc_mappings,
self.lpar_uuid,
port_map=fabric_map)
self.assertEqual(1, len(maps))
self.assertEqual(3, maps[0].client_adapter.lpar_slot_num)
def update_ibmi_settings(adapter, lpar_w, boot_type):
"""Update TaggedIO, Keylock postion and IPL Source of IBMi VM.
TaggedIO of IBMi vm will be updated to identify the load source,
alternative load source and console type. Keylock position will be set
to the value of NORMAL in KeylockPos enumration. IPL Source will be set
to the value of B in IPLSrc enumration.
:param adapter: The pypowervm adapter.
:param lpar_w: The lpar wrapper.
:param boot_type: The boot connectivity type of the VM. It is a string
value that represents one of the values in the
BootStorageType enumeration.
:return: The updated LPAR wrapper. The update is not executed against the
system, but rather the wrapper itself is updated locally.
"""
load_source = None
alt_load_source = None
client_adapters = []
console_type = 'HMC'
# Set the console type as vea adapter if the host is not managed by HMC
if adapter.traits.vea_as_ibmi_console:
msg = _LI("Setting Virtual Ethernet Adapter slot as console type for "
"VM %s") % lpar_w.name
LOG.info(msg)
cna_wrap = pvm_net.CNA.wrap(adapter.read(
pvm_lpar.LPAR.schema_type,
root_id=lpar_w.partition_uuid,
child_type=pvm_net.CNA.schema_type))
cna_slot_nums = set(cna.slot for cna in cna_wrap)
cna_slot_nums = list(cna_slot_nums)
cna_slot_nums.sort()
if len(cna_slot_nums) > 0:
console_type = cna_slot_nums.pop(0)
if boot_type == pvm_lpar.BootStorageType.VFC:
msg = _LI("Setting Virtual Fibre Channel slot as load source for VM "
"%s") % lpar_w.name
LOG.info(msg)
vios_wraps = pvm_vios.VIOS.wrap(adapter.read(
pvm_vios.VIOS.schema_type,
xag=[pvm_vios.VIOS.xags.FC_MAPPING]))
for vios_wrap in vios_wraps:
existing_maps = pvm_vfcmap.find_maps(
vios_wrap.vfc_mappings, lpar_w.id)
client_adapters.extend([vfcmap.client_adapter
for vfcmap in existing_maps])
else:
# That boot volume, which is vscsi physical volume, ssp lu
# and local disk, could be handled here.
msg = _LI("Setting Virtual SCSI slot slot as load source for VM "
"%s") % lpar_w.name
LOG.info(msg)
vios_wraps = pvm_vios.VIOS.wrap(adapter.read(
pvm_vios.VIOS.schema_type,
xag=[pvm_vios.VIOS.xags.SCSI_MAPPING]))
for vios_wrap in vios_wraps:
existing_maps = pvm_smap.find_maps(
vios_wrap.scsi_mappings, lpar_w.id)
client_adapters.extend([smap.client_adapter
for smap in existing_maps])
slot_nums = set(s.lpar_slot_num for s in client_adapters)
slot_nums = list(slot_nums)
slot_nums.sort()
if len(slot_nums) > 0:
load_source = slot_nums.pop(0)
if len(slot_nums) > 0:
alt_load_source = slot_nums.pop(0)
if load_source is not None:
if alt_load_source is None:
alt_load_source = load_source
lpar_w.io_config.tagged_io = pvm_bp.TaggedIO.bld(
adapter, load_src=load_source,
console=console_type,
alt_load_src=alt_load_source)
else:
raise pvmex.IBMiLoadSourceNotFound(vm_name=lpar_w.name)
lpar_w.desig_ipl_src = pvm_lpar.IPLSrc.B
lpar_w.keylock_pos = pvm_bp.KeylockPos.NORMAL
return lpar_w