Ulteo OVD 4.0 - Migration OVD 3 To OVD 4 - v1.0

ULTEO OPEN VIRTUAL DESKTOP
V4.0
MIGRATION GUIDE
28 February 2014
U l t e o O p e n V ir t u a l D e s k t o p v4 . 0
Contents
Section 1 Introduction ............................................................................................................................... 4
Section 2 Overview ..................................................................................................................................... 5
Section 3 Preparation ................................................................................................................................ 6
3.1 Enter Maintenance Mode ................................................................................................................ 6
3.2 Backup The OVD Session Manager Data ...................................................................................... 7
Section 4 Installing OVD V4 ....................................................................................................................... 8
4.1 Upgrade The Session Manager ...................................................................................................... 8
4.1.1 Install OVD 4 ............................................................................................................................... 8
4.1.2 Session Manager Database Migration.................................................................................. 11
4.2 OVD Web Portal .............................................................................................................................. 12
4.2.1 Install OVD 4 ............................................................................................................................. 12
4.2.2 Modify The Web Portal Configuration .................................................................................. 14
4.3 OVD Windows Application Server ................................................................................................ 16
4.4 OVD Linux Application Server ....................................................................................................... 17
4.4.1 Update OVD 4 Subsystem ...................................................................................................... 17
4.4.2 Install OVD 4 Application Server Package ............................................................................ 18
4.4.3 Restarting the Linux Application Server ............................................................................... 20
4.5 OVD File Server ............................................................................................................................... 21
4.5.1 Update OVD 4 Subsystem ...................................................................................................... 21
4.5.2 Install OVD 4 File Server Package .......................................................................................... 24
4.5.3 Restarting the File Server ....................................................................................................... 26
4.6 OVD Gateway .................................................................................................................................. 27
4.6.1 Update OVD 4 Gateway .......................................................................................................... 27
Migration Guide ULTEO SAS 2014 - 2
4.7 Production Mode ............................................................................................................................ 28
Section 1 Introduction
This document describes the process to migrate an existing OVD v3.x farm to the latest major
version of OVD, v4.0
If your OVD installation contains swat patches, you need first to list them and contact us
to define how to proceed.
Section 2 Overview
The migration is a manual process that consists of the multiple steps. Each step is explained in
greater detail below.
Preparation: The system must be offline and should be backed up before migrating.
Installation: Each system component is updated in turn.
Completion: Run a test to make sure the migration worked.
Section 3 Preparation
3.1 Enter Maintenance Mode
In order to migrate to OVD V4, you will need to take the current system offline. First of all, stop
the services on each of the servers you have in your OVD farm and then switch the system to
maintenance mode.
OVD L INUX A PPLICATION S ERVER
root@server:~# /etc/init.d/ulteo-ovd-subsystem stop
OVD W INDOWS A PPLICATION S ERVER

Stop the Windows Service called Ulteo Open Virtual Desktop agent
OVD F ILE S ERVER

OVD G ATEWAY
root@server:~# /etc/init.d/ulteo-ovd-slaveserver stop
OVD S ESSION M ANAGER

Go to the OVD Administration console
1. Click on Status tab then Session and close all user sessions
2. Go to the Index tab and click switch the system to maintenance mode
OVD W EB P ORTAL
The Web Portal will be in maintenance mode once the OVD system has been set to maintenance
mode through the Admin Console.
3.2 Backup The OVD Session Manager Data

Before upgrading the OVD 3.x system, it is highly recommended that you make backups of the
OVD Session Manager data in case there are any migration issues. The steps below explain how
to backup the database and configuration file on the Session Manager.
Backup the Session Manager database using the following command using your own username
and password:
root@server:~# mysqldump --user=[admin_user] --password=[password] ovd |

gzip > backup_database_ovd.sql.gz
Backup the Session Manager configuration file using the following command:
root@server:~# tar cvzf backup_config.tar.gz

