View Source ct_slave (common_test v1.27)
Common Test framework functions for starting and stopping nodes for Large-Scale Testing.
Common Test
framework functions for starting and stopping nodes for
Large-Scale Testing.
This module exports functions used by the Common Test
Master to start and stop
"slave" nodes. It is the default callback module for the {init, node_start}
term in the Test Specification.
Summary
Functions
start(Node) -> Result
start(HostOrNode, NodeOrOpts) -> Result
start(Host, Node, Opts) -> Result
stop(Node) -> Result
stop(Host, Node) -> Result
Functions
start(Node) -> Result
Starts an Erlang node with name Node
on the local host.
See also ct_slave:start/3
.
start(HostOrNode, NodeOrOpts) -> Result
Starts an Erlang node with default options on a specified host, or on the local
host with specified options. That is, the call is interpreted as
start(Host, Node)
when the second argument is atom-valued and
start(Node, Opts)
when it is list-valued.
See also ct_slave:start/3
.
start(Host, Node, Opts) -> Result
Starts an Erlang node with name Node
on host Host
as specified by the
combination of options in Opts
.
Options Username
and Password
are used to log on to the remote host Host
.
Username
, if omitted, defaults to the current username. Password
is empty by
default.
A list of functions specified in option Startup
are executed after startup of
the node. Notice that all used modules are to be present in the code path on
Host
.
The time-outs are applied as follows:
BootTimeout
- The time to start the Erlang node, in seconds. Defaults to 3 seconds. If the node is not pingable within this time, the result{error, boot_timeout, NodeName}
is returned.InitTimeout
- The time to wait for the node until it calls the internal callback function informing master about a successful startup. Defaults to 1 second. In case of a timed out message, the result{error, init_timeout, NodeName}
is returned.StartupTimeout
- The time to wait until the node stops to runStartupFunctions
. Defaults to 1 second. If this time-out occurs, the result{error, startup_timeout, NodeName}
is returned.
Options:
monitor_master
- Specifies if the slave node is to be stopped if the master node stops. Defaults tofalse
.kill_if_fail
- Specifies if the slave node is to be killed if a time-out occurs during initialization or startup. Defaults totrue
. Notice that the node can also be still alive it the boot time-out occurred, but it is not killed in this case.erl_flags
- Specifies which flags are added to the parameters of the executableerl
.env
- Specifies a list of environment variables that will extend the environment.
Special return values:
{error, already_started, NodeName}
if the node with the specified name is already started on a specified host.{error, started_not_connected, NodeName}
if the node is started, but not connected to the master node.{error, not_alive, NodeName}
if the node on whichct_slave:start/3
is called, is not alive. Notice thatNodeName
is the name of the current node in this case.
stop(Node) -> Result
Stops the running Erlang node with name Node
on the local host.
stop(Host, Node) -> Result
Stops the running Erlang node with name Node
on host Host
.