Installing PostgreSQL
The Social Annotation Service uses PostgreSQL as a database solution. Please follow installation instructions from the PostgreSQL official website PostgreSQL.
Installing Apache Tomcat 7.x
For the deployment of the Social Annotation Service, Tomcat v7 is recommended.
In order to install Tomcat please follow the instructions in the official website: http://tomcat.apache.org/download-70.cgi
The deployment can be done manually by copying the social-annotation-service.war to Tomcat’s ‘webapps’ directory or through its Manager GUI.
Log4j
Log4j is used for logging in Social Annotation Service. All logs are directed by default to the console. For changing the location of the created logs, their names, the used pattern etc, please edit log4j.properties.
Social Annotation Service¶
Introduction¶
Social Annotation Service takes care of all actions related to the social media (authorization, content posting and retrieval, etc), which remain transparent to the user of the application. The aim is to create an innovative and practical application for automating the process of video annotation with information coming from multiple individuals using the social media.
Functionality¶
A lot of features are supported in Social Annotation Service. The information, is stored in a PostgreSQL database, and is synchronised with the posts on Facebook at runtime to prevent errors when a photo is deleted from Facebook. The database contains information for each photo about:
Use Cases¶
Social Annotation Service was initially designed for and deployed at the Foundation of the Hellenic World. It has also been deployed in the context of two additional experimental applications: CARVIREN (CAR Virtual Environment) and iCaCoT (interactive Camera-based Coaching and Training).
Requirements & Installation¶
Requirements¶
The software required for deploying and running Social Annotation Service:
Installation¶
Installing PostgreSQL¶
The Social Annotation Service uses PostgreSQL as a database solution. Please follow installation instructions from the PostgreSQL official website PostgreSQL.
Download: http://www.postgresql.org/download/
After installing PostgeSQL create the following database and tables:
Installing Apache Tomcat 7.x¶
For the deployment of the Social Annotation Service, Tomcat v7 is recommended.
In order to install Tomcat please follow the instructions in the official website: http://tomcat.apache.org/download-70.cgi
The deployment can be done manually by copying the social-annotation-service.war to Tomcat’s ‘webapps’ directory or through its Manager GUI.
JDK¶
Installing JDK: For more information visit the official Oracle website
Eclipse IDE¶
The usage of Eclipse is recommended to those that want to build the Social Annotation Service project.
More information about Eclipse IDE could be found in the official Eclipse website https://www.eclipse.org
Log4j¶
Log4j is used for logging in Social Annotation Service. All logs are directed by default to the console. For changing the location of the created logs, their names, the used pattern etc, please edit log4j.properties.
Configuration¶
Social Annotation Service is a RESTful web service that uses Jersey distribution packaged in ‘social-annotation-service.war’. All required Java libraries are included inside the WAR. The WAR also includes the following properties files for configuration:
The usage of Eclipse is recommended to those that want to build the Social Annotation Service project and generate a new WAR. For simply running it, open the distributed WAR using a file archiver program for zip format, edit the properties files mentioned above using the instructions that follow and directly save changes in the WAR file.
Note: When Social Annotation Service is first initialized, a daemon monitoring thread for collecting info from FB for the existing photos in the database is created. This time interval is set by default to 20 secs. For changing it, edit property ‘interval’ in social.properties. Note that this time interval is specified in milliseconds.
You can configure Social Annotation Service to connect to the database in its database.properties file by editing the following line:
Prior to the photo being uploaded to FB, this software downloads and stores the image in a given location. This location can be edited in the social.properties file:
Social Annotation Service exchanges data with a given Facebook target location (e.g. an event, a page, a group, etc). This location must be configured by providing the Facebook id of the target event/page/group. The following instructions explain how to create a Facebook User Event or a Facebook Page Event.
A Facebook user or page access token is required. Comprehensive instructions for obtaining such a token can be found here. It is recommended to obtain an extended access user or page token using your own app ID and app secret.
API¶
List of functions¶
Four operations are exposed:
Contact & Support Information¶
Contact¶
Licensing¶