You are here: Diagnostics > Platform troubleshooting

Troubleshooting the Pexip Infinity platform

This section contains a list of symptoms, possible causes and suggested resolutions for some issues you may experience when using the Pexip Infinity platform.

It includes the following sections:

Pexip Infinity deployment and upgrading
Pexip Infinity administration
Joining a conference and viewing content
Infinity Connect clients

Help in resolving LDAP-specific issues is contained in a separate topic: Troubleshooting LDAP server connections.

Help in resolving Lync/Skype for Business issues is contained in a separate topic: Troubleshooting and limitations with Lync / Skype for Business and Pexip Infinity.

Pexip Infinity deployment and upgrading

Symptom	Possible cause	Resolution
During upgrade, one or more Conferencing Nodes are stuck with a status of "waiting for calls to clear", but there are no active calls reported on the Management Node.	A bug in v3 of the software means that in some circumstances a SIP call will not clear properly from the Conferencing Node.	Reboot the Conferencing Node.
During automatic deployment of a Conferencing Node using VMware, the following message is given: "Server raised fault: 'Current license or ESXi version prohibits execution of the requested operation.'"	You are using a version of VMware that does not support use of the VMware API, which is required for automatic deployment of Conferencing Nodes.	Either: Upgrade your VMware deployment to one that supports the VMware API. For more information, see VMware editions. Deploy the Conferencing Node manually. For more information, see Manually deploying a Conferencing Node on an ESXi host.
An automatic deployment of a Conferencing Node using vCenter as the VM manager fails at 22%.	During automatic deployment, the Management Node uploads the VM image directly to the ESXi host using HTTPS on port 443/TCP. If this port is not accessible, the upload will fail.	Ensure that all ESXi hosts on which Conferencing Nodes are being deployed are accessible from the Management Node using HTTPS on port 443/TCP.
A Conferencing Node does not accept calls even though it is powered on and is contactable on the network.	If time is not properly synchronized between the Management Node and the host server, certificates issued by the Management Node may be invalidated by Conferencing Nodes within the same Pexip Infinity deployment. As a result, the Conferencing Nodes will not communicate properly with the Management Node, causing calls to fail.	Ensure all virtual machines (VMs) (i.e. the Management Node and all Conferencing Nodes) within the Pexip Infinity platform, and the host servers on which they are running, are using accurate times according to the public or private standard NTP clock. We strongly recommend that you configure at least 3 distinct NTP servers or NTP server pools in each instance to ensure proper synchronization. To synchronize time on Pexip Infinity: Synchronize time on host servers (for instructions see Hypervisor configuration). Enable NTP on Management Node. Reboot all VMs.
A newly deployed Conferencing Node does not accept calls and its last contacted status on the Management Node shows "Never", even though it is powered on and is contactable on the network.	After deploying a new Conferencing Node, it typically takes 15-20 minutes before the node is available for conference hosting and for its status to be updated on the Management Node. (Until it is available, the Management Node will report the status of the Conferencing Node as having a last contacted and last updated date of "Never".)	Wait 15-20 minutes for the Conferencing Node to finish initializing.
I entered the wrong information while running the installation wizard.		Re-run the installation wizard by following the instructions in Re-running the installation wizard.
A new Management Node or Conferencing Node does not work. It was created by cloning it through VMware.	You cannot use cloning to create Management Nodes and Conferencing Nodes.	Create all Management Nodes according to the instructions in Installing the Management Node. Create all Conferencing Nodes by following the instructions in Deploying new Conferencing Nodes.
Your system experiences random node crashes and a wedged VM. A kernel backtrace on the system console reports the instruction pointer (RIP) as being within "move_freepages".	Crashes can occur if the amount of main system RAM allocated to the Management Node or a Conferencing Node is not a multiple of 2 MB.	Ensure that the amount of main system RAM allocated to the Management Node or a Conferencing Node is a multiple of 2 MB. One way to achieve this is by configuring your VM with 8 MB of video RAM (VRAM). Refer to your specific hypervisor documentation for how to do this.

