From SMW+ A Semantic Web Enterprise Wiki

Jump to: navigation, search
Smw plus help icon 32x32.gif Installing SMW+ 1.6.0 (Windows installer)
Created by: User:Dominika | Status: Final version Icon audience.png For audience: Administrator

This article gives step-by-step instructions on the entire process of installing Semantic MediaWiki plus (SMW+) Community Edition using the Windows installation tool. The same steps are to be followed while installing Semantic MediaWiki plus (SMW+) Professional.

This documentation applies to the latest version. If you are using an earlier version, no other releases.
User manual information
Applies to version: Help:SMW+ 1.6.0,
Note: Use the tree-view on the right hand side to navigate in the documentation

Contents

Introduction

The SMW+ 1.6.0 Windows installer or the SMW+ 1.6.0 VMware image may be downloaded from our Download page. To acquire SMW+ Professional, please go to to our web shop.

Requirements

These are the installation prerequisites for SMW+ 1.6.0 (Windows installer):

SMW+ 1.6.0 (Windows installer) is pre-configured to be installed in a MS Windows Environment. SMW+ is approved to run on the following Windows versions:

  • Windows 7 (Professional, Ultimate or Enterprise)
  • Microsoft Windows Server 2008 R2 (R2 is important!)


Supported Browsers

The SMW+ front-end runs in the web browser. SMW+ 1.6.x has been approved for the following browsers:

  • IE 8.x (which MUST NOT run in compatibility mode)
  • Mozilla Firefox (7 and 8)
  • Google Chrome (15)

The Installation Wizard

1. Start the installation process by copying the SMW+ distribution into the file system of the server where SMW+ is to be operated on. Double click or select Open in the file's context menu to launch the installation tool.

Step 1 - Launching the installation tool
- successful installation start shall be accompanied by a welcome screen similar to the one illustrated below.

2. Click Next to proceed with the installation process.

Step 2 - The welcome screen
- clicking Next displays the License agreement of SMW+ Community Edition and SMW+ Professional in the installation tool.

3. Read the License agreement of SMW+ Community Edition and SMW+ Professional carefully and check the I accept the terms in the License Agreement if you do and click Next

If you do not accept the terms, you may click Cancel – doing this will abort the installation process.
Step 3 - License agreement of SMW+ Community Edition and SMW+ Professional
- this opens the License Agreement of third party components.

4. Read the License Agreement of third party components carefully and click I Agree, that is if you accept the conditions of the agreement.

If you do not agree to the agreement, you may go on to click Cancel – doing this will abort the installation process.
Step 4 - License Agreement of third party components

5. Select the mode of installation you wish to run.
There are two available options:

  • New: Select this mode if you are installing SMW+ for the first time on your computer.
  • Custom: This mode lets you make a selection on whether XAMPP should be installed in addition to the SMW+ core.


Step 5 - Selecting the type of installation

6. The installation shall then make a proposal about the destination folder of your SMW+ installation. This is the folder where all files and third party components needed to operate SMW+ will be. Browse to a different destination folder on your server by clicking on Browse which opens a folder selection dialog.
Once you verify your desired destination folder in your server’s file system, proceed with the installation process by clicking Next.

Warning.png  Important note:
Note that SMW+ must not be installed in directories containing parentheses like "Programs". Note that you don't have full write privileges for "C:\Program files", even as an Admin.
Step 6 - Selecting the destination folder

7. At this level, you can decide whether shortcuts should be created on the start menu folder or not. If you do not want the shortcuts, just activate the 'Do not create shortcuts' box.

Step 7 - Defining the shortcut option


8. Now enter your local IP address for the Lucene settings. You may leave the field blank and the system will in this case automatically obtain your IP address. In some cases, such as virtual network devices, it is recommended that one enters the IP manually.

Step 8 - Defining the IP address

9. The installation tool will at this point offer options which may be used to customize your SMW+ installation. The options available are:

  • Wiki name: This should be the name that will be displayed in the browser’s title bar when using SMW+.
  • Wiki logo: This logo will be displayed on the upper left corner of every wiki page.
  • Language: One may currently use English or German as the wiki content language.
  • Skin: The skin allows the customization of your wiki layout. SMW+ comes with a predefined skin that goes by the name ontoskin3. You may customize this at a later point of time.


Step 9 - Customizing your SMW+ installation


10. Select install to run the installation process.

Information.png  Note:
SMW+ needs TCP port 80. If any application or a service blocks this port, you will be prompted to close this application.
Step 10 - Installation in progress

11. SMW+ will install two processes that need to freely access different ports. Windows may ask you if it should block these ports. In order to run the SMW+, it is necessary that you unblock these processes.

One process is the Apache WebServer which the wiki uses and the second one is the MySQL database which is used for storing the content.


Step 11 - Windows firewall warning

12. The installation process will have completed successfully if the installation tool displays the "Completing the SMW+ v.1.6 Setup Wizard" window.

Information.png  Note:
We recommended that you activate the "Run wiki on startup (installs Windows services)" tick box – Activating this option adds the processes of Apache, MySQL, and Solr server to the Autostart of Windows. Additionally the processes Apache and MySQL are registered as Windows services per default.

