" "LAVA"
lava-server - lava-server command line support
lava-server is a command-line management interface to a
LAVA instance, and the Django database management tools for that
instance.
lava-server manage subcommand [options] [args]
Most of these options are imported from django and more
information can be found in the django documentation.
These options are supported for all subcommands.
- -v VERBOSITY, --verbosity=VERBOSITY
- Verbosity level; 0=minimal output, 1=normal output, 2=verbose output,
3=very verbose output
- --settings=SETTINGS
- The Python path to a settings module, e.g.
"myproject.settings.main". If this isn't provided, the
DJANGO_SETTINGS_MODULE environment variable will be used.
- --pythonpath=PYTHONPATH
- A directory to add to the Python path, e.g.
"/home/djangoprojects/myproject".
- --traceback
- Print traceback on exception
- --version
- show program's version number and exit
- -h,
--help
- show this help message and exit
Type lava-server manage help <subcommand> for help on
a specific subcommand.
Type lava-server manage <subcommand> -h for help on
an option available to a specific subcommand.
- auth
- changepassword
- Change a user's password for django.contrib.auth.
- createsuperuser
- Used to create a superuser.
- Usage:
- lava-server manage createsuperuser [options]
- Options:
- --username=USERNAME
- Specifies the username for the superuser.
- --email=EMAIL
- Specifies the email address for the superuser.
- --noinput
- Tells Django to NOT prompt the user for input of any kind. You must use
--username and --email with --noinput and superusers
created with --noinput will not be able to log in until they are
given a valid password.
- --database=DATABASE
- Specifies the database to use. Default is default.
django
django functions change with releases of the django
package. See the documentation for python-django.
lava_scheduler_app
- devices
- Manage devices
- positional
arguments:
- {add, details, list, set}
- Sub commands
- add Add a device
copy Copy an existing device as a new device
details Details about a device
positional arguments:
hostname Hostname of the device
list List the installed devices
- device-types
- Manage device types according to which templates are available and which
device-types are defined in the database. When counting the number of
devices, Retired devices are included.
- positional
arguments:
- {add, list} Sub commands
- add Add V2 device type(s) to the database.
- positional
arguments:
- optional
arguments:
- health check:
- Only supported when creating a single device-type
- --health-check HEALTH_CHECK
- The health check (filename) for the given device type.
- --health - frequency HEALTH_FREQUENCY
- How often to run health checks.
- --health-denominator
- {hours, jobs} Initiate health checks by hours or by jobs.
- device-transitions
- Export device state transitions in either yaml or csv format. Output can
be filtered by old_state and new_state field values.
positional arguments:
{export} Sub commands
- export Export existing
device state transitions
Fields exported: created_on, created_by, device, job,
old_state, new_state, message Available states are: RETIRED, IDLE, RUNNING,
OFFLINING, RESERVED, OFFLINE Not all combinations of states will exist. Not
all fields are populated for all transitions. Example: To see transitions
where an admin put the device back online, use: lava-server manage
device-transition export --old-state OFFLINE --new-state IDLE Note: exporting
all transitions will produce a lot of output, it is recommended to always
specify --old-state and --new-state.
optional arguments:
— csv Print as csv --old-state Filter output by old device status
--new-state Filter output by new device status
pipeline-worker
- LAVA Pipeline worker
helper
- test
- Runs the test suite for the specified applications, or the entire site if
no apps are specified.
- Usage:
- lava-server manage test [options] [appname ...]
- Options:
- --noinput
- Tells Django to NOT prompt the user for input of any kind.
- --failfast
- Tells Django to stop running the test suite after first failed test.
- --testrunner TESTRUNNER
- Tells Django to use specified test runner class instead of the one
specified by the TEST_RUNNER setting.
- --liveserver LIVESERVER
- Overrides the default address where the live server (used with
LiveServerTestCase) is expected to run from. The default value is
localhost:8081.
If your bug relates to a specific type of device, please include
all configuration details for that device type as well as the job submission
JSON and as much of the LAVA test job log file as you can (e.g. as a
compressed file attached to the bug report).
If your device type is not one found on existing LAVA instances,
please supply as much information as you can on the board itself.
If you, or anyone on your team, would like to register with Linaro
directly, this will allow you to file an upstream bug, submit code for
review by the LAVA team, etc. Register at the following url:
https://register.linaro.org/
If you are considering large changes, it is best to register and
also to subscribe to the Linaro Validation mailing list at:
http://lists.linaro.org/mailman/listinfo/linaro-validation
Also talk to us on IRC:
irc.freenode.net
#linaro-lava
2010-2019, Linaro Limited