{"action":"created","comment":{"url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/comments/36976526","id":36976526,"diff_hunk":"@@ -32,18 +50,201 @@ of that.\n \n -   **Decoupling the management  and provisioning**\n \n-    Decoupling the management of the catalogue (specifications of what can be deployed) \n-    and the management of the inventory (instances of what has been already deployed). \n-    In addition, decoupling the management of environments from the management of applications, \n+    Decoupling the management of the catalogue (specifications of what can be deployed)\n+    and the management of the inventory (instances of what has been already deployed).\n+    In addition, decoupling the management of environments from the management of applications,\n     since there could be uses cases where the users of those functionalities could be different ones.\n \n \n-Documentation\n-=============\n+Build and Install\n+=================\n+\n+The recommended procedure is to install using RPM packages in CentOS 6.x as it is explained in\n+the `following document <doc/admin_guide.rst#install-paas-manager-from-rpm>`_\n+. If you are interested in building\n+from sources, check `this document <doc/admin_guide.rst#install-paas-manager-from-source#>`_.\n+\n+\n+Requirements\n+------------\n+\n+- System resources: see `these recommendations\n+  <doc/admin_guide.rst#Resource availability>`_.\n+- Operating systems: CentOS (RedHat), being CentOS 6.5 the\n+  reference operating system.\n+\n+\n+Installation\n+------------\n+\n+Using FIWARE package repository (recommended)\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Refer to the documentation of your Linux distribution to set up the URL of the\n+repository where FIWARE packages are available (and update cache, if needed):\n+\n+    http://repositories.testbed.fiware.org/repo/rpm/x86_64\n+\n+\n+Then, use the proper tool to install the packages\n+\n+    $ sudo yum install fiware-paas\n+\n+and the latest version will be installed. In order to install a specific version\n+\n+    $ sudo yum install fiware-paas-{version}-1.noarch\n+\n+where {version} being the specific version to be installed\n+\n+\n+Upgrading from a previous version\n+---------------------------------\n+\n+Unless explicitly stated, no migration steps are required to upgrade to a\n+newer version of the PaaS Manager components:\n+\n+- When using the package repositories, just follow the same directions\n+  described in the Installation_ section (the ``install`` subcommand also\n+  performs upgrades).\n+- When upgrading from downloaded package files, use ``rpm -U`` in CentOS\n+\n+Upgrading database\n+~~~~~~~~~~~~~~~~~~\n+In case the database needs to be upgrade, the script db-changelog.sql should\n+be execute. To do that, it just needed to execute::\n+\n+    psql -U postgres -d $db_name << EOF\n+    \\i db-changelog.sql\n+\n+\n+Running\n+=======\n+\n+As explained in the `GEi overall description`_ section, there are a variety of\n+elements involved in the PaaS Manager architecture, apart from those components\n+provided by this PaaS Manager GE as the Software Deployment and Configuration and\n+Openstack services. Please\n+refer to their respective documentation for instructions to run them.\n+\n+\n+In order to start the PaaS Manager service, as it is based on a\n+web application on top of jetty, just you should run::\n+\n+    $ service fiware-paas start\n+\n+Then, to stop the service, run::\n+\n+    $ service fiware-paas stop\n+\n+We can also force a service restart::\n+\n+    $ service fiware-paas restart\n+\n+\n+Configuration file\n+------------------\n+\n+The configuration of PaaS Manager is in configuration_properties table in the database.\n+There, it is required to configure::\n+\n+    $ openstack-tcloud.keystone.url: This is the url where the keystone-proxy is deployed\n+    $ openstack-tcloud.keystone.user: the admin user\n+    $ openstack-tcloud.keystone.password: the admin password\n+    $ openstack-tcloud.keystone.tenant: the admin tenant\n+    $ paas_manager_url: the final url, mainly https://paas-ip:8443/paasmanager\n+\n+\n+\n+Checking status\n+---------------\n+\n+In order to check the status of the service, use the following command\n+(no special privileges required):\n+\n+::\n+\n+    $ service fiware-paas status\n+\n+\n+API Overview\n+============\n+\n+- `FIWARE PaaS Manager v1 (Apiary) <https://jsapi.apiary.io/apis/fiwarepaas/reference.html>`_\n+\n+\n+Testing\n+=======\n+\n+Unit tests\n+----------\n+\n+The ``test`` target for each module in the PaaS Manager is used for running the unit tests in both components of\n+PaaS Manager GE:\n+\n+Please have a look at the section `building from source code\n+<doc/admin-guide.rst#install-paas-from-source>`_ in order to get more\n+information about how to prepare the environment to run the\n+unit tests.\n+\n+\n+Acceptance tests\n+----------------\n+\n+In the following path you will find a set of tests related to the\n+end-to-end funtionalities.\n+\n+- `PaaS Manager Aceptance Tests <https://github.com/telefonicaid/fiware-paas/tree/develop/test>`_\n+","path":"README.rst","position":210,"original_position":210,"commit_id":"cd1d4517c8cd7d58a765b7c9434c998631feb422","original_commit_id":"cd1d4517c8cd7d58a765b7c9434c998631feb422","user":{"login":"flopezag","id":1379796,"avatar_url":"https://avatars.githubusercontent.com/u/1379796?v=3","gravatar_id":"","url":"https://api.github.com/users/flopezag","html_url":"https://github.com/flopezag","followers_url":"https://api.github.com/users/flopezag/followers","following_url":"https://api.github.com/users/flopezag/following{/other_user}","gists_url":"https://api.github.com/users/flopezag/gists{/gist_id}","starred_url":"https://api.github.com/users/flopezag/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/flopezag/subscriptions","organizations_url":"https://api.github.com/users/flopezag/orgs","repos_url":"https://api.github.com/users/flopezag/repos","events_url":"https://api.github.com/users/flopezag/events{/privacy}","received_events_url":"https://api.github.com/users/flopezag/received_events","type":"User","site_admin":false},"body":"Please add how can you execute the acceptance tests and how to prepare the environment if something is needed in order to execute these tests.","created_at":"2015-08-13T13:58:56Z","updated_at":"2015-08-13T13:58:56Z","html_url":"https://github.com/telefonicaid/fiware-paas/pull/245#discussion_r36976526","pull_request_url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245","_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/comments/36976526"},"html":{"href":"https://github.com/telefonicaid/fiware-paas/pull/245#discussion_r36976526"},"pull_request":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245"}}},"pull_request":{"url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245","id":42340409,"html_url":"https://github.com/telefonicaid/fiware-paas/pull/245","diff_url":"https://github.com/telefonicaid/fiware-paas/pull/245.diff","patch_url":"https://github.com/telefonicaid/fiware-paas/pull/245.patch","issue_url":"https://api.github.com/repos/telefonicaid/fiware-paas/issues/245","number":245,"state":"open","locked":false,"title":"Updatereadme","user":{"login":"hmunfru","id":1541508,"avatar_url":"https://avatars.githubusercontent.com/u/1541508?v=3","gravatar_id":"","url":"https://api.github.com/users/hmunfru","html_url":"https://github.com/hmunfru","followers_url":"https://api.github.com/users/hmunfru/followers","following_url":"https://api.github.com/users/hmunfru/following{/other_user}","gists_url":"https://api.github.com/users/hmunfru/gists{/gist_id}","starred_url":"https://api.github.com/users/hmunfru/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hmunfru/subscriptions","organizations_url":"https://api.github.com/users/hmunfru/orgs","repos_url":"https://api.github.com/users/hmunfru/repos","events_url":"https://api.github.com/users/hmunfru/events{/privacy}","received_events_url":"https://api.github.com/users/hmunfru/received_events","type":"User","site_admin":false},"body":"@jframos ","created_at":"2015-08-13T11:33:56Z","updated_at":"2015-08-13T13:58:56Z","closed_at":null,"merged_at":null,"merge_commit_sha":"a2239af456b1d476cc84eb22013387282f07c0d0","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245/commits","review_comments_url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245/comments","review_comment_url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/comments{/number}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-paas/issues/245/comments","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-paas/statuses/cd1d4517c8cd7d58a765b7c9434c998631feb422","head":{"label":"hmunfru:updatereadme","ref":"updatereadme","sha":"cd1d4517c8cd7d58a765b7c9434c998631feb422","user":{"login":"hmunfru","id":1541508,"avatar_url":"https://avatars.githubusercontent.com/u/1541508?v=3","gravatar_id":"","url":"https://api.github.com/users/hmunfru","html_url":"https://github.com/hmunfru","followers_url":"https://api.github.com/users/hmunfru/followers","following_url":"https://api.github.com/users/hmunfru/following{/other_user}","gists_url":"https://api.github.com/users/hmunfru/gists{/gist_id}","starred_url":"https://api.github.com/users/hmunfru/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hmunfru/subscriptions","organizations_url":"https://api.github.com/users/hmunfru/orgs","repos_url":"https://api.github.com/users/hmunfru/repos","events_url":"https://api.github.com/users/hmunfru/events{/privacy}","received_events_url":"https://api.github.com/users/hmunfru/received_events","type":"User","site_admin":false},"repo":{"id":18432383,"name":"fiware-paas","full_name":"hmunfru/fiware-paas","owner":{"login":"hmunfru","id":1541508,"avatar_url":"https://avatars.githubusercontent.com/u/1541508?v=3","gravatar_id":"","url":"https://api.github.com/users/hmunfru","html_url":"https://github.com/hmunfru","followers_url":"https://api.github.com/users/hmunfru/followers","following_url":"https://api.github.com/users/hmunfru/following{/other_user}","gists_url":"https://api.github.com/users/hmunfru/gists{/gist_id}","starred_url":"https://api.github.com/users/hmunfru/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hmunfru/subscriptions","organizations_url":"https://api.github.com/users/hmunfru/orgs","repos_url":"https://api.github.com/users/hmunfru/repos","events_url":"https://api.github.com/users/hmunfru/events{/privacy}","received_events_url":"https://api.github.com/users/hmunfru/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/hmunfru/fiware-paas","description":"PaaS Manager repository of the OpenStack PaaS solution in the FI-WARE project.","fork":true,"url":"https://api.github.com/repos/hmunfru/fiware-paas","forks_url":"https://api.github.com/repos/hmunfru/fiware-paas/forks","keys_url":"https://api.github.com/repos/hmunfru/fiware-paas/keys{/key_id}","collaborators_url":"https://api.github.com/repos/hmunfru/fiware-paas/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/hmunfru/fiware-paas/teams","hooks_url":"https://api.github.com/repos/hmunfru/fiware-paas/hooks","issue_events_url":"https://api.github.com/repos/hmunfru/fiware-paas/issues/events{/number}","events_url":"https://api.github.com/repos/hmunfru/fiware-paas/events","assignees_url":"https://api.github.com/repos/hmunfru/fiware-paas/assignees{/user}","branches_url":"https://api.github.com/repos/hmunfru/fiware-paas/branches{/branch}","tags_url":"https://api.github.com/repos/hmunfru/fiware-paas/tags","blobs_url":"https://api.github.com/repos/hmunfru/fiware-paas/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/hmunfru/fiware-paas/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/hmunfru/fiware-paas/git/refs{/sha}","trees_url":"https://api.github.com/repos/hmunfru/fiware-paas/git/trees{/sha}","statuses_url":"https://api.github.com/repos/hmunfru/fiware-paas/statuses/{sha}","languages_url":"https://api.github.com/repos/hmunfru/fiware-paas/languages","stargazers_url":"https://api.github.com/repos/hmunfru/fiware-paas/stargazers","contributors_url":"https://api.github.com/repos/hmunfru/fiware-paas/contributors","subscribers_url":"https://api.github.com/repos/hmunfru/fiware-paas/subscribers","subscription_url":"https://api.github.com/repos/hmunfru/fiware-paas/subscription","commits_url":"https://api.github.com/repos/hmunfru/fiware-paas/commits{/sha}","git_commits_url":"https://api.github.com/repos/hmunfru/fiware-paas/git/commits{/sha}","comments_url":"https://api.github.com/repos/hmunfru/fiware-paas/comments{/number}","issue_comment_url":"https://api.github.com/repos/hmunfru/fiware-paas/issues/comments{/number}","contents_url":"https://api.github.com/repos/hmunfru/fiware-paas/contents/{+path}","compare_url":"https://api.github.com/repos/hmunfru/fiware-paas/compare/{base}...{head}","merges_url":"https://api.github.com/repos/hmunfru/fiware-paas/merges","archive_url":"https://api.github.com/repos/hmunfru/fiware-paas/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/hmunfru/fiware-paas/downloads","issues_url":"https://api.github.com/repos/hmunfru/fiware-paas/issues{/number}","pulls_url":"https://api.github.com/repos/hmunfru/fiware-paas/pulls{/number}","milestones_url":"https://api.github.com/repos/hmunfru/fiware-paas/milestones{/number}","notifications_url":"https://api.github.com/repos/hmunfru/fiware-paas/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/hmunfru/fiware-paas/labels{/name}","releases_url":"https://api.github.com/repos/hmunfru/fiware-paas/releases{/id}","created_at":"2014-04-04T08:24:45Z","updated_at":"2014-06-24T10:51:07Z","pushed_at":"2015-08-13T11:33:20Z","git_url":"git://github.com/hmunfru/fiware-paas.git","ssh_url":"git@github.com:hmunfru/fiware-paas.git","clone_url":"https://github.com/hmunfru/fiware-paas.git","svn_url":"https://github.com/hmunfru/fiware-paas","homepage":null,"size":15319,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"telefonicaid:develop","ref":"develop","sha":"a0e1526558f9f0eb6faf266d7fdf6ccea066c0b3","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":18406709,"name":"fiware-paas","full_name":"telefonicaid/fiware-paas","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-paas","description":"PaaS Manager repository of the OpenStack PaaS solution in the FI-WARE project.","fork":false,"url":"https://api.github.com/repos/telefonicaid/fiware-paas","forks_url":"https://api.github.com/repos/telefonicaid/fiware-paas/forks","keys_url":"https://api.github.com/repos/telefonicaid/fiware-paas/keys{/key_id}","collaborators_url":"https://api.github.com/repos/telefonicaid/fiware-paas/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/telefonicaid/fiware-paas/teams","hooks_url":"https://api.github.com/repos/telefonicaid/fiware-paas/hooks","issue_events_url":"https://api.github.com/repos/telefonicaid/fiware-paas/issues/events{/number}","events_url":"https://api.github.com/repos/telefonicaid/fiware-paas/events","assignees_url":"https://api.github.com/repos/telefonicaid/fiware-paas/assignees{/user}","branches_url":"https://api.github.com/repos/telefonicaid/fiware-paas/branches{/branch}","tags_url":"https://api.github.com/repos/telefonicaid/fiware-paas/tags","blobs_url":"https://api.github.com/repos/telefonicaid/fiware-paas/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/telefonicaid/fiware-paas/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/telefonicaid/fiware-paas/git/refs{/sha}","trees_url":"https://api.github.com/repos/telefonicaid/fiware-paas/git/trees{/sha}","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-paas/statuses/{sha}","languages_url":"https://api.github.com/repos/telefonicaid/fiware-paas/languages","stargazers_url":"https://api.github.com/repos/telefonicaid/fiware-paas/stargazers","contributors_url":"https://api.github.com/repos/telefonicaid/fiware-paas/contributors","subscribers_url":"https://api.github.com/repos/telefonicaid/fiware-paas/subscribers","subscription_url":"https://api.github.com/repos/telefonicaid/fiware-paas/subscription","commits_url":"https://api.github.com/repos/telefonicaid/fiware-paas/commits{/sha}","git_commits_url":"https://api.github.com/repos/telefonicaid/fiware-paas/git/commits{/sha}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-paas/comments{/number}","issue_comment_url":"https://api.github.com/repos/telefonicaid/fiware-paas/issues/comments{/number}","contents_url":"https://api.github.com/repos/telefonicaid/fiware-paas/contents/{+path}","compare_url":"https://api.github.com/repos/telefonicaid/fiware-paas/compare/{base}...{head}","merges_url":"https://api.github.com/repos/telefonicaid/fiware-paas/merges","archive_url":"https://api.github.com/repos/telefonicaid/fiware-paas/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/telefonicaid/fiware-paas/downloads","issues_url":"https://api.github.com/repos/telefonicaid/fiware-paas/issues{/number}","pulls_url":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls{/number}","milestones_url":"https://api.github.com/repos/telefonicaid/fiware-paas/milestones{/number}","notifications_url":"https://api.github.com/repos/telefonicaid/fiware-paas/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/telefonicaid/fiware-paas/labels{/name}","releases_url":"https://api.github.com/repos/telefonicaid/fiware-paas/releases{/id}","created_at":"2014-04-03T14:50:18Z","updated_at":"2015-06-24T06:09:59Z","pushed_at":"2015-08-13T11:51:16Z","git_url":"git://github.com/telefonicaid/fiware-paas.git","ssh_url":"git@github.com:telefonicaid/fiware-paas.git","clone_url":"https://github.com/telefonicaid/fiware-paas.git","svn_url":"https://github.com/telefonicaid/fiware-paas","homepage":null,"size":16248,"stargazers_count":3,"watchers_count":3,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":8,"mirror_url":null,"open_issues_count":2,"forks":8,"open_issues":2,"watchers":3,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245"},"html":{"href":"https://github.com/telefonicaid/fiware-paas/pull/245"},"issue":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/issues/245"},"comments":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/issues/245/comments"},"review_comments":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245/comments"},"review_comment":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/pulls/245/commits"},"statuses":{"href":"https://api.github.com/repos/telefonicaid/fiware-paas/statuses/cd1d4517c8cd7d58a765b7c9434c998631feb422"}}}}