Alcatel-Lucent OmniPCX Enterprise Free Desktop Free Desktop version 3.0.1 – Linux Installation Guide
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 ............................................................................6
1.1
Intended Readership.............................................................................................................................6
1.2
Applicability Statement .......................................................................................................................6
1.3
Purpose ....................................................................................................................................................6
1.4
Scope ........................................................................................................................................................6
1.5
Application Overview ...........................................................................................................................7
1.6
How to use this document...................................................................................................................7
1.7
Copyrights ...............................................................................................................................................8
1.8
Related Documents ...............................................................................................................................8
1.9
Licensing..................................................................................................................................................8
1.10
Customer Support..............................................................................................................................8
2
OVERVIEW....................................................................................9
2.1
The Application......................................................................................................................................9
2.2
This Manual .............................................................................................................................................9
2.3
Architecture ...........................................................................................................................................9
3
ENVIRONMENT ........................................................................... 12
4
CONTENTS OF CD ROM .............................................................. 13
5
COPYRIGHTS .............................................................................. 14
6
PREPARING FOR INSTALLATION ................................................. 15
6.1
Compatibility Requirement for Inter-terminal Movement ........................................................15
6.2
Multi-Call Server configuration ........................................................................................................17
6.3 Interaction with Other Features......................................................................................................17 6.3.1 Functional compatibilities: .........................................................................................................17 All Rights Reserved © Alcatel-Lucent 2008
Page 3
6.3.2 6.3.3
Free Desktop and OmniTouch Unified Communication/4980................................................18 Alcatel–Lucent 8&9 Series Sets and Additional Key Modules.................................................18
7
RECOMMENDED FREE DESKTOP ENVIRONMENT INSTALLATION . 19
8
OMNIPCX ENTERPRISE CONFIGURATION .................................... 20
8.1
General OmniPCX Enterprise Configuration..................................................................................20
9
ALACTEL XML API OR UC INSTALLATION ................................... 21
10 NETWORK ARCHITECTURE OVERVIEW ....................................... 22 10.1
Network Architecture.....................................................................................................................22
10.2
Testing your Network Architecture ............................................................................................22
10.3
Free Desktop Server Prerequisites .............................................................................................23
11 FREE DESKTOP ENVIRONMENT INSTALLATION........................... 24 11.1
Free Desktop Environment Installation......................................................................................24
12 INSTALLATION CHECKS .............................................................. 26 12.1
Free Desktop Service Test.............................................................................................................26
12.2
FreeDesktop Web Admin Test ......................................................................................................26
12.3
FreeDesktop Web Interface Test .................................................................................................27
12.4
IP Touch Interface Setup Test ......................................................................................................28
12.5
Free Desktop SNMP Agent Service Test .....................................................................................30
13 CONFIGURATION ........................................................................ 31 13.1
Presentation Server Configuration..............................................................................................31
13.2
OmniPCX Enterprise Configuration for Free Desktop Interface...........................................35
14 UNINSTALLING ........................................................................... 37 14.1
Free Desktop Environment Uninstalling.....................................................................................37
14.2
Complete Free Desktop IP-Touch Interface Uninstalling .......................................................38
All Rights Reserved © Alcatel-Lucent 2008
Page 4
15 APPENDIX................................................................................... 41 15.1
Table of Figures ...............................................................................................................................41
All Rights Reserved © Alcatel-Lucent 2008
Page 5
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 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 Environment version 3.0.1. The method of installing related software on other servers. Configuration of Free Desktop Environment 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 Environment version 3.0.1
•
Method of configuring Free Desktop Environment version 3.0.1
•
Method of installing related software
•
Method of configuring related software
•
Checking if the installation is done all right
•
Uninstalling the Free Desktop Environment version 3.0.1
All Rights Reserved © Alcatel-Lucent 2008
Page 6
1.5 Application Overview You will have to install the application Free Desktop Environment : • in a separate server or • in the XML Server (mono server) If you install Free Desktop High Availability, Free Desktop Environment must be installed in the XML Server (mono server). Free Desktop Environment is supported by one or more OXE Server/s and XML Server/s. These supporting servers are installed with software that supports the Free Desktop Server. After installation, they should be configured as needed. The OXE servers are connected to different telephone terminals. The Free Desktop Server enables movement of users among different terminals within the network. When one user moves to another terminal, he can use that terminal as his own – his incoming calls would land up in this new terminal. To enable this mobility, the telephone terminals will have to be in accordance with the specifications.
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 Recommended Free Desktop Environment Installation Network Architecture Overview Alcatel XML API or UC Installation OmniPCX Enterprise Configuration Free Desktop Environment 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
All Rights Reserved © Alcatel-Lucent 2008
Page 7
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.
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 Related Documents Free Desktop – Administration Guide Free Desktop - User Guide
1.9 Licensing Each Free Desktop Server 3.x required a FlexLM license: FREEDESKTOP version 1.0. Each Free Desktop User 3.x required a FlexLM license: FREEDESKTOPUSER version 1.0. IP Touch Mobile Solution required FlexLM licenses for all the IP Touch users: MY IP TOUCH BASIC SERVICES.
1.10 Customer Support Please contact your system administrator or Alcatel-Lucent Business Partner for support
All Rights Reserved © Alcatel-Lucent 2008
Page 8
2 Overview 2.1 The Application This application enables portability of phone terminals in a corporate network. User of one terminal can move to another terminal in the network. He can use this new terminal as his own, that it is initialized with his original number. Incoming calls to his original terminal will land up in this new terminal. In the new terminal, the user will have to use his original directory name, and his original number. In this manner, this application makes movement of personnel within the network, most convenient.
2.2 This Manual This document is an installation guide. It describes the minimum procedures required to install the Alcatel Free Desktop Environment (FDE) 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 Environment CDROM.
2.3 Architecture Below is a sample architecture for the Free Desktop:
FIGURE 1 - Free Desktop architecture
All Rights Reserved © Alcatel-Lucent 2008
Page 9
In the above layout, a user of one OXE server can move to a terminal under another OXE server. He can use it just like his earlier terminal. His incoming calls reach the new terminal, and not the old one.
FIGURE 2 - Sequence diagram : Logon-IP Touch Interface
All Rights Reserved © Alcatel-Lucent 2008
Page 10
FIGURE 3 - Fsequence diagram : Web Interface
Installing Free Desktop involves installation and configuration of the application in: 1. OXE Server/s 2. XML Server/s 3. Free Desktop Server
All Rights Reserved © Alcatel-Lucent 2008
Page 11
3 Environment Installation of Free Desktop application 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 Free Desktop Environment
Release 3.0.1
Operating systems
Red Hat Linux Enterprise 4.0 Update 5
OmniPCX Enterprise
Supported sets
Alcatel XML API Framework or Alcatel Unified Communication (UC)
Presentation Server (PRS)
All Rights Reserved © Alcatel-Lucent 2008
Version 8.0, 9.0 The Alarm lock (47) 4010, 4010 + TSC IP, 4020, 4022, 4035, 4037, 4008, 4018, 4019, 4028, 4029, 4038, 4039, 4068 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) Since 1.1 (Only with IP-Touch Interface)
Page 12
4 Contents of CD ROM Free Desktop Environment Installation Pack comes 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 13
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 14
6 Preparing for Installation 6.1 Compatibility Requirement for Inter-terminal Movement For moving purposes, the user can use either • • •
Free Desktop IP Touch Interface or Free Desktop Web Interface or Both
Free Desktop is available for users provided with following types of telephone sets: • •
8 & 9 series: 4008, 4018, 4019, 4028, 4029, 4038, 4039 and 4068, IP Desktop Softphone Reflexes/e-Reflexes: 4010, 4010 IP, 4020, 4022, 4035, 4037
The following table gives details of Application availability in telephone sets: Phone Types
Free Desktop IP Touch Interface
Free Desktop WEB Interface
4010
4010 IP
4020
4022
4035
4037
4018
4019
4028
4029
4038
4039
4068
FIGURE 4 - Application availability
All Rights Reserved © Alcatel-Lucent 2008
Page 15
Switching a telephone set for another is possible, provided phone sets are compatible. The following table shows the matrix of phone set compatibility.
FIGURE 5 - Phone set Compatibility
All Rights Reserved © Alcatel-Lucent 2008
Page 16
6.2 Multi-Call Server configuration If Free Desktop users are required to move among several nodes, then: •
Alcatel-Lucent strongly recommends having the same release and patching on each node
•
The inter-system diffusion mechanism must be activated
•
The dialing plan must be homogenous between the different nodes
•
The definition of Classes of Services, entities and discrimination must be compatible/homogeneous on each node
•
When users change node, their taxation tickets are generated and allocated to this new reporting node.
6.3 Interaction with Other Features 6.3.1 Functional compatibilities: This function of mobility is not available for: •
Sets which belong to a call centre group
•
Sets using additional key modules (except for key modules detailed: § Alcatel–Lucent 8&9 Series Sets and Additional Key Modules)
•
Sets which belong to a group of sets (available when user moves within the same Call Server)
•
Sets using a data , analog or S0 interface
•
Analog, DECT/PWT, Wifi or SIP sets
•
Sets using the twin-set feature (available when user moves within the same Call Server)
•
Sets configured on forwarding at night or general ringing
•
Sets which belong to an MLA (MultiLine Appearance) group
Free Desktop users cannot monitor other sets, or use or be used by applications based on CSTA, CTI and SIP protocols.
All Rights Reserved © Alcatel-Lucent 2008
Page 17
6.3.2 Free Desktop and OmniTouch Unified Communication/4980 o
Nomadic mode: This feature is not available when a Free Desktop user is logged off.
o
My Phone: No interaction when a user moves in a PBX network managed by a single XML API / UC. My Phone services are suspended when a user moves on a PBX that is not managed by his original XML API / UC. The user retrieves all My Phone services when he moves back on a PBX managed by his original XML API / UC.
o
My Assistant: Free Desktop detects if a user has activated My Assistant and does not modify the immediate forward on the routing point if there is one.
o
My Messaging & My Teamwork: No interaction.
6.3.3 Alcatel–Lucent 8&9 Series Sets and Additional Key Modules On 8&9 series sets, namely: 4028, 4029, 4038, 4039 and 4068, four types of additional key module(s) can be connected. The available additional key modules are: •
Additional module with 10 keys
•
Additional module with 20 keys
•
Additional module with 40 keys
•
Smart Display additional module with 14 keys The Smart Display additional module with 14 keys is not compatible with Free Desktop. With the 3 other additional modules, a Free Desktop user can log on another phone set but:
•
If the target phone set is equipped with an identical additional module, the user can use the target phone set as his/her own set
•
If the target phone set is not equipped with an additional module or if this additional module is different, additional keys are not available
•
When users log on their own phone set, they retrieve the use of their module additional keys
All Rights Reserved © Alcatel-Lucent 2008
Page 18
7 Recommended Free Desktop Environment installation The Free Desktop Environment standard offer consists of 1 installer for 2 applications : •
Free Desktop Environment (Server/Web Interface/IP Touch Interface) : service started automatically
•
Free Desktop SNMP Agent : service needing to be start manually by the administrator
Installation Process : The following figure explains the installation process. You will have to install and configure the software in the sequence given : OXE Server 1. Configure OXE XML Server (OS RHEL 4 Update 5) 2. Configure XML 3. Configure Presentation Server 4. Configure FlexLM Server 5. Configure XML Web Services Free Desktop Server (OS RHEL 4 Update 5) or Free Desktop in XML Server 6. Install Free Desktop components
All Rights Reserved © Alcatel-Lucent 2008
Page 19
8 OmniPCX Enterprise Configuration Goals:
To check if the OmniPCX Enterprise(s) is(are) correctly configured for the Free Desktop feature. To configure future Free Desktop users
Scenario:
You are connected to your OmniPCX Enterprise network. You know exactly: - Which users to configure - Their level of use (Free Desktop rights) - The number of temporary directory numbers on each nodes
Outcome:
The OmniPCX Enterprise will be ready for Free Desktop operations.
Time:
According to: - The number of nodes - The number of users
The OmniPCX Enterprise(s) configuration must be complete and all subscribers must be created and assigned to their set. Broadcast must be enabled (even when there is only one node).
8.1 General OmniPCX Enterprise Configuration The following checks must be performed for each node of your network. To check the broadcast is enabled: 1. Connect to the OmniPCX Enterprise using Telnet 2. Enter login and password 3. When prompted, enter mao -a 4. If on the first line you read BROADCAST is off, enter mao +br to enable broadcast. The prompt must read BROADCAST is on 5. The last line must read Synchronization 4400-47xx is on. If not: a. Access the OmniPCX Enterprise configuration tool b. Select System c. Review/modify the following attribute: 47xx directory - 4400 Synchro
Select True
d. Confirm your entries
All Rights Reserved © Alcatel-Lucent 2008
Page 20
9 Alactel XML API or UC Installation Goal:
To install and configure the API Framework for Free Desktop Web Admin for operation
Scenario:
Install or configure the API for Free Desktop use. This section of this document describes the recommended configuration
Outcome:
The Alcatel XML API Framework will be installed and configured for Free Desktop. The mandatory information to install Free Desktop will be listed.
Time:
According to your configuration
Please refer to the installation guide of the product you install. Free Desktop Web Admin uses the following components: • • •
Presentation Server (if you install the Free Desktop IP Touch Interface) FlexLM Server XML Web Services
To be able to move among several Call Servers, you have to configure the Open Telephony Server (OTS) for each Call Server created in the XML API. At Free Desktop purchase, the FREEDESKTOP license has been automatically generated in the Alcatel XML API or UC licenses. The Free Desktop Web Admin application checks this license via the FLEXlm Server installed with the Alcatel XML API or UC. The following parameters are requested at Free Desktop Server configuration:
FLEXlm server host
Hostname (or IP address) of the computer where the FLEXlm Server is installed.
FLEXlm server port
Port number. Generally 27000.
All Rights Reserved © Alcatel-Lucent 2008
Page 21
10 Network Architecture Overview Goal:
Prepare your network architecture in order to install Free Desktop
Scenario:
Before installing Free Desktop, you need to know whether your hardware installation is compatible with Free Desktop, and whether the requested components are correctly installed
Outcome:
You will be ready to start Free Desktop installation
Time:
According to your configuration
10.1 Network Architecture The Alcatel XML API Framework can run under Linux Red Hat 4.0 Update 5 Enterprise. The Free Desktop Server must run the same under Linux Red Hat 4.0 Update 5 Enterprise in this release. Please consult the readme.txt file on the Free Desktop Environment to find out about the last updates. XML API or UC. Components used : •
FlexLM Server
•
Presentation Server
•
XML Web Services
With separate server, XML API or UC server and Free Desktop server must be able to communicate through their hostname.
10.2 Testing your Network Architecture Check all connections and more particularly connections between: -
The Free Desktop Server machine and: •
The FLEXlm Server (through hostnames)
•
The OmniPCX Enterprise network (recommended)
•
The Presentation Server
Example:
All Rights Reserved © Alcatel-Lucent 2008
Page 22
To check the connection between two computers, for example computer A, named: hostnameA with 172.25.163.80 as IP address, and computer B, named hostnameB with 172.25.163.180 as IP address: 1.
On A, click start to open your Start Menu
2.
Click Run, this will open a dialog box that allows you to type in a command
3.
Type in cmd and click OK. This opens a command window
4.
Type in ping hostNameB to test the hostname
5.
Type in ping 172.25.163.180 to test the IP address
6.
The system provides different responses, such as: « Reply from hostNameB : octets=32 temps./install.sh 5. Free Desktop is installed. Free Desktop Web Admin, Web Interface and IP Touch Interface are grouped in one service. Free Desktop SNMP Agent Service is an other service.
All Rights Reserved © Alcatel-Lucent 2008
Page 24
SCREENSHOT 6 - Installation trace
6. Once you are sure the Free Desktop is well installed and started, you will have to configure it. Refer to “Free Desktop Administration guide” to do that.
All Rights Reserved © Alcatel-Lucent 2008
Page 25
12 Installation Checks 12.1 Free Desktop Service Test Goal:
To test if Free Desktop Service is well started after the installation
Scenario:
Installation is over and no error has occurred
Outcome:
You wil know if Free Desktop service is running
Time:
1 minute
1. Open a Linux terminal 2. Run the command : >service freedesktop status 3. If the Free Desktop Service is well started, the message will be : Free Desktop is started
12.2 FreeDesktop Web Admin Test Goal:
To test if the Free Desktop Web Admin is available.
Scenario:
Installation is over and no error has occurred.
Outcome:
You will know if the Web Admin is correctly installed and ready to start.
Time:
1 minute.
The Free Desktop Web Admin's URL is as follows: http://[hostname]:7080/freedesktop/ Where [hostname] is the name of the machine on which Free Desktop Web Admin runs, and 7080 is the HTTP port number. Test this URL to know if the Web Admin is available, using following steps: 1. Start your favorite web browser (e.g. Internet Explorer, Mozilla, Firefox) All Rights Reserved © Alcatel-Lucent 2008
Page 26
2. Enter the above URL with the correct hostname and HTTP port number. You should get the login page of FreeDesktop Web Admin Configuration. If you get an error page, go to the Trouble shooting section of your Administration guide 3. Gives the below screenshot :
SCREENSHOT 7 - Web Admin Interface Start Page
The following directory contains the admin guide : /opt/Alcatel/FreeDesktop/guides
12.3 FreeDesktop Web Interface Test Goal:
To check if FDE Web Interface has been correctly installed.
Scenario:
Once the application has been installed, check setup is correct.
Outcome:
The FDE Web Interface will run properly on your machine.
Time:
1 minute
The Free Desktop Web Interface’s URL is as follows: http://[hostname]:7080/freedesktop/ 1. Same process than for the Web Admin test All Rights Reserved © Alcatel-Lucent 2008
Page 27
2. Gives the below screenshot :
SCREENSHOT 8 - Web Interface Start Page
The following directory contains the user guide : /opt/Alcatel/FreeDesktop/guides
12.4 IP Touch Interface Setup Test Goal:
To check if FDE IP Touch Interface has been correctly installed
Scenario:
Once the application has been installed, check setup results.
Outcome:
FDE IP-Touch Interface will run properly on your machine.
Time:
1 minute
The Free Desktop Web Interface’s URL is as follows: http://[hostname]:7080/iptouchinterface/en/isRunning.html 1. Same process than for the Web Admin test 2. Gives the below screenshot :
All Rights Reserved © Alcatel-Lucent 2008
Page 28
SCREENSHOT 9 - IP-Touch Interface Start Page
The following directory contains the user guide : /opt/Alcatel/FreeDesktop/guides
All Rights Reserved © Alcatel-Lucent 2008
Page 29
12.5 Free Desktop SNMP Agent Service Test Goal:
To test if Free Desktop SNMP Agent Service is well created and stopped after the installation
Scenario:
Installation is over and no error has occurred
Outcome:
You wil know if Free Desktop SNMP Agent service is well created and stopped
Time:
1 minute
4. Open a Linux terminal 5. Run the command : >service freedesktopsnmpagentd status 6. If the Free Desktop Service is well created and stopped, the message will be : Service Agent SNMP Free Desktop is stopped
All Rights Reserved © Alcatel-Lucent 2008
Page 30
13 Configuration 13.1 Presentation Server Configuration Goal:
To declare Free Desktop IP-Touch Interface on the Presentation Server.
Scenario:
The Free Desktop IP-Touch Interface is installed. The application server (Tomcat) is running.
Outcome:
You will have a Presentation Server where the Free Desktop IPTouch Interface is declared.
Time:
5 minutes
To declare FDE IP-Touch Interface in the Presentation Server: 1. Log on as admin on the Xml Api server (or UC), via its web interface; click on Services in the menu to the left of the page. A configuration page is displayed. 2. In the list of services, locate the service whose entity type is Presentation Server and click the icon in the Action column 3. A PRS Application Management – Presentation Server Global Parameters configuration page is displayed. If there is a proxy between the Presentation Server and the Free Desktop Server, you can configure it here. 4. Click Next. A second administration page, where IP-Touch applications are listed (if they exist); is displayed
All Rights Reserved © Alcatel-Lucent 2008
Page 31
SCREENSHOT 10 - XML API Service Configuration Page
All Rights Reserved © Alcatel-Lucent 2008
Page 32
SCREENSHOT 11 - List of IP Touch Application Example Window
5. Find a free Index in this list (this value must be higher than 0) 6. Click Create. Another configuration page is displayed
All Rights Reserved © Alcatel-Lucent 2008
Page 33
SCREENSHOT 12 - IP-Touch Application Creation Example
7. Fill the 3 mandatory fields: -
“Index”: put here the free index value (higher than 0) you found before.
-
“Identifier”: this is 4 letters identifier (for example: “FDEI”). It will be used to identify the Free Desktop application on the PBX during the next OXE configuration.
-
“URL registration”: this is the address where the IPTouch application can be reached on the Free Desktop Server. This address is like :
http://[hostname]:7080/iptouchinterface/Register where: {FD-SRV-HOST} must be replaced by the IP address or the hostname of the Free Desktop Server. {FD-SRV-TOMCAT-PORT} must be replaced by the Tomcat 5.0.28 port you have installed before. For example, the following URL is valid: All Rights Reserved © Alcatel-Lucent 2008
Page 34
http://192.168.101.17:7080/iptouchinterface/Register Be careful with the upper cases. Keep the other ones with their default value. 8. Click Create. You are brought back to the list of application page. Your new application is added to the list 9. Click Next. Another page is displayed 10. Click Finish
13.2 OmniPCX Enterprise Configuration for Free Desktop Interface Goal:
To configure the OmniPCX Enterprise in order to display the Free Desktop IP-Touch Interface on 8&9 series sets
Scenario:
The Free Desktop IP-Touch Interface is installed and configured on the Presentation Server. The Presentation Server and the Tomcat server are running
Outcome:
The Desktop IP-Touch Interface will run on the IP-Touch sets and will be ready for use.
Time:
5 minutes
An IP-Touch application corresponding to the FDE IP-Touch Interface must be declared on the OmniPCX Enterprise to display access to the application on Free Desktop subscribers' sets. 1. Access the OmniPCX Enterprise configuration tool 2. Select Alcatel 8&9 Series > Alcatel Series 8&9 applications 3. Select Create 4. Fill the following attributes:
Application Id
All Rights Reserved © Alcatel-Lucent 2008
Enter FDEI
Page 35
Application name
Enter Free Desktop
The « Application Id » must be the same identifier than this one you have enter during the Presentation Server configuration (Here « FDEI »). 5. Confirm your entries 6. Once the application has been defined, associate it to the class of service (COS) for Free Desktop subscribers. Only users in this class of service will have access to the FDE IP-Touch Interface via their set 7. For each class of service with the Free Desktop feature: a. Select: Alcatel 8&9 Series Alcatel Series 8&9 Classes of Service COS applications b. Review/modify the following attribute: Application COS
Select the Free Desktop class of service. In our Example the COS number is 0 External Application No x
Id
FDEI
Name
Free Desktop
Priority
Change the priority to a free priority number. For example set it to 8 (if all priorities from 0 to 7 are used). Default value: 0
c. Confirm your entries 8. The last step consists in associating the Free Desktop class of service to Free Desktop subscribers if this has not been done already. For each IP-Touch subscriber with Free Desktop: a. Select Users > Alcatel 8&9 Series Parameters b. Review/modify the following attributes: Directory Number
Select the subscriber number to be modified.
Application COS
Change the application's COS if needed.
All Rights Reserved © Alcatel-Lucent 2008
Page 36
c. Confirm your entries The Free Desktop application will appear on the menu tab of the IP-Touch (in 8th position since we set priority to 8):
SCREENSHOT 13 - Free Desktop in 8 th position
14 Uninstalling 14.1 Free Desktop Environment Uninstalling Goal:
To uninstall Free Desktop Environment from your server.
Scenario:
You do not want to use Free Desktop anymore.
Outcome:
Free Desktop will be removed from your computer.
Time:
1 minute.
1. Open the directory /opt/Alcatel/FreeDesktop/_uninstall: >cd /opt/Alcatel/FreeDesktop/_uninstall 2. Run the uninstaller uninstall.sh >./uninstall.sh 3. A summary of removed components is displayed. Free Desktop and Free Desktop SNMP Agent Service are uninstalled. If Free Desktop High Availability is installed, you are notified of the uninstallation. This uninstaller removes all the Free Desktop components (Service, SNMP Agent Service, High Availability).
All Rights Reserved © Alcatel-Lucent 2008
Page 37
SCREENSHOT 14 - Free Desktop removal
14.2 Complete Free Desktop IP-Touch Interface Uninstalling Goal: To finish uninstallation of the Free Desktop IP-Touch Interface from your
All Rights Reserved © Alcatel-Lucent 2008
Page 38
server. Scenario: You do not want to use Free Desktop IP-Touch Interface anymore. Outcome: Free Desktop IP-Touch Interface will be unconfigured in the XML API / UC and OXE. Time: 2 minutes. 1. Delete the FDE IP-Touch Interface from the Presentation Server: a. Log on as admin on the Xml Api server (or UC), via its web interface; b. Click on Services in the menu to the left of the page. configuration page is displayed.
A
c. In the list of services, locate the service whose entity type is Presentation Server d. Click the icon in the Action column e. A PRS Application Management- Presentation Server Parameters configuration page is displayed, see figure.
Global
f. Click Next. A second administration page, where IP-Touch applications are listed (if they exist); see: figure: List of IP Touch Application Example Window. g. Click on Next to reach the page where the IP-Touch applications are listed; h. Select the FDEI application and click on the corresponding icon labeled Delete selected on this page. A confirmation window appears i. Select the FDEI application and click the icon j. Click Next k. Click Finish 2. Delete the FDE IP-Touch Interface from the OmniPCX Enterprise. l. Access the mgr configuration tool m. Select Alcatel 8&9 Series Alcatel Series 8&9 applications Delete n. In the Delete screen, enter FDEI as ID All Rights Reserved © Alcatel-Lucent 2008
Page 39
o. Press Ctrl+V to validate Now the Free Desktop IP Touch Interface is fully removed.
All Rights Reserved © Alcatel-Lucent 2008
Page 40
15 Appendix 15.1 Table of Figures
FIGURE 1 - FREE DESKTOP ARCHITECTURE
.......................................................................9
FIGURE 2 - SEQUENCE DIAGRAM : LOGON-IP TOUCH INTERFACE ....................................................
10
FIGURE 3 - FSEQUENCE DIAGRAM : WEB INTERFACE ..............................................................
11
FIGURE 4 - APPLICATION AVAILABILITY .........................................................................
15
FIGURE 5 - PHONE SET COMPATIBILITY .........................................................................
16
SCREENSHOT 1 - INSTALLATION TRACE .........................................................................
25
SCREENSHOT 2 - WEB ADMIN INTERFACE START PAGE SCREENSHOT 3 - WEB INTERFACE START PAGE
........................................................... 27
................................................................. 28
SCREENSHOT 4 - IP-TOUCH INTERFACE START PAGE ............................................................. SCREENSHOT 5 - XML API SERVICE CONFIGURATION PAGE
29
....................................................... 32
SCREENSHOT 6 - LIST OF IP TOUCH APPLICATION EXAMPLE WINDOW ................................................
33
SCREENSHOT 7 - IP-TOUCH APPLICATION CREATION EXAMPLE .....................................................
34
SCREENSHOT 8 - FREE DESKTOP IN 8 TH POSITION
................................................................ 37
SCREENSHOT 9 - FREE DESKTOP REMOVAL .....................................................................
All Rights Reserved © Alcatel-Lucent 2008
38
Page 41
www.alcatel-lucent.com
All Rights Reserved © Alcatel-Lucent 2008
Page 42
