Alcatel-Lucent OmniPCX Enterprise Free Desktop High Availability Free Desktop HA version 3.0.1 – Linux Installation Guide

Professional Services is mandatory for HA integration Please contact [email protected]

Alcatel-Lucent Services for Enterprise All Rights Reserved © Alcatel-Lucent 2008

Legal notice Alcatel, Lucent, Alcatel-Lucent and the Alcatel-Lucent logo are trademarks of AlcatelLucent. All other trademarks are the property of their respective owners. The information presented is subject to change without notice. Alcatel-Lucent assumes no responsibility for inaccuracies contained herein. COPYRIGHT © 2008 ALCATEL-LUCENT. ALL RIGHTS RESERVED.

All Rights Reserved © Alcatel-Lucent 2008

Page 2

TABLE OF CONTENT

1

INTRODUCTION ............................................................................5

1.1

Intended Readership.............................................................................................................................5

1.2

Applicability Statement .......................................................................................................................5

1.3

Purpose ....................................................................................................................................................5

1.4

Scope ........................................................................................................................................................5

1.5

Application Overview ...........................................................................................................................6

1.6

How to use this document...................................................................................................................6

1.7

Copyrights ...............................................................................................................................................7

1.8

Customer Support..................................................................................................................................7

2

OVERVIEW....................................................................................8

2.1

Principle...................................................................................................................................................8

2.2

This Manual .............................................................................................................................................8

2.3

Architecture ...........................................................................................................................................8

3

ENVIRONMENT ........................................................................... 10

4

CONTENTS OF CD ROM .............................................................. 11

5

COPYRIGHTS .............................................................................. 12

6

FREE DESKTOP HIGH AVAILABILITY ....................................................... 13

6.1

Free Desktop High Availability Prerequisites ...............................................................................13

7

FREE DESKTOP

7.1

Checks before Installation.................................................................................................................14

HIGH AVAILABILITY

INSTALLATION.......................... 14

7.2 Free Desktop High Availability Installation ...................................................................................16 7.2.1 Installation on the active server ................................................................................................16 7.2.2 Installation on the passive server ..............................................................................................16 All Rights Reserved © Alcatel-Lucent 2008

Page 3

7.2.3 7.2.4

Installation trace...........................................................................................................................17 Restarting the cluster ..................................................................................................................17

8

INSTALLATION CHECKS .............................................................. 18

8.1

“Alcatel” Cluster Test ........................................................................................................................18

8.2

FreeDesktop service Test ..................................................................................................................19

8.3

Active server failure Test..................................................................................................................19

8.4

Active server reboot Test..................................................................................................................21

9

UNINSTALLING ........................................................................... 23

9.1

Free Desktop Environment Uninstalling ........................................................................................23

10 APPENDIX................................................................................... 26 10.1

Table of Figures ...............................................................................................................................26

All Rights Reserved © Alcatel-Lucent 2008

Page 4

1 Introduction 1.1 Intended Readership This manual targets System Administrator who also does networking. This is not relevant to the user of this application

1.2 Applicability Statement This manual applies to installation and configuration of the application: Free Desktop High Availability version 3.0.1 and its related software in multiple servers and clients. This does not cover actual use of this application.

1.3 Purpose This guide explains: • • • •

The hardware and software environment that the installation of this application requires. The method of installing Free Desktop High Availability version 3.0.1. Configuration of Free Desktop High Availability version 3.0.1. Configuration of related software.

This manual targets at the System Administrator, and provides him with all necessary information to complete the above tasks.

1.4 Scope This manual covers •

Hardware requirements

•

Software requirements

•

Method of installing Free Desktop High Availability version 3.0.1

•

Method of configuring Free Desktop High Availability version 3.0.1

•

Checking if the installation is done all right

•

Uninstalling the Free Desktop High Availability version 3.0.1

All Rights Reserved © Alcatel-Lucent 2008

Page 5

1.5 Application Overview In case of a server failure, thanks to Active/Passive servers configuration, the application is started on the redundant server. You will have to install the application Free Desktop High Availability in 2 servers : • •

Active server (main) Passive server (slave)

Free Desktop High Availability must be installed in the XML Server where Free Desktop Environment is installed (mono server). It doesn’t work in separate server mode.

1.6 How to use this document This manual explains the complete installation process in sequence. So, a sequential reading of this manual and executing the given tasks could make the task easy. The installation process is conveniently explained under following heads: • • • • • • • •

Overview Environment Contents of CD Rom Preparing For Installation Free Desktop High Availability Installation Installation Checks Configuration Uninstalling

The above categorization could help you to use this manual for quick reference – you can get what you want, more easily. You can access the required part of this manual by using the Table of Contents given at the beginning of this manual. The entries in this list are hyper-linked. User Ctrl+Click on the line to move to that part of the manual. For layouts, diagrams are provided. As much as possible and based on relevance, screenshots are provided at appropriate places for you to visualize the process. As required, some screenshots are provided with brief explanation in the screen itself. If you prefer to access different parts of this manual based on screenshots, then you can use the Table of Figures given at the end of this manual. The entries given there are hyper-linked to move you to the screenshot, on which you can Ctrl+Click.

All Rights Reserved © Alcatel-Lucent 2008

Page 6

1.7 Copyrights This product is based on software developed by Microsoft. Copyright (C). All rights reserved. This document gives product names, which can be trademarks, all of them recognized as such.

1.8 Customer Support Please contact your system administrator or Alcatel-Lucent Business Partner for support

All Rights Reserved © Alcatel-Lucent 2008

Page 7

2 Overview 2.1 Principle High availability is the ability of the system to perform its function continuously for a significantly longer period time than the reliabilities of its individual components would suggest. So in case of a server failure, Free Desktop Environment is started on the passive server with data redundancy. For the end user, there is a service disruption of a few minutes, the service continuity is not guaranteed during this laps of time. The service is regained by logging again into the application.

2.2 This Manual This document is an installation guide. It describes the minimum procedures required to install the Alcatel Free Desktop High Availability (FDHA) software. Further information is provided in the Readme.txt and ReleaseNotes.txt files, available at the root and under each component's sub-directories of the Free Desktop High Availability CDROM.

2.3 Architecture The cluster manager monitors the server through a heartbeat. In case of server fails, the service is started on the Passive server, which becomes now Active.

Heartbeat

Active server Linux

Passive server Linux

FIGURE 1 - High Availability 1+1 configuration

All Rights Reserved © Alcatel-Lucent 2008

Page 8

Below is a sample architecture for the Free Desktop High Availability :

Active Free Desktop Server & UC/XML API Server

Heartbeat

UC / XML API 5.1 only !

Passive HA server running on Linux

1 to 15

OXE R9

OXE R9

1 to 2 500

IP Touch FIGURE 2 - Free Desktop High Availability architecture

All Rights Reserved © Alcatel-Lucent 2008

Page 9

3 Environment Installation of Free Desktop High Availability requires specific hardware and software. These extend from main servers to the terminals of users. The following table gives a consolidated list of those requirements Operating systems Alcatel XML API Framework High Availability or Alcatel Unified Communication (UC) High Availability

Presentation Server (PRS)

Alcatel XML API Framework or Alcatel Unified Communication (UC)

Red Hat Linux Enterprise 4.0 Update 5

Release 5.1

Since 1.1 (Only with IP-Touch Interface) XML API Release 5.1 and higher or corresponding UC, with FREEDESKTOP license enabled. Requires My IP-Touch XML Basic Services 10 ext. pack (depending on the total amount of IPTouch sets - only for IP-Touch Interface)

Free Desktop Environment

Release 3.0.1

Free Desktop High Availability

Release 3.0.1

All Rights Reserved © Alcatel-Lucent 2008

Page 10

4 Contents of CD ROM Free Desktop Environment Installation Pack come to you with a CD for installation purposes. Its contents are: I. Free Desktop Environment for Linux OS : a. Free Desktop Environment installer b. Free Desktop High Availability installer II. Free Desktop Environment for Windows OS : III. External Applications a. Java 2 Software Development Kit (1.5.0_10) b. Application Server (Tomcat 5.0.28) IV. Guides a. This installation guide b. Other guides V. README.txt file.

All Rights Reserved © Alcatel-Lucent 2008

Page 11

5 Copyrights This product includes software developed by Apache Software. Foundation: http://www/apache.org/ Copyright (C) 1995-2000 University College London. All rights reserved. Expat: Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd and Clark Cooper Other product and company names mentioned herein may be the trademarks of their respective owners.

All Rights Reserved © Alcatel-Lucent 2008

Page 12

6 Free Desktop High Availability 6.1 Free Desktop High Availability Prerequisites

Professional Services is mandatory for HA integration Please contact [email protected]

Both servers require that you install sequentially : 1.

Red Hat Linux Enterprise 4.0 Update 5 has to be installed using AlcatelLucent boot CD in order to have 6 LVM (Linux Virtual Machines) partitions created for data redundancy.

2.

XML UC Framework R5.1

3.

XML UC High Availability Framework R5.1

4.

Free Desktop Environment R3.0.1

Please refer to XML UC High Availability deployment guide and Free Desktop Environment V3.0.1 Linux Installation Guide for installation. Active Server :

Passive Server :

Real IP : 172.27.134.142 Real FQDN : fde-vmrh4otuc1.proserv.alcatel.com Virtual FQDN : fde-vmotucha.proserv.alcatel.com Virtual IP : 172.27.134.220

Real IP : 172.27.134.143 Real FQDN : fde-vmrh4otuc2.proserv.alcatel.com Virtual FQDN : fde-vmotucha.proserv.alcatel.com Virtual IP : 172.27.134.220

XML UC + XML UC HA + Free Desktop Environment configured

XML UC + XML UC HA + Free Desktop Environment configured

Clients request the virtual address

All Rights Reserved © Alcatel-Lucent 2008

Page 13

OXE

IP Touch Web Client

FIGURE 3 - Sample Architecture before installing

7 Free Desktop High Availability Installation Goals:

This section describes how to install Free Desktop High Availability

Scenario: You are logged on both machines where Free Desktop High Availability is to be installed. All the prerequisites are satisfied. Outcome: servers

The Free Desktop High Availability will be installed on active and passive

Time:

About 5 minutes (20 minutes if the cluster is started).

7.1 Checks before Installation Before starting the installation, verify the cluster state by using Cluster Configuration tool. In order to open it , under the terminal run the command : >system-config-cluster In the below screenshot, active and passive servers FQDN are displayed in the Cluster Nodes section. The virtual IP address is in the Resources section. The cluster name is “Alcatel”. In a local network, it is not allowed to have two clusters with the same name.

All Rights Reserved © Alcatel-Lucent 2008

Page 14

SCREENSHOT 4 - Cluster Configuration tab

To control the Cluster status (started/stopped), verify the “AS_primary” service line in the Cluster Management. The below screenshot confirms the “AS_primary” service is well started. Both servers are well initialized because they have the “Member” status.

All Rights Reserved © Alcatel-Lucent 2008

Page 15

SCREENSHOT 5 - Cluster Management tab

7.2 Free Desktop High Availability Installation 7.2.1 Installation on the active server 1. Insert the Free Desktop Environment CD-ROM. 2. Open the CD-ROM directory : Linux/FD_HA 3. To start the installation, run the install.sh file : >./install.sh Stopping the cluster and installing Free Desktop HA can take few minutes.

7.2.2 Installation on the passive server 1. Insert the Free Desktop Environment CD-ROM. 2. Open the CD-ROM directory : Linux/FD_HA 3. To start the installation, run the install.sh file : All Rights Reserved © Alcatel-Lucent 2008

Page 16

>./install.sh

7.2.3 Installation trace Below is the trace validating Free Desktop HA has been installed successfully. At this time of the installation process, the “Alcatel” cluster appears as stopped or failed on both servers.

SCREENSHOT 6 - Installation trace

7.2.4 Restarting the cluster After having installed Free Desktop High Availability on both servers, restart AS_primary service using : -

the “Restart” button in Cluster Configuration tool.

-

the terminal command : >clusvcadm –R AS_primary

Starting the cluster takes few minutes.

All Rights Reserved © Alcatel-Lucent 2008

Page 17

SCREENSHOT 7 - Restarting “Alcatel” cluster

8 Installation Checks 8.1 “Alcatel” Cluster Test Goal:

To test if the “Alcatel” cluster is well started after installation

Scenario:

Verify the “AS_primary” status under Cluster Configuration tool

Outcome:

You wil know if “Alcatel” cluster is running

Time:

1 minute

1. Open Cluster Configuration tool using the terminal : >system-config-cluster 2. Click on the Cluster Management tab 3. Verify that “AS_primary” state is started and that the active server appears as the Owner.

All Rights Reserved © Alcatel-Lucent 2008

Page 18

8.2 FreeDesktop service Test Goal:

To test if the Free Desktop is started.

Scenario: started

The cluster is started. Run the command to know If Free Desktop is

Outcome:

Free Desktop is started

Time:

1 minute.

1. Run this command in the terminal : >service freedesktop status 2. If the cluster is started, the result must be : Free Desktop is started

8.3 Active server failure Test Goal:

To test if Free Desktop is started on the redundant server

Scenario:

The cluster is started. Shutdown the active server.

Outcome:

Free Desktop is started on the passive server

Time:

About 10 minutes.

