Professional Documents
Culture Documents
Troubleshooting Guide Opentouch Conversation PC From R2.2 Onwards
Troubleshooting Guide Opentouch Conversation PC From R2.2 Onwards
2
Troubleshooting Guide
onwards
TG0087 ed07 Release 10.0 and above
This document describes most common problems encountered during installation and usage of OpenTouch Conversation
PC running on Windows environment.
Revision History
Legal notice:
The Alcatel-Lucent name and logo are trademarks of Nokia used under license by ALE. To view other trademarks used by
affiliated companies of ALE Holding, visit: www.al-enterprise.com/en/legal/trademarks-copyright. All other trademarks are the
property of their respective owners. The information presented is subject to change without notice. Neither ALE Holding nor any
of its affiliates assumes any responsibility for inaccuracies contained herein. © 2018 ALE International. All rights reserved.
www.al-enterprise.com
Table of contents
1 Scope ..................................................................................................................................................... 5
2 OTC PC .................................................................................................................................................. 5
2.1 Installation ....................................................................................................................................... 5
2.1.1 Prerequisites............................................................................................................................... 5
2.1.2 Software Overview ...................................................................................................................... 5
2.1.3 Installation problems ................................................................................................................... 6
2.1.3.1 Could not access VBScript run time ...................................................................................................... 6
2.1.3.2 Could not access Jscript run time ......................................................................................................... 6
2.1.3.3 Cache issue........................................................................................................................................ 7
2.1.3.4 ContactsService.exe could not be installed ............................................................................................ 7
2.1.3.5 JSScript issue ..................................................................................................................................... 8
2.1.3.6 DSSourceFilter.dll failed to register ....................................................................................................... 8
2.1.3.7 Update failed with Windows Installer error ...........................................................................................10
2.1.3.8 Error ‘Could not access network location none’ .....................................................................................18
2.2 Traces & Log setting ....................................................................................................................... 18
2.2.1 Silent mode .............................................................................................................................. 18
2.2.2 Install logs ............................................................................................................................... 18
2.2.3 Uninstall logs ............................................................................................................................ 18
2.2.4 Logs files .................................................................................................................................. 19
2.2.4.1 Configuration files .............................................................................................................................19
2.2.4.2 Enable logs OTC PC ...........................................................................................................................20
2.2.4.3 Collecting log files..............................................................................................................................20
2.2.5 Logs Synchro contact ................................................................................................................ 20
2.2.6 Logs Contact Services ............................................................................................................... 20
2.3 Starting and display issues .............................................................................................................. 21
2.3.1 Black screen ............................................................................................................................. 21
2.3.2 Application failed to start with no window .................................................................................. 21
2.3.2.1 Check Process List .............................................................................................................................21
2.3.2.2 Check Graphic Display Driver ..............................................................................................................22
2.3.2.3 Check DirectX installation ...................................................................................................................24
2.3.2.4 Try DirectX 9 compatibility .................................................................................................................25
2.3.2.5 Try OpenGL Mode .............................................................................................................................26
2.3.2.6 Try Software 3D renderer ...................................................................................................................26
2.3.2.7 Take logs with specifics parameters ....................................................................................................26
2.3.3 Application failed to start with a crash ........................................................................................ 27
2.3.3.1 Solution 1: remove OpenTouchConversation data directory ...................................................................27
2.3.3.2 Solution 2: Uninstall program .............................................................................................................27
2.4 OTCv PC display is not good ............................................................................................................ 27
2.4.1 Windows and text are very small ............................................................................................... 27
2.4.2 Font display is not good ............................................................................................................ 27
2.4.3 Error OpenGl when OTC PC is started ........................................................................................ 28
2.5 Crash OTCv .................................................................................................................................... 28
2.6 OTCv PC very slow .......................................................................................................................... 29
2 OTC PC
2.1 Installation
2.1.1 Prerequisites
OTC PC works with Win7/Win8/Win10 32 and 64 bits.
Does not works with Windows XP.
Compliant with Office 2010, 2013 onwards
OT 2.2.x
The OTC PC installation package OpenTouchConversation-2.xx.msi, is available in the DVD OT core (ot-
R2.x-2.iso Clients_software\Windows\OpenTouchConversation )
Services:
ContactsService.exe
Used to synchronize local contacts from Outlook
Symptom:
On some PC during OTC conversation installation there are an error message "Could not access VBScript run
time for custom action”
Diagnosis:
It is Microsoft issue.
Solution:
A Microsoft fix exists.
What this Fix does is to remove incorrect or corrupted registry entries that interfere with VB support in
windows and then re-registers the DLL ensuring that the correct registry settings are there. After running the
Fix it solution you may be able to immediately try the operation that previously gave you the error, but to be
sure, a reboot is suggested. This will address similar issues with other programs as well and not just the
applications that are specifically mentioned in this thread.
Temporary Solution :
Open a command prompt as administrator and run the following commands
reg delete "HKCU\SOFTWARE\Classes\Wow6432Node\CLSID\{B54F3741-5B07-11CF-A4B0-00AA004A55E8}" /f
regsvr32 vbscript.dll
Symptom:
On some PC during OTC conversation installation there are an error message "Could not access Jscript run
time for custom action”
Diagnosis:
It is Microsoft issue.
Solution:
A Microsoft fix exists.
Click on the Start menu, choose Run, type cmd and click OK
To unregister the JScript engine on a 64-bit OS, run this command: reg delete
"HKCU\SOFTWARE\Classes\Wow6432Node\CLSID\{F414C260-6AC0-11CF-B6D1-00AA00BBBB58}" /f
Temporary Solution :
Open a command prompt as administrator and run the following commands
reg delete "HKCU\SOFTWARE\Classes\Wow6432Node\CLSID\{F414C260-6AC0-11CF-B6D1-00AA00BBBB58}"
/f
Symptom:
Outlook deleted contact still found when we search in personal contacts list
Diagnosis:
Contacts from call log and favorites remains in OTCv PC cache
Solution:
Cache mechanism removed in OT 2.0.1
Symptom:
During update process, user is prompt because a file (for example “ContactsService.exe”,
“IMProvider.exe”) that needs to be modified is currently in use.
It needs to be closed and/or stopped
Solution:
- Make sure that Outlook is correctly closed.
Make sure that the user installing the program has administrator privileges.
Stop the windows service “ContactService.exe” if started and chose “Retry”
cd "%systemroot%\System32"
regsvr32.exe /u jscript.dll
cd "%systemroot%\SysWow64"
regsvr32 jscript.dll
After that, you will be prompted to Modify Setup, click on “Repair”, and follow the wizard
At the end of the update process an error message appears. Setup tries to do a rollback but it failed, and
uninstall process will failed with an error. The error message at the end of the update process looks like this:
Something is broken in the installation process, and the most clean process is to restore the previous
installation in order to uninstall it before doing any other installation. Another solution is to uninstall properly
the previous version.
6) Click “Next” button and wait that restoration process is finished (should reboot at least one
time).
7) Save your configuration : backup the file “otc.ini” located in
“%APPDATA%\AlcatelLucent\OpenTouchConversation”
8) Uninstall previous version: got to control panel, and uninstall OpenTouchConversation version.
9) Try to install the new OpenTouchConversation program (who failed to update)
10) Overwrite the otc.ini with the backuped file.
After an update failed, uninstall process of the previous version could failed. Most of the time,
OpenTouchConversation is present in the Windows programs list, but the installation directory
If you haven’t saved the previous MSI, it’s possible to find it in Windows system:
2) Windows store all the MSI currently installed in this directory, but unfortunatly it changes their
name. To find the OpenTouchConversation MSI, sort files by size and localize files with a size
between 66 an 72 Mo.
5) Rename it “OpenTouchConversation.msi”
7) At the end of the repair process, verify that all the files in directory “C:\Program Files
(x86)\Alcatel-Lucent\OpenTouch Conversation” were restored
Symptom:
Impossible to install new release of OTC PC
Diagnosis:
De-installation of former release impossible
Solution1:
Unplug the PC from the network while uninstalling the current release
Solution2:
Use diag tool from Microsoft to clean –up registry
https://support.microsoft.com/en-us/help/17588/fix-problems-that-block-programs-from-being-installed-or-
removed
SIP messages
After each update these files are cleared and regenerated with their original values.
Check that DirectX installation is working correctly. Go to Windows Start Menu, and execute “dxdiag”
command. A Window like this will be opened, verify that in the “Display” tab, DirectDraw and Direct3D
Acceleration are Enabled.
If DirectDraw or Direct3D Acceleration are “Not Available”, program couldn’t start. Some ways to resolve this
issue are:
1. Install again Microsoft DirectX 11
2. Check that graphic display driver is correctly installed and up to date with the last version.
3. Some PC could have more than one graphic display, check all of them
4. Try to run in OpenGL mode (see chapter “1.2.3.6”)
Or
[Settings]
forceOpenGLRenderer=true
Open a Window Console, and set this environment variable before launching the program:
Another way to change the renderer is to modify the file otc.ini located in
“%APPDATA%\AlcatelLucent\OpenTouchConversation” directory. Add a “forceSoftwareRenderer” parameter in
[Settings] section like this.
[Settings]
forceSoftwareRenderer=true
When all of these modes failed, launch OTC PC with specific settings in order to get more logs concerning
display problems.
Open a Window Console, and set these environment variables:
Symptoms:
Application start, Login window is displayed, but application failed and exit (sometimes with a crash).
Symptoms:
On some PC with a high-resolution screen density, OpenTouchConversation Windows and text display may
seem very small.
Solutions:
Create a file called “qt.conf” with this content:
[Platforms]
WindowsArguments = dpiawareness=0
Copy this file in OpenTouchConversation installation directory:
C:\Program Files (x86)\Alcatel-Lucent\OpenTouch Conversation
[Settings]
fontFamily=SimSun
Environment:
OTCPC
Windows 7 32bits
Diagnosis:
Error due to a bad access to directX
Solution:
Checkup directx ( dxdiag )
Modify key ‘AnglePlatform’ ) in the registry ( available from OTC PC 2.3.018 )
Values :
warp: software render
Symptom:
OTCv PC application crashes when accessing on Headset Device modification menu
Environment:
OTCv 2.1.1
Symptom:
Some slowness may occur with OTCv PC on some PCs (e.g. Dell)
Environment:
OTCv 2.1.1
Windows 7, 8.1
Diagnosis:
This is due to the Microsoft “antivirus” used which do a scan each time we write in log file.
EICAR Test
To check that OTC PC logs files are monitored by Antivirus/Antimalware software, go to the
“%APPDATA%\AlcatelLucent\OpenTouchConversation” directory and create a new text file
with this content.
X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*
If the Antimalware/Antivirus Software detect a virus, that means the directory is monitored. In this
case you must write rules to exclude it.
Symptom:
After having logged the OTC PC , a yellow triangle is displayed on the right top of the screen and there is an
error message ‘ telephony services are not available’
No issue when LAN access
Environment:
OTC PC
Windows 7
VPN access through Pulse secure
Diagnosis:
Firewall rules for private/public access not allowed
Solution:
Modify rules dedicated to the application ‘OpenTouch Conversation’
3 Outlook Add-in
Check if add-in is running
If add-in is present in the session Inactive Application Add-ins, activate it by selecting ‘COM Add-
ins’
Solution:
Click the button “Always enable this add-in” of OpenTouch “Conversation add-in”
Restart Outlook
Solution:
1 ) Execute “Regedit” and open the Windows registry key
HKEY_CURRENT_USER\Software\IM Providers
Verify the presence of “DefaultIMApp = OTCPCLyncIMProvider”
Set the key with the right value, and restart Outlook.
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TypeLib\{00062FFF-0000-0000-C000-000000000046}\9.5]
"PrimaryInteropAssemblyName"="Microsoft.Office.Interop.Outlook, Version=15.0.0.0, Culture=neutral,
PublicKeyToken=71E9BCE111E9429C"
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Wow6432Node\TypeLib\{00062FFF-0000-0000-C000-
000000000046}\9.5]
"PrimaryInteropAssemblyName"="Microsoft.Office.Interop.Outlook, Version=15.0.0.0, Culture=neutral,
PublicKeyToken=71E9BCE111E9429C"
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-
18\Components\F30A4287CC821734CB45391DE5CFE1F7]
"00005109A20000000100000000F01FEC"="20:\\TypeLib\\{00062FFF-0000-0000-C000-
000000000046}\\9.5\\PrimaryInteropAssemblyName"
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\TypeLib\{00062FFF-0000-0000-C000-
000000000046}\9.5]
"PrimaryInteropAssemblyName"="Microsoft.Office.Interop.Outlook, Version=15.0.0.0, Culture=neutral,
PublicKeyToken=71E9BCE111E9429C"
Symptom:
After first start-up of outlook it even prevent the application to start and was discarded in the list of disabled
Add-in
Diagnostic :
As plug-in takes a long time to be loaded, it is deactivated by Outlook
Solution:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\Outlook\Addins\Alcat
elLucentOutlookSynchroContacts
When problems happened with Outlook, the first thing to do is to download and execute OffCat
Microsoft tools.
Go to this link: https://www.microsoft.com/en-gb/download/details.aspx?id=36852
- Or Outlook crashes with the following error: « Microsoft Outlook has stopped working »
Solutions:
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TypeLib\{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}\2.8]
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TypeLib\{00062FFF-0000-0000-C000-000000000046}\9.5]
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Wow6432Node\TypeLib\{00062FFF-0000-0000-C000-000000000046}\9.5]
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\TypeLib\{00062FFF-0000-0000-C000-000000000046}\9.5]
Debugging
Firefox
Shift+Ctrl+j or Web Development > Web Console
IE10
F12
5.2 Installation
Link to download it :
https://chrome.google.com/webstore/detail/opentouch-meeting-manager/pppenjemghkogncgkdgoicpfoianjpid
To Install Open Touch Meeting Manager, open Chrome Browser, copy the above link or go to the
Chrome Store Web site, search for “OpenTouch Meeting Manager” and click on the “Free” button.
This application is now visible in the Chrome extension session.
Once installation is done, create a shortcut on the deskstop.
To start the application, click on the shortcut.
5.3 Logs
On ‘Settings’ tab :
7.4 Exception
Symptom:
When starting Microsoft Outlook, an error is raised
“Alcatel-Lucent
OpenTouch Outlook Conference Scheduling Add-in has fired an exception”
Symptom:
When user click on “Start an Audio call” from a Skype contact, an error is raised saying that user
doesn’t have a phone number.
When editing Skype for Business Options, there is no numbers in “Phones” section:
Diagnostic :
Synchronization between Active Directory and Skype user’s database doesn’t keep user phone
number. On Skype server, check events viewer for Lync, you should have a Warning with a link
on the file “Invalid_AD_Phone_Numbers.txt”.
Solution:
Download and install “Skype for Business Address Book Normalisation Tool”:
https://gallery.technet.microsoft.com/Skype-for-Business-Address-2ab65ca7
Exemples:
For internal numbers with 5 digits, the rule looks like :
Priority : 1
Pattern : (\d{5})
Translation : $1
Suppress the user directory sip:username@mail.com to force the update of ABfiles.
OTC.INI :
%appdata%\AlcatelLucent\OpenTouchConversation\otc.ini
Change startAppAtPcLogon=true by startAppAtPcLogon=false
8.3 Logs
8.3.1 Configurations files
%appdata%\AlcatelLucent\OTC4Skype
8.3.2 Logs
%temp%\Alcatel-Lucent\OpenTouchConversation
%ALLUSERSPROFILE%\Alcatel-Lucent\OTCSkypeLaunchServiceLogs
Stop Sametime
Clear logs
%appdata%\IBM\Sametime \logs\error-log-*.xml, trace-log-*.xml
Modify the file
%appdata%\IBM\Sametime\.config\rcpinstall.properties
Add the line
otc4sametime.level=FINEST
Start Sametime
9.1.2 Logs
%appdata%\IBM\Sametime \logs
http://localhost:8089/MyIC/get/page
Result
10.1.2 Logs
twitter.com/ALUE_Care
facebook.com/ALECustomerCare
- END OF DOCUMENT -