Table of Contents
A minimal Open Virtual Desktop infrastructure requires one Session Manager and one Application Server.
the Session Manager is a LAMP (Linux Apache MySQL PHP) system and could be used in an exising LAMP server.
the Application Server is a server where the desktop and applications will be executed. It has to be a Ulteo OVD dedicated server.
![[Important]](img/important.png) | Important |
|---|---|
In this document, we are using sm.ulteo.com for the Session Manager and aps.ulteo.com for Application Server. You need to set that names according to your own domain names. |
![[Note]](img/note.png) | Note |
|---|---|
It is possible to install both Application Server and Session Manager on the same machine. |
The Session Manager is the main server for your Ulteo Open Virtual Desktop infrastructure. It will manage all your application servers through an administration web interface.
All operations need to be done as superuser (root).
Autotools: autoconf, intltool, make.
PHP 5 with modules curl, ldap, mysql, and gettext.
Apache 2 with php module enable.
Java developper kit with ant, keytool, jdk >=1.5
Extract the ovd applet tarball and enter in the directory
$ tar xfz ovd-applets.tar.gz
$ cd ovd-applets/
Create a working directory
$ mkdir certificate $ cd certificate
Set the options
$ export PASSWD="123546" $ export DNAME="cn=myname, ou=Ulteo, o=Ulteo, c=EN" $ export ALIAS="ulteo" $ export KEYSTORE=keystore $ export VALIDITY=180
Build the certificate
$ keytool -genkeypair -dname "$DNAME" -alias "$ALIAS" -keypass "$PASSWD" -storepass "$PASSWD" -keystore "$KEYSTORE" -validity "$VALIDITY"
Self sign the certificate
$ keytool -selfcert -alias "$ALIAS" -keystore "$KEYSTORE" -keypass "$PASSWD" -storepass "$PASSWD"
Back to the parent directory (the applet source one)
$ cd ..
Set the java development environnement. For instance, if you are using Sun java 5:
$ export JAVA_BINDIR=/usr/lib/jvm/java-1.5.0-sun-1.5.0/bin $ export JAVA_ROOT=/usr/lib/jvm/java-1.5.0-sun-1.5.0 $ export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun-1.5.0
Compile
$ ant sign -Dprefix=/usr -Dbuild.cert=certificate/
Install
# ant install
Download the Ulteo Open Virtual Desktop tarball from http://www.ulteo.com/home/ovdi/openvirtualdesktop/download
Uncompress the tarball and enter into the Session Manager directory
$ tar xzf ulteo-ovd.tar.gz $ cd ulteo-ovd $ tar xzf sessionmanager.tar.gz $ cd sessionmanager
Install the system
./configure && make && make install
Add
/usr/local/binto the PATHexport PATH=$PATH:/usr/local/bin
# sm-config Admin login: admin Password: Retype password: Chroot download url [http://www.ulteo.com/main/downloads/ulteo-ovd.php?suite=2.0]: Chroot destination [/usr/share/ulteo/sessionmanager/base.tar.gz]: Options: * chroot download: yes * chroot URL: http://www.ulteo.com/main/downloads/ulteo-ovd.php?suite=2.0 * chroot directory: /usr/share/ulteo/sessionmanager/base.tar.gz * apache group: apache * apache dir: /etc/httpd/conf.d Is this correct? [Y/n]Restart apache
apache2ctl restart
The server is now installed but not configured yet. You have to open http://sm.ulteo.com/sessionmanager with a web browser.It should display this page:
If you get an empty page and see an error about mb_internal_encoding() in the Apache log, comment line:
mb_internal_encoding('UTF-8');in /usr/local/share/ulteo/sessionmanager/includes/core.inc.php and /usr/local/share/ulteo/sessionmanager/includes/core-minimal.inc.php.
The first step is to go to http://sm.ulteo.com/sessionmanager/admin and autenticate yourself with the login and password you provided during the installation.
For the first time you login, the system detect that is not well configured so you are redirected to a basic setup page which will save a default configuration.
You have to set the MySQL configuration. For instance, if you install MySQL on the same host as described previously, here is the configuration:
Then, you should be redirected to the main page:
The session manager has no application server plugged yet. You now have to install one or more Application Servers.
All operations need to be done as superuser (root).
Autotools: autoconf intltool make
PHP 5 with modules curl imagick.
Apache 2 with php module enable.
| Important |
|---|---|
If you are not installing on the same server as a already existing one, you have to build the applets. To build the applet, please follow the instructions on the Session Manager installation. |
Download the Ulteo Open Virtual Desktop tarball from http://www.ulteo.com/home/ovdi/openvirtualdesktop/download
Uncompress the tarball and enter into the Application server directory http://www.ulteo.com/home/ovdi/openvirtualdesktop/download
$ tar xzf ulteo-ovd.tar.gz $ cd ulteo-ovd $ tar xzf applciationserver.tar.gz $ cd applicationserver
Install the system
# ./configure && make && make install
Add
/usr/local/binto the PATHexport PATH=$PATH:/usr/local/bin
Important If you are going to install an Application server on the same machine as your Session Manager, it's recommended to use:
FQDN: 127.0.0.1
SM URL: http://127.0.0.1/sessionmanager
# aps-chroot-install Full Qualified Domain Name [aps.ulteo.com]: aps.ulteo.com Session Manager URL: http://sm.ulteo.com/sessionmanager Chroot installation path: /opt/ulteo Options: * FQDN: aps.ulteo.com * SM URL: http://sm.ulteo.com/sessionmanager * chroot path: /opt/ulteo * chroot download: yes * apache group: apache * apache dir: /etc/httpd/conf.d Is this correct? [Y/n]Then start the OVD daemon in the chroot:
chroot /opt /etc/init.d/ulteo-ovdd start
An Application server has been installed and is now ready. First, we have to register it, and switch it from maintenance mode to production mode.
Your server should appear in the Unregistered server page.
If your server does not appear in the list, you might have a DNS configuration issue, please report to the FAQ to solve this issue.
If you want to use this server on your network, you have to click on register.
Now, click on Switch to production to switch it to Production mode.
The server redirection name is an option. If all your machines are in the same network, you don't have to change it.
| Important |
|---|---|
If you installed your Application server on the same machine as your Session Manager and you follow our advices, you setup 127.0.0.1 as server name so you must define an redirection name. |
The redirection name is used to launch session. When you launch a session, you are redirected to an Application server using the redirection name as redirection. In some cases the default redirection name (the FQDN you gave at the ApS installation) is not valid. For instance, if you setup an private IP address and you want to connect from Internet.
A publication is an association between a users group and an applications group. It's an authorization for a users group to launch the applications include in the group.
By default, there is no users or applications group installed so you have to create it to launch sessions (it's not possible to launch session without application in the default configuration).
To simplify the process, you can use the Publication wizard by going on Applications page.
Go to the Publications page, select and follow the wizard steps.
| Important |
|---|---|
Client prerequisites:
|
Back to http://sm.ulteo.com/sessionmanager/ with your browser, you should see a login page:
Once logged in, the session is launching:
The session is launched and is ready to use with applications that have been published for the user:
