[maas] Fix class ordering for ipv6.disable dup
[fuel.git] / mcp / scripts / lib.sh
1 #!/bin/bash -e
2 # shellcheck disable=SC2155,SC1001,SC2015,SC2128
3 ##############################################################################
4 # Copyright (c) 2018 Mirantis Inc., Enea AB and others.
5 # All rights reserved. This program and the accompanying materials
6 # are made available under the terms of the Apache License, Version 2.0
7 # which accompanies this distribution, and is available at
8 # http://www.apache.org/licenses/LICENSE-2.0
9 ##############################################################################
10 #
11 # Library of shell functions
12 #
13
14 function generate_ssh_key {
15   local mcp_ssh_key=$(basename "${SSH_KEY}")
16   local user=${USER}
17   if [ -n "${SUDO_USER}" ] && [ "${SUDO_USER}" != 'root' ]; then
18     user=${SUDO_USER}
19   fi
20
21   if [ -f "${SSH_KEY}" ]; then
22     cp "${SSH_KEY}" .
23     ssh-keygen -f "${mcp_ssh_key}" -y > "${mcp_ssh_key}.pub"
24   fi
25
26   [ -f "${mcp_ssh_key}" ] || ssh-keygen -f "${mcp_ssh_key}" -N ''
27   sudo install -D -o "${user}" -m 0600 "${mcp_ssh_key}" "${SSH_KEY}"
28 }
29
30 function get_base_image {
31   local base_image=$1
32   local image_dir=$2
33
34   mkdir -p "${image_dir}"
35   wget --progress=dot:giga -P "${image_dir}" -N "${base_image}"
36 }
37
38 function __kernel_modules {
39   # Load mandatory kernel modules: loop, nbd
40   local image_dir=$1
41   test -e /dev/loop-control || sudo modprobe loop
42   if sudo modprobe nbd max_part=8 || sudo modprobe -f nbd max_part=8; then
43     return 0
44   fi
45   if [ -e /dev/nbd0 ]; then return 0; fi  # nbd might be inbuilt
46   # CentOS (or RHEL family in general) do not provide 'nbd' out of the box
47   echo "[WARN] 'nbd' kernel module cannot be loaded!"
48   if [ ! -e /etc/redhat-release ]; then
49     echo "[ERROR] Non-RHEL system detected, aborting!"
50     echo "[ERROR] Try building 'nbd' manually or install it from a 3rd party."
51     exit 1
52   fi
53
54   # Best-effort attempt at building a non-maintaned kernel module
55   local __baseurl
56   local __subdir
57   local __uname_r=$(uname -r)
58   local __uname_m=$(uname -m)
59   if [ "${__uname_m}" = 'x86_64' ]; then
60     __baseurl='http://vault.centos.org/centos'
61     __subdir='Source/SPackages'
62     __srpm="kernel-${__uname_r%.${__uname_m}}.src.rpm"
63   else
64     __baseurl='http://vault.centos.org/altarch'
65     __subdir="Source/${__uname_m}/Source/SPackages"
66     # NOTE: fmt varies across releases (e.g. kernel-alt-4.11.0-44.el7a.src.rpm)
67     __srpm="kernel-alt-${__uname_r%.${__uname_m}}.src.rpm"
68   fi
69
70   local __found='n'
71   local __versions=$(curl -s "${__baseurl}/" | grep -Po 'href="\K7\.[\d\.]+')
72   for ver in ${__versions}; do
73     for comp in os updates; do
74       local url="${__baseurl}/${ver}/${comp}/${__subdir}/${__srpm}"
75       if wget "${url}" -O "${image_dir}/${__srpm}" > /dev/null 2>&1; then
76         __found='y'; break 2
77       fi
78     done
79   done
80
81   if [ "${__found}" = 'n' ]; then
82     echo "[ERROR] Can't find the linux kernel SRPM for: ${__uname_r}"
83     echo "[ERROR] 'nbd' module cannot be built, aborting!"
84     echo "[ERROR] Try 'yum upgrade' or building 'nbd' krn module manually ..."
85     exit 1
86   fi
87
88   rpm -ivh "${image_dir}/${__srpm}" 2> /dev/null
89   mkdir -p ~/rpmbuild/{BUILD,BUILDROOT,RPMS,SOURCES,SPECS,SRPMS}
90   # shellcheck disable=SC2016
91   echo '%_topdir %(echo $HOME)/rpmbuild' > ~/.rpmmacros
92   (
93     cd ~/rpmbuild/SPECS
94     rpmbuild -bp --nodeps --target="${__uname_m}" kernel*.spec
95     cd ~/rpmbuild/BUILD/"${__srpm%.src.rpm}"/linux-*
96     sed -i 's/^.*\(CONFIG_BLK_DEV_NBD\).*$/\1=m/g' .config
97     # http://centosfaq.org/centos/nbd-does-not-compile-for-3100-514262el7x86_64
98     if grep -Rq 'REQ_TYPE_DRV_PRIV' drivers/block; then
99       sed -i 's/REQ_TYPE_SPECIAL/REQ_TYPE_DRV_PRIV/g' drivers/block/nbd.c
100     fi
101     gunzip -c "/boot/symvers-${__uname_r}.gz" > Module.symvers
102     make prepare modules_prepare
103     make M=drivers/block -j
104     modinfo drivers/block/nbd.ko
105     sudo mkdir -p "/lib/modules/${__uname_r}/extra/"
106     sudo cp drivers/block/nbd.ko "/lib/modules/${__uname_r}/extra/"
107   )
108   sudo depmod -a
109   sudo modprobe nbd max_part=8 || sudo modprobe -f nbd max_part=8
110 }
111
112 function mount_image {
113   local image=$1
114   local image_dir=$2
115   OPNFV_MNT_DIR="${image_dir}/ubuntu"
116
117   # Find free nbd, loop devices
118   for dev in '/sys/class/block/nbd'*; do
119     if [ "$(cat "${dev}/size")" = '0' ]; then
120       OPNFV_NBD_DEV=/dev/$(basename "${dev}")
121       break
122     fi
123   done
124   OPNFV_LOOP_DEV=$(sudo losetup -f)
125   OPNFV_MAP_DEV=/dev/mapper/$(basename "${OPNFV_NBD_DEV}")p1
126   export OPNFV_MNT_DIR OPNFV_LOOP_DEV
127   [ -n "${OPNFV_NBD_DEV}" ] && [ -n "${OPNFV_LOOP_DEV}" ] || exit 1
128   qemu-img resize "${image_dir}/${image}" 3G
129   sudo qemu-nbd --connect="${OPNFV_NBD_DEV}" --aio=native --cache=none \
130     "${image_dir}/${image}"
131   sudo kpartx -av "${OPNFV_NBD_DEV}"
132   sleep 5 # /dev/nbdNp1 takes some time to come up
133   # Hardcode partition index to 1, unlikely to change for Ubuntu UCA image
134   if sudo growpart "${OPNFV_NBD_DEV}" 1; then
135     sudo kpartx -u "${OPNFV_NBD_DEV}"
136     sudo e2fsck -pf "${OPNFV_MAP_DEV}"
137     sudo resize2fs "${OPNFV_MAP_DEV}"
138   fi
139   # grub-update does not like /dev/nbd*, so use a loop device to work around it
140   sudo losetup "${OPNFV_LOOP_DEV}" "${OPNFV_MAP_DEV}"
141   mkdir -p "${OPNFV_MNT_DIR}"
142   sudo mount "${OPNFV_LOOP_DEV}" "${OPNFV_MNT_DIR}"
143   sudo mount -t proc proc "${OPNFV_MNT_DIR}/proc"
144   sudo mount -t sysfs sys "${OPNFV_MNT_DIR}/sys"
145   sudo mount -o bind /dev "${OPNFV_MNT_DIR}/dev"
146   sudo mkdir -p "${OPNFV_MNT_DIR}/run/resolvconf"
147   sudo cp /etc/resolv.conf "${OPNFV_MNT_DIR}/run/resolvconf"
148   echo "GRUB_DISABLE_OS_PROBER=true" | \
149     sudo tee -a "${OPNFV_MNT_DIR}/etc/default/grub"
150   sudo sed -i -e 's/^\(GRUB_TIMEOUT\)=.*$/\1=1/g' -e 's/^GRUB_HIDDEN.*$//g' \
151     "${OPNFV_MNT_DIR}/etc/default/grub"
152 }
153
154 function apt_repos_pkgs_image {
155   local apt_key_urls=(${1//,/ })
156   local all_repos=(${2//,/ })
157   local pkgs_i=(${3//,/ })
158   local pkgs_r=(${4//,/ })
159   [ -n "${OPNFV_MNT_DIR}" ] || exit 1
160
161   # APT keys
162   if [ "${#apt_key_urls[@]}" -gt 0 ]; then
163     for apt_key in "${apt_key_urls[@]}"; do
164       sudo chroot "${OPNFV_MNT_DIR}" /bin/bash -c \
165         "wget -qO - '${apt_key}' | apt-key add -"
166     done
167   fi
168   # Additional repositories
169   for repo_line in "${all_repos[@]}"; do
170     # <repo_name>|<repo prio>|deb|[arch=<arch>]|<repo url>|<dist>|<repo comp>
171     local repo=(${repo_line//|/ })
172     [ "${#repo[@]}" -gt 5 ] || continue
173     # NOTE: Names and formatting are compatible with Salt linux.system.repo
174     cat <<-EOF | sudo tee "${OPNFV_MNT_DIR}/etc/apt/preferences.d/${repo[0]}"
175
176                 Package: *
177                 Pin: release a=${repo[-2]}
178                 Pin-Priority: ${repo[1]}
179
180                 EOF
181     echo "${repo[@]:2}" | sudo tee \
182       "${OPNFV_MNT_DIR}/etc/apt/sources.list.d/${repo[0]}.list"
183   done
184   # Install packages
185   if [ "${#pkgs_i[@]}" -gt 0 ]; then
186     sudo DEBIAN_FRONTEND="noninteractive" \
187       chroot "${OPNFV_MNT_DIR}" apt-get update
188     sudo DEBIAN_FRONTEND="noninteractive" FLASH_KERNEL_SKIP="true" \
189       chroot "${OPNFV_MNT_DIR}" apt-get install -y "${pkgs_i[@]}"
190   fi
191   # Remove packages
192   if [ "${#pkgs_r[@]}" -gt 0 ]; then
193     sudo DEBIAN_FRONTEND="noninteractive" FLASH_KERNEL_SKIP="true" \
194       chroot "${OPNFV_MNT_DIR}" apt-get purge -y "${pkgs_r[@]}"
195   fi
196   # Disable cloud-init metadata service datasource
197   sudo mkdir -p "${OPNFV_MNT_DIR}/etc/cloud/cloud.cfg.d"
198   echo "datasource_list: [ NoCloud, None ]" | sudo tee \
199     "${OPNFV_MNT_DIR}/etc/cloud/cloud.cfg.d/95_real_datasources.cfg"
200 }
201
202 function cleanup_mounts {
203   # Remove any mounts, loop and/or nbd devs created while patching base image
204   if [ -n "${OPNFV_MNT_DIR}" ] && [ -d "${OPNFV_MNT_DIR}" ]; then
205     if [ -f "${OPNFV_MNT_DIR}/boot/grub/grub.cfg" ]; then
206       # Grub thinks it's running from a live CD
207       sudo sed -i -e 's/^\s*set root=.*$//g' -e 's/^\s*loopback.*$//g' \
208         "${OPNFV_MNT_DIR}/boot/grub/grub.cfg"
209     fi
210     sudo rm -f "${OPNFV_MNT_DIR}/run/resolvconf/resolv.conf"
211     sync
212     if mountpoint -q "${OPNFV_MNT_DIR}"; then
213       sudo umount -l "${OPNFV_MNT_DIR}" || true
214     fi
215   fi
216   if [ -n "${OPNFV_LOOP_DEV}" ] && \
217     sudo losetup "${OPNFV_LOOP_DEV}" 1>&2 > /dev/null; then
218       sudo losetup -d "${OPNFV_LOOP_DEV}"
219   fi
220   if [ -n "${OPNFV_NBD_DEV}" ]; then
221     sudo kpartx -d "${OPNFV_NBD_DEV}" || true
222     sudo qemu-nbd -d "${OPNFV_NBD_DEV}" || true
223   fi
224 }
225
226 function cleanup_uefi {
227   # Clean up Ubuntu boot entry if cfg01, kvm nodes online from previous deploy
228   local cmd_str="ssh ${SSH_OPTS} ${SSH_SALT}"
229   ping -c 1 -w 1 "${SALT_MASTER}" || return 0
230   [ ! "$(hostname)" = 'cfg01' ] || cmd_str='eval'
231   ${cmd_str} "sudo salt -C 'kvm* or cmp*' cmd.run \
232     \"which efibootmgr > /dev/null 2>&1 && \
233     efibootmgr | grep -oP '(?<=Boot)[0-9]+(?=.*ubuntu)' | \
234     xargs -I{} efibootmgr --delete-bootnum --bootnum {}; \
235     rm -rf /boot/efi/*\"" || true
236 }
237
238 function cleanup_vms {
239   # clean up existing nodes
240   for node in $(virsh list --name | grep -P '\w{3}\d{2}'); do
241     virsh destroy "${node}"
242   done
243   for node in $(virsh list --name --all | grep -P '\w{3}\d{2}'); do
244     virsh domblklist "${node}" | awk '/^.da/ {print $2}' | \
245       xargs --no-run-if-empty -I{} sudo rm -f {}
246     virsh undefine "${node}" --remove-all-storage --nvram || \
247       virsh undefine "${node}" --remove-all-storage
248   done
249 }
250
251 function prepare_vms {
252   local base_image=$1; shift
253   local image_dir=$1; shift
254   local repos_pkgs_str=$1; shift # ^-sep list of repos, pkgs to install/rm
255   local vnodes=("$@")
256   local image=base_image_opnfv_fuel.img
257   local vcp_image=${image%.*}_vcp.img
258   local _o=${base_image/*\/}
259   local _h=$(echo "${repos_pkgs_str}.$(md5sum "${image_dir}/${_o}")" | \
260              md5sum | cut -c -8)
261   local _tmp
262
263   cleanup_uefi
264   cleanup_vms
265   get_base_image "${base_image}" "${image_dir}"
266   IFS='^' read -r -a repos_pkgs <<< "${repos_pkgs_str}"
267
268   echo "[INFO] Lookup cache / build patched base image for fingerprint: ${_h}"
269   _tmp="${image%.*}.${_h}.img"
270   if [ "${image_dir}/${_tmp}" -ef "${image_dir}/${image}" ]; then
271     echo "[INFO] Patched base image found"
272   else
273     rm -f "${image_dir}/${image%.*}"*
274     if [[ ! "${repos_pkgs_str}" =~ ^\^+$ ]]; then
275       echo "[INFO] Patching base image ..."
276       cp "${image_dir}/${_o}" "${image_dir}/${_tmp}"
277       __kernel_modules "${image_dir}"
278       mount_image "${_tmp}" "${image_dir}"
279       apt_repos_pkgs_image "${repos_pkgs[@]:0:4}"
280       cleanup_mounts
281     else
282       echo "[INFO] No patching required, using vanilla base image"
283       ln -sf "${image_dir}/${_o}" "${image_dir}/${_tmp}"
284     fi
285     ln -sf "${image_dir}/${_tmp}" "${image_dir}/${image}"
286   fi
287
288   # Create config ISO and resize OS disk image for each foundation node VM
289   for node in "${vnodes[@]}"; do
290     ./create-config-drive.sh -k "$(basename "${SSH_KEY}").pub" \
291        -u 'user-data.sh' -h "${node}" "${image_dir}/mcp_${node}.iso"
292     cp "${image_dir}/${image}" "${image_dir}/mcp_${node}.qcow2"
293     qemu-img resize "${image_dir}/mcp_${node}.qcow2" 100G
294     # Prepare dedicated drive for cinder on cmp nodes
295     if [[ "${node}" =~ ^(cmp) ]]; then
296       qemu-img create "${image_dir}/mcp_${node}_storage.qcow2" 100G
297     fi
298   done
299
300   # VCP VMs base image specific changes
301   if [[ ! "${repos_pkgs_str}" =~ \^{3}$ ]] && [ -n "${repos_pkgs[*]:4}" ]; then
302     echo "[INFO] Lookup cache / build patched VCP image for md5sum: ${_h}"
303     _tmp="${vcp_image%.*}.${_h}.img"
304     if [ "${image_dir}/${_tmp}" -ef "${image_dir}/${vcp_image}" ]; then
305       echo "[INFO] Patched VCP image found"
306     else
307       echo "[INFO] Patching VCP image ..."
308       cp "${image_dir}/${image}" "${image_dir}/${_tmp}"
309       __kernel_modules "${image_dir}"
310       mount_image "${_tmp}" "${image_dir}"
311       apt_repos_pkgs_image "${repos_pkgs[@]:4:4}"
312       cleanup_mounts
313       ln -sf "${image_dir}/${_tmp}" "${image_dir}/${vcp_image}"
314     fi
315   fi
316 }
317
318 function jumpserver_pkg_install {
319   local req_type=$1
320   if [ -n "$(command -v apt-get)" ]; then
321     pkg_type='deb'; pkg_cmd='sudo apt-get install -y'
322   else
323     pkg_type='rpm'; pkg_cmd='sudo yum install -y --skip-broken'
324   fi
325   eval "$(parse_yaml "./requirements_${pkg_type}.yaml")"
326   for section in 'common' "$(uname -i)"; do
327     section_var="${req_type}_${section}[*]"
328     pkg_list+=" ${!section_var}"
329   done
330   # shellcheck disable=SC2086
331   ${pkg_cmd} ${pkg_list}
332 }
333
334 function jumpserver_check_requirements {
335   # shellcheck disable=SC2178
336   local vnodes=$1; shift
337   local br=("$@")
338   local err_br_not_found='Linux bridge not found!'
339   local err_br_virsh_net='is a virtual network, Linux bridge expected!'
340   local warn_br_endpoint="Endpoints might be inaccessible from external hosts!"
341   # MaaS requires a Linux bridge for PXE/admin
342   if [[ "${vnodes}" =~ mas01 ]]; then
343     if ! brctl showmacs "${br[0]}" >/dev/null 2>&1; then
344       notify_e "[ERROR] PXE/admin (${br[0]}) ${err_br_not_found}"
345     fi
346     # Assume virsh network name matches bridge name (true if created by us)
347     if virsh net-info "${br[0]}" >/dev/null 2>&1; then
348       notify_e "[ERROR] ${br[0]} ${err_br_virsh_net}"
349     fi
350   fi
351   # If virtual nodes are present, public should be a Linux bridge
352   if [ "$(echo "${vnodes}" | wc -w)" -gt 2 ]; then
353     if ! brctl showmacs "${br[3]}" >/dev/null 2>&1; then
354       if [[ "${vnodes}" =~ mas01 ]]; then
355         # Baremetal nodes *require* a proper public network
356         notify_e "[ERROR] Public (${br[3]}) ${err_br_not_found}"
357       else
358         notify_n "[WARN] Public (${br[3]}) ${err_br_not_found}" 3
359         notify_n "[WARN] ${warn_br_endpoint}" 3
360       fi
361     fi
362     if virsh net-info "${br[3]}" >/dev/null 2>&1; then
363       if [[ "${vnodes}" =~ mas01 ]]; then
364         notify_e "[ERROR] ${br[3]} ${err_br_virsh_net}"
365       else
366         notify_n "[WARN] ${br[3]} ${err_br_virsh_net}" 3
367         notify_n "[WARN] ${warn_br_endpoint}" 3
368       fi
369     fi
370   fi
371 }
372
373 function create_networks {
374   local all_vnode_networks=("mcpcontrol" "$@")
375   # create required networks, including constant "mcpcontrol"
376   for net in "${all_vnode_networks[@]}"; do
377     if virsh net-info "${net}" >/dev/null 2>&1; then
378       virsh net-destroy "${net}" || true
379       virsh net-undefine "${net}"
380     fi
381     # in case of custom network, host should already have the bridge in place
382     if [ -f "virsh_net/net_${net}.xml" ] && \
383      [ ! -d "/sys/class/net/${net}/bridge" ]; then
384       virsh net-define "virsh_net/net_${net}.xml"
385       virsh net-autostart "${net}"
386       virsh net-start "${net}"
387     fi
388   done
389   # create veth pairs for relevant networks (mcpcontrol, pxebr, mgmt)
390   for i in $(seq 0 2 4); do
391     sudo ip link del "veth_mcp$i" || true
392     sudo ip link add "veth_mcp$i" type veth peer name "veth_mcp$((i+1))"
393     sudo ip link set "veth_mcp$i" up mtu 9000
394     sudo ip link set "veth_mcp$((i+1))" up mtu 9000
395     sudo brctl addif "${all_vnode_networks[$((i/2))]}" "veth_mcp$i"
396   done
397 }
398
399 function create_vms {
400   local image_dir=$1; shift
401   # vnode data should be serialized with the following format:
402   #   <name0>,<ram0>,<vcpu0>[,<sockets0>,<cores0>,<threads0>[,<cell0name0>,<cell0memory0>,
403   #   <cell0cpus0>,<cell1name0>,<cell1memory0>,<cell1cpus0>]]|<name1>,...'
404   IFS='|' read -r -a vnodes <<< "$1"; shift
405
406   # AArch64: prepare arch specific arguments
407   local virt_extra_args=""
408   if [ "$(uname -i)" = "aarch64" ]; then
409     # No Cirrus VGA on AArch64, use virtio instead
410     virt_extra_args="$virt_extra_args --video=virtio"
411   fi
412
413   # create vms with specified options
414   for serialized_vnode_data in "${vnodes[@]}"; do
415     if [ -z "${serialized_vnode_data}" ]; then continue; fi
416     IFS=',' read -r -a vnode_data <<< "${serialized_vnode_data}"
417
418     # prepare VM CPU model, count, topology (optional), NUMA cells (optional, requires topo)
419     local virt_cpu_args=' --cpu host-passthrough'
420     local idx=6  # cell0.name index in serialized data
421     while [ -n "${vnode_data[${idx}]}" ]; do
422       virt_cpu_args+=",${vnode_data[${idx}]}.memory=${vnode_data[$((idx + 1))]}"
423       virt_cpu_args+=",${vnode_data[${idx}]}.cpus=${vnode_data[$((idx + 2))]}"
424       idx=$((idx + 3))
425     done
426     virt_cpu_args+=" --vcpus vcpus=${vnode_data[2]}"
427     if [ -n "${vnode_data[5]}" ]; then
428       virt_cpu_args+=",sockets=${vnode_data[3]},cores=${vnode_data[4]},threads=${vnode_data[5]}"
429     fi
430
431     # prepare network args
432     local vnode_networks=("$@")
433     if [[ "${vnode_data[0]}" =~ ^(cfg01|mas01) ]]; then
434       net_args=" --network network=mcpcontrol,model=virtio"
435       # 3rd interface gets connected to PXE/Admin Bridge (cfg01, mas01)
436       vnode_networks[2]="${vnode_networks[0]}"
437     else
438       net_args=" --network bridge=${vnode_networks[0]},model=virtio"
439     fi
440     for net in "${vnode_networks[@]:1}"; do
441       net_args="${net_args} --network bridge=${net},model=virtio"
442     done
443
444     # dedicated storage drive for cinder on cmp nodes
445     virt_extra_storage=
446     if [[ "${vnode_data[0]}" =~ ^(cmp) ]]; then
447       virt_extra_storage="--disk path=${image_dir}/mcp_${vnode_data[0]}_storage.qcow2,format=qcow2,bus=virtio,cache=none,io=native"
448     fi
449
450     [ ! -e "${image_dir}/virt-manager" ] || VIRT_PREFIX="${image_dir}/virt-manager/"
451     # shellcheck disable=SC2086
452     ${VIRT_PREFIX}virt-install --name "${vnode_data[0]}" \
453     ${virt_cpu_args} --accelerate \
454     ${net_args} \
455     --ram "${vnode_data[1]}" \
456     --disk path="${image_dir}/mcp_${vnode_data[0]}.qcow2",format=qcow2,bus=virtio,cache=none,io=native \
457     ${virt_extra_storage} \
458     --os-type linux --os-variant none \
459     --boot hd --vnc --console pty --autostart --noreboot \
460     --disk path="${image_dir}/mcp_${vnode_data[0]}.iso",device=cdrom \
461     --noautoconsole \
462     ${virt_extra_args}
463   done
464 }
465
466 function reset_vms {
467   local vnodes=("$@")
468   local cmd_str="ssh ${SSH_OPTS} ${SSH_SALT}"
469
470   # reset non-infrastructure vms, wait for them to come back online
471   for node in "${vnodes[@]}"; do
472     if [[ ! "${node}" =~ (cfg01|mas01) ]]; then
473       virsh reset "${node}"
474     fi
475   done
476   for node in "${vnodes[@]}"; do
477     if [[ ! "${node}" =~ (cfg01|mas01) ]]; then
478       wait_for 20.0 "${cmd_str} sudo salt -C '${node}*' saltutil.sync_all"
479     fi
480   done
481 }
482
483 function start_vms {
484   local vnodes=("$@")
485
486   # start vms
487   for node in "${vnodes[@]}"; do
488     virsh start "${node}"
489     sleep $((RANDOM%5+1))
490   done
491 }
492
493 function prepare_containers {
494   local image_dir=$1
495   [ -n "${image_dir}" ] || exit 1
496   [ -n "${MCP_REPO_ROOT_PATH}" ] || exit 1
497   docker-compose --version > /dev/null 2>&1 || COMPOSE_PREFIX="${image_dir}/"
498
499   "${COMPOSE_PREFIX}docker-compose" -f docker-compose/docker-compose.yaml down
500   if [[ ! "${MCP_DOCKER_TAG}" =~ 'verify' ]]; then
501     "${COMPOSE_PREFIX}docker-compose" -f docker-compose/docker-compose.yaml pull
502   fi
503   sudo rm -rf "${image_dir}/"{salt,hosts,pki} "${image_dir}/nodes/"*
504   mkdir -p "${image_dir}/salt/"{master.d,minion.d}
505   touch "${image_dir}/hosts"
506 }
507
508 function start_containers {
509   local image_dir=$1
510   [ -n "${image_dir}" ] || exit 1
511   docker-compose --version > /dev/null 2>&1 || COMPOSE_PREFIX="${image_dir}/"
512   "${COMPOSE_PREFIX}docker-compose" -f docker-compose/docker-compose.yaml up -d
513 }
514
515 function check_connection {
516   local total_attempts=60
517   local sleep_time=5
518
519   set +e
520   echo '[INFO] Attempting to get into Salt master ...'
521
522   # wait until ssh on Salt master is available
523   # shellcheck disable=SC2034
524   for attempt in $(seq "${total_attempts}"); do
525     # shellcheck disable=SC2086
526     ssh ${SSH_OPTS} "ubuntu@${SALT_MASTER}" uptime
527     case $? in
528       0) echo "${attempt}> Success"; break ;;
529       *) echo "${attempt}/${total_attempts}> ssh server ain't ready yet, waiting for ${sleep_time} seconds ..." ;;
530     esac
531     sleep $sleep_time
532   done
533   set -e
534 }
535
536 function parse_yaml {
537   local prefix=$2
538   local s
539   local w
540   local fs
541   s='[[:space:]]*'
542   w='[a-zA-Z0-9_]*'
543   fs="$(echo @|tr @ '\034')"
544   sed -e 's|---||g' -ne "s|^\($s\)\($w\)$s:$s\"\(.*\)\"$s\$|\1$fs\2$fs\3|p" \
545       -e "s|^\($s\)\($w\)$s[:-]$s\(.*\)$s\$|\1$fs\2$fs\3|p" "$1" |
546   awk -F"$fs" '{
547   indent = length($1)/2;
548   vname[indent] = $2;
549   for (i in vname) {if (i > indent) {delete vname[i]}}
550       if (length($3) > 0) {
551           vn=""; for (i=0; i<indent; i++) {vn=(vn)(vname[i])("_")}
552           printf("%s%s%s=(\"%s\")\n", "'"$prefix"'",vn, $2, $3);
553       }
554   }' | sed 's/_=/+=/g'
555 }
556
557 function wait_for {
558   # Execute in a subshell to prevent local variable override during recursion
559   (
560     local total_attempts=$1; shift
561     local cmdstr=$*
562     local sleep_time=10
563     echo -e "\n[wait_for] Waiting for cmd to return success: ${cmdstr}"
564     # shellcheck disable=SC2034
565     for attempt in $(seq "${total_attempts}"); do
566       echo "[wait_for] Attempt ${attempt}/${total_attempts%.*} for: ${cmdstr}"
567       if [ "${total_attempts%.*}" = "${total_attempts}" ]; then
568         eval "${cmdstr}" && echo "[wait_for] OK: ${cmdstr}" && return 0 || true
569       else
570         ! (eval "${cmdstr}" || echo 'No response') |& tee /dev/stderr | \
571            grep -Eq '(Not connected|No response)' && \
572            echo "[wait_for] OK: ${cmdstr}" && return 0 || true
573       fi
574       sleep "${sleep_time}"
575     done
576     echo "[wait_for] ERROR: Failed after max attempts: ${cmdstr}"
577     return 1
578   )
579 }
580
581 function do_udev_cfg {
582   local _conf='/etc/udev/rules.d/99-opnfv-fuel-vnet-mtu.rules'
583   # http://linuxaleph.blogspot.com/2013/01/how-to-network-jumbo-frames-to-kvm-guest.html
584   echo 'SUBSYSTEM=="net", ACTION=="add|change", KERNEL=="vnet*", RUN+="/bin/sh -c '"'/bin/sleep 1; /sbin/ip link set %k mtu 9000'\"" |& sudo tee "${_conf}"
585   echo 'SUBSYSTEM=="net", ACTION=="add|change", KERNEL=="*-nic", RUN+="/bin/sh -c '"'/bin/sleep 1; /sbin/ip link set %k mtu 9000'\"" |& sudo tee -a "${_conf}"
586   sudo udevadm control --reload
587   sudo udevadm trigger
588 }
589
590 function do_sysctl_cfg {
591   local _conf='/etc/sysctl.d/99-opnfv-fuel-bridge.conf'
592   # https://wiki.libvirt.org/page/Net.bridge.bridge-nf-call_and_sysctl.conf
593   if modprobe br_netfilter bridge; then
594     echo 'net.bridge.bridge-nf-call-arptables = 0' |& sudo tee "${_conf}"
595     echo 'net.bridge.bridge-nf-call-iptables = 0'  |& sudo tee -a "${_conf}"
596     echo 'net.bridge.bridge-nf-call-ip6tables = 0' |& sudo tee -a "${_conf}"
597     # Some distros / sysadmins explicitly blacklist br_netfilter
598     sudo sysctl -q -p "${_conf}" || true
599   fi
600 }
601
602 function get_nova_compute_pillar_data {
603   local value=$(salt -C 'I@nova:compute and *01*' pillar.get _param:"${1}" --out yaml | cut -d ' ' -f2)
604   if [ "${value}" != "''" ]; then
605     echo "${value}"
606   fi
607 }
608
609 function docker_install {
610   local image_dir=$1
611   # Mininum effort attempt at installing Docker if missing
612   if ! docker --version; then
613     curl -fsSL https://get.docker.com -o get-docker.sh
614     sudo sh get-docker.sh
615     rm get-docker.sh
616     # On RHEL distros, the Docker service should be explicitly started
617     sudo systemctl start docker
618   else
619     DOCKER_VER=$(docker version --format '{{.Server.Version}}')
620     if [ "${DOCKER_VER%%.*}" -lt 2 ]; then
621       notify_e "[ERROR] Docker version ${DOCKER_VER} is too old, please upgrade it."
622     fi
623   fi
624   # Distro-provided docker-compose might be simply broken (Ubuntu 16.04, CentOS 7)
625   if ! docker-compose --version > /dev/null 2>&1; then
626     COMPOSE_BIN="${image_dir}/docker-compose"
627     COMPOSE_VERSION='1.22.0'
628     notify_n "[WARN] Using docker-compose ${COMPOSE_VERSION} in ${COMPOSE_BIN}" 3
629     if [ ! -e "${COMPOSE_BIN}" ]; then
630       COMPOSE_URL="https://github.com/docker/compose/releases/download/${COMPOSE_VERSION}"
631       sudo curl -L "${COMPOSE_URL}/docker-compose-$(uname -s)-$(uname -m)" -o "${COMPOSE_BIN}"
632       sudo chmod +x "${COMPOSE_BIN}"
633     fi
634   fi
635 }
636
637 function virtinst_install {
638   local image_dir=$1
639   VIRT_VER=$(virt-install --version 2>&1)
640   if [ "${VIRT_VER//./}" -lt 140 ]; then
641     VIRT_TGZ="${image_dir}/virt-manager.tar.gz"
642     VIRT_VER='1.4.3'
643     VIRT_URL="https://github.com/virt-manager/virt-manager/archive/v${VIRT_VER}.tar.gz"
644     notify_n "[WARN] Using virt-install ${VIRT_VER} from ${VIRT_TGZ}" 3
645     if [ ! -e "${VIRT_TGZ}" ]; then
646       curl -L "${VIRT_URL}" -o "${VIRT_TGZ}"
647       mkdir -p "${image_dir}/virt-manager"
648       tar xzf "${VIRT_TGZ}" -C "${image_dir}/virt-manager" --strip-components=1
649     fi
650   fi
651 }