support ubuntu precise

ULTEO OPEN VIRTUAL DESKTOPV4.0.2UBUNTU 12.04 (PRECISE PANGOLIN) SUPPORT

Ulteo Open Virtual Desktop v4.0.2

Contents

1 Prerequisites: Ubuntu 12.04 (Precise Pangolin) 31.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 sudo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Repository 52.1 Online Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3 Session Manager Installation and Configuration 63.1 Installing MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63.2 Package Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63.3 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.4 Setting Up the Subsystem Archive . . . . . . . . . . . . . . . . . . . . . . . 11

4 Installing the Application Server and File Server (using Subsystem) 124.1 Important note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.2.1 Setting a Redirection Name . . . . . . . . . . . . . . . . . . . . . . . 145 Installing a Web Portal (eg web.test.demo) 15

© ULTEO SAS - HTTP://WWW.ULTEO.COM 2014 - 1

HTTP://WWW.ULTEO.COM


The purpose of this document is to describe how the different server roles of UlteoOVD can be installed on Ubuntu 12.04 (Precise Pangolin) system.




Section 1 Prerequisites: Ubuntu 12.04 (Precise Pangolin)

The new LTS version is Ubuntu 12.04 (Precise Pangolin).

1.1 System Requirements

• For a Session Manager:• Evaluations/POCs: Minimum prerequisites are 1 CPU core and 512MB RAM• Production environments: Ulteo recommends a minimum of 2GB RAM and2 CPU cores

• For an Application Server (Subsystem):• Evaluations/POCs: Minimum prerequisites are 1 CPU core and 1GB RAM• Production environments: Ulteo recommends a minimum of 4GB RAM and2 CPU cores

• For a Web Portal:• Evaluations/POCs: Minimum prerequisites are 1 CPU core and 512MB RAM• Production envrionments: Ulteo recommends 1GB RAM whenever possibleor more

• For using the same physical machine to host the Session Manager, the Web Por-tal and the Linux Application Server:• Evaluations/POCs: Minimum prerequisites are 1 CPU core and 1GB RAM• Production environments: Please note, Ulteo does not recommend usingthis installation method for production environments

1.2 sudo

On Ubuntu systems, we are not using the super user (root) to log in and install pack-ages. It is recomended to use sudo.So there are two alternatives: either you think about adding sudo before each com-mand you launch or you log in as rootTo log in as root:$ sudo -s




In this document, we are using sm.test.demo for the Session Manager address,aps.test.demo for the Application Server and web.test.demo for the Web Portal.

You need to use the names that are configured for your own environment.




Section 2 Repository

Ubuntu 12.04 (Precise Pangolin) is a Debian-based system which uses the same pack-aging system and tools: apt-get. So you need to have an internet connection on yourUbuntu 12.04 (Precise Pangolin) system and add an Ulteo Debian repository to yoursystem.

2.1 Online Method

The followingmethod describes the repository process when your servers have accessto the Internet.• Edit the /etc/apt/sources.list.d/ulteo_ovd.list file and add these lines:

deb http :// archive.ulteo.com/ovd /4.0/ ubuntu precise main

Completing the Installation Process• Update the package database:

# apt -get update

GPG errors given by the previous command will be fixed in the next instal-lation steps. They won’t prevent the installation from succeeding.

• Install the keyring package to validate the repository using gpg:# apt -get install ulteo -keyring# apt -get update




Section 3 Session Manager Installation and Configuration

The Session Manager is a LAMP (Linux Apache MySQL PHP) system and can be usedon an exising LAMP server.

3.1 Installing MySQL

The Session Manager needs access to a MySQL database. We advise you to setup theMySQL server on the same machine as the Session Manager to minimize access time.• Install themysql-server package:

# apt -get install mysql -server

A password for root will be asked.• Now login to mysql and create a database:

# mysql -u root -p -e ’create database ovd ’

3.2 Package Installation

• Install the ulteo-ovd-session-manager packages:# apt -get install ulteo -ovd -session -manager ulteo -ovd - ←↩

administration -console

