Posts in Category "General"

Troubleshooting On-premise Telephony SSL Handshake

The inability to save an audio profile is sometimes caused by a failure of the the ssl connection. Here is an example of a pop-up generated by an ssl handshake error using a telephony adaptor:

ssltel.fw

If the ssl handshake for a telephony adaptor connection fails, check the telephonyservice.conf file in C:\Connect\9.3.1\TelephonyService\conf

Backup the file and find the System properties definitions:

# System property definitions (-D) ( 50 … 99)
wrapper.java.additional.50=-Dapplication.home=..\TelephonyService
wrapper.java.additional.51=-Djava.endorsed.dirs=..\tomcat\bin
wrapper.java.additional.52=-Dcatalina.base=.
wrapper.java.additional.53=-Dcatalina.home=..\tomcat
wrapper.java.additional.54=-Djava.io.tmpdir=.\temp
wrapper.java.additional.55=-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
wrapper.java.additional.56=-Djava.util.logging.config.file=..\tomcat\conf\logging.properties
wrapper.java.additional.57=-Dlibrary.service=WIN32

Add a line if needed:

wrapper.java.additional.58=-Djavax.net.debug=ssl:handshake

Save and restart the Adobe Connect Telephony service.

telephsvc.fw

In this example case an error was found in the Intercall_Adaptor.log; check the log appropriate to the adapter being used \logs\telephony\

logstelephony.fwssltel1.fw

Check the server to server connection (from the Connect server) using the URL in telephony-settings.xml in \TelephonyService\conf\ In this example:

https://iccapi.audiocontrols.net:8443/axis2/services/CCAPI?wsdl

ccapi.fw

Check the TelephonyService.keystore:

  • Connect\9.3.1\TelephonyService\cert
  • Connect\9.3.1\\jre\bin\keytool.exe

keystoredir.fw

From a command prompt (edit install directory location as required):

C:\Connect\9.3.1\jre\bin>keytool -list -v -keystore C:\Connect\9.3.1\TelephonyService\cert\TelephonyService.keystore

Check the cacerts in C:\Breeze\9.3.1\jre\lib\security\cacerts.txt

cacerdir.fw

Compare from a command prompt (edit install directory location as required):

C:\Connect\9.3.1\jre\bin>keytool -list -v -keystore C:\Breeze\9.3.1\jre\lib\security\cacerts.txt

Note: TelephonyService.keystore packaged with Connect expired on Nov 9 2013; this will be updated in version 9.6.

Check the SSL entry in the server.xml file in \Connect\9.3.1\TelephonyService\conf

<Connector port=”9443″ protocol=”HTTP/1.1″ SSLEnabled=”true”
maxThreads=”150″ scheme=”https” secure=”true”
keystoreFile=”${catalina.base}/cert/TelephonyService.keystore” keystorePass=”connect”
clientAuth=”false” sslProtocol=”TLS” URIEncoding=”UTF-8″ />

 The logs for each adaptor are depicted by name: \Connect\logs\telephony\-relevant-adaptor.xx.log

logstelephony.fw

The debug log is also often helpful: \Connect\logs\support\debug.xx.log

debuglog.fw

As is the telephony application log: \Connect\logs\support\apps\_defaultHost_\telephonyProviderTesterApp\instances\7\####\application.xx.log

teltestapplog.fw

Note: As a general rule, when sending logs to Adobe Connect Support for scrutiny of a telephony (or any server-side) issue, it is prudent to send all logs (if allowable) by truncating them to focus on the issue at hand:

  • Stop all services: FMS, FMG, Connect & Telephony
  • Rename or delete all log directories
  • Restart all services and recreate the problem being scrutinized
  • Stop all services and zip complete log directories focused on the issue at hand and provide them to the support consultant

And along those same lines, entire conf directories and custom.ini file can also will help us locate the source of problems as well:

  • C:\Connect\9.3.1\TelephonyService\conf
  • C:\Connect\9.3.1\comserv\win32\conf
  • C:\Connect\9.3.1\comserv\conf
  • \Connect\9.3.1\custom.ini

Troubleshooting FMG On-premise: “Error in joining Audio Conference”

If Flash Media Gateway cannot establish a connection, you may see this pop up message upon invoking Unified Voice: Error in joining Audio Conference:

fmg.fw uvtestfail.fw

 There are a number of potential causes; let’s consider some approaches to troubleshooting:

Restart the FMG service. Check the task manager to make sure that there is not a hanging FMG process. If fmgmain is hanging, terminate it manually through the task manager and then restart the FMG services. Here are the relevant services highlighted:

rel-svcs.fw

Manually check the FMG status from the Connect server  via a browser and telnet:

  • http://fmgIPAddress/2222/admin/getFMGStatus?auser=sa&apswd=fmgpassword

fmgcheck.fw

  • telnet from fmg to the Connect server on 8606 on 2222
  • telnet from the Connect server to fmg on 2222
  • telnet from fmg to sip on 5060
  • Check to see if ports are listening:
    • netstat -an|find “8506”
    • netstat -an|find “2222”

Here is the flow illustrated with an eye toward the Intercall implementation:

