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 servers used by Ulteo OVD need to be installed with Red Hat RHEL 5.2 32-bit, Fedora Core 9 or CentOS 5.2.
All operations need to be done as superuser (root).
Ulteo OVD is not compatible with SELinux yet.
So please disable SELinux support:
# yum remove selinux-policy
If you don't have any available MySQL database, you have to install MySQL on your Session Manager.
Install the mysql-server package:
# yum install mysql mysql-serverTo start automatically MySQL when the system boots up
# chkconfig --levels 235 mysqld on
Start the service
# service mysqld start
Define the root mysql password
# mysqladmin -u root password 'mysql_root_password'
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
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.
The first step is to configure yum to enable the Ulteo rpm repository. Create the file /etc/yum.repos.d/ovd.repo with:
[ovd-2.5] name=Ulteo OVD 2.5 baseurl=http://archive.ulteo.com/ulteo/rpm/rhel5/2.5 enabled=1 gpgcheck=1 gpgkey=http://archive.ulteo.com/ulteo/rpm/ulteo-archive.keyLet rpm know about the ulteo signing key by executing the following commands:
# wget http://archive.ulteo.com/ulteo/rpm/ulteo-archive.key # rpm --import ulteo-archive.key # rm ulteo-archive.keyInstall the ovd-session-manager package:
# yum install ovd-session-manager# sm-config Admin login: admin Password: Retype password: Chroot download url [http://www.ulteo.com/main/downloads/ulteo-ovd.php?suite=2.5]: 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.5 * chroot directory: /usr/share/ulteo/sessionmanager/base.tar.gz * apache group: apache * apache dir: /etc/httpd/conf.d Is this correct? [Y/n]Configure and start apache service
# chkconfig httpd on # service httpd 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:
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.
If you haven't done it yet for the Session Manager, configure yum to enable the Ulteo rpm repository. Create the file /etc/yum.repos.d/ovd.repo with:
[ovd-2.5] name=Ulteo OVD 2.5 baseurl=http://archive.ulteo.com/ulteo/rpm/rhel5/2.5 enabled=1 gpgcheck=1 gpgkey=http://archive.ulteo.com/ulteo/rpm/ulteo-archive.keyLet rpm know about the ulteo signing key by executing the following commands:
# wget http://archive.ulteo.com/ulteo/rpm/ulteo-archive.key # rpm --import ulteo-archive.key # rm ulteo-archive.keyInstall the ovd-application-server package:
# yum install ovd-application-serverImportant 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]Configure and start apache service
# chkconfig httpd on # service httpd restartConfigure and start Ulteo service
# chkconfig ulteo-ovd on # service ulteo-ovd restart
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:
