ULTEO OPEN VIRTUAL DESKTOP V4.0.2 OPENSUSE 11.3 SUPPORT
Contents 1 Prerequisites: opensuse 11.3 3 1.1 System Requirements.............................. 3 2 Repository 4 2.1 Online Method.................................. 4 3 Session Manager Installation and Configuration 5 3.1 Installing MySQL................................. 5 3.2 Package Installation............................... 5 3.2.1 Configuration............................... 6 3.2.2 Setting Up the Subsystem Archive................... 8 3.2.3 PHP Settings................................ 8 4 Installing the Application Server and File Server (using Subsystem) 9 4.1 Setting a Redirection Name........................... 10 5 Installing a Web Portal (eg web.test.demo) 12 6 Application Server installation (native method) 14 ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-1
The purpose of this document is to describe how the different server roles of Ulteo OVD can be installed on opensuse 11.3 system. ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-2
Section 1 Prerequisites: opensuse 11.3 opensuse 11.3 can be downloaded here. All operation have to be done as super user (root). 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 and 2 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 and 2 CPU cores For a Web Portal: Evaluations/POCs: Minimum prerequisites are 1 CPU core and 512MB RAM Production envrionments: Ulteo recommends 1GB RAM whenever possible or more For using the same physical machine to host the Session Manager, the Web Portal and the Linux Application Server: Evaluations/POCs: Minimum prerequisites are 1 CPU core and 1GB RAM Production environments: Please note, Ulteo does not recommend using this installation method for production environments 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. ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-3
Section 2 Repository opensuse 11.3 uses the RPM packaging system. An Internet connection that provides HTTP access is required on your opensuse 11.3 system and add an Ulteo RPM repository into your system. 2.1 Online Method The following method describes the repository process when your servers have access to the Internet. Add the OVD repository: # zypper ar http :// archive. ulteo.com/ovd /4.0/ opensuse /11.3 OVD Install the keyring package to validate the repository using gpg: # rpm -- import http :// archive. ulteo.com/ovd /4.0/ opensuse /11.3/ keyring Completing the Installation Process Update the package database: # zypper refresh ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-4
Section 3 Session Manager Installation and Configuration The Session Manager is a LAMP (Linux Apache MySQL PHP) system and can be used on an exising LAMP server. 3.1 Installing MySQL The Session Manager needs access to a MySQL database. We advise you to setup the MySQL server on the same machine as the Session Manager to minimize access time. Install the mysql package: # zypper install mysql To start automatically MySQL when the system boots up # chkconfig mysql on Start the service # service mysql start Define the root mysql password # mysqladmin -u root password mysql_ root_ password 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: # zypper install ulteo - ovd - session - manager ulteo - ovd - administration - console Launch the configuration tool # sm - config Admin login : admin Password : Retype password : Chroot download url [ http :// archive. ulteo.com/ovd /4.0.2/ subsystem / base. tar.gz ]: Chroot destination [/ var/cache / ulteo / sessionmanager / base.tar.gz ]: Options : * chroot download : yes * chroot URI: http :// archive. ulteo.com/ovd /4.0.2/ subsystem / base. tar.gz ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-5
* chroot directory : / var / cache / ulteo / sessionmanager / base.tar.gz Is this correct? [ Y/ n] If you don t have access to Internet, please use the following command instead of the previous one: # sm - config --no - download Then, please read this to manually get the subsystem archive. Launch the Administration Console configuration tool # ovd - administration - console - config Session Manager address [ 127. 0. 0. 1]: Configure and start apache service # chkconfig apache2 on # service apache2 restart 3.2.1 Configuration The first step is to go to http://sm.test.demo/ovd/admin and authenticate yourself with the login and password you provided during installation. ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-6
The first time you log in, the system detects that it is not configured so you are redirected to a basic setup page which will save a default configuration. You have to set the MySQL configuration. For example, if you install MySQL on the same host as described previously, you would use the follwing configuration: Then, modifications are validated. ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-7
3.2.2 Setting Up the Subsystem Archive If you didn t specify a URL when initailly prompted, you have to manually copy a subsystem archive into /var/cache/ulteo/sessionmanager/base.tar.gz. Retrieve the base.tar.gz archive from the Ulteo website and copy it into the /var/- cache/ulteo/sessionmanager/ folder of your machine. 3.2.3 PHP Settings You have to set the timezone setting located in the php configuration file. Edit the php configuration file # vi /etc / php. ini Change the setting with your own value (values can be found here http://php.net/- manual/en/timezones.php) date. timezone = Europe / Paris Restart the Apache server # service httpd restart ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-8
Section 4 Installing the Application Server and File Server (using Subsystem) Install the package ulteo-ovd-subsystem: # zypper install ulteo - ovd - subsystem Due to a conflict, you may have to uninstall samba packages before installing the ulteo-ovd-session-manager package. Remove the samba client and server packages: # zypper remove samba * Launch the configuration tool # ovd - subsystem - config Session Manager address : sm. test. demo Chroot destination [/ opt/ ulteo ]: If you are going to install an Application Server on the same machine as your Session Manager, it is recommended to use 127.0.0.1 as the host. Configure and start the Ulteo service # chkconfig ulteo - ovd - subsystem on # service ulteo - ovd - subsystem restart Your server should appear in the Unregistered server page. ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-9
4.1 Setting a Redirection Name The server redirection name is optional. If all your machines are in the same network, you don t have to change it. If you have installed your Application Server on the same machine as your Session Manager and you have followed our advice, you have set 127.0.0.1 as the server name so you must define a redirection name. The redirection name is used when launching sessions. When you launch a session, you are redirected to an Application Server using the redirection name as target host. In some cases the default redirection name is not valid. For instance, if you set up a private IP address and you want to connect to your Application Server from the internet. ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-10
ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-11
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 was on previous versions (version number < 3.0). So you have to install it manually on any server you want. It is, of course, possible to install it on the same machine as the Session Manager. In this example, we are using web.test.demo as the Web Portal address Install the packages ulteo-ovd-web-client and ulteo-ovd-web-client-ajaxplorer: # zypper install ulteo -ovd -web - client ulteo -ovd -web -client - ajaxplorer ulteo - ovd - guacamole The HTML5 client is enabled by installing ulteo-ovd-guacamole package. By default, it s based on using Tomcat 6 server Launch the configuration tool # ovd - webclient - config Do you want to link the Web Portal to a specific Session Manager? ([ yes ]/ no): Session Manager address [127.0.0.1]: sm. test. demo Configure and start apache service # chkconfig apache2 on # service apache2 restart Configure and start tomcat 6 service # chkconfig tomcat6 on # service tomcat6 restart Configure and start guacd service # chkconfig guacd on # service guacd restart ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-12
Using you web browser, go to http://web.test.demo/ovd/, you should see a login page: ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-13
Section 6 Application Server installation (native method) Install a desktop environment into your server if there is none yet: # zypper install xfce4 - desktop xfce4 - settings Install some useful graphical applications : # zypper install gimp libreoffice Install the package ulteo-ovd-slaveserver-role-aps: # zypper install ulteo - ovd - slaveserver - role - aps Launch the configuration tool # ovd - slaveserver - config Session Manager address [127.0.0.1]: sm. test. demo Restart the service # chkconfig ulteo - ovd - slaveserver on # service ulteo - ovd - slaveserver stop ULTEO SAS - HTTP://WWW.ULTEO.COM 2014-14