• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
2# Use of this source code is governed by a BSD-style license that can be
3# found in the LICENSE file.
4
5import logging
6
7from autotest_lib.client.common_lib import error
8from autotest_lib.client.common_lib import utils
9from autotest_lib.client.common_lib.cros import dev_server
10from autotest_lib.server import host_attributes
11
12AUTHOR = "Chrome OS Team"
13NAME = "platform_InstallTestImage"
14TIME = "MEDIUM"
15TEST_CATEGORY = "Install"
16TEST_CLASS = "platform"
17TEST_TYPE = "server"
18
19DOC = """
20This test installs a specified test image onto a servo-connected DUT.
21The principle purpose is to allow installing a known-good image onto
22a wedged unit that would otherwise have to be re-imaged manually.
23
24Here is the command to install a recovery image with a locally attached
25servo:
26    test_that -b ${BOARD} ${IP_ADDRESS} \
27        --args="image=$IMAGE_PATH" platform_InstallTestImage
28
29"""
30
31args_dict = utils.args_to_dict(args)
32servo_args = hosts.CrosHost.get_servo_arguments(args_dict)
33
34def run(machine):
35    # Setup the client machine.
36    host = hosts.create_host(machine, servo_args=servo_args)
37    # If we're invoked from test_that, the user can pass an
38    # optional "image" argument.  If it's omitted, we want to pass
39    # `None` to the test.  That will cause the test to assume
40    # there's an image pre-installed on USB.  This is convenient,
41    # because it can save the time of a long download.
42    #
43    # If we're called from the AFE, there won't be an "image"
44    # argument, and we want to ask the dev server to stage a test
45    # image.
46    #
47    # To distinguish the two cases above, we ask the host for
48    # the name of the default image we should stage.  When we're
49    # called from test_that, this call should fail when we
50    # try to look the host up in the AFE database.  Otherwise, if we
51    # get a valid image name, we use it to stage a build.
52    image_url = args_dict.get("image")
53    if image_url is None:
54        try:
55            # This fails if the board type can't be determined.
56            image_name = host.get_cros_repair_image_name()
57        except error.AutoservError as e:
58            # Failed, so assume this is test_that.
59            logging.info("Can't find build to stage: %s.", e)
60            logging.info("Assuming this is an invocation from test_that "
61                         "with a pre-installed USB image")
62        else:
63            # Succeeded, so stage the build and get its URL.
64            # N.B. Failures from staging the build at this point
65            # are fatal by design.
66            image_url = host.stage_image_for_servo(image_name)
67            logging.info("Using staged image:  %s", image_url)
68    job.run_test("platform_InstallTestImage", host=host,
69                 disable_sysinfo=True, image_url=image_url)
70
71parallel_simple(run, machines)
72