Difference between revisions of "Social Portal Extension Setup"

From Gcube Wiki
Jump to: navigation, search
(Get the needed dependencies for the Social Extension)
m
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
[[Category:Administrator's Guide]]
 +
== Get the latest gCube Portal Bundle ==
 +
 +
http://gcube.wiki.gcube-system.org/gcube/index.php/GCube_Portal_Installation and install it.
 +
 
== Get the needed dependencies for the Social Extension ==
 
== Get the needed dependencies for the Social Extension ==
  
* Social Networking Library from maven (get the latest) [http://maven.research-infrastructures.eu/nexus/index.html#nexus-search;quick~social-networking nexus-search;quick~social-networking]
+
Social Networking Library from maven (get the latest) [http://maven.research-infrastructures.eu/nexus/index.html#nexus-search;quick~social-networking nexus-search;quick~social-networking]
  
 
<source lang="xml">
 
<source lang="xml">
Line 21: Line 26:
 
</dependency>
 
</dependency>
 
</source>
 
</source>
 +
 +
* Get the latest [http://gcube.wiki.gcube-system.org/gcube/index.php/ASL#ASL_Social_Extension ASL Social Extension] and copy it into the $GLOBUS_LOCATION/lib/_application-support-layer folder
 +
 +
== Notifications ==
 +
For notifications to work you will need to deploy the Notification Servlet on the Portal. The client code is instead implemented in the social-dockbar-hook provided in the portal bundle.
 +
 +
<source lang="xml">
 +
<dependency>
 +
  <groupId>org.gcube.portal</groupId>
 +
  <artifactId>notificationchecker</artifactId>
 +
  <version>0.1.0-SNAPSHOT</version>
 +
  <type>war</type>
 +
</dependency>
 +
</source>
 +
 +
== Create the Social Portal Layout on Liferay ==
 +
 +
The Layout of the Data e-Infrastructure Gateway Community must be updated, the following pages should be created (pay attention to friendly url and the hidden property)
 +
 +
* Workspace
 +
** Name: Workspace
 +
** Friendly URL: workspace
 +
** Visibility: hidden
 +
 +
* Messages
 +
** Name: Messages
 +
** Friendly URL: messages
 +
** Visibility: hidden
 +
 +
* Notifications
 +
** Name: Notifications
 +
** Friendly URL: notifications
 +
** Visibility: hidden
 +
 +
* Profile
 +
** Name: Profile
 +
** Friendly URL: profile
 +
** Visibility: visible
 +
 +
* Join New
 +
** Name: Join New
 +
** Friendly URL: join-new
 +
** Visibility: visible
 +
 +
Populate the pages with the related portlets.
 +
 +
== Required portlets and Configuration steps ==
 +
 +
The following portlets need then to be installed on the portal:
 +
 +
* portlets-user.join-new-environment
 +
* portlets-user.myvres
 +
* portlets-user.newsfeed
 +
* portlets-user.notifications
 +
* portlets-user.shareupdates
 +
* portlets-user.messages
 +
* portlets-user.socialprofile
 +
 +
The following widgets has to be installed under $GLOBUS_LOCATION/lib/_ext
 +
 +
* portlets-user.wsmailwidget
 +
* portlets-user.application-news-widget
 +
 +
please note that in order to use the correct webapp context the notificationcheker servlet installation folder should be ''notificationchecker'', so you should rename the folder under $CATALINA_HOME/webapps from notificationchecker-X.Y.Z to  ''notificationchecker''
 +
 +
== Staging Procedure ==
 +
 +
The Cassandra Cluster needs to be "staged" the first time you are going to use it.
 +
 +
* Create the RuntimeResource for the Cassandra Cluster
 +
** The Runtime Resource with name SocialPortalDataStore of type Database must be created in the root Vo of the infrastructure.
 +
*** The Access Point part should have the following settings:
 +
 +
<source lang="xml">
 +
...
 +
<AccessPoint>       
 +
        <Description>$CLUSTER_NAME</Description>
 +
        <Interface>
 +
            <Endpoint EntryName="$KEYSPACE_NAME">$HOST:$PORT</Endpoint>
 +
        </Interface>
 +
....
 +
</source>
 +
 +
* Create the RuntimeResource for the Files Storage
 +
** The Runtime Resource with name SocialPortalDataStore of type FTPServer must be created in the root Vo of the infrastructure.
 +
*** The Access Point part should have the following settings:
 +
 +
<source lang="xml">
 +
...
 +
<AccessPoint>       
 +
        <Description>FTP Server</Description>
 +
        <Interface>
 +
            <Endpoint EntryName="D4Science.org FTP Server">ftp.d4science.org</Endpoint>
 +
        </Interface>
 +
....
 +
</source>
 +
 +
 +
* Setup the KeySpace
 +
** This was not automatized yet. Please contact [mailto:massimiliano-DOT-assante-AT-isti-DOT-cnr-DOT-it Massimiliano Assante]

Latest revision as of 09:08, 24 July 2013

Get the latest gCube Portal Bundle

http://gcube.wiki.gcube-system.org/gcube/index.php/GCube_Portal_Installation and install it.

Get the needed dependencies for the Social Extension

Social Networking Library from maven (get the latest) nexus-search;quick~social-networking

<dependency>
  <groupId>org.gcube.portal</groupId>
  <artifactId>social-networking-library</artifactId>
  <version>1.0.0-SNAPSHOT</version>
</dependency>
  • Create a folder _social-library in $GLOBUS_LOCATION/lib
  • Copy in the yet created floder the SNL Dependencies & the Netflix Astyanax Dependencies:
<dependency>
  <groupId>com.netflix.astyanax</groupId>
  <artifactId>astyanax</artifactId>
  <version>CHECK THE VERSION IN SNL POM</version>
</dependency>
  • Get the latest ASL Social Extension and copy it into the $GLOBUS_LOCATION/lib/_application-support-layer folder

Notifications

For notifications to work you will need to deploy the Notification Servlet on the Portal. The client code is instead implemented in the social-dockbar-hook provided in the portal bundle.

<dependency>
  <groupId>org.gcube.portal</groupId>
  <artifactId>notificationchecker</artifactId>
  <version>0.1.0-SNAPSHOT</version>
  <type>war</type>
</dependency>

Create the Social Portal Layout on Liferay

The Layout of the Data e-Infrastructure Gateway Community must be updated, the following pages should be created (pay attention to friendly url and the hidden property)

  • Workspace
    • Name: Workspace
    • Friendly URL: workspace
    • Visibility: hidden
  • Messages
    • Name: Messages
    • Friendly URL: messages
    • Visibility: hidden
  • Notifications
    • Name: Notifications
    • Friendly URL: notifications
    • Visibility: hidden
  • Profile
    • Name: Profile
    • Friendly URL: profile
    • Visibility: visible
  • Join New
    • Name: Join New
    • Friendly URL: join-new
    • Visibility: visible

Populate the pages with the related portlets.

Required portlets and Configuration steps

The following portlets need then to be installed on the portal:

  • portlets-user.join-new-environment
  • portlets-user.myvres
  • portlets-user.newsfeed
  • portlets-user.notifications
  • portlets-user.shareupdates
  • portlets-user.messages
  • portlets-user.socialprofile

The following widgets has to be installed under $GLOBUS_LOCATION/lib/_ext

  • portlets-user.wsmailwidget
  • portlets-user.application-news-widget

please note that in order to use the correct webapp context the notificationcheker servlet installation folder should be notificationchecker, so you should rename the folder under $CATALINA_HOME/webapps from notificationchecker-X.Y.Z to notificationchecker

Staging Procedure

The Cassandra Cluster needs to be "staged" the first time you are going to use it.

  • Create the RuntimeResource for the Cassandra Cluster
    • The Runtime Resource with name SocialPortalDataStore of type Database must be created in the root Vo of the infrastructure.
      • The Access Point part should have the following settings:
...
 <AccessPoint>        
         <Description>$CLUSTER_NAME</Description>
         <Interface>
            <Endpoint EntryName="$KEYSPACE_NAME">$HOST:$PORT</Endpoint>
         </Interface>
....
  • Create the RuntimeResource for the Files Storage
    • The Runtime Resource with name SocialPortalDataStore of type FTPServer must be created in the root Vo of the infrastructure.
      • The Access Point part should have the following settings:
...
 <AccessPoint>        
         <Description>FTP Server</Description>
         <Interface>
            <Endpoint EntryName="D4Science.org FTP Server">ftp.d4science.org</Endpoint>
         </Interface>
....