You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openmeetings.apache.org by se...@apache.org on 2022/04/26 08:55:41 UTC
[openmeetings-site] branch master updated: OPENMEETINGS-2728 Update Media Server config.
This is an automated email from the ASF dual-hosted git repository.
sebawagner pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/openmeetings-site.git
The following commit(s) were added to refs/heads/master by this push:
new 5dbf2ab1 OPENMEETINGS-2728 Update Media Server config.
5dbf2ab1 is described below
commit 5dbf2ab1977d5db68c07d71bd15c11b441408901
Author: Sebastian Wagner <se...@apache.org>
AuthorDate: Tue Apr 26 20:53:22 2022 +1200
OPENMEETINGS-2728 Update Media Server config.
---
InstallMediaServer.html | 58 ++++++++++++++++++++++++++++++++++++++++++++-----
1 file changed, 52 insertions(+), 6 deletions(-)
diff --git a/InstallMediaServer.html b/InstallMediaServer.html
index 7165d741..91ab3ea3 100644
--- a/InstallMediaServer.html
+++ b/InstallMediaServer.html
@@ -3,7 +3,7 @@
<!doctype html>
<!--
- Generated by Apache Maven Doxia at 2021-10-26 Rendered using Reflow Maven Skin 2.3.0 (http://devacfr.github.io/reflow-maven-skin)
+ Generated by Apache Maven Doxia at 2022-04-26 Rendered using Reflow Maven Skin 2.3.0 (http://devacfr.github.io/reflow-maven-skin)
-->
<html xml:lang="en" lang="en">
<head>
@@ -215,7 +215,7 @@
<main class="col-xs-12 col-sm-12 col-md-12 col-lg-12 col-xl-8" role="main">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
- <li class="publishDate version-date"> Last Published: 2021-10-26</li>
+ <li class="publishDate version-date"> Last Published: 2022-04-26</li>
</ol>
</nav>
<!--
@@ -226,16 +226,59 @@ Licensed under the Apache License, Version 2.0 (the "License") http://www.apache
</div>
<section>
<h2 id="install-kurento-media-server">Install Kurento Media server</h2>
- <p><a class="externalLink" href="https://doc-kurento.readthedocs.io/en/stable/user/installation.html">Install Kurento Media server</a></p>
+ <p>Each instance of OpenMeetings requires a running Kurento Media Server (KMS). There is a complete list of installation modes here: <a class="externalLink" href="https://doc-kurento.readthedocs.io/en/stable/user/installation.html">Install Kurento Media server</a></p>
+ <p>The default config of OpenMeetings and Kurento Media Server is a 1:1 mapping. Each OpenMeetings instance is mapped exactly to 1 KMS instance as well as OpenMeetings and KMS running on the same host.</p>
<div class="bd-callout bd-callout-danger">
- It should be run under same user as OM
+ If running on the same host OpenMeetings and KMS should be run under same user.
</div>
+ <p>The quickest and easiest way to run KMS is via Docker. But running the following commands you can run KMS locally.</p>
+ <div>
+ <pre><code>// for example /home/$user/work/openmeetings
+export OM_HOME=$YOUR_PATH
+// for example export OM_HOME=/Users/wagns1/Documents/apache/openmeetings/_REPO/openmeetings/openmeetings-web/target/openmeetings-web-5.0.0-M5-SNAPSHOT
+
+docker run -v $OM_HOME/data:$OM_HOME/data -p 8888:8888 kurento/kurento-media-server
+</code></pre>
+ </div>
+ <p>Assuming OpenMeetings runs on your machine locally above will work without any config changes in OpenMeetings and is the most common way to spin up a development environment.</p>
</section>
<section>
<h2 id="specifyinstall-turn-server">Specify/Install Turn server</h2>
<div class="bd-callout bd-callout-warning">
- Only local installation will work without TURN server
+ Only local installation will work without TURN server - also you require a valid SSL certificate for doing webRTC Audio/Video for anything other then local installations
</div>
+ <p>See the installation instructions at <a class="externalLink" href="https://doc-kurento.readthedocs.io/en/stable/user/installation.html">Install Kurento Media server</a> for the relevant section on CoTurn.</p>
+ <p>Once installed update the CoTurn relevant sections in the OpenMeetings configuration:</p>
+ <div>
+ <pre><code>################## Kurento ##################
+kurento.ws.url=ws://127.0.0.1:8888/kurento
+kurento.turn.url=
+kurento.turn.user=
+kurento.turn.secret=
+kurento.turn.mode=rest
+## minutes
+kurento.turn.ttl=60
+## milliseconds
+kurento.check.timeout=10000
+## milliseconds
+kurento.object.check.timeout=200
+kurento.watch.thread.count=10
+kurento.flowout.timeout=5
+## please ensure this one is unique, better to regenerate it from time to time
+## can be generated for ex. here https://www.uuidtools.com
+kurento.kuid=df992960-e7b0-11ea-9acd-337fb30dd93d
+## this list can be space and/or comma separated
+kurento.ignored.kuids=
+## See https://doc-kurento.readthedocs.io/en/latest/features/security.html#media-plane-security-dtls
+## possible values: RSA, or ECDSA (capital-case)
+kurento.certificateType=
+</code></pre>
+ </div>
+ <p>in your local $OM_HOME/webapps/openmeetings/WEB-INF/classes/openmeetings.properties file. A server restart is required in order for changes to take affect.</p>
+</section>
+<section>
+ <h2 id="other-installation-and-configuration-resources">Other installation and configuration resources</h2>
+ <p>See the Wiki for much more detailed and linux distribution specific instructions: <a class="externalLink" href="https://cwiki.apache.org/confluence/display/openmeetings/tutorials+for+installing+openmeetings+and+tools"></a><a class="externalLink" href="https://cwiki.apache.org/confluence/display/openmeetings/tutorials+for+installing+openmeetings+and+tools">https://cwiki.apache.org/confluence/display/openmeetings/tutorials+for+installing+openmeetings+and+tools</a></p>
</section> </main>
<div class="d-none d-sm-none d-md-none d-lg-none d-xl-block col-xl-2">
<div id="m-toc-sidebar" class="d-print-none m-toc-sidebar-enabled m-toc-sidebar-expanded m-toc-sidebar-autoexpandable toc-sidebar-fixed">
@@ -249,6 +292,9 @@ Licensed under the Apache License, Version 2.0 (the "License") http://www.apache
</li>
<li class="h2">
<a class="nav-link" href="#specifyinstall-turn-server" title="Specify/Install Turn server">Specify/Install Turn server</a>
+ </li>
+ <li class="h2">
+ <a class="nav-link" href="#other-installation-and-configuration-resources" title="Other installation and configuration resources">Other installation and configuration resources</a>
</li>
</ul>
</nav>
@@ -325,7 +371,7 @@ Development
<div class="container subfooter text-center">
<div class="row">
<div class="col-md-12">
- <p class="copyright">Copyright ©2012-2021
+ <p class="copyright">Copyright ©2012-2022
<a href="https://apache.org">Apache Software Foundation</a>
. All Rights Reserved.</p>
</div>