MediaSoup

194 views
Skip to first unread message

jhartl...@gmail.com

unread,
Jan 10, 2022, 5:46:31 AM1/10/22
to BigBlueButton-Setup
Morning all,

Can someone explain the steps for using mediasoup?


If I am to understand rightly, for a normal BBB setup, external IP firewalled to internal IP, we would run:

  • yq w -i /etc/bigbluebutton/bbb-webrtc-sfu/production.yml mediasoup.webrtc.listenIps[0].ip "0.0.0.0"
  • yq w -i /etc/bigbluebutton/bbb-webrtc-sfu/production.yml mediasoup.webrtc.listenIps[0].announcedIp $SERVER_IPv4
  • yq w -i /etc/bigbluebutton/bbb-webrtc-sfu/production.yml mediasoup.plainRtp.listenIp.ip "0.0.0.0"
  • yq w -i /etc/bigbluebutton/bbb-webrtc-sfu/production.yml mediasoup.plainRtp.listenIp.announcedIp $SERVER_IPv4

Make all the file changes? or just settings.yml?

Also, wil mediasoup affect anything if we are using enableMultipleKurentos

Thanks

James

Paulo Lanzarin

unread,
Jan 10, 2022, 6:05:34 AM1/10/22
to bigbluebu...@googlegroups.com
 > If I am to understand rightly, for a normal BBB setup, external IP firewalled to internal IP, we would run:

Correct.



Make all the file changes? or just settings.yml?

Just settings.yml should be enough (server wide). Metaparameters are only useful if you want to enable mediasoup
on a per-meeting basis.


> Also, wil mediasoup affect anything if we are using enableMultipleKurentos

No.


--
You received this message because you are subscribed to the Google Groups "BigBlueButton-Setup" group.
To unsubscribe from this group and stop receiving emails from it, send an email to bigbluebutton-s...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/bigbluebutton-setup/5e190495-021d-41d0-8e31-1141ac582061n%40googlegroups.com.

jhartl...@gmail.com

unread,
Jan 10, 2022, 6:28:45 AM1/10/22
to BigBlueButton-Setup
Great thanks :)

and i assume just adding the yq commands to apply-config.sh will be good for upgrading?

Paulo Lanzarin

unread,
Jan 10, 2022, 6:45:14 AM1/10/22
to bigbluebu...@googlegroups.com
> and i assume just adding the yq commands to apply-config.sh will be good for upgrading?

The yq commands are targeted at the /etc/bigbluebutton files which are supposed to be persisted on upgrades.
See: https://docs.bigbluebutton.org/admin/configuration-files.html#local-overrides-for-configuration-settings.

Same goes for the HTML5 settings (/etc/bigbluebutton/bbb-html5.yml).

So apply-config isn't needed.

Vasyl Ostrovskyi

unread,
Jan 31, 2022, 6:08:55 AM1/31/22
to BigBlueButton-Setup
Hi there,
If I have multiple kurentos enabled, do I need to disable them to use mediasoup, or this does not matter?
Regards,
 Vasyl
понеділок, 10 січня 2022 р. о 13:45:14 UTC+2 prlanzarin пише:

Paulo Lanzarin

unread,
Jan 31, 2022, 7:03:50 AM1/31/22
to bigbluebu...@googlegroups.com
> If I have multiple kurentos enabled, do I need to disable them to use mediasoup, or this does not matter?

Doesn't matter.

Paulo Lanzarin

unread,
Jan 31, 2022, 5:39:11 PM1/31/22
to bigbluebu...@googlegroups.com
Or maybe: it doesn't matter, but if you keep it enabled you'll isolate screen sharing recording from webcam recording.
Not a big deal when push comes to shove, but it still adds a bit more robustness after all?
So I suggest just keeping it enabled.

Vasyl Ostrovskyi

unread,
Feb 2, 2022, 3:50:22 AM2/2/22
to BigBlueButton-Setup

Thank you for the explanation. 
I kept multiple kurentos and configured mediasoup. Restarted bbb, and started testing my config.
During the session I opened mutiple browser windows, shared cameras and screens in different modes - all fine.
But there was a problen in recording: one of chunks of screenshare disappeared. Namely, the first screenshare is recorded, then goes some presentation, then next screenshare is NOT recorded - only white screen, then again some presentation, then again screenshare recorded properly. Voice and webcam are recorded OK.
I could not reproduce this issue again after several attempts, so consider it as a random bug. But to be sure, I rolled back to kurento for now (this is my production system).

Regards,
 Vasyl
вівторок, 1 лютого 2022 р. о 00:39:11 UTC+2 prlanzarin пише:

Paulo Lanzarin

unread,
Feb 2, 2022, 6:02:31 AM2/2/22
to bigbluebu...@googlegroups.com
> But there was a problen in recording: one of chunks of screenshare disappeared. Namely, the first screenshare is recorded, then goes some presentation, then next screenshare is NOT recorded - only white screen, then again some presentation, then again screenshare recorded properly. Voice and webcam are recorded OK.

If you're able to, please share the raw recording files.
If you're not able to, please check whether all screenshare raw webm are in there and if all of them have valid media.
Also check events.xml to see if all screen sharing events are in there.
I get rare reports of sporadic failures of that nature (with KMS and mediasoup for all that matters), but without debugging info
it really isn't that easy to track it down.

Vasyl Ostrovskyi

unread,
Feb 2, 2022, 11:27:09 AM2/2/22
to BigBlueButton-Setup
I noticed that the situation is net exacty what I said. In fact, one of screenshares is broken, about 3 of 15 minutes is OK, then blank white.
I carefully examined events.xml, it is good, all events are recorded in proper times.
Raw webm files are also complete, in particular, for the broken screenshare it contains all 15 minutes of proper video (in fact, since some moment, this is a static picture, since the shared tab remained unchanged).
Published directory contains deskshare.webm which is bad, its total length is 15 min, but only 3 mins contain actual video, deskshare.xml looks good.
A brief look at /var/log/bigbluebutton/presentation/process-xxx.log does not show errors from ffmpeg.
Trying bbb-record --rebuild xxx produces the same result with only 3 mins of video.

Maybe the problem is in sharing of static picture for a long time?
Regards,
 Vasyl

середа, 2 лютого 2022 р. о 13:02:31 UTC+2 prlanzarin пише:

Paulo Lanzarin

unread,
Feb 3, 2022, 7:05:09 AM2/3/22
to bigbluebu...@googlegroups.com
>  Maybe the problem is in sharing of static picture for a long time?

Might be. Would you mind sharing the browser you used (+ version), the OS (+version) and what were you sharing
(screen, window or browser tab)?

s,
prlanzarin

Reply all
Reply to author
Forward
0 new messages