A JSR-286 portlet that integrates with a VIVO server for searching of semantic web data.
Note: even though it is a JSR-286 portlet and we've made efforts to help it work in other portals, it has only been tested in Liferay 6.0.6. We do not use a Liferay-specific build (it uses Maven without all of the liferay repositories, etc.), but the go.sh script is for Liferay 6.0.6 only. If you are using another portal, just deploy the war.
See the screenshot or the video.
Releases - please right-click to download
- 2011-08-08 - current - working with hardcoded service url. Tested w/Liferay 6.0.6 in Firefox 5.0.1 and Chrome 13.0 in OS X 10.6.
- 2011-06-03 - search not working
- 2011-05-26 - working search but no persistence
You don't have to use Liferay to use the portlet, but the portlet was developed and tested with Liferay.
- Download Liferay 6.0.6.
- If you want to be consistent with other instructions for building, create the path /usr/java/ and unzip Liferay into that directory, so that Liferay's home directory is /usr/java/liferay-portal-6.0.6.
- Start Liferay according to its instructions.
e.g. Here are the commands to use in OS X 10.6:
mkdir -p /usr/java
cd /usr/java
wget http://downloads.sourceforge.net/project/lportal/Liferay%20Portal/6.0.6/liferay-portal-tomcat-6.0.6-20110225.zip?r=&ts=1312902524&use_mirror=cdnetworks-us-2
unzip liferay-portal-tomcat-6.0.6-20110225.zip
cd liferay-portal-6.0.6/tomcat-6.0.29/bin
./startup.sh
Copy the vivo.war you downloaded from the releases section into /usr/java/liferay-portal-6.0.6/deploy.
cp ~/Downloads/vivo.war /usr/java/liferay-portal-6.0.6/deploy/
In Liferay 6.0.6, login and go to Add->More...->Social->Vivo->Add. If you are not logged-in, history is not stored, but search still works.
If you have installed VIVO and VIVO Widgets, then you can have the portlet point at your own VIVO instance.
Modify the portlet's WEB-INF/classes/vivo.properties to set the vivoUrl like:
vivoUrl=http://vivo.example.com/widgets/search.jsonp?query=
Modify the portlet's META-INF/persistence.xml to use your favorite database. It uses H2 as an in-memory-only database by default, so unless you change that, data will not be saved on restart of the portal.
Restart Liferay after making these changes.
Install Maven and follow the instructions on the Maven site for setting it up. Java 6 (or possibly higher) is required.
Running the following command should do a clean build of the portlet. The resulting portlet should be in target/vivo.war:
mvn clean install
If you want to ensure a fresh build and deploy to a completely clean Liferay HSQL database, if you are using OS X 10.6 (or possibly higher) then you can use go.sh if you dare, but please understand that go.sh will DELETE /usr/java/liferay-portal-6.0.6. go.sh uses Maven to build, stops Liferay, deletes Liferay, unzips Liferay, copies the war so that it will be deployed on start, starts Liferay, and tails the log. go.sh may take a few minutes to complete, or longer if your computer is slower.
Copyright (c) 2011 Duke University, released under the MIT license.