This guide will walk you through the steps to get Shindig up and running on windows.
The WAMP stack stands for apache, mysql and php on windows, and is required for running Shindig. In this guide I'll use an easy to run and configure free (GPL) stack called 'wampserver'.
First download the wampserver from: http://www.en.wampserver.com/
Click the download link, save the file on your desktop, and then execute it.
In the installer just click 'next' on every step, the defaults are fine and the default locations will be used in this guide.
After installing it you will probably get a warning like the one below, click 'unblock' to allow your new apache server to listen on port 80.
After the wampserver install, it's time to configure the modules that Shindig requires, once the wampserver is started you will have a new icon in your icon tray (bottom right of your screen) and by LEFT clicking it you will get various options to configure it.
For Shindig we need a couple of things, first you need to enable mod_rewrite support for apache, so go to the Apache -> Apache Modules option, and click on the 'rewrite_module' option to enable it.
* note: on my computer it did enable the module on clicking it, but it did not put a check before it when i did. This is rather confusing and probably a bug in the wampserver.. however it works just fine so if you have the same happen to you, just ignore the fact that it's not 'checked', it will show up once we restart the server.
Next we need to configure the correct PHP extentions that Shindig requires, you can do this through the PHP -> PHP Extentions menu and you enable extentions by clicking them, just like we did for apache.
The required extentions are:
If an extention isn't checked (like mcrypt which is off by default) click it .. and like the apache module, sometimes the check doesn't show up right away ... it's safe to ignore this and assume it worked.
Next we need a SVN client to check out the source code to Shindig, Tortoise is a nice graphical interface for this so that's what we'll be using. Download it from http://tortoisesvn.tigris.org/
Run the installer, again default options are fine
And once the installer is done, you have to reboot
Once we're back, we'll check out the source code of Shindig. First go to the web root directory (c:\wamp\www) and create a shindig directory:
Go into the shindig folder, right click and select SVN Checkout (this is the menu tortoise added):
In the following dialog enter the location of the SVN repository http://svn.apache.org/repos/asf/incubator/shindig/trunk/ as follows:
Click ok and you should see a screen like this, it's now downloading the code:
Once your done, you should have a shindig directory that looks like this:
First locate your apache configuration file (which is called httpd.conf), this will be in c:\wamp\bin\apache\apache2.2.8\conf. We want to configure 'virtual hosts' on our instalation since we need a shindig server on one 'domain' and later on in the next guide we want partuza on another domain name. This is required for the cross domain security model of your browser to work, which is the basis of the security model of open social gadgets. We'll also add a 'localhost' domain as the first entry so that http://localhost keeps working as expected (for the wampserver entry screen, phpadmin, etc). Remember that the first entry in your virtual host configuration will also be the default host if the host name isn't recognized, so please keep to the order as you see them in this guide.
Open the file, scroll to the end and locate the section that reads #Include conf/extra/httpd-vhosts.conf, and remove the # before the Include as such:
The go into the extra folder, and open the httpd-vhosts.conf file:
Edit this file, remove the 2 example vhost configurations (they don't work) and add the following 2 entries (for the localhost and shindig virtual hosts)
Next we need to let windows know about the 'shindig' host name, you do this by editing c:\WINDOWS\system32\drivers\etc\hosts :
And adding 'shindig' (without quotes) to the following line:
After this is done, restart your wamp server through the tray icon: left click it, and select 'Restart All Services':
Point your browser to http://shindig/gadgets/ifr?url=http://www.labpixies.com/campaigns/todo/todo.xml
And you should see the todo gadget being rendered; This means shindig is now fully up and running on you computer
And with that this guide ends, you now have your own Open Social gadget server up and running. In the next guide we'll go through setting up Partuza, which is an example Social Network Site (or "Open Social Container" as we also call it): http://www.chabotc.com/guides/partuza_install/