Install Apache OpenMeetings 3.0 on CentOS, Fedora & RHEL

OpenMeetings is open source software which is used for presenting, online training, web conferencing, collaborative white board drawing and document editing and user desktop sharing. The product is developed a group of open source components, like (ImageMagick, GhostScript, SWFTools, JODConverter ,FFMpeg and OpenOffice or Libre Office) and main functionality on this product is OpenLaszlo RIA framework and Red5 media server.

Note:

a) OpenMeetings requires SUN/Oracle JRE 6, not openJDK!. So install proper JDK & JRE.
b) By default openmeetings use Apache Derby database which is integrated with openmeetings. For production environment you should use MySQL, MSSQL, Postgres & Oracle.

Features of OpenMeetings

  • Audio communication
  • Video conferencing
  • Meeting recording
  • Screen sharing
  • Collaborative document editing
  • Chat and white boarding
  • User and room management

ImageMagick :ImageMagick is a opensource software which is used to create, edit, compose, or convert bitmap images into other formats like jpeg, png and gif..,etc.,,(100 plus formats).
GhostScript :GhostScript is a opensource software and its called file format converter, such as PostScript to PDF converter.
SWFTools :SWFTools is a collection of utilities for working with Adobe Flash files (SWF files). The tool collection includes programs for reading SWF files, combining them, and creating them from other content (like images, sound files, videos or sourcecode).
FFMpeg :FFMpeg is a opensource software which is used to record, convert and stream audio and video.
JODConverter :JODConverter, the Java OpenDocument Converter, converts documents between different office formats.
Libre Office :LibreOffice is a free and open source office suite software which is suitable for office documentation work.
SoX :SoX is command line utility that can convert various formats of computer audio files in to other formats.
Red5 :Red5 is a leading open-source media streaming server and implemented in Java which is used for video streaming.
lame :lame is stands for “LAME Ain’t an MP3 Encoder”. lame is a opensource software which is used to encode/compress audio into the MP3 file format.

Follow the below steps for OpenMeetings installation and configuration in Centos.

I’m going to install some required basic software’s but most of the basic software was installed by default anyhow we need to re run it. See below.

1) Basic package installation ?

# yum install wget gcc-c++ unzip zlib-devel libjpeg-devel freetype-devel giflib-devel ghostscript ImageMagick sox libreoffice

2) MySQL Database creation ?

Follow the below steps to create the mysql database for production environment.

# mysql -u root -p

mysql> CREATE DATABASE openmeetings DEFAULT CHARACTER SET 'utf8';
mysql> CREATE USER 'openmeetings'@'localhost' IDENTIFIED BY 'openmeetings';
mysql> GRANT ALL PRIVILEGES ON openmeetings.* TO 'openmeetings'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> exit

3) swftools installation

SWFTools is a collection of utilities for working with Adobe Flash files (SWF files). The tool collection includes programs for reading SWF files, combining them, and creating them from other content (like images, sound files, videos or sourcecode). Follow the below stpes for swftools installation and configuration.

# wget http://www.swftools.org/swftools-0.9.2.tar.gz
# tar -xzvf swftools-0.9.2.tar.gz
# cd swftools-0.9.2
# ./configure --libdir=/usr/lib --bindir=/usr/bin
# make
# make install
rm -f /usr/local/share/swftools/swfs/default_viewer.swf -o -L /usr/local/share/swftools/swfs/default_viewer.swf
rm: invalid option -- 'o'
Try `rm --help' for more information.
make[1]: *** [install] Error 1
make[1]: Leaving directory `/root/swftools-0.9.2/swfs'
make: *** [install] Error 2

There is a bug in the swftools Makefile that’s why we got above error message. You need to remove below both line which is mentioned in ORANGE color which is start rm -f. Then try to run makefile.

# nano Makefile
        rm -f $(pkgdatadir)/swfs/default_viewer.swf -o -L $(pkgdatadir)/swfs/default_viewer.swf
        rm -f $(pkgdatadir)/swfs/default_loader.swf -o -L $(pkgdatadir)/swfs/default_loader.swf

# cd swfs

