Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 123 lines (92 sloc) 4.829 kb
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
1 Using Autophone
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
2 ===============
3
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
4 Starting Autophone
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
5 ------------------
6
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
7 Autophone has a number of command-line options. Run "python autophone.py -h"
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
8 to see them. Some important ones are
9
8bddba38 » bclary
2014-04-22 Bug 990601 - Autophone - use adb instead of tcp/ip to control devices…
10 --devices <devices>: Specifies an ini file which lists each device to be tested.
11 The devices ini file has a section for each device in the form:
12
13 [<devicename>]
14 serialno=<deviceserialnumber>
15
16 An example devices ini file can be found at devices.ini.example.
17
18
5d632feb » bclary
2012-12-20 Bug 785129 - Create Autophone tests to run unit tests, r=mcote.
19 --test-path <testpath>: Specifies the test manifest which will load the
20 appropriate phone test. Autophone will use
21 tests/manifest.ini by default.
22
23 --enable-unittests: Tells Autophone to download the appropriate tests.zip
24 for each build to use when running the unittests. This
25 is required when running the unittests.
26
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
27 --restarting: By default Autophone starts with no knowledge of any devices.
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
28 It creates a local cache as devices register with it. This
29 option preserves that cache when restarting.
30 (FIXME: This should probably be the default behaviour.)
31
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
32 --no-reboot: Use with --restarting to prevent Autophone from rebooting
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
33 all known devices while starting up.
34
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
35 --ipaddr: Autophone tries to determine an external IP address on the host
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
36 machine. This option can override this address, or provide one
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
37 if Autophone can't find one. (FIXME: This may no longer be
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
38 needed?)
39
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
40 --logfile: Log main Autophone system messages to this file. Defaults to
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
41 autophone.log. Devices will log to their own files in the
42 format <logfile base>-<phone id>.<logfile extension>, e.g.
43 autophone-a8_26_d9_93_fe_4b_nexus_one.log.
44
45 --loglevel: Log messages at or above this level. Can be set to
46 DEBUG (default), INFO, WARNING, or ERROR.
47
6d575549 » bclary
2014-02-12 Bug 968905 - Autophone - parameterize control constants via config fi…
48 --config <configfile>: Use the specified configuration file to set various
49 options. The values set in the config file override
50 options set on the command line.
51
52 Settings for command line options:
53
54 clear_cache
55 ipaddr
56 port
57 cachefile
58 logfile
59 loglevel
60 test_path
61 emailcfg
62 enable_pulse
63 enable_unittests
64 cache_dir
65 override_build_dir
66 repos
67 buildtypes
68 build_cache_port
69
70 Settings for internal parameters:
71
72 build_cache_size
73 build_cache_expires
74 devicemanager_retry_limit
75 devicemanager_settling_time
76 phone_retry_limit
77 phone_retry_wait
78 phone_max_reboots
79 phone_ping_interval
80 phone_command_queue_timeout
81 phone_command_queue_timeout
82 phone_crash_window
83 phone_crash_limit
84
5d632feb » bclary
2012-12-20 Bug 785129 - Create Autophone tests to run unit tests, r=mcote.
85 Running Unit Tests
86 ------------------
87
88 Autophone can run individual unit tests such as robocop, reftests,
89 crashtests, jsreftests or mochitests for each build or it can run combinations of
90 them.
91
92 Before running the unit tests, you will need to copy
93 configs/unittest_defaults.ini.example to configs/unittest_defaults.ini
94 and edit configs/unittest_defaults.ini to change the xre_path,
95 utility_path, and minidump_stackwalk values. If you wish to use a
96 development version of ElasticSearch or Autolog, you will need to edit
97 the es_server and rest_server values as well.
98
99 You can switch from using the experimental 'new' logparser and
100 logparser by changing the use_newparser value to False.
101
102 For example,
103
104 to run only the robocop tests:
105
8bddba38 » bclary
2014-04-22 Bug 990601 - Autophone - use adb instead of tcp/ip to control devices…
106 python autophone.py --devices=devices.ini --enable-unittests --test-path=./tests/robocoptests_manifest.ini
5d632feb » bclary
2012-12-20 Bug 785129 - Create Autophone tests to run unit tests, r=mcote.
107
108 to run all of the unit tests specified in the configs/unittests_settings.ini file:
109
8bddba38 » bclary
2014-04-22 Bug 990601 - Autophone - use adb instead of tcp/ip to control devices…
110 python autophone.py --devices=devices.ini --enable-unittests --test-path=./tests/unittests_manifest.ini
5d632feb » bclary
2012-12-20 Bug 785129 - Create Autophone tests to run unit tests, r=mcote.
111
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
112
113 Running Tests
114 -------------
115
99627181 » wlach
2012-08-08 Bug 780268 - Use Autophone, not AutoPhone in docs/help;r=mcote
116 Autophone listens to pulse for new fennec builds. When one is detected,
117 the main Autophone process downloads it and notifies all of its workers,
c66279b3 » markrcote
2012-07-11 Usage instructions, documented email settings.
118 which install it on the phones and begin a test run. If a test run is
119 ongoing, the new job is queued.
120
121 You can also trigger test runs on past builds with trigger_runs.py. This
122 script takes a build ID or date/time range and finds the appropriate builds.
123 Run "python trigger_runs.py -h" for exact usage.
Something went wrong with that request. Please try again.