Author: solomax
Date: Fri Mar 30 17:53:03 2012
New Revision: 1307556
URL: http://svn.apache.org/viewvc?rev=1307556&view=rev
Log:
RTMPS documentation is updated with correct steps
Modified:
incubator/openmeetings/trunk/singlewebapp/docs/RTMPSAndHTTPS.html
incubator/openmeetings/trunk/singlewebapp/xdocs/RTMPSAndHTTPS.xml
Modified: incubator/openmeetings/trunk/singlewebapp/docs/RTMPSAndHTTPS.html
URL:
http://svn.apache.org/viewvc/incubator/openmeetings/trunk/singlewebapp/docs/RTMPSAndHTTPS.html?rev=1307556&r1=1307555&r2=1307556&view=diff
==============================================================================
--- incubator/openmeetings/trunk/singlewebapp/docs/RTMPSAndHTTPS.html (original)
+++ incubator/openmeetings/trunk/singlewebapp/docs/RTMPSAndHTTPS.html Fri Mar
30 17:53:03 2012
@@ -34,11 +34,8 @@ limitations under the License.
<meta name="email" value="[email protected]">
-
-
-
-
-
+
+
<title>Apache OpenMeetings - Using OpenMeetings with RTMPS and
HTTPS</title>
<link rel="stylesheet" type="text/css" href="css/openmeetings.css">
<link rel="stylesheet" type="text/css" href="css/jquery-ui.css">
@@ -863,18 +860,18 @@ limitations under the License.
<tr><td>
<blockquote>
<p>There are 3 ways the client
communicates with the server: </p>
- <ul>
- <li>The flash-client uses RTMP protocol to
transfer Audio/Video and
- to send and receive the user data
(login et cetera) to the server
- and back
- </li>
- <li>The browser uses HTTP protocol to load the
SWF and to upload and
- download the files (documents, pdfs,
images) to the server and
- back.
- </li>
- <li>The screensharing client uses RTMP protocol
to transfer screen
- data and remote control to the server
and back
- </li>
+ <ul>
+ <li>The flash-client uses RTMP protocol to
transfer Audio/Video and
+ to send and receive the user data
(login et cetera) to the server
+ and back
+ </li>
+ <li>The browser uses HTTP protocol to load the
SWF and to upload and
+ download the files (documents, pdfs,
images) to the server and
+ back.
+ </li>
+ <li>The screensharing client uses RTMP protocol
to transfer screen
+ data and remote control to the server
and back
+ </li>
</ul>
</blockquote>
</p>
@@ -890,17 +887,17 @@ limitations under the License.
</td></tr>
<tr><td>
<blockquote>
- <ul>
- <li>You need OpenMeetings 1.9.x for this,
OpenMeetings 1.8.x does
- not
- have those options.
- </li>
- <li>Install OpenMeetings according to the
install instructions and
- check that it runs without problems
- </li>
- <li>Rename the existing keystore file
red5/conf/keystore to
- keystore.bak
- </li>
+ <ul>
+ <li>You need OpenMeetings 1.9.x for this,
OpenMeetings 1.8.x does
+ not
+ have those options.
+ </li>
+ <li>Install OpenMeetings according to the
install instructions and
+ check that it runs without problems
+ </li>
+ <li>Rename the existing keystore file
red5/conf/keystore to
+ keystore.bak
+ </li>
</ul>
</blockquote>
</p>
@@ -916,58 +913,58 @@ limitations under the License.
</td></tr>
<tr><td>
<blockquote>
- <ol>
- <li>
- Create a new keystore and key, use the
same password for both:<br />
- (copied from
- <a
href="http://trac.red5.org/wiki/Documentation/Tutorials/Red5DeveloperTips/SSLTLS%29:";
rel="nofollow">http://trac.red5.org/wiki/Documentation/Tutorials/Red5DeveloperTips/SSLTLS):</a>
- <div class="xmlcode">
- keytool -keysize 2048 -genkey
-alias red5 -keyalg RSA -keystore red5/conf/keystore<br />
- Enter keystore password:<br />
- Re-enter new password:<br />
- What is your first and last
name?<br />
- [Unknown]: <your hostname,
e.g demo.openmeetings.de><br />
- What is the name of your
organizational unit?<br />
- [Unknown]: Dev<br />
- What is the name of your
organization?<br />
- [Unknown]: OpenMeetings<br />
- What is the name of your City
or Locality?<br />
- [Unknown]: Henderson<br />
- What is the name of your State
or Province?<br />
- [Unknown]: Nevada<br />
- What is the two-letter country
code for this unit?<br />
- [Unknown]: US<br />
- Is CN=demo.openmeetings.de,
OU=Dev, O=OpenMeetings, L=Henderson, ST=Nevada, C=US correct?<br />
- [no]: yes<br />
- Enter key password for
<red5><br />
- </div>
- </li>
-
- <li>Generate a CSR: keytool -certreq -keyalg
RSA -alias red5 -file
- red5.csr -keystore red5/conf/keystore
- </li>
- <li>Submit CSR to your CA of choice and receive
a signed certificate
- </li>
- <li>Submit CSR to your CA of choice and receive
a signed certificate
- </li>
- <li>Import your chosen CA's root certificate
into the keystore (may
- need to download it from their site -
make sure to get the root CA and
- not the intermediate one): keytool
-import -alias root -keystore
- red5/conf/keystore
- -trustcacerts -file root.crt (note: you
may receive a warning that
- the certificate already exists in the
system wide keystore - import
- anyway)
- </li>
- <li>Import the intermediate certificate(s) you
normally receive with
- the certificate:
- keytool -import -alias intermed
-keystore red5/conf/ keystore -trustcacerts
- -file intermediate.crt
- </li>
- <li>Import the certificate you received:
keytool -import -alias red5
- -keystore red5/conf/keystore
-trustcacerts -file
- demo.openmeetings.de.crt
- </li>
-
+ <ol>
+ <li>
+ Create a new keystore and key, use the
same password for both:<br />
+ (copied from
+ <a
href="http://trac.red5.org/wiki/Documentation/Tutorials/Red5DeveloperTips/SSLTLS%29:";
rel="nofollow">http://trac.red5.org/wiki/Documentation/Tutorials/Red5DeveloperTips/SSLTLS):</a>
+ <div class="xmlcode">
+ keytool -keysize 2048 -genkey
-alias red5 -keyalg RSA -keystore red5/conf/keystore<br />
+ Enter keystore password:<br />
+ Re-enter new password:<br />
+ What is your first and last
name?<br />
+ [Unknown]: <your hostname,
e.g demo.openmeetings.de><br />
+ What is the name of your
organizational unit?<br />
+ [Unknown]: Dev<br />
+ What is the name of your
organization?<br />
+ [Unknown]: OpenMeetings<br />
+ What is the name of your City
or Locality?<br />
+ [Unknown]: Henderson<br />
+ What is the name of your State
or Province?<br />
+ [Unknown]: Nevada<br />
+ What is the two-letter country
code for this unit?<br />
+ [Unknown]: US<br />
+ Is CN=demo.openmeetings.de,
OU=Dev, O=OpenMeetings, L=Henderson, ST=Nevada, C=US correct?<br />
+ [no]: yes<br />
+ Enter key password for
<red5><br />
+ </div>
+ </li>
+
+ <li>Generate a CSR: keytool -certreq -keyalg
RSA -alias red5 -file
+ red5.csr -keystore red5/conf/keystore
+ </li>
+ <li>Submit CSR to your CA of choice and receive
a signed certificate
+ </li>
+ <li>Submit CSR to your CA of choice and receive
a signed certificate
+ </li>
+ <li>Import your chosen CA's root certificate
into the keystore (may
+ need to download it from their site -
make sure to get the root CA and
+ not the intermediate one): keytool
-import -alias root -keystore
+ red5/conf/keystore
+ -trustcacerts -file root.crt (note: you
may receive a warning that
+ the certificate already exists in the
system wide keystore - import
+ anyway)
+ </li>
+ <li>Import the intermediate certificate(s) you
normally receive with
+ the certificate:
+ keytool -import -alias intermed
-keystore red5/conf/ keystore -trustcacerts
+ -file intermediate.crt
+ </li>
+ <li>Import the certificate you received:
keytool -import -alias red5
+ -keystore red5/conf/keystore
-trustcacerts -file
+ demo.openmeetings.de.crt
+ </li>
+
</ol>
</blockquote>
</p>
@@ -983,72 +980,33 @@ limitations under the License.
</td></tr>
<tr><td>
<blockquote>
- <ol>
- <li>
- Add the following XML code to red5/conf/red5-core.xml
before the final <tt></beans></tt> line:
-
- <div class="xmlcode">
- <bean id="rtmpsMinaIoHandler"<br />
- <div style="margin-left:20px">
-
class="org.red5.server.net.rtmps.RTMPSMinaIoHandler"><br />
- <property name="handler"
ref="rtmpHandler" /><br />
- <property name="codecFactory"
ref="rtmpCodecFactory" /><br />
- <property name="rtmpConnManager"
ref="rtmpMinaConnManager" /><br />
- </div>
- <property name="keyStorePassword"
value="${rtmps.keystorepass}" /><br />
- <div style="margin-left:20px">
- <property name="keystoreFile"
value="conf/keystore" /><br />
- </div>
- </bean><br />
- <br />
- <bean id="rtmpsTransport"
class="org.red5.server.net.rtmp.RTMPMinaTransport" init-method="start"
destroy-method="stop"><br />
- <div style="margin-left:20px">
- <property name="ioHandler"
ref="rtmpsMinaIoHandler" /><br />
- <property
name="connectors"><br />
- <div style="margin-left:20px">
- <list><br />
- <div
style="margin-left:20px">
- <bean
class="java.net.InetSocketAddress"><br />
- <div
style="margin-left:20px">
- <constructor-arg
index="0" type="java.lang.String" value="${rtmps.host}" /><br />
- <constructor-arg
index="1" type="int" value="${rtmps.port}" /><br />
- </div>
- </bean><br />
- </div>
- </list><br />
- </div>
- </property><br />
- <property
name="receiveBufferSize" value="${rtmp.receive_buffer_size}" /><br />
- <property name="sendBufferSize"
value="${rtmp.send_buffer_size}" /><br />
- <property name="tcpNoDelay"
value="${rtmp.tcp_nodelay}" /><br />
- </div>
- </bean> <br />
- </div>
-
- </li>
-
- <li>
- Edit red5/conf/red5.properties and set
- <tt>rtmps.port=5443</tt>
- and
- <tt>rtmps.keystorepass=password</tt>
- (password = password you set on your new
- keystore)
- </li>
-
- <li>
- Edit
red5/webapps/openmeetings/config.xml and set
-
<tt><rtmpsslport>5443</rtmpsslport></tt>
- ,
-
<tt><useSSL>yes</useSSL></tt>
- and
-
<tt><proxyType>best</proxyType></tt>
- </li>
-
- <li>Restart red5 and try to connect - your
connection should now be
- made via RTMPS (close port 1935 to be
sure)
- </li>
-
+ <ol>
+ <li>
+ Uncomment <!-- RTMPS --> section in
red5/conf/red5-core.xml
+ </li>
+
+ <li>
+ Edit red5/conf/red5.properties and set
+ <tt>rtmps.port=5443</tt>
+ and
+ <tt>rtmps.keystorepass=password</tt>
+ (password = password you set on your new
+ keystore)
+ </li>
+
+ <li>
+ Edit
red5/webapps/openmeetings/config.xml and set
+
<tt><rtmpsslport>5443</rtmpsslport></tt>
+ ,
+
<tt><useSSL>yes</useSSL></tt>
+ and
+
<tt><proxyType>best</proxyType></tt>
+ </li>
+
+ <li>Restart red5 and try to connect - your
connection should now be
+ made via RTMPS (close port 1935 to be
sure)
+ </li>
+
</ol>
</blockquote>
</p>
@@ -1064,31 +1022,31 @@ limitations under the License.
</td></tr>
<tr><td>
<blockquote>
- <p>If you want to use SSL for the web
interface in addition to RTMPS,
- you need to make some further modifications.
This is mainly to secure
- the server against MITM attacks, additionally
some other features
- like file uploads also use a plain HTTP
connection if this is not
- done. The following instructions assume that
you have already set up
+ <p>If you want to use SSL for the web
interface in addition to RTMPS,
+ you need to make some further modifications.
This is mainly to secure
+ the server against MITM attacks, additionally
some other features
+ like file uploads also use a plain HTTP
connection if this is not
+ done. The following instructions assume that
you have already set up
RTMPS successfully. </p>
- <ol>
- <li>
- Copy this
- <a
href="http://openmeetings.googlecode.com/svn/docs/jee-container-ssl.xml";
rel="nofollow">jee-container-ssl.xml</a>
- file to red5/conf/jee-container.xml
- </li>
- <li>
- Edit
red5/webapps/openmeetings/config.xml and set
-
<tt><protocol>https</protocol></tt>
- </li>
- <li>Edit red5/conf/red5.properties and set
<tt>https.port=443</tt> </li>
- <li>
- Restart red5 and try to connect to
- <a href="https://your.server";
rel="nofollow">https://your.server</a>
- - you should be redirected to the
OpenMeetings
- <a
href="/p/openmeetings/w/edit/OpenMeetings">?</a>
- app and all access should be via HTTPS
or RTMPS (close port 5080 to
- be sure).
- </li>
+ <ol>
+ <li>
+ Copy this
+ <a
href="http://openmeetings.googlecode.com/svn/docs/jee-container-ssl.xml";
rel="nofollow">jee-container-ssl.xml</a>
+ file to red5/conf/jee-container.xml
+ </li>
+ <li>
+ Edit
red5/webapps/openmeetings/config.xml and set
+
<tt><protocol>https</protocol></tt>
+ </li>
+ <li>Edit red5/conf/red5.properties and set
<tt>https.port=443</tt> </li>
+ <li>
+ Restart red5 and try to connect to
+ <a href="https://your.server";
rel="nofollow">https://your.server</a>
+ - you should be redirected to the
OpenMeetings
+ <a
href="/p/openmeetings/w/edit/OpenMeetings">?</a>
+ app and all access should be via HTTPS
or RTMPS (close port 5080 to
+ be sure).
+ </li>
</ol>
</blockquote>
</p>
@@ -1104,7 +1062,7 @@ limitations under the License.
</td></tr>
<tr><td>
<blockquote>
- <p>Credits goto: Nexus and Holger Rabbach
for their help and
+ <p>Credits goto: Nexus and Holger Rabbach
for their help and
contribution and configuration documention! </p>
</blockquote>
</p>
Modified: incubator/openmeetings/trunk/singlewebapp/xdocs/RTMPSAndHTTPS.xml
URL:
http://svn.apache.org/viewvc/incubator/openmeetings/trunk/singlewebapp/xdocs/RTMPSAndHTTPS.xml?rev=1307556&r1=1307555&r2=1307556&view=diff
==============================================================================
--- incubator/openmeetings/trunk/singlewebapp/xdocs/RTMPSAndHTTPS.xml (original)
+++ incubator/openmeetings/trunk/singlewebapp/xdocs/RTMPSAndHTTPS.xml Fri Mar
30 17:53:03 2012
@@ -117,46 +117,7 @@
<ol>
<li>
- Add the following XML code to red5/conf/red5-core.xml
before the final <tt></beans></tt> line:
-
- <div class="xmlcode">
- <bean id="rtmpsMinaIoHandler"<br/>
- <div style="margin-left:20px">
-
class="org.red5.server.net.rtmps.RTMPSMinaIoHandler"><br/>
- <property name="handler"
ref="rtmpHandler" /><br/>
- <property name="codecFactory"
ref="rtmpCodecFactory" /><br/>
- <property name="rtmpConnManager"
ref="rtmpMinaConnManager" /><br/>
- </div>
- <property name="keyStorePassword"
value="${rtmps.keystorepass}" /><br/>
- <div style="margin-left:20px">
- <property name="keystoreFile"
value="conf/keystore" /><br/>
- </div>
- </bean><br/>
- <br/>
- <bean id="rtmpsTransport"
class="org.red5.server.net.rtmp.RTMPMinaTransport" init-method="start"
destroy-method="stop"><br/>
- <div style="margin-left:20px">
- <property name="ioHandler"
ref="rtmpsMinaIoHandler" /><br/>
- <property
name="connectors"><br/>
- <div style="margin-left:20px">
- <list><br/>
- <div
style="margin-left:20px">
- <bean
class="java.net.InetSocketAddress"><br/>
- <div
style="margin-left:20px">
- <constructor-arg
index="0" type="java.lang.String" value="${rtmps.host}" /><br/>
- <constructor-arg
index="1" type="int" value="${rtmps.port}" /><br/>
- </div>
- </bean><br/>
- </div>
- </list><br/>
- </div>
- </property><br/>
- <property
name="receiveBufferSize" value="${rtmp.receive_buffer_size}" /><br/>
- <property name="sendBufferSize"
value="${rtmp.send_buffer_size}" /><br/>
- <property name="tcpNoDelay"
value="${rtmp.tcp_nodelay}" /><br/>
- </div>
- </bean> <br/>
- </div>
-
+ Uncomment <!-- RTMPS --> section in
red5/conf/red5-core.xml
</li>
<li>