Pexip Infinity administration

Symptom	Possible cause	Resolution
Log timestamps appear to be inaccurate or log entries appear to be out of sequence.	Time is not properly synchronized between the Management Node, Conferencing Nodes and their host servers, causing different systems to use different timestamps. This could be because: Insufficient NTP servers or NTP pools have been configured on a host server or the Management Node (we recommend a minimum of 3). One or more NTP servers are unreachable or have inaccurate time themselves. NTP is otherwise not configured according to our recommendations.	Ensure all virtual machines (VMs) (i.e. the Management Node and all Conferencing Nodes) within the Pexip Infinity platform, and the host servers on which they are running, are using accurate times according to the public or private standard NTP clock. We strongly recommend that you configure at least 3 distinct NTP servers or NTP server pools in each instance to ensure proper synchronization. To synchronize time on Pexip Infinity: Synchronize time on host servers (for instructions see Hypervisor configuration). Enable NTP on Management Node. Reboot all VMs.
How do I register Pexip Infinity to a gatekeeper?		You don't. Instead, you configure your call control system to route calls to Pexip Infinity. See Call control.
Oracle Acme Packet SBC has the error "Message Too Large".		Increase the following configuration parameters on the Acme Packet SBC: `sip-message-len 16000` `option +max-udp-length=0`
VMware datastore is showing disk I/O alarms.		Enabling SIOC on your datastores might help. For more information, see this VMware knowledge base article.

Joining a conference and viewing content

Symptom	Possible cause	Resolution
Participants cannot join a conference due to insufficient capacity. When users attempt to join a conference they get a message saying "Participants cannot join a conference due to insufficient capacity." There is an alarm "Call capacity limit reached". The admin log is reporting "Participant failed to join conference" and "resource unavailable".	All Conferencing Nodes that are able to take the media for this call are at capacity.	Deploy more Conferencing Nodes in this location. Move existing Conferencing Nodes onto more powerful servers. Allocate more virtual CPUs for Conferencing Nodes on existing servers (if there are sufficient CPU cores). Note that the Conferencing Node will have to be rebooted for this to take effect. Configure each location with a primary and secondary overflow location.
	The participant has dialed in to the Conferencing Node while it is still starting up and an internal capacity-checking tool is running.	The Administrator should place the Conferencing Node into maintenance mode if it is expected to be powered off and on. If the Conferencing Node is not in maintenance mode while the capacity-checking tool is running the participant should wait a few moments and then attempt to join the conference.
