{"action":"created","comment":{"url":"https://api.github.com/repos/xcat2/xcat-core/pulls/comments/39019216","id":39019216,"diff_hunk":"@@ -1,2 +1,170 @@\n Enable Kdump Over Ethernet\n ==========================\n+\n+Overview\n+--------\n+\n+kdump is an advanced crash dumping mechanism. When enabled, the system is booted from the context of another kernel. This second kernel reserves a small amount of memory, and its only purpose is to capture the core dump image in case the system crashes. Since being able to analyze the core dump helps significantly to determine the exact cause of the system failure.\n+\n+\n+xCAT Interface\n+--------------\n+\n+The pkglist, exclude and postinstall files location and name can be obtained by running the following command: ::\n+\n+    lsdef -t osimage <osimage name>\n+\n+The pkglist file\n+----------------\n+\n+For RHEL6 and RHEL7, there are two rpm packages for kdump: ::\n+\n+    kexec-tools\n+    crash\n+\n+For SLES11, there are 3 rpm packages for kdump: ::\n+\n+    kdump\n+    kexec-tools\n+    makedumpfile\n+\n+For SLES10, there are 4 rpm packages for kdump: ::\n+\n+    kernel-kdump\n+    kexec-tools\n+    kdump\n+    makedumpfile\n+\n+Setup pkglist\n+-------------\n+\n+Before setting up kdump,the approprite rpms should be added to the pkglist file as found by running: ::\n+\n+    lsdef -t osimage <osimage name>\n+\n+The exclude file\n+----------------\n+\n+The base diskless image excludes the /boot directory, but it is required for kdump. Update the exlist file and remove the entry for /boot. Then run the packimage or liteimg command to update your image with the changes.\n+\n+The postinstall file\n+--------------------\n+\n+The kdump will create a new initrd which used in the dumping stage. The /tmp or /var/tmp directory will be used as the temporary directory. These 2 directory only are allocated 10M space by default. You need to enlarge it to 200M.\n+\n+For RHELS6 or SLES10, modify the postinstall file to increase /tmp space: ::\n+\n+    tmpfs   /var/tmp    tmpfs   defaults,size=200m   0 2\n+\n+For SLES11, modify the postinstall file to increase /tmp/space: ::\n+\n+    tmpfs   /tmp    tmpfs   defaults,size=200m       0 2\n+\n+The dump attribute\n+------------------\n+\n+In order to support kdump, the dump attribute was added into linuximage table, which is used to define the remote path where the crash information should be dumped to. Use the chdef command to change the image's dump attribute using the URI format. ::\n+\n+    chdef -t osimage <image name> dump=nfs://<nfs_server_ip>/<kdump_path>\n+\n+The <nfs_server_ip> can be excluded if the destination NFS server is the service or management node. ::\n+\n+    chdef -t osimage <image name> dump=nfs:///<kdump_path>\n+\n+The crashkernelsize attribute\n+-----------------------------\n+\n+For system x machine, on sles10 set the crashkernelsize attribute like this: ::\n+\n+    chdef -t osimage <image name> crashkernelsize=<size>M@16M\n+\n+On sles11 and rhels6 set the crashkernelsize attribute like this: ::\n+\n+    chdef -t osimage <image name> crashkernelsize=<size>M\n+\n+Where <size> recommended value is 256. For more information about the size can refer to the following information:","path":"docs/source/guides/admin-guides/manage_clusters/common/deployment/enable_kdump.rst","position":85,"original_position":85,"commit_id":"bc23bda3424ad5e8079f07ea9056c31af30e7620","original_commit_id":"bc23bda3424ad5e8079f07ea9056c31af30e7620","user":{"login":"zet809","id":8222144,"avatar_url":"https://avatars.githubusercontent.com/u/8222144?v=3","gravatar_id":"","url":"https://api.github.com/users/zet809","html_url":"https://github.com/zet809","followers_url":"https://api.github.com/users/zet809/followers","following_url":"https://api.github.com/users/zet809/following{/other_user}","gists_url":"https://api.github.com/users/zet809/gists{/gist_id}","starred_url":"https://api.github.com/users/zet809/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zet809/subscriptions","organizations_url":"https://api.github.com/users/zet809/orgs","repos_url":"https://api.github.com/users/zet809/repos","events_url":"https://api.github.com/users/zet809/events{/privacy}","received_events_url":"https://api.github.com/users/zet809/received_events","type":"User","site_admin":false},"body":"Rh5 may can be droped.\r\nThe 2nd and 4th link are the same.","created_at":"2015-09-09T08:45:39Z","updated_at":"2015-09-09T08:45:39Z","html_url":"https://github.com/xcat2/xcat-core/pull/151#discussion_r39019216","pull_request_url":"https://api.github.com/repos/xcat2/xcat-core/pulls/151","_links":{"self":{"href":"https://api.github.com/repos/xcat2/xcat-core/pulls/comments/39019216"},"html":{"href":"https://github.com/xcat2/xcat-core/pull/151#discussion_r39019216"},"pull_request":{"href":"https://api.github.com/repos/xcat2/xcat-core/pulls/151"}}},"pull_request":{"url":"https://api.github.com/repos/xcat2/xcat-core/pulls/151","id":43976324,"html_url":"https://github.com/xcat2/xcat-core/pull/151","diff_url":"https://github.com/xcat2/xcat-core/pull/151.diff","patch_url":"https://github.com/xcat2/xcat-core/pull/151.patch","issue_url":"https://api.github.com/repos/xcat2/xcat-core/issues/151","number":151,"state":"open","locked":false,"title":"add enable_kdump.rst,generate_img.rst,install_new_kernel.rst etc docu…","user":{"login":"tingtli","id":12440603,"avatar_url":"https://avatars.githubusercontent.com/u/12440603?v=3","gravatar_id":"","url":"https://api.github.com/users/tingtli","html_url":"https://github.com/tingtli","followers_url":"https://api.github.com/users/tingtli/followers","following_url":"https://api.github.com/users/tingtli/following{/other_user}","gists_url":"https://api.github.com/users/tingtli/gists{/gist_id}","starred_url":"https://api.github.com/users/tingtli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tingtli/subscriptions","organizations_url":"https://api.github.com/users/tingtli/orgs","repos_url":"https://api.github.com/users/tingtli/repos","events_url":"https://api.github.com/users/tingtli/events{/privacy}","received_events_url":"https://api.github.com/users/tingtli/received_events","type":"User","site_admin":false},"body":"…mentation","created_at":"2015-09-02T10:32:14Z","updated_at":"2015-09-09T08:45:39Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b6e2aa91fdb89808376b8fcd9c29c97b4a29a718","assignee":{"login":"zet809","id":8222144,"avatar_url":"https://avatars.githubusercontent.com/u/8222144?v=3","gravatar_id":"","url":"https://api.github.com/users/zet809","html_url":"https://github.com/zet809","followers_url":"https://api.github.com/users/zet809/followers","following_url":"https://api.github.com/users/zet809/following{/other_user}","gists_url":"https://api.github.com/users/zet809/gists{/gist_id}","starred_url":"https://api.github.com/users/zet809/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zet809/subscriptions","organizations_url":"https://api.github.com/users/zet809/orgs","repos_url":"https://api.github.com/users/zet809/repos","events_url":"https://api.github.com/users/zet809/events{/privacy}","received_events_url":"https://api.github.com/users/zet809/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/xcat2/xcat-core/pulls/151/commits","review_comments_url":"https://api.github.com/repos/xcat2/xcat-core/pulls/151/comments","review_comment_url":"https://api.github.com/repos/xcat2/xcat-core/pulls/comments{/number}","comments_url":"https://api.github.com/repos/xcat2/xcat-core/issues/151/comments","statuses_url":"https://api.github.com/repos/xcat2/xcat-core/statuses/bc23bda3424ad5e8079f07ea9056c31af30e7620","head":{"label":"tingtli:master","ref":"master","sha":"bc23bda3424ad5e8079f07ea9056c31af30e7620","user":{"login":"tingtli","id":12440603,"avatar_url":"https://avatars.githubusercontent.com/u/12440603?v=3","gravatar_id":"","url":"https://api.github.com/users/tingtli","html_url":"https://github.com/tingtli","followers_url":"https://api.github.com/users/tingtli/followers","following_url":"https://api.github.com/users/tingtli/following{/other_user}","gists_url":"https://api.github.com/users/tingtli/gists{/gist_id}","starred_url":"https://api.github.com/users/tingtli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tingtli/subscriptions","organizations_url":"https://api.github.com/users/tingtli/orgs","repos_url":"https://api.github.com/users/tingtli/repos","events_url":"https://api.github.com/users/tingtli/events{/privacy}","received_events_url":"https://api.github.com/users/tingtli/received_events","type":"User","site_admin":false},"repo":{"id":40871337,"name":"xcat-core","full_name":"tingtli/xcat-core","owner":{"login":"tingtli","id":12440603,"avatar_url":"https://avatars.githubusercontent.com/u/12440603?v=3","gravatar_id":"","url":"https://api.github.com/users/tingtli","html_url":"https://github.com/tingtli","followers_url":"https://api.github.com/users/tingtli/followers","following_url":"https://api.github.com/users/tingtli/following{/other_user}","gists_url":"https://api.github.com/users/tingtli/gists{/gist_id}","starred_url":"https://api.github.com/users/tingtli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tingtli/subscriptions","organizations_url":"https://api.github.com/users/tingtli/orgs","repos_url":"https://api.github.com/users/tingtli/repos","events_url":"https://api.github.com/users/tingtli/events{/privacy}","received_events_url":"https://api.github.com/users/tingtli/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/tingtli/xcat-core","description":"Code repo for xCAT core packages","fork":true,"url":"https://api.github.com/repos/tingtli/xcat-core","forks_url":"https://api.github.com/repos/tingtli/xcat-core/forks","keys_url":"https://api.github.com/repos/tingtli/xcat-core/keys{/key_id}","collaborators_url":"https://api.github.com/repos/tingtli/xcat-core/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/tingtli/xcat-core/teams","hooks_url":"https://api.github.com/repos/tingtli/xcat-core/hooks","issue_events_url":"https://api.github.com/repos/tingtli/xcat-core/issues/events{/number}","events_url":"https://api.github.com/repos/tingtli/xcat-core/events","assignees_url":"https://api.github.com/repos/tingtli/xcat-core/assignees{/user}","branches_url":"https://api.github.com/repos/tingtli/xcat-core/branches{/branch}","tags_url":"https://api.github.com/repos/tingtli/xcat-core/tags","blobs_url":"https://api.github.com/repos/tingtli/xcat-core/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/tingtli/xcat-core/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/tingtli/xcat-core/git/refs{/sha}","trees_url":"https://api.github.com/repos/tingtli/xcat-core/git/trees{/sha}","statuses_url":"https://api.github.com/repos/tingtli/xcat-core/statuses/{sha}","languages_url":"https://api.github.com/repos/tingtli/xcat-core/languages","stargazers_url":"https://api.github.com/repos/tingtli/xcat-core/stargazers","contributors_url":"https://api.github.com/repos/tingtli/xcat-core/contributors","subscribers_url":"https://api.github.com/repos/tingtli/xcat-core/subscribers","subscription_url":"https://api.github.com/repos/tingtli/xcat-core/subscription","commits_url":"https://api.github.com/repos/tingtli/xcat-core/commits{/sha}","git_commits_url":"https://api.github.com/repos/tingtli/xcat-core/git/commits{/sha}","comments_url":"https://api.github.com/repos/tingtli/xcat-core/comments{/number}","issue_comment_url":"https://api.github.com/repos/tingtli/xcat-core/issues/comments{/number}","contents_url":"https://api.github.com/repos/tingtli/xcat-core/contents/{+path}","compare_url":"https://api.github.com/repos/tingtli/xcat-core/compare/{base}...{head}","merges_url":"https://api.github.com/repos/tingtli/xcat-core/merges","archive_url":"https://api.github.com/repos/tingtli/xcat-core/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/tingtli/xcat-core/downloads","issues_url":"https://api.github.com/repos/tingtli/xcat-core/issues{/number}","pulls_url":"https://api.github.com/repos/tingtli/xcat-core/pulls{/number}","milestones_url":"https://api.github.com/repos/tingtli/xcat-core/milestones{/number}","notifications_url":"https://api.github.com/repos/tingtli/xcat-core/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/tingtli/xcat-core/labels{/name}","releases_url":"https://api.github.com/repos/tingtli/xcat-core/releases{/id}","created_at":"2015-08-17T06:50:04Z","updated_at":"2015-08-17T06:50:11Z","pushed_at":"2015-09-02T10:29:17Z","git_url":"git://github.com/tingtli/xcat-core.git","ssh_url":"git@github.com:tingtli/xcat-core.git","clone_url":"https://github.com/tingtli/xcat-core.git","svn_url":"https://github.com/tingtli/xcat-core","homepage":null,"size":179469,"stargazers_count":0,"watchers_count":0,"language":"Perl","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":"xcat2:master","ref":"master","sha":"c0e16c9fcf1096691f99f75c04b2f7a0bf7a720a","user":{"login":"xcat2","id":10124414,"avatar_url":"https://avatars.githubusercontent.com/u/10124414?v=3","gravatar_id":"","url":"https://api.github.com/users/xcat2","html_url":"https://github.com/xcat2","followers_url":"https://api.github.com/users/xcat2/followers","following_url":"https://api.github.com/users/xcat2/following{/other_user}","gists_url":"https://api.github.com/users/xcat2/gists{/gist_id}","starred_url":"https://api.github.com/users/xcat2/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xcat2/subscriptions","organizations_url":"https://api.github.com/users/xcat2/orgs","repos_url":"https://api.github.com/users/xcat2/repos","events_url":"https://api.github.com/users/xcat2/events{/privacy}","received_events_url":"https://api.github.com/users/xcat2/received_events","type":"Organization","site_admin":false},"repo":{"id":27747508,"name":"xcat-core","full_name":"xcat2/xcat-core","owner":{"login":"xcat2","id":10124414,"avatar_url":"https://avatars.githubusercontent.com/u/10124414?v=3","gravatar_id":"","url":"https://api.github.com/users/xcat2","html_url":"https://github.com/xcat2","followers_url":"https://api.github.com/users/xcat2/followers","following_url":"https://api.github.com/users/xcat2/following{/other_user}","gists_url":"https://api.github.com/users/xcat2/gists{/gist_id}","starred_url":"https://api.github.com/users/xcat2/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xcat2/subscriptions","organizations_url":"https://api.github.com/users/xcat2/orgs","repos_url":"https://api.github.com/users/xcat2/repos","events_url":"https://api.github.com/users/xcat2/events{/privacy}","received_events_url":"https://api.github.com/users/xcat2/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/xcat2/xcat-core","description":"Code repo for xCAT core packages","fork":false,"url":"https://api.github.com/repos/xcat2/xcat-core","forks_url":"https://api.github.com/repos/xcat2/xcat-core/forks","keys_url":"https://api.github.com/repos/xcat2/xcat-core/keys{/key_id}","collaborators_url":"https://api.github.com/repos/xcat2/xcat-core/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/xcat2/xcat-core/teams","hooks_url":"https://api.github.com/repos/xcat2/xcat-core/hooks","issue_events_url":"https://api.github.com/repos/xcat2/xcat-core/issues/events{/number}","events_url":"https://api.github.com/repos/xcat2/xcat-core/events","assignees_url":"https://api.github.com/repos/xcat2/xcat-core/assignees{/user}","branches_url":"https://api.github.com/repos/xcat2/xcat-core/branches{/branch}","tags_url":"https://api.github.com/repos/xcat2/xcat-core/tags","blobs_url":"https://api.github.com/repos/xcat2/xcat-core/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/xcat2/xcat-core/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/xcat2/xcat-core/git/refs{/sha}","trees_url":"https://api.github.com/repos/xcat2/xcat-core/git/trees{/sha}","statuses_url":"https://api.github.com/repos/xcat2/xcat-core/statuses/{sha}","languages_url":"https://api.github.com/repos/xcat2/xcat-core/languages","stargazers_url":"https://api.github.com/repos/xcat2/xcat-core/stargazers","contributors_url":"https://api.github.com/repos/xcat2/xcat-core/contributors","subscribers_url":"https://api.github.com/repos/xcat2/xcat-core/subscribers","subscription_url":"https://api.github.com/repos/xcat2/xcat-core/subscription","commits_url":"https://api.github.com/repos/xcat2/xcat-core/commits{/sha}","git_commits_url":"https://api.github.com/repos/xcat2/xcat-core/git/commits{/sha}","comments_url":"https://api.github.com/repos/xcat2/xcat-core/comments{/number}","issue_comment_url":"https://api.github.com/repos/xcat2/xcat-core/issues/comments{/number}","contents_url":"https://api.github.com/repos/xcat2/xcat-core/contents/{+path}","compare_url":"https://api.github.com/repos/xcat2/xcat-core/compare/{base}...{head}","merges_url":"https://api.github.com/repos/xcat2/xcat-core/merges","archive_url":"https://api.github.com/repos/xcat2/xcat-core/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/xcat2/xcat-core/downloads","issues_url":"https://api.github.com/repos/xcat2/xcat-core/issues{/number}","pulls_url":"https://api.github.com/repos/xcat2/xcat-core/pulls{/number}","milestones_url":"https://api.github.com/repos/xcat2/xcat-core/milestones{/number}","notifications_url":"https://api.github.com/repos/xcat2/xcat-core/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/xcat2/xcat-core/labels{/name}","releases_url":"https://api.github.com/repos/xcat2/xcat-core/releases{/id}","created_at":"2014-12-09T03:21:50Z","updated_at":"2015-08-24T13:01:14Z","pushed_at":"2015-09-09T04:44:33Z","git_url":"git://github.com/xcat2/xcat-core.git","ssh_url":"git@github.com:xcat2/xcat-core.git","clone_url":"https://github.com/xcat2/xcat-core.git","svn_url":"https://github.com/xcat2/xcat-core","homepage":null,"size":185327,"stargazers_count":19,"watchers_count":19,"language":"Perl","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":26,"mirror_url":null,"open_issues_count":59,"forks":26,"open_issues":59,"watchers":19,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/xcat2/xcat-core/pulls/151"},"html":{"href":"https://github.com/xcat2/xcat-core/pull/151"},"issue":{"href":"https://api.github.com/repos/xcat2/xcat-core/issues/151"},"comments":{"href":"https://api.github.com/repos/xcat2/xcat-core/issues/151/comments"},"review_comments":{"href":"https://api.github.com/repos/xcat2/xcat-core/pulls/151/comments"},"review_comment":{"href":"https://api.github.com/repos/xcat2/xcat-core/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/xcat2/xcat-core/pulls/151/commits"},"statuses":{"href":"https://api.github.com/repos/xcat2/xcat-core/statuses/bc23bda3424ad5e8079f07ea9056c31af30e7620"}}}}