Alcatel-Lucent OmniPCX Enterprise Free DeskTop Server Free DeskTop version 3.0.1 – Administration Guide
Alcatel-Lucent Services for Enterprise All Rights Reserved © Alcatel-Lucent 2007
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 ...........................................................................................................................6
1.6
How to use this document...................................................................................................................7
1.7
Copyrights ...............................................................................................................................................7
1.8
Related Documents ...............................................................................................................................7
1.9
Licensing..................................................................................................................................................7
1.10
Customer Support..............................................................................................................................8
2
OVERVIEW....................................................................................9
2.1
The Application......................................................................................................................................9
2.2
This Manual .............................................................................................................................................9
2.3
Scope of this Document .......................................................................................................................9
3
FREE DESKTOP ENVIRONMENT FEATURES DESCRIPTION ........... 11
3.1
Free Desktop, a mobility solution for Alcatel-Lucent OmniPCX Enterprise..........................11
3.2
Free Desktop users and Temporary users .....................................................................................11
3.3
Free Desktop Subscriber Rights .......................................................................................................11
3.4
Auto-Log-off..........................................................................................................................................12
3.5
Dedicated OXE hosting temporary and/or virtual users.............................................................12
3.6
Retaining same number of users per OXE .....................................................................................12
3.7
Emergency calls – Entity number updatable during a move .....................................................13
3.8
Save phone book Licences ................................................................................................................13
All Rights Reserved © Alcatel-Lucent 2008
Page 3
3.9
Unified Communication compatibility table .................................................................................13
3.10
Upgrade Free Desktop 1.0 to Free Desktop 2.0 ......................................................................14
3.11
Restore users’ aliases configuration for Free Desktop 1.0 ...................................................14
4
FREE DESKTOP CONFIGURATION ............................................... 15
4.1
Access to the web administration interface .................................................................................15
4.2
About, Help, Sign Out.........................................................................................................................16
4.3 General Parameters ............................................................................................................................16 4.3.1 Normal Mode..................................................................................................................................17 4.3.2 Expert Mode ...................................................................................................................................18 4.4 Configure the PBX network...............................................................................................................21 4.4.1 Description .....................................................................................................................................21 4.4.2 Create a new PBX (or UC) Connector .......................................................................................21 4.5 Configure Free Desktop users ..........................................................................................................23 4.5.1 Description .....................................................................................................................................23 4.5.2 Add a user ......................................................................................................................................24 4.5.3 Search a user .................................................................................................................................26 4.5.4 Delete a user .................................................................................................................................29 4.5.5 Import users ...................................................................................................................................30 4.6 Configure Temporary users...............................................................................................................33 4.6.1 Description .....................................................................................................................................33 4.6.2 Add a temporary user...................................................................................................................34 4.6.3 Search a temporary user..............................................................................................................36 4.6.4 Delete a temporary user..............................................................................................................39 4.6.5 Import temporary users ...............................................................................................................40 4.7 Configure Auto-Log-Off ......................................................................................................................43 4.7.1 Description .....................................................................................................................................43 4.7.2 Create an Auto Log Off task........................................................................................................44 4.8
Export configuration...........................................................................................................................46
4.9 Protection mechanism........................................................................................................................46 4.9.1 Description .....................................................................................................................................46 4.9.2 Description .....................................................................................................................................47
5
FREE DESKTOP ADMINISTRATION............................................... 47
5.1
Traces.....................................................................................................................................................47
5.2
Start & stop Free Desktop .................................................................................................................48
5.3
Expert configuration...........................................................................................................................48
All Rights Reserved © Alcatel-Lucent 2008
Page 4
6
TROUBLESHOOTING ................................................................... 49
7
APPENDIX................................................................................... 50
7.1
Table of Figures ...................................................................................................................................50
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 configuration and administration 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 tasks of the System Administrator, after installing the application: Free Desktop version 3.0.1 and its related software. After installation, the System Administrator has to configure the installed software and carryout the administrative works. This manual provides information to do these activities.
1.4 Scope This manual covers •
Free Desktop Environment Features Description
•
Free Desktop Configuration
•
Free Desktop Administration
1.5 Application Overview The application: Free Desktop Environment is installed in a separate server or in XML server(Linux installation only). 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. Now that the installation of these is over, you will have to configure them to suit your needs. 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.
All Rights Reserved © Alcatel-Lucent 2008
Page 6
1.6 How to use this document This document assumes that the installation of Free Desktop version 3.0.1, along with its related software are already installed as specified. Now the task of the administrator is to: • •
Configure the installed software Do his administrative duties to make the systems work as required
This manual explains the above in detail, along with related information. You can give sequential reading of this manual for a good understanding of the tasks. Then, as and when you require, you can use this as your reference manual To locate the description for the required task, you can use the Table of Contents given at the beginning of this manual. The entries in this list are hyper-linked. Use Ctrl+Click on the line to move to that part of the manual. 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 – Installation Guide Free Desktop - User Guide
1.9 Licensing Each Free Desktop Server 2.x required a FlexLM license: FREEDESKTOP version 1.0. Each Free Desktop User 2.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.
All Rights Reserved © Alcatel-Lucent 2008
Page 7
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 administration guide. It describes the configuration and administration of the installed Free Desktop and other related software. minimum procedures required to install the Alcatel Free Desktop Environment (FDE) software. This software includes three components: • • •
Free Desktop Server Free Desktop IP-Touch Interface Free Desktop Web Interface
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 Scope of this Document This document describes procedures that may be requested before or after installing the Alcatel Free Desktop Environment software. Further information is provided in the installation CD-ROM in the Readme.txt file. The table below lists the components of the Free Desktop application: Free Desktop Environment
3.X
Detailed components: Free Desktop Web Service Free Desktop IP-Touch interface Free Desktop Web Interface
3.0.1 3.0.1 3.0.1
Operating Systems
Microsoft Windows 2003 SP1 / Red Hat 4 ES
OXE version
Release 8.0 (g1.302.7 or upper), Release 9.0
Supported sets
4010, 4010IP, 4020, 4022, 4035, 4037, 4008, 4018, 4019, 4028, 4029, 4038, 4039, 4068,IPDSP
Java version
JDK 1.5.0_10
All Rights Reserved © Alcatel-Lucent 2008
Page 9
Free Desktop Environment
3.X
Application Server
Tomcat 5.0.28
Alcatel-Lucent XML API or Unified Communication
5.1
Table 1: Free Desktop Environment Components
All Rights Reserved © Alcatel-Lucent 2008
Page 10
3 Free Desktop Environment features description 3.1 Free Desktop, a mobility solution for Alcatel-Lucent OmniPCX Enterprise Free Desktop Environment is mobility feature allowing: • • •
to share the extensions(phone sets) of a company to simplify the move operations of the users to get easily the configuration of the users’ extensions.
The users can log on an extension and automatically retrieve their phone profile (directory number, discrimination, programmable keys…). The Free Desktop application allows users to affect (log on) or disaffect (log off) their phone number on a phone set. The Free Desktop Web Service is in charge of the subscribers’ moves in the PBX.
3.2 Free Desktop users and Temporary users Temporary directory numbers are used to replace user directory numbers who have been moved from THEIR extension to another extension. For each node, you must have as many temporary directory numbers as users with an initial extension. The users who are initially logged off and the Shared extensions do not require temporary directory numbers. Before configuring any Free Desktop subscriber, we recommend configuring their accounts in their original position: • • • • •
Users who are originally on a specific phone set must be assigned to this phone set. This concerns real users and users (directory numbers) assigned to shared phone sets. Users who do not have an original physical phone set must be on a virtual location Pools of temporary directory numbers associated to each node must be on a virtual location For one mobile user you need one temporary user Temporary Users must be configured in OXE as UA phone (i.e.: for each 4018 user you need 4019 temporary user, for each 4068 user, you need 4039 temporary user…)
3.3 Free Desktop Subscriber Rights #
Rights
When enabled
1.
Mobile right
The subscriber can move to another set
2.
Shared right
The subscriber allows another subscriber to move to their current set
All Rights Reserved © Alcatel-Lucent 2008
Page 11
#
Rights
When enabled
3.
Protected right
The subscriber does not allow other subscribers to move to their original set.
4.
Network right
The subscriber can move to a set on another node
5.
Auto-Log-On right
A user is automatically logged on back his phone set when this one is free or freed. The Automatic log on back feature runs when: • Either when the user logs off AND his phone set is free or • When his phone set is freed and the user is logged off Table 1: Free Desktop Subscriber Rights
3.4 Auto-Log-off If some users forget to log off leaving their workspace, they can be automatically logged off by the system. Those users must be defined in a list, and a periodic date to check if the users are logged off must be associated to this list. This feature is called: Auto-Log off. a. Several lists can be defined b. A list can contain one or several users and/or one or several ranges of users. The users are defined thanks their directory number. c. The periodicity can be daily, weekly, monthly or annually at a specific hour. Ex: Log off user 1001 each Saturday at 6PM.
3.5 Dedicated OXE hosting temporary and/or virtual users You can select an OXE for hosting your temporary and/or virtual user
3.6 Retaining same number of users per OXE A network move keeps the same number of subscriber by PBX (if this feature is enabled). There are 2 ways: a. Mode 1: Without dedicated PBX, the moves follow these rules: i. When a user logs on another node, a temporary user is selected on the target node to replace the user. ii. When a user logs off, he is moved on his original node to keep the same number of temporary users associated to each node. b. Mode 2: With a dedicated PBX to Free Desktop, all virtual subscribers are hosted on this PBX. The moves follow these rules: i. When a user logs on another node, a temporary user is selected to replace the user on the dedicated PBX associated to the target PBX. All Rights Reserved © Alcatel-Lucent 2008
Page 12
ii. When a user logs off, he is moved to the dedicated PBX associated to his original PBX to keep the same number of temporary users associated to each node. This feature is applied to all Free Desktop users of the installation and can be activated/deactivated in the configuration of the Free Desktop Web Service. By default, this feature is activated.
3.7 Emergency calls – Entity number updatable during a move According to your phone system configuration, emergency calls can be managed by entity. When a user logs on a phone set, his entity number is become the one of the previous user. This feature is applied to all Free Desktop users of the installation and can be activated / deactivated in the configuration of the Free Desktop Web Service. By default, this feature is deactivated.
3.8 Save phone book Licences When a Free Desktop User is logged off, his phone book license is saved in Free Desktop database. This license will be restored during user log on.
3.9 Unified Communication compatibility table Free Desktop 3.x Single PBX
PBX network
Mono API/UC XML API 2.2, 3.x
Multi API/UC
Releases not supported
UC 3.x & 4.x : My Phone
Releases not supported
My Assistant My Messaging XML API 5.1
OK
OK
WR
My Phone
OK*
OK*
WR
My Assistant
OK
OK
OK
My Messaging
OK
OK
OK
UC 5.1 :
Table 2: Unified Communication compatibility
Note: OK:
Fully compatible
All Rights Reserved © Alcatel-Lucent 2008
Page 13
OK*:
Nomadic functionality does not work when the user is logged off Configure the protected and auto-log-on Free Desktop rights to the nomadic users to be sure they are always logged on a set.
WR:
With Restrictions. After such a move, My Phone Web Services / My Phone application is not available for the user until he moves back on a PBX cover by his initial XML API / UC.
3.10 Upgrade Free Desktop 1.0 to Free Desktop 2.0 Free Desktop release 3 is not compatible with Free Desktop release 1. Nevertheless, a procedure is available to upgrade from Free Desktop 1.0 to Free Desktop 3.0
3.11 Restore users’ aliases configuration for Free Desktop 1.0 Free Desktop release 1 is not compatible with Free Desktop release 3. Nevertheless, a procedure is available to downgrade from Free Desktop 3.0 to Free Desktop 1.0 Caution: Please take into account that Free Desktop step 1 does not manage autologon, auto-logoff and entity movable
All Rights Reserved © Alcatel-Lucent 2008
Page 14
4 Free Desktop Configuration 4.1 Access to the web administration interface The Free Desktop Server Interface URL is as follows: http://[hostname]:[HTTP_port]/freedesktop/
Where: -
[hostname] is the name of the machine on which Free Desktop Server runs,
and -
[HTTP_port] is the HTTP port number configured in Tomcat (typically:
8080). Log on as admin on the Authentification Page.
SCREENSHOT 1 - Authentication page
To change the Authentication parameters, please edit file: …\Tomcat 5.0\conf\tomcat-users.xml And change the line:
All Rights Reserved © Alcatel-Lucent 2008
Page 15
4.2 About, Help, Sign Out When you are log on, three buttons are shown in the top of the interface:
SCREENSHOT 2 - Authentication page
•
Click on the first button if you want to display information about the Free Desktop version
•
Click on the second button if you want to open the admin guide
•
Click on the last button if you want to sign out
4.3 General Parameters Click on the “General” thumbnail to display the General page. between two modes, namely: • •
You can choose
Normal Mode and Expert Mode
All Rights Reserved © Alcatel-Lucent 2008
Page 16
4.3.1 Normal Mode
SCREENSHOT 3 - General Page (Normal Mode)
In this mode you can enable: -
the Entity movable feature (refer to chapter 3.7)
-
the Keep number of user per OXE feature (refer to chapter 3.6)
-
the Forward Policy feature if you want that the Free Desktop manage the forward policy
-
the Save phone book license feature (refer to chapter 3.8)
-
the My Assistant detection enabled feature if you want that the Free Desktop detect my assistant user. If you set this feature at true, you will have two ways to detect these users: automatically (longer) or by adding RSI numbers in the RSI number list (recommended).
You can delete a RSI number by clicking on the icon below each user in the RSI number list. When a My Assistant user is detected, his immediate forward on RSI point is not modified. All Rights Reserved © Alcatel-Lucent 2008
Page 17
SCREENSHOT 4 - RSI number List
4.3.2 Expert Mode
All Rights Reserved © Alcatel-Lucent 2008
Page 18
SCREENSHOT 5 - General Page (Expert Mode)
In this mode you can enable: All Rights Reserved © Alcatel-Lucent 2008
Page 19
-
features of normal mode
-
the Cache enable feature if you want to optimize the processing time
-
you can set the maximum number of XML API. The maximum number of XML API is limited to 10)
-
you can set the Max try for set Mac address: the number of time the Free Desktop will try to change the Mac address of a phone set during a move(if this change failed).
-
you can set the Sleep after set Mac address failed: the time between the moment where the Free Desktop failed to change the Mac address and the moment where the Free Desktop will retry to change it
-
you can set the Max try for set PBX address: the number of time the Free Desktop will try to change the PBX address of a phone set during a move(if this change failed).
-
you can set the Sleep after set PBX address failed: the time between the moment where the Free Desktop failed to change the PBX address and the moment where the Free Desktop will retry to change it
-
you can set the Max try for change station type: the number of time the Free Desktop will try to change the phone set Type during a move(if this change failed).
-
you can set the Sleep after change station type: the time between the moment where the Free Desktop failed to change phone set type and the moment where the Free Desktop will retry to change it
-
You can launch the Free Desktop upgrade tool add-on (refer to chapter 3.10/3.11): you have to choose if you want to upgrade the Free Desktop 1 to Free Desktop 3 (upgrade) or if you want to downgrade the Free Desktop 3 to Free Desktop 1 (restore) by changing the available actions field. Then Click on the icon below to start the action. This icon will be modified by the icon during this operation. The upgrade/restore operation is finished when the clock icon disappear. You can check if the upgrade/restore operation succeeded in the FD-Ugrade.log file (refer to chapter 5.1).
-
You can launch the Free Desktop Auto Log Off add-on (refer to chapter 3.4): you have to choose if you want to start or stop the Auto Log Off feature by changing the available actions field. Then Click on the icon below to start the action
-
.
You can modify all fields of the Free Desktop configuration and click on the Update button to save it.
Caution: this mode allows the administrator to force delete users or configured OXE for Free Desktop All Rights Reserved © Alcatel-Lucent 2008
Page 20
4.4 Configure the PBX network 4.4.1 Description Click on the “PBX Links” thumbnail to display the PBX Links page.
SCREENSHOT 6 - PBX Links Page
This page is used to create and configure all XML API (or UC) connector and Node.
4.4.2 Create a new PBX (or UC) Connector Please fill in all Field in the “Create” window and click on the “Create” button to create a PBX connector. All Rights Reserved © Alcatel-Lucent 2008
Page 21
SCREENSHOT 7 - Create connector
-
The Host field represents the address of your XML API (or UC) Server.
-
The Port field represents the port of your XML API (or UC) Server.
-
The FlexLM Host field represents the address of your FlexLM Server.
-
The FlexLM Port field represents the port of your FlexLM Server.
-
The Login field represents the administrator log in of your XML API (or UC) Server.
-
The Password field represents the admin password of your XML API (or UC) Server.
If your connector is correctly created, it will appear in the connectors table as given below:
SCREENSHOT 8 - Connectors Table
Any node registered in your XML API (or UC) server will appear in the nodes table.
All Rights Reserved © Alcatel-Lucent 2008
Page 22
SCREENSHOT 9 - Nodes Table
Please check the checkbox below each node you want to configure for the Free Desktop and choose the PBX where the temporary user will be hosted by using list box. If you configure a new PBX in your XML API server, please click on the icon click on the modify button.
and
If you have added a user in PBX and you want to configure it to Free Desktop you have to click on the reload icon before create this user in the Free Desktop database. You can only disable a PBX configured for Free Desktop if there is no depended Free Desktop user (delete all user in the user page before disable a node). Note: you can force disable if you are in expert mode (refer to chapter 4.3.2)
4.5 Configure Free Desktop users 4.5.1 Description Click on the User config thumbnail to display the User Configuration page.
All Rights Reserved © Alcatel-Lucent 2008
Page 23
SCREENSHOT 10 - User Configuration Page
This page is used to create and configure all Free Desktop User. It shows you the number of FreeDesktop user licenses left (On screenshot 9 you can see “user licenses left: 10/10”, it means there is 10 licenses left and the total number of licenses used and unused is 10).
4.5.2 Add a user There are two ways to add a user in the Free Desktop List:
All Rights Reserved © Alcatel-Lucent 2008
Page 24
-
By number: you have just to check the Number radio button and enter the number you want to add to the Free Desktop list in the Number Field and click on the Add button. You can only add an existing user in PBX.
SCREENSHOT 11 - Add a User by number
-
By range of number: you have just to check the Range of Number radio button and enter the first number and the last number of the range you want to add to the Free Desktop list in the First Number and Last Number fields and click on the Add button (Only existing users in PBX will be added).
SCREENSHOT 12 - Add users by range of number
All your added users will appear in the users table. information on the following table:
All Rights Reserved © Alcatel-Lucent 2008
You can observe many
Page 25
SCREENSHOT 13 - Users Table
•
Directory Number
•
User on original set: o o
•
Owner of Current set: o o
•
the user 1001 has a permanent physical set, you can see in the table that this user is connected on his original set. the user 1005 is connected on the original set of the user 1004.
the owner of the set where the user 1005 is currently logged is the user 1004. the user 1004 is not logged because his Owner of Current set cell is empty.
You can change user rights by clicking on those icons: (please consult subscriber rights chapter 3.1)
4.5.3 Search a user There are many ways to search a user in the Free Desktop List: •
By number: you have just to check the Number radio button and enter the number you want to search in the Number Field and click on the Search button (if this number is not registered in the Free Desktop list, the following message will be displayed: nothing found to display).
All Rights Reserved © Alcatel-Lucent 2008
Page 26
SCREENSHOT 14 - Search users by number
•
By range of number: you have just to check the Range of Number radio button and enter the first number and the last number of the range you want to search in the First Number and Last Numbers fields and click on the Search button (Only existing users configured for Free Desktop in PBX will be displayed).
SCREENSHOT 15 - Search users by range
•
If you click on the Search button without filling Number, First Number and Last Number fields, the user table will display all Free Desktop Users.
All Rights Reserved © Alcatel-Lucent 2008
Page 27
SCREENSHOT 16 - Search users (empty)
•
If you choose the search by range and you fill only the First Number Field, only numbers bigger than this number will be displayed.
SCREENSHOT 17 - Search user by range (First Number)
•
If you choose the search by range and you fill only the Last Number Field, only numbers lower than this number will be displayed.
All Rights Reserved © Alcatel-Lucent 2008
Page 28
SCREENSHOT 18 - Search user by range (Last Number)
4.5.4 Delete a user There are three ways to delete a user in the Free Desktop List: •
By number: you have just to check the Number radio button and enter the number you want to delete in the Number Field and click on the Delete button (A confirmation will be asked).
SCREENSHOT 19 - Delete user by number
•
By range of number: you have just to check the Range of Number radio button and enter the first number and the last number of the range you want to search in the First Number and Last Numbers fields and click on the Delete button (A confirmation will be asked).
All Rights Reserved © Alcatel-Lucent 2008
Page 29
SCREENSHOT 20 - Delete user by range of number
•
You can delete a user by clicking on the icon below each user in the users table. Caution: In normal mode you can only delete a user when he is located on is original phone set (or logged off if it is a virtual user).
SCREENSHOT 21 - Delete user by using icons
4.5.5 Import users You can add or modify users by using the import tool.
SCREENSHOT 22 - Delete user by using icons
All Rights Reserved © Alcatel-Lucent 2008
Page 30
•
Import by using CSV file: o
Export the user table by using the following icon, You will get the right import file format
SCREENSHOT 23 - Export Options
o
You can modify Free Desktop right by changing TRUE by FALSE or FALSE by TRUE
Directory Number;User On Original Set;Owner Of Current Set;Mobile Right;Shared Right;Protected Right;Auto Logon Right;Network Right 38000;38000;38000;FAUX;VRAI;FAUX;FAUX;VRAI 38001;38001;38001;VRAI;FAUX;FAUX;FAUX;VRAI 38002;38002;38002;VRAI;VRAI;FAUX;FAUX;VRAI 38003;38003;38003;VRAI;VRAI;FAUX;FAUX;VRAI 38008;38008;38008;VRAI;VRAI;FAUX;FAUX;VRAI 38009;38009;38009;VRAI;VRAI;VRAI;FAUX;VRAI 38010;38010;38010;VRAI;VRAI;FAUX;FAUX;VRAI 38011;38011;38011;VRAI;VRAI;FAUX;FAUX;VRAI
SCREENSHOT 24 - Export Options
o
You can add a user, proceed like this:
Directory_Number;;;[TRUE/FALSE];[TRUE/FALSE];[TRUE/FALSE];[TRUE/FALSE];[TRUE/FALSE]
o
Select “Save as…” in the “File” menu. Select “*.CSV” file extension and save
SCREENSHOT 25 - Export Options
All Rights Reserved © Alcatel-Lucent 2008
Page 31
o
Import the “CSV” file by FD admin page
SCREENSHOT 26 - Export Options
o •
An exception error will be returned in case of bad format
Import by using XSL file: o
Export the user table by using the following icon, You will get the right import file format
SCREENSHOT 27 - Export Options
o
You can modify Free Desktop right by changing TRUE by FALSE or FALSE by TRUE
SCREENSHOT 28 - Export Options
All Rights Reserved © Alcatel-Lucent 2008
Page 32
o
You can add a user (don’t fill the second and third cols)
o
Select “Save as…” in the “File” menu. Select “*.XLS” file extension and save
SCREENSHOT 29 - Export Options
o
Import the “XLS” file by FD admin page
SCREENSHOT 30 - Export Options
o
An exception error will be returned in case of bad format
4.6 Configure Temporary users 4.6.1 Description Click on the Temp Subscriber thumbnail to display the Temporary User page.
All Rights Reserved © Alcatel-Lucent 2008
Page 33
SCREENSHOT 31 - Export Options
This page is used to create and configure all Free Desktop Temporary Users.
4.6.2 Add a temporary user There are two ways to add a temporary user in the Free Desktop List: •
By number: you have just to check the Number radio button and enter the number you want to add to the Free Desktop list in the Number Field and click on the Add button (You can only add an existing user in PBX).
All Rights Reserved © Alcatel-Lucent 2008
Page 34
SCREENSHOT 32 - Add a temporary user by number
•
By range of number: you have just to check the Range of Number radio button and enter the first number and the last number of the range you want to add to the Free Desktop list in the First Number and Last Numbers fields and click on the Add button (Only existing users in PBX will be added).
SCREENSHOT 33 - Add a temporary users by range of number
All your added temporary users will appear in the users table. You can observe many information on the following table:
All Rights Reserved © Alcatel-Lucent 2008
Page 35
SCREENSHOT 34 - Temporary Users Table
•
Directory Number
•
User on original set: i.e. No temporary user have a permanent physical set because nobody is connected on their set.
•
Owner of Current set:
The examples should be matched as per the table given above. o
i.e.1 the owner of the set where the user A100 is currently logged is the user 1002.
o
i.e.2 the user B001 is not logged because his Owner of Current set cell is empty.
4.6.3 Search a temporary user There are many ways to search a temporary user in the Free Desktop List: •
By number: you have just to check the Number radio button and enter the number you want to search in the Number Field and click on the Search button (if this number is not registered in the Free Desktop list, the following message will be displayed: nothing found to display).
All Rights Reserved © Alcatel-Lucent 2008
Page 36
SCREENSHOT 35 - Search temporary user by number
•
By range of number: you have just to check the Range of Number radio button and enter the first number and the last number of the range you want to search in the First Number and Last Numbers fields and click on the Search button (Only existing users configured for Free Desktop in PBX will be displayed).
SCREENSHOT 36 - Search temporary users by range of number
•
If you click on the Search button without filling Number, First Number and Last Number fields, the temporary user table will display all Free Desktop temporary users.
All Rights Reserved © Alcatel-Lucent 2008
Page 37
SCREENSHOT 37 - Search temporary users (empty)
•
If you choose the search by range and you fill only the First Number Field, only numbers bigger than this number will be displayed.
SCREENSHOT 38 - Search temporary users by range of number (First Number)
•
If you choose the search by range and you fill only the Last Number Field, only numbers lower than this number will be displayed.
All Rights Reserved © Alcatel-Lucent 2008
Page 38
SCREENSHOT 39 - Search temporary users by range of number (Last Number)
4.6.4 Delete a temporary user There are three ways to delete a temporary user in the Free Desktop List: •
By number: you have just to check the Number radio button and enter the number you want to delete in the Number Field and click on the Delete button (A confirmation will be asked).
SCREENSHOT 40 - Search Temporary User Result Table
•
By range of number: you have just to check the Range of Number radio button and enter the first number and the last number of the range you want to delete in the First Number and Last Numbers fields and click on the Delete button (A confirmation will be asked).
All Rights Reserved © Alcatel-Lucent 2008
Page 39
SCREENSHOT 41 - Search Temporary User Result Table
•
You can delete a temporary user by clicking on the icon below each temporary user in the temporary users table Caution: In normal mode, you can only delete a temporary user when he is logged off.
SCREENSHOT 42 - Deletion by clicking on icon
4.6.5 Import temporary users You can add or modify users by using the import tool.
•
Import by using CSV file:
All Rights Reserved © Alcatel-Lucent 2008
Page 40
-
Export the user table by using the following icon, You will get the right import file format
SCREENSHOT 43 - Export Options
Directory Number;User On Original Set;Owner Of Current Set A1000;; A1001;; A1002;; A1003;; A1008;; A1009;; A1010;; A1011;;
SCREENSHOT 44 - Export Options
-
You can add a user, proceed like this: Directory_Number;;
Select “Save as…” in the “File” menu. Select “*.CSV” file extension and save
SCREENSHOT 45 - Export Options
-
Import the “CSV” file by FD admin page
All Rights Reserved © Alcatel-Lucent 2008
Page 41
SCREENSHOT 46 - Export Options
•
An exception error will be returned in case of bad format
Import by using XSL file: -
Export the user table by using the following icon, You will get the right import file format
SCREENSHOT 47 - Export Options
-
You can modify Free Desktop right by changing TRUE by FALSE or FALSE by TRUE
SCREENSHOT 48 - Export Options
-
You can add a user (don’t fill the second and third cols)
All Rights Reserved © Alcatel-Lucent 2008
Page 42
-
Select “Save as…” in the “File” menu. Select “*.XLS” file extension and save
SCREENSHOT 49 - Export Options
-
Import the “XLS” file by FD admin page
SCREENSHOT 50 - Export Options
-
An exception error will be returned in case of bad format
4.7 Configure Auto-Log-Off 4.7.1 Description Click on the Auto Log Off thumbnail to display the Auto Log Off page.
All Rights Reserved © Alcatel-Lucent 2008
Page 43
SCREENSHOT 51 - Auto Log Off Page
This page is used to create and configure auto log off tasks.
4.7.2 Create an Auto Log Off task There are three ways to create an auto log off: •
By number: you have just to choose the frequency the start hour and start minute and then check the Number radio button and enter the directory number in the Number Field and click on the Create button. This task will be affected to this number (You can only affect a task an existing Free Desktop user).
All Rights Reserved © Alcatel-Lucent 2008
Page 44
SCREENSHOT 52 - Create Auto Log Off Task for a User
•
By range of number: you have just to choose the frequency the start hour and start minute and then check the Range of Number radio button and enter the first number and the last number of the range in the First Number and Last Numbers fields and click on the Create button. This task will be affected to those numbers.
SCREENSHOT 53 - Create Auto Log Off Task for Users
•
You can modify or delete a task by clicking those icons
All Rights Reserved © Alcatel-Lucent 2008
Page 45
SCREENSHOT 54 - Auto Log Off Task Table
4.8 Export configuration For each table you can create an export in CSV, Excel, XML, PDF or RTF file
SCREENSHOT 55 - Export Options
4.9 Protection mechanism 4.9.1 Description A queue mechanism is provided to protect system against ACAPI over use.
SCREENSHOT 56 - Export Options
Processing queue: Move operation is in process, user will be moved within a minute.
Waiting queue: User’s requests are on hold, Free Desktop system provides users waiting time information. A user is allowed to cancel its operation any time during this waiting procedure.
All Rights Reserved © Alcatel-Lucent 2008
Page 46
When processing queue is full, move request are stored in waiting queue. Otherwise they are processed in real time.
When waiting queue is full, Free Desktop system notifies users to request again.
Administrator can configure waiting queue capacity to change maximum users waiting time.
4.9.2 Description You can configure the waiting queue capacity by changing the file: …\Tomcat 5.0\webapps\freedesktop\WEB-INF\classes\freedesktopServerContext.xml
Modify the value of the field “maxMoveContextInList”:
i.e.: this field represents the maximum number of move stored in the waiting queue (around 12 moves for a minute). If you want to have a max waiting time of 10 minutes in the waiting list, set the maxMoveContextInList” value at 120 like this:
You must restart the Free Desktop Server to update modifications.
5 Free Desktop administration 5.1 Traces The Free Desktop Web Service generates traces. They can be useful to determine the state of the service or error causes. You can find them in the logs directory of the Tomcat Server Installation directory. Once the service has started, 9 files are available: -
FD-Errors.log: reports move errors.
-
FD-Ugrade.log: reports the result of restore/upgrade operation.
-
FD-AutoLogOff.log: generate traces by the Auto-logoff feature.
-
FD-Config.log: generate traces by the configuration module.
-
FD-Server.log: traces during start and move operation and traces of move algorithm.
-
FD-WebService.log: communication between Free Desktop clients and server.
All Rights Reserved © Alcatel-Lucent 2008
Page 47
-
FD-XmlApi.log: communication between Free Desktop server and XML API.
-
FD-WebClient.log: generate traces by the Free Desktop web client.
-
FD-PbxLink.log: traces according to OXE operations.
5.2 Start & stop Free Desktop You have to start the tomcat server to start the Free Desktop server. You have to stop the tomcat server to stop the Free Desktop server.
5.3 Expert configuration Possible log levels are: DEBUG, INFO, WARN, ERROR and FATAL. Default value is INFO. However to change it in anyway you have to modify the level name in …\Tomcat 5.0\webapps\freedesktop\conf\traces.xml. i.e. : You must restart the Free Desktop Server to update modifications.
All Rights Reserved © Alcatel-Lucent 2008
Page 48
6 Troubleshooting For troubleshooting you can consult the Readme.txt file located on the Free Desktop Environment CD-ROM to help you solve your problem. This file lists the most common issues. If the problem persists, please contact Alcatel-Lucent Technical Support
All Rights Reserved © Alcatel-Lucent 2008
Page 49
7 Appendix 7.1 Table of Figures
SCREENSHOT 1 - AUTHENTICATION PAGE ............................................................... 15 SCREENSHOT 2 - AUTHENTICATION PAGE ............................................................... 16 SCREENSHOT 3 - GENERAL PAGE (NORMAL MODE)..................................................... 17 SCREENSHOT 4 - RSI NUMBER LIST ..................................................................... 18 SCREENSHOT 5 - GENERAL PAGE (EXPERT MODE)...................................................... 19 SCREENSHOT 6 - PBX LINKS PAGE ..................................................................... 21 SCREENSHOT 7 - CREATE CONNECTOR .................................................................. 22 SCREENSHOT 8 - CONNECTORS TABLE .................................................................. 22 SCREENSHOT 9 - NODES TABLE ......................................................................... 23 SCREENSHOT 10 - USER CONFIGURATION PAGE ........................................................ 24 SCREENSHOT 11 - ADD A USER BY NUMBER ............................................................ 25 SCREENSHOT 12 - ADD USERS BY RANGE OF NUMBER ................................................... 25 SCREENSHOT 13 - USERS TABLE ........................................................................ 26 SCREENSHOT 14 - SEARCH USERS BY NUMBER .......................................................... 27 SCREENSHOT 15 - SEARCH USERS BY RANGE ............................................................ 27 SCREENSHOT 16 - SEARCH USERS (EMPTY) ............................................................. 28 SCREENSHOT 17 - SEARCH USER BY RANGE (FIRST NUMBER)........................................... 28 SCREENSHOT 18 - SEARCH USER BY RANGE (LAST NUMBER) ........................................... 29 SCREENSHOT 19 - DELETE USER BY NUMBER ........................................................... 29 SCREENSHOT 20 - DELETE USER BY RANGE OF NUMBER ................................................ 30 SCREENSHOT 21 - DELETE USER BY USING ICONS ....................................................... 30 SCREENSHOT 22 - DELETE USER BY USING ICONS ....................................................... 30 SCREENSHOT 23 - EXPORT OPTIONS ................................................................... 31 SCREENSHOT 24 - EXPORT OPTIONS ................................................................... 31 SCREENSHOT 25 - EXPORT OPTIONS ................................................................... 31 SCREENSHOT 26 - EXPORT OPTIONS ................................................................... 32
All Rights Reserved © Alcatel-Lucent 2008
Page 50
SCREENSHOT 27 - EXPORT OPTIONS ................................................................... 32 SCREENSHOT 28 - EXPORT OPTIONS ................................................................... 32 SCREENSHOT 29 - EXPORT OPTIONS ................................................................... 33 SCREENSHOT 30 - EXPORT OPTIONS ................................................................... 33 SCREENSHOT 31 - EXPORT OPTIONS ................................................................... 34 SCREENSHOT 32 - ADD A TEMPORARY USER BY NUMBER................................................ 35 SCREENSHOT 33 - ADD A TEMPORARY USERS BY RANGE OF NUMBER ................................... 35 SCREENSHOT 34 - TEMPORARY USERS TABLE .......................................................... 36 SCREENSHOT 35 - SEARCH TEMPORARY USER BY NUMBER .............................................. 37 SCREENSHOT 36 - SEARCH TEMPORARY USERS BY RANGE OF NUMBER .................................. 37 SCREENSHOT 37 - SEARCH TEMPORARY USERS (EMPTY) ................................................ 38 SCREENSHOT 38 - SEARCH TEMPORARY USERS BY RANGE OF NUMBER (FIRST NUMBER)................ 38 SCREENSHOT 39 - SEARCH TEMPORARY USERS BY RANGE OF NUMBER (LAST NUMBER) ................ 39 SCREENSHOT 40 - SEARCH TEMPORARY USER RESULT TABLE .......................................... 39 SCREENSHOT 41 - SEARCH TEMPORARY USER RESULT TABLE .......................................... 40 SCREENSHOT 42 - DELETION BY CLICKING ON ICON..................................................... 40 SCREENSHOT 43 - EXPORT OPTIONS ................................................................... 41 SCREENSHOT 44 - EXPORT OPTIONS ................................................................... 41 SCREENSHOT 45 - EXPORT OPTIONS ................................................................... 41 SCREENSHOT 46 - EXPORT OPTIONS ................................................................... 42 SCREENSHOT 47 - EXPORT OPTIONS ................................................................... 42 SCREENSHOT 48 - EXPORT OPTIONS ................................................................... 42 SCREENSHOT 49 - EXPORT OPTIONS ................................................................... 43 SCREENSHOT 50 - EXPORT OPTIONS ................................................................... 43 SCREENSHOT 51 - AUTO LOG OFF PAGE ............................................................... 44 SCREENSHOT 52 - CREATE AUTO LOG OFF TASK FOR A USER ......................................... 45 SCREENSHOT 53 - CREATE AUTO LOG OFF TASK FOR USERS .......................................... 45 SCREENSHOT 54 - AUTO LOG OFF TASK TABLE ........................................................ 46 SCREENSHOT 55 - EXPORT OPTIONS ................................................................... 46 SCREENSHOT 56 - EXPORT OPTIONS ................................................................... 46
All Rights Reserved © Alcatel-Lucent 2008
Page 51
All Rights Reserved © Alcatel-Lucent 2008
Page 52
www.alcatel-lucent.com
All Rights Reserved © Alcatel-Lucent 2008
Page 53
