| content
| - %META:TOPICPARENT{name="ODSIndex"}%
---+ Setting up <nop>PubSubHub in ODS
%TOC%
---++ Introduction
<nop>PubSubHub (PSH) setup consists of two steps:
1 Set up the ODS server.
1 Configure applications to publish to hub.
These steps are detailed below.
---++Prerequisites
The following packages should be installed:
* <code>[[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.1/virtuoso/ods_framework_dav.vad][ods_framework_dav.vad]]</code>
* <code>[[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.1/virtuoso/pubsubhub_dav.vad][pubsubhub_dav.vad]]</code>
* <code>[[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.1/virtuoso/ods_blog_dav.vad][ods_blog_dav.vad]]</code>
* <code>[[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.1/virtuoso/ods_feedmanager_dav.vad][ods_feedmanager_dav.vad]]</code>
---++ Set up the ODS server
PSH setup on the ODS Server takes two steps, performed while logged in as the <code>dav</code> <nop>WebDAV System Administrator user, through the <b>Site Settings</b> link of ODS UI:
1 In the <b>Feed Instances with Admin Rights</b> section , specify the PSH endpoint. This setting tells applications what to report for PSH auto-discovery:
%BR%%BR%<img src="%ATTACHURLPATH%/step1.png" style="wikiautogen"/>%BR%%BR%
2 The <b>Notification Services</b> UI is used to set up the PSH publish service endpoint, to which ODS users can point their applications:
%BR%%BR%<img src="%ATTACHURLPATH%/step2.png" style="wikiautogen"/>%BR%%BR%
* Enter for Endpoint: <b><code><nowiki>http://<host>:<port>/psh/</nowiki></code></b> (modified for your instance, e.g., <b><code><nowiki>http://myhost.example.com:8889/psh/</nowiki></code></b>)
* Enter for Notification Service: <b><code><nowiki>PubSubHub</nowiki></code></b>
* Select Protocol: <b><code><nowiki>PubSubHub</nowiki></code></b>
ODS applications can now be configured to publish messages to the PSH endpoint.
---++ Configure an ODS application to publish via PSH
1 Log in as the <b><code>dav</code></b> user.
1 Go to <b>ODS</b> -> <b>Application Settings</b> -> <b>Application Notifications</b>
1 Select the default 'dav' blog from the top menu, and highlight the <b>PubSubHub</b> Notification Service. (You may command-click to select multiple notification targets.)
%BR%%BR%<img src="%ATTACHURLPATH%/step3.png" style="wikiautogen"/>%BR%%BR%
1 Click <b>Add</b> to make your setting take effect.
---++ Test the setup using ODS-Feed Manager and basic PSH Subscription UI
For our test, we use ODS-Weblog as publisher and ODS-Feed Manager as subscriber.
First, in ODS-Feed Manager we subscribe to the rss feed:
1 Log in as a normal user, e.g., <b><code>demo</code></b>
1 Go to the Feed Manager application.
1 Go to <b>Administration</b> -> <b>Feeds</b> and click <b>Subscribe</b>.
%BR%%BR%<img src="%ATTACHURLPATH%/p1.png" style="wikiautogen"/>%BR%%BR%
1 Select <b>From URL...</b> and click <b>Next</b>.
1 In <b>From URL (RSS/Atom/OPML/OCS/SIOC ...)</b> field, enter the Weblog Feed URL, e.g.,
<verbatim>
http://myhost.example.com/weblog/dav/dav-blog-0/gems/rss.xml
</verbatim>
%BR%%BR%<img src="%ATTACHURLPATH%/p2.png" style="wikiautogen"/>%BR%%BR%
1 Click <b>Subscribe</b>
%BR%%BR%<img src="%ATTACHURLPATH%/p3.png" style="wikiautogen"/>%BR%%BR%
1 The PSH Server value will be shown, and <b>PubSubHub Enable</b> will be checked. Click <b>Subscribe</b> again.
%BR%%BR%<img src="%ATTACHURLPATH%/p4.png" style="wikiautogen"/>%BR%%BR%
Now, we publish something on the 'dav' weblog:
%BR%%BR%<img src="%ATTACHURLPATH%/p5.png" style="wikiautogen"/>%BR%%BR%
Notification is made to the PSH endpoint, and the Feed Manager is notified to update its subscription content.
%BR%%BR%<img src="%ATTACHURLPATH%/p6.png" style="wikiautogen"/>%BR%%BR%
---++Related
* [[VirtPubSubHub][PubSubHubbub Demo Client Example]]
* [[VirtFeedPubSubHub][Example feed subscription via PubSubHub Protocol]]
* [[VirtPubSubHubACL][Setting Up PubSubHub to use WebID Protocol- or IP-based control lists]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSPARQLSSL][Creating and Using a SPARQL-SSL based Endpoint]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtAuthServerUI][Set WebID Protocol ACLs using the Virtuoso Authentication Server UI]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtAuthFOAFSSLACL][WebID Protocol ACLs Tutorial]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtOAuthSPARQL][SPARQL OAuth Tutorial]]
* [[VirtODSFOAFSSL][WebID Protocol Support in OpenLink Data Spaces]]
* [[ODSPkiSetup][Guide to Setting up a X.509 certificate issuer and HTTPS listener and Generating ODS user certificates]]
* [[OdsKeyImport][CA Keys Import using Conductor]]
* [[ODSGenerateX509Certificate][Generate an X.509 Certificate hosted WebID Guide]]
* [[ODSBriefcaseFOAFSSLShareFile][ODS Briefcase WebID Protocol Share File Guide]]
* [[http://esw.w3.org/topic/foaf+ssl][WebID Protocol Specification]]
* [[https://foaf.me/simpleLogin.php][Test WebID Protocol Certificate page]]
* [[http://test.foafssl.org/cert/][WebID Protocol Certificate Generation page]]
* [[https://demo.openlinksw.com/sparql-ssl][Virtuoso Demo SPARQL-SSL Endpoint]]
|
![[RDF Data]](/fct/images/sw-rdf-blue.png)
![[cxml]](/fct/images/cxml_doc.png)
![[csv]](/fct/images/csv_doc.png)
![[text]](/fct/images/ntriples_doc.png)
![[turtle]](/fct/images/n3turtle_doc.png)
![[ld+json]](/fct/images/jsonld_doc.png)
![[rdf+json]](/fct/images/json_doc.png)
![[rdf+xml]](/fct/images/xml_doc.png)
![[atom+xml]](/fct/images/atom_doc.png)
![[html]](/fct/images/html_doc.png)