1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
# Copyright 2016 IBM Corp.
#
# All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
from pypowervm import util
def udid_to_scsi_mapping(vios_w, udid, lpar_id, ignore_orphan=True):
"""Finds the SCSI mapping (if any) for a given backing storage udid.
This is a helper method that will parse through a given VIOS wrapper
(retrieved with pypowervm.const.XAG.VIO_SMAP) and will find the client
SCSI mapping for a given backing storage element (LU, PV, LV, VOpt).
:param vios_w: The Virtual I/O Server wrapper. Should have the Storage
and SCSI mapping XAG associated with it.
:param udid: The volume's udid.
:param lpar_id: The LPARs 'short' id.
:param ignore_orphan: (Optional, Default: True) If set to True, any orphan
SCSI mappings (those with no client adapter) will be
ignored.
:return: The first matching SCSI mapping (or None).
"""
for scsi_map in vios_w.scsi_mappings:
# No backing storage, then ignore.
if not scsi_map.backing_storage:
continue
# If there is not a client adapter, it isn't attached fully.
if not scsi_map.client_adapter and ignore_orphan:
continue
# Is it for the right LPAR? (The server adapter is present even if
# it's an orphan.)
if lpar_id != scsi_map.server_adapter.lpar_id:
continue
if scsi_map.backing_storage.udid == udid:
return scsi_map
return None
def c_wwpn_to_vfc_mapping(vios_w, c_wwpn):
"""Finds the vFC mapping (if any) for a given client WWPN.
This is a helper method that will parse through a given VIOS wrapper
(retrieved with pypowervm.const.XAG.VIO_FMAP) and will find the client vFC
mapping for that WWPN.
:param vios_w: The Virtual I/O Server wrapper. Should have
pypowervm.const.XAG.VIO_FMAP associated with it.
:param c_wwpn: One of the client's WWPNs.
:return: The vFC mapping (or None)
"""
wwpn = util.sanitize_wwpn_for_api(c_wwpn)
for vfc_map in vios_w.vfc_mappings:
# If there is not a client adapter, it isn't properly attached.
if not vfc_map.client_adapter:
continue
if wwpn in vfc_map.client_adapter.wwpns:
return vfc_map
return None
|
