Use this cookbook to install and configure all the components that you need to set up a remote desktop connection to a server. The default recipe in this cookbook installs the following components:
- VNC server - implements "Virtual Network Computing" allowing a remote computer to view the desktop of the computer on which the VNC server is running.
- Desktop environment - provides the graphical desktop environment with windows, icons, etc.
- Web browser - provides the ability to view HTML pages.
The cookbook creates a VNC server service and user account to under which the VNC server and desktop are run. For answers to questions about this cookbook see the provided FAQ.
The components used in the default recipe are TightVNC, LXDE and Firefox, which are all installed using the latest versions from the standard Ubuntu repository. These were chosen for the default recipe as a working set but others work equally well, for example x11vnc for the VNC server, XFCE4 for the desktop and Chrome for the browser. You will need to modify the creation of the vncservice and xstartup scripts in the default recipe if you want to use different VNC server and desktop implementations.
- Chef: 0.10.10+
No other cookbooks are required by this cookbook.
The cookbook currently supports:
- Ubuntu 12.04 LTS x86-64
|['vnc']['geometry']||String||Geometry of the desktop, specified as pixels horizontal x vertical.||1024x768|
|['vnc']['account_username']||String||Name of the user account to set up for use with the installed components. If the account does not exist, it will be created.||vncuser|
vnc in your node's
run_list to install and set up all VNC and desktop components.
Once the recipe has been run on a node you will need to SSH to the node, log in as root and perform the following commands
to complete the configuration:
su - <insert user name here, default vncuser> vncpasswd <enter the password to be used for VNC connections and confirm it> logout service vncserver start
License and Authors
Copyright 2013 IBM Corp. under the Eclipse Public license.
The component installations referred to above are suggested by the Author and Contributors as a working set, however, other products are available which will provide similar functionality. The Author and Contributors shall have no responsibility or liability in respect of the products that are installed by the EPL Chef script. These products are not licensed by the Author and are subject to the terms and conditions imposed by their respective Licensors.
- Author:: Simon Holdsworth firstname.lastname@example.org