| import os, time, types, socket, shutil, glob, logging |
| from autotest_lib.client.common_lib import error |
| from autotest_lib.server import utils, autotest |
| from autotest_lib.server.hosts import remote |
| |
| |
| def make_ssh_command(user="root", port=22, opts='', connect_timeout=30): |
| base_command = ("/usr/bin/ssh -a -x %s -o BatchMode=yes " |
| "-o ConnectTimeout=%d -o ServerAliveInterval=300 " |
| "-l %s -p %d") |
| assert isinstance(connect_timeout, (int, long)) |
| assert connect_timeout > 0 # can't disable the timeout |
| return base_command % (opts, connect_timeout, user, port) |
| |
| |
| # import site specific Host class |
| SiteHost = utils.import_site_class( |
| __file__, "autotest_lib.server.hosts.site_host", "SiteHost", |
| remote.RemoteHost) |
| |
| |
| class AbstractSSHHost(SiteHost): |
| """ This class represents a generic implementation of most of the |
| framework necessary for controlling a host via ssh. It implements |
| almost all of the abstract Host methods, except for the core |
| Host.run method. """ |
| |
| def _initialize(self, hostname, user="root", port=22, password="", |
| *args, **dargs): |
| super(AbstractSSHHost, self)._initialize(hostname=hostname, |
| *args, **dargs) |
| self.ip = socket.getaddrinfo(self.hostname, None)[0][4][0] |
| self.user = user |
| self.port = port |
| self.password = password |
| |
| |
| def _encode_remote_paths(self, paths): |
| """ Given a list of file paths, encodes it as a single remote path, in |
| the style used by rsync and scp. """ |
| escaped_paths = [utils.scp_remote_escape(path) for path in paths] |
| return '%s@%s:"%s"' % (self.user, self.hostname, |
| " ".join(paths)) |
| |
| |
| def _make_rsync_cmd(self, sources, dest, delete_dest): |
| """ Given a list of source paths and a destination path, produces the |
| appropriate rsync command for copying them. Remote paths must be |
| pre-encoded. """ |
| ssh_cmd = make_ssh_command(self.user, self.port) |
| if delete_dest: |
| delete_flag = "--delete" |
| else: |
| delete_flag = "" |
| command = "rsync -L %s --timeout=1800 --rsh='%s' -az %s %s" |
| return command % (delete_flag, ssh_cmd, " ".join(sources), dest) |
| |
| |
| def _make_scp_cmd(self, sources, dest): |
| """ Given a list of source paths and a destination path, produces the |
| appropriate scp command for encoding it. Remote paths must be |
| pre-encoded. """ |
| command = "scp -rpq -P %d %s '%s'" |
| return command % (self.port, " ".join(sources), dest) |
| |
| |
| def _make_rsync_compatible_globs(self, path, is_local): |
| """ Given an rsync-style path, returns a list of globbed paths |
| that will hopefully provide equivalent behaviour for scp. Does not |
| support the full range of rsync pattern matching behaviour, only that |
| exposed in the get/send_file interface (trailing slashes). |
| |
| The is_local param is flag indicating if the paths should be |
| interpreted as local or remote paths. """ |
| |
| # non-trailing slash paths should just work |
| if len(path) == 0 or path[-1] != "/": |
| return [path] |
| |
| # make a function to test if a pattern matches any files |
| if is_local: |
| def glob_matches_files(path): |
| return len(glob.glob(path)) > 0 |
| else: |
| def glob_matches_files(path): |
| result = self.run("ls \"%s\"" % utils.sh_escape(path), |
| ignore_status=True) |
| return result.exit_status == 0 |
| |
| # take a set of globs that cover all files, and see which are needed |
| patterns = ["*", ".[!.]*"] |
| patterns = [p for p in patterns if glob_matches_files(path + p)] |
| |
| # convert them into a set of paths suitable for the commandline |
| path = utils.sh_escape(path) |
| if is_local: |
| return ["\"%s\"%s" % (path, pattern) for pattern in patterns] |
| else: |
| return ["\"%s\"" % (path + pattern) for pattern in patterns] |
| |
| |
| def _make_rsync_compatible_source(self, source, is_local): |
| """ Applies the same logic as _make_rsync_compatible_globs, but |
| applies it to an entire list of sources, producing a new list of |
| sources, properly quoted. """ |
| return sum((self._make_rsync_compatible_globs(path, is_local) |
| for path in source), []) |
| |
| |
| def get_file(self, source, dest, delete_dest=False): |
| """ |
| Copy files from the remote host to a local path. |
| |
| Directories will be copied recursively. |
| If a source component is a directory with a trailing slash, |
| the content of the directory will be copied, otherwise, the |
| directory itself and its content will be copied. This |
| behavior is similar to that of the program 'rsync'. |
| |
| Args: |
| source: either |
| 1) a single file or directory, as a string |
| 2) a list of one or more (possibly mixed) |
| files or directories |
| dest: a file or a directory (if source contains a |
| directory or more than one element, you must |
| supply a directory dest) |
| delete_dest: if this is true, the command will also clear |
| out any old files at dest that are not in the |
| source |
| |
| Raises: |
| AutoservRunError: the scp command failed |
| """ |
| if isinstance(source, basestring): |
| source = [source] |
| dest = os.path.abspath(dest) |
| |
| try: |
| remote_source = self._encode_remote_paths(source) |
| local_dest = utils.sh_escape(dest) |
| rsync = self._make_rsync_cmd([remote_source], local_dest, |
| delete_dest) |
| utils.run(rsync) |
| except error.CmdError, e: |
| logging.warn("warning: rsync failed with: %s", e) |
| logging.info("attempting to copy with scp instead") |
| |
| # scp has no equivalent to --delete, just drop the entire dest dir |
| if delete_dest and os.path.isdir(dest): |
| shutil.rmtree(dest) |
| os.mkdir(dest) |
| |
| remote_source = self._make_rsync_compatible_source(source, False) |
| if remote_source: |
| remote_source = self._encode_remote_paths(remote_source) |
| local_dest = utils.sh_escape(dest) |
| scp = self._make_scp_cmd([remote_source], local_dest) |
| try: |
| utils.run(scp) |
| except error.CmdError, e: |
| raise error.AutoservRunError(e.args[0], e.args[1]) |
| |
| |
| def send_file(self, source, dest, delete_dest=False): |
| """ |
| Copy files from a local path to the remote host. |
| |
| Directories will be copied recursively. |
| If a source component is a directory with a trailing slash, |
| the content of the directory will be copied, otherwise, the |
| directory itself and its content will be copied. This |
| behavior is similar to that of the program 'rsync'. |
| |
| Args: |
| source: either |
| 1) a single file or directory, as a string |
| 2) a list of one or more (possibly mixed) |
| files or directories |
| dest: a file or a directory (if source contains a |
| directory or more than one element, you must |
| supply a directory dest) |
| delete_dest: if this is true, the command will also clear |
| out any old files at dest that are not in the |
| source |
| |
| Raises: |
| AutoservRunError: the scp command failed |
| """ |
| if isinstance(source, basestring): |
| source = [source] |
| remote_dest = self._encode_remote_paths([dest]) |
| |
| try: |
| local_sources = [utils.sh_escape(path) for path in source] |
| rsync = self._make_rsync_cmd(local_sources, remote_dest, |
| delete_dest) |
| utils.run(rsync) |
| except error.CmdError, e: |
| logging.warn("warning: rsync failed with: %s", e) |
| logging.info("attempting to copy with scp instead") |
| |
| # scp has no equivalent to --delete, just drop the entire dest dir |
| if delete_dest: |
| is_dir = self.run("ls -d %s/" % remote_dest, |
| ignore_status=True).exit_status == 0 |
| if is_dir: |
| cmd = "rm -rf %s && mkdir %s" |
| cmd %= (remote_dest, remote_dest) |
| self.run(cmd) |
| |
| local_sources = self._make_rsync_compatible_source(source, True) |
| if local_sources: |
| scp = self._make_scp_cmd(local_sources, remote_dest) |
| try: |
| utils.run(scp) |
| except error.CmdError, e: |
| raise error.AutoservRunError(e.args[0], e.args[1]) |
| |
| self.run('find "%s" -type d -print0 | xargs -0r chmod o+rx' % dest) |
| self.run('find "%s" -type f -print0 | xargs -0r chmod o+r' % dest) |
| if self.target_file_owner: |
| self.run('chown -R %s %s' % (self.target_file_owner, dest)) |
| |
| |
| def ssh_ping(self, timeout=60): |
| try: |
| self.run("true", timeout=timeout, connect_timeout=timeout) |
| logging.info("ssh_ping of %s completed sucessfully", self.hostname) |
| except error.AutoservSSHTimeout: |
| msg = "ssh ping timed out (timeout = %d)" % timeout |
| raise error.AutoservSSHTimeout(msg) |
| except error.AutoservSshPermissionDeniedError: |
| #let AutoservSshPermissionDeniedError be visible to the callers |
| raise |
| except error.AutoservRunError, e: |
| msg = "command true failed in ssh ping" |
| raise error.AutoservRunError(msg, e.result_obj) |
| |
| |
| def is_up(self): |
| """ |
| Check if the remote host is up. |
| |
| Returns: |
| True if the remote host is up, False otherwise |
| """ |
| try: |
| self.ssh_ping() |
| except error.AutoservError: |
| return False |
| else: |
| return True |
| |
| |
| def wait_up(self, timeout=None): |
| """ |
| Wait until the remote host is up or the timeout expires. |
| |
| In fact, it will wait until an ssh connection to the remote |
| host can be established, and getty is running. |
| |
| Args: |
| timeout: time limit in seconds before returning even |
| if the host is not up. |
| |
| Returns: |
| True if the host was found to be up, False otherwise |
| """ |
| if timeout: |
| end_time = time.time() + timeout |
| |
| while not timeout or time.time() < end_time: |
| if self.is_up(): |
| try: |
| if self.are_wait_up_processes_up(): |
| return True |
| except error.AutoservError: |
| pass |
| time.sleep(1) |
| |
| return False |
| |
| |
| def wait_down(self, timeout=None, warning_timer=None): |
| """ |
| Wait until the remote host is down or the timeout expires. |
| |
| In fact, it will wait until an ssh connection to the remote |
| host fails. |
| |
| Args: |
| timeout: time limit in seconds before returning even |
| if the host is still up. |
| warning_timer: time limit in seconds that will generate |
| a warning if the host is not down yet. |
| |
| Returns: |
| True if the host was found to be down, False otherwise |
| """ |
| current_time = time.time() |
| if timeout: |
| end_time = current_time + timeout |
| |
| if warning_timer: |
| warn_time = current_time + warning_timer |
| |
| while not timeout or current_time < end_time: |
| if not self.is_up(): |
| return True |
| |
| if warning_timer and current_time > warn_time: |
| self.record("WARN", None, "shutdown", |
| "Shutdown took longer than %ds" % warning_timer) |
| # Print the warning only once. |
| warning_timer = None |
| |
| time.sleep(1) |
| current_time = time.time() |
| |
| return False |
| |
| |
| # tunable constants for the verify & repair code |
| AUTOTEST_GB_DISKSPACE_REQUIRED = 20 |
| |
| |
| def verify(self): |
| super(AbstractSSHHost, self).verify_hardware() |
| |
| logging.info('Pinging host ' + self.hostname) |
| self.ssh_ping() |
| |
| if self.is_shutting_down(): |
| raise error.AutoservHostError("Host is shutting down") |
| |
| super(AbstractSSHHost, self).verify_software() |
| |
| try: |
| autodir = autotest._get_autodir(self) |
| if autodir: |
| self.check_diskspace(autodir, |
| self.AUTOTEST_GB_DISKSPACE_REQUIRED) |
| except error.AutoservHostError: |
| raise # only want to raise if it's a space issue |
| except Exception: |
| pass # autotest dir may not exist, etc. ignore |
| |
| |
| class LoggerFile(object): |
| def write(self, data): |
| if data: |
| logging.debug(data.rstrip("\n")) |
| |
| |
| def flush(self): |
| pass |
