This is an automated email from the ASF dual-hosted git repository.
sebawagner pushed a commit to branch
feature/OPENMEETINGS-2728-update-website-mediaserver-docu-and-banner
in repository https://gitbox.apache.org/repos/asf/openmeetings.git
commit 01ddbefc2c887f2c67ed5fb469d18d20183b5895
Author: Sebastian <sebawag...@apache.org>
AuthorDate: Mon Apr 25 17:31:12 2022 +1200
OPENMEETINGS-2728 Update KMS docu and apachecon banner.
---
.../src/site/markdown/InstallMediaServer.md | 54 ++++++++++++++++++++--
.../src/site/resources/css/site.css | 1 +
openmeetings-server/src/site/resources/js/site.js | 2 +-
openmeetings-server/src/site/xdoc/index.xml | 4 +-
4 files changed, 55 insertions(+), 6 deletions(-)
diff --git a/openmeetings-server/src/site/markdown/InstallMediaServer.md
b/openmeetings-server/src/site/markdown/InstallMediaServer.md
index 3d71f4e8e..73b2ec476 100644
--- a/openmeetings-server/src/site/markdown/InstallMediaServer.md
+++ b/openmeetings-server/src/site/markdown/InstallMediaServer.md
@@ -5,12 +5,60 @@ Licensed under the Apache License, Version 2.0 (the
"License") http://www.apache
# Media Server Installation
## Install Kurento Media server
-
+Each instance of OpenMeetings requires a running Kurento Media Server (KMS).
There is a complete list of installation modes here:
<a
href="https://doc-kurento.readthedocs.io/en/stable/user/installation.html";>Install
Kurento Media server</a>
+
+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.
+
<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>
+
+The quickest and easiest way to run KMS is via Docker. But running the
following commands you can run KMS locally.
+```
+// 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
+```
+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.
+
## Specify/Install Turn server
-<div class="bd-callout bd-callout-warning">Only local installation will work
without TURN server</div>
+<div class="bd-callout bd-callout-warning">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>
+
+See the installation instructions at <a
href="https://doc-kurento.readthedocs.io/en/stable/user/installation.html";>Install
Kurento Media server</a> for the relevant section on CoTurn.
+
+Once installed update the CoTurn relevant sections in the OpenMeetings
configuration:
+```
+################## 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=
+```
+
+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.
+
+## Other installation and configuration resources
+
+See the Wiki for much more detailed and linux distribution specific
instructions: <a
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>
diff --git a/openmeetings-server/src/site/resources/css/site.css
b/openmeetings-server/src/site/resources/css/site.css
index e8f6de2b5..a5011e316 100644
--- a/openmeetings-server/src/site/resources/css/site.css
+++ b/openmeetings-server/src/site/resources/css/site.css
@@ -13,6 +13,7 @@ iframe {
}
.apachecon-banner.bannerRight img {
max-width: 250px;
+ max-height: 80px;
height: initial !important;
}
.bannerRight img, .bannerLeft img {
diff --git a/openmeetings-server/src/site/resources/js/site.js
b/openmeetings-server/src/site/resources/js/site.js
index 328a71146..959c8c260 100644
--- a/openmeetings-server/src/site/resources/js/site.js
+++ b/openmeetings-server/src/site/resources/js/site.js
@@ -27,7 +27,7 @@ $(document).ready(function() {
$('.header .bannerRight').parent().append(
$('<div class="float-right">')
.append($('<a
href="https://www.apache.org/events/current-event"; class="apachecon-banner
bannerRight">')
- .append($('<img
src="https://www.apache.org/events/current-event-234x60.png";>'))
+ .append($('<img
src="https://www.apachecon.com/acna2022/images/banner.png";>'))
)
);
})
diff --git a/openmeetings-server/src/site/xdoc/index.xml
b/openmeetings-server/src/site/xdoc/index.xml
index 4f417c73b..28817076b 100644
--- a/openmeetings-server/src/site/xdoc/index.xml
+++ b/openmeetings-server/src/site/xdoc/index.xml
@@ -139,8 +139,8 @@
<div class="row">
<div class="col-md-1"></div>
<div class="col-md-8">
- <a
href="https://www.apache.org/events/current-event";>
- <img alt="ASF Current
Events" src="https://www.apache.org/events/current-event-234x60.png"/>
+ <a
href="https://apachecon.com/";>
+ <img alt="ASF Current
Events" src="https://www.apachecon.com/acna2022/images/banner.png"/>
</a>
</div>
</div>
![https://www.apache.org/events/current-event-234x60.png"](https://www.apache.org/events/current-event-234x60.png"){kind=link}
![https://www.apachecon.com/acna2022/images/banner.png"](https://www.apachecon.com/acna2022/images/banner.png"){kind=link}
![https://www.apache.org/events/current-event-234x60.png"/](https://www.apache.org/events/current-event-234x60.png"/){kind=link}
![https://www.apachecon.com/acna2022/images/banner.png"/](https://www.apachecon.com/acna2022/images/banner.png"/){kind=link}