{"action":"created","comment":{"url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/comments/25934883","id":25934883,"diff_hunk":"@@ -1 +1,154 @@\n-TBD\n+#Cygnus Quick Start Guide\n+This quick start overviews the steps a newbie programmer will have to follow in order to get familiar with Cygnus and its basic functionality. For more detailed information, please refer to the [Cygnus GitHub](https://github.com/telefonicaid/fiware-connectors).\n+\n+##Basic knowlegde about Cygnus\n+Previous to installing and using it, you should know a couple of things about Cygnus.\n+\n+###What is is for?\n+Cygnus is a connector in charge of persisting Orion context data in certain configured third-party storages, creating an historical view of such data. In other words, Orion only stores the last value regarding an entity's attribute, and if an older value is required then you will have to persist it in other storage, value by value, using Cygnus.\n+\n+###How does it receives context data from Orion Context Broker?\n+Cygnus uses the subscription/notification feature of Orion. A subscription is made in Orion on behalf of Cygnus, detailing which entities we want to be notified for when an update occurs on any of those entities attributes.\n+\n+###Which storages is it able to integrate?\n+Current stable release (0.7.1) is able to persist Orion context data in:\n+\n+* HDFS, the Hadoop distributed file system.\n+* MySQL, the well-know relational database manager.\n+* CKAN, an Open Data platform.\n+\n+###Which is its basic architecture?\n+Internally, Cygnus is based on Apache Flume. In fact, Cygnus is a Flume agent, which is basically composed of a <i>source</i> in charge of receiving the data, a <i>channel</i> where the source puts the data once it has been transformed into a Flume event, and a <i>sink</i>, which takes Flume events from the channel in order to persist the data within its body into a third-party storage.\n+\n+As said, Cygnus is able to persist in HDFS, MySQL and CKAN, thus there exists a sink for each one of those storages.\n+\n+##Installing Cygnus\n+Open a terminal and simply configure the FIWARE repository if not yet configured and use your applications manager in order to install the latest version of Cygnus (CentOS/RedHat example):\n+\n+```\n+$ cat > /etc/yum.repos.d/fiware.repo <<EOL\n+[Fiware]\n+name=FIWARE repository\n+baseurl=http://repositories.testbed.fi-ware.eu/repo/rpm/x86_64/\n+gpgcheck=0\n+enabled=1\n+EOL\n+$ yum install cygnus\n+```\n+\n+When installing through the RPM, Cygnus is started as a service. Stop it since this Quick Start Guide will run Cygnus from the command line.\n+\n+```\n+$ service cygnus stop\n+```\n+\n+##Configuring a test agent\n+This kind of agent is the simplest one you can configure with Cygnus. It is based on a standard `HTTPSource`, a `MemoryChannel` and a `OrionTestSink`. Don't worry about the configuration details, specially those about the source; simply think on a Http listener waiting for Orion notifications on port TCP/5050 and sending that notifications in the form el Flume events to a testing purpose sink that will not really persist anything in a third-party storage, but will log the notified context data.","path":"flume/doc/quick_start_guide.md","position":47,"original_position":47,"commit_id":"9dde041e3c7972c9b3872c131a10f51c708b5791","original_commit_id":"9dde041e3c7972c9b3872c131a10f51c708b5791","user":{"login":"frbattid","id":3865056,"avatar_url":"https://avatars.githubusercontent.com/u/3865056?v=3","gravatar_id":"","url":"https://api.github.com/users/frbattid","html_url":"https://github.com/frbattid","followers_url":"https://api.github.com/users/frbattid/followers","following_url":"https://api.github.com/users/frbattid/following{/other_user}","gists_url":"https://api.github.com/users/frbattid/gists{/gist_id}","starred_url":"https://api.github.com/users/frbattid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/frbattid/subscriptions","organizations_url":"https://api.github.com/users/frbattid/orgs","repos_url":"https://api.github.com/users/frbattid/repos","events_url":"https://api.github.com/users/frbattid/events{/privacy}","received_events_url":"https://api.github.com/users/frbattid/received_events","type":"User","site_admin":false},"body":"Regarding the http listener, I was talking in general not about a scpecific class.","created_at":"2015-03-06T09:53:33Z","updated_at":"2015-03-06T09:53:33Z","html_url":"https://github.com/telefonicaid/fiware-connectors/pull/341#discussion_r25934883","pull_request_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341","_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/comments/25934883"},"html":{"href":"https://github.com/telefonicaid/fiware-connectors/pull/341#discussion_r25934883"},"pull_request":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341"}}},"pull_request":{"url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341","id":30628365,"html_url":"https://github.com/telefonicaid/fiware-connectors/pull/341","diff_url":"https://github.com/telefonicaid/fiware-connectors/pull/341.diff","patch_url":"https://github.com/telefonicaid/fiware-connectors/pull/341.patch","issue_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/341","number":341,"state":"open","locked":false,"title":"task/319_quick_start_guide","user":{"login":"frbattid","id":3865056,"avatar_url":"https://avatars.githubusercontent.com/u/3865056?v=3","gravatar_id":"","url":"https://api.github.com/users/frbattid","html_url":"https://github.com/frbattid","followers_url":"https://api.github.com/users/frbattid/followers","following_url":"https://api.github.com/users/frbattid/following{/other_user}","gists_url":"https://api.github.com/users/frbattid/gists{/gist_id}","starred_url":"https://api.github.com/users/frbattid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/frbattid/subscriptions","organizations_url":"https://api.github.com/users/frbattid/orgs","repos_url":"https://api.github.com/users/frbattid/repos","events_url":"https://api.github.com/users/frbattid/events{/privacy}","received_events_url":"https://api.github.com/users/frbattid/received_events","type":"User","site_admin":false},"body":"* Implements the issue https://github.com/telefonicaid/fiware-connectors/issues/319\r\n* No unit tests required.\r\n* No e2e tests required.\r\n* Assignee: @gtorodelvalle , anyway comments from @fgalan are always welcome :)","created_at":"2015-03-06T08:35:18Z","updated_at":"2015-03-06T09:53:33Z","closed_at":null,"merged_at":null,"merge_commit_sha":"cdbbdc88b271263de0309f620f6b957d438af2fd","assignee":{"login":"gtorodelvalle","id":667284,"avatar_url":"https://avatars.githubusercontent.com/u/667284?v=3","gravatar_id":"","url":"https://api.github.com/users/gtorodelvalle","html_url":"https://github.com/gtorodelvalle","followers_url":"https://api.github.com/users/gtorodelvalle/followers","following_url":"https://api.github.com/users/gtorodelvalle/following{/other_user}","gists_url":"https://api.github.com/users/gtorodelvalle/gists{/gist_id}","starred_url":"https://api.github.com/users/gtorodelvalle/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gtorodelvalle/subscriptions","organizations_url":"https://api.github.com/users/gtorodelvalle/orgs","repos_url":"https://api.github.com/users/gtorodelvalle/repos","events_url":"https://api.github.com/users/gtorodelvalle/events{/privacy}","received_events_url":"https://api.github.com/users/gtorodelvalle/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341/commits","review_comments_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341/comments","review_comment_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/comments{/number}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/341/comments","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/statuses/9dde041e3c7972c9b3872c131a10f51c708b5791","head":{"label":"telefonicaid:task/319_quick_start_guide","ref":"task/319_quick_start_guide","sha":"9dde041e3c7972c9b3872c131a10f51c708b5791","user":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"repo":{"id":16607947,"name":"fiware-connectors","full_name":"telefonicaid/fiware-connectors","owner":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/telefonicaid/fiware-connectors","description":"FI-WARE connectors","fork":false,"url":"https://api.github.com/repos/telefonicaid/fiware-connectors","forks_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/forks","keys_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/keys{/key_id}","collaborators_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/teams","hooks_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/hooks","issue_events_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/events{/number}","events_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/events","assignees_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/assignees{/user}","branches_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/branches{/branch}","tags_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/tags","blobs_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/refs{/sha}","trees_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/trees{/sha}","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/statuses/{sha}","languages_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/languages","stargazers_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/stargazers","contributors_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/contributors","subscribers_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/subscribers","subscription_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/subscription","commits_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/commits{/sha}","git_commits_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/commits{/sha}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/comments{/number}","issue_comment_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/comments{/number}","contents_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/contents/{+path}","compare_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/compare/{base}...{head}","merges_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/merges","archive_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/downloads","issues_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues{/number}","pulls_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls{/number}","milestones_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/milestones{/number}","notifications_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/labels{/name}","releases_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/releases{/id}","created_at":"2014-02-07T07:57:41Z","updated_at":"2015-02-16T11:08:32Z","pushed_at":"2015-03-06T08:32:59Z","git_url":"git://github.com/telefonicaid/fiware-connectors.git","ssh_url":"git@github.com:telefonicaid/fiware-connectors.git","clone_url":"https://github.com/telefonicaid/fiware-connectors.git","svn_url":"https://github.com/telefonicaid/fiware-connectors","homepage":"","size":93891,"stargazers_count":12,"watchers_count":12,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":36,"forks":7,"open_issues":36,"watchers":12,"default_branch":"master"}},"base":{"label":"telefonicaid:develop","ref":"develop","sha":"3d976f57ad83cfc5286c96191486b5e3c800ab02","user":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"repo":{"id":16607947,"name":"fiware-connectors","full_name":"telefonicaid/fiware-connectors","owner":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/telefonicaid/fiware-connectors","description":"FI-WARE connectors","fork":false,"url":"https://api.github.com/repos/telefonicaid/fiware-connectors","forks_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/forks","keys_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/keys{/key_id}","collaborators_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/teams","hooks_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/hooks","issue_events_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/events{/number}","events_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/events","assignees_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/assignees{/user}","branches_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/branches{/branch}","tags_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/tags","blobs_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/refs{/sha}","trees_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/trees{/sha}","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/statuses/{sha}","languages_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/languages","stargazers_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/stargazers","contributors_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/contributors","subscribers_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/subscribers","subscription_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/subscription","commits_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/commits{/sha}","git_commits_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/git/commits{/sha}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/comments{/number}","issue_comment_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/comments{/number}","contents_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/contents/{+path}","compare_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/compare/{base}...{head}","merges_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/merges","archive_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/downloads","issues_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues{/number}","pulls_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls{/number}","milestones_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/milestones{/number}","notifications_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/labels{/name}","releases_url":"https://api.github.com/repos/telefonicaid/fiware-connectors/releases{/id}","created_at":"2014-02-07T07:57:41Z","updated_at":"2015-02-16T11:08:32Z","pushed_at":"2015-03-06T08:32:59Z","git_url":"git://github.com/telefonicaid/fiware-connectors.git","ssh_url":"git@github.com:telefonicaid/fiware-connectors.git","clone_url":"https://github.com/telefonicaid/fiware-connectors.git","svn_url":"https://github.com/telefonicaid/fiware-connectors","homepage":"","size":93891,"stargazers_count":12,"watchers_count":12,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":36,"forks":7,"open_issues":36,"watchers":12,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341"},"html":{"href":"https://github.com/telefonicaid/fiware-connectors/pull/341"},"issue":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/341"},"comments":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/issues/341/comments"},"review_comments":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341/comments"},"review_comment":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/pulls/341/commits"},"statuses":{"href":"https://api.github.com/repos/telefonicaid/fiware-connectors/statuses/9dde041e3c7972c9b3872c131a10f51c708b5791"}}}}