• The installer requires the location of the Session Manager

• The installer requires an admin login




• And a password:

• which has to be confirmed:




• As described in the Archictecture documentation, a Susbsystem archive can beinstalled on the SM to simplify Application Server deployments.

If you don’t have access to the Internet, please read this to manually getthe subsystem archive.




The server is now installed but not configured yet. To configure the SM, open http://sm.test.demo/ovd/admin in a web browser. It should display this page:

3.3 Configuration

The first step is to go to http://sm.test.demo/ovd/admin and authenticate yourself withthe login and password you provided during installation.

The first time you log in, the system detects that it is not configured so you are redi-rected to a basic setup page which will save a default configuration.


http://sm.test.demo/ovd/admin





You have to set the MySQL configuration. For example, if you install MySQL on thesame host as described previously, you would use the follwing configuration:

Then, modifications are validated.

The Session Manager is now installed. Please read the appropriate documentations toinstall other servers or start sessions.




3.4 Setting Up the Subsystem Archive

If you didn’t specify a URL when initailly prompted, you have to manually copy a sub-system archive into /var/cache/ulteo/sessionmanager/base.tar.gz.Retrieve the base.tar.gz archive from the Ulteowebsite and copy it into the /var/cache/ul-teo/sessionmanager/ folder of your machine.


http://www.ulteo.com/main/downloads/ulteo-ovd.php?suite=4.0.2



Section 4 Installing the Application Server and File Server(using Subsystem)

4.1 Important note

Due to issues with the latest kernel, it’s necessary to downgrade it. You have touse a Linux kernel version 3.2.0 in your host server

• Install the previous kernel# sudo apt -get update# sudo apt -get install linux -image -3.2.0 -60 - virtual linux -image - ←↩

extra -3.2.0 -60 - virtual

• List all kernels installed# dpkg -l | grep linux -image

• Remove all kernels higher than linux-image-3.2.0.60# sudo apt -get remove --purge linux -image -XXX

• You must reboot the server now

4.2 Installation

• Install the package ulteo-ovd-subsystem:# apt -get install ulteo -ovd -subsystem

• The only information required is the host/IP address where the session managercan be accessed (we use sm.test.demo here for the example, but of course, youhave to set your own domain name).

If you are going to install an Application Server on the same machine asyour Session Manager, it is recommended to use 127.0.0.1 as the host.


sm.test.demo

127.0.0.1



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

Your server should appear in the Unregistered server page.




4.2.1 Setting a Redirection Name

The server redirection name is optional. If all your machines are in the same net-work, you don’t have to change it.

If you have installed your Application Server on the same machine as your Ses-sion Manager and you have followed our advice, you have set 127.0.0.1 as the

server name so youmust define a redirection name.

The redirection name is used when launching sessions. When you launch a ses-sion, you are redirected to an Application Server using the redirection name as tar-get host. In some cases the default redirection name is not valid. For instance, ifyou set up a private IP address and you want to connect to your Application Serverfrom the internet.




Section 5 Installing a Web Portal (eg web.test.demo)

The Ulteo OVD Web Portal is no longer installed with the Session Manager as it wason previous versions (version number < 3.0). So you have to install it manually onany server you want. It is, of course, possible to install it on the same machine as theSession Manager.In this example, we are using web.test.demo as the Web Portal address• Install the package ulteo-ovd-web-client:

# apt -get install ulteo -ovd -web -client

• The installer asks if you want to connect the Web Portal with an existing SessionManager. The answer depends on whether you want to use this Web Portal in aspecific Ulteo OVD farm or if you want a generic Web Portal.

• If you answered yes for the previous question, you now have to provide thehost/IP address of the Session Manager. In our example: sm.test.demo.


sm.test.demo



Using you web browser, go to http://web.test.demo/ovd/, you should see a login page:


http://web.test.demo/ovd/


support ubuntu precise

Documents

ulteo open virtual desktopv4

precise pangolin system

ulteo debian repository

minimum prerequisites

sudo s ulteo sas http

ubuntu precise maincompleting

gb ram production environments

web portal