summaryrefslogtreecommitdiffstats
path: root/README
blob: 9e727c1d29acd34182f5cc9bcf76028c318e4cdc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

VM Chooser Helper Program
==================================

This is the program used by the vmchooser-plugin, which
is part of the openslx-system.



==================================
FAQ
==================================

What does it do?
 It handles xml-files for the virtual-machines plugins 
 or linux sessions after the login-screen.
 If chosen, it starts the proper virtualizer script or the linux session
 as a background process and terminates itself.

How can I build it?
 This project has been converted to cmake and can be built by running:
   $ mkdir -p build
   $ cd build
   $ cmake .. && make
 Alternatively you can just run:
   $ ./build.sh

How can I install it?
 See below

What command-line parameters are available?
 "-p|--path=" In this (abolute) path are your xml-files for the virtualizer-plugin
 "-l|--lpath=" In this (absolute) path are your linux sessions
 "-g|--group=" Show only entries valid for this group
 "-h|--help" Show help

==================================


You just need to compile this, if you have local changes.
The most recent svn version is also included in binary format 
in the main folder of this openslx-distribution.

Enter "cmake <path to vmchooser source> && make" to compile everything.

UPDATE: There is a script in the build-directory to simplify building.

Enter "cp vmchooser ../../../../openslx/trunk/os-plugins/plugins/vmchooser/files/" 
to install it to the proper path of the svn distribution of openslx 
(only if the build-path is [SVN ROOT]/openslx-src-tools/vmchooser/trunk/somefolder/). 

Do not forget to enter "make install" in [SVN ROOT]/openslx/trunk .

Needed libraries to compile:
 - All sorts of X libs and development files
 - fltk-2 (included - see note *)
 - libxml2 (included - libxml2-dev on Ubuntu)
 
 * Boost Libraries (static - dynamic versions can 
 	be enabled by changing the CMakelists.txt -
 	specifically commenting out the 
 	Boost_USE_STATIC_LIBS variable definition)
   (libboost-dev/libboost-[regex|filesystem|system]-dev on Ubuntu) 
 - libboost-regex_s
 - libboost_filesystem_s
 - libboost_system_s
 
Most probably (for fltk2-includes):
 - libpng-dev (libpng12-dev on Ubuntu)
 - libjpeg-dev (libjpeg-dev on Ubuntu)
 - libxi-dev (libxi-dev on Ubuntu)
 - libxinerama-dev (libxinerama-dev on Ubuntu)
 - libxrender-dev (libxrender-dev on Ubuntu)
 - libxconfig1-dev (libxconfig1-dev on Ubuntu)
 - libxft-dev (libxft-dev on Ubuntu)

Needed libraries to run:
 - All sorts of X libs
 - libxml2

===================================
* Some static libraries of fltk - svn version - and libxml2 are located 
in fltk/ and libxml2/ and are used to link against this program.
- as images are enabled, you should have libjpeg and libpng too.
===================================