Ulteo OVD 4.0 - Migration OVD 3 to OVD 4_v1.0

8/10/2019 Ulteo OVD 4.0 - Migration OVD 3 to OVD 4_v1.0

1/28

ULTEO OPEN VIRTUAL DESKTOP

V4.0

MIGRATION GUIDE

28 February 2014


2/28

Ulteo Open V irtual Desktop v4.0

Migration Guide ULTEO SAS 2014 - 2

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


3/28



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


4/28



Section 1Introduction

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 usto define how to proceed.


5/28


6/28



Section 3Preparation

3.1Enter Maintenance Mode

In order to migrate to OVD V4, you will need to take the current system offline. First of all, stopthe services on each of the servers you have in your OVD farm and then switch the system to

maintenance mode.

OVDLINUX APPLICATION SERVER

root@server:~# /etc/init.d/ulteo-ovd-subsystem stop

OVDWINDOWS APPLICATION SERVER

Stop the Windows Service called Ulteo Open Virtual Desktop agent

OVDFILE SERVER


OVDGATEWAY

root@server:~# /etc/init.d/ulteo-ovd-slaveserver stop

OVDSESSION MANAGER

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

OVDWEB PORTAL

The Web Portal will be in maintenance mode once the OVD system has been set to maintenance

mode through the Admin Console.


7/28



3.2Backup 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.


8/28



Section 4Installing OVD V4

4.1Upgrade The Session Manager

Once you have completed the preparation and backup steps, you can proceed to install OVD V4starting with the Session Manager.

4.1.1Install 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.1Debian/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-session-manager ulteo-ovd-l10n

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

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


9/28



You should see lines that have the value 4.0.0.0as 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.2Centos/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.noarchulteo-ovd-l10n-4.0.0.0.XXX.noarch

ulteo-ovd-session-manager-4.0.0.0.XXX.noarch


10/28



4.1.1.3SUSE 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-session-manager ulteo-ovd-l10n




ulteo-ovd-administration-console-4.0.0.0.XXX.noarch

ulteo-ovd-l10n-4.0.0.0.XXX.noarch


4.1.1.4openSUSE 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-session-manager ulteo-ovd-l10n




11/28



You should see lines that have the va lue 4.0.0.0as in the example below.

ulteo-ovd-administration-console-4.0.0.0.XXX.noarch

ulteo-ovd-l10n-4.0.0.0.XXX.noarch


4.1.2Session 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), ADDUNIQUE 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 NOTNULL 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.


12/28



4.2OVD 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-clientulteo-ovd-web-client-ajaxplorer ulteo-ovd-applets ulteo-ovd-l10n




Add the new repository and save the file


13/28



[ovd-4.0.0]



enabled=1

gpgcheck=1


Install OVD 4.0

root@server:~# yum install ulteo-ovd-web-client ulteo-ovd-web-client-ajaxplorer ulteo-ovd-applets ulteo-ovd-l10n




Install OVD 4.0

root@server:~# zypper refresh && zypper install ulteo-ovd-web-clientulteo-ovd-web-client-ajaxplorer ulteo-ovd-applets ulteo-ovd-l10n




Install OVD 4.0

root@server:~# zypper refresh && zypper install ulteo-ovd-web-clientulteo-ovd-web-client-ajaxplorer ulteo-ovd-applets ulteo-ovd-l10n


14/28



4.2.2Modify 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 andpassword. 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'); // alternativemethod 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


15/28



// 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); // default

// define('RDP_PROVIDER_JAVA_INSTALLED', false);

This completes the update of the Web Portal.


16/28



4.3OVD Windows Application Server

To upgrade a Windows Application Server, run the new installer on your Application Server. You

can download the installer athttp://www.ulteo.com/main/downloads/ulteo-ovd-

win.php?suite=4.0.0.

The installation process will prompt the user to restart the server which should be done to

activate OVD 4.
http://www.ulteo.com/main/downloads/ulteo-ovd-win.php?suite=4.0.0http://www.ulteo.com/main/downloads/ulteo-ovd-win.php?suite=4.0.0http://www.ulteo.com/main/downloads/ulteo-ovd-win.php?suite=4.0.0http://www.ulteo.com/main/downloads/ulteo-ovd-win.php?suite=4.0.0http://www.ulteo.com/main/downloads/ulteo-ovd-win.php?suite=4.0.0


17/28



4.4OVD 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.1Update 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-desktopulteo-ovd-slaveserver ulteo-ovd-slaveserver-role-aps uxda-server ulteo-ovd-externalapps-client ulteo-ovd-integrated-launcher ulteo-xfce4-restricted-menu-plugin libovd-xclient-area


18/28



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 notinstalled 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.2Install 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


19/28







[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


20/28






Install OVD 4


4.4.3Restarting 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


21/28



4.5OVD 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.1Update 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}" >> $LOG2>&1

continued ..


22/28



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>&1echo "${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>&1fi

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 ">> $LOG2>&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


23/28



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-ovd-slaveserver ulteo-ovd-slaveserver-role-fs


24/28



4.5.2Install 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


25/28







[ovd-4.0.0]



enabled=1

gpgcheck=1



root@server:~# yum install ulteo-ovd-subsystem




Install OVD 4.0



26/28






Install OVD 4.0


4.5.3Restarting 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


27/28



4.6OVD 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.1Update 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-slaveserverulteo-ovd-slaveserver-role-gateway

Restart the Gateway service.

root@server:~# /etc/init.d ulteo-ovd-slaveserver start


28/28


4.7Production Mode

The migration is complete. Switch the system to production mode.

If you meet issues, please send us an email at [email protected] and add in subject

[MIGRATION ISSUES]

Date post:	02-Jun-2018
Category:	Documents
Upload:	unicycle1234
View:	226 times
Download:	0 times