Now, Re-Run the Makefile to complete the swftools installation.

# make install

4) Java Version checking

Apache Openmeetings working on .jar file. So java should be installed in our system. We have alredy installed java in our system so, i’m going to check the java version. If No, Install Oracle Java or OpenJDK on your system.

# java -version
java version "1.7.0_65"
OpenJDK Runtime Environment (rhel-2.5.1.2.el6_5-x86_64 u65-b17)
OpenJDK 64-Bit Server VM (build 24.65-b04, mixed mode)

5) jodconverter Installation

JODConverter, the Java OpenDocument Converter, converts documents between different office formats. Follow the below stpes for jodconverter installation and configuration.

# cd /opt
# wget http://jodconverter.googlecode.com/files/jodconverter-core-3.0-beta-4-dist.zip
# unzip jodconverter-core-3.0-beta-4-dist.zip

6) lame Installation

lame is stands for “LAME Ain’t an MP3 Encoder”. lame is a opensource software which is used to encode/compress audio into the MP3 file format. Follow the below stpes for lame installation and configuration.

# cd /opt
# wget http://kaz.dl.sourceforge.net/project/lame/lame/3.99/lame-3.99.5.tar.gz
# tar -xzvf lame-3.99.5.tar.gz
# ./configure --libdir=/usr/lib --bindir=/usr/bin
# make
# make install

7) ffmpeg Installation

FFMpeg is a opensource software which is used to record, convert and stream audio and video. Follow the below stpes for ffmpeg installation and configuration.

# cd /opt
# wget http://ffmpeg.org/releases/ffmpeg-1.1.1.tar.gz
# ./configure --libdir=/usr/lib --bindir=/usr/bin --enable-libmp3lame --disable-yasm
# make
# make install

8) JAVA MySQL Connector Downloading


Use the below command to download the JAVA MySQL connector, its used to connect the openmeetings app into MySQL database.

# cd /opt
# wget http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.0.8.tar.gz
# tar -xzvf mysql-connector-java-5.0.8.tar.gz

9) OpenMeethings Installation

OpenMeetings is opensource software which is used for presenting, online training, web conferencing, collaborative whiteboard drawing and document editing and user desktop sharing. Follow the below stpes for OpenMeethings installation and configuration.

# mkdir openmeetings
# cd openmeetings
# wget http://apache.petsads.us/openmeetings/3.0.2/bin/apache-openmeetings-3.0.2.tar.gz
# tar -xzvf apache-openmeetings-3.0.2.tar.gz

Copy the mysql-connector-java-5.0.8-bin.jar file into openmeetings lib folder. See below.

# cd /opt/mysql-connector-java-5.0.8
# cp mysql-connector-java-5.0.8-bin.jar /openmeetings/webapps/openmeetings/WEB-INF/lib

For MySQL configuration, navigate to openmeetings META-INF folder and backup persistence.xml file because its Derby database configuration and rename the mysql_persistence.xml file to persistence.xml

# cd openmeetings/webapps/openmeetings/WEB-INF/classes/META-INF
# cp persistence.xml persistence.xml.bk.live
# cp mysql_persistence.xml persistence.xml

Assign your mysql username and its password to configuration file. Make your you need to add your database username and password instead of us.

# nano persistence.xml
                                        , Url=jdbc:mysql://localhost:3306/openmeetings?autoReconnect=true&useUnicode=true&createDatabaseIfNotExist=true&cha$
                                        , MaxActive=100
                                        , MaxWait=10000
                                        , TestOnBorrow=true
                                        , poolPreparedStatements=true
                                        , Username=openmeetings
                                        , Password=openmeetings" />

Start the red5.sh file to hik the server. If the server started properly without any issues. It shows like below.

# cd openmeetings
# ./red5.sh
Running on  Linux
Starting Red5
Red5 root: /root/openmeetings
Configuation root: /root/openmeetings/conf
org.apache.openmeetings.data.whiteboard.EmoticonsManager [Launcher:/openmeetings] - ##### loadEmot completed
DEBUG 08-14 17:24:28.434 Version.java 6629 96 org.apache.openmeetings.util.Version [Launcher:/openmeetings] -
        ##################################################
        #               Openmeetings is up               #
        #       3.0.2-RELEASE 1598809 31-May-2014        #
        #                and ready to use                #
        ##################################################