Connect_Intercall_FlowSimp

These are the relevant logs for troubleshooting telephony issues; some Connect telephony adaptors leverage FMG:

  • \Flash Media Gateway\2.0.1.19_8x8\log\core.xx.log and master.xx.log, sip.xxxx.log

fmglogdir.fw

  • \Connect\logs\telephony\-relevant-adaptor.xx.log

logstelephony.fw

  • \Connect\logs\support\debug.xx.log

debuglog.fw

  • \Connect\logs\support\apps\_defaultHost_\telephonyProviderTesterApp\instances\7\####\application.xx.log

teltestapplog.fw

Note: When sending logs to Adobe Connect Support for scrutiny of a telephony (or any server-side) issue, it is generally prudent to send all logs if allowable by truncating them to focus on the issue at hand:

  • Stop all services: FMS, FMG, Connect & Telephony
  • Rename or delete all log directories
  • Restart all services and recreate the problem being scrutinized
  • Stop all services and zip complete log directories focused on the issue at hand and provide them to the support consultant

And along those same lines, the entire /conf/ directories, all four zipped will help us locate errors as well:

  • C:\Connect\9.3.1\TelephonyService\conf
  • C:\Flash Media Gateway\2.0.1.19\conf
  • C:\Connect\9.3.1\comserv\win32\conf
  • C:\Connect\9.3.1\comserv\conf

Relevant configuration files for troubleshooting may include:

  • \Flash Media Gateway\2.0.1.19_8x8\conf\sip.xml, rtmp.xml, http.xml, workflow.xml

fmgconfdir.fw

  • \Connect\9.3.1\TelephonyService\conf\telephony-settings.xml, server.xml

telconf.fw

  • \Connect\9.3.1\custom.ini

customdir.fw

FMG connection settings are configurable in the console on port 8510 on the Connect server. While it is recommended that FMG be installed and run on a separate server, in some cases, it is collocated with Connect. Check to make sure there are not two instances of FMG where only one is needed. This is possible as when distributing FMG onto a separate server as appropriate in a robust clustered environment, an oversight may be to leave it also installed locally on the Connect server as well:

fmg8510.fw

Delete superfluous instances and disable any local unneeded FMG service.

fmg85101.fw

  fmgsvc.fw

Troubleshooting On-premise Server Upgrade error: could not find public key

Upon upgrade, if you choose a new installation directory (such as changing a breeze directory to a connect directory) and then cannot start the Connect services, check the debug log for the following error message:

[07-28 09:19:39,957] cps-startup (ERROR) ConfigProperty.initPublicKey(), could not find publickey in C:\breeze\9.3.1\appserv\keys\

There is a database entry in the pps_config table that corresponds to the \appserv\keys\ directory. You may need to manually edit it:

select * from PPS_CONFIG where NAME = ‘config-keys-path’

upgrdkey.fw

upgrdkey1.fw

Find the actual location of the \appserv\keys\ directory and make sure the database points to it:

upgrdkey1a.fw

upgrdkey1b.fw

After updating pps_config, attempt to start the services and gain access to the console.

Firefox May Prevent Connect Access

Firefox may automatically prevent access to Connect:

ff-update1.fw

To resolve this issue, update Flash Player to the latest patch: http://get.adobe.com/flashplayer

Event Template does not show data, blank white page appears

Problem:
Event template, Event catalog or Email template doesn’t load in iFrame rather gets displayed as blank white page.

Description:
When we click on Event Management -> Event Template or Event Catalog or Email Template, we get a white page in the area where the Event Template data should have been visible.

Reason:
This issue occurs if Adobe connect is running on SSL (HTTPS), however, CQ is not running on SSL. Hence the data coming from CQ is not secured. When secure and unsecure data is received by the browser over a secure connection, it is called Mixed content. Every browser has a setting where it usually blocks mixed content i.e. un-encrypted data coming from CQ gets blocked.

The page usually appears as shown below:

Event Template does not show any data

You may also get a prompt depending on the settings of Internet Explorer.

Internet Explorer 7 or earlier

Display Mixed content IE_Old

Internet Explorer 11

Prompt to display Mixed content

Prompt to display Mixed content at Bottom of Page

 

Solution:

It is possible to change this behavior of a browser where it allows mixed data and displays data sent without securing it over a connection which is secured using SSL.

Below steps allow us to modify this behavior:

Internet Explorer:
Internet Option -> Security -> Custom Level -> Display Mixed content -> Enable;

Enable Mixed Content in Internet Explorer

Google Chrome:
Click the shield icon on top right -> Click “Load unsafe scripts”;

Enable Mixed content in Google Chrome

 

Mozilla Firefox:
Click the shield icon on top left -> Under “Insecure content” -> “Disable protection for now” ;

Enable Mixed content in Mozilla Firefox

These are the basic steps to fix this problem. Depending on the permission on the account, you may or may not be able to make these changes.

 

Adobe connect Add-in crashes / freezes on Windows 8.1

Problem:
Adobe connect add-in freezes on Windows 8.1 machine while meeting is running.

