Installation

MoKi is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

To work properly, MoKi has to be installed on a fresh installation of MediaWiki and Semantic MediaWiki. There is no guarantee that any of MoKi's functionality will work on your system. No dedicated uninstall mechanism is provided. We shall not be held responsible for any loss, however caused, by using this software.

Requirements

The requirements to be fullfilled before installing MoKi can be found in the file REQUIREMENTS.

Installation

0. Prerequisites

(We assume that php, java, apache, MySql are all correctly installed. See the requirements section of this file for more details):

  1. Install Mediawiki following the instructions in its README file. During the installation phase you will be asked to create an Admin user for the Wiki. Mind to remember the Admin name and password!
  2. Install the Semantic Mediawiki following the instructions in its README file.
  3. Install the Semantic Forms following the instructions in its README file.
  4. Install the ParserFunctions following the instructions in its README file.
  5. Install/extract YUI in a folder called "yui" in the "extensions" of MediaWiki.

Before proceeding, check that mediawiki is installed and running! Moki has to be installed on an "fresh" mediawiki/semantic mediawiki database.

Check write permission (Linux/Mac OS X only)

In order to configure corretly Moki you have to make the images, extensions, and skins folders (and, recurively, their subfolders/files) writable and executable by the webserver (and the user performing the installation). 
If you don't have strict security issues, you can set the permission of these folders to be writable/readable/executable by all from the command line (go to the {moki_installation_dir}):

  •  chmod -R 777 images
  •  chmod -R 777 extensions
  •  chmod -R 777 skins

1. MoKi Installation

A wizard will help you installing MoKi. Run from the command line/shell :

java -jar MoKi_installer.jar

During the installation you will be asked to indicate the full path of the PHP executable interpreter  (e.g.: c:/php/php.exe), the full path of the  LocalSettings.php file in the mediawiki installation directory (e.g.: 
c:/xampp/htdocs/moki/LocalSettings.php), and the full path of the mediawiki installation deirectory that is the value of {moki_installation_dir} (e.g. c:/xampp/htdocs/moki)
 
At the end of the installation wizard, we suggest to perform a dump of the database tables of mediawiki/semantic mediawiki. This will allow you to start with a fresh MoKi-ready database, in case of need, without having to perform the complete installation from scratch.

 

2. Check that MoKi is correctly installed

To check that the Moki is correctly installed, go to the main page of the mediawiki and check  that:

1. First of all, check that:

  • the extensions folder (i.e. {moki_installation_dir}/extensions) contains a non-empty "MoKi" folder;
  • the images folder (i.e. {moki_installation_dir}/images) contains a non-empty "MoKi" folder;
  • the skins folder (i.e. {moki_installation_dir}/skins) contains a non-empty "moki" folder, and two additional files "MoKi.php" and "MoKi.des.php".


2. Open with a text editor the "LocalSettings.php" file in folder {moki_installation_dir}, and check that at the end of it, you find the following lines:

# MoKi
require_once("extensions/MoKi/MoKi_Settings.php");

 

3. The MoKi style skin is correctly loaded. The skin is violet-based. You should see the MoKi logo on the top-left corner. (check the style of the on-line demo MoKi at moki.fbk.eu for a comparison)

4. The left sidebar should contain a list of functionalities, including "import/export", "visualise", etc. (again, check the on-line demo MoKi at moki.fbk.eu for a comparison). If this new sidebar doesn't appear, use the following manual procedure:

  • Log in as Administrator
  • In the toolbox, click the link SpecialPages, then the link Semantic Page Import
  • Select the file: {moki_installation_dir}/extensions/tmp_moki/Installsetup.xml

  • Click "upload".

5. Try adding some concepts, indivudlas, properties and processes, and check that they are correctly visualised by the listing/visualise functionalities. Try also the export functionalities, and check that the files obtained are not empty. (if you performed a dump of the DB at the end of the installer, you reset the DB with that file, without having to delete each of the "testing" pages you have added).

3. Create users

The pages of MoKi are visible only to registered users. To create a new user, you have to:

  • Under SpecialPages, select the link  "Log in / create account"

Once you have created the user, you have to assign him to a group:

  • Under SpecialPages, select the link "User rights management"

enter the user name of the user to assign to a group, and click on "Edit user groups". Choose one of the following group:

  • registered: its members have access to all the Moki's functionalities
  • reviewers: its memebers can only view the pages but can't edit/modify them

WARNING: since users are also stored in the database of mediawiki, if you restore MoKI to a previous dump of the database, all users created after the dump of the database has been made will be lost! 

4. Enable MoKi Import and Export Functionalities

To enable importing OWL files directly into MoKi and Exporting OWL files from MoKi, installation of additional software is required:

  • To enable the Import you have to provide a converter that given an Ontology written in OWL, creates a MoKi compliant file.
  • To enable the Export you have to provide a converter from MoKi files to OWL.

We have developed a java version of these converters called OWL2MoKi. It can be downloaded from the here. To install it inside MoKi please follow the instructions in the README file included in the zip package.

Enjoy!