Installing omCollab

From MIKE2.0 Methodology

omCollab is a composite product that brings together capabilites from multiple products such as mediawiki and wordpress.

Installing from the omCollab Package

Here is the approach to very quickly install omCollab. This installation process allows you to get a local or development environment up and ready to go in a matter of minutes.

• Download xampp: http://www.apachefriends.org/en/xampp-windows.html. xampp will give you an installation of apache (web server), php (server-side scripting language for running web pages) mySQL (database) and PHPMyAdmin (web-based database administration)

• Install xampp, following the instructions on the site. The easiest way to install xampp is through the installer.

• Download omCollab: current version. This will give you a collaborative environment that includes wikis, blogs, social bookmarking, social networking, etc. All in a single install.

• Unzip omCollab

• Go to the root directory where you installed xampp and copy the entire contents in the xampp/htdocs/ directory

• Follow the instructions in the Readme file, which is in the omCollab root directory. The main steps include:

Example URLs assume you unzipped omCollab in to xampp/htdocs/omCollab and you are not using virtual hosts

• • Creating a database user and 3 databases within phpmyadmin (installed via xampp).

Example to go to phpmyadmin: http://localhost/phpmyadmin/

• • Launching a web browser to the omCollab directory and populating the configuration for omCollab.

Example to go to phpmyadmin: http://localhost/omCollab/

• • Delete config files produced as per instructions

That’s it. You’re ready to go – with an out of the box solution for advanced collaboration!

There are a few minor issues with the current install, but you will be able to get everything running. We will release a patched version in the next day or 2.

Install Notes

Common install issues due to platform configuration:

Blogs Error

The Blogs module may throw an error in current package. If so:

• Go to your httpd.conf file in the \xampp\apache\conf directory
• Edit the file and enable LoadModule expires_module modules/mod_expires.so

Curl not enabled

If you see something like Fatal error: Call to undefined function curl_init() in C:\xampp\htdocs\omCollab\w\extensions\APIQueryExtension\APIQueryExtension.php on line 154

Do the following:

• Go to xampp\apache\bin
• Open php.ini
• Look for extension=php_curl.dll
• Uncomment this line by removing the semicolon
• Does this work? If not, you might need to restart apache. With xampp this would be: start->programs->apache friends->xampp->xampp control panel.

file_get_contents

To enable allow_url_fopen in php.ini

If you find page block in local deployment when you use "http://localhost" to access omcollab. Please open the hosts file.

c:\windows\system32\drivers\etc\hosts

Open the file with notepad and you will see 2 entries for local host like this:

127.0.0.1 localhost
::1 localhost

Just delete the second one so you only have

127.0.0.1 localhost

Forums

Installation and configuration of omForums (based on phpBB) is not as smooth yet as for the other applications.

• If you install omCollab on Windows, make sure you have the php module mysqli installed. Most Linux based hosting providers already include it.
• Double check that the database authentication variables in config.php are correct. The build.php script is supposed to take care of this, but doesn't always succeed ;)
• Once you have successfully installed omCollab and forums, you need to do some manual configuration of forums:
  • The first user available to you is Admin. Log in as Admin to manage forums and permissions.
  • You should see a link called Administration Control Panel on the bottom of the page.
    • If not, your current user doesn't have Administrator privileges. You can assign a user to the Administrator group by setting usertype = 3 in the users table in the database.
    • Click on Board Settings to set a proper site name.
    • Click on Manage Forums to remove the default forums and add the forums you would like to have.
    • Don't forget that you need to set permissions for registered and anonymous users to have access to your forums.
    • Make sure you set the Return email address and other email settings using the 'E-mail settings' link in the left menu.

Downloads

Current Version

Legacy Versions

Installing from svn

You can access the latest code for omCollab by browsing to http://waterloo.openmethodology.org/trac/omcollab/. This will take you to the trac interface which we use for software release management. If you do not you have a subversion client or want more than the code itself, use this link.

The url to directly connect via a subversion client is http://waterloo.openmethodology.org/svn/omcollab. Our development team is using eclipse. Installation and user guides on eclipse can be found on the eclipse site; we've also posted a brief set of instructions on how to install the software.

We'll soon be posting more detailed instructions around how this works, our development model and recommeded methods for intergration.

Upgrading omCollab

Scripts have been provided for migrating from prior versions of omCollab

DB Migration Scripts

For migrations between versions where a DB upgrade is required, scripts are provided in the Installation Resources directory.

Upgrade to 1.100.0

You need to use manual installation method for upgrading omcollab from 1.010.x to 1.100.0.

• Edit build.bat or build.sh to suit your system environment.
• Let PreserveData be y to keep the legacy database unmodified in the upgrade process.
• Run build.bat or build.sh to upgrade omcollab application
• Edit AdminSetttings.php to suit your wiki database configuration.
• Run these commands to upgrade wiki database

(Windows)

cd wiki\maintenance
php update.php --aconf ..\AdminSettings.php

(Linux)

cd wiki/maintenance
php update.php --aconf ../AdminSettings.php

Now your omcollab is upgraded to 1.100.0.

Upgrade to 1.100.3

In addition to normal deployment process, omwiki_migration_11002_11003.sql is provided to upgrade wiki database from 1.100.1 or 1.100.2 to 1.100.3. You will find this file in _InstallationResources directory. Maybe you have to do some modification on this script to match the DB table prefix.

Note: build.php and omconfig.php are updated in this version.

Upgrade to 1.200.5

If you don’t see any data in home page, please access the url http://your_domain/home/home_cache_cron.php?key=enter_your_key .The value of the key is configurable in the omconfig.php.

And you also need to do:

• 1. cd your_installation_dir/home/
• 2. mkdir omcache
• 3. chmod 777 omcache (you can use chown , just make sure apache is of read and write permission in the directory is ok)
• 4. crontab –e
• 5. Add this line:

#update cache of omcollab
30 * * * * /usr/bin/curl -s -o /dev/null http://your_domain/home/home_cache_cron.php?key=enter_your_key