Description:
It freezes / crashes during the meeting usually around 20 minutes of screen sharing or camera sharing. Sometimes, the issue occurs randomly as well.

Reason:
This is a know issue and it has been documented in our bug tracking system. It is targeted to be fixed in the upcoming version.

Workaround:
We can configure Adobe connect add-in to run in Windows 7 compatibility mode. Follow the steps mentioned below:

• Go to the below location on your computer:
“%userprofile%\AppData\Roaming\Macromedia\Flash Player\www.macromedia.com\bin\adobeconnectaddin”;

• If you are unable to find this location, open a meeting room which should launch Adobe connect add-in;

• Open windows task manager and select Adobeconnectaddin.exe from the list of processes running on the machine;

• Right click and choose open location;

• This shall take you to the location where Adobeconnectaddin.exe (Adobe connect’s add-in) is installed;

• This file shall be present at “C:\Users\<userprofilefolder>\AppData\Roaming\Macromedia\Flash Player\www.macromedia.com\bin\adobeconnectaddin”;

Location of Adobe connect addin

• Right click on Adobeconnectaddin.exe and choose properties;

• Switch to Compatibility;

• Select the compatibility mode, click Apply, OK as shown below;

Adobe connect addin compatibility mode

• Close the existing instances of Adobe connect add-in;

• Once the previous instances have been closed, Adobe connect add-in should start getting executed in Compatibility mode;

The above mentioned steps should fix this problem.

Troubleshooting Verbose Meeting Addin Logging

On occasion it can be difficult to get verbose addin logging to work. The tech-note describing how to set it up is here: Enable logging | Meeting Add-in

The tech-note correctly describes where to place the customized mms.cfg file for use with both 64 bit and 32 bit Windows clients as well as for the Mac OS.

If after following the instructions in the tech-note, you still do not see any verbose addin logs, one possible cause is that there may be an additional mms.cfg file in an alternate location on the client that is blocking the log creation process. To remedy this, add the customized debug mms.cfg to the following locations after renaming any existing mms.cfg files (to allow them to be restored after verbose logging or debugging is complete):

Here are the locations (more than in the tech-note):

  • Windows (32 bit) :

In: C:\Windows\System32\Macromed\Flash\mms.cfg
or C:\Windows\System32\mms.cfg

  • Windows 7 (64 bit):

In: c:\Windows\SysWOW64\Macromed\Flash\mms.cfg
or c:\Windows\SysWOW64\mms.cfg

After placing the mms.cfg in both folders, be sure to close all addin browsers and then to open the addin only in the one Meeting that you wish to troubleshoot.

MP4 Recording Conversion Update

MP4 recording conversion functionality was recently unavailable for all Adobe Connect Hosted Accounts.

Note: Offline FLV recording conversion was unaffected and remains fully operational.

Update: 09 July

There is a workaround in place, as of 10:30 EST, to get the MP4 conversions back on track. Any job that was submitted prior to this may continue to throw an error to the user in the web app. Here is the way ahead:

• If you submitted a job this morning and the web app shows a conversion error, re-submit the job
• The queue is very long right now and it may take longer than normal for the conversions to finish.
• If you recently submitted a job, within the last hour or so, report all any new problems to the adobe support team.

Terms of Service Notification on Adobe Connect Hosted Accounts

Changes made to the Adobe Connect Terms and Conditions (ToS) in Connect 9.4 are related to the new licenses introduced in Adobe Connect 9.4. Note that the first administrative login will be presented with the ToS dialog. If the first administrative login is an automated API call, this call will fail until the ToS dialog is manually cleared.

22.6: “Named Virtual Classroom Manager” means an individual that has the ability to host a Meeting in a Virtual Classroom, track user completion and course results for Meeting Attendees in Virtual Classrooms, and manage advanced registration, branded event pages, and email options. A Named Virtual Classroom Manager is a type of On-demand User.

22.7: “Named Webinar Manager” means an individual that has the ability to host a Meeting with Meeting Attendees up to the number of seats purchased, as well as manage advanced registration, branded event pages, email options, and reporting.  A Named Webinar Manager is a type of On-demand User.

The new licensing options were also added to sections 2.1, 3 and 19, and 20.  Similarly, in line with the new licensing, we also exchanged the term ‘seminar’ for ‘webinar’ in several locations.

For more information on Adobe Connect 9.4, see http://blogs.adobe.com/adobeconnect/2015/03/introducing-9-4-2.html.

Meeting Hosts and Concurrent Attendee Licensing Model

Although, using the Named Hosts licensing model, there are restrictions to assigning meeting hosts to rooms, there are fewer restrictions with the Concurrent Attendee licensing model.

In the Concurrent Attendee model, it is possible to assign participants as host in a room who are not members of the Meeting Hosts group. As there is no limit in the number of meeting hosts allowed with this licensing model, there are no restrictions to the number of users who are assigned as host in a room (whether or not they are member of the Meeting Hosts group), as long as the total number of concurrent users of all types does not exceed the license limit for the account.

With the Named Hosts licensing model, only users who are member of the Meeting Hosts group may be assigned as host in the web interface.