{"action":"created","comment":{"url":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments/62725693","id":62725693,"diff_hunk":"@@ -0,0 +1,113 @@\n+---\n+post_title: Storage\n+menu_order: 10\n+---\n+\n+### Mount Disk Resources\n+\n+#### Overview\n+\n+Mesos Volume Mounts give services the ability to reserve dedicated disk space throughout the cluster. This is particularly useful for stateful services like Kafka and Cassandra.\n+\n+In DC/OS it is possible to configure [Mesos Mount disk resources][1] across the cluster by simply mounting storage resources on Agents using a well-known path. When a DC/OS agent starts for the first time it will scan for volumes matching the pattern `/dcos/volumeN`, where N is an integer, and automatically configure the Mesos Agent to offer these disk resources to other services.\n+\n+##### Example using loopback device\n+\n+The example below shows how to add a disk resource to a DC/OS agent post-install on a running cluster. The same steps can be used pre-install, but in that scenario it is not necessary to stop services or clear the Mesos Agent state. All commands below should be run as root.\n+\n+***Warning:*** This will terminate any running tasks or services on the node.\n+\n+1. Connect to an agent in the cluster with SSH\n+\n+2. Examine the current Mesos Agent resource state\n+\n+  Note there are no references yet for `/dcos/volume0`.\n+\n+\t```\n+\troot@dcos-agent-public:~# cat /var/lib/dcos/mesos-resources\n+\t# Generated by make_disk_resources.py on 2016-05-05 17:04:29.868595\n+\t#\n+\n+\tMESOS_RESOURCES='[{\"ranges\": {\"range\": [{\"end\": 21, \"begin\": 1}, {\"end\": 5050, \"begin\": 23}, {\"end\": 32000, \"begin\": 5052}]}, \"type\": \"RANGES\", \"name\": \"ports\"}, {\"role\": \"*\", \"type\": \"SCALAR\", \"name\": \"disk\", \"scalar\": {\"value\": 47540}}]'\n+\t```\n+\n+3. Stop the Mesos Agent","path":"1.7/administration/storage.md","position":34,"original_position":34,"commit_id":"137c37d9c79eea90d61fba5ddf6d0e8391acc896","original_commit_id":"137c37d9c79eea90d61fba5ddf6d0e8391acc896","user":{"login":"lingmann","id":33731,"avatar_url":"https://avatars.githubusercontent.com/u/33731?v=3","gravatar_id":"","url":"https://api.github.com/users/lingmann","html_url":"https://github.com/lingmann","followers_url":"https://api.github.com/users/lingmann/followers","following_url":"https://api.github.com/users/lingmann/following{/other_user}","gists_url":"https://api.github.com/users/lingmann/gists{/gist_id}","starred_url":"https://api.github.com/users/lingmann/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lingmann/subscriptions","organizations_url":"https://api.github.com/users/lingmann/orgs","repos_url":"https://api.github.com/users/lingmann/repos","events_url":"https://api.github.com/users/lingmann/events{/privacy}","received_events_url":"https://api.github.com/users/lingmann/received_events","type":"User","site_admin":false},"body":"I thought about that, but we can't combine without making it into a little subscript or by swallowing systemctl errors.","created_at":"2016-05-10T18:27:20Z","updated_at":"2016-05-10T18:27:20Z","html_url":"https://github.com/dcos/dcos-docs/pull/288#discussion_r62725693","pull_request_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/288","_links":{"self":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments/62725693"},"html":{"href":"https://github.com/dcos/dcos-docs/pull/288#discussion_r62725693"},"pull_request":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/288"}}},"pull_request":{"url":"https://api.github.com/repos/dcos/dcos-docs/pulls/288","id":69076637,"html_url":"https://github.com/dcos/dcos-docs/pull/288","diff_url":"https://github.com/dcos/dcos-docs/pull/288.diff","patch_url":"https://github.com/dcos/dcos-docs/pull/288.patch","issue_url":"https://api.github.com/repos/dcos/dcos-docs/issues/288","number":288,"state":"open","locked":false,"title":"Initial draft of Disk Volume Mount Resources","user":{"login":"lingmann","id":33731,"avatar_url":"https://avatars.githubusercontent.com/u/33731?v=3","gravatar_id":"","url":"https://api.github.com/users/lingmann","html_url":"https://github.com/lingmann","followers_url":"https://api.github.com/users/lingmann/followers","following_url":"https://api.github.com/users/lingmann/following{/other_user}","gists_url":"https://api.github.com/users/lingmann/gists{/gist_id}","starred_url":"https://api.github.com/users/lingmann/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lingmann/subscriptions","organizations_url":"https://api.github.com/users/lingmann/orgs","repos_url":"https://api.github.com/users/lingmann/repos","events_url":"https://api.github.com/users/lingmann/events{/privacy}","received_events_url":"https://api.github.com/users/lingmann/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-05-05T21:52:31Z","updated_at":"2016-05-10T18:27:20Z","closed_at":null,"merged_at":null,"merge_commit_sha":"df02a1ce5b817d4bddd083762e4c6572b1c300c4","assignee":{"login":"pyronicide","id":47992,"avatar_url":"https://avatars.githubusercontent.com/u/47992?v=3","gravatar_id":"","url":"https://api.github.com/users/pyronicide","html_url":"https://github.com/pyronicide","followers_url":"https://api.github.com/users/pyronicide/followers","following_url":"https://api.github.com/users/pyronicide/following{/other_user}","gists_url":"https://api.github.com/users/pyronicide/gists{/gist_id}","starred_url":"https://api.github.com/users/pyronicide/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pyronicide/subscriptions","organizations_url":"https://api.github.com/users/pyronicide/orgs","repos_url":"https://api.github.com/users/pyronicide/repos","events_url":"https://api.github.com/users/pyronicide/events{/privacy}","received_events_url":"https://api.github.com/users/pyronicide/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/288/commits","review_comments_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/288/comments","review_comment_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/issues/288/comments","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/137c37d9c79eea90d61fba5ddf6d0e8391acc896","head":{"label":"dcos:jeremy/disk-volume-mounts","ref":"jeremy/disk-volume-mounts","sha":"137c37d9c79eea90d61fba5ddf6d0e8391acc896","user":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"repo":{"id":53887483,"name":"dcos-docs","full_name":"dcos/dcos-docs","owner":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dcos/dcos-docs","description":"Documentation for Datacenter Operating System (DC/OS)","fork":false,"url":"https://api.github.com/repos/dcos/dcos-docs","forks_url":"https://api.github.com/repos/dcos/dcos-docs/forks","keys_url":"https://api.github.com/repos/dcos/dcos-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dcos/dcos-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dcos/dcos-docs/teams","hooks_url":"https://api.github.com/repos/dcos/dcos-docs/hooks","issue_events_url":"https://api.github.com/repos/dcos/dcos-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dcos/dcos-docs/events","assignees_url":"https://api.github.com/repos/dcos/dcos-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dcos/dcos-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dcos/dcos-docs/tags","blobs_url":"https://api.github.com/repos/dcos/dcos-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dcos/dcos-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dcos/dcos-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dcos/dcos-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dcos/dcos-docs/languages","stargazers_url":"https://api.github.com/repos/dcos/dcos-docs/stargazers","contributors_url":"https://api.github.com/repos/dcos/dcos-docs/contributors","subscribers_url":"https://api.github.com/repos/dcos/dcos-docs/subscribers","subscription_url":"https://api.github.com/repos/dcos/dcos-docs/subscription","commits_url":"https://api.github.com/repos/dcos/dcos-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dcos/dcos-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dcos/dcos-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dcos/dcos-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dcos/dcos-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dcos/dcos-docs/merges","archive_url":"https://api.github.com/repos/dcos/dcos-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dcos/dcos-docs/downloads","issues_url":"https://api.github.com/repos/dcos/dcos-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dcos/dcos-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dcos/dcos-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dcos/dcos-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dcos/dcos-docs/labels{/name}","releases_url":"https://api.github.com/repos/dcos/dcos-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dcos/dcos-docs/deployments","created_at":"2016-03-14T19:58:33Z","updated_at":"2016-05-09T16:35:21Z","pushed_at":"2016-05-10T18:19:48Z","git_url":"git://github.com/dcos/dcos-docs.git","ssh_url":"git@github.com:dcos/dcos-docs.git","clone_url":"https://github.com/dcos/dcos-docs.git","svn_url":"https://github.com/dcos/dcos-docs","homepage":"http://dcos.io","size":24941,"stargazers_count":53,"watchers_count":53,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":23,"mirror_url":null,"open_issues_count":21,"forks":23,"open_issues":21,"watchers":53,"default_branch":"master"}},"base":{"label":"dcos:master","ref":"master","sha":"ad9c1bc899ee947796cc90f57bf77269e86eeb13","user":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"repo":{"id":53887483,"name":"dcos-docs","full_name":"dcos/dcos-docs","owner":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dcos/dcos-docs","description":"Documentation for Datacenter Operating System (DC/OS)","fork":false,"url":"https://api.github.com/repos/dcos/dcos-docs","forks_url":"https://api.github.com/repos/dcos/dcos-docs/forks","keys_url":"https://api.github.com/repos/dcos/dcos-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dcos/dcos-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dcos/dcos-docs/teams","hooks_url":"https://api.github.com/repos/dcos/dcos-docs/hooks","issue_events_url":"https://api.github.com/repos/dcos/dcos-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dcos/dcos-docs/events","assignees_url":"https://api.github.com/repos/dcos/dcos-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dcos/dcos-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dcos/dcos-docs/tags","blobs_url":"https://api.github.com/repos/dcos/dcos-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dcos/dcos-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dcos/dcos-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dcos/dcos-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dcos/dcos-docs/languages","stargazers_url":"https://api.github.com/repos/dcos/dcos-docs/stargazers","contributors_url":"https://api.github.com/repos/dcos/dcos-docs/contributors","subscribers_url":"https://api.github.com/repos/dcos/dcos-docs/subscribers","subscription_url":"https://api.github.com/repos/dcos/dcos-docs/subscription","commits_url":"https://api.github.com/repos/dcos/dcos-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dcos/dcos-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dcos/dcos-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dcos/dcos-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dcos/dcos-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dcos/dcos-docs/merges","archive_url":"https://api.github.com/repos/dcos/dcos-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dcos/dcos-docs/downloads","issues_url":"https://api.github.com/repos/dcos/dcos-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dcos/dcos-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dcos/dcos-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dcos/dcos-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dcos/dcos-docs/labels{/name}","releases_url":"https://api.github.com/repos/dcos/dcos-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dcos/dcos-docs/deployments","created_at":"2016-03-14T19:58:33Z","updated_at":"2016-05-09T16:35:21Z","pushed_at":"2016-05-10T18:19:48Z","git_url":"git://github.com/dcos/dcos-docs.git","ssh_url":"git@github.com:dcos/dcos-docs.git","clone_url":"https://github.com/dcos/dcos-docs.git","svn_url":"https://github.com/dcos/dcos-docs","homepage":"http://dcos.io","size":24941,"stargazers_count":53,"watchers_count":53,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":23,"mirror_url":null,"open_issues_count":21,"forks":23,"open_issues":21,"watchers":53,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/288"},"html":{"href":"https://github.com/dcos/dcos-docs/pull/288"},"issue":{"href":"https://api.github.com/repos/dcos/dcos-docs/issues/288"},"comments":{"href":"https://api.github.com/repos/dcos/dcos-docs/issues/288/comments"},"review_comments":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/288/comments"},"review_comment":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/288/commits"},"statuses":{"href":"https://api.github.com/repos/dcos/dcos-docs/statuses/137c37d9c79eea90d61fba5ddf6d0e8391acc896"}}}}