Version of Shindig that connects to Profiles. Based on shindig-project-2.0.2 tag
Java JavaScript PHP Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 88 commits behind CTSIatUCSF:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assembly
config
content
etc
extras
features
java
php
shindig-documents
.gitignore
README
pom.xml
screenshot-apache.JPG

README

Prerequisites
	Java 1.6 or higher
	Git
	Maven
	Tomcat 6.x or higher (to run)
	Eclipse 3.7 or higher (optional for building and debugging)
	
Download
	Create an empty directory and from Git Bash type:
		>git clone git@github.com:EricMeeks/shindig-profiles.git

	A shindig-profiles sub-directory will be created with the contents of the code
	
Build
	The project can be built with Maven, but first you need to install jdbc4.jar into your maven repository. 
	Go to shindig-profiles\java\profiles-connector\jdbc\ and type the following command:
		>mvn install:install-file -Dfile=jdbc4-3.0.jar -DgroupId=com.microsoft.jdbc -DartifactId=jdbc4 -Dversion=3.0 -Dpackaging=jar

	See http://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html for more details
	
	Now just go to the top shindig-profiles directory and run maven:
		>mvn
		
	The shindig-profiles\java\server\target\shindig-server-2.0.2.war file will be created.
	
Install
	Create a C:\shindig\conf directory.  
	Copy the shindig-profiles\java\profiles-connector\conf\profiles.shindig.properties file into the directory and edit as needed 
	for your environment.  The four values that require editing are: ProfilesEndpoint, dbURL, dbUser, dbPassword.
	Note that 

	Put shindig-server-2.0.2.war into your webapps directory under Tomcat and rename to shindig.war

	Please view the screenshot-apache.JPG file for an example of the following,
		Add C:\shindig\conf to the BEGINNING of your Java Classpath in Tomcat.
		Add the following two lines to Java Options for Tomcat 
			-Dshindig.host=<your profiles host machine>
			-Dshindig.port=80
			
	Create a secure key for Shindig.  
		The default location for this key is \shindig\openssl\securitytokenkey.txt as set in 
		shindig-profiles\java\profiles-connector\src\main\resources\profiles-container.js
		The easiest way to create the key is to find a linux machine and issue the following command:
			>dd if=/dev/random bs=32 count=1  | openssl base64 > securitytokenkey.txt 

		You can then copy this over to your Profiles windows machine, and place it in a \shindig\openssl directory 
		that you will need to create.

	Start Tomcat.  
	
Eclipse
	Create your eclipse workspace one directory above shindig-profiles
	Import the projects as maven projects:
		File->Import...->Maven->Existing Maven Projects
		Select your workspace directory (the one immediately above shindig-profiles)
		Accept the default of all pom.xml's being recognized

	To build/clean the project:
		Right click shindig-profiles 
			Run As->Maven build
			Run as->Maven clean

	To run in the Debugger
		Open the Java EE perspective
		On Servers tab, right click and add your Tomcat server.
		Double click on the server to bring up the configuration screen.  
		Click to the Modules tab (botton of pane), add an external web module and browse to the exploded 
		shindig-server-2.0.2 WAR (shown below)  
		Set path to /shindig:
			Document base: ..\shindig-profiles\java\server\target\shindig-server-2.0.2
			Path /shindig 
	
		Click back to the Overview tab
		Click the 'Open launch configuration' in the upper left at the bottom of the General Information section.
		On the (x)= Arguments tab add the Java Options as outlined above:
			-Dshindig.host=<your profiles host machine>
			-Dshindig.port=80
			
		On the Classpath tab add C:\shindig\conf under User Entries
			Advanced..->Add External Folder  
			
		You can now run and debug shindig-profiles by starting Tomcat from Eclipse 
			

		











----- STOP--------------
Setting up in Eclipse/Local Testing
	Clear out your old repository by deleting C:\Documents and Settings\meekse\.m2\repository or equivalent
	Follow the instruction in SetupInstrucionsforShindig.pdf.  Use the best branch you can find (currently shindig-project-2.0.0-RC2_
	Make sure that shindig by itself builds in Eclipse and that you can run it in the debugger on Tomcat.  Test.
	From eclipse in the workspace you just created for shindig, go to the https://svn.ctsi.ucsf.edu/ctsi/ctsi-profiles-shindig/trunk
	repository location and check out as a Maven Project
	Accept defaults.  You should see in the file browser that shindig-profiles has been added as a subfolder in your workspace.
	Install SQLServer JDBC Driver (see below) if you have not done so before.
	
Integrating profiles-shindig into shindig
	Check pom.xml in shindig-profiles and make sure the parent info is correct.  Be sure to check that version is correct.
	Add shindig-profiles to the dependencyManagement section of the parent shindig-project/pom.xml.  Make it like the others.
	In the 'all' profile of shindig-project/pom.xml, add ../shindig-profiles as a module immediately after java/social-api.    
	Add shindig-profiles as a dependency to shindig-server/pom.xml.  Make it like the others
	Edit the web.xml.  
		Remove org.apache.shindig.common.PropertiesModule:
		Replace org.apache.shindig.social.sample.SampleModule with edu.ucsf.profiles.shindig.config.ProfilesModule
		Make sure shingid.host and shindig.port are empty, as we need to pass these in via JVM args to Tomcat
		Optionally remove or comment out the other sample and extras modules
		
	In eclipse right click the shindig-profiles project.  Properties->Builders.  Make sure Maven Project Builder is before Validation
	Look at shindig-social-api and make it like that.
	
	Compare profiles.shindig.poperties with conf/shindig.properites in shindig-common
	Compare profiles-container.js with config/container.js in shindig-project
	
	Make sure that profiles.shindig.properties is in the Tomcat class path. 
	Also add appropriate values for the shindig.port and shindig.host 
	(ex -Dshindig.port=80 -Dshindig.host=localhost) to the VM Arguments
	In eclipse do this by editing the launch configuration of Tomcat
	Outside of eclipse this can be done in the Tomcat monitor
	
	If using IIS to front end Tomcat, make sure that you can handle long URL's!

Install SQLServer JDBC Driver into you repository if you have not already done so.
Download jdbc4.jar
C:\>mvn install:install-file -Dfile=jdbc4.jar -DgroupId=com.microsoft.jdbc -DartifactId=jdbc4 -Dversion=3.0 -Dpackaging=jar