# (c) Copyright IBM Corp. 2020 All Rights Reserved # # Author: Aman Kumar Sinha # # This file is part of cloud-init. See LICENSE file for license information. """Refresh IPv6 interface and RMC: Ensure Network Manager is not managing IPv6 interface""" import errno from cloudinit import log as logging from cloudinit import netinfo, subp, util from cloudinit.cloud import Cloud from cloudinit.config import Config from cloudinit.config.schema import MetaSchema from cloudinit.distros import ALL_DISTROS from cloudinit.settings import PER_ALWAYS MODULE_DESCRIPTION = """\ This module is IBM PowerVM Hypervisor specific Reliable Scalable Cluster Technology (RSCT) is a set of software components that together provide a comprehensive clustering environment(RAS features) for IBM PowerVM based virtual machines. RSCT includes the Resource Monitoring and Control (RMC) subsystem. RMC is a generalized framework used for managing, monitoring, and manipulating resources. RMC runs as a daemon process on individual machines and needs creation of unique node id and restarts during VM boot. More details refer https://www.ibm.com/support/knowledgecenter/en/SGVKBA_3.2/admin/bl503_ovrv.htm This module handles - Refreshing RMC - Disabling NetworkManager from handling IPv6 interface, as IPv6 interface is used for communication between RMC daemon and PowerVM hypervisor. """ meta: MetaSchema = { "id": "cc_refresh_rmc_and_interface", "name": "Refresh IPv6 Interface and RMC", "title": "Ensure Network Manager is not managing IPv6 interface", "description": MODULE_DESCRIPTION, "distros": [ALL_DISTROS], "frequency": PER_ALWAYS, "examples": [], "activate_by_schema_keys": [], } # This module is undocumented in our schema docs __doc__ = "" LOG = logging.getLogger(__name__) # Ensure that /opt/rsct/bin has been added to standard PATH of the # distro. The symlink to rmcctrl is /usr/sbin/rsct/bin/rmcctrl . RMCCTRL = "rmcctrl" def handle(name: str, cfg: Config, cloud: Cloud, args: list) -> None: if not subp.which(RMCCTRL): LOG.debug("No '%s' in path, disabled", RMCCTRL) return LOG.debug( "Making the IPv6 up explicitly. " "Ensuring IPv6 interface is not being handled by NetworkManager " "and it is restarted to re-establish the communication with " "the hypervisor" ) ifaces = find_ipv6_ifaces() # Setting NM_CONTROLLED=no for IPv6 interface # making it down and up if len(ifaces) == 0: LOG.debug("Did not find any interfaces with ipv6 addresses.") else: for iface in ifaces: refresh_ipv6(iface) disable_ipv6(sysconfig_path(iface)) restart_network_manager() def find_ipv6_ifaces(): info = netinfo.netdev_info() ifaces = [] for iface, data in info.items(): if iface == "lo": LOG.debug("Skipping localhost interface") if len(data.get("ipv4", [])) != 0: # skip this interface, as it has ipv4 addrs continue ifaces.append(iface) return ifaces def refresh_ipv6(interface): # IPv6 interface is explicitly brought up, subsequent to which the # RMC services are restarted to re-establish the communication with # the hypervisor. subp.subp(["ip", "link", "set", interface, "down"]) subp.subp(["ip", "link", "set", interface, "up"]) def sysconfig_path(iface): return "/etc/sysconfig/network-scripts/ifcfg-" + iface def restart_network_manager(): subp.subp(["systemctl", "restart", "NetworkManager"]) def disable_ipv6(iface_file): # Ensuring that the communication b/w the hypervisor and VM is not # interrupted due to NetworkManager. For this purpose, as part of # this function, the NM_CONTROLLED is explicitly set to No for IPV6 # interface and NetworkManager is restarted. try: contents = util.load_file(iface_file) except IOError as e: if e.errno == errno.ENOENT: LOG.debug("IPv6 interface file %s does not exist\n", iface_file) else: raise e if "IPV6INIT" not in contents: LOG.debug("Interface file %s did not have IPV6INIT", iface_file) return LOG.debug("Editing interface file %s ", iface_file) # Dropping any NM_CONTROLLED or IPV6 lines from IPv6 interface file. lines = contents.splitlines() lines = [line for line in lines if not search(line)] lines.append("NM_CONTROLLED=no") with open(iface_file, "w") as fp: fp.write("\n".join(lines) + "\n") def search(contents): # Search for any NM_CONTROLLED or IPV6 lines in IPv6 interface file. return ( contents.startswith("IPV6ADDR") or contents.startswith("IPADDR6") or contents.startswith("IPV6INIT") or contents.startswith("NM_CONTROLLED") )