1. Run this command on the active server terminal : >shutdown –h now 2. After waiting few minutes, control the cluster state of passive server using the Cluster Configuration tool. First, the “AS_primary’ service appears sequentially as i. Stopping with the active server as owner ii. Starting on the passive server and the active server appears as Dead iii. Started with the passive server as owner

All Rights Reserved © Alcatel-Lucent 2008

Page 19

SCREENSHOT 8 -”AS_primary” service stopping on the active server

SCREENSHOT 9 - “AS_primary” service starting on the passive server

All Rights Reserved © Alcatel-Lucent 2008

Page 20

SCREENSHOT 10 - “AS_primary” service started on the passive server

3. Test the Free Desktop service using the linux terminal or your web browser connecting on the virtual address. The sample virtual address being 172.27.134.220,the Free Desktop Web Admin address is : http://172.27.134.220:7080/freedesktop/home.htm

8.4 Active server reboot Test Goal: the service

To test if Active Server reboots and becomes the member owner of

Scenario:

Reboot the active server

Outcome:

“AS_primary” service is well restarted on the active server

Time:

About 15 minutes.

1. Reboot the active server After rebooting, the active server appears as Member and is not Dead anymore. The cluster identifies this server as the previous owner. All Rights Reserved © Alcatel-Lucent 2008

Page 21

SCREENSHOT 11 - Cluster Management tab after active server reboot

2. Run the command to reinitialize the active server as the service owner >clusvcadm –r AS_primary –m fde-vmrh4otuc1.proserv.alcatel.com with AS_primary : the service name and fde-vmrh4otuc1.proserv.alcatel.com : the active server FQDN

All Rights Reserved © Alcatel-Lucent 2008

Page 22

SCREENSHOT 12 - Cluster Management tab after active server relocate

9 Uninstalling 9.1 Free Desktop Environment Uninstalling Goal:

To uninstall Free Desktop High Availability and Environment from your server.

Scenario: You do not want to use Free Desktop High Availability and Environment anymore. Outcome: Free Desktop High Availability and Environment will be removed from your computer. Time:

About 1 minute (10 min if the cluster is started)

1. Open the directory /opt/Alcatel/FreeDesktop/_uninstall: >cd /opt/Alcatel/FreeDesktop/_uninstall 2. Run the uninstaller uninstall.sh >./uninstall.sh All Rights Reserved © Alcatel-Lucent 2008

Page 23

Stopping the cluster and uninstalling Free Desktop HA and Environment can take few minutes. 3. A summary of removed components is displayed. This uninstaller removes all the Free Desktop components (Service, SNMP Agent Service, High Availability).

All Rights Reserved © Alcatel-Lucent 2008

Page 24

SCREENSHOT 13 - Free Desktop High Avaibality removal

As can see in the above srceenshot, to finalize the Free Desktop removal, FD directory must be deleted from the DRBD data managing after the cluster being restarted.

All Rights Reserved © Alcatel-Lucent 2008

Page 25

10 Appendix 10.1 Table of Figures

FIGURE 1 - HIGH AVAILABILITY 1+1 CONFIGURATION ................................................................8 FIGURE 2 - FREE DESKTOP HIGH AVAILABILITY ARCHITECTURE FIGURE 3 - SAMPLE ARCHITECTURE BEFORE INSTALLING

.......................................................9

.......................................................... 14

SCREENSHOT 1 - CLUSTER CONFIGURATION TAB ................................................................. SCREENSHOT 2 - CLUSTER M ANAGEMENT TAB

15

.................................................................. 16

SCREENSHOT 3 - INSTALLATION TRACE .........................................................................

17

SCREENSHOT 4 - RESTARTING “ALCATEL” CLUSTER ..............................................................

18

SCREENSHOT 5 -”AS_PRIMARY” SERVICE STOPPING ON THE ACTIVE SERVER ..........................................

20

SCREENSHOT 6 - “AS_PRIMARY” SERVICE STARTING ON THE PASSIVE SERVER

........................................ 20

SCREENSHOT 7 - “AS_PRIMARY” SERVICE STARTED ON THE PASSIVE SERVER ......................................... SCREENSHOT 8 - CLUSTER M ANAGEMENT TAB AFTER ACTIVE SERVER REBOOT

........................................ 22

SCREENSHOT 9 - CLUSTER M ANAGEMENT TAB AFTER ACTIVE SERVER RELOCATE

...................................... 23

SCREENSHOT 10 - FREE DESKTOP HIGH AVAIBALITY REMOVAL .....................................................

All Rights Reserved © Alcatel-Lucent 2008

21

25

Page 26

www.alcatel-lucent.com

All Rights Reserved © Alcatel-Lucent 2008

Page 27