View Source ct_master (common_test v1.27)

Distributed test execution control for Common Test.

Distributed test execution control for Common Test.

This module exports functions for running Common Test nodes on multiple hosts in parallel.

Summary

Functions

abort() -> ok

abort(Nodes) -> ok

basic_html(Bool) -> ok

get_event_mgr_ref() -> MasterEvMgrRef

progress() -> [{Node, Status}]

run(TestSpecs) -> ok

run(TestSpecs, InclNodes, ExclNodes) -> ok

run(TestSpecs, AllowUserTerms, InclNodes, ExclNodes) -> ok

run_on_node(TestSpecs, Node) -> ok

run_on_node(TestSpecs, AllowUserTerms, Node) -> ok

run_test(Node, Opts) -> ok

Functions

abort() -> ok

Stops all running tests.

abort(Nodes) -> ok

Stops tests on specified nodes.

Link to this function

basic_html(Bool)

View Source (since OTP R15B01)

basic_html(Bool) -> ok

If set to true, the ct_master logs are written on a primitive HTML format, not using the Common Test CSS style sheet.

Link to this function

get_event_mgr_ref()

View Source (since OTP 17.5)

get_event_mgr_ref() -> MasterEvMgrRef

Gets a reference to the Common Test master event manager. The reference can be used to, for example, add a user-specific event handler while tests are running.

Example:

 gen_event:add_handler(ct_master:get_event_mgr_ref(), my_ev_h, [])

progress() -> [{Node, Status}]

Returns test progress. If Status is ongoing, tests are running on the node and are not yet finished.

run(TestSpecs) -> ok

Equivalent to ct_master:run(TestSpecs, false, [], []).

Link to this function

run(TestSpecs, InclNodes, ExclNodes)

View Source

run(TestSpecs, InclNodes, ExclNodes) -> ok

Equivalent to ct_master:run(TestSpecs, false, InclNodes, ExclNodes).

run(TestSpecs, AllowUserTerms, InclNodes, ExclNodes) -> ok

Tests are spawned on the nodes as specified in TestSpecs. Each specification in TestSpec is handled separately. However, it is also possible to specify a list of specifications to be merged into one specification before the tests are executed. Any test without a particular node specification is also executed on the nodes in InclNodes. Nodes in the ExclNodes list are excluded from the test.

Link to this function

run_on_node(TestSpecs, Node)

View Source

run_on_node(TestSpecs, Node) -> ok

Equivalent to ct_master:run_on_node(TestSpecs, false, Node).

run_on_node(TestSpecs, AllowUserTerms, Node) -> ok

Tests are spawned on Node according to TestSpecs.

run_test(Node, Opts) -> ok

Tests are spawned on Node using ct:run_test/1