Participants cannot join a conference due to an invalid license. When users attempt to join a conference they get a message saying "Participants cannot join a conference due to an invalid license." The admin log is reporting "Participant failed to join conference" and "no valid license available".	The license has not been activated. The existing license has expired. The existing license has become corrupt. For more information, see Pexip Infinity license installation and usage.	Check the status of your licenses from the Licensing page (Platform configuration > Licenses). Contact your authorized Pexip representative for assistance.
Participants cannot join a conference due to insufficient licenses. When users attempt to join a conference they get a message saying "Participants cannot join a conference due to insufficient licenses." There is an alarm saying "License limit reached". The admin log is reporting "Participant failed to join conference" and "license limit reached".	There are not enough port licenses available on the system at this time. For more information, see Pexip Infinity license installation and usage.	Wait until one or more of the existing conferences have finished and the licenses have been returned to the pool. Contact your authorized Pexip representative to purchase more licenses.
An H.323 endpoint has its bandwidth restricted when joining a conference via a Virtual Reception, or when placing a call using the Distributed Gateway after first connecting to a Virtual Reception.	If there has been a bandwidth restriction placed on the Virtual Reception, any H.323 endpoints using that service will not be able to subsequently increase their bandwidth, even after being transferred to a Virtual Meeting Room or using a Gateway Routing Rule that has a higher (or no) limit.	Make the call using a SIP endpoint or Infinity Connect client. Do not place a bandwidth restriction on the Virtual Reception.
Presentations do not display full screen	If the presentation being shared is either: an application that is not in full-screen mode a full screen image that is being sent from a non-standard aspect ratio screen then the image being sent may have a non-standard aspect ratio. In order to send the image inside a standard resolution window (for example 640x480 [4:3]) or 1280x720 [16:9]), the endpoint may add horizontal or vertical mattes (also known as letterboxing or pillarboxing respectively).	Ensure that presenters always either: share their entire screen, or share individual applications when they are in full-screen mode only.
Images are not displaying as expected: they are being cropped they have black bars at the top or sides	Endpoints send and display video images and presentations in various aspect ratios, most commonly 16:9 and 4:3. If there is a difference between the aspect ratios of the sending and receiving endpoints, then the endpoint and/or Pexip Infinity may crop the image or add vertical or horizontal mattes.	For more information, see Changing aspect ratios.
Participants keep hearing themselves repeated back after a short delay. This happens in a conference with one or more other participants connected using Infinity Connect via Internet Explorer or Firefox, and who are using their computer's microphone and speakers.	Internet Explorer and Firefox do not have adequate echo cancellation, and in certain circumstances may experience a delay in playing audio. When this happens, sounds played through the computer's speakers are picked up by the computer's microphone and replayed back to other participants.	Participants on IE or Firefox should use a headset. Participants on IE or Firefox should mute themselves when not speaking. Participants on IE or Firefox should consider using Chrome or the Infinity Connect desktop client instead.
Users can't enter a conference PIN from a T150 running L5.1.	There was a bug in the L5.1 software which meant that DTMF tones weren't being sent properly over SIP.	Do one of the following: upgrade the T150 to L6.1 use H.323 (not SIP) interwork to SIP via a VCS.
In-band DTMF tones may not be detected if they are input too quickly.	False detections can be caused, for example, by poor line quality, line noise and echo.	This is best resolved through using out-of-band DTMF tones.
A Cisco MXP intermittently puts a call on hold immediately after resuming it.	This is due to a bug in the MXP where a race condition exists between the resume message and the session refresh re-INVITE message.	Set the session refresh configuration on your call control system to a value that avoids this race occurring.
After upgrading to version 10 or later, some Cisco MXPs may no longer be able to connect over TLS to Pexip Infinity.	This can occur if the endpoint connects directly to a Conferencing Node (e.g. because it is registered to Pexip Infinity, or it is using IP dialing).	Please contact support@pexip.com if you experience this issue.

Infinity Connect clients

Symptom	Possible cause	Resolution
Participants are unable to use Infinity Connect clients. Infinity Connect Web App and Infinity Connect desktop client users are presented with a message "Server error! Please try again".	Support for these applications has been disabled.	Enable support as follows: Go to Platform configuration > Global settings. Select the Enable support for Pexip Infinity Connect and Mobile App checkbox.
Participants using an Infinity Connect client cannot see the chat window.	Chat has been globally disabled.	Enable chat.
Guest participants using an Infinity Connect client cannot see the chat window, participant list, or presentation.	Guest participants are not allowed in to the conference if the conference is locked, or until the first Host participant has joined. There must be at least one Host participant sending media (i.e. connected using video or audio) in order for Guests to join the conference.	Allow an individual guest to join the conference. Unlock the conference, allowing all guests to join. Connect at least one endpoint to the conference as a Host participant, with video or audio.
Users cannot access the Infinity Connect Web App home page when using Internet Explorer.	Internet Explorer may be accessing the site in Compatibility View.	Ensure that the target domain is not in Internet Explorer's list of websites added to Compatibility View.
Users of the Infinity Connect Web App via Edge, Internet Explorer or Safari get no main video when connecting to a conference via a reverse proxy. Other conference participants see a muted camera icon in place of the participant's video.	To send and receive audio/video media, Internet Explorer, Edge, and Safari browsers need a direct TCP connection to a Conferencing Node (as they use the RTMP protocol and thus cannot use ICE/TURN). For more information, see Using Infinity Connect from outside your network.	Connect over VPN. Use a different browser.