/var/spool/ulteo/sessionmanager/config
Make sure these files are stored in a secure location.
Section 4 Installing OVD V4

4.1 Upgrade The Session Manager
Once you have completed the preparation and backup steps, you can proceed to install OVD V4
starting with the Session Manager.
4.1.1 Install OVD 4

The next step is to install Ulteo OVD 4 on the Session Manager using the OVD 4 repositories.
For the Linux distro you have installed, use the following commands to add the new source
and install OVD 4.0
4.1.1.1 Debian/Ubuntu
Edit the sources file.
root@server:~# vi /etc/apt/sources.list.d/ulteo-ovd.list
Add the OVD source and save the file
deb http://archive.ulteo.com/ovd/4.0.0/ubuntu [dists] main
* replace dists with either lucid or precise depending on your distribution
Install OVD 4.0
root@server:~# apt-get update && apt-get install ulteo-ovd-sessionmanager ulteo-ovd-l10n
Verify that you have now have a v4.0.0 version installed
root@server:~# dpkg -l | grep ulteo
You should see lines that have the value 4.0.0.0 as in the example below.
ulteo-ovd-administration-console 4.0.0.0.XXX Ulteo

ulteo-ovd-l10n
4.0.0.0.XXX Ulteo
ulteo-ovd-session-manager
4.0.0.0.XXX Ulteo
4.1.1.2 Centos/Redhat 6.0
Edit the repository file
root@server:~# vi /etc/yum.repos.d/ovd.repo
Add the new repository
[ovd-4.0.0]
name=Ulteo OVD 4.0.0
baseurl=http://archive.ulteo.com/ovd/4.0.0/rhel/6.0/
enabled=1
gpgcheck=1
gpgkey=http://archive.ulteo.com/ovd/4.0.0/rhel/6.0/keyring
Install OVD 4.0
root@server:~# yum install ulteo-ovd-session-manager ulteo-ovd-l10n
root@server:~# rpm -qa | grep ulteo
ulteo-ovd-administration-console-4.0.0.0.XXX.noarch
ulteo-ovd-l10n-4.0.0.0.XXX.noarch
ulteo-ovd-session-manager-4.0.0.0.XXX.noarch
4.1.1.3 SUSE Linux Enterprise Server 11
Add the OVD 4 repository file
zypper ar http://archive.ulteo.com/ovd/4.0.0/sles/11_sp1 ovd
Install OVD 4.0
root@server:~# zypper refresh && zypper install ulteo-ovd-sessionmanager ulteo-ovd-l10n
4.1.1.4 openSUSE 11.3
zypper ar http://archive.ulteo.com/ovd/4.0.0/opensuse/11.3 ovd
Install OVD 4.0
root@server:~# zypper refresh && zypper install ulteo-ovd-sessionmanager ulteo-ovd-l10n
4.1.2 Session Manager Database Migration

