1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
Installing
==========
Installation instructions depend whether the system on which
you're attempting to install Supervisor has internet access.
Installing to A System With Internet Access
-------------------------------------------
If your system has internet access, you can get Supervisor
installed in two ways:
- Using ``easy_install``, which is a feature of `setuptools
<http://peak.telecommunity.com/DevCenter/setuptools>`_. This is the
preferred method of installation.
- By downloading the Supervisor package and invoking
a command.
Internet-Installing With Setuptools
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If the Python interpreter you're using has Setuptools installed, and
the system has internet access, you can download and install
supervisor in one step using ``easy_install``.
.. code-block:: bash
easy_install supervisor
Depending on the permissions of your system's Python, you might need
to be the root user to install Supervisor successfully using
``easy_install``.
Internet-Installing Without Setuptools
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If your system does not have setuptools installed, you will need to download
the Supervisor distribution and install it by hand. Current and previous
Supervisor releases may be downloaded from `PyPi
<http://pypi.python.org/pypi/supervisor>`_. After unpacking the software
archive, run ``python setup.py install``. This requires internet access. It
will download and install all distributions depended upon by Supervisor and
finally install Supervisor itself.
.. note::
Depending on the permissions of your system's Python, you might
need to be the root user to sucessfully invoke ``python
setup.py install``.
Installing To A System Without Internet Access
----------------------------------------------
If the system that you want to install Supervisor to does not have
Internet access, you'll need to perform installation slightly
differently. Since both ``easy_install`` and ``python setup.py
install`` depend on internet access to perform downloads of dependent
software, neither will work on machines without internet access until
dependencies are installed. To install to a machine which is not
internet-connected, obtain the following dependencies on a machine
which is internet-connected:
- setuptools (latest) from `http://pypi.python.org/pypi/setuptools
<http://pypi.python.org/pypi/setuptools>`_.
- meld3 (latest) from `http://www.plope.com/software/meld3/
<http://www.plope.com/software/meld3/>`_.
- elementtree (latest) from `http://effbot.org/downloads#elementtree
<http://effbot.org/downloads#elementtree>`_.
Copy these files to removable media and put them on the target
machine. Install each onto the target machine as per its
instructions. This typically just means unpacking each file and
invoking ``python setup.py install`` in the unpacked directory.
Finally, run supervisor's ``python setup.py install``.
.. note::
Depending on the permissions of your system's Python, you might
need to be the root user to invoke ``python setup.py install``
sucessfully for each package.
Installing a Distribution Package
---------------------------------
Some Linux distributions offer a version of Supervisor that is installable
through the system package manager. These packages may include
distribution-specific changes to Supervisor.
.. note::
Some of these packages can lag considerably behind the official
release version. For example, Ubuntu 12.04 (released April 2012)
offers a package based on Supervisor 3.0a8 (released January 2010).
Use the package management tools of your distribution to check availability;
e.g. on Ubuntu you can run ``apt-cache show supervisor``, and on CentOS
you can run ``yum info supervisor``.
Packaged Supervisor will normally already be integrated into the service
management infrastructure of your distribution.
Installing via pip
------------------
With pip >= 1.4
.. code-block:: bash
pip install supervisor --pre
With previous versions of pip:
.. code-block:: bash
pip install supervisor
Creating a Configuration File
-----------------------------
Once the Supervisor installation has completed, run
``echo_supervisord_conf``. This will print a "sample" Supervisor
configuration file to your terminal's stdout.
Once you see the file echoed to your terminal, reinvoke the command as
``echo_supervisord_conf > /etc/supervisord.conf``. This won't work if
you do not have root access.
If you don't have root access, or you'd rather not put the
:file:`supervisord.conf` file in :file:`/etc/supervisord.conf``, you
can place it in the current directory (``echo_supervisord_conf >
supervisord.conf``) and start :program:`supervisord` with the
``-c`` flag in order to specify the configuration file
location.
For example, ``supervisord -c supervisord.conf``. Using the ``-c``
flag actually is redundant in this case, because
:program:`supervisord` searches the current directory for a
:file:`supervisord.conf` before it searches any other locations for
the file, but it will work. See :ref:`running` for more information
about the ``-c`` flag.
Once you have a configuration file on your filesystem, you can
begin modifying it to your liking.
|
