Alcatel-Lucent OmniPCX Enterprise Communication Server. IP Desktop SoftPhone-For Flex Office Deployment Guide

Legal notice Alcatel, Lucent, Alcatel-Lucent and the Alcatel-Lucent logo are trademarks of Alcatel- Lucent. 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 2009 Alcatel-Lucent. All rights reserved. Page 2

Table of Content 1 INTRODUCTION...4 1.1 The Product...4 1.2 Scope...4 2 INSTALLATION...5 2.1 Requirements for installing...5 2.1.1 Ip Desktop SoftPhone...5 2.1.2 MCDO Server...5 2.1.3 Tomcat Server...5 2.2 Installation...5 2.3 Installation of MCDO and TOMCAT...5 2.3.1 MyMacModifier web service...5 2.3.2 IP Desktop SoftPhone...5 2.4 Installation using: IpDesktopSoftPhoneInst_v9.1.x.x.exe...6 2.5 Installation using: IPdesktopSoftPhone_v9.1.x.x.msi...7 3 USING THE FEATURE... 11 3.1 Configuration of Flex Office parameters...11 3.2 Skin configuration...12 3.3 Starting the IP Desktop SoftPhone...13 3.4 Troubleshooting...14 Page 3

1 Introduction 1.1 The Product The goal is to provide the ability to Real Estate to deploy new way of working for the employees (Teleworkers, Home Office and Flex office in a flexible way). IP Desktop SoftPhone, is improved to emulate Ip Touch 4038 and 4028 hard phones. Ip Desktop SoftPhone when connecting disconnects the hard phone at the office. Even the user has forgotten to log out from his hard phone at the office, he would be able to connect to the voice network through his soft phone. The hard phone should be disconnected when the soft phone is connecting 1.2 Scope This manual covers all activities necessary for installing the application in a PC and provides guidelines to configure it. It also covers all necessary information to create the environment suitable for the installation.. Page 4

2 Installation 2.1 Requirements for installing 2.1.1 Ip Desktop SoftPhone Please refer to IP Desktop SoftPhone administration guide for its installation requirements. 2.1.2 MCDO Server The version to be used is MCDO 1.0.22 2.1.3 Tomcat Server Tomcat version is 5.0.x, Refer to http://wwwcsif.cs.ucdavis.edu/~cs160t/tomcat-tutorial.html for more details. NB : For both MCDO and Tomcat, at least JRE 5 must be installed (refer to http://java.sun.com/javase/downloads/index_jdk5.jsp for more details on JRE installation) 2.2 Installation 2.3 Installation of MCDO and TOMCAT Please refer to their installation documentation for installation details. 2.3.1 MyMacModifier web service Once tomcat installed, the file MyMacAddrModifier.war file must be put under webapps directory of tomcat to install MyMacModifier web service. Once there, Tomcat will activate the service automatically. For example, If Tomcat is installed under C:\Program Files\Apache Software Foundation\Tomcat 5.0, put the file MyMacAddrModifier.war under C:\Program Files\Apache Software Foundation\Tomcat 5.0\webapps 2.3.2 IP Desktop SoftPhone The installation is almost the same as the one described in its admin guide (refer to IP Desktop SoftPhone Administration Guide). We will describe how to fill some parameters added to the installation Page 5

2.4 Installation using: IpDesktopSoftPhoneInst_v9.1.x.x.exe Follolw the steps described in IP Desktop SoftPhone Administration Guide. Before installation ends, you will be asked to fill some parameters. We will explain here how to fill them correctly SCREENSHOT 1 FILL FLEX OFFICE PARAMETERS Pbx main address: refers to main cpu ip address or hostname Pbx backup address: refers to ip address or hostname of a backup CPU Activate Flex Office: check if you are to use the Flex Office feature. Pbx login: login of pbx (mtcl) Pbx password: password of previous login (mtcl) Phone Number: this is an optional field : please fill with the right phone number to be used with IP Desktop SoftPhone Mcdo Server: Ip address or hostname of the server where MCDO is installed Page 6

Mcdo Port: Port of Mcdo server (default value is 43879) Web service URL: URL of MyMacModifier web service. It must be in the following format : http://<tomcat server>:<tomcat port>/mymacaddrmodifier/services/mymacmodifier where <Tomcat server> and <Tomcat Port> must be replaced with the right tomcat server ipaddress or hostname and its http port number. Example : http://135.183.168.16:9090/mymacaddrmodifier/services/mymacmodifier Then click Next, and finish the installation exactly the same as described in IP Desktop SoftPhone Admin Guide. 2.5 Installation using: IPdesktopSoftPhone_v9.1.x.x.msi The following steps detail the installation process, using the file: IPdesktopSoftphone_v9.1.x.x.msi 1. Ensure that hardware, software and networking requirements are in place, as prescribed. 2. Ensure that Microsoft.NET Framework 2.0 is already installed. Otherwise, when you invoke the installation process, the following warning message would display, and the installation process will be aborted: 3. Close all running applications SCREENSHOT 1 Warning message when.net is not installed 4. To start the installation, follow the steps below: 5. Open command prompt screen. You can do this by clicking on: Start Run. In the screen that displays, key in: cmd. This opens the command prompt screen. Page 7

6. Move to the directory, where the file: IPdesktopSoftPhone_v9.1.x.x.msi is located. 7. There, key in the following: msiexec /i IPdesktopSoftphone_v9.1.x.x.msi PBXADDR=<server address> MODEPROACD=<number> LANGUAGE=<Number> ACTIVATEFLEXOFFICE=<activate flex office> PBXLOGIN=<login> PBXPASSWORD=<password> PHONENUMBER=<phone number> MCDOSERVER=<mcdo server> MCDOPORT=<mcdo port> WEBSERVICE=<web service> - Below table explains the different components that constitute this command: Component Description msiexec Microsoft command to execute file with msi extension /i Optional parameter for Status Messages. For more of such options, you can key in the following at command prompt: msiexec /? IPdesktopSoftPhone_v9.1.x.x.msi Name of file that is to be executed. PBXADDR= is the address of PBX server <server address> Address of PBX server MODEPROACD= Page 8

Component Description is the chosen mode (business or ProACD) <number> Here, key in: 0 for Business option 1 for ProACD option LANGUAGE= refers to the interactive language to be used during installation. <number> Give any of the following integers here. The numbers and their related languages are listed below: 4 Generic Alcatel English 5 French 6 Italian 11 German 12 Portuguese 15 Spanish 18 Norwegian 22 Finnish 23 Dutch 24 Russian 40 Chinese 42 Korean ACTIVATEFLEXOFFICE= refers to activating flex office feature Activate flex office 0: do not activate 1: activate PBXLOGIN= Page 9

Component Description refers pbx login login Pbx login (mtcl in general) PBXPASSWORD= refers previous login password password Pbx login password PHONENUMBER= refers the phone number to be used with IP Desktop SoftPhone Phone number The value of phone number MCDOSERVER= refers MCDO server IP address or hostname Mcdo server Value of mcdo server address MCDOPORT= refers to MCDO port number Mcdo port Value of MCDO port number WEBSERVICE= refers to MyMacModifier web service URL Page 10

Component Description Webs service Web service URL value NB :Web service URL must be in the following format : http://<tomcat server>:<tomcat port>/mymacaddrmodifier/services/mymacmodifier where <Tomcat server> and <Tomcat Port> must be replaced with the right tomcat server ipaddress or hostname and its http port number. Example : http://135.183.168.16:9090/mymacaddrmodifier/services/mymacmodifier 8. After keying the command, the installation process would commence, please refer to IP Desktop SoftPhone Administration guide for remaining installation details. 3 Using the feature For the use of IP Desktop SoftPhone, please refer to its users guide document. We will focus here on the use of Flex Office feature. 3.1 Configuration of Flex Office parameters In the Options -> application menu, a new tab is added named Flex Office, this tab offers to the user to configure, if not already done at installation level, the flex office feature parameters Page 11

SCREENSHOT 3 Flex office tab window 3.2 Skin configuration As IP Desktop SoftPhone emulates more than the 4068 Ip touch, the 4038 and the 4028, new skins are added. The skin name indicates witch type of emulation the user chooses. To use IP Desktop SoftPhone as a 4038 phone please choose skins starting with 4038 label. For 4028, please choose skin starting with 4028 label. The other skins refer to 4068 use. Page 12

3.3 Starting the IP Desktop SoftPhone When IP Desktop Starts, if it detects that the extension number the user dialed is not authorized (meaning that remote phone may still use that extension number), a new popup window is shown: SCREENSHOT 4 Flex Office warning message The QMCDU field refers to IP Desktop extension number, filled automatically if already configured. Code is the secret code of previous extension number. The user must click OK to take the identity of that extension number. The operation takes a few seconds; a small rotating icon is shown at the upper right side of the window to show that the request is ongoing. SCREENSHOT 5 Flex office operation ongoing If the operation succeeds, the phone resets and reconnects to OXE with the right identity. Page 13

3.4 Troubleshooting The table below lists some of the problems you could face, along with their remedial measures: # Problem Remedy 1. Connection establishment fails o o o Check if your network connection is enabled. Check that tftp address is correct and make sure you reach it by a ping You may be using the wrong network adapter: check in Network tab using Options Application menu 2. 3. 4. Set is out of service message is shown on IP Desktop SoftPhone screen When applying the Flex Office warning message: an error message appears : Error setting mac address When applying the Flex Office warning message: a long Exception error message appears If you get this during the Installation, then one of the reason could be when the IP-Soft phone Emulation is not activated in the PABX: Ask your administrator to activate it in mgr > Users >Descend Hierarchy > TSC IP Users > Review and Modify >Directory Number (Enter the number of the terminal) > Ctrl+V >Select parameter IP Softphone Emulation > press Enter to change the parameter from NO to YES at PABX side Check that the secret code of your extension number is correct. Check also that MCDO server is started, and has the right Flexlm license Check that tomcat server in started, and that the MyMacAddrModifier service is started (on your internet browser, try to access to : http://<tomcat-server>:<tomcatport>/mymacaddrmodifier/services/mymacmodi fier) Page 14

www.alcatel-lucent.com Page 15