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 <sebawag...@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>