From e4e4989e1885cd7981e22dbe9d07dad9e2dddded Mon Sep 17 00:00:00 2001 From: Tim Miller Date: Tue, 2 Apr 2013 18:22:41 -0700 Subject: [PATCH] Bring os-svc-install element docs up-to-date. Change-Id: Ia0547de1a899359994706d1607ed19e5ad5c056f --- elements/os-svc-install/README.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/elements/os-svc-install/README.md b/elements/os-svc-install/README.md index c947a616..50eec16c 100644 --- a/elements/os-svc-install/README.md +++ b/elements/os-svc-install/README.md @@ -1,9 +1,18 @@ -Installs 'os-svc-install', a script to perform one-line installs of init-controlled openstack services from github. +Command line utilities to simplify instalation of OpenStack services. + +## os-svc-install +Given a git repo url, pip-install the repo and all of its python dependencies into a virtualenv under /opt/stack/venvs. + +## os-svc-daemon +Given a system service command line and run-as user, generate and install system service start script. -Example Usage --------------- -`os-svc-install -u nova -n nova-all -c 'nova-all --someoption' -r https://github.com/openstack/nova.git` +## example usage +```bash +# clone nova.git from github, and install it and its dependencies to /opt/stack/venvs/nova +os-svc-install -u nova -n nova-all -c 'nova-all --someoption' -r https://github.com/openstack/nova.git -The above command will pip-install the repo specified by '-r', and create a service start script called nova-all (from `-n`), which starts the command specified by `-c` as user `-u` +# install a system-start script for nova-api +os-svc-daemon nova-api nova /opt/stack/venvs/nova/bin/nova-api --config-dir /etc/nova +```