| <?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> |
| <div> |
| <h3><b>3 <i>steps</i> to install OpenMeetings</b></h3> |
| <ol class="install-steps"> |
| <li class="step"> |
| <div> |
| <a href="InstallMediaServer.html">Install Kurento Media server</a> |
| </div> |
| <div class="small"></div> |
| </li> |
| <li class="step download os"> |
| <div><a href="downloads.html" rel="nofollow">Download latest .zip (.tar.gz)</a></div> |
| <div class="small">Java 17 required</div> |
| </li> |
| <li class="step unpack"> |
| <div>Unpack + run bin/startup.bat (.sh)</div> |
| <div class="small">(Windows: double click startup.bat)</div> |
| </li> |
| <li class="step run"> |
| <div>Run Web Installer</div> |
| <div class="small">(goto: <a href="https://localhost:5443/openmeetings/install">https://localhost:5443/openmeetings/install</a>)</div> |
| </li> |
| </ol> |
| <script type="text/javascript"><![CDATA[ |
| let osname = 'windows'; |
| if (navigator.appVersion.indexOf('Mac') > -1) { |
| osname = 'mac'; |
| } |
| if (navigator.appVersion.indexOf('X11') > -1 || navigator.appVersion.indexOf('Linux') > -1) { |
| osname = 'linux'; |
| } |
| document.onreadystatechange = () => { |
| if (document.readyState === 'complete') { |
| $('.download.os').css('background-image', 'url(images/download_for_' + osname + '.png)'); |
| } |
| }; |
| //]]> |
| </script> |
| </div> |
| <p> |
| <i>Note: Openmeetings requires JRE 17, JRE 6/7/8/11 are 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 H2 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> |
| </ul> |
| </div> |
| </li> |
| <li> |
| <b>Enabling import of .doc, .docx, .ppt, .pptx, ... all Office |
| Documents into whiteboard |
| </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="Tutorials by Alvaro Bustos"> |
| <h4>OpenMeetings Installation tutorials by Alvaro Bustos for:</h4> |
| <div> |
| Arch Linux, CentOS, Debian, Devuan, Fedora, Gentoo, MacOS, Mageia, Manjaro, Mint |
| , MX Linux, OpenSuse, PCLinuxOS, Slackware, Ubuntu and Windows. |
| <a href="https://cwiki.apache.org/confluence/display/OPENMEETINGS/Tutorials+for+installing+OpenMeetings+and+Tools"> |
| Can be found here</a><br/> |
| As wee as some automatic scripts |
| </div> |
| </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) 2GHz CPU 4 GB RAM (<i>server-side</i>) |
| </li> |
| <li> |
| Recommended requirement 2x/4x 2GHz ++ CPU (32 or 64Bit) 8GB 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="Useful Links"> |
| <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/pages/viewpage.action?pageId=27837303" |
| rel="nofollow">Tutoriales en espaƱol relacionados con OpenMeetings</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>$OM_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>$OM_HOME/logs/openmeetings.log</tt>). There will be error Messages which help you. You must |
| install OpenOffice, ImageMagick and GhostScript 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> |