Revision 55faeced docs/dev-guide.rst

b/docs/dev-guide.rst
10 10

  
11 11
First of all you have to set up a developing environment for Synnefo.
12 12

  
13
**1. Create a new Squeeze VM**
13
**1. Create a new VM**
14

  
15
It has been tested on Debian Wheezy. It is expected to work with other
16
releases (e.g., Squeeze) too, as long as they are supported by
17
``snf-deploy``.
14 18

  
15 19
**2. Build your own Synnefo installation**
16 20

  
......
44 48

  
45 49
.. code-block:: console
46 50

  
51
        # su some_regular_user
47 52
	$ git clone https://code.grnet.gr/git/synnefo
48 53

  
49
Make sure you did the previous as a regular user. Otherwise you will have problems
50
with file permissions when deploying.
54
Make sure you clone the repository as a regular user. Otherwise you will
55
have problems with file permissions when deploying.
51 56

  
52 57
**6. Code and deploy**
53 58

  
......
58 63
	$ devflow-update-version
59 64

  
60 65
2. Code
61
3. In every component you change run
66
3. In every component you change, run as root
67

  
68
.. code-block:: console
69

  
70
	# python setup.py develop -N
71

  
72
This does not automatically install dependencies, in order to avoid
73
confusion with synnefo packages installed by ``snf-deploy``. External
74
dependencies have already been installed by ``snf-deploy``; if you introduce
75
a new dependency, you will have to explicitly install it.
76

  
77
4. You will need to restart the server with
78

  
79
.. code-block:: console
80

  
81
       # service gunicorn restart
82

  
83
5. If your changes affected ``snf-dispatcher`` (from package
84
   ``snf-cyclades-app``) or ``snf-ganeti-eventd`` (from
85
   ``snf-cyclades-gtools``) you will need to restart these daemons, too.
86
   Since step 3 installed the former under ``/usr/local/``, you need to
87
   make sure that the correct version is evoked. You can override the
88
   version installed by ``snf-deploy`` with
89

  
90
.. code-block:: console
91

  
92
       # ln -sf /usr/local/bin/snf-dispatcher /usr/bin/snf-dispatcher
93

  
94
and then restart the daemons
62 95

  
63 96
.. code-block:: console
64 97

  
65
	# python setup.py develop
98
       # service snf-dispatcher restart
99
       # service snf-ganeti-eventd restart
66 100

  
67
4. Refresh the web page and see your changes
101
6. Refresh the web page and see your changes
68 102

  
69 103
Synnefo REST APIs
70 104
=================

Also available in: Unified diff