.\" Man page generated from reStructuredText. . .TH "LAVA-SERVER" "1" "June 21, 2018" "2016.12 " "LAVA Server" .SH NAME lava-server \- lava-server command line support . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH SUMMARY .sp \fBlava\-server\fP is a command\-line management interface to a LAVA instance, and the Django database management tools for that instance. .SH USAGE .sp lava\-server manage subcommand [options] [args] .SH COMMON OPTIONS .sp Most of these options are imported from \fBdjango\fP and more information can be found in the django documentation. .sp These options are supported for all subcommands. .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .BI \-v \ VERBOSITY\fP,\fB \ \-\-verbosity\fB= VERBOSITY Verbosity level; 0=minimal output, 1=normal output, 2=verbose output, 3=very verbose output .TP .BI \-\-settings\fB= SETTINGS The Python path to a settings module, e.g. "myproject.settings.main". If this isn\(aqt provided, the DJANGO_SETTINGS_MODULE environment variable will be used. .TP .BI \-\-pythonpath\fB= PYTHONPATH A directory to add to the Python path, e.g. "/home/djangoprojects/myproject". .TP .B \-\-traceback Print traceback on exception .TP .B \-\-version show program\(aqs version number and exit .TP .B \-h\fP,\fB \-\-help show this help message and exit .UNINDENT .UNINDENT .UNINDENT .SH SUBCOMMANDS .sp Type \fBlava\-server manage help \fP for help on a specific subcommand. .SH AVAILABLE SUBCOMMANDS .INDENT 0.0 .TP .B auth .INDENT 7.0 .TP .B changepassword Change a user\(aqs password for django.contrib.auth. .INDENT 7.0 .TP .B Usage: lava\-server manage changepassword [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Specifies the database to use. Default is "default". .UNINDENT .UNINDENT .TP .B createsuperuser Used to create a superuser. .INDENT 7.0 .TP .B Usage: lava\-server manage createsuperuser [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-username\fB= USERNAME Specifies the username for the superuser. .TP .BI \-\-email\fB= EMAIL Specifies the email address for the superuser. .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. You must use \fB\-\-username\fP and \fB\-\-email\fP with \fB\-\-noinput\fP and superusers created with \fB\-\-noinput\fP will not be able to log in until they are given a valid password. .TP .BI \-\-database\fB= DATABASE Specifies the database to use. Default is \fBdefault\fP\&. .UNINDENT .UNINDENT .UNINDENT .TP .B django .INDENT 7.0 .TP .B cleanup Can be run as a cronjob or directly to clean out old data from the database (only expired sessions at the moment). .INDENT 7.0 .TP .B Usage: lava\-server manage cleanup [options] .UNINDENT .TP .B compilemessages Compiles .po files to .mo files for use with builtin gettext support. .INDENT 7.0 .TP .B Usage: lava\-server manage compilemessages [options] .TP .B Options: .INDENT 7.0 .TP .BI \-l \ LOCALE\fP,\fB \ \-\-locale\fB= LOCALE The locale to process. Default is to process all. .UNINDENT .UNINDENT .TP .B createcachetable Creates the table needed to use the SQL cache backend. .INDENT 7.0 .TP .B Usage: lava\-server manage createcachetable [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database onto which the cache table will be installed. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B dbshell Runs the command\-line client for specified database, or the default database if none is provided. .INDENT 7.0 .TP .B Usage: lava\-server manage dbshell [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database onto which to open a shell. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B diffsettings Displays differences between the current settings.py and the Django default settings. Settings that do not appear in the defaults are followed by "###". .INDENT 7.0 .TP .B Usage: lava\-server manage diffsettings [options] .UNINDENT .TP .B dumpdata Output the contents of the database as a fixture of the given format (using each model\(aqs default manager unless \fB\-\-all\fP is specified). .INDENT 7.0 .TP .B Usage: lava\-server manage dumpdata [options] [appname appname.ModelName ...] .TP .B Options: .INDENT 7.0 .TP .BI \-\-format\fB= FORMAT Specifies the output serialization format for fixtures. .TP .BI \-\-indent\fB= INDENT Specifies the indent level to use when pretty\-printing output .TP .BI \-\-database\fB= DATABASE Nominates a specific database to dump fixtures from. Defaults to the "default" database. .TP .BI \-e \ EXCLUDE\fP,\fB \ \-\-exclude\fB= EXCLUDE An appname or appname.ModelName to exclude (use multiple \-\-exclude to exclude multiple apps/models). .TP .B \-n\fP,\fB \-\-natural Use natural keys if they are available. .TP .B \-a\fP,\fB \-\-all Use Django\(aqs base manager to dump all models stored in the database, including those that would otherwise be filtered or modified by a custom manager. .UNINDENT .UNINDENT .TP .B flush Returns the database to the state it was in immediately after syncdb was executed. This means that all data will be removed from the database, any post\-synchronization handlers will be re\-executed and the initial_data fixture will be re\-installed. .INDENT 7.0 .TP .B Usage: lava\-server manage flush [options] .TP .B Options: .INDENT 7.0 .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. .TP .BI \-\-database\fB= DATABASE Nominates a database to flush. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B inspectdb Introspects the database tables in the given database and outputs a Django model module. .INDENT 7.0 .TP .B Usage: lava\-server manage inspectdb [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to introspect. Defaults to using the "default" database. .UNINDENT .UNINDENT .TP .B loaddata Installs the named fixture(s) in the database. .INDENT 7.0 .TP .B Usage: lava\-server manage loaddata [options] fixture [fixture ...] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a specific database to load fixtures into. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B makemessages Runs over the entire source tree of the current directory and pulls out all strings marked for translation. It creates (or updates) a message file in the conf/locale (in the django tree) or locale (for projects and applications) directory. .INDENT 7.0 .TP .B Usage: lava\-server manage makemessages [options] .TP .B Options: .INDENT 7.0 .TP .BI \-l \ LOCALE\fP,\fB \ \-\-locale\fB= LOCALE Creates or updates the message files for the given locale (e.g. pt_BR). .TP .BI \-d \ DOMAIN\fP,\fB \ \-\-domain\fB= DOMAIN The domain of the message files (default: "django"). .TP .B \-a\fP,\fB \-\-all Updates the message files for all existing locales. .TP .BI \-e \ EXTENSIONS\fP,\fB \ \-\-extension\fB= EXTENSIONS The file extension(s) to examine (default: "html,txt", or "js" if the domain is "djangojs"). Separate multiple extensions with commas, or use \-e multiple times. .TP .B \-s\fP,\fB \-\-symlinks Follows symlinks to directories when examining source code and templates for translation strings. .TP .BI \-i \ PATTERN\fP,\fB \ \-\-ignore\fB= PATTERN Ignore files or directories matching this glob\-style pattern. Use multiple times to ignore more. .TP .B \-\-no\-default\-ignore Don\(aqt ignore the common glob\-style patterns \fB\(aqCVS\(aq\fP, \fB\(aq.*\(aq\fP and \fB\(aq*~\(aq\fP\&. .TP .B \-\-no\-wrap Don\(aqt break long message lines into several lines .TP .B \-\-no\-location Don\(aqt write \(aq#: filename:line\(aq lines .TP .B \-\-no\-obsolete Remove obsolete message strings .UNINDENT .UNINDENT .TP .B reset Executes \fBsqlreset\fP for the given app(s) in the current database. .INDENT 7.0 .TP .B Usage: lava\-server manage reset [options] [appname ...] .TP .B Options: .INDENT 7.0 .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. .TP .BI \-\-database\fB= DATABASE Nominates a database to reset. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B runfcgi Run this project as a fastcgi (or some other protocol supported by flup) application. To do this, the flup package from \fI\%http://www.saddi.com/software/flup/\fP is required. .INDENT 7.0 .TP .B Usage: lava\-server manage runfcgi [options] [fcgi settings] .TP .B Options: See the django documentation for information on this option. .UNINDENT .TP .B shell Runs a Python interactive interpreter. Tries to use IPython, if it\(aqs available. .INDENT 7.0 .TP .B Usage: lava\-server manage shell [options] .TP .B Options: .INDENT 7.0 .TP .B \-\-plain Tells Django to use plain Python, not IPython. .UNINDENT .UNINDENT .TP .B sql Prints the CREATE TABLE SQL statements for the given app name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sql [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlall Prints the CREATE TABLE, custom SQL and CREATE INDEX SQL statements for the given model module name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sqlall [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlclear Prints the DROP TABLE SQL statements for the given app name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sqlclear [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlcustom Prints the custom table modifying SQL statements for the given app name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sqlcustom [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlflush Returns a list of the SQL statements required to return all tables in the database to the state they were in just after they were installed. .INDENT 7.0 .TP .B Usage: lava\-server manage sqlflush [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlindexes Prints the CREATE INDEX SQL statements for the given model module name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sqlindexes [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlinitialdata RENAMED: see \fBsqlcustom\fP .TP .B sqlreset Prints the DROP TABLE SQL, then the CREATE TABLE SQL, for the given app name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sqlreset [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B sqlsequencereset Prints the SQL statements for resetting sequences for the given app name(s). .INDENT 7.0 .TP .B Usage: lava\-server manage sqlsequencereset [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-database\fB= DATABASE Nominates a database to print the SQL for. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B startapp Creates a Django app directory structure for the given app name in the current directory or optionally in the given directory. .INDENT 7.0 .TP .B Usage: lava\-server manage startapp [options] [name] [optional destination directory] .TP .B Options: .INDENT 7.0 .TP .BI \-\-template\fB= TEMPLATE The dotted import path to load the template from. .TP .BI \-e \ EXTENSIONS\fP,\fB \ \-\-extension\fB= EXTENSIONS The file extension(s) to render (default: "py"). Separate multiple extensions with commas, or use \-e multiple times. .TP .BI \-n \ FILES\fP,\fB \ \-\-name\fB= FILES The file name(s) to render. Separate multiple extensions with commas, or use \-n multiple times. .UNINDENT .UNINDENT .TP .B startproject Creates a Django project directory structure for the given project name in the current directory or optionally in the given directory. .INDENT 7.0 .TP .B Usage: lava\-server manage startproject [options] [name] [optional destination directory] .TP .B Options: .INDENT 7.0 .TP .BI \-\-template\fB= TEMPLATE The dotted import path to load the template from. .TP .BI \-e \ EXTENSIONS\fP,\fB \ \-\-extension\fB= EXTENSIONS The file extension(s) to render (default: "py"). Separate multiple extensions with commas, or use \-e multiple times. .TP .BI \-n \ FILES\fP,\fB \ \-\-name\fB= FILES The file name(s) to render. Separate multiple extensions with commas, or use \-n multiple times. .UNINDENT .UNINDENT .TP .B validate Validates all installed models. .INDENT 7.0 .TP .B Usage: lava\-server manage validate [options] .UNINDENT .UNINDENT .TP .B django_openid_auth .INDENT 7.0 .TP .B openid_cleanup Clean up stale OpenID associations and nonces .INDENT 7.0 .TP .B Usage: lava\-server manage openid_cleanup [options] .UNINDENT .UNINDENT .TP .B lava_scheduler_app .INDENT 7.0 .TP .B scheduler Run the LAVA test job scheduler .INDENT 7.0 .TP .B Usage: lava\-server manage scheduler [options] .TP .B Options: .INDENT 7.0 .TP .B \-\-use\-fake Use fake dispatcher (for testing) .TP .BI \-\-dispatcher\fB= DISPATCHER Dispatcher command to invoke .UNINDENT .UNINDENT .TP .B schedulermonitor Run the LAVA test job scheduler .INDENT 7.0 .TP .B Usage: lava\-server manage schedulermonitor [options] .TP .B Options: .INDENT 7.0 .TP .BI \-l \ LOGLEVEL\fP,\fB \ \-\-loglevel\fB= LOGLEVEL Log level, default is taken from settings. .TP .BI \-f \ LOGFILE\fP,\fB \ \-\-logfile\fB= LOGFILE Path to log file, default is taken from settings. .UNINDENT .UNINDENT .TP .B testjobmigrate Fill out results_bundle on old testjobs. .INDENT 7.0 .TP .B Usage: lava\-server manage testjobmigrate [options] .UNINDENT .TP .B datamigration Creates a new template data migration for the given app .INDENT 7.0 .TP .B Usage: lava\-server manage datamigration [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-freeze\fB= FREEZE_LIST Freeze the specified app(s). Provide an app name with each; use the option multiple times for multiple apps .TP .B \-\-stdout Print the migration to stdout instead of writing it to a file. .UNINDENT .UNINDENT .TP .B graphmigrations Outputs a GraphViz dot file of all migration dependencies to stdout. .INDENT 7.0 .TP .B Usage: lava\-server manage graphmigrations [options] .UNINDENT .TP .B migrate Runs migrations for all apps. .INDENT 7.0 .TP .B Usage: lava\-server manage migrate [options] [appname] [migrationname|zero] [\-\-all] [\-\-list] [\-\-skip] [\-\-merge] [\-\-no\-initial\-data] [\-\-fake] [\-\-db\-dry\-run] [\-\-database=dbalias] .TP .B Options: .INDENT 7.0 .TP .B \-\-all Run the specified migration for all apps. .TP .B \-\-list List migrations noting those that have been applied .TP .B \-\-changes List changes for migrations .TP .B \-\-skip Will skip over out\-of\-order missing migrations .TP .B \-\-merge Will run out\-of\-order missing migrations as they are \- no rollbacks. .TP .B \-\-no\-initial\-data Skips loading initial data if specified. .TP .B \-\-fake Pretends to do the migrations, but doesn\(aqt actually execute them. .TP .B \-\-db\-dry\-run Doesn\(aqt execute the SQL generated by the db methods, and doesn\(aqt store a record that the migration(s) occurred. Useful to test migrations before applying them. .TP .B \-\-delete\-ghost\-migrations Tells South to delete any \(aqghost\(aq migrations (ones in the database but not on disk). .TP .B \-\-ignore\-ghost\-migrations Tells South to ignore any \(aqghost\(aq migrations (ones in the database but not on disk) and continue to apply new migrations. .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. .TP .BI \-\-database\fB= DATABASE Nominates a database to synchronize. Defaults to the "default" database. .UNINDENT .UNINDENT .TP .B migrationcheck Runs migrations for each app in turn, detecting missing depends_on values. .INDENT 7.0 .TP .B Usage: lava\-server manage migrationcheck [options] .UNINDENT .TP .B schemamigration Creates a new template schema migration for the given app .INDENT 7.0 .TP .B Usage: lava\-server manage schemamigration [options] .TP .B Options: .INDENT 7.0 .TP .BI \-\-freeze\fB= FREEZE_LIST Freeze the specified app(s). Provide an app name with each; use the option multiple times for multiple apps .TP .B \-\-stdout Print the migration to stdout instead of writing it to a file. .TP .BI \-\-add\-model\fB= ADDED_MODEL_LIST Generate a Create Table migration for the specified model. Add multiple models to this migration with subsequent \-\-model parameters. .TP .BI \-\-add\-field\fB= ADDED_FIELD_LIST Generate an Add Column migration for the specified modelname.fieldname \- you can use this multiple times to add more than one column. .TP .BI \-\-add\-index\fB= ADDED_INDEX_LIST Generate an Add Index migration for the specified modelname.fieldname \- you can use this multiple times to add more than one column. .TP .B \-\-initial Generate the initial schema for the app. .TP .B \-\-auto Attempt to automatically detect differences from the last migration. .TP .B \-\-empty Make a blank migration. .UNINDENT .UNINDENT .TP .B startmigration Deprecated command .TP .B syncdb Create the database tables for all apps in INSTALLED_APPS whose tables have not already been created, except those which use migrations. .INDENT 7.0 .TP .B Usage: lava\-server manage syncdb [options] .TP .B Options: .INDENT 7.0 .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. .TP .BI \-\-database\fB= DATABASE Nominates a database to synchronize. Defaults to the "default" database. .TP .B \-\-migrate Tells South to also perform migrations after the sync. Default for during testing, and other internal calls. .TP .B \-\-all Makes syncdb work on all apps, even migrated ones. Be careful! .UNINDENT .UNINDENT .TP .B test Runs the test suite for the specified applications, or the entire site if no apps are specified. .INDENT 7.0 .TP .B Usage: lava\-server manage test [options] [appname ...] .TP .B Options: .INDENT 7.0 .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. .TP .B \-\-failfast Tells Django to stop running the test suite after first failed test. .TP .BI \-\-testrunner\fB= TESTRUNNER Tells Django to use specified test runner class instead of the one specified by the TEST_RUNNER setting. .TP .BI \-\-liveserver\fB= LIVESERVER Overrides the default address where the live server (used with LiveServerTestCase) is expected to run from. The default value is localhost:8081. .UNINDENT .UNINDENT .TP .B testserver Runs a development server with data from the given fixture(s). .INDENT 7.0 .TP .B Usage: lava\-server manage testserver [options] [fixture ...] .TP .B Options: .INDENT 7.0 .TP .B \-\-noinput Tells Django to NOT prompt the user for input of any kind. .TP .BI \-\-addrport\fB= ADDRPORT port number or ipaddr:port to run the server on .TP .B \-6\fP,\fB \-\-ipv6 Tells Django to use a IPv6 address. .UNINDENT .UNINDENT .UNINDENT .TP .B staticfiles .INDENT 7.0 .TP .B collectstatic Collect static files in a single location. .INDENT 7.0 .TP .B Usage: lava\-server manage collectstatic [options] .TP .B Options: .INDENT 7.0 .TP .B \-\-noinput Do NOT prompt the user for input of any kind. .TP .B \-\-no\-post\-process Do NOT post process collected files. .TP .BI \-i \ PATTERN\fP,\fB \ \-\-ignore\fB= PATTERN Ignore files or directories matching this glob\-style pattern. Use multiple times to ignore more. .TP .B \-n\fP,\fB \-\-dry\-run Do everything except modify the filesystem. .TP .B \-c\fP,\fB \-\-clear Clear the existing files using the storage before trying to copy or link the original file. .TP .B \-l\fP,\fB \-\-link Create a symbolic link to each file instead of copying. .TP .B \-\-no\-default\-ignore Don\(aqt ignore the common private glob\-style patterns \fB\(aqCVS\(aq\fP, \fB\(aq.*\(aq\fP and \fB\(aq*~\(aq\fP\&. .UNINDENT .UNINDENT .TP .B findstatic Finds the absolute paths for the given static file(s). .sp Usage: lava\-server manage findstatic [options] [file ...] .sp Options: \-\-first Only return the first match for each static file. .TP .B runserver Starts a lightweight Web server for development and also serves static files. .INDENT 7.0 .TP .B Usage: lava\-server manage runserver [options] [optional port number, or ipaddr:port] .TP .B Options: .INDENT 7.0 .TP .B \-6\fP,\fB \-\-ipv6 Tells Django to use a IPv6 address. .TP .B \-\-nothreading Tells Django to NOT use threading. .TP .B \-\-noreload Tells Django to NOT use the auto\-reloader. .TP .B \-\-nostatic Tells Django to NOT automatically serve static files at STATIC_URL. .TP .B \-\-insecure Allows serving static files even if DEBUG is False. .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SH BUGS .sp 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). .sp If your device type is not one found on existing LAVA instances, please supply as much information as you can on the board itself. .SH CONTRIBUTING UPSTREAM .sp 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: .sp \fI\%https://register.linaro.org/\fP .sp If you are considering large changes, it is best to register and also to subscribe to the Linaro Validation mailing list at: .sp \fI\%http://lists.linaro.org/mailman/listinfo/linaro\-validation\fP .sp Also talk to us on IRC: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C irc.freenode.net #linaro\-lava .ft P .fi .UNINDENT .UNINDENT .SH AUTHOR Linaro Validation Team .SH COPYRIGHT 2010-2018, Linaro Limited .\" Generated by docutils manpage writer. .