From Wikipedia OpenMeeting is:
OpenMeetings is software used for presenting, online training, web conferencing, collaborative whiteboard drawing and document editing, and user desktop sharing. The product is based on OpenLaszlo RIA framework and Red5 media server, which in turn are based on a bunch of open source components. Communication takes place in meeting rooms which are set to different communication, security and video quality modes. The recommended database for backend support is MySQL. The product can be set up as an installed server product, or used as a hosted product.
Today we will be installing OpenMeeting on CentOS 6.3 (64-bit).
Find a nice place to work:
Go to http://openmeetings.apache.org/downloads.html and download and unpack latest binary.
tar -xzvf ../apache-openmeetings-incubating-2.0.0.r1361497-14-07-2012_1108.tar.gz
The default installation of OpenMeeting uses an integrated Apache Derby database to persist data at the back end. They recommend MySQL (or a real database) for production installations. I however, like to easily poke around the database and investigate how the product works. The trouble with an integrated database is that it won’t be available when the application is down and it may not be available to clients outside the application.
OpenMeeting requires UTF8 so we’ll install MySQL and configure the collation.
- Install PHP and MySQL with
yum install php mysql-server mysql
- There are a few problems of setting the collation with MySQL so. Edit
/etc/my.cnf and add the following lines to the mysqld section:
collation-server = utf8_unicode_ci
init-connect=’SET NAMES utf8′
character-set-server = utf8
- Then restart MySQL with:
Now that we have MySQL installed, we’ll have to create a MySQL account for OpenMeeting to use.
- Login to MySQL:
- Create the database:
CREATE DATABASE openmeetings;
- Create a MySQL user for the application:
CREATE USER openmeetings;
- Set permissions:
GRANT ALL ON openmeetings.* TO openmeetings@localhost;
- Set password (change **** to your password):
SET PASSWORD FOR openmeetings@localhost=PASSWORD(’****’);
- Log out of MySQL:
- Now we will just check that our new user is set up properly. (Where **** is the password)
mysql -uopenmeetings -p**** openmeetings
OpenMeeting isn’t bundled with all the database connectors so we’ll have to download and install the MySQL connector in order to talk to the database.
- Start off in our dev area:
- Go to http://www.mysql.com/downloads/connector/j/ and download the latest ConnectorJ (at the time of writing this was 5.1.24)
- Unpack it:
tar -xvzf mysql-connector-java-5.1.24.tar.gz
- Move the connector to the correct place in the OpenMeeting directory structure so it can be found by the application:
mv mysql-connector-java-5.1.24/mysql-connector-java-5.1.24-bin.jar openmeeting/webapps/openmeetings/WEB-INF/lib/
We are not using the default database type so we must change the configuration files so that the OpenMeeting installation process uses the MySQL configuration file instead of the integrated Derby configuration file.
- Go to the connectors folder:
- Use the MySQL configuration template:
cp mysql_persistence.xml persistence.xml
persistence.xml and change the MySQL credentials. At the bottom of the file you will see
…. , MaxActive=100
Change the Username and Password to what you set earlier. If you want to change the database name
localhost:3306/openmeetings? will become
Now we are going to set up Enabling Image Upload and import to whiteboard
To install ImageMagick
we’ll use the package manager:
yum install ImageMagick
will install GhostScript
as a dependency so we get part 1 of Enabling import of PDFs into whiteboard
for free. Part 2 requires installing SWFTools which we will do now:
- Start in our development directory:
- Go to http://www.swftools.org/download.html and get the latest version:
- Unpack with:
tar -xvzf swftools-0.9.2.tar.gz
- If this is a minimal version of CentOS (or you type
gcc and get bad command) then you’ll need to install the C compiler and tools:
yum install gcc* automake zlib-devel libjpeg-devel giflib-devel freetype-devel make
- Prepare to build the software:
- Run the pre-build configuration script:
- Build SWFTools:
There is a bug in the
step so we’ll just fix that before running it.
- Search for the install: directive and change:
rm -f $(pkgdatadir)/swfs/default_viewer.swf -o -L $(pkgdatadir)/swfs/default_viewer.swf
$(LN_S) $(pkgdatadir)/swfs/simple_viewer.swf $(pkgdatadir)/swfs/default_viewer.swf
rm -f $(pkgdatadir)/swfs/default_loader.swf -o -L $(pkgdatadir)/swfs/default_loader.swf
$(LN_S) $(pkgdatadir)/swfs/tessel_loader.swf $(pkgdatadir)/swfs/default_loader.swf
<TAB>rm -f $(pkgdatadir)/swfs/default_viewer.swf
<TAB>$(LN_S) $(pkgdatadir)/swfs/simple_viewer.swf $(pkgdatadir)/swfs/default_viewer.swf
<TAB>rm -f $(pkgdatadir)/swfs/default_loader.swf
<TAB>$(LN_S) $(pkgdatadir)/swfs/tessel_loader.swf $(pkgdatadir)/swfs/default_loader.swf
Make sure that the first and only character at the start of the replacement lines is a TAB and not a space.
- Now we can run:
Next we’ll install the dependencies for Enabling import of .doc, .docx, .ppt, .pptx, … all Office Documents into whitebaord
. This also installs Oracle’s Java which is why we didn’t install it earlier.
Enabling Recording and import of .avi, .flv, .mov and .mp4 into whiteboard
- Install Libre Office:
yum install libreoffice-writer
requires FFMpeg which is not available via standard yum so we’ll add another repository that does contain it. Thanks to needlessly does a “yum update” which would probably update everything seeing as CentOS keep stable older version instead of the bleeding edge
Enabling Recording and import of .avi, .flv, .mov and .mp4 into whiteboard
name=DAG RPM Repository
- Import keys so we can talk to the repository securely:
rpm −−import http://apt.sw.be/RPM-GPG-KEY.dag.txt
- Start installation:
yum install ffmpeg
also requires SOX but that is available on the standard yum so just install that.
yum install sox
I have read through the installation instructions for OpenMeeting and they are as clear as mud. Half the documents seem to say that JODConverter is needed and the other half say that it isn’t. Even the project page for JODConverter says that the project isn’t even maintained. It has some connection to OpenOffice/LibreOffice, so I’m installing it anyway just in case.
- Change back to our scratch folder:
- Go to http://code.google.com/p/jodconverter/
- And download the latest version:
- Then unzip it
Well that’s it for the dependencies. Hopefully OpenMeeting will find all the things it needs during it installation.
After following the original instructions for installing OpenMeeting, the Oracle Java had been replaced by the GNU version of the Java runtime. When I started the OpenMeeting container it use that version instead of the Oracle implementation and didn’t work.
If you install the dependencies in the order that I described above then Oracle’s Java should come out on top. We need to check to make sure though:
- Get which version of Java are you running:
- You should get:
java version “1.7.0_13″
Java™ SE Runtime Environment (build 1.7.0_13-b20)
Java HotSpot™ 64-Bit Server VM (build 23.7-b01, mixed mode)
- If you don’t then you’ll have to uninstall the GNU version:
yum remove gij
rpm -e jre
- And reinstall Oracle’s Java over the top:
- Navigate to: http://www.java.com/en/download/manual.jsp
- And download the appropriate version I selected “Linux x64 RPM".
- Install via the Redhat Package Manager, you might see a couple of errors like “Error: Could not open input file” but you can ignore these.
rpm -i jre-7u13-linux-x64.rpm
OpenMeeting uses a couple of ports to communicate with so make sure your firewall allows traffic on them. For development purposes the following will remove all firewall rules until you reboot.
To start OpenMeeting:
- Change directory:
It should print a lot of information on the screen. There will be pauses and gaps but when it starts repeating no Appointments in range
you are ready for the next step.
You can check [crudely] that the database has been created in MySQL by ensuring that there are plenty of files in:
The final part of the installation is run from the web interface so navigate to:
is the machine you have installed OpenMeeting on.
Click the link Continue with STEP 1
. This will take you to the initial configuration screen where you can set up the application:
In the Userdata
section fill in the admin user
In the Configuration
section I didn’t touch anything but the names seem pretty self explanatory if you know how to set up your mail system (which is beyond the scope of this document).
In the Converters
section we need to add the paths to the support utilities as they won’t be available to the servlet container.
All the Converter support applications should be in your path except jodconverter-core. I still don’t understand if or how JODConverter is needed, so add a reference to the JOD path anyway.
I leave all the other stuff to their defaults.
Finally click INSTALL
screen will spend a couple of minutes spewing out data, so let it get on with it. When it has finished your web browser will sent you to the “Installation Complete!” page.
Click Enter the Application
and login with Username
as admin and Password
The rest is up to you! Good luck.