[INFO] [Launcher:/openmeetings] org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping - Mapped "{[/networktest.upload],methods=[GET],params=[],headers=[],consumes=[],produces=[],custom=[]}" onto public void org.apache.openmeetings.servlet.outputhandler.NetworkTestingController.serviceGet(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse,javax.servlet.http.HttpSession) throws javax.servlet.ServletException,java.io.IOException

Now, we have installed openmeetings successfully in centos.

10) Navigate your browser to OpenMeethings Installation link

Navigate your browser to http://localhost:5080/openmeetings/install or http://serverIP:5080/openmeetings/install and need to configure some basic things on browser. This is welcome page and step-1 Just follow the instruction carefully and hitNEXT button.
how-to-install-apache-openmeetings-in-centos-1

11) Enter Administrator Details

In step-2 you need to enter administrator details and hitNEXT button.
how-to-install-apache-openmeetings-in-centos-2

12) Enter Configuration Details

In step-3 you need to enter configuration details. like SMTP server information, etc… and hitNEXT button.
how-to-install-apache-openmeetings-in-centos-3

13) Enter Convertor Details

In step-4 you need to enter convertor tools configuration details. like SWFtools, ImageMagick, FFMPEG configuration and Path details., etc… and hitNEXT button.
how-to-install-apache-openmeetings-in-centos-4

14) Enter red5SIP Configuration Details

In step-5 you need to enter red5SIP Configuration details and hitNEXT button.
how-to-install-apache-openmeetings-in-centos-5

15) Start Openmeetings installation

In step-6 you have completed all the configuration and hit FINISH button to Start Openmeetings installation.
how-to-install-apache-openmeetings-in-centos-6
It will take shot while to complet the installation.
how-to-install-apache-openmeetings-in-centos-7

16) Openmeetings installation successful

After completing installation, the below window is appear. Click the Enter the Application link. to lunch the openmeetings login page.
how-to-install-apache-openmeetings-in-centos-8

17) Openmeetings Login page

Log with the admin credentials which is gave in step-2
how-to-install-apache-openmeetings-in-centos-9
This is the main dashbord of Openmeetings. Start play with your openmeetings.
how-to-install-apache-openmeetings-in-centos-10

18) Making red5 server to automatic

In the above setup, everytime you need to start the red5 server and you want to start the red5 server automatically, follow the below steps. Create the file called red5 on below mentioned directory and put the below code. Make sure you need to mention your path(Green color line) instead of us. Then save and exit the file.

[email protected] [~]# nano /etc/init.d/red5
  GNU nano 2.0.9                                         File: /etc/init.d/red5

#
#!/bin/sh -e
#
# chkconfig: 2345 20 80
# description: Startup script for Red5/openmeetings

export RED5_HOME=/root/openmeetings/
start_red5="$RED5_HOME/red5.sh"
stop_red5="$RED5_HOME/red5-shutdown.sh"

start() {
        echo -n "Starting Red5: "
        ${start_red5} &
        echo "done."
}
stop() {
        echo -n "Shutting down Red5: "
        ${stop_red5}
        echo "done."
}

case "$1" in
  start)
        start
        ;;
  stop)
        stop
        ;;
  restart)
        stop
        sleep 10
        start
        ;;
  *)
        echo "Usage: $0 {start|stop|restart}"
esac

exit 0

Assign executable permission to red5 file and enable it on boot using below steps.

[email protected] [~]# chmod +x /etc/init.d/red5

[email protected] [~]# service red5 stop

[email protected] [~]# chkconfig red5 on

[email protected] [~]# service red5 start

We are preparing all articles in-depth to understand by all level/stage Linux administrators. If the article is useful for you, then please spend less than a minute to share your valuable comments in our commenting section.

Please stay tune with us…Good Luck.

Magesh Maruthamuthu

Love to play with all Linux distribution

You may also like...