13. Click on Finish to close the installation tool.

Step 13 - Window indicating successful installation

14. Six different SMW+ icons should now shop up in the start menu under SMW+ program path:

  • SMW+ Main Page – Opens the Main Page
  • Start SMW+ – Starts the Apache webserver and the database
  • Start Solr – Solr is the popular, blazing fast open source enterprise search platform from the Apache Lucene project. Semantic MediaWiki plus uses Solr for the powerful faceted browsing feature
  • Stop SMW+ – Stops the Apache webserver and the database
  • Stop Solr – Stops Solr
  • UninstallUninstall SMW+
New start menu items
Information.png  Note:
Solr
With the full integration of Solr in the release SMW+ 1.6.0, the indexing of all wiki articles allows fast full text search with extended functionality. The Lucene search is not supported in release 1.6.0 and above. If you still wish to use the "old" Lucene search, use earlier versions.

Starting SMW+

15. Open the start menu and select All programs > SMW+ Community Edition v1.6.x > Start SMW+ to start the Apache web server and MySQL database server.

Information.png  Note:
You can alternatively use the XAMPP control panel to start both servers by opening the SMW+ installation directory, double clicking xampp-control.exe and clicking Apache-start and MySQL-start.

16. Open the start menu and select All programs > SMW+ Community Edition v1.6.x > Start Solr to start the Solr server, which fetches triples from the wiki. The first startup a Solr index is created.

17. Open the start menu and select All programs > SMW+ Community Edition v1.6.x > SMW+ Main Page to open the Main Page of the wiki in your default web browser.

Step 17 - Image depicting the Wiki's Main Page after successful installation of SMW+
Information.png  Note:
You can alternatively enter the following URL into the URL-field of your web browser to open the Main Page of the wiki directly: 'http://localhost/mediawiki/index.php' (You can use "127.0.0.1" instead of "localhost")

Database access

If you need direct database access for any reason, the default credentials are:

user: root
password: m8nix

We strongly recommend that you change these credentials for security reasons.


Configuring SMW+ as a Service

You can register SMW+ so that it automatically restarts after a shutdown. To do this:

  1. Go to the SMW+ installation directory
  2. Open xampp-control.exe
    Opening xampp-control.exe
    - this opens the XAMPP Control Panel
  3. Click Service...
    The XAMPP Control Panel
  4. Register Apache and MySQL as Windows services:
    XamppControlPanel.png
  5. Click OK
    Information.png  Note:
    If you have the Triple store connector also installed as a Windows service, it restarts after a shutdown too.


Logging into SMW+

1. Log into the Wiki as administrator (a.k.a. "WikiSysop") by clicking on 'Log in' and entering the credentials for the administrator account.

The default credentials for the administrator account are:

username: WikiSysop
password: root
Information.png  Note:
We strongly recommend that you change the WikiSysop account password on the preferences page once you log into the wiki successfully.

2. Open the special page Special:Preferences and select to the Change Password section to change the administrator password.

Information.png  Note:
Once you log in for the first time as administrator (a.k.a. WikiSysop), you will be advised to change the administrator account password. Refer to this Logging in article so as to learn more about your account and how to set your personal preferences.

Bring SMW+ up-to-date

After you have installed SMW+ make sure that your installation is up-to-date and all needed services are running. It is important that you follow these instructions before giving other users access to the Wiki or starting productive work. We also highly recommend to repeat these instructions from time to time.


Getting started with installation of SMW+

Please refer to the Getting Started Guide, for information and tips on how to use SMW+ for the first time. Read the how to extend SMW+ user guide if you wish to add more extensions to SMW+.


Troubleshooting your SMW+


Upgrade information

We encourage you to always keep your installation of SMW+ up-to-date; this ensures that you have always the latest features and bug fixes. Use the Wiki Administration Tool (already part of SMW+) to perform the upgrade.

Comment icon crystal.png

Static facts Derived facts
Facts about Installing SMW+ 1.6.0 (Windows installer)RDF feed
Content titleInstalling SMW+ 1.6.0 (Windows installer)  +
Creation dateThis property is a special property in this wiki.15 November 2011 15:33:42  +
CreatorThis property is a special property in this wiki.Dominika  +
For audienceAdministrator  +
Has StatusFinal version  +
Has overviewThis article gives step-by-step instructio This article gives step-by-step instructions on the entire process of installing Semantic MediaWiki plus (SMW+) Community Edition using the Windows installation tool. The same steps are to be followed while installing Semantic MediaWiki plus (SMW+) Professional. mantic MediaWiki plus (SMW+) Professional.
Has prerequisitesSMW+ 1.6.0  +
Last modified byThis property is a special property in this wiki.Dominika  +
Position in subsection overview1  +
Reviewed byDominika  +
Subsection ofInstalling SMW+ 1.6.0  +
Transitive Subsection ofInstalling SMW+ 1.6.0  +
This page was last modified on 14 March 2012, at 07:33.This page has been accessed 1,499 times.
SemanticTreeview close tree