Revision 22b0cfd8

b/docs/intgrt-guide.rst
21 21
Synnefo internals
22 22
=================
23 23

  
24
snf-vncauthproxy
25
----------------
26

  
27
To support OOB console access to the VMs over VNC, the vncauthproxy
28
daemon must be running on every :ref:`APISERVER <APISERVER_NODE>` node.
29

  
30
.. note:: The Debian package for vncauthproxy undertakes all configuration
31
   automatically.
32

  
33
Download and install the latest vncauthproxy from its own repository,
34
at `https://code.grnet.gr/git/vncauthproxy`, or a specific commit:
35

  
36
.. code-block:: console
37

  
38
    $ bin/pip install -e git+https://code.grnet.gr/git/vncauthproxy@INSERT_COMMIT_HERE#egg=vncauthproxy
39

  
40
Create ``/var/log/vncauthproxy`` and set its permissions appropriately.
41

  
42
Alternatively, build and install Debian packages.
43

  
44
.. code-block:: console
45

  
46
    $ git checkout debian
47
    $ dpkg-buildpackage -b -uc -us
48
    # dpkg -i ../vncauthproxy_1.0-1_all.deb
49

  
50
.. warning::
51
    **Failure to build the package on the Mac.**
52

  
53
    ``libevent``, a requirement for gevent which in turn is a requirement for
54
    vncauthproxy is not included in `MacOSX` by default and installing it with
55
    MacPorts does not lead to a version that can be found by the gevent
56
    build process. A quick workaround is to execute the following commands::
57

  
58
        $ cd $SYNNEFO
59
        $ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
60
        <the above fails>
61
        $ cd build/gevent
62
        $ sudo python setup.py -I/opt/local/include -L/opt/local/lib build
63
        $ cd $SYNNEFO
64
        $ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
65

  
66
.. todo:: Mention vncauthproxy bug, snf-vncauthproxy, inability to install using pip
67
.. todo:: kpap: fix installation commands
68

  
69

  
24 70
Components
25 71
==========
26 72

  
b/docs/quick-install-admin-guide.rst
1418 1418
component right now.
1419 1419

  
1420 1420

  
1421
.. _cyclades-install-vncauthproxy:
1422

  
1423
vncauthproxy
1424
------------
1425

  
1426
To support OOB console access to the VMs over VNC, the vncauthproxy
1427
daemon must be running on every :ref:`APISERVER <APISERVER_NODE>` node.
1428

  
1429
.. note:: The Debian package for vncauthproxy undertakes all configuration
1430
   automatically.
1431

  
1432
Download and install the latest vncauthproxy from its own repository,
1433
at `https://code.grnet.gr/git/vncauthproxy`, or a specific commit:
1434

  
1435
.. code-block:: console
1436

  
1437
    $ bin/pip install -e git+https://code.grnet.gr/git/vncauthproxy@INSERT_COMMIT_HERE#egg=vncauthproxy
1438

  
1439
Create ``/var/log/vncauthproxy`` and set its permissions appropriately.
1440

  
1441
Alternatively, build and install Debian packages.
1442

  
1443
.. code-block:: console
1444

  
1445
    $ git checkout debian
1446
    $ dpkg-buildpackage -b -uc -us
1447
    # dpkg -i ../vncauthproxy_1.0-1_all.deb
1448

  
1449
.. warning::
1450
    **Failure to build the package on the Mac.**
1451

  
1452
    ``libevent``, a requirement for gevent which in turn is a requirement for
1453
    vncauthproxy is not included in `MacOSX` by default and installing it with
1454
    MacPorts does not lead to a version that can be found by the gevent
1455
    build process. A quick workaround is to execute the following commands::
1456

  
1457
        $ cd $SYNNEFO
1458
        $ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
1459
        <the above fails>
1460
        $ cd build/gevent
1461
        $ sudo python setup.py -I/opt/local/include -L/opt/local/lib build
1462
        $ cd $SYNNEFO
1463
        $ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
1464

  
1465
.. todo:: Mention vncauthproxy bug, snf-vncauthproxy, inability to install using pip
1466
.. todo:: kpap: fix installation commands
1467

  
1468

  
1469 1421
Configuration of Cyclades (and Plankton)
1470 1422
========================================
1471 1423

  

Also available in: Unified diff