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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
|
# Copyright 2017 Citrix Systems
#
# 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.
"""The common functions for XenAPI utils
It contains the common functions used by XenAPI utils."""
import inspect
import ipaddress
import logging
import netifaces
import os
import subprocess
import sys
from os_xenapi.client import exception
PATTERN_XENSTORE_VIFS_IN_VM = '/xapi/%s/private/vif'
LOG_ROOT = '/var/log/os-xenapi'
DEFAULT_LOG_FILE = 'xenapi.log'
LOG = logging.getLogger(__name__)
def exit_with_error(err_msg):
sys.stderr.write(err_msg)
sys.exit(1)
def detailed_execute(*cmd, **kwargs):
cmd = map(str, cmd)
_env = kwargs.get('env')
env_prefix = ''
if _env:
env_prefix = ''.join(['%s=%s ' % (k, _env[k]) for k in _env])
env = dict(os.environ)
env.update(_env)
else:
env = None
LOG.info(env_prefix + ' '.join(cmd))
proc = subprocess.Popen(cmd, stdin=subprocess.PIPE, # nosec
stdout=subprocess.PIPE,
stderr=subprocess.PIPE, env=env)
prompt = kwargs.get('prompt')
if prompt:
(out, err) = proc.communicate(prompt)
else:
(out, err) = proc.communicate()
if out:
# Truncate "\n" if it is the last char
out = out.strip()
LOG.debug(out)
if err:
LOG.info(err)
if proc.returncode is not None and proc.returncode != 0:
if proc.returncode in kwargs.get('allowed_return_codes', [0]):
LOG.info('Swallowed acceptable return code of %d',
proc.returncode)
else:
LOG.warn('proc.returncode: %s', proc.returncode)
raise exception.ExecuteCommandFailed(cmd)
return proc.returncode, out, err
def execute(*cmd, **kwargs):
_, out, _ = detailed_execute(*cmd, **kwargs)
return out
def get_eth_ipaddr(eth):
# return eth's IP address.
return netifaces.ifaddresses(eth).get(netifaces.AF_INET)[0]['addr']
def get_eth_mac(eth):
# Get eth's mac address.
return netifaces.ifaddresses(eth).get(netifaces.AF_LINK)[0]['addr']
def get_remote_hostname(host_client):
# Get remote host's hostname via the host_client connected to the host.
_, out, _ = host_client.ssh('hostname')
hostname = out.strip()
return hostname
def get_iface_bridge(iface, host_client):
# Get bridge name for interface in the host
# return 1 means that it doesn't find a bridge for this interface.
ret, out, _ = host_client.ssh('ovs-vsctl iface-to-br %s' % iface,
allowed_return_codes=[0, 1])
if ret == 0:
return out.strip()
# Get no bridge for this interface; check if it's the internal
# interface for a bridge. The return code 2 means bridge with
# this name doesn't exist.
bridge = iface
ret, _, _ = host_client.ssh('ovs-vsctl br-exists %s' % bridge,
allowed_return_codes=[0, 2])
if ret == 0:
return bridge
# Reaching here, means this interface doesn't belong to any bridge.
return None
def get_host_ipv4s(host_client):
# Get host's IPs (v4 only) via the host_client connected to the host.
ipv4s = []
command = "ip -4 -o addr show scope global | awk '{print $2, $4}'"
_, out, _ = host_client.ssh(command)
for line in out.split('\n'):
line = line.strip()
if line:
interface, ipv4_address = line.split()
net_if = ipaddress.IPv4Interface(ipv4_address)
network = net_if.network
ipv4 = {}
ipv4['interface'] = interface
ipv4['bridge'] = get_iface_bridge(interface, host_client)
ipv4['address'], _ = ipv4_address.split('/')
ipv4['broadcast'] = str(network.broadcast_address)
ipv4['network'] = str(network.network_address)
ipv4['netmask'] = str(network.netmask)
ipv4s.append(ipv4)
return ipv4s
def get_vm_vifs(xenserver_client, vm_uuid):
"""Get a specific VM's vifs
This function can be used to get vif list for a specific VM.
:param xenserver_client: the ssh client connected to XenServer where
the domU belongs to.
:param vm_uuid: the VM's uuid
:returns: list -- list the VM's vif data.
"""
vm_vifs = PATTERN_XENSTORE_VIFS_IN_VM % vm_uuid
_, out, _ = xenserver_client.ssh('xenstore-list %s' % vm_vifs)
vif_ids = [x.strip() for x in out.split('\n') if x.strip()]
vifs = []
for id in vif_ids:
vif_ent = '/'.join([vm_vifs, id])
_, out, _ = xenserver_client.ssh('xenstore-ls %s' % vif_ent)
key_values = [x.strip().split(' = ') for x in out.split('\n')
if ' = ' in x]
vif_dict = {x[0]: x[1].replace('\"', '') for x in key_values}
vifs.append(vif_dict)
return vifs
def get_domu_vifs_by_eth(xenserver_client):
"""Get domU's vifs
This function can be used to get a domU's vifs.
:param xenserver_client: the ssh client connected to XenServer where
the domU belongs to.
:returns: dict -- The domU's vifs with ethernet interfaces as the keys.
"""
# Get domU VM's uuid
out = execute('xenstore-read', 'vm')
vm_uuid = out.split('/')[-1]
vifs = get_vm_vifs(xenserver_client, vm_uuid)
vifs_by_mac = {vif['mac']: vif for vif in vifs}
# Get all ethernet interfaces and mapping them into vifs basing on
# mac address
vifs_by_eth = {}
for eth in netifaces.interfaces():
mac_addrs = [x['addr'] for x in
netifaces.ifaddresses(eth)[netifaces.AF_LINK]]
for mac in vifs_by_mac:
if mac in mac_addrs:
vifs_by_eth[eth] = vifs_by_mac[mac]
break
return vifs_by_eth
def scp_and_execute(dom0_client, script_name):
# copy script to remote host and execute it
_, TMP_SH_DIR, _ = dom0_client.ssh("mktemp -d /tmp/domu_sh.XXXXXX")
TMP_SH_PATH = TMP_SH_DIR + '/' + script_name
Util_DIR = os.path.dirname(
os.path.abspath(inspect.getfile(inspect.currentframe())))
SH_TOOLS_DIR = Util_DIR + '/sh_tools/'
dom0_client.ssh("mkdir -p " + TMP_SH_DIR)
try:
dom0_client.scp(SH_TOOLS_DIR + script_name, TMP_SH_PATH)
dom0_client.ssh("chmod +x " + TMP_SH_PATH)
dom0_client.ssh(TMP_SH_PATH)
finally:
dom0_client.ssh("rm -rf " + TMP_SH_DIR)
def setup_logging(filename=DEFAULT_LOG_FILE, folder=LOG_ROOT,
log_level=logging.WARNING):
log_file = os.path.join(folder, filename)
if not os.path.exists(folder):
os.mkdir(folder)
logging.basicConfig(
filename=log_file, level=log_level,
format='%(asctime)s %(name)-12s %(levelname)-8s %(message)s')
|
