Document how to run simulators as systemd services

Change-Id: I9405d7f36ecbe742b3402fd09dfa38b9e37121a7
Task: 12050
Story: 1751571
This commit is contained in:
Aija Jaunteva 2018-03-12 14:13:36 +02:00
parent 0260a11155
commit 2e6b8f1882
2 changed files with 32 additions and 0 deletions

View File

@ -0,0 +1,31 @@
Configuring simulators
======================
Running simulators in background
--------------------------------
The simulators run as interactive processes attached to the
terminal by default. You can create a systemd service to run the
emulators in background.
For each emulator create a systemd unit file and
update full path to ``sushy-static`` or ``sushy-emulator`` binary and
adjust arguments as necessary, for example::
[Unit]
Description=Sushy Libvirt emulator
After=syslog.target
[Service]
Type=simple
ExecStart=/<full-path>/sushy-emulator --port 8000 --libvirt-uri "qemu:///system"
StandardOutput=syslog
StandardError=syslog
If you want to run simulators with different configuration, for example,
``sushy-static`` simulator with different mockup files, then create a new
systemd unit file.
You can also use ``gunicorn`` to run ``sushy-emulator``, for example::
ExecStart=/usr/bin/gunicorn sushy_tools.emulator.main:app

View File

@ -8,6 +8,7 @@ Documentation
:maxdepth: 2
install/index
admin/index
user/index
contributor/index