openmeetings-server/src/site/xdoc/installation.xml - openmeetings - Git at Google

 <?xml version="1.0" encoding="UTF-8"?>
 <!--
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

        http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
  -->
 <document xmlns="http://maven.apache.org/XDOC/2.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
 	<properties>
 		<title>Installation</title>
 		<author email="dev@openmeetings.apache.org">Apache OpenMeetings Team</author>
 	</properties>

 	<body>

 		<section name="OpenMeetings Installation">

 			<p>
 				To update from past versions or migrate see <a href="Upgrade.html">Upgrade</a>.<br/>
 				If you are looking for commercial help have a look at
 				<a href="commercial-support.html" target="_blank" rel="nofollow">commercial support</a>.
 			</p>
 			<div>
 				<a href="downloads.html" rel="nofollow">
 					<img src="images/installation_instructions.png" alt="Installation in 3 simple steps" />
 				</a>
 				<p>
 					<i>Note: Openmeetings requires JRE 7/8, JRE 6 is NOT compatible!</i><br />
 					<i>
 						Since Version 2.0 you can also install OpenMeetings from command line. Just cd to the unpacked
 						archive and type ./admin.sh or admin.bat, please see
 						<a href="CommandLineAdmin.html" target="_blank" rel="nofollow">Command Line Admin</a>
 						for more options
 					</i>
 				</p>
 			</div>
 			<ol>
 				<li>
 					<b>Recommendation for production environment</b>
 					<div style="margin-top: 10px; margin-bottom:10px">
 						By default OpenMeetings uses the integrated Apache Derby database.
 						For production environment you should consider using
 						<a href="MySQLConfig.html">MySQL</a>
 						,
 						<a href="PostgresConfig.html">Postgres</a>
 						, or for example
 						<a href="IBMDB2Config.html">IBM DB2</a>
 						, or
 						<a href="OracleConfig.html">Oracle</a>
 						, or
 						<a href="MSSQLConfig.html">MSSQL</a>
 					</div>
 				</li>
 				<li>
 					<b>Enabling Image Upload and import to whiteboard</b>
 					<div style="margin-top: 10px; margin-bottom:10px">
 						Install
 						<b>ImageMagick</b>
 						on the server, you can get more information on
 						<a href="http://www.imagemagick.org" rel="nofollow" target="_blank">http://www.imagemagick.org
 						</a>
 						regarding installation. The instructions
 						for installation can be
 						found there
 						<a href="http://www.imagemagick.org/script/binary-releases.php"
 							target="_blank" rel="nofollow">http://www.imagemagick.org/script/binary-releases.php
 						</a>
 						,
 						however on
 						most Linux systems you can get it via your favorite
 						package
 						managers (apt-get it)
 					</div>
 				</li>
 				<li>
 					<b>Enabling import of PDFs into whiteboard</b>
 					<div style="margin-top: 10px; margin-bottom:10px">
 						<ul>
 							<li>
 								Install
 								<b>GhostScript</b>
 								on the server, you can get more
 								information on
 								<a href="http://www.ghostscript.com/download/gsdnld.html" target="_blank"
 									rel="nofollow">
 									http://www.ghostscript.com/download/gsdnld.html
 								</a>
 								regarding
 								installation. The instructions for installation can be
 								found
 								there, however on most Linux systems you can get it via
 								your
 								favorite package managers (apt-get it).
 							</li>
 							<li>
 								Install
 								<b>SWFTools</b>
 								on the server, you can get more information
 								on
 								<a href="http://www.swftools.org/" target="_blank" rel="nofollow">http://www.swftools.org/
 								</a>
 								regarding installation. Some of the
 								Linux distributions already
 								have it in there package manager (see
 								<a href="http://packages.debian.org/unstable/utils/swftools"
 									target="_blank" rel="nofollow">http://packages.debian.org/unstable/utils/swftools
 								</a>
 								), the
 								recommended version of SWFTools is 0.9 as prior version
 								have a
 								bug that does lead to wrong object dimensions at
 								whiteboard
 							</li>
 						</ul>
 					</div>
 				</li>
 				<li>
 					<b>Enabling import of .doc, .docx, .ppt, .pptx, ... all Office
 						Documents into whitebaord
 					</b>
 					<div style="margin-top: 10px; margin-bottom:10px">
 						<ul>
 							<li>OpenOffice or Libre Office Installed</li>
 						</ul>
 						Since Version 2.x of OpenMeetings it is no more required to start
 						OpenOffice (or Libreoffice) service, see
 						<a href="OpenOfficeConverter.html">OpenOfficeConverter</a>
 						for details
 					</div>
 				</li>
 				<li>
 					<b>Enabling Recording and import of .avi, .flv, .mov and .mp4 into
 						whiteboard
 					</b>
 					<div style="margin-top: 10px; margin-bottom:10px">
 						<ul>
 							<li>
 								Install
 								<b>FFMpeg (with -enabled libmp3lame and libx264 options)</b>
 								. You should get FFMPEG in an up to date copy! OpenMeetings is
 								tested with FFMPEG Version 10.3 and latest build from GIT
 								For Windows you can download a Build for example from
 								<a href="http://ffmpeg.zeranoe.com/builds/" target="_blank"
 									rel="nofollow">http://ffmpeg.zeranoe.com/builds/ </a>
 								Linux or OSx Users should be able to use one of the various
 								Installation Instructions on the Web. You need to enable
 								libmp3lame and libx264!
 							</li>
 							<li>
 								Install
 								<b>SoX</b>
 								<a href="http://sox.sourceforge.net/" target="_blank" rel="nofollow">http://sox.sourceforge.net/
 								</a>
 								. You should install SoX in a up
 								to date copy! SoX 12.xx will NOT
 								work!
 							</li>
 						</ul>
 					</div>
 				</li>
 			</ol>

 		</section>

 		<section name="Ports, NAT Settings, Customize">

 			<p>
 				See
 				<a href="PortSettings.html">PortSettings</a>
 			</p>
 		</section>

 		<section name="Hardware Requirements">
 			<ul>
 				<li>
 					Minimalistic requirement (without Document Converters, Recorder and
 					Upload feature) 1GHz CPU 1 GB RAM (
 					<i>server-side</i>
 					)
 				</li>
 				<li>
 					Recommended requirement 2x/4x 2GHz ++ CPU (32 or 64Bit) 4GB RAM. If
 					you have a 64Bit Operating System check if there is a OpenOffice
 					64Bit Version
 					<a href="http://download.openoffice.org/other.html#de" rel="nofollow">available
 						for your OS
 					</a>
 					(
 					<i>server-side</i>
 					)
 				</li>
 				<li>
 					Headset/Microphone recommendation: Logitech ClearChat PC Wireless,
 					for example from
 					<a
 						href="http://www.amazon.de/Logitech-ClearChat-kabelloser-Kopfh%C3%B6rer-Transmitter/dp/B00166WSN4"
 						rel="nofollow">Amazon</a>
 					or
 					<a
 						href="http://shop.ebay.com/i.html?_nkw=Logitech+ClearChat.+Wireless&amp;_sacat=0&amp;_trksid=p3286.m270.l1313&amp;LH_BIN=1&amp;LH_IncludeSIF=1&amp;_odkw=Logitech+ClearChat+PC&amp;_osacat=0"
 						rel="nofollow">EBay Auctions</a>
 					(
 					<i>cient-side</i>
 					).
 					<a href="RecommendedHardwareList.html">See all recommendations</a>
 					for cameras, headsets and speakerphones.
 				</li>
 			</ul>

 		</section>

 		<section name="Debian, Links, Changelog, VoIP">
 			<ul>
 				<li>for VoIP and SIP Integration see also <a href="voip-sip-integration.html">VoIPAndSIP</a></li>
 				<li><a href="http://meetingslive.sourceforge.net/" rel="nofollow">http://meetingslive.sourceforge.net/</a></li>
 				<li>
 					<a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools">Installation of OM 2.0 for Windows XP, 7, 2003, 2008</a>
 				</li>
 				<li>
 					<a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools">
 						OpenMeetings Installation tutorials by Alvaro Bustos for: Ubuntu, Debian, Mint, MacOS X, CentOS, Fedora,
 						PCLinuxOS, openSUSE and Arch Linux.</a>
 				</li>
 				<li>
 					<a href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=27837303"
 						rel="nofollow">Tutoriales en español relacionados con OpenMeetings</a>
 				</li>
 				<li>
 					<a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools"
 						rel="nofollow">Automatic script installation for Ubuntu/Debian (beta)</a>
 				</li>
 				<li>
 					French version of Installation Instructions:
 					<a href="http://flash.54n.free.fr/?/Root/Debian/OpenMeetings-Installation"
 						rel="nofollow">http://flash.54n.free.fr/?/Root/Debian/OpenMeetings-Installation
 					</a>
 				</li>
 			</ul>
 		</section>

 		<section name="Tips and Tricks">
 			<ul>
 				<li>
 					Use the Debug-Application: open <tt>$RED5_HOME/webapps/openmeetings/WEB-INF/web.xml</tt> change
 					<source><![CDATA[
 <init-param>
 	<param-name>configuration</param-name>
 	<param-value>DEPLOYMENT</param-value>
 </init-param>
 					]]></source> to be
 					<source><![CDATA[
 <init-param>
 	<param-name>configuration</param-name>
 	<param-value>DEVELOPMENT</param-value>
 </init-param>
 					]]></source>
 					then access your OM installation
 				</li>
 				<li>If you have Problems with conversion-jobs check your openmeetings log
 					output (available at <tt>$RED5_HOME/log/openmeetings.log</tt>). There will be error Messages which help you. You must
 					install OpenOffice, ImageMagick, GhostScript and SWFTools to run
 					all conversion-Jobs correctly.
 				</li>
 				<li>
 					you can query a Mysql Database to get the schema_collection by
 					using this query:
 					<source><![CDATA[SELECT Table_name, TABLE_COLLATION FROM information_schema.tables WHERE table_schema = 'openmeetings' ORDER BY table_name DESC ]]></source>
 				</li>
 			</ul>
 		</section>

 	</body>

 </document>
	<?xml version="1.0" encoding="UTF-8"?>
	<!--
	Licensed under the Apache License, Version 2.0 (the "License");
	you may not use this file except in compliance with the License.
	You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
	-->
	<document xmlns="http://maven.apache.org/XDOC/2.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
	<properties>
	<title>Installation</title>
	<author email="dev@openmeetings.apache.org">Apache OpenMeetings Team</author>
	</properties>

	<body>

	<section name="OpenMeetings Installation">

	<p>
	To update from past versions or migrate see <a href="Upgrade.html">Upgrade</a>.<br/>
	If you are looking for commercial help have a look at
	<a href="commercial-support.html" target="_blank" rel="nofollow">commercial support</a>.
	</p>
	<div>
	<a href="downloads.html" rel="nofollow">
	<img src="images/installation_instructions.png" alt="Installation in 3 simple steps" />
	</a>
	<p>
	<i>Note: Openmeetings requires JRE 7/8, JRE 6 is NOT compatible!</i><br />
	<i>
	Since Version 2.0 you can also install OpenMeetings from command line. Just cd to the unpacked
	archive and type ./admin.sh or admin.bat, please see
	<a href="CommandLineAdmin.html" target="_blank" rel="nofollow">Command Line Admin</a>
	for more options
	</i>
	</p>
	</div>
	<ol>
	<li>
	<b>Recommendation for production environment</b>
	<div style="margin-top: 10px; margin-bottom:10px">
	By default OpenMeetings uses the integrated Apache Derby database.
	For production environment you should consider using
	<a href="MySQLConfig.html">MySQL</a>
	,
	<a href="PostgresConfig.html">Postgres</a>
	, or for example
	<a href="IBMDB2Config.html">IBM DB2</a>
	, or
	<a href="OracleConfig.html">Oracle</a>
	, or
	<a href="MSSQLConfig.html">MSSQL</a>
	</div>
	</li>
	<li>
	<b>Enabling Image Upload and import to whiteboard</b>
	<div style="margin-top: 10px; margin-bottom:10px">
	Install
	<b>ImageMagick</b>
	on the server, you can get more information on
	<a href="http://www.imagemagick.org" rel="nofollow" target="_blank">http://www.imagemagick.org
	</a>
	regarding installation. The instructions
	for installation can be
	found there
	<a href="http://www.imagemagick.org/script/binary-releases.php"
	target="_blank" rel="nofollow">http://www.imagemagick.org/script/binary-releases.php
	</a>
	,
	however on
	most Linux systems you can get it via your favorite
	package
	managers (apt-get it)
	</div>
	</li>
	<li>
	<b>Enabling import of PDFs into whiteboard</b>
	<div style="margin-top: 10px; margin-bottom:10px">
	<ul>
	<li>
	Install
	<b>GhostScript</b>
	on the server, you can get more
	information on
	<a href="http://www.ghostscript.com/download/gsdnld.html" target="_blank"
	rel="nofollow">
	http://www.ghostscript.com/download/gsdnld.html
	</a>
	regarding
	installation. The instructions for installation can be
	found
	there, however on most Linux systems you can get it via
	your
	favorite package managers (apt-get it).
	</li>
	<li>
	Install
	<b>SWFTools</b>
	on the server, you can get more information
	on
	<a href="http://www.swftools.org/" target="_blank" rel="nofollow">http://www.swftools.org/
	</a>
	regarding installation. Some of the
	Linux distributions already
	have it in there package manager (see
	<a href="http://packages.debian.org/unstable/utils/swftools"
	target="_blank" rel="nofollow">http://packages.debian.org/unstable/utils/swftools
	</a>
	), the
	recommended version of SWFTools is 0.9 as prior version
	have a
	bug that does lead to wrong object dimensions at
	whiteboard
	</li>
	</ul>
	</div>
	</li>
	<li>
	<b>Enabling import of .doc, .docx, .ppt, .pptx, ... all Office
	Documents into whitebaord
	</b>
	<div style="margin-top: 10px; margin-bottom:10px">
	<ul>
	<li>OpenOffice or Libre Office Installed</li>
	</ul>
	Since Version 2.x of OpenMeetings it is no more required to start
	OpenOffice (or Libreoffice) service, see
	<a href="OpenOfficeConverter.html">OpenOfficeConverter</a>
	for details
	</div>
	</li>
	<li>
	<b>Enabling Recording and import of .avi, .flv, .mov and .mp4 into
	whiteboard
	</b>
	<div style="margin-top: 10px; margin-bottom:10px">
	<ul>
	<li>
	Install
	<b>FFMpeg (with -enabled libmp3lame and libx264 options)</b>
	. You should get FFMPEG in an up to date copy! OpenMeetings is
	tested with FFMPEG Version 10.3 and latest build from GIT
	For Windows you can download a Build for example from
	<a href="http://ffmpeg.zeranoe.com/builds/" target="_blank"
	rel="nofollow">http://ffmpeg.zeranoe.com/builds/ </a>
	Linux or OSx Users should be able to use one of the various
	Installation Instructions on the Web. You need to enable
	libmp3lame and libx264!
	</li>
	<li>
	Install
	<b>SoX</b>
	<a href="http://sox.sourceforge.net/" target="_blank" rel="nofollow">http://sox.sourceforge.net/
	</a>
	. You should install SoX in a up
	to date copy! SoX 12.xx will NOT
	work!
	</li>
	</ul>
	</div>
	</li>
	</ol>

	</section>

	<section name="Ports, NAT Settings, Customize">

	<p>
	See
	<a href="PortSettings.html">PortSettings</a>
	</p>
	</section>

	<section name="Hardware Requirements">
	<ul>
	<li>
	Minimalistic requirement (without Document Converters, Recorder and
	Upload feature) 1GHz CPU 1 GB RAM (
	<i>server-side</i>
	)
	</li>
	<li>
	Recommended requirement 2x/4x 2GHz ++ CPU (32 or 64Bit) 4GB RAM. If
	you have a 64Bit Operating System check if there is a OpenOffice
	64Bit Version
	<a href="http://download.openoffice.org/other.html#de" rel="nofollow">available
	for your OS
	</a>
	(
	<i>server-side</i>
	)
	</li>
	<li>
	Headset/Microphone recommendation: Logitech ClearChat PC Wireless,
	for example from
	<a
	href="http://www.amazon.de/Logitech-ClearChat-kabelloser-Kopfh%C3%B6rer-Transmitter/dp/B00166WSN4"
	rel="nofollow">Amazon</a>
	or
	<a
	href="http://shop.ebay.com/i.html?_nkw=Logitech+ClearChat.+Wireless&_sacat=0&_trksid=p3286.m270.l1313&LH_BIN=1&LH_IncludeSIF=1&_odkw=Logitech+ClearChat+PC&_osacat=0"
	rel="nofollow">EBay Auctions</a>
	(
	<i>cient-side</i>
	).
	<a href="RecommendedHardwareList.html">See all recommendations</a>
	for cameras, headsets and speakerphones.
	</li>
	</ul>

	</section>

	<section name="Debian, Links, Changelog, VoIP">
	<ul>
	<li>for VoIP and SIP Integration see also <a href="voip-sip-integration.html">VoIPAndSIP</a></li>
	<li><a href="http://meetingslive.sourceforge.net/" rel="nofollow">http://meetingslive.sourceforge.net/</a></li>
	<li>
	<a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools">Installation of OM 2.0 for Windows XP, 7, 2003, 2008</a>
	</li>
	<li>
	<a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools">
	OpenMeetings Installation tutorials by Alvaro Bustos for: Ubuntu, Debian, Mint, MacOS X, CentOS, Fedora,
	PCLinuxOS, openSUSE and Arch Linux.</a>
	</li>
	<li>
	<a href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=27837303"
	rel="nofollow">Tutoriales en español relacionados con OpenMeetings</a>
	</li>
	<li>
	<a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools"
	rel="nofollow">Automatic script installation for Ubuntu/Debian (beta)</a>
	</li>
	<li>
	French version of Installation Instructions:
	<a href="http://flash.54n.free.fr/?/Root/Debian/OpenMeetings-Installation"
	rel="nofollow">http://flash.54n.free.fr/?/Root/Debian/OpenMeetings-Installation
	</a>
	</li>
	</ul>
	</section>

	<section name="Tips and Tricks">
	<ul>
	<li>
	Use the Debug-Application: open <tt>$RED5_HOME/webapps/openmeetings/WEB-INF/web.xml</tt> change
	<source><![CDATA[
	<init-param>
	<param-name>configuration</param-name>
	<param-value>DEPLOYMENT</param-value>
	</init-param>
	]]></source> to be
	<source><![CDATA[
	<init-param>
	<param-name>configuration</param-name>
	<param-value>DEVELOPMENT</param-value>
	</init-param>
	]]></source>
	then access your OM installation
	</li>
	<li>If you have Problems with conversion-jobs check your openmeetings log
	output (available at <tt>$RED5_HOME/log/openmeetings.log</tt>). There will be error Messages which help you. You must
	install OpenOffice, ImageMagick, GhostScript and SWFTools to run
	all conversion-Jobs correctly.
	</li>
	<li>
	you can query a Mysql Database to get the schema_collection by
	using this query:
	<source><![CDATA[SELECT Table_name, TABLE_COLLATION FROM information_schema.tables WHERE table_schema = 'openmeetings' ORDER BY table_name DESC ]]></source>
	</li>
	</ul>
	</section>

	</body>

	</document>