The next step is to migrate the OVD 3.x MySQL database on the Session Manager to the
format required by OVD 4. This will be done by creating and then running a script.
First, create a script for the SQL migration
root@server:~# vi migration_database.sql
Copy the following lines into the script and save it.
ALTER TABLE ùlteo_servers` DROP PRIMARY KEY, ADD ìd` varchar(255), ADD
UNIQUE U_FQDN (`fqdn`);
UPDATE ùlteo_servers` SET ìd` = `fqdn`;
ALTER TABLE ùlteo_servers` ADD PRIMARY KEY (ìd`);
ALTER TABLE ùlteo_servers_properties` DROP PRIMARY KEY, CHANGE `fqdn`
`server` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_general_ci NOT
NULL DEFAULT '', ADD PRIMARY KEY (`server`, `property`);
Execute the script using your own username and password
root@server:~# mysql --user=[username] --password=[password] -database=ovd < migration_database.sql
Validate the modifications by saving the database settings. On the OVD

Administration Console, go to Configuration, Database settings and click on
Save. Check the Servers to make sure everything looks good.
4.2 OVD Web Portal

After completing the Session Manager upgrade, move onto to the Web Portal. Note: this server
was previously called the Web Client in OVD 3.
4.2.1 Install OVD 4

Install Ulteo OVD 4 on the Web Portal using the OVD 4 repositories. For the Linux distro you
have installed, use the following commands to add the new source and install OVD 4.0
Install OVD 4.0 keeping your configuration file
root@server:~# apt-get update && apt-get install ulteo-ovd-web-client

ulteo-ovd-web-client-ajaxplorer ulteo-ovd-applets ulteo-ovd-l10n
Add the new repository and save the file
[ovd-4.0.0]
enabled=1
gpgcheck=1
Install OVD 4.0
root@server:~# yum install ulteo-ovd-web-client ulteo-ovd-web-clientajaxplorer ulteo-ovd-applets ulteo-ovd-l10n
Install OVD 4.0
root@server:~# zypper refresh && zypper install ulteo-ovd-web-client

4.2.1.4 openSUSE 11.3
Install OVD 4.0
root@server:~# zypper refresh && zypper install ulteo-ovd-web-client

4.2.2 Modify The Web Portal Configuration

The configuration file for the Web Portal must now be modified to support the new features
available in OVD 4. Open the file /etc/ulteo/webclient/config.inc.php in an editor and add the
lines listed below. Set the values that match your environment. After completing the changes
save the file.
// Option force SSO: do not allow the user to enter a login and
password. The login is set to use REMOTE_USER if possible
// define('OPTION_FORCE_SSO', true);
// define('OPTION_FORCE_SSO', false);
// default
// define('DEBUG_MODE', true);
// define('DEBUG_MODE', false);
// default
// define('RDP_INPUT_METHOD', 'unicode'); // alternative method

// define('RDP_INPUT_METHOD', 'unicode_local_ime'); // alternative
method with client integration
// RDP input method: show option
// define('OPTION_SHOW_INPUT_METHOD', true);
// define('OPTION_SHOW_INPUT_METHOD', false);
// default
//
//
//
//
RDP input method: force option

Must be used in conjunction of RDP_INPUT_METHOD
define('OPTION_FORCE_INPUT_METHOD', true);
define('OPTION_FORCE_INPUT_METHOD', false);
// default
//
//
//
//
Perform desktop integration in portal sessions

publish destkop and start menu icons, mime type association, ...
define('PORTAL_LOCAL_INTEGRATION', true);
define('PORTAL_LOCAL_INTEGRATION', false);
// default
//
//
//
//
Confirm Logout Options

define('OPTION_CONFIRM_LOGOUT', 'always');
define('OPTION_CONFIRM_LOGOUT', 'apps_only');
define('OPTION_CONFIRM_LOGOUT', 'never');
// default
continued
// Option direct SM communication (with proxy.php)

// define('OPTION_USE_PROXY', true);
// define('OPTION_USE_PROXY', false);
// default
// HTML5 Client installed
define('RDP_PROVIDER_HTML5_INSTALLED', true);
// define('RDP_PROVIDER_HTML5_INSTALLED', false); // default
// Java web client installed
define('RDP_PROVIDER_JAVA_INSTALLED', true);
// define('RDP_PROVIDER_JAVA_INSTALLED', false);
// default
This completes the update of the Web Portal.
4.3 OVD Windows Application Server

To upgrade a Windows Application Server, run the new installer on your Application Server. You
can download the installer at http://www.ulteo.com/main/downloads/ulteo-ovdwin.php?suite=4.0.0.
The installation process will prompt the user to restart the server which should be done to
activate OVD 4.
4.4 OVD Linux Application Server

Next upgrade the Linux Application Servers. The Linux Application server has an OVD Subsystem
installed as well as a standard software package. The migration first deals with the subsystem
and then updates the standard software package.
4.4.1 Update OVD 4 Subsystem
The subsystem should have already been stopped as part of the preparation. If not,
then issue the following command:
From inside the OVD Subsystem, remove the package ulteo-ovd-desktop-settings

and update the installation to OVD 4.
(OVD)root@srv:/#: apt-get remove ulteo-ovd-desktop-settings
Modify the software installation sources file to add the new source
(OVD)root@srv:/#: vi /etc/apt/sources.list.d/ulteo_ovd.list
Add the new source for OVD 4 and save the changes
deb http://archive.ulteo.com/ovd/4.0.0/ubuntu lucid main
Update the software packages for the subsystem using the following command
(OVD)root@srv:/#: apt-get update && apt-get install ulteo-ovd-desktop

ulteo-ovd-slaveserver ulteo-ovd-slaveserver-role-aps uxda-server ulteoovd-externalapps-client ulteo-ovd-integrated-launcher ulteo-xfce4restricted-menu-plugin libovd-xclient-area
NOTE: If you have installed the File Server on the same server, do not restart the slave
server now. The subsystem and slave server will be restarted once you have completed
the File Server migration.
Restart the slave server if the File Server is not installed on this server.
(OVD)root@srv:/#: /etc/init.d/ulteo-ovd-slaveserver stop

(OVD)root@srv:/#: /etc/init.d/ulteo-ovd-slaveserver start
4.4.2 Install OVD 4 Application Server Package

Now working outside the subsystem again, update the OVD software package. For the Linux
distro you have installed, use the following commands to add the new source and install OVD
4.0
Install the OVD 4 subsystem software
root@server:~# apt-get update && apt-get install ulteo-ovd-subsystem
[ovd-4.0.0]
enabled=1
gpgcheck=1
root@server:~# yum install ulteo-ovd-subsystem
Install OVD 4.0
root@server:~# zypper refresh && zypper install ulteo-ovd-subsystem
4.4.2.4 openSUSE 11.3
Install OVD 4
4.4.3 Restarting the Linux Application Server
To restart the Application Server, issue the following command to restart the
subsystem from outside the chroot
NOTE: If you have installed the File Server on the same server, do not restart the slave
server now. The subsystem and slave server will be restarted once you have completed
the File Server migration.
root@server:~# /etc/init.d/ulteo-ovd-subsystem start
4.5 OVD File Server

Next upgrade the Linux Application Servers if any are in your OVD farm. The Application server
has an OVD Subsystem installed as well as a standard software package. The migration first
deals with the subsystem and then updates the standard software package.
4.5.1 Update OVD 4 Subsystem

The subsystem should have already been stopped as part of the preparation. If not, then issue
the following command:
Inside the OVD Subsystem create a profiles_migration.sh file in /root
(OVD)root@server:/#: vi /root/profiles_migration.sh
Add the following lines to the file and save it
#!/bin/bash
LOG=profiles_migration.log
DATETIME="[$(date '+%Y/%m/%d') - $(date '+%H:%M:%S')]"
echo "${DATETIME} Move fs directory to fs.real directory " >> $LOG 2>&1
mv /var/lib/ulteo/ovd/slaveserver/fs
/var/lib/ulteo/ovd/slaveserver/fs.real >> $LOG 2>&1
echo "${DATETIME} Create new fs directory " >> $LOG 2>&1
mkdir -p /var/lib/ulteo/ovd/slaveserver/fs >> $LOG 2>&1
for p in /var/lib/ulteo/ovd/slaveserver/fs.real/p_*
do
echo "${DATETIME} Start copying data from directory ${p}" >> $LOG
2>&1
continued ..
if [ -e ${p}/conf.Windows ]; then
echo "${DATETIME} Create conf directories in ${p}" >> $LOG 2>&1
mkdir ${p}/conf.Windows.2008R2 ${p}/conf.Windows.2008
${p}/conf.Windows.2003 >> $LOG 2>&1
echo "${DATETIME} Rename AppData and LocalAppData in ${p}" >> $LOG
2>&1
mv ${p}/conf.Windows/AppData ${p}/conf.Windows/CSIDL_APPDATA >>
$LOG 2>&1
mv ${p}/conf.Windows/LocalAppData
${p}/conf.Windows/CSIDL_LOCAL_APPDATA >> $LOG 2>&1
echo "${DATETIME} Copy data from directory in ${p}" >> $LOG 2>&1
cp -R ${p}/conf.Windows/* ${p}/conf.Windows.2003 >> $LOG 2>&1
cp -R ${p}/conf.Windows/* ${p}/conf.Windows.2008 >> $LOG 2>&1
cp -R ${p}/conf.Windows/* ${p}/conf.Windows.2008R2 >> $LOG 2>&1
rm -rf ${p}/conf.Windows/ >> $LOG 2>&1
fi
echo "${DATETIME} Move Desktop and Documents to Data directory in
${p} " >> $LOG 2>&1
mkdir ${p}/Data >> $LOG 2>&1
mv ${p}/Desktop ${p}/Documents ${p}/Data >> $LOG 2>&1
done
echo "${DATETIME} Chown on /var/lib/ulteo/ovd/slaveserver/fs ">> $LOG
2>&1
chown ovd-fs:ovd-fs /var/lib/ulteo/ovd/slaveserver/fs >> $LOG 2>&1
Make the file executable and run the script. The script will create a log file in the
same folder.
(OVD)root@srv:/#: chmod u+x /root/profiles_migration.sh

(OVD)root@srv:/#: /root/profiles_migration.sh
Now update the OVD software. Working inside the OVD Subsystem, remove the
package ulteo-ovd-desktop-settings.
(OVD)root@srv:/#: apt-get remove ulteo-ovd-desktop-settings
Modify the software installation sources file to add the new source
(OVD)root@srv:/#: vi /etc/apt/sources.list.d/ulteo_ovd.list
Add the new source for OVD 4 and save the changes
Update the software packages for the subsystem
(OVD)root@srv:/#: apt-get update && apt-get install ulteo-ovdslaveserver ulteo-ovd-slaveserver-role-fs
4.5.2 Install OVD 4 File Server Package

Now working outside the subsystem again, update the OVD software package. For the Linux
distro you have installed, use the following commands to add the new source and install OVD
4.0
NOTE: If you have installed the File Server on the same server as the Application
Server, the software would have been already been installed when updating the
Application Server.
root@server:~# apt-get update && apt-get install ulteo-ovd-subsystem
[ovd-4.0.0]
enabled=1
gpgcheck=1
root@server:~# yum install ulteo-ovd-subsystem
Install OVD 4.0
4.5.2.4 openSUSE 11.3
Install OVD 4.0
4.5.3 Restarting the File Server
To restart the File Server, issue the following command to restart the subsystem
from outside the chroot
NOTE: If you have installed the File Server on the same server as the Application
Server, this command will start both the File Server and the Application Server.
root@server:~# /etc/init.d/ulteo-ovd-subsystem start
4.6 OVD Gateway

Finally, upgrade the OVD Gateway. The Gateway does not have an OVD Subsystem, so it is only
necessary to upgrade the OVD software package. The migration instructions are written for an
OVD Gateway running Ubuntu Lucid.
4.6.1 Update OVD 4 Gateway

The OVD Gateway should have already been stopped as part of the preparation. If not, then
issue the following command on the server:
root@server:~# /etc/init.d ulteo-ovd-slaveserver stop
Add the OVD source for Debian/Ubuntu and save the file

deb http://archive.ulteo.com/ovd/4.0.0/premium/ubuntu precise main
Install OVD 4
root@server:~# apt-get update && apt-get install ulteo-ovd-slaveserver

ulteo-ovd-slaveserver-role-gateway
Restart the Gateway service.
root@server:~# /etc/init.d ulteo-ovd-slaveserver start
4.7 Production Mode

The migration is complete. Switch the system to production mode.
If you meet issues, please send us an email at support-ovd@ulteo.com and add in subject
[MIGRATION ISSUES]

Ulteo OVD 4.0 - Migration OVD 3 To OVD 4 - v1.0

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Ulteo OVD 4.0 - Migration OVD 3 To OVD 4 - v1.0

Uploaded by

Copyright:

Available Formats

ULTEO OPEN VIRTUAL DESKTOP

Migration Guide ULTEO SAS 2014 - 2

4.7 Production Mode ............................................................................................................................ 28

Migration Guide ULTEO SAS 2014 - 3

Migration Guide ULTEO SAS 2014 - 4

Migration Guide ULTEO SAS 2014 - 5

OVD W INDOWS A PPLICATION S ERVER

OVD F ILE S ERVER

OVD S ESSION M ANAGER

Migration Guide ULTEO SAS 2014 - 6

3.2 Backup The OVD Session Manager Data

root@server:~# mysqldump --user=[admin_user] --password=[password] ovd |

root@server:~# tar cvzf backup_config.tar.gz

Migration Guide ULTEO SAS 2014 - 7

Section 4 Installing OVD V4

4.1.1 Install OVD 4

Edit the sources file.

Add the OVD source and save the file

deb http://archive.ulteo.com/ovd/4.0.0/ubuntu [dists] main

* replace dists with either lucid or precise depending on your distribution

Install OVD 4.0

root@server:~# apt-get update && apt-get install ulteo-ovd-sessionmanager ulteo-ovd-l10n

Verify that you have now have a v4.0.0 version installed

root@server:~# dpkg -l | grep ulteo

Migration Guide ULTEO SAS 2014 - 8

ulteo-ovd-administration-console 4.0.0.0.XXX Ulteo

4.1.1.2 Centos/Redhat 6.0

Edit the repository file

Add the new repository

Install OVD 4.0

root@server:~# yum install ulteo-ovd-session-manager ulteo-ovd-l10n

Verify that you have now have a v4.0.0 version installed

root@server:~# rpm -qa | grep ulteo

Migration Guide ULTEO SAS 2014 - 9

4.1.1.3 SUSE Linux Enterprise Server 11

Add the OVD 4 repository file

zypper ar http://archive.ulteo.com/ovd/4.0.0/sles/11_sp1 ovd

Install OVD 4.0

root@server:~# zypper refresh && zypper install ulteo-ovd-sessionmanager ulteo-ovd-l10n

Verify that you have now have a v4.0.0 version installed

root@server:~# rpm -qa | grep ulteo

4.1.1.4 openSUSE 11.3

Add the OVD 4 repository file

zypper ar http://archive.ulteo.com/ovd/4.0.0/opensuse/11.3 ovd

Install OVD 4.0

root@server:~# zypper refresh && zypper install ulteo-ovd-sessionmanager ulteo-ovd-l10n

Verify that you have now have a v4.0.0 version installed

root@server:~# rpm -qa | grep ulteo

Migration Guide ULTEO SAS 2014 - 10

4.1.2 Session Manager Database Migration

First, create a script for the SQL migration

Execute the script using your own username and password

root@server:~# mysql --user=[username] --password=[password] -database=ovd < migration_database.sql

Validate the modifications by saving the database settings. On the OVD

Migration Guide ULTEO SAS 2014 - 11

4.2 OVD Web Portal

4.2.1 Install OVD 4

Edit the sources file.

Add the OVD source and save the file

deb http://archive.ulteo.com/ovd/4.0.0/ubuntu [dists] main

* replace dists with either lucid or precise depending on your distribution

Install OVD 4.0 keeping your configuration file

root@server:~# apt-get update && apt-get install ulteo-ovd-web-client