root / docs / intgrt-guide.rst @ 49026a89
History | View | Annotate | Download (2.4 kB)
1 | bc055d09 | Constantinos Venetsanopoulos | .. _intgrt-guide: |
---|---|---|---|
2 | bc055d09 | Constantinos Venetsanopoulos | |
3 | bc055d09 | Constantinos Venetsanopoulos | Synnefo Integrator's Guide |
4 | bc055d09 | Constantinos Venetsanopoulos | ^^^^^^^^^^^^^^^^^^^^^^^^^^ |
5 | bc055d09 | Constantinos Venetsanopoulos | |
6 | bc055d09 | Constantinos Venetsanopoulos | This is the complete Synnefo Integrator's Guide |
7 | bc055d09 | Constantinos Venetsanopoulos | |
8 | bc055d09 | Constantinos Venetsanopoulos | Developer's quick start |
9 | bc055d09 | Constantinos Venetsanopoulos | ======================= |
10 | bc055d09 | Constantinos Venetsanopoulos | |
11 | bc055d09 | Constantinos Venetsanopoulos | This section describes how to setup quickly a synnefo development environment. |
12 | bc055d09 | Constantinos Venetsanopoulos | The setup uses ``pip`` and ``virtualenv`` and we assume you do it on a working |
13 | bc055d09 | Constantinos Venetsanopoulos | debian system. The purpose of this section is to provide the synnefo developer |
14 | bc055d09 | Constantinos Venetsanopoulos | with a quick installation, so that he can have all the synnefo components |
15 | bc055d09 | Constantinos Venetsanopoulos | up and running to start developing. |
16 | bc055d09 | Constantinos Venetsanopoulos | |
17 | bc055d09 | Constantinos Venetsanopoulos | | :ref:`Integrator's quick installation guide <quick-install-intgrt-guide>` |
18 | bc055d09 | Constantinos Venetsanopoulos | | This guide will walk you through a complete installation using ``pip``. |
19 | bc055d09 | Constantinos Venetsanopoulos | |
20 | bc055d09 | Constantinos Venetsanopoulos | |
21 | bc055d09 | Constantinos Venetsanopoulos | Synnefo internals |
22 | bc055d09 | Constantinos Venetsanopoulos | ================= |
23 | bc055d09 | Constantinos Venetsanopoulos | |
24 | 22b0cfd8 | Constantinos Venetsanopoulos | snf-vncauthproxy |
25 | 22b0cfd8 | Constantinos Venetsanopoulos | ---------------- |
26 | 22b0cfd8 | Constantinos Venetsanopoulos | |
27 | 22b0cfd8 | Constantinos Venetsanopoulos | To support OOB console access to the VMs over VNC, the vncauthproxy |
28 | 22b0cfd8 | Constantinos Venetsanopoulos | daemon must be running on every :ref:`APISERVER <APISERVER_NODE>` node. |
29 | 22b0cfd8 | Constantinos Venetsanopoulos | |
30 | 22b0cfd8 | Constantinos Venetsanopoulos | .. note:: The Debian package for vncauthproxy undertakes all configuration |
31 | 22b0cfd8 | Constantinos Venetsanopoulos | automatically. |
32 | 22b0cfd8 | Constantinos Venetsanopoulos | |
33 | 22b0cfd8 | Constantinos Venetsanopoulos | Download and install the latest vncauthproxy from its own repository, |
34 | 22b0cfd8 | Constantinos Venetsanopoulos | at `https://code.grnet.gr/git/vncauthproxy`, or a specific commit: |
35 | 22b0cfd8 | Constantinos Venetsanopoulos | |
36 | 22b0cfd8 | Constantinos Venetsanopoulos | .. code-block:: console |
37 | 22b0cfd8 | Constantinos Venetsanopoulos | |
38 | 22b0cfd8 | Constantinos Venetsanopoulos | $ bin/pip install -e git+https://code.grnet.gr/git/vncauthproxy@INSERT_COMMIT_HERE#egg=vncauthproxy |
39 | 22b0cfd8 | Constantinos Venetsanopoulos | |
40 | 22b0cfd8 | Constantinos Venetsanopoulos | Create ``/var/log/vncauthproxy`` and set its permissions appropriately. |
41 | 22b0cfd8 | Constantinos Venetsanopoulos | |
42 | 22b0cfd8 | Constantinos Venetsanopoulos | Alternatively, build and install Debian packages. |
43 | 22b0cfd8 | Constantinos Venetsanopoulos | |
44 | 22b0cfd8 | Constantinos Venetsanopoulos | .. code-block:: console |
45 | 22b0cfd8 | Constantinos Venetsanopoulos | |
46 | 22b0cfd8 | Constantinos Venetsanopoulos | $ git checkout debian |
47 | 22b0cfd8 | Constantinos Venetsanopoulos | $ dpkg-buildpackage -b -uc -us |
48 | 22b0cfd8 | Constantinos Venetsanopoulos | # dpkg -i ../vncauthproxy_1.0-1_all.deb |
49 | 22b0cfd8 | Constantinos Venetsanopoulos | |
50 | 22b0cfd8 | Constantinos Venetsanopoulos | .. warning:: |
51 | 22b0cfd8 | Constantinos Venetsanopoulos | **Failure to build the package on the Mac.** |
52 | 22b0cfd8 | Constantinos Venetsanopoulos | |
53 | 22b0cfd8 | Constantinos Venetsanopoulos | ``libevent``, a requirement for gevent which in turn is a requirement for |
54 | 22b0cfd8 | Constantinos Venetsanopoulos | vncauthproxy is not included in `MacOSX` by default and installing it with |
55 | 22b0cfd8 | Constantinos Venetsanopoulos | MacPorts does not lead to a version that can be found by the gevent |
56 | 22b0cfd8 | Constantinos Venetsanopoulos | build process. A quick workaround is to execute the following commands:: |
57 | 22b0cfd8 | Constantinos Venetsanopoulos | |
58 | 22b0cfd8 | Constantinos Venetsanopoulos | $ cd $SYNNEFO |
59 | 22b0cfd8 | Constantinos Venetsanopoulos | $ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy |
60 | 22b0cfd8 | Constantinos Venetsanopoulos | <the above fails> |
61 | 22b0cfd8 | Constantinos Venetsanopoulos | $ cd build/gevent |
62 | 22b0cfd8 | Constantinos Venetsanopoulos | $ sudo python setup.py -I/opt/local/include -L/opt/local/lib build |
63 | 22b0cfd8 | Constantinos Venetsanopoulos | $ cd $SYNNEFO |
64 | 22b0cfd8 | Constantinos Venetsanopoulos | $ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy |
65 | 22b0cfd8 | Constantinos Venetsanopoulos | |
66 | 22b0cfd8 | Constantinos Venetsanopoulos | .. todo:: Mention vncauthproxy bug, snf-vncauthproxy, inability to install using pip |
67 | 22b0cfd8 | Constantinos Venetsanopoulos | .. todo:: kpap: fix installation commands |
68 | 22b0cfd8 | Constantinos Venetsanopoulos | |
69 | 22b0cfd8 | Constantinos Venetsanopoulos | |
70 | bc055d09 | Constantinos Venetsanopoulos | Components |
71 | bc055d09 | Constantinos Venetsanopoulos | ========== |