---
name: "lava-slave"
section: "8"
platform: "linux"
package: "lava-dispatcher"
version: "2019.01-5"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/lava-slave"
---

# lava-slave(8)

manage connections to lava master

" "LAVA"

## NAME

lava-slave - manage connections to lava master

## SUMMARY

**lava-slave** runs the connection to the lava master over ZMQ to manage LAVA test jobs running on the reserved device, sending log messages back to the master. **lava-slave** runs as a daemon.

## USAGE

- **lava-slave \[-h\] \[--hostname HOSTNAME\] --master MASTER --socket-addr**

  SOCKET\_ADDR \[--log-file LOG\_FILE\] \[--level {DEBUG,ERROR,INFO,WARN}\] \[--timeout TIMEOUT\] \[--ipv6\] \[--encrypt\] \[--master-cert MASTER\_CERT\] \[--slave-cert SLAVE\_CERT\]

## OPTIONS

Options can be passed by editing /etc/default/lava-slave or /etc/lava-dispatcher/lava-slave

- **optional arguments:**

  - **-h, --help**

    show this help message and exit

  - **--hostname** *HOSTNAME*

    Name of the slave

  - **--master** *MASTER*

    Main master socket

  - **--socket-addr** *SOCKET\_ADDR*

    Log socket

  - **--log-file** *LOG\_FILE*

    Log file for the slave logs

  - **--level, -l**

    Log level (DEBUG, ERROR, INFO, WARN); default to INFO

  - **--timeout** *TIMEOUT,* **-t** *TIMEOUT*

    Socket connection timeout in seconds; default to 5

  - **--ipv6**

    Enable IPv6

  - **--encrypt**

    Encrypt messages

  - **--master-cert** *MASTER\_CERT*

    Master certificate file

  - **--slave-cert** *SLAVE\_CERT*

    Slave certificate file

## ENCRYPTION

Some LAVA instances require the ZMQ connection to the master to be encrypted. For more information on configuring lava-slave to use encryption support, see the lava-server documentation on your local instance or at: *https://validation.linaro.org/static/docs/v2/pipeline-server.html#zmq-curve*

You will need to contact the admin of the instance to obtain the certificate of the master to which this slave should connect.

The default install uses systemd translation of the sysvinit script but a systemd service file is available, if desired:

```
/usr/share/lava-dispatcher/lava-slave.service
```

This file can be copied to **/lib/systemd/system/**.

## AUTHOR

Linaro Validation Team

## COPYRIGHT

2010-2019, Linaro Limited