Ulteo Open Virtual Desktop

Installation

Copyright 2008 Ulteo SAS -

CONTENTS

CONTENTS

Contents
1 2 Prerequisites 1.1 Installation of MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Session Manager (sm.ulteo.com) 2.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.1 Setup the application system archive . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2 Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application Server installation (aps.ulteo.com) 3.1 Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.1.1 Register the server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.1.2 Set an redirection name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Perform a "Publication" Launch a session 2 2 3 3 6 7 9 11 11 12 14 15

4 5

PREREQUISITES

Prerequisites

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.

I MPORTANT
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.

N OTE

It is possible to install both Application Server and Session Manager on the same machine.

The servers used by Ulteo OVD need to be installed with Ubuntu 8.04.3 (Hardy Heron) Server for x86/32 bits (it can be downloaded from this link). All operations need to be done as super user. To log in as root:
$ sudo -s

1.1

Installation of MySQL

If you dont have any available MySQL database, you have to install MySQL on your Session Manager. Install the mysql-server package:
# apt-get install mysql-server

A password for root will be asked. Now log in mysql and create a database:
# mysql -u root -p Enter password: mysql> create database ulteo_sm; Query OK, 1 row affected (0.02 sec) mysql> exit

SESSION MANAGER (SM.ULTEO.COM)

Session Manager (sm.ulteo.com)

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.

2.1

Installation

Add the Ulteo repository to the repository list:

# echo "deb http://archive.ulteo.com/ulteo/ovd 2.0 main" >> /etc/apt/sources .list # apt-get update

N OTE

GPG errors given by the previous command will be xed in the next installation steps. They wont prevent the installation to be successful.

Install the keyring package to validate the repository using gpg:

# apt-get install ulteo-keyring # apt-get update

Install the ulteo-ovd-session-manager package:

# apt-get install ulteo-ovd-session-manager

The installer asks for an admin login

SESSION MANAGER (SM.ULTEO.COM)

2.1

Installation

SESSION MANAGER (SM.ULTEO.COM)

2.1

Installation

And a password:

which has to be conrmed:

SESSION MANAGER (SM.ULTEO.COM)

2.1

Installation

Application servers are using an application system that will be the same for all your application servers:

If you dont have access to Internet, keep this eld empty, well see later how to install it by hand. The server is now installed but not congured yet. You have to open http://sm.ulteo.com/ sessionmanager with a web browser.It should display this page:

2.1.1

Setup the application system archive

If you didnt specify an URL at the last question, you have to copy an application system archive into /usr/share/ulteo/sessionmanager/base.tar.gz. For instance, you can download an archive from http://www.ulteo.com/main/downloads/ ulteo-ovd.php?suite=2.0 from another computer which have access to Internet and copy it on a usb stick. Then, you have to copy it on the Session Manager at /usr/share/ulteo/sessionmanager/base.tar.gz

SESSION MANAGER (SM.ULTEO.COM)

2.2

Conguration

2.2

Conguration

The rst 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 rst time you login, the system detect that is not well congured so you are redirected to a basic setup page which will save a default conguration. You have to set the MySQL conguration. For instance, if you install MySQL on the same host as described previously, here is the conguration:

Then, you should be redirected to the main page:

SESSION MANAGER (SM.ULTEO.COM)

2.2

Conguration

The session manager has no application server plugged yet. You now have to install one or more Application Servers.

APPLICATION SERVER INSTALLATION . . .

Application Server installation (aps.ulteo.com)

Add the Ulteo repositoriy to the Ubuntu repository list:
# echo "deb http://archive.ulteo.com/ulteo/ovd 2.0 main" >> /etc/apt/sources .list # apt-get update

Install the keyring package to validate the repository using gpg:

# apt-get install ulteo-keyring # apt-get update

N OTE

GPG errors given by the previous command will be xed in the next installation steps. They wont prevent the installation to be successful.

Install the package ulteo-ovd-application-server:

# apt-get install ulteo-ovd-application-server

The rst question is about the FQDN (Fully Qualied Domain Name) hostname of the machine you are using as an Application Server. This FQDN is used by the Session Manager server to manage Application Servers. If the FQDN is not dened well, this Application Server will never register on the Main server. Here we are using aps.ulteo.com.

I MPORTANT
If you are going to install an Application server on the same machine as your Session Manager, its adviced to use 127.0.0.1 as FQDN.

APPLICATION SERVER INSTALLATION . . .

10

APPLICATION SERVER INSTALLATION . . .

3.1

Conguration

The next question is about the URL/path where the session manager can be accessed. Provide the URL that was used previously (we use http://sm.ulteo.com/sessionmanager here for the example, but of course, you have to set your own domain name).

I MPORTANT
If you are going to install an Application server on the same machine as your Session Manager, its adviced to use http://127.0.0.1/sessionmanager as URL.

The conguration is now done. The system is going to donwload and uncompress the application system archive from the Session Manager your registered. Once done, you just have to restart the service:
# /etc/init.d/ulteo-ovd restart

3.1
3.1.1

Conguration
Register the server

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.

11

APPLICATION SERVER INSTALLATION . . .

3.1

Conguration

If your server does not appear in the list, you might have a DNS conguration 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. 3.1.2 Set an redirection name

The server redirection name is an option. If all your machines are in the same network, you dont have to change it.

I MPORTANT
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 dene 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.

12

APPLICATION SERVER INSTALLATION . . .

3.1

Conguration

13

PERFORM A "PUBLICATION"

Perform a "Publication"

A publication is an association between a users group and an applications group. Its 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 (its not possible to launch session without application in the default conguration). 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.

14

LAUNCH A SESSION

Launch a session

I MPORTANT
Client prerequisites: Java 1.5/1.6 (Sun or OpenJDK) browser: Firefox 2+ or Internet Explorer 7+

Back to http://sm.ulteo.com/sessionmanager/ with your browser, you should see a login page:

15

LAUNCH A SESSION

Once logged in, the session is launching:

16

LAUNCH A SESSION

The session is launched and is ready to use with applications that have been published for the user:

17