2 # NEPI, a framework to manage network experiments
3 # Copyright (C) 2013 INRIA
5 # This program is free software: you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation, either version 3 of the License, or
8 # (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program. If not, see <http://www.gnu.org/licenses/>.
18 # Author: Alina Quereilhac <alina.quereilhac@inria.fr>
20 from nepi.execution.attribute import Attribute, Flags
21 from nepi.execution.resource import ResourceManager, clsinit, ResourceState
22 from nepi.resources.linux import rpmfuncs, debfuncs
23 from nepi.util import sshfuncs, execfuncs
24 from nepi.util.sshfuncs import ProcStatus
34 # TODO: Verify files and dirs exists already
35 # TODO: Blacklist nodes!
36 # TODO: Unify delays!!
37 # TODO: Validate outcome of uploads!!
39 reschedule_delay = "0.5s"
43 Error codes that the rexitcode function can return if unable to
44 check the exit code of a spawned process
53 Supported flavors of Linux OS
62 class LinuxNode(ResourceManager):
66 def _register_attributes(cls):
67 hostname = Attribute("hostname", "Hostname of the machine",
68 flags = Flags.ExecReadOnly)
70 username = Attribute("username", "Local account username",
71 flags = Flags.Credential)
73 port = Attribute("port", "SSH port", flags = Flags.ExecReadOnly)
75 home = Attribute("home",
76 "Experiment home directory to store all experiment related files",
77 flags = Flags.ExecReadOnly)
79 identity = Attribute("identity", "SSH identity file",
80 flags = Flags.Credential)
82 server_key = Attribute("serverKey", "Server public key",
83 flags = Flags.ExecReadOnly)
85 clean_home = Attribute("cleanHome", "Remove all files and directories " + \
86 " from home folder before starting experiment",
87 flags = Flags.ExecReadOnly)
89 clean_processes = Attribute("cleanProcesses",
90 "Kill all running processes before starting experiment",
91 flags = Flags.ExecReadOnly)
93 tear_down = Attribute("tearDown", "Bash script to be executed before " + \
94 "releasing the resource",
95 flags = Flags.ExecReadOnly)
97 cls._register_attribute(hostname)
98 cls._register_attribute(username)
99 cls._register_attribute(port)
100 cls._register_attribute(home)
101 cls._register_attribute(identity)
102 cls._register_attribute(server_key)
103 cls._register_attribute(clean_home)
104 cls._register_attribute(clean_processes)
105 cls._register_attribute(tear_down)
107 def __init__(self, ec, guid):
108 super(LinuxNode, self).__init__(ec, guid)
111 # lock to avoid concurrency issues on methods used by applications
112 self._lock = threading.Lock()
114 def log_message(self, msg):
115 return " guid %d - host %s - %s " % (self.guid,
116 self.get("hostname"), msg)
120 return self.get("home") or ""
124 return os.path.join(self.home, self.ec.exp_id)
128 node_home = "node-%d" % self.guid
129 return os.path.join(self.exp_home, node_home)
136 if (not self.get("hostname") or not self.get("username")):
137 msg = "Can't resolve OS, insufficient data "
139 raise RuntimeError, msg
141 (out, err), proc = self.execute("cat /etc/issue", with_lock = True)
143 if err and proc.poll():
144 msg = "Error detecting OS "
145 self.error(msg, out, err)
146 raise RuntimeError, "%s - %s - %s" %( msg, out, err )
148 if out.find("Fedora release 12") == 0:
149 self._os = OSType.FEDORA_12
150 elif out.find("Fedora release 14") == 0:
151 self._os = OSType.FEDORA_14
152 elif out.find("Debian") == 0:
153 self._os = OSType.DEBIAN
154 elif out.find("Ubuntu") ==0:
155 self._os = OSType.UBUNTU
157 msg = "Unsupported OS"
159 raise RuntimeError, "%s - %s " %( msg, out )
165 return self.get("hostname") in ['localhost', '127.0.0.7', '::1']
168 if not self.is_alive():
169 self._state = ResourceState.FAILED
170 msg = "Deploy failed. Unresponsive node %s" % self.get("hostname")
172 raise RuntimeError, msg
174 if self.get("cleanProcesses"):
175 self.clean_processes()
177 if self.get("cleanHome"):
180 self.mkdir(self.node_home)
182 super(LinuxNode, self).provision()
185 if self.state == ResourceState.NEW:
190 self._state = ResourceState.FAILED
193 # Node needs to wait until all associated interfaces are
194 # ready before it can finalize deployment
195 from nepi.resources.linux.interface import LinuxInterface
196 ifaces = self.get_connected(LinuxInterface.rtype())
198 if iface.state < ResourceState.READY:
199 self.ec.schedule(reschedule_delay, self.deploy)
202 super(LinuxNode, self).deploy()
205 tear_down = self.get("tearDown")
207 self.execute(tear_down)
209 super(LinuxNode, self).release()
211 def valid_connection(self, guid):
215 def clean_processes(self, killer = False):
216 self.info("Cleaning up processes")
220 cmd = ("sudo -S killall python tcpdump || /bin/true ; " +
221 "sudo -S killall python tcpdump || /bin/true ; " +
222 "sudo -S kill $(ps -N -T -o pid --no-heading | grep -v $PPID | sort) || /bin/true ; " +
223 "sudo -S killall -u root || /bin/true ; " +
224 "sudo -S killall -u root || /bin/true ; ")
227 cmd = ("sudo -S killall tcpdump || /bin/true ; " +
228 "sudo -S killall tcpdump || /bin/true ; " +
229 "sudo -S killall -u %s || /bin/true ; " % self.get("username") +
230 "sudo -S killall -u %s || /bin/true ; " % self.get("username"))
233 (out, err), proc = self.execute(cmd, retry = 1, with_lock = True)
235 def clean_home(self):
236 self.info("Cleaning up home")
239 # "find . -maxdepth 1 \( -name '.cache' -o -name '.local' -o -name '.config' -o -name 'nepi-*' \)" +
240 "find . -maxdepth 1 -name 'nepi-*' " +
241 " -execdir rm -rf {} + "
245 cmd = "cd %s ; " % self.home + cmd
248 (out, err), proc = self.execute(cmd, with_lock = True)
250 def upload(self, src, dst, text = False):
251 """ Copy content to destination
253 src content to copy. Can be a local file, directory or a list of files
255 dst destination path on the remote host (remote is always self.host)
257 text src is text input, it must be stored into a temp file before uploading
259 # If source is a string input
261 if text and not os.path.isfile(src):
262 # src is text input that should be uploaded as file
263 # create a temporal file with the content to upload
264 f = tempfile.NamedTemporaryFile(delete=False)
269 if not self.localhost:
270 # Build destination as <user>@<server>:<path>
271 dst = "%s@%s:%s" % (self.get("username"), self.get("hostname"), dst)
273 result = self.copy(src, dst)
281 def download(self, src, dst):
282 if not self.localhost:
283 # Build destination as <user>@<server>:<path>
284 src = "%s@%s:%s" % (self.get("username"), self.get("hostname"), src)
285 return self.copy(src, dst)
287 def install_packages(self, packages, home):
289 if self.os in [OSType.FEDORA_12, OSType.FEDORA_14, OSType.FEDORA]:
290 command = rpmfuncs.install_packages_command(self.os, packages)
291 elif self.os in [OSType.DEBIAN, OSType.UBUNTU]:
292 command = debfuncs.install_packages_command(self.os, packages)
294 msg = "Error installing packages ( OS not known ) "
295 self.error(msg, self.os)
296 raise RuntimeError, msg
299 (out, err), proc = self.run_and_wait(command, home,
300 shfile = "instpkg.sh",
301 pidfile = "instpkg_pidfile",
302 ecodefile = "instpkg_exitcode",
303 stdout = "instpkg_stdout",
304 stderr = "instpkg_stderr",
305 raise_on_error = True)
307 return (out, err), proc
309 def remove_packages(self, packages, home):
311 if self.os in [OSType.FEDORA_12, OSType.FEDORA_14, OSType.FEDORA]:
312 command = rpmfuncs.remove_packages_command(self.os, packages)
313 elif self.os in [OSType.DEBIAN, OSType.UBUNTU]:
314 command = debfuncs.remove_packages_command(self.os, packages)
316 msg = "Error removing packages ( OS not known ) "
318 raise RuntimeError, msg
321 (out, err), proc = self.run_and_wait(command, home,
323 pidfile = "rmpkg_pidfile",
324 ecodefile = "rmpkg_exitcode",
325 stdout = "rmpkg_stdout",
326 stderr = "rmpkg_stderr",
327 raise_on_error = True)
329 return (out, err), proc
331 def mkdir(self, path, clean = False):
335 return self.execute("mkdir -p %s" % path, with_lock = True)
337 def rmdir(self, path):
338 return self.execute("rm -rf %s" % path, with_lock = True)
340 def run_and_wait(self, command, home,
343 ecodefile = "exitcode",
349 raise_on_error = False):
351 runs a command in background on the remote host, busy-waiting
352 until the command finishes execution.
353 This is more robust than doing a simple synchronized 'execute',
354 since in the remote host the command can continue to run detached
355 even if network disconnections occur
357 self.upload_command(command, home, shfile, ecodefile)
359 command = "bash ./%s" % shfile
360 # run command in background in remote host
361 (out, err), proc = self.run(command, home,
369 # check no errors occurred
370 if proc.poll() and err:
371 msg = " Failed to run command '%s' " % command
372 self.error(msg, out, err)
374 raise RuntimeError, msg
376 # Wait for pid file to be generated
377 pid, ppid = self.wait_pid(
380 raise_on_error = raise_on_error)
382 # wait until command finishes to execute
383 self.wait_run(pid, ppid)
385 (out, err), proc = self.check_errors(home, ecodefile, stderr)
387 # Out is what was written in the stderr file
389 msg = " Failed to run command '%s' " % command
390 self.error(msg, out, err)
393 raise RuntimeError, msg
395 return (out, err), proc
397 def exitcode(self, home, ecodefile = "exitcode"):
399 Get the exit code of an application.
400 Returns an integer value with the exit code
402 (out, err), proc = self.check_output(home, ecodefile)
404 # Succeeded to open file, return exit code in the file
407 return int(out.strip())
409 # Error in the content of the file!
410 return ExitCode.CORRUPTFILE
412 # No such file or directory
413 if proc.returncode == 1:
414 return ExitCode.FILENOTFOUND
416 # Other error from 'cat'
417 return ExitCode.ERROR
419 def upload_command(self, command, home,
421 ecodefile = "exitcode",
424 command = " ( %(command)s ) ; echo $? > %(ecodefile)s " % {
426 'ecodefile': ecodefile,
432 for var in env.split(" "):
433 environ += 'export %s\n' % var
435 command = environ + command
437 dst = os.path.join(home, shfile)
438 return self.upload(command, dst, text = True)
440 def check_errors(self, home,
441 ecodefile = "exitcode",
444 Checks whether errors occurred while running a command.
445 It first checks the exit code for the command, and only if the
446 exit code is an error one it returns the error output.
452 ecode = self.exitcode(home, ecodefile)
454 if ecode in [ ExitCode.CORRUPTFILE, ExitCode.ERROR ]:
455 err = "Error retrieving exit code status from file %s/%s" % (home, ecodefile)
456 elif ecode > 0 or ecode == ExitCode.FILENOTFOUND:
457 # The process returned an error code or didn't exist.
458 # Check standard error.
459 (out, err), proc = self.check_output(home, stderr)
461 # If the stderr file was not found, assume nothing happened.
462 # We just ignore the error.
463 # (cat returns 1 for error "No such file or directory")
464 if ecode == ExitCode.FILENOTFOUND and proc.poll() == 1:
467 return (out, err), proc
469 def wait_pid(self, home, pidfile = "pidfile", raise_on_error = False):
470 """ Waits until the pid file for the command is generated,
471 and returns the pid and ppid of the process """
476 pidtuple = self.getpid(home = home, pidfile = pidfile)
485 msg = " Failed to get pid for pidfile %s/%s " % (
490 raise RuntimeError, msg
494 def wait_run(self, pid, ppid, trial = 0):
495 """ wait for a remote process to finish execution """
499 status = self.status(pid, ppid)
501 if status is ProcStatus.FINISHED:
503 elif status is not ProcStatus.RUNNING:
506 # If it takes more than 20 seconds to start, then
507 # asume something went wrong
511 # The app is running, just wait...
514 def check_output(self, home, filename):
515 """ Retrives content of file """
516 (out, err), proc = self.execute("cat %s" %
517 os.path.join(home, filename), retry = 1, with_lock = True)
518 return (out, err), proc
526 # TODO: FIX NOT ALIVE!!!!
527 (out, err), proc = self.execute("echo 'ALIVE' || (echo 'NOTALIVE') >&2", retry = 5,
531 trace = traceback.format_exc()
532 msg = "Unresponsive host %s " % err
533 self.error(msg, out, trace)
536 if out.strip().startswith('ALIVE'):
539 msg = "Unresponsive host "
540 self.error(msg, out, err)
543 def copy(self, src, dst):
545 (out, err), proc = execfuncs.lcopy(source, dest,
547 strict_host_checking = False)
550 (out, err), proc = sshfuncs.rcopy(
552 port = self.get("port"),
553 identity = self.get("identity"),
554 server_key = self.get("serverKey"),
556 strict_host_checking = False)
558 return (out, err), proc
560 def execute(self, command,
568 err_on_timeout = True,
569 connect_timeout = 30,
570 strict_host_checking = False,
574 """ Notice that this invocation will block until the
575 execution finishes. If this is not the desired behavior,
576 use 'run' instead."""
579 (out, err), proc = execfuncs.lexec(command,
587 (out, err), proc = sshfuncs.rexec(
589 host = self.get("hostname"),
590 user = self.get("username"),
591 port = self.get("port"),
595 identity = self.get("identity"),
596 server_key = self.get("serverKey"),
599 forward_x11 = forward_x11,
602 err_on_timeout = err_on_timeout,
603 connect_timeout = connect_timeout,
604 persistent = persistent,
605 strict_host_checking = strict_host_checking
608 (out, err), proc = sshfuncs.rexec(
610 host = self.get("hostname"),
611 user = self.get("username"),
612 port = self.get("port"),
616 identity = self.get("identity"),
617 server_key = self.get("serverKey"),
620 forward_x11 = forward_x11,
623 err_on_timeout = err_on_timeout,
624 connect_timeout = connect_timeout,
625 persistent = persistent
628 return (out, err), proc
630 def run(self, command, home,
639 self.debug("Running command '%s'" % command)
642 (out, err), proc = execfuncs.lspawn(command, pidfile,
647 create_home = create_home,
652 (out, err), proc = sshfuncs.rspawn(
656 create_home = create_home,
657 stdin = stdin if stdin is not None else '/dev/null',
658 stdout = stdout if stdout else '/dev/null',
659 stderr = stderr if stderr else '/dev/null',
661 host = self.get("hostname"),
662 user = self.get("username"),
663 port = self.get("port"),
665 identity = self.get("identity"),
666 server_key = self.get("serverKey"),
670 return (out, err), proc
672 def getpid(self, home, pidfile = "pidfile"):
674 pidtuple = execfuncs.lgetpid(os.path.join(home, pidfile))
677 pidtuple = sshfuncs.rgetpid(
678 os.path.join(home, pidfile),
679 host = self.get("hostname"),
680 user = self.get("username"),
681 port = self.get("port"),
683 identity = self.get("identity"),
684 server_key = self.get("serverKey")
689 def status(self, pid, ppid):
691 status = execfuncs.lstatus(pid, ppid)
694 status = sshfuncs.rstatus(
696 host = self.get("hostname"),
697 user = self.get("username"),
698 port = self.get("port"),
700 identity = self.get("identity"),
701 server_key = self.get("serverKey")
706 def kill(self, pid, ppid, sudo = False):
709 status = self.status(pid, ppid)
711 if status == sshfuncs.ProcStatus.RUNNING:
713 (out, err), proc = execfuncs.lkill(pid, ppid, sudo)
716 (out, err), proc = sshfuncs.rkill(
718 host = self.get("hostname"),
719 user = self.get("username"),
720 port = self.get("port"),
723 identity = self.get("identity"),
724 server_key = self.get("serverKey")
727 return (out, err), proc