Commit 0ddf243a authored by Constantinos Venetsanopoulos's avatar Constantinos Venetsanopoulos
Browse files

Move vncauthproxy section out of the admin guide

snf-vncauthproxy is installed automatically during the snf-cyclades-app
installation, so there is no need for details in the admin's quick
install guide. The section has been moved to the integrator's guide and
needs to get updated in the future.
parent ffa88f69
......@@ -21,6 +21,52 @@ up and running to start developing.
Synnefo internals
=================
snf-vncauthproxy
----------------
To support OOB console access to the VMs over VNC, the vncauthproxy
daemon must be running on every :ref:`APISERVER <APISERVER_NODE>` node.
.. note:: The Debian package for vncauthproxy undertakes all configuration
automatically.
Download and install the latest vncauthproxy from its own repository,
at `https://code.grnet.gr/git/vncauthproxy`, or a specific commit:
.. code-block:: console
$ bin/pip install -e git+https://code.grnet.gr/git/vncauthproxy@INSERT_COMMIT_HERE#egg=vncauthproxy
Create ``/var/log/vncauthproxy`` and set its permissions appropriately.
Alternatively, build and install Debian packages.
.. code-block:: console
$ git checkout debian
$ dpkg-buildpackage -b -uc -us
# dpkg -i ../vncauthproxy_1.0-1_all.deb
.. warning::
**Failure to build the package on the Mac.**
``libevent``, a requirement for gevent which in turn is a requirement for
vncauthproxy is not included in `MacOSX` by default and installing it with
MacPorts does not lead to a version that can be found by the gevent
build process. A quick workaround is to execute the following commands::
$ cd $SYNNEFO
$ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
<the above fails>
$ cd build/gevent
$ sudo python setup.py -I/opt/local/include -L/opt/local/lib build
$ cd $SYNNEFO
$ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
.. todo:: Mention vncauthproxy bug, snf-vncauthproxy, inability to install using pip
.. todo:: kpap: fix installation commands
Components
==========
......@@ -1418,54 +1418,6 @@ automatically along with Cyclades, because it is contained in the same Synnefo
component right now.
.. _cyclades-install-vncauthproxy:
vncauthproxy
------------
To support OOB console access to the VMs over VNC, the vncauthproxy
daemon must be running on every :ref:`APISERVER <APISERVER_NODE>` node.
.. note:: The Debian package for vncauthproxy undertakes all configuration
automatically.
Download and install the latest vncauthproxy from its own repository,
at `https://code.grnet.gr/git/vncauthproxy`, or a specific commit:
.. code-block:: console
$ bin/pip install -e git+https://code.grnet.gr/git/vncauthproxy@INSERT_COMMIT_HERE#egg=vncauthproxy
Create ``/var/log/vncauthproxy`` and set its permissions appropriately.
Alternatively, build and install Debian packages.
.. code-block:: console
$ git checkout debian
$ dpkg-buildpackage -b -uc -us
# dpkg -i ../vncauthproxy_1.0-1_all.deb
.. warning::
**Failure to build the package on the Mac.**
``libevent``, a requirement for gevent which in turn is a requirement for
vncauthproxy is not included in `MacOSX` by default and installing it with
MacPorts does not lead to a version that can be found by the gevent
build process. A quick workaround is to execute the following commands::
$ cd $SYNNEFO
$ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
<the above fails>
$ cd build/gevent
$ sudo python setup.py -I/opt/local/include -L/opt/local/lib build
$ cd $SYNNEFO
$ sudo pip install -e git+https://code.grnet.gr/git/vncauthproxy@5a196d8481e171a#egg=vncauthproxy
.. todo:: Mention vncauthproxy bug, snf-vncauthproxy, inability to install using pip
.. todo:: kpap: fix installation commands
Configuration of Cyclades (and Plankton)
========================================
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment