INUVIKA OPEN VIRTUAL DESKTOP ENTERPRISE MIGRATION GUIDE Mathieu Schires Versin 1.0 Published 06/03/2015 This dcument describes the preparatin and steps t fllw t upgrade an OVD farm frm Inuvika OVD 0.9.x r OVD 4.0.2 t Inuvika OVD 1.0.0. www.inuvika.cm
TABLE OF CONTENTS 1. INTRODUCTION... 3 2. RELATED DOCUMENTATION... 3 3. PRE-REQUISITES... 3 4. OVERVIEW... 3 5. PREPARATION... 4 5.1 On Ubuntu... 4 5.2 RedHat Enterprise Server... 4 6. BACKUP EXISTING CONFIGURATION... 4 6.1 OVD Sessin Manager (OSM)... 4 6.1.1 Exprt prcess... 4 6.2 Linux OVD Applicatin Server (OAS)... 5 6.3 OVD File Server (OFS)... 6 6.4 OVD Gateway (OVD Enterprise Secure Gateway)... 7 6.5 OVD Web Access (OWA)... 8 7. PERFORM THE UPGRADE... 8 7.1 OSM... 8 7.2 OAS... 9 7.2.1 Windws... 9 7.2.2 Linux... 9 7.3 OFS... 10 7.4 Inuvika Enterprise Secure Gateway (ESG)... 12 7.5 OVD Web Access... 13 8. UPGRADE VERIFICATION... 13 Page 2
1. INTRODUCTION This dcument describes the preparatin and steps t fllw t upgrade an OVD farm frm Inuvika Enterprise OVD 0.9.x r Ulte OVD Premium Editin 4.0.2 t Inuvika OVD Enterprise 1.0.0. 2. RELATED DOCUMENTATION The Inuvika OVD Fundatin Server dcumentatin is made available fr dwnlad tgether with the sftware. Please refer t the dcumentatin available at http://dcs.inuvika.cm Installatin and Cnfiguratin Guide Enterprise Activatin Guide The fllwing OVD Enterprise dcumentatin is available at http://dcs.inuvika.cm Enterprise Secure Gateway Guide 3. PRE-REQUISITES The OVD Sessin Manager (OSM) must be set in Maintenance Mde by clicking n the Switch the system t maintenance mde buttn. Ensure that there are n active sessins befre cntinuing. An Inuvika Subscriptin Key is required fr Inuvika OVD Enterprise. D nt delete any data frm the current system until yu are sure that the upgrade is successful. Fllw the Pre-requisites n the Installatin and Cnfiguratin Guide. 4. OVERVIEW The high-level steps invlved are: 1. Prepare the new target system. Nte: If using Ubuntu, an Ubuntu Trusty system is required. 2. Backup existing cnfiguratin data 3. Upgrade t OVD 1.0 and imprt the existing cnfiguratin data Each f these steps is explained in detail in the fllwing sectins fr each type f server. Nte: Ubuntu is handled differently than RedHat/Cents. Page 3
5. PREPARATION 5.1 ON UBUNTU Inuvika OVD 1.0 des nt supprt Ubuntu Precise r Ubuntu Lucid. As a result, yu need t install and prepare an Ubuntu Trusty server and then fllw the nline dcumentatin t install Inuvika OVD 1.0.0. 5.2 REDHAT ENTERPRISE SERVER Inuvika OVD 1.0.0 supprts RHEL 6.x and 7.x as well as Cents 6.x and 7.x. 6. BACKUP EXISTING CONFIGURATION 6.1 OVD SESSION MANAGER (OSM) G t the OVD Administratin Cnsle (OAC) t check that the system is in Maintenance Mde and n sessins remain active. 6.1.1 EXPORT PROCESS 6.1.1.1 ON UBUNTU Since Inuvika OVD 1.0 des nt supprt Ubuntu Lucid and Ubuntu Precise, the first part f the upgrade prcess will cnsist f making a backup f the existing OSM cnfiguratin. Please cpy the Pythn script prvided with this dcumentatin t a lcatin f yur chice. Change the permissins t make the script executable # sud chmd u+x upgrade_tl.py Install the fllwing package # sud apt-get install pythn-setuptls # sud easy_install argparse Run the fllwing cmmand t exprt all the cnfiguratin data Page 4
# sud./upgrade_tl.py exprt An archive file vd_exprt.tar.gz has been created. Keep this file in a secure place. 6.1.1.2 ON RHEL/CENTOS 6 Lgin as rt # su Change the permissins t make the script executable # chmd u+x upgrade_tl.py Install the fllwing package # yum install rsync # yum install pythn-setuptls # easy_install argparse Run the fllwing cmmand t exprt all the cnfiguratin data #./upgrade_tl.py exprt 6.2 LINUX OVD APPLICATION SERVER (OAS) This step is required fr Linux applicatin servers nly. If upgrading frm either Ulte OVD 4.0.2 r Inuvika OVD 0.9.x, the OVD Subsystem will nt exist n the new target system. In this case, the update cnsists f making a backup f the cnfiguratin files and then re-installing the applicatins n the target OVD 1.0 system. Please fllw the steps belw fr each OAS server available n the OVD farm. G t the OVD Subsytem Page 5
# sud uchrt Create an archive f the cnfiguratin directry On Ulte OVD 4.0.2 # tar -czf ultecnf.tar.gz /etc/ulte On Inuvika OVD 0.9.x # tar -czf vdcnf.tar.gz /etc/vd Save the archive file in a secure place fr later use. 6.3 OVD FILE SERVER (OFS) As was the case fr the OAS, OVD V1.0.0 OFS des nt use an OVD Subsystem. If prfile data is stred n the OFS, it must be cpied t a secure place fr later use. The fllwing steps are the same fr Ubuntu and Cents/RedHat. G t the OVD Subsytem # sud uchrt Create an archive f the cnfiguratin directry On Ulte OVD 4.0.2 # tar -czf ultecnf.tar.gz /etc/ulte On Inuvika OVD 0.9.x Page 6
# tar -czf vdcnf.tar.gz /etc/vd Stp the OVD service # /etc/init.d/ulte-vd-slaveserver stp Create an archive f user prfiles On Ulte OVD 4.0.2 # tar -czf prfiles.tar.gz /var/lib/ulte On Inuvika OVD 0.9.x # tar -czf prfiles.tar.gz /var/lib/vd Keep the tw archives files in a secure place fr later use. 6.4 OVD GATEWAY (OVD ENTERPRISE SECURE GATEWAY) On the OVD Gateway, yu need t make a backup f yur private certificate and the cnfiguratin. Create an archive f the cnfiguratin directry On Ulte OVD 4.0.2 # tar -czf ultecnf.tar.gz /etc/ulte On Inuvika OVD 0.9.x Page 7
# tar -czf vdcnf.tar.gz /etc/vd Keep the archive file in a secure place fr later use. 6.5 OVD WEB ACCESS (OWA) The migratin frm OWA n OVD 0.9.x, named Web Client with Ulte OVD 4.0.2, requires that tw cnfiguratin files are saved: cnfig.inc.php cnfig.client.ini The flder where thse files are lcated is On Ulte OVD 4.0.2 /etc/ulte/webclient/ On OVD 9.x /etc/vd/web-access/ Cpy thse tw files frm the crrespnding flder t a secure place fr later use. 7. PERFORM THE UPGRADE 7.1 OSM Inuvika supprts OSM 1.0.0 n Ubuntu Trusty and RHEL/Cents 6 and RHEL/Cents 7 The first step is t install MySQL Server. Please fllw the Installing MySQL instructins related t the perating system in use in the Installatin and Cnfiguratin Guide. Once the database has been created, imprt the backup cnfiguratin data that was previusly saved frm the OSM. Cpy the archive file and the tl upgrade_tl.py t the target system Change the permissins t make the script executable # sud chmd u+x upgrade_tl.py Page 8
Run the fllwing cmmand t imprt all the cnfiguratin data #./upgrade_tl.py imprt The script will prmpt fr sme infrmatin that needs t be entered. Enter the lgin and passwrd fr yur MySQL server and enter vd fr the database and table prefix. MySQL base: vd MySQL lgin: rt MySQL passwrd: rt MySQL table prefix: vd_ Cmplete the installatin by fllwing the Package Installatin sectin fr OSM in the Installatin and Cnfiguratin Guide. The OSM needs t be upgraded t OVD Enterprise by fllwing the Enterprise Activatin Guide. Nte: An Ulte subscriptin key will nt functin with Inuvika OVD Enterprise 7.2 OAS First make sure that the new OAS servers are cnfigured with the same IP address and/r DNS as the previus OAS servers. This is imprtant fr matching the settings stred in the OSM database. 7.2.1 WINDOWS On the Windws applicatin server, the nly upgrade required is t install the new OAS installer that is available frm http://archive.inuvika.cm/vd/1.0 7.2.2 LINUX If upgrading frm either Ulte OVD 4.0.2 r Inuvika OVD 0.9.x, the OVD Subsystem will nt exist n the new target system. One f the supprted perating systems must be installed n the Linux applicatin servers and the applicatins that were installed n the previus OVD farm must be installed n the new OAS server. Page 9
Cpy the saved archive file t the /tmp directry f the crrespnding new OAS server and extract the files. Fr an Ulte OVD 4.0.2 archive # tar -xzf ultecnf.tar.gz Fr an Inuvika OVD 0.9.x archive # tar -xzf vdcnf.tar.gz Rename the directry if the archive was fr OVD 4.0.2 # mv etc/ulte etc/vd # mv etc/vd/vd etc/vd/slaveserver Mve the directry t the crrect place # cp -R etc/vd /etc Cmplete the installatin by fllwing the installatin instructins fr an OAS in the Installatin and Cnfiguratin Guide. If yu are using an OFS server, when the IP address is requested, use 0.0.0.0. The crrect IP address will be added nce the OFS installatin has been cmpleted. When a prmpt t cnfirm the replacement f the cnfiguratin files appears, answer Yes. When cmplete, the server shuld be listed in the Servers page in the OVD Administratin Cnsle with an nline status. 7.3 OFS First make sure that the new OFS server is cnfigured with the same IP address and/r DNS as the previus OFS server. This is imprtant fr matching the settings stred in the OSM database. Page 10
If upgrading frm either Ulte OVD 4.0.2 r Inuvika OVD 0.9.x, the OVD Subsystem will nt exist n the new target system. One f the supprted perating systems must be installed n the Linux applicatin servers. Cpy the saved cnfiguratin data archive file t the /tmp directry f the new OFS server and extract the files. Fr an Ulte OVD 4.0.2 archive # tar -xzf ultecnf.tar.gz Fr an Inuvika OVD 0.9.x archive # tar -xzf vdcnf.tar.gz Rename the directry if the archive was fr OVD 4.0.2 # mv etc/ulte etc/vd # mv etc/vd/vd etc/vd/slaveserver Mve the directry t the crrect place # cp -R etc/vd /etc Cpy the saved user prfile archive file t the /tmp directry f the new OFS server and extract the files. # tar -xzf prfiles.tar.gz Rename the directry if the archive was fr OVD 4.0.2 # mv var/lib/ulte/vd/ var/lib/ # rm -r var/lib/ulte Page 11
Mve the directry t the crrect place # cp -R var/lib/vd /var/lib Cmplete the installatin by fllwing the installatin instructins fr an OFS in the Installatin and Cnfiguratin Guide. When a prmpt t cnfirm the replacement f the cnfiguratin files appears, answer Yes. When cmplete, the server shuld be listed in the Servers page in the OVD Administratin Cnsle with an nline status. 7.4 INUVIKA ENTERPRISE SECURE GATEWAY (ESG) First make sure that the new ESG server is cnfigured with the same IP address and/r DNS as the previus OVD Gateway/ESG server. This is imprtant fr matching the settings stred in the OSM database. One f the supprted perating systems must be installed n the Linux applicatin servers. Cpy the saved archive file t the /tmp directry f the new OFS server and extract the files. Fr an Ulte OVD 4.0.2 archive # tar -xzf ultecnf.tar.gz Fr an Inuvika OVD 0.9.x archive # tar -xzf vdcnf.tar.gz Rename the directry if the archive was fr OVD 4.0.2 # mv etc/ulte/vd/ etc/vd Page 12
Mve the directry t the crrect place # cp -R etc/vd /etc Cmplete the installatin by fllwing the installatin instructins in the Enterprise Secure Gateway Guide. When cmplete, the server shuld be listed in the Servers page in the OVD Administratin Cnsle with an nline status. 7.5 OVD WEB ACCESS Perfrm the installatin by fllwing the installatin instructins fr an OWA in the Installatin and Cnfiguratin Guide. Once the installatin is cmplete, cpy the saved cnfiguratin file t the /etc/vd/web-access flder. cnfig.client.ini Edit the cnfig.inc.php file in the /etc/vd/web-access flder t apply the settings frm the previusly saved cnfig.ini.php file. 8. UPGRADE VERIFICATION The upgrade is nw cmplete. G t the OVD Administratin Cnsle and check the servers, users, applicatins and publicatins. T check the publicatins, brwse t the Status page and select the Summary tab. Switch the system int Prductin mde. If sme applicatins are missing, a test t run a sessin can be perfrmed by setting the User can launch a sessin even if sme f his published applicatins are nt available ptin t yes. If ne r mre applicatins are missing, g t the Applicatins page and click n the Remve rphan applicatins buttn. Test the upgrade by running a number f different user sessins and checking the main lg fr any errrs. Page 13