Browse code

doc: Describe running a command as a separate group

Some commands must be run as a separate group to work. Users can use the
'sg' tool to do this.

This may be assumed knowledge for many users but it's helpful to note in
this, the definitive resource for DevStack's systemd integration.

Change-Id: I271c1d21b44fa972c152780c1caa01c21c265159
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>

Stephen Finucane authored on 2018/05/31 22:49:59
Showing 1 changed files
... ...
@@ -152,6 +152,19 @@ Invoke the command manually::
152 152
 
153 153
   /usr/local/bin/nova-scheduler --config-file /etc/nova/nova.conf
154 154
 
155
+Some executables, such as :program:`nova-compute`, will need to be executed
156
+with a particular group. This will be shown in the systemd unit file::
157
+
158
+  sudo systemctl cat devstack@n-cpu.service | grep Group
159
+
160
+::
161
+
162
+  Group = libvirt
163
+
164
+Use the :program:`sg` tool to execute the command as this group::
165
+
166
+  sg libvirt -c '/usr/local/bin/nova-compute --config-file /etc/nova/nova-cpu.conf'
167
+
155 168
 Using remote-pdb
156 169
